@runa-cmd/core 0.1.0

package/dist/cli.js

@@ -0,0 +1,413 @@
+/**
+ * @runa-cmd/core — defineCLI() + runCLI()
+ *
+ * The main CLI orchestrator. Wires together:
+ * - Command resolution (including subcommands)
+ * - Parsing pipeline (schema-walker → parseArgs-bridge → util.parseArgs → resolve)
+ * - Lifecycle hooks (7-hook pipeline)
+ * - Plugin loading (topological sort, setup/cleanup)
+ * - Middleware execution (Koa/Hono onion model)
+ * - Config loading
+ * - Error handling
+ */
+import { parseArgs } from 'node:util';
+import { loadAndMergeConfig } from './config/merge.js';
+import { CommandNotFoundError, RunaError } from './errors.js';
+import { getSchema } from './introspect.js';
+import { createHookRegistry } from './lifecycle.js';
+import { buildParseArgsConfig } from './parse/parseargs-bridge.js';
+import { resolveValues } from './parse/resolve.js';
+import { walkSchema } from './parse/schema-walker.js';
+import { resolvePlugins, runPluginCleanup, runPluginSetup, topologicalSort } from './plugin.js';
+/**
+ * Check if a value is a Command (branded object).
+ */
+function isCommand(value) {
+    return '_type' in value && value._type === 'runa:command';
+}
+/**
+ * Levenshtein distance for "did you mean" suggestions.
+ */
+function levenshtein(a, b) {
+    const rows = b.length + 1;
+    const cols = a.length + 1;
+    // Use a flat array for guaranteed index access without non-null assertions
+    const matrix = new Array(rows * cols).fill(0);
+    const at = (i, j) => matrix[i * cols + j] ?? 0;
+    const set = (i, j, v) => {
+        matrix[i * cols + j] = v;
+    };
+    for (let i = 0; i < rows; i++)
+        set(i, 0, i);
+    for (let j = 0; j < cols; j++)
+        set(0, j, j);
+    for (let i = 1; i < rows; i++) {
+        for (let j = 1; j < cols; j++) {
+            if (b[i - 1] === a[j - 1]) {
+                set(i, j, at(i - 1, j - 1));
+            }
+            else {
+                set(i, j, Math.min(at(i - 1, j - 1) + 1, // substitution
+                at(i, j - 1) + 1, // insertion
+                at(i - 1, j) + 1));
+            }
+        }
+    }
+    return at(b.length, a.length);
+}
+/**
+ * Find the best suggestion for a misspelled command name.
+ * Returns undefined if no close match exists (distance > 3).
+ */
+function findSuggestion(input, candidates) {
+    let best;
+    let bestDist = Infinity;
+    for (const candidate of candidates) {
+        const dist = levenshtein(input, candidate);
+        if (dist < bestDist) {
+            bestDist = dist;
+            best = candidate;
+        }
+    }
+    // Only suggest if reasonably close
+    return bestDist <= 3 ? best : undefined;
+}
+/**
+ * Resolve a command from the command tree by walking argv tokens.
+ * Supports nested subcommands.
+ */
+function resolveCommand(commands, tokens) {
+    let current = commands;
+    let consumed = 0;
+    for (let i = 0; i < tokens.length; i++) {
+        const token = tokens[i];
+        if (token === undefined)
+            break;
+        // Stop at flags — they're not command names
+        if (token.startsWith('-'))
+            break;
+        const entry = current[token];
+        if (!entry)
+            break;
+        consumed++;
+        if (isCommand(entry)) {
+            return {
+                command: entry,
+                remainingArgv: tokens.slice(consumed),
+            };
+        }
+        // It's a subtree — continue walking
+        current = entry;
+    }
+    // If we're in a subtree and haven't found a command, check for a default/index command
+    // For now, throw CommandNotFoundError
+    const commandName = tokens[consumed] ?? tokens[consumed - 1] ?? '';
+    const candidates = Object.keys(current);
+    const suggestion = commandName ? findSuggestion(commandName, candidates) : undefined;
+    if (!commandName && consumed === 0) {
+        throw new CommandNotFoundError('(no command specified)', undefined);
+    }
+    throw new CommandNotFoundError(tokens.slice(0, consumed + 1).join(' '), suggestion);
+}
+// ─── Middleware Composition ─────────────────────────────────
+/**
+ * Compose middleware into a nested chain.
+ * Outermost middleware is first in the array.
+ * Innermost next() calls the command execution function.
+ */
+function composeMiddleware(middlewareList, globalOptions, innerFn) {
+    // Build the chain from inside out
+    let chain = innerFn;
+    for (let i = middlewareList.length - 1; i >= 0; i--) {
+        const mw = middlewareList[i];
+        if (!mw)
+            continue;
+        const next = chain;
+        chain = () => {
+            const ctx = {
+                next: async () => {
+                    await next();
+                },
+                globalOptions,
+            };
+            return mw.handler(ctx);
+        };
+    }
+    return chain;
+}
+// ─── CLI Execution Engine ───────────────────────────────────
+/**
+ * Run the full CLI lifecycle.
+ */
+async function runCLILifecycle(config, argv) {
+    // ─── State ─────────────────────────────────────────
+    const hookRegistry = createHookRegistry();
+    const mutableCommands = { ...config.commands };
+    const mutableGlobalOptions = { ...(config.globalOptions ?? {}) };
+    const mutableGlobalMeta = {
+        options: { ...(config.globalMeta?.options ?? {}) },
+    };
+    const mutableMiddleware = [...(config.middleware ?? [])];
+    let sortedPlugins = [];
+    // Hook context that grows as we progress through the lifecycle
+    const hookCtx = {
+        cli: config.meta,
+        rawArgs: argv,
+    };
+    let lifecycleError;
+    let commandResult;
+    try {
+        // ─── Plugin resolution ────────────────────────────
+        if (config.plugins && config.plugins.length > 0) {
+            const resolvedPlugins = await resolvePlugins(config.plugins);
+            sortedPlugins = topologicalSort(resolvedPlugins);
+            // Create plugin host refs
+            const pluginRefs = {
+                commands: mutableCommands,
+                globalOptions: mutableGlobalOptions,
+                globalMeta: mutableGlobalMeta,
+                middleware: mutableMiddleware,
+                hookRegister: (name, handler) => hookRegistry.register(name, handler),
+                getSchema: () => getSchema({ ...config, commands: mutableCommands }, mutableGlobalOptions, mutableGlobalMeta.options),
+            };
+            await runPluginSetup(sortedPlugins, pluginRefs);
+        }
+        // ─── beforeParse ──────────────────────────────────
+        await hookRegistry.emit('beforeParse', hookCtx);
+        // Handlers may have mutated hookCtx.rawArgs
+        const currentArgv = hookCtx.rawArgs;
+        // ─── Parse global options ─────────────────────────
+        let parsedGlobalOptions = {};
+        if (Object.keys(mutableGlobalOptions).length > 0) {
+            const globalMetadata = walkSchema(mutableGlobalOptions);
+            const { parseArgsConfig, longAliasMap } = buildParseArgsConfig(globalMetadata, mutableGlobalMeta.options, true);
+            // Build lookup maps for global options:
+            // longNames: '--verbose' → 'verbose' (canonical name)
+            // shortNames: '-V' → 'verbose' (canonical name)
+            // booleanGlobals: set of canonical names that are boolean type
+            const longNames = new Map();
+            const shortNames = new Map();
+            const booleanGlobals = new Set();
+            const registeredOptions = parseArgsConfig.options ?? {};
+            for (const [name, opt] of Object.entries(registeredOptions)) {
+                const canonical = longAliasMap[name] ?? name;
+                longNames.set(`--${name}`, canonical);
+                // --no-* negation for booleans
+                if (opt?.type === 'boolean') {
+                    booleanGlobals.add(canonical);
+                    longNames.set(`--no-${name}`, canonical);
+                }
+                if (opt && 'short' in opt && opt.short) {
+                    shortNames.set(`-${opt.short}`, canonical);
+                }
+            }
+            // Long aliases
+            for (const [alias, canonical] of Object.entries(longAliasMap)) {
+                longNames.set(`--${alias}`, canonical);
+            }
+            // Manual argv split: extract global option tokens, leave the rest
+            const globalArgv = [];
+            const commandArgv = [];
+            let i = 0;
+            while (i < currentArgv.length) {
+                const token = currentArgv[i] ?? '';
+                // Handle --opt=val form
+                const eqIdx = token.indexOf('=');
+                const tokenKey = eqIdx > 0 ? token.slice(0, eqIdx) : token;
+                if (longNames.has(tokenKey) || shortNames.has(tokenKey)) {
+                    const canonical = longNames.get(tokenKey) ?? shortNames.get(tokenKey) ?? '';
+                    const isBool = booleanGlobals.has(canonical);
+                    if (eqIdx > 0) {
+                        // --opt=val — single token, always extract
+                        globalArgv.push(token);
+                        i++;
+                    }
+                    else if (isBool) {
+                        // --verbose or --no-verbose — boolean, no value token
+                        globalArgv.push(token);
+                        i++;
+                    }
+                    else {
+                        // --opt val — string option, extract both tokens
+                        globalArgv.push(token);
+                        i++;
+                        if (i < currentArgv.length) {
+                            globalArgv.push(currentArgv[i] ?? '');
+                            i++;
+                        }
+                    }
+                }
+                else {
+                    commandArgv.push(token);
+                    i++;
+                }
+            }
+            // Now parse ONLY the extracted global tokens with parseArgs
+            const globalParseResult = parseArgs({
+                ...parseArgsConfig,
+                args: globalArgv,
+            });
+            const { parsedOptions } = resolveValues({
+                parseArgsResult: {
+                    values: globalParseResult.values,
+                    positionals: [],
+                },
+                longAliasMap,
+                schemas: { options: mutableGlobalOptions },
+                meta: { options: mutableGlobalMeta.options },
+            });
+            parsedGlobalOptions = parsedOptions;
+            // Pass remaining argv (command tokens only) to command parsing
+            hookCtx.rawArgs = commandArgv;
+        }
+        hookCtx.globalOptions = parsedGlobalOptions;
+        // ─── onGlobalFlags ────────────────────────────────
+        const globalFlagsResult = await hookRegistry.emit('onGlobalFlags', hookCtx);
+        if (globalFlagsResult.shortCircuited) {
+            // Short-circuit: skip command resolution and execution, go to cleanup
+            return;
+        }
+        // ─── Resolve command ──────────────────────────────
+        const commandArgv = hookCtx.rawArgs;
+        const { command, remainingArgv } = resolveCommandFromTree(mutableCommands, commandArgv, config);
+        hookCtx.command = command.meta;
+        // ─── Parse command args + options ──────────────────
+        const optionMetadata = command.options ? walkSchema(command.options) : [];
+        const { parseArgsConfig, longAliasMap } = buildParseArgsConfig(optionMetadata, command.meta.options, !!command.args);
+        const cmdParseResult = parseArgs({
+            ...parseArgsConfig,
+            args: remainingArgv,
+        });
+        // Load config values if configured
+        let configValues;
+        if (config.config) {
+            configValues = await loadAndMergeConfig(config.config);
+        }
+        const { parsedArgs, parsedOptions } = resolveValues({
+            parseArgsResult: {
+                values: cmdParseResult.values,
+                positionals: cmdParseResult.positionals,
+            },
+            longAliasMap,
+            schemas: {
+                args: command.args,
+                options: command.options,
+            },
+            meta: { options: command.meta.options },
+            configValues,
+        });
+        hookCtx.args = parsedArgs;
+        hookCtx.options = parsedOptions;
+        // ─── afterParse ───────────────────────────────────
+        await hookRegistry.emit('afterParse', hookCtx);
+        // ─── beforeRun ────────────────────────────────────
+        await hookRegistry.emit('beforeRun', hookCtx);
+        // ─── Middleware chain + command execution ──────────
+        const runContext = {
+            args: parsedArgs,
+            options: parsedOptions,
+            globalOptions: parsedGlobalOptions,
+            command: command.meta,
+            rawArgs: argv,
+        };
+        const innerFn = async () => {
+            commandResult = await command.run(runContext);
+            // Validate output schema if present
+            if (command.output) {
+                command.output.parse(commandResult);
+            }
+        };
+        const chain = composeMiddleware(mutableMiddleware, parsedGlobalOptions, innerFn);
+        await chain();
+        // ─── afterRun ─────────────────────────────────────
+        await hookRegistry.emit('afterRun', hookCtx);
+    }
+    catch (err) {
+        lifecycleError = err instanceof Error ? err : new Error(String(err));
+        // ─── onError ──────────────────────────────────────
+        hookCtx.error = lifecycleError;
+        try {
+            await hookRegistry.emit('onError', hookCtx);
+        }
+        catch {
+            // onError handler threw — swallow it, cleanup still needs to run
+        }
+        // If error was not handled, fall back to default behavior
+        if (!hookCtx.handled) {
+            const exitCode = lifecycleError instanceof RunaError ? lifecycleError.exitCode : 1;
+            console.error(lifecycleError.message);
+            process.exit(exitCode);
+        }
+    }
+    finally {
+        // ─── cleanup (ALWAYS runs) ────────────────────────
+        try {
+            await hookRegistry.emit('cleanup', hookCtx);
+        }
+        catch {
+            // Cleanup hook errors are swallowed
+        }
+        // Plugin cleanup in reverse topological order
+        if (sortedPlugins.length > 0) {
+            const cleanupErrors = await runPluginCleanup(sortedPlugins);
+            if (cleanupErrors.length > 0) {
+                for (const err of cleanupErrors) {
+                    console.error(`Plugin cleanup error: ${err.message}`);
+                }
+            }
+        }
+    }
+}
+/**
+ * Resolve command with single-command mode support.
+ * If there's exactly one command, route directly without requiring
+ * the command name in argv.
+ */
+function resolveCommandFromTree(commands, argv, _config) {
+    const commandEntries = Object.entries(commands);
+    // Single-command mode: if exactly one command and first token doesn't match it,
+    // route directly to that command
+    if (commandEntries.length === 1) {
+        const firstEntry = commandEntries[0];
+        if (firstEntry) {
+            const [name, entry] = firstEntry;
+            if (isCommand(entry)) {
+                // If argv is empty or first token doesn't match the command name
+                if (argv.length === 0 || argv[0] !== name) {
+                    return { command: entry, remainingArgv: argv };
+                }
+                // First token matches — consume it
+                return { command: entry, remainingArgv: argv.slice(1) };
+            }
+        }
+    }
+    // Multi-command mode: resolve from tree
+    return resolveCommand(commands, argv);
+}
+// ─── Public API ─────────────────────────────────────────────
+/**
+ * Create a CLI from a configuration.
+ * Returns a branded CLI object with a .run() method.
+ */
+export function defineCLI(config) {
+    return {
+        _type: 'runa:cli',
+        config,
+        async run(argv) {
+            const effectiveArgv = argv ?? process.argv.slice(2);
+            await runCLILifecycle(config, effectiveArgv);
+        },
+    };
+}
+/**
+ * Single-command shorthand.
+ * Wraps a command in defineCLI() and runs it.
+ */
+export async function runCLI(command, argv) {
+    const cli = defineCLI({
+        meta: { name: command.meta.name, description: command.meta.description },
+        commands: { [command.meta.name]: command },
+    });
+    await cli.run(argv);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/command.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @runa-cmd/core — defineCommand()
+ *
+ * Builder function that creates a typed, branded Command object from
+ * a CommandConfig. Validates variadic args and meta.options keys at
+ * definition time.
+ */
+import type { ZodType } from 'zod';
+import type { Command, CommandConfig } from './types.js';
+/**
+ * Create a typed Command from a CommandConfig.
+ *
+ * Validates at definition time:
+ * - Variadic args (z.array()) must be the last positional arg
+ * - meta.options keys must be a subset of options keys
+ *
+ * Returns a branded Command object with full generic inference preserved.
+ */
+export declare function defineCommand<TArgs extends Record<string, ZodType> = Record<string, ZodType>, TOptions extends Record<string, ZodType> = Record<string, ZodType>, TOutput extends ZodType | undefined = undefined>(config: CommandConfig<TArgs, TOptions, TOutput>): Command;
+//# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAGnC,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAA2B,MAAM,YAAY,CAAC;AA6BlF;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC5B,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,OAAO,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EAC9C,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,OAAO,CAkB1D"}

package/dist/command.js

@@ -0,0 +1,46 @@
+import { RunaError } from './errors.js';
+import { validateVariadicArgs } from './parse/variadic.js';
+// ─── Definition-time validation ─────────────────────────────
+/**
+ * Validate that keys in meta.options are a subset of the options schema keys.
+ * This is a runtime complement to TypeScript's compile-time constraint.
+ */
+function validateMetaOptionsKeys(meta, options) {
+    if (!meta.options)
+        return;
+    const optionKeys = options ? new Set(Object.keys(options)) : new Set();
+    for (const key of Object.keys(meta.options)) {
+        if (!optionKeys.has(key)) {
+            throw new RunaError(`meta.options contains key '${key}' that is not defined in options. ` +
+                `Available keys: ${optionKeys.size > 0 ? [...optionKeys].map((k) => `'${k}'`).join(', ') : '(none)'}.`, { code: 'INVALID_META_OPTIONS', exitCode: 1 });
+        }
+    }
+}
+// ─── Public API ─────────────────────────────────────────────
+/**
+ * Create a typed Command from a CommandConfig.
+ *
+ * Validates at definition time:
+ * - Variadic args (z.array()) must be the last positional arg
+ * - meta.options keys must be a subset of options keys
+ *
+ * Returns a branded Command object with full generic inference preserved.
+ */
+export function defineCommand(config) {
+    // Validate variadic args at definition time
+    if (config.args) {
+        validateVariadicArgs(config.args);
+    }
+    // Validate meta.options keys match options keys
+    validateMetaOptionsKeys(config.meta, config.options);
+    // Construct branded Command object
+    return {
+        _type: 'runa:command',
+        meta: config.meta,
+        args: config.args,
+        options: config.options,
+        output: config.output,
+        run: config.run,
+    };
+}
+//# sourceMappingURL=command.js.map

package/dist/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,+DAA+D;AAE/D;;;GAGG;AACH,SAAS,uBAAuB,CAC/B,IAA2B,EAC3B,OAAkB;IAElB,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO;IAE1B,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAU,CAAC;IAE/E,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,SAAS,CAClB,8BAA8B,GAAG,oCAAoC;gBACpE,mBAAmB,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,EACvG,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,CAAC,EAAE,CAC7C,CAAC;QACH,CAAC;IACF,CAAC;AACF,CAAC;AAED,+DAA+D;AAE/D;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAI3B,MAA+C;IAChD,4CAA4C;IAC5C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,oBAAoB,CAAC,MAAM,CAAC,IAA+B,CAAC,CAAC;IAC9D,CAAC;IAED,gDAAgD;IAChD,uBAAuB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAErD,mCAAmC;IACnC,OAAO;QACN,KAAK,EAAE,cAAuB;QAC9B,IAAI,EAAE,MAAM,CAAC,IAAmB;QAChC,IAAI,EAAE,MAAM,CAAC,IAA2C;QACxD,OAAO,EAAE,MAAM,CAAC,OAA8C;QAC9D,MAAM,EAAE,MAAM,CAAC,MAA6B;QAC5C,GAAG,EAAE,MAAM,CAAC,GAAmC;KAC/C,CAAC;AACH,CAAC"}

package/dist/config/loader.d.ts

@@ -0,0 +1,9 @@
+import type { ConfigLoader } from '../types.js';
+export type { ConfigLoader } from '../types.js';
+/**
+ * Built-in JSON config file loader.
+ * Reads the file and parses it with JSON.parse().
+ * Wraps parse errors with a descriptive message including file path.
+ */
+export declare function jsonLoader(): ConfigLoader;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAsBzC"}

package/dist/config/loader.js

@@ -0,0 +1,34 @@
+/**
+ * @runa-cmd/core — Config file loader
+ *
+ * ConfigLoader interface + built-in JSON loader.
+ * Uses node:fs/promises for zero runtime dependencies.
+ */
+import { readFile } from 'node:fs/promises';
+// ─── Public API ─────────────────────────────────────────────
+/**
+ * Built-in JSON config file loader.
+ * Reads the file and parses it with JSON.parse().
+ * Wraps parse errors with a descriptive message including file path.
+ */
+export function jsonLoader() {
+    return {
+        extensions: ['.json'],
+        async load(filePath) {
+            let content;
+            try {
+                content = await readFile(filePath, 'utf-8');
+            }
+            catch (err) {
+                throw new Error(`Failed to read config file '${filePath}': ${err instanceof Error ? err.message : String(err)}`);
+            }
+            try {
+                return JSON.parse(content);
+            }
+            catch (err) {
+                throw new Error(`Invalid JSON in config file '${filePath}': ${err instanceof Error ? err.message : String(err)}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAM5C,+DAA+D;AAE/D;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACzB,OAAO;QACN,UAAU,EAAE,CAAC,OAAO,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,QAAgB;YAC1B,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACJ,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CACd,+BAA+B,QAAQ,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC/F,CAAC;YACH,CAAC;YAED,IAAI,CAAC;gBACJ,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAC;YACvC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CACd,gCAAgC,QAAQ,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAChG,CAAC;YACH,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/config/merge.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @runa-cmd/core — Config loading orchestration
+ *
+ * Searches for a config file using registered loaders, loads it,
+ * and returns the raw config values. The actual merge priority
+ * (CLI > env > config > defaults) is handled in resolve.ts.
+ */
+import type { CLIConfigOptions } from '../types.js';
+/**
+ * Load config values from a config file, if found.
+ *
+ * 1. Combines built-in JSON loader with any additional loaders
+ * 2. Searches configured paths for matching config files
+ * 3. Loads and returns the parsed config
+ * 4. Returns undefined if no config file found
+ */
+export declare function loadAndMergeConfig(configOptions: CLIConfigOptions): Promise<Record<string, unknown> | undefined>;
+//# sourceMappingURL=merge.d.ts.map

package/dist/config/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/config/merge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMpD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACvC,aAAa,EAAE,gBAAgB,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CA0B9C"}

package/dist/config/merge.js

@@ -0,0 +1,31 @@
+import { jsonLoader } from './loader.js';
+import { searchConfig } from './search.js';
+// ─── Public API ─────────────────────────────────────────────
+/**
+ * Load config values from a config file, if found.
+ *
+ * 1. Combines built-in JSON loader with any additional loaders
+ * 2. Searches configured paths for matching config files
+ * 3. Loads and returns the parsed config
+ * 4. Returns undefined if no config file found
+ */
+export async function loadAndMergeConfig(configOptions) {
+    // Combine built-in JSON loader with additional loaders
+    const builtInLoader = jsonLoader();
+    const allLoaders = [builtInLoader, ...(configOptions.loaders ?? [])];
+    // Default search paths: current dir, then home dir
+    const searchPaths = configOptions.searchPaths ?? ['.', '~'];
+    // Search for config file
+    const result = await searchConfig(configOptions.name, allLoaders, searchPaths);
+    if (!result) {
+        return undefined;
+    }
+    // Load and return config values
+    const config = await result.loader.load(result.filePath);
+    // Config files should return plain objects
+    if (config === null || typeof config !== 'object' || Array.isArray(config)) {
+        throw new Error(`Config file '${result.filePath}' must export a plain object, got ${Array.isArray(config) ? 'array' : typeof config}.`);
+    }
+    return config;
+}
+//# sourceMappingURL=merge.js.map

package/dist/config/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/config/merge.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,+DAA+D;AAE/D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,aAA+B;IAE/B,uDAAuD;IACvD,MAAM,aAAa,GAAG,UAAU,EAAE,CAAC;IACnC,MAAM,UAAU,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,aAAa,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IAErE,mDAAmD;IACnD,MAAM,WAAW,GAAG,aAAa,CAAC,WAAW,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAE5D,yBAAyB;IACzB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAE/E,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,gCAAgC;IAChC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEzD,2CAA2C;IAC3C,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CACd,gBAAgB,MAAM,CAAC,QAAQ,qCAAqC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,MAAM,GAAG,CACtH,CAAC;IACH,CAAC;IAED,OAAO,MAAiC,CAAC;AAC1C,CAAC"}

package/dist/config/search.d.ts

@@ -0,0 +1,18 @@
+import type { ConfigLoader } from '../types.js';
+export interface SearchResult {
+    filePath: string;
+    loader: ConfigLoader;
+}
+/**
+ * Search for a config file in the given paths.
+ *
+ * For each search path, for each loader, checks if
+ * `{path}/{name}.config{ext}` exists.
+ *
+ * Search paths are checked in order; first match wins.
+ * '~' is resolved to os.homedir().
+ *
+ * Returns null if no config file is found (not an error).
+ */
+export declare function searchConfig(name: string, loaders: ConfigLoader[], searchPaths: string[]): Promise<SearchResult | null>;
+//# sourceMappingURL=search.d.ts.map

package/dist/config/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/config/search.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EAAE,EACvB,WAAW,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAmB9B"}