incur 0.0.0 → 0.0.2

package/dist/Help.js

@@ -0,0 +1,231 @@
+import { z } from 'zod';
+/** Formats help text for a router CLI or command group. */
+export function formatRoot(name, options = {}) {
+    const { description, version, commands = [], root = false } = options;
+    const lines = [];
+    // Header
+    lines.push(description ? `${name} \u2014 ${description}` : name);
+    if (version)
+        lines.push(`v${version}`);
+    lines.push('');
+    // Synopsis
+    lines.push(`Usage: ${name} <command>`);
+    // Commands
+    if (commands.length > 0) {
+        lines.push('');
+        lines.push('Commands:');
+        const maxLen = Math.max(...commands.map((c) => c.name.length));
+        for (const cmd of commands) {
+            if (cmd.description) {
+                const padding = ' '.repeat(maxLen - cmd.name.length);
+                lines.push(`  ${cmd.name}${padding}  ${cmd.description}`);
+            }
+            else
+                lines.push(`  ${cmd.name}`);
+        }
+    }
+    lines.push(...globalOptionsLines(root));
+    return lines.join('\n');
+}
+/** Formats help text for a leaf command. */
+export function formatCommand(name, options = {}) {
+    const { alias, description, version, args, env, hint, root = false, options: opts, examples, } = options;
+    const lines = [];
+    // Header
+    lines.push(description ? `${name} \u2014 ${description}` : name);
+    if (version)
+        lines.push(`v${version}`);
+    lines.push('');
+    // Synopsis
+    const { usage } = options;
+    if (usage && usage.length > 0) {
+        const usageLines = usage.map((u) => {
+            const parts = [];
+            if (u.prefix)
+                parts.push(u.prefix);
+            parts.push(name);
+            if (u.args)
+                for (const key of Object.keys(u.args))
+                    parts.push(`<${key}>`);
+            if (u.options)
+                for (const key of Object.keys(u.options))
+                    parts.push(`--${key} <${key}>`);
+            if (u.suffix)
+                parts.push(u.suffix);
+            return parts.join(' ');
+        });
+        const pad = ' '.repeat('Usage: '.length);
+        lines.push(`Usage: ${usageLines[0]}`);
+        for (const line of usageLines.slice(1))
+            lines.push(`${pad}${line}`);
+    }
+    else {
+        const synopsis = buildSynopsis(name, args);
+        lines.push(`Usage: ${synopsis}${opts ? ' [options]' : ''}`);
+    }
+    // Arguments
+    if (args) {
+        const entries = argsEntries(args);
+        if (entries.length > 0) {
+            lines.push('');
+            lines.push('Arguments:');
+            const maxLen = Math.max(...entries.map((e) => e.name.length));
+            for (const entry of entries)
+                lines.push(`  ${entry.name}${' '.repeat(maxLen - entry.name.length)}  ${entry.description}`);
+        }
+    }
+    // Options
+    if (opts) {
+        const entries = optionEntries(opts, alias);
+        if (entries.length > 0) {
+            lines.push('');
+            lines.push('Options:');
+            const maxLen = Math.max(...entries.map((e) => e.flag.length));
+            for (const entry of entries) {
+                const padding = ' '.repeat(maxLen - entry.flag.length);
+                const desc = entry.defaultValue !== undefined
+                    ? `${entry.description} (default: ${entry.defaultValue})`
+                    : entry.description;
+                lines.push(`  ${entry.flag}${padding}  ${desc}`);
+            }
+        }
+    }
+    // Environment Variables
+    if (env) {
+        const entries = envEntries(env);
+        if (entries.length > 0) {
+            lines.push('');
+            lines.push('Environment Variables:');
+            const maxLen = Math.max(...entries.map((e) => e.name.length));
+            for (const entry of entries) {
+                const padding = ' '.repeat(maxLen - entry.name.length);
+                const desc = entry.defaultValue !== undefined
+                    ? `${entry.description} (default: ${entry.defaultValue})`
+                    : entry.description;
+                lines.push(`  ${entry.name}${padding}  ${desc}`);
+            }
+        }
+    }
+    // Examples
+    if (examples && examples.length > 0) {
+        lines.push('');
+        lines.push('Examples:');
+        const maxLen = Math.max(...examples.map((e) => (e.command ? `$ ${name} ${e.command}` : `$ ${name}`).length));
+        for (const ex of examples) {
+            const cmd = ex.command ? `$ ${name} ${ex.command}` : `$ ${name}`;
+            if (ex.description)
+                lines.push(`  ${cmd}${' '.repeat(maxLen - cmd.length)}  ${ex.description}`);
+            else
+                lines.push(`  ${cmd}`);
+        }
+    }
+    // Hint
+    if (hint) {
+        lines.push('');
+        lines.push(hint);
+    }
+    lines.push(...globalOptionsLines(root));
+    return lines.join('\n');
+}
+/** Builds the synopsis string with `<required>` and `[optional]` placeholders. */
+function buildSynopsis(name, args) {
+    if (!args)
+        return name;
+    const parts = [name];
+    for (const [key, schema] of Object.entries(args.shape))
+        parts.push(schema.isOptional() ? `[${key}]` : `<${key}>`);
+    return parts.join(' ');
+}
+/** Extracts arg entries from a Zod object schema. */
+function argsEntries(schema) {
+    const entries = [];
+    for (const [key, field] of Object.entries(schema.shape))
+        entries.push({ name: key, description: field.description ?? '' });
+    return entries;
+}
+/** Extracts env var entries from a Zod object schema. */
+function envEntries(schema) {
+    const entries = [];
+    for (const [key, field] of Object.entries(schema.shape)) {
+        const defaultValue = extractDefault(field);
+        entries.push({ name: key, description: field.description ?? '', defaultValue });
+    }
+    return entries;
+}
+/** Extracts option entries from a Zod object schema. */
+function optionEntries(schema, alias) {
+    const entries = [];
+    for (const [key, field] of Object.entries(schema.shape)) {
+        const type = resolveTypeName(field);
+        const short = alias?.[key];
+        const kebab = toKebab(key);
+        const flag = short ? `--${kebab}, -${short} <${type}>` : `--${kebab} <${type}>`;
+        const defaultValue = extractDefault(field);
+        entries.push({ flag, description: field.description ?? '', defaultValue });
+    }
+    return entries;
+}
+/** Resolves a human-readable type name from a Zod schema. */
+function resolveTypeName(schema) {
+    const unwrapped = unwrap(schema);
+    if (unwrapped instanceof z.ZodString)
+        return 'string';
+    if (unwrapped instanceof z.ZodNumber)
+        return 'number';
+    if (unwrapped instanceof z.ZodBoolean)
+        return 'boolean';
+    if (unwrapped instanceof z.ZodArray)
+        return 'array';
+    return 'value';
+}
+/** Unwraps optional/default/nullable wrappers to get the inner type. */
+function unwrap(schema) {
+    if (schema instanceof z.ZodOptional)
+        return unwrap(schema.unwrap());
+    if (schema instanceof z.ZodDefault)
+        return unwrap(schema.removeDefault());
+    if (schema instanceof z.ZodNullable)
+        return unwrap(schema.unwrap());
+    return schema;
+}
+/** Extracts the default value from a Zod schema, if any. */
+function extractDefault(schema) {
+    if (schema instanceof z.ZodDefault) {
+        const raw = schema._def.defaultValue;
+        const value = typeof raw === 'function' ? raw() : raw;
+        if (Array.isArray(value) && value.length === 0)
+            return undefined;
+        return value;
+    }
+    if (schema instanceof z.ZodOptional)
+        return extractDefault(schema.unwrap());
+    return undefined;
+}
+/** Converts a camelCase string to kebab-case. */
+function toKebab(str) {
+    return str.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+}
+/** Renders the built-in commands and global options block. Root-only items are hidden for subcommands. */
+function globalOptionsLines(root = false) {
+    const lines = [];
+    if (root) {
+        const builtins = [
+            { name: 'mcp add', desc: 'Register as an MCP server' },
+            { name: 'skills add', desc: 'Sync skill files to your agent' },
+        ];
+        const maxCmd = Math.max(...builtins.map((b) => b.name.length));
+        lines.push('', 'Built-in Commands:', ...builtins.map((b) => `  ${b.name}${' '.repeat(maxCmd - b.name.length)}  ${b.desc}`));
+    }
+    const flags = [
+        { flag: '--format <toon|json|yaml|md|jsonl>', desc: 'Output format' },
+        { flag: '--help', desc: 'Show help' },
+        { flag: '--llms', desc: 'Print LLM-readable manifest' },
+        ...(root ? [{ flag: '--mcp', desc: 'Start as MCP stdio server' }] : []),
+        { flag: '--verbose', desc: 'Show full output envelope' },
+        ...(root ? [{ flag: '--version', desc: 'Show version' }] : []),
+    ];
+    const maxLen = Math.max(...flags.map((f) => f.flag.length));
+    lines.push('', 'Global Options:', ...flags.map((f) => `  ${f.flag}${' '.repeat(maxLen - f.flag.length)}  ${f.desc}`));
+    return lines;
+}
+//# sourceMappingURL=Help.js.map

