zodline 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Robin Genz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,258 @@
+# zodline
+
+[![npm version](https://img.shields.io/npm/v/zodline)](https://www.npmjs.com/package/zodline)
+[![npm downloads](https://img.shields.io/npm/dm/zodline)](https://www.npmjs.com/package/zodline)
+[![license](https://img.shields.io/npm/l/zodline)](https://github.com/robingenz/zodline/blob/main/LICENSE)
+
+A powerful CLI parser built with TypeScript and Zod for type-safe command-line interfaces.
+
+## Features
+
+- 🛡️ **Type-safe**: Built with TypeScript and Zod for runtime validation.
+- 📋 **Declarative**: Define commands, options, and arguments with simple schemas.
+- 🔄 **Flexible parsing**: Support for long flags, short flags, and flag clustering.
+- 🔀 **Smart conversion**: Automatic kebab-case to camelCase conversion.
+- 🏷️ **Alias support**: Define short aliases for any option.
+- 📦 **Array handling**: Automatic normalization of single values to arrays.
+- 🎯 **Default commands**: Set a default command to run when no command is specified.
+- ❓ **Help message**: Automatic help generation for commands and options.
+- ⚠️ **Error handling**: Clear, actionable error messages.
+- 🚀 **Zero dependencies**: Only requires Zod as a peer dependency.
+- 📦 **ESM support**: Modern ES modules with full TypeScript support.
+
+## Installation
+
+```bash
+npm install zodline zod
+```
+
+## Migration from `@robingenz/zli`
+
+`zodline` was previously published as `@robingenz/zli`. To migrate:
+
+1. Replace the dependency:
+
+   ```bash
+   npm uninstall @robingenz/zli
+   npm install zodline
+   ```
+
+2. Update import specifiers:
+
+   ```diff
+   - import { ... } from '@robingenz/zli';
+   + import { ... } from 'zodline';
+   ```
+
+3. Rename the `ZliError` export to `ZodlineError` (the public API is otherwise unchanged):
+
+   ```diff
+   - import { ZliError } from '@robingenz/zli';
+   + import { ZodlineError } from 'zodline';
+   ```
+
+## Usage
+
+### Basic Example
+
+```javascript
+import { z } from 'zod';
+import { defineConfig, defineCommand, defineOptions, processConfig } from 'zodline';
+
+// Define a simple command
+const greetCommand = defineCommand({
+  description: 'Greet someone',
+  options: defineOptions(
+    z.object({
+      name: z.string().describe('Name to greet'),
+      loud: z.boolean().default(false).describe('Use uppercase'),
+    }),
+    { n: 'name', l: 'loud' } // Short aliases
+  ),
+  action: async (options) => {
+    const greeting = `Hello, ${options.name}!`;
+    console.log(options.loud ? greeting.toUpperCase() : greeting);
+  },
+});
+
+// Configure the CLI
+const config = defineConfig({
+  meta: {
+    name: 'my-cli',
+    version: '1.0.0',
+    description: 'A simple CLI example',
+  },
+  commands: {
+    greet: greetCommand,
+  },
+  defaultCommand: greetCommand,
+});
+
+// Process command line arguments
+try {
+  const result = processConfig(config, process.argv.slice(2));
+  await result.command.action(result.options, result.args);
+} catch (error) {
+  console.error('Error:', error.message);
+  process.exit(1);
+}
+```
+
+### Command Usage
+
+```bash
+# Show help
+my-cli --help
+my-cli greet --help
+
+# Run commands
+my-cli greet --name Alice
+my-cli greet -n Bob --loud
+
+# Run default command
+my-cli --name Alice
+my-cli greet --name Alice
+```
+
+### Advanced Features
+
+#### Default Commands
+
+You can specify a default command that will be executed when no command is provided:
+
+```javascript
+const config = defineConfig({
+  meta: {
+    name: 'my-app',
+    version: '1.0.0',
+  },
+  commands: {
+    start: startCommand,
+    build: buildCommand,
+  },
+  defaultCommand: startCommand,
+});
+```
+
+With this configuration:
+- `my-app` will run the `startCommand`
+- `my-app --help` will still show the help message
+- `my-app build` will run the `build` command
+
+#### Commands with Arguments
+
+```javascript
+const copyCommand = defineCommand({
+  description: 'Copy a file',
+  args: z.tuple([
+    z.string().describe('Source file'),
+    z.string().describe('Destination file'),
+  ]),
+  options: defineOptions(
+    z.object({
+      verbose: z.boolean().default(false).describe('Verbose output'),
+    }),
+    { v: 'verbose' }
+  ),
+  action: async (options, args) => {
+    const [source, dest] = args;
+    console.log(`Copying ${source} to ${dest}`);
+  },
+});
+```
+
+#### Array Options
+
+```javascript
+const options = defineOptions(
+  z.object({
+    files: z.array(z.string()).describe('Input files'),
+    tags: z.array(z.string()).optional().describe('Tags to apply'),
+  })
+);
+
+// Usage: --files file1.txt --files file2.txt
+// Single values are automatically converted to arrays
+```
+
+#### Type Transformations
+
+```javascript
+const options = defineOptions(
+  z.object({
+    port: z.coerce.number().min(1).max(65535).describe('Port number'),
+    count: z.coerce.number().min(1).describe('Count'),
+  })
+);
+```
+
+### Flag Parsing
+
+`zodline` supports various flag formats:
+
+```bash
+# Long flags
+--verbose --name=value --port 3000
+
+# Short flags  
+-v -n value -p 3000
+
+# Flag clustering
+-abc  # equivalent to -a -b -c
+
+# Kebab-case conversion
+--my-option  # becomes myOption in your code
+
+# Multiple values
+--file a.txt --file b.txt  # becomes ['a.txt', 'b.txt']
+```
+
+### API Reference
+
+#### `defineOptions(schema, aliases?)`
+
+Define options for a command with optional aliases.
+
+- `schema`: Zod object schema defining the options
+- `aliases`: Optional object mapping short aliases to option names
+
+#### `defineCommand(config)`
+
+Define a command with options, arguments, and action.
+
+- `description`: Command description for help
+- `options`: Options definition (optional)
+- `args`: Zod schema for arguments (optional)  
+- `action`: Function to execute when command is run
+
+#### `defineConfig(config)`
+
+Define the CLI configuration.
+
+- `meta`: CLI metadata (name, version, description)
+- `commands`: Object mapping command names to definitions
+- `defaultCommand`: Optional default command definition to run when no command is specified
+
+#### `processConfig(config, args)`
+
+Process command line arguments and return the result.
+
+- `config`: CLI configuration
+- `args`: Command line arguments (typically `process.argv.slice(2)`)
+
+Returns an object with:
+- `command`: The matched command definition
+- `options`: Parsed and validated options
+- `args`: Parsed and validated arguments
+
+## Used By
+
+- [Capawesome Team CLI](https://github.com/capawesome-team/cli) - The Capawesome Cloud CLI to manage Live Updates and more.
+
+## Changelog
+
+See [CHANGELOG.md](./CHANGELOG.md).
+
+## License
+
+See [LICENSE](./LICENSE).

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import type { OptionsDefinition, CommandDefinition, DefineConfig } from './types.js';
+export declare function defineOptions<T extends z.ZodObject<any> = z.ZodObject<any>>(schema: T, aliases?: Record<string, string>): OptionsDefinition<T>;
+export declare function defineCommand<TOptions extends OptionsDefinition<any> | undefined = undefined, TArgs extends z.ZodType | undefined = undefined>(config: {
+    description?: string;
+    options?: TOptions;
+    args?: TArgs;
+    action: (options: TOptions extends OptionsDefinition<infer U> ? z.infer<U> : {}, args: TArgs extends z.ZodType ? z.infer<TArgs> : undefined) => void | Promise<void>;
+}): CommandDefinition<TOptions extends OptionsDefinition<infer U> ? U : z.ZodObject<any>, TArgs>;
+export declare function defineConfig<TCommands extends Record<string, CommandDefinition<any, any>> = {}>(config: DefineConfig<TCommands>): DefineConfig<TCommands>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAErF,wBAAgB,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EACzE,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,iBAAiB,CAAC,CAAC,CAAC,CAEtB;AAED,wBAAgB,aAAa,CAC3B,QAAQ,SAAS,iBAAiB,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,EAC/D,KAAK,SAAS,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,SAAS,EAC/C,MAAM,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,CACN,OAAO,EAAE,QAAQ,SAAS,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,EACtE,IAAI,EAAE,KAAK,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,SAAS,KACvD,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,GAAG,iBAAiB,CAAC,QAAQ,SAAS,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAE/F;AAED,wBAAgB,YAAY,CAAC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAC7F,MAAM,EAAE,YAAY,CAAC,SAAS,CAAC,GAC9B,YAAY,CAAC,SAAS,CAAC,CAEzB"}

package/dist/config.js

@@ -0,0 +1,10 @@
+export function defineOptions(schema, aliases) {
+    return { schema, aliases };
+}
+export function defineCommand(config) {
+    return config;
+}
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,aAAa,CAC3B,MAAS,EACT,OAAgC;IAEhC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,aAAa,CAG3B,MAQD;IACC,OAAO,MAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAA+B;IAE/B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import type { CommandDefinition, DefineConfig, ProcessResult } from './types.js';
+/**
+ * Main entry point for processing CLI configuration and arguments.
+ * Parses command line arguments, validates options, and returns the processed result.
+ * Handles help display, command validation, and option processing.
+ *
+ * @param config - CLI configuration with commands
+ * @param args - Command line arguments (typically process.argv.slice(2))
+ * @returns Processed result containing command, options, and arguments
+ * @throws Error for invalid commands or validation failures
+ *
+ * @example
+ * processConfig(config, ['apps:bundles:create', '--android-max', '10'])
+ * // Returns: { command: ..., options: { androidMax: '10' }, args: [] }
+ */
+export declare function processConfig<TCommands extends Record<string, CommandDefinition<any, any>> = {}>(config: DefineConfig<TCommands>, args: string[]): ProcessResult<CommandDefinition<any, any>>;
+export { defineOptions, defineCommand, defineConfig } from './config.js';
+export { ZodlineError } from './types.js';
+export type { OptionsDefinition, CommandDefinition, DefineConfig, ProcessResult } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAqB,aAAa,EAAE,MAAM,YAAY,CAAC;AAggBpG;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAC9F,MAAM,EAAE,YAAY,CAAC,SAAS,CAAC,EAC/B,IAAI,EAAE,MAAM,EAAE,GACb,aAAa,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CA0C5C;AAGD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,507 @@
+import { z } from 'zod';
+import { ZodlineError } from './types.js';
+/**
+ * Parses command line arguments into flags and non-flag arguments.
+ * Handles both long flags (--flag) and short flags (-f), including flag clustering (-abc).
+ * Supports flags with values (--flag=value or --flag value) and boolean flags.
+ * When the same flag is specified multiple times, values are collected into an array.
+ *
+ * @param args - Array of command line arguments to parse
+ * @returns Object containing parsed flags and non-flag arguments under '_' key
+ *
+ * @example
+ * parseFlags(['--verbose', '--count', '5', 'file.txt'])
+ * // Returns: { verbose: true, count: '5', _: ['file.txt'] }
+ *
+ * @example
+ * parseFlags(['--custom-property', 'key1=value1', '--custom-property', 'key2=value2'])
+ * // Returns: { 'custom-property': ['key1=value1', 'key2=value2'], _: [] }
+ */
+function parseFlags(args) {
+    const flags = {};
+    const nonFlags = [];
+    const addFlag = (key, value) => {
+        if (key in flags) {
+            const existing = flags[key];
+            if (Array.isArray(existing)) {
+                existing.push(value);
+            }
+            else {
+                flags[key] = [existing, value];
+            }
+        }
+        else {
+            flags[key] = value;
+        }
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (arg.startsWith('--')) {
+            const key = arg.slice(2);
+            if (key.includes('=')) {
+                const [flagName, ...valueParts] = key.split('=');
+                if (flagName) {
+                    addFlag(flagName, valueParts.join('='));
+                }
+            }
+            else {
+                const nextArg = args[i + 1];
+                if (nextArg && !nextArg.startsWith('-')) {
+                    addFlag(key, nextArg);
+                    i++;
+                }
+                else {
+                    addFlag(key, true);
+                }
+            }
+        }
+        else if (arg.startsWith('-') && arg.length > 1) {
+            const key = arg.slice(1);
+            if (key.length === 1) {
+                const nextArg = args[i + 1];
+                if (nextArg && !nextArg.startsWith('-')) {
+                    addFlag(key, nextArg);
+                    i++;
+                }
+                else {
+                    addFlag(key, true);
+                }
+            }
+            else {
+                for (const char of key) {
+                    addFlag(char, true);
+                }
+            }
+        }
+        else {
+            nonFlags.push(arg);
+        }
+    }
+    return { ...flags, _: nonFlags };
+}
+/**
+ * Resolves flag aliases by replacing alias keys with their target keys.
+ * If both alias and target exist, the alias value takes precedence.
+ *
+ * @param flags - Object containing parsed flags
+ * @param aliases - Optional mapping of alias keys to target keys
+ * @returns New flags object with aliases resolved to their target keys
+ *
+ * @example
+ * resolveAliases({ v: true, verbose: false }, { v: 'verbose' })
+ * // Returns: { verbose: true }
+ */
+function resolveAliases(flags, aliases) {
+    if (!aliases)
+        return flags;
+    const resolved = { ...flags };
+    for (const [alias, target] of Object.entries(aliases)) {
+        if (alias in resolved) {
+            resolved[target] = resolved[alias];
+            delete resolved[alias];
+        }
+    }
+    return resolved;
+}
+/**
+ * Converts a camelCase string to kebab-case.
+ *
+ * @param str - The camelCase string to convert
+ * @returns The kebab-case version of the input string
+ *
+ * @example
+ * camelToKebab('androidMax') // Returns: 'android-max'
+ * camelToKebab('expiresInDays') // Returns: 'expires-in-days'
+ */
+function camelToKebab(str) {
+    return str.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+}
+/**
+ * Resolves kebab-case flags to their camelCase equivalents based on the schema.
+ * Only converts kebab-case flags when the camelCase version is not already present.
+ * This allows users to pass --android-max instead of --androidMax.
+ *
+ * @param flags - Object containing parsed flags
+ * @param schema - Zod schema object defining the expected camelCase keys
+ * @returns New flags object with kebab-case flags converted to camelCase
+ *
+ * @example
+ * resolveKebabCase({ 'android-max': '10' }, schema)
+ * // Returns: { androidMax: '10' } (if androidMax is in schema)
+ */
+function resolveKebabCase(flags, schema) {
+    const resolved = { ...flags };
+    const schemaKeys = Object.keys(schema.shape);
+    for (const camelKey of schemaKeys) {
+        if (!(camelKey in resolved)) {
+            const kebabKey = camelToKebab(camelKey);
+            if (kebabKey in resolved) {
+                resolved[camelKey] = resolved[kebabKey];
+                delete resolved[kebabKey];
+            }
+        }
+    }
+    return resolved;
+}
+/**
+ * Builds and displays a header line with description and meta information.
+ *
+ * @param options - Header display options
+ */
+function displayHeader(options) {
+    const parts = [];
+    if (options.description)
+        parts.push(options.description);
+    const metaParts = [];
+    if (options.packageName)
+        metaParts.push(options.packageName);
+    if (options.commandName)
+        metaParts.push(options.commandName);
+    if (options.version)
+        metaParts.push(`v${options.version}`);
+    if (metaParts.length > 0) {
+        parts.push(`(${metaParts.join(' ')})`);
+    }
+    if (parts.length > 0) {
+        console.log(`\x1b[90m${parts.join(' ')}\x1b[0m\n`);
+    }
+}
+/**
+ * Displays the main help screen with all available commands.
+ * Shows CLI version, usage instructions, and a formatted list of commands with descriptions.
+ *
+ * @param commands - Object mapping command names to their definitions
+ * @param meta - Meta information about the CLI
+ */
+function displayHelp(commands, meta) {
+    displayHeader({
+        description: meta?.description,
+        packageName: meta?.name,
+        version: meta?.version,
+    });
+    const commandNames = Object.keys(commands).join('|');
+    const usageName = meta?.name || 'cli';
+    console.log(`\x1b[1mUSAGE\x1b[0m \x1b[36m${usageName} ${commandNames}\x1b[0m\n`);
+    console.log('\x1b[1mCOMMANDS\x1b[0m\n');
+    // Find the maximum command name length for alignment
+    const maxLength = Math.max(...Object.keys(commands).map((name) => name.length));
+    for (const [name, command] of Object.entries(commands)) {
+        const description = command.description || '';
+        const padding = ' '.repeat(Math.max(2, maxLength - name.length + 4));
+        console.log(`  \x1b[36m${name}\x1b[0m${padding}${description}`);
+    }
+    if (meta?.name) {
+        console.log(`\nUse \x1b[36m${meta.name} <command> --help\x1b[0m for more information about a command.`);
+    }
+}
+/**
+ * Displays help information for a specific command.
+ * Shows command description, usage, and available options with their descriptions.
+ *
+ * @param commandName - Name of the command to show help for
+ * @param command - Command definition containing options and description
+ * @param meta - Meta information about the CLI
+ */
+function displayCommandHelp(commandName, command, meta) {
+    displayHeader({
+        commandName,
+        description: command.description,
+        packageName: meta?.name,
+        version: meta?.version,
+    });
+    // Build usage line
+    const usageName = meta?.name || 'cli';
+    let usageLine = `\x1b[1mUSAGE\x1b[0m \x1b[36m${usageName} ${commandName}`;
+    // Add [OPTIONS] if the command has options
+    if (command.options) {
+        usageLine += ' [OPTIONS]';
+    }
+    // Add args placeholder if the command expects args
+    if (command.args) {
+        usageLine += ' [ARGS]';
+    }
+    console.log(`${usageLine}\x1b[0m\n`);
+    // Display options if they exist
+    if (command.options?.schema) {
+        console.log('\x1b[1mOPTIONS\x1b[0m\n');
+        const shape = command.options.schema.shape;
+        const aliases = command.options.aliases || {};
+        // Calculate the maximum length for consistent padding
+        let maxLength = 0;
+        for (const [key] of Object.entries(shape)) {
+            const alias = Object.keys(aliases).find((alias) => aliases[alias] === key);
+            const kebabKey = camelToKebab(key);
+            const visibleLength = `  --${kebabKey}${alias ? `, -${alias}` : ''}`.length;
+            maxLength = Math.max(maxLength, visibleLength);
+        }
+        for (const [key, zodType] of Object.entries(shape)) {
+            const description = zodType.description || '';
+            const alias = Object.keys(aliases).find((alias) => aliases[alias] === key);
+            const kebabKey = camelToKebab(key);
+            let optionLine = `  \x1b[36m--${kebabKey}\x1b[0m`;
+            if (alias) {
+                optionLine += `, \x1b[36m-${alias}\x1b[0m`;
+            }
+            // Extract default value if present
+            const defaultValue = extractDefaultValue(zodType);
+            let finalDescription = description;
+            if (defaultValue !== undefined) {
+                finalDescription = description + (description ? ' ' : '') + `(default: ${defaultValue})`;
+            }
+            // Add padding and description (accounting for color codes)
+            const visibleLength = `  --${kebabKey}${alias ? `, -${alias}` : ''}`.length;
+            const padding = ' '.repeat(Math.max(2, maxLength - visibleLength + 4));
+            console.log(`${optionLine}${padding}${finalDescription}`);
+        }
+    }
+}
+/**
+ * Normalizes single values to arrays for fields that are defined as arrays in the schema.
+ * This ensures that when a user provides a single value for an array field,
+ * it gets wrapped in an array before validation.
+ *
+ * @param options - Object containing parsed options
+ * @param schema - Zod schema object defining the expected field types
+ * @returns New options object with single values normalized to arrays where needed
+ *
+ * @example
+ * normalizeArrayFields({ customProperty: 'key=value' }, schema)
+ * // Returns: { customProperty: ['key=value'] } (if customProperty is defined as array in schema)
+ */
+function normalizeArrayFields(options, schema) {
+    const normalized = { ...options };
+    const shape = schema.shape;
+    for (const [key, zodType] of Object.entries(shape)) {
+        if (key in normalized) {
+            // Check if this field is defined as an array (including optional arrays)
+            const isArrayField = isZodArrayType(zodType);
+            if (isArrayField && !Array.isArray(normalized[key])) {
+                // Convert single value to array
+                normalized[key] = [normalized[key]];
+            }
+        }
+    }
+    return normalized;
+}
+/**
+ * Checks if a Zod type is an array type, handling optional and default wrappers.
+ *
+ * @param zodType - The Zod type to check
+ * @returns True if the type is an array type
+ */
+function isZodArrayType(zodType) {
+    // Handle ZodOptional and ZodDefault wrappers, but stop when we find the actual type
+    let innerType = zodType;
+    // Only unwrap wrapper types like ZodOptional and ZodDefault, not the content types
+    while (innerType._def && (innerType._def.innerType || innerType._def.type)) {
+        const next = innerType._def.innerType || innerType._def.type;
+        // Stop unwrapping if we reach a content type (like ZodArray, ZodString, etc.)
+        if (innerType.constructor.name === 'ZodOptional' || innerType.constructor.name === 'ZodDefault') {
+            innerType = next;
+        }
+        else {
+            break;
+        }
+    }
+    // Check for ZodArray type name as instanceof might not work with different zod instances
+    return innerType instanceof z.ZodArray || (innerType._def && innerType._def.typeName === 'ZodArray');
+}
+/**
+ * Creates an error for unknown options with proper flag prefix and display name.
+ *
+ * @param optionName - The unknown option name
+ * @returns ZodlineError with formatted error message
+ */
+function createUnknownOptionError(optionName) {
+    const flagPrefix = optionName.length === 1 ? '-' : '--';
+    const displayName = optionName.length === 1 ? optionName : camelToKebab(optionName);
+    return new ZodlineError(`Unknown option: \x1b[36m${flagPrefix}${displayName}\x1b[0m`);
+}
+/**
+ * Extracts the default value from a Zod type, handling nested optional and default wrappers.
+ *
+ * @param zodType - The Zod type to extract default value from
+ * @returns The formatted default value if present, undefined otherwise
+ */
+function extractDefaultValue(zodType) {
+    // Traverse through the type definition to find default value
+    let currentType = zodType;
+    while (currentType && currentType._def) {
+        // Check if this is a ZodDefault type
+        if (currentType.constructor.name === 'ZodDefault' || currentType._def.typeName === 'ZodDefault') {
+            // Handle both function and direct value defaults
+            const defaultValue = currentType._def.defaultValue;
+            const value = typeof defaultValue === 'function' ? defaultValue() : defaultValue;
+            // Format the value based on its type
+            if (typeof value === 'string') {
+                return `"${value}"`;
+            }
+            return String(value);
+        }
+        // Move to the inner type if it exists
+        if (currentType._def.innerType) {
+            currentType = currentType._def.innerType;
+        }
+        else if (currentType._def.type) {
+            currentType = currentType._def.type;
+        }
+        else {
+            break;
+        }
+    }
+    return undefined;
+}
+/**
+ * Validates and transforms command options using Zod schema validation.
+ * Processes aliases and kebab-case conversion before validation.
+ * Ensures that single values for array fields are converted to arrays.
+ * Throws an error if any unknown options are provided.
+ *
+ * @param flags - Raw parsed flags from command line
+ * @param optionsDef - Optional options definition with schema and aliases
+ * @returns Validated options object matching the schema
+ * @throws Error if validation fails or unknown options are provided
+ *
+ * @example
+ * validateOptions({ 'android-max': '10' }, { schema: z.object({ androidMax: z.string() }) })
+ * // Returns: { androidMax: '10' }
+ *
+ * @example
+ * validateOptions({ 'custom-property': 'key=value' }, { schema: z.object({ customProperty: z.array(z.string()) }) })
+ * // Returns: { customProperty: ['key=value'] }
+ */
+function validateOptions(flags, optionsDef) {
+    if (!optionsDef) {
+        // Check for unknown options when no schema is defined
+        const { _, ...options } = flags;
+        const unknownOptions = Object.keys(options);
+        if (unknownOptions.length > 0) {
+            // Find the first unknown option that looks like a flag
+            const firstUnknown = unknownOptions.find((key) => key !== 'help' && key !== 'version');
+            if (firstUnknown) {
+                throw createUnknownOptionError(firstUnknown);
+            }
+        }
+        return {};
+    }
+    // Get valid option names from schema
+    const schemaKeys = Object.keys(optionsDef.schema.shape);
+    const validNames = new Set();
+    // Add camelCase names
+    schemaKeys.forEach((key) => validNames.add(key));
+    // Add kebab-case versions
+    schemaKeys.forEach((key) => validNames.add(camelToKebab(key)));
+    // Add aliases
+    if (optionsDef.aliases) {
+        Object.keys(optionsDef.aliases).forEach((alias) => validNames.add(alias));
+    }
+    // Add standard help and version flags
+    validNames.add('help');
+    validNames.add('version');
+    // Check for unknown options before processing
+    const { _, ...options } = flags;
+    for (const optionName of Object.keys(options)) {
+        if (!validNames.has(optionName)) {
+            throw createUnknownOptionError(optionName);
+        }
+    }
+    const resolvedAliases = resolveAliases(flags, optionsDef.aliases);
+    const resolvedKebab = resolveKebabCase(resolvedAliases, optionsDef.schema);
+    const { _: resolvedUnderscore, ...resolvedOptions } = resolvedKebab;
+    // Normalize single values to arrays for fields that expect arrays
+    const normalizedOptions = normalizeArrayFields(resolvedOptions, optionsDef.schema);
+    return optionsDef.schema.parse(normalizedOptions);
+}
+/**
+ * Processes a command with its options and arguments.
+ * Validates options using the command's schema and parses arguments if provided.
+ *
+ * @param command - The command definition to process
+ * @param parsedFlags - Parsed flags from command line
+ * @param args - Arguments to validate and process
+ * @returns Processed result containing command, options, and arguments
+ * @throws Error for validation failures
+ */
+function processCommandExecution(command, parsedFlags, args) {
+    // Process command options
+    const options = validateOptions(parsedFlags, command.options);
+    // Validate args if schema is provided
+    let validatedArgs = args;
+    if (command.args) {
+        try {
+            validatedArgs = command.args.parse(args);
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                const issues = error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`).join(', ');
+                throw new Error(`Argument validation failed: ${issues}`);
+            }
+            throw error;
+        }
+    }
+    return {
+        command,
+        options,
+        args: validatedArgs,
+    };
+}
+/**
+ * Main entry point for processing CLI configuration and arguments.
+ * Parses command line arguments, validates options, and returns the processed result.
+ * Handles help display, command validation, and option processing.
+ *
+ * @param config - CLI configuration with commands
+ * @param args - Command line arguments (typically process.argv.slice(2))
+ * @returns Processed result containing command, options, and arguments
+ * @throws Error for invalid commands or validation failures
+ *
+ * @example
+ * processConfig(config, ['apps:bundles:create', '--android-max', '10'])
+ * // Returns: { command: ..., options: { androidMax: '10' }, args: [] }
+ */
+export function processConfig(config, args) {
+    const parsedFlags = parseFlags(args);
+    const commandArgs = parsedFlags._ || [];
+    // Find the command
+    const commandName = commandArgs[0];
+    if (!commandName) {
+        if (parsedFlags.version === true && config.meta?.version) {
+            // Show version and exit successfully
+            console.log(config.meta.version);
+            process.exit(0);
+        }
+        else if (parsedFlags.help === true) {
+            // Show help and exit successfully
+            displayHelp(config.commands, config.meta);
+            process.exit(0);
+        }
+        else if (config.defaultCommand) {
+            // Use default command when no command is specified
+            return processCommandExecution(config.defaultCommand, parsedFlags, commandArgs);
+        }
+        else {
+            // Show help and throw error
+            displayHelp(config.commands, config.meta);
+            throw new ZodlineError('No command specified.');
+        }
+    }
+    const command = config.commands[commandName];
+    if (!command) {
+        displayHelp(config.commands, config.meta);
+        throw new ZodlineError(`Unknown command: \x1b[36m${commandName}\x1b[0m`);
+    }
+    const remainingArgs = commandArgs.slice(1);
+    // Check for help flag for the specific command
+    if (parsedFlags.help === true) {
+        displayCommandHelp(commandName, command, config.meta);
+        process.exit(0);
+    }
+    // Process the command
+    return processCommandExecution(command, parsedFlags, remainingArgs);
+}
+// Export main functions and types from config
+export { defineOptions, defineCommand, defineConfig } from './config.js';
+export { ZodlineError } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export declare class ZodlineError extends Error {
+    constructor(message: string);
+}
+export interface OptionsDefinition<T extends z.ZodObject<any> = z.ZodObject<any>> {
+    schema: T;
+    aliases?: Record<string, string> | undefined;
+}
+export interface CommandDefinition<TOptions extends z.ZodObject<any> = z.ZodObject<any>, TArgs extends z.ZodType | undefined = undefined> {
+    description?: string;
+    options?: OptionsDefinition<TOptions>;
+    args?: TArgs;
+    action: (options: TOptions extends z.ZodObject<any> ? z.infer<TOptions> : {}, args: TArgs extends z.ZodType ? z.infer<TArgs> : undefined) => void | Promise<void>;
+}
+export interface DefineConfig<TCommands extends Record<string, CommandDefinition<any, any>> = {}> {
+    meta?: {
+        name?: string;
+        version?: string;
+        description?: string;
+    };
+    commands: TCommands;
+    defaultCommand?: CommandDefinition<any, any>;
+}
+export interface ProcessResult<TCommand extends CommandDefinition<any, any> = CommandDefinition<any, any>> {
+    command: TCommand;
+    options: TCommand extends CommandDefinition<infer TOptions, any> ? TOptions extends z.ZodObject<any> ? z.infer<TOptions> : {} : any;
+    args: TCommand extends CommandDefinition<any, infer TArgs> ? TArgs extends z.ZodType ? z.infer<TArgs> : undefined : any;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;IAC9E,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAiB,CAChC,QAAQ,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EACpD,KAAK,SAAS,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,SAAS;IAE/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,CACN,OAAO,EAAE,QAAQ,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,EACnE,IAAI,EAAE,KAAK,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,SAAS,KACvD,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY,CAAC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE;IAC9F,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE,SAAS,CAAC;IACpB,cAAc,CAAC,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,aAAa,CAAC,QAAQ,SAAS,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC;IACvG,OAAO,EAAE,QAAQ,CAAC;IAClB,OAAO,EAAE,QAAQ,SAAS,iBAAiB,CAAC,MAAM,QAAQ,EAAE,GAAG,CAAC,GAC5D,QAAQ,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAC/B,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,GACjB,EAAE,GACJ,GAAG,CAAC;IACR,IAAI,EAAE,QAAQ,SAAS,iBAAiB,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,GACtD,KAAK,SAAS,CAAC,CAAC,OAAO,GACrB,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GACd,SAAS,GACX,GAAG,CAAC;CACT"}

package/dist/types.js

@@ -0,0 +1,7 @@
+export class ZodlineError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ZodlineError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/example.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+import { z } from 'zod';
+import { defineConfig, defineCommand, defineOptions, processConfig } from './dist/index.js';
+
+// Define a simple command to greet someone
+const greetCommand = defineCommand({
+  description: 'Greet someone',
+  options: defineOptions(
+    z.object({
+      name: z.string().describe('Name to greet'),
+      loud: z.boolean().default(false).describe('Use uppercase'),
+    }),
+    { n: 'name', l: 'loud' } // Short aliases
+  ),
+  action: async (options) => {
+    const greeting = `Hello, ${options.name}!`;
+    console.log(options.loud ? greeting.toUpperCase() : greeting);
+  },
+});
+
+// Define a command that copies a file
+const copyCommand = defineCommand({
+  description: 'Copy a file to another location',
+  args: z.tuple([
+    z.string().describe('Source file'),
+    z.string().describe('Destination file'),
+  ]),
+  options: defineOptions(
+    z.object({
+      verbose: z.boolean().default(false).describe('Show detailed output'),
+    }),
+    { v: 'verbose' }
+  ),
+  action: async (options, args) => {
+    const [source, dest] = args;
+    
+    if (options.verbose) {
+      console.log(`Copying ${source} to ${dest}...`);
+    }
+    
+    console.log(`✅ Copied ${source} to ${dest}`);
+  },
+});
+
+// Configure the CLI
+const config = defineConfig({
+  meta: {
+    name: 'simple-cli',
+    version: '1.0.0',
+    description: 'A simple example CLI',
+  },
+  commands: {
+    greet: greetCommand,
+    copy: copyCommand,
+  },
+});
+
+// Process and run
+try {
+  const result = processConfig(config, process.argv.slice(2));
+  await result.command.action(result.options, result.args);
+} catch (error) {
+  console.error('Error:', error.message);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "zodline",
+  "version": "0.2.0",
+  "description": "A CLI parser built with Zod.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "zodline-example": "./example.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/robingenz/zodline.git"
+  },
+  "bugs": {
+    "url": "https://github.com/robingenz/zodline/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist",
+    "fmt": "prettier --write \"src/**/*.{ts,js,json}\"",
+    "lint": "prettier --check \"src/**/*.{ts,js,json}\"",
+    "test": "vitest run",
+    "test:run": "vitest run",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "release": "commit-and-tag-version",
+    "release:dry-run": "npm run release -- --dry-run",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "peerDependencies": {
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "commit-and-tag-version": "^12.5.2",
+    "prettier": "^3.1.1",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.3.3",
+    "vitest": "^3.2.4",
+    "zod": "^4.0.17"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "keywords": [
+    "cli",
+    "parser",
+    "zod",
+    "typescript",
+    "command-line"
+  ],
+  "author": "Robin Genz <mail@robingenz.dev>",
+  "license": "MIT"
+}