package/dist/Help.js.map

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

package/dist/Mcp.d.ts

@@ -0,0 +1,13 @@
+import type { Readable, Writable } from 'node:stream';
+/** Starts a stdio MCP server that exposes commands as tools. */
+export declare function serve(name: string, version: string, commands: Map<string, any>, options?: serve.Options): Promise<void>;
+export declare namespace serve {
+    /** Options for the MCP server. */
+    type Options = {
+        /** Override input stream. Defaults to `process.stdin`. */
+        input?: Readable | undefined;
+        /** Override output stream. Defaults to `process.stdout`. */
+        output?: Writable | undefined;
+    };
+}
+//# sourceMappingURL=Mcp.d.ts.map

package/dist/Mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mcp.d.ts","sourceRoot":"","sources":["../src/Mcp.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAIrD,gEAAgE;AAChE,wBAAsB,KAAK,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,OAAO,GAAE,KAAK,CAAC,OAAY,GAC1B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,kCAAkC;IAClC,KAAK,OAAO,GAAG;QACb,0DAA0D;QAC1D,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;QAC5B,4DAA4D;QAC5D,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;KAC9B,CAAA;CACF"}

package/dist/Mcp.js

@@ -0,0 +1,140 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import * as Schema from './Schema.js';
+/** Starts a stdio MCP server that exposes commands as tools. */
+export async function serve(name, version, commands, options = {}) {
+    const server = new McpServer({ name, version });
+    for (const tool of collectTools(commands, [])) {
+        const mergedShape = {
+            ...tool.command.args?.shape,
+            ...tool.command.options?.shape,
+        };
+        const hasInput = Object.keys(mergedShape).length > 0;
+        server.registerTool(tool.name, {
+            ...(tool.description ? { description: tool.description } : undefined),
+            ...(hasInput ? { inputSchema: mergedShape } : undefined),
+        }, async (...callArgs) => {
+            // registerTool passes (args, extra) when inputSchema is set, (extra) when not
+            const params = hasInput ? callArgs[0] : {};
+            const extra = hasInput ? callArgs[1] : callArgs[0];
+            return callTool(tool, params, extra);
+        });
+    }
+    const input = options.input ?? process.stdin;
+    const output = options.output ?? process.stdout;
+    const transport = new StdioServerTransport(input, output);
+    await server.connect(transport);
+}
+/** @internal Executes a tool call and returns a CallToolResult. */
+async function callTool(tool, params, extra) {
+    try {
+        const { args, options } = splitParams(params, tool.command);
+        const parsedArgs = tool.command.args ? tool.command.args.parse(args) : {};
+        const parsedOptions = tool.command.options ? tool.command.options.parse(options) : {};
+        const parsedEnv = tool.command.env ? tool.command.env.parse(process.env) : {};
+        const sentinel = Symbol.for('incur.sentinel');
+        const okFn = (data) => ({ [sentinel]: 'ok', data });
+        const errorFn = (opts) => ({ [sentinel]: 'error', ...opts });
+        const raw = tool.command.run({
+            args: parsedArgs,
+            env: parsedEnv,
+            options: parsedOptions,
+            ok: okFn,
+            error: errorFn,
+        });
+        // Streaming: send progress notifications per chunk, then return buffered result
+        if (isAsyncGenerator(raw)) {
+            const chunks = [];
+            const progressToken = extra?._meta?.progressToken;
+            let i = 0;
+            for await (const chunk of raw) {
+                if (typeof chunk === 'object' && chunk !== null && sentinel in chunk) {
+                    const tagged = chunk;
+                    if (tagged[sentinel] === 'error')
+                        return {
+                            content: [{ type: 'text', text: tagged.message ?? 'Command failed' }],
+                            isError: true,
+                        };
+                }
+                chunks.push(chunk);
+                if (progressToken !== undefined && extra?.sendNotification)
+                    await extra.sendNotification({
+                        method: 'notifications/progress',
+                        params: { progressToken, progress: ++i, message: JSON.stringify(chunk) },
+                    });
+            }
+            return { content: [{ type: 'text', text: JSON.stringify(chunks) }] };
+        }
+        const awaited = await raw;
+        if (typeof awaited === 'object' && awaited !== null && sentinel in awaited) {
+            const tagged = awaited;
+            if (tagged[sentinel] === 'error')
+                return {
+                    content: [{ type: 'text', text: tagged.message ?? 'Command failed' }],
+                    isError: true,
+                };
+            return { content: [{ type: 'text', text: JSON.stringify(tagged.data) }] };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(awaited) }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: err instanceof Error ? err.message : String(err) }],
+            isError: true,
+        };
+    }
+}
+/** @internal Type guard for async generators. */
+function isAsyncGenerator(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        Symbol.asyncIterator in value &&
+        typeof value.next === 'function');
+}
+/** @internal Recursively collects leaf commands as tool entries. */
+function collectTools(commands, prefix) {
+    const result = [];
+    for (const [name, entry] of commands) {
+        const path = [...prefix, name];
+        if ('_group' in entry && entry._group)
+            result.push(...collectTools(entry.commands, path));
+        else {
+            result.push({
+                name: path.join('_'),
+                description: entry.description,
+                inputSchema: buildToolSchema(entry.args, entry.options),
+                command: entry,
+            });
+        }
+    }
+    return result.sort((a, b) => a.name.localeCompare(b.name));
+}
+/** @internal Builds a merged JSON Schema from args and options Zod schemas. */
+function buildToolSchema(args, options) {
+    const properties = {};
+    const required = [];
+    for (const schema of [args, options]) {
+        if (!schema)
+            continue;
+        const json = Schema.toJsonSchema(schema);
+        Object.assign(properties, json.properties ?? {});
+        required.push(...(json.required ?? []));
+    }
+    if (required.length > 0)
+        return { type: 'object', properties, required };
+    return { type: 'object', properties };
+}
+/** @internal Splits flat params into args vs options using schema shapes. */
+function splitParams(params, command) {
+    const argKeys = new Set(command.args ? Object.keys(command.args.shape) : []);
+    const a = {};
+    const o = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (argKeys.has(key))
+            a[key] = value;
+        else
+            o[key] = value;
+    }
+    return { args: a, options: o };
+}
+//# sourceMappingURL=Mcp.js.map

package/dist/Mcp.js.map

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

package/dist/Parser.d.ts

@@ -0,0 +1,24 @@
+import type { z } from 'zod';
+/** Parses raw argv tokens against Zod schemas for args and options. */
+export declare function parse<const args extends z.ZodObject<any> | undefined = undefined, const options extends z.ZodObject<any> | undefined = undefined>(argv: string[], options?: parse.Options<args, options>): parse.ReturnType<args, options>;
+export declare namespace parse {
+    /** Options for parsing. */
+    type Options<args extends z.ZodObject<any> | undefined = undefined, options extends z.ZodObject<any> | undefined = undefined> = {
+        /** Zod schema for positional arguments. Keys define order. */
+        args?: args;
+        /** Zod schema for named options/flags. */
+        options?: options;
+        /** Map of option names to single-char aliases. */
+        alias?: Record<string, string> | undefined;
+    };
+    /** Parsed result with args and options. */
+    type ReturnType<args extends z.ZodObject<any> | undefined = undefined, options extends z.ZodObject<any> | undefined = undefined> = {
+        /** Parsed positional arguments. */
+        args: args extends z.ZodObject<any> ? z.output<args> : {};
+        /** Parsed named options. */
+        options: options extends z.ZodObject<any> ? z.output<options> : {};
+    };
+}
+/** Parses environment variables against a Zod schema. Falls back to `process.env` → `Deno.env` when no source is provided. */
+export declare function parseEnv<const env extends z.ZodObject<any>>(schema: env, source?: Record<string, string | undefined>): z.output<env>;
+//# sourceMappingURL=Parser.d.ts.map

package/dist/Parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Parser.d.ts","sourceRoot":"","sources":["../src/Parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAK5B,uEAAuE;AACvE,wBAAgB,KAAK,CACnB,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,EAC3D,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,EAC9D,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAM,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAsG7F;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,2BAA2B;IAC3B,KAAK,OAAO,CACV,IAAI,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,EACrD,OAAO,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,IACtD;QACF,8DAA8D;QAC9D,IAAI,CAAC,EAAE,IAAI,CAAA;QACX,0CAA0C;QAC1C,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,kDAAkD;QAClD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;KAC3C,CAAA;IACD,2CAA2C;IAC3C,KAAK,UAAU,CACb,IAAI,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,EACrD,OAAO,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,SAAS,IACtD;QACF,mCAAmC;QACnC,IAAI,EAAE,IAAI,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;QACzD,4BAA4B;QAC5B,OAAO,EAAE,OAAO,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAA;KACnE,CAAA;CACF;AAgED,8HAA8H;AAC9H,wBAAgB,QAAQ,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EACzD,MAAM,EAAE,GAAG,EACX,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAsB,GAC9D,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAOf"}

package/dist/Parser.js

@@ -0,0 +1,215 @@
+import { ParseError, ValidationError } from './Errors.js';
+/** Parses raw argv tokens against Zod schemas for args and options. */
+export function parse(argv, options = {}) {
+    const { args: argsSchema, options: optionsSchema, alias } = options;
+    // Build reverse alias map: short char → long name
+    const aliasToName = new Map();
+    if (alias)
+        for (const [name, short] of Object.entries(alias))
+            aliasToName.set(short, name);
+    // Known option names from schema, plus kebab-case → camelCase map
+    const knownOptions = new Set(optionsSchema ? Object.keys(optionsSchema.shape) : []);
+    const kebabToCamel = new Map();
+    for (const name of knownOptions) {
+        const kebab = name.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+        if (kebab !== name)
+            kebabToCamel.set(kebab, name);
+    }
+    // First pass: split argv into positional tokens and raw option values
+    const positionals = [];
+    const rawOptions = {};
+    let i = 0;
+    while (i < argv.length) {
+        const token = argv[i];
+        if (token.startsWith('--no-') && token.length > 5) {
+            // --no-flag negation
+            const raw = token.slice(5);
+            const name = kebabToCamel.get(raw) ?? raw;
+            if (!knownOptions.has(name))
+                throw new ParseError({ message: `Unknown flag: ${token}` });
+            rawOptions[name] = false;
+            i++;
+        }
+        else if (token.startsWith('--')) {
+            const eqIdx = token.indexOf('=');
+            if (eqIdx !== -1) {
+                // --flag=value
+                const raw = token.slice(2, eqIdx);
+                const name = kebabToCamel.get(raw) ?? raw;
+                if (!knownOptions.has(name))
+                    throw new ParseError({ message: `Unknown flag: --${raw}` });
+                setOption(rawOptions, name, token.slice(eqIdx + 1), optionsSchema);
+                i++;
+            }
+            else {
+                // --flag [value]
+                const raw = token.slice(2);
+                const name = kebabToCamel.get(raw) ?? raw;
+                if (!knownOptions.has(name))
+                    throw new ParseError({ message: `Unknown flag: ${token}` });
+                if (isBooleanOption(name, optionsSchema)) {
+                    rawOptions[name] = true;
+                    i++;
+                }
+                else {
+                    const value = argv[i + 1];
+                    if (value === undefined)
+                        throw new ParseError({ message: `Missing value for flag: ${token}` });
+                    setOption(rawOptions, name, value, optionsSchema);
+                    i += 2;
+                }
+            }
+        }
+        else if (token.startsWith('-') && token.length === 2) {
+            // -f [value]
+            const short = token.slice(1);
+            const name = aliasToName.get(short);
+            if (!name)
+                throw new ParseError({ message: `Unknown flag: ${token}` });
+            if (isBooleanOption(name, optionsSchema)) {
+                rawOptions[name] = true;
+                i++;
+            }
+            else {
+                const value = argv[i + 1];
+                if (value === undefined)
+                    throw new ParseError({ message: `Missing value for flag: ${token}` });
+                setOption(rawOptions, name, value, optionsSchema);
+                i += 2;
+            }
+        }
+        else {
+            positionals.push(token);
+            i++;
+        }
+    }
+    // Assign positionals to args schema keys in order
+    const rawArgs = {};
+    if (argsSchema) {
+        const keys = Object.keys(argsSchema.shape);
+        for (let j = 0; j < keys.length; j++) {
+            const key = keys[j];
+            if (positionals[j] !== undefined) {
+                rawArgs[key] = positionals[j];
+            }
+        }
+    }
+    // Validate args through zod
+    const args = argsSchema ? zodParse(argsSchema, rawArgs) : {};
+    // Coerce raw option values before zod validation
+    if (optionsSchema) {
+        for (const [name, value] of Object.entries(rawOptions)) {
+            rawOptions[name] = coerce(value, name, optionsSchema);
+        }
+    }
+    // Validate options through zod
+    const parsedOptions = optionsSchema ? zodParse(optionsSchema, rawOptions) : {};
+    return { args, options: parsedOptions };
+}
+/** Unwraps ZodDefault/ZodOptional to get the inner type. */
+function unwrap(schema) {
+    let s = schema;
+    while (s._zod?.def?.innerType)
+        s = s._zod.def.innerType;
+    return s;
+}
+/** Checks if an option's inner type is boolean. */
+function isBooleanOption(name, schema) {
+    if (!schema)
+        return false;
+    const field = schema.shape[name];
+    if (!field)
+        return false;
+    return unwrap(field).constructor.name === 'ZodBoolean';
+}
+/** Checks if an option's inner type is an array. */
+function isArrayOption(name, schema) {
+    if (!schema)
+        return false;
+    const field = schema.shape[name];
+    if (!field)
+        return false;
+    return unwrap(field).constructor.name === 'ZodArray';
+}
+/** Sets an option value, collecting into arrays for array schemas. */
+function setOption(raw, name, value, schema) {
+    if (isArrayOption(name, schema)) {
+        const existing = raw[name];
+        if (Array.isArray(existing)) {
+            existing.push(value);
+        }
+        else {
+            raw[name] = [value];
+        }
+    }
+    else {
+        raw[name] = value;
+    }
+}
+/** Wraps zod schema.parse(), converting ZodError to ValidationError. */
+function zodParse(schema, data) {
+    try {
+        return schema.parse(data);
+    }
+    catch (err) {
+        const issues = err?.issues ?? err?.error?.issues ?? [];
+        const fieldErrors = issues.map((issue) => ({
+            path: (issue.path ?? []).join('.'),
+            expected: issue.expected ?? '',
+            received: issue.received ?? '',
+            message: issue.message ?? '',
+        }));
+        throw new ValidationError({
+            message: issues.map((i) => i.message).join('; ') || 'Validation failed',
+            fieldErrors,
+            cause: err instanceof Error ? err : undefined,
+        });
+    }
+}
+/** Parses environment variables against a Zod schema. Falls back to `process.env` → `Deno.env` when no source is provided. */
+export function parseEnv(schema, source = defaultEnvSource()) {
+    const raw = {};
+    for (const [key, field] of Object.entries(schema.shape)) {
+        const value = source[key];
+        if (value !== undefined)
+            raw[key] = coerceEnv(value, field);
+    }
+    return zodParse(schema, raw);
+}
+/** Coerces an env var string to the type expected by the schema field. */
+function coerceEnv(value, field) {
+    const inner = unwrap(field);
+    const typeName = inner.constructor.name;
+    if (typeName === 'ZodNumber')
+        return Number(value);
+    if (typeName === 'ZodBoolean')
+        return value === 'true' || value === '1';
+    return value;
+}
+/** Coerces a raw string value to the type expected by the schema. */
+function coerce(value, name, schema) {
+    const field = schema.shape[name];
+    if (!field)
+        return value;
+    const inner = unwrap(field);
+    const typeName = inner.constructor.name;
+    if (typeName === 'ZodNumber' && typeof value === 'string') {
+        return Number(value);
+    }
+    if (typeName === 'ZodBoolean' && typeof value === 'string') {
+        return value === 'true';
+    }
+    return value;
+}
+/** Returns the best available env source for the current runtime. */
+function defaultEnvSource() {
+    if (typeof globalThis !== 'undefined') {
+        const g = globalThis;
+        if (g.process?.env)
+            return g.process.env;
+        if (g.Deno?.env)
+            return new Proxy({}, { get: (_, key) => g.Deno.env.get(key) });
+    }
+    return {};
+}
+//# sourceMappingURL=Parser.js.map