@optique/config 1.0.0-dev.428 → 1.0.0-dev.431

package/dist/run.js

@@ -1,189 +0,0 @@
-import { clearActiveConfig, configKey, setActiveConfig } from "./src-Dm_17c1d.js";
-import { readFile } from "node:fs/promises";
-import { basename } from "node:path";
-import process from "node:process";
-import { runWith } from "@optique/core/facade";
-
-//#region src/run.ts
-function isErrnoException(error) {
-	return typeof error === "object" && error !== null && "code" in error;
-}
-/**
-* Helper function to create a wrapper SourceContext for config loading.
-* @internal
-*/
-function createConfigSourceContext(context, options) {
-	return {
-		id: context.id,
-		async getAnnotations(parsed) {
-			if (!parsed) return {};
-			let configData;
-			if ("load" in options) {
-				const customOptions = options;
-				try {
-					const rawData = await Promise.resolve(customOptions.load(parsed));
-					const validation = context.schema["~standard"].validate(rawData);
-					let validationResult;
-					if (validation instanceof Promise) validationResult = await validation;
-					else validationResult = validation;
-					if (validationResult.issues) {
-						const firstIssue = validationResult.issues[0];
-						throw new Error(`Config validation failed: ${firstIssue?.message ?? "Unknown error"}`);
-					}
-					configData = validationResult.value;
-				} catch (error) {
-					if (error instanceof Error && error.message.includes("validation")) throw error;
-					throw error;
-				}
-			} else {
-				const singleFileOptions = options;
-				const configPath = singleFileOptions.getConfigPath(parsed);
-				if (configPath) try {
-					const contents = await readFile(configPath);
-					let rawData;
-					if (singleFileOptions.fileParser) rawData = singleFileOptions.fileParser(contents);
-					else {
-						const text = new TextDecoder().decode(contents);
-						rawData = JSON.parse(text);
-					}
-					const validation = context.schema["~standard"].validate(rawData);
-					let validationResult;
-					if (validation instanceof Promise) validationResult = await validation;
-					else validationResult = validation;
-					if (validationResult.issues) {
-						const firstIssue = validationResult.issues[0];
-						throw new Error(`Config validation failed: ${firstIssue?.message ?? "Unknown error"}`);
-					}
-					configData = validationResult.value;
-				} catch (error) {
-					if (isErrnoException(error) && error.code === "ENOENT") configData = void 0;
-					else if (error instanceof SyntaxError) throw new Error(`Failed to parse config file ${configPath}: ${error.message}`);
-					else throw error;
-				}
-			}
-			if (configData !== void 0 && configData !== null) {
-				setActiveConfig(context.id, configData);
-				return { [configKey]: configData };
-			}
-			return {};
-		}
-	};
-}
-/**
-* Runs a parser with configuration file support using two-pass parsing.
-*
-* This function performs the following steps:
-* 1. First pass: Parse arguments to extract config path or data
-* 2. Load and validate: Load config file(s) and validate using Standard Schema
-* 3. Second pass: Parse arguments again with config data as annotations
-*
-* The priority order for values is: CLI > config file > default.
-*
-* The function also supports help, version, and completion features. When these
-* special commands are detected, config loading is skipped entirely, ensuring
-* these features work even when config files don't exist.
-*
-* @template M The parser mode (sync or async).
-* @template TValue The parser value type.
-* @template TState The parser state type.
-* @template T The config data type.
-* @template THelp The return type when help is shown.
-* @template TError The return type when an error occurs.
-* @param parser The parser to execute.
-* @param context The config context with schema.
-* @param options Run options - either SingleFileOptions or CustomLoadOptions.
-* @returns Promise that resolves to the parsed result.
-* @throws Error if config file validation fails.
-* @since 0.10.0
-*
-* @example Single file mode
-* ```typescript
-* import { z } from "zod";
-* import { runWithConfig } from "@optique/config/run";
-* import { createConfigContext, bindConfig } from "@optique/config";
-*
-* const schema = z.object({
-*   host: z.string(),
-*   port: z.number(),
-* });
-*
-* const context = createConfigContext({ schema });
-*
-* const parser = object({
-*   config: option("--config", string()),
-*   host: bindConfig(option("--host", string()), {
-*     context,
-*     key: "host",
-*     default: "localhost",
-*   }),
-* });
-*
-* const result = await runWithConfig(parser, context, {
-*   getConfigPath: (parsed) => parsed.config,
-*   args: process.argv.slice(2),
-*   help: { mode: "option", onShow: () => process.exit(0) },
-*   version: { value: "1.0.0", onShow: () => process.exit(0) },
-* });
-* ```
-*
-* @example Custom load mode (multi-file merging)
-* ```typescript
-* import { deepMerge } from "es-toolkit";
-*
-* const result = await runWithConfig(parser, context, {
-*   load: async (parsed) => {
-*     const configs = await Promise.all([
-*       loadToml("/etc/app/config.toml").catch(() => ({})),
-*       loadToml("~/.config/app/config.toml").catch(() => ({})),
-*       loadToml("./.app.toml").catch(() => ({})),
-*     ]);
-*     return deepMerge(...configs);
-*   },
-*   args: process.argv.slice(2),
-*   help: { mode: "option", onShow: () => process.exit(0) },
-* });
-* ```
-*/
-async function runWithConfig(parser, context, options) {
-	const effectiveProgramName = options.programName ?? (typeof process !== "undefined" && process.argv?.[1] ? basename(process.argv[1]) : "cli");
-	const wrapperContext = createConfigSourceContext(context, options);
-	try {
-		return await runWith(parser, effectiveProgramName, [wrapperContext], {
-			args: options.args ?? [],
-			help: options.help,
-			version: options.version,
-			completion: options.completion,
-			stdout: options.stdout,
-			stderr: options.stderr,
-			colors: options.colors,
-			maxWidth: options.maxWidth,
-			showDefault: options.showDefault,
-			showChoices: options.showChoices,
-			aboveError: options.aboveError,
-			brief: options.brief,
-			description: options.description,
-			examples: options.examples,
-			author: options.author,
-			bugs: options.bugs,
-			footer: options.footer,
-			onError: options.onError
-		});
-	} catch (error) {
-		if (error instanceof Error && error.message.startsWith("Failed to parse config file ")) {
-			const stderr = options.stderr ?? console.error;
-			stderr(`Error: ${error.message}`);
-			if (options.onError) try {
-				options.onError(1);
-			} catch {
-				options.onError();
-			}
-			throw error;
-		}
-		throw error;
-	} finally {
-		clearActiveConfig(context.id);
-	}
-}
-
-//#endregion
-export { runWithConfig };

package/dist/src-9MkUoh9z.cjs

@@ -1,301 +0,0 @@
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-const __optique_core_annotations = __toESM(require("@optique/core/annotations"));
-const __optique_core_message = __toESM(require("@optique/core/message"));
-
-//#region src/index.ts
-/**
-* Unique symbol for config data in annotations.
-* @since 0.10.0
-*/
-const configKey = Symbol.for("@optique/config");
-/**
-* Internal registry for active config data during runWithConfig execution.
-* This is a workaround for the limitation that object() doesn't propagate
-* annotations to child field parsers.
-* @internal
-*/
-const activeConfigRegistry = /* @__PURE__ */ new Map();
-/**
-* Sets active config data for a context.
-* @internal
-*/
-function setActiveConfig(contextId, data) {
-	activeConfigRegistry.set(contextId, data);
-}
-/**
-* Gets active config data for a context.
-* @internal
-*/
-function getActiveConfig(contextId) {
-	return activeConfigRegistry.get(contextId);
-}
-/**
-* Clears active config data for a context.
-* @internal
-*/
-function clearActiveConfig(contextId) {
-	activeConfigRegistry.delete(contextId);
-}
-/**
-* Creates a config context for use with Optique parsers.
-*
-* The config context implements the SourceContext interface and can be used
-* with runWith() or runWithConfig() to provide configuration file support.
-*
-* @template T The output type of the config schema.
-* @param options Configuration options including schema and optional parser.
-* @returns A config context that can be used with bindConfig() and runWithConfig().
-* @since 0.10.0
-*
-* @example
-* ```typescript
-* import { z } from "zod";
-* import { createConfigContext } from "@optique/config";
-*
-* const schema = z.object({
-*   host: z.string(),
-*   port: z.number(),
-* });
-*
-* const configContext = createConfigContext({ schema });
-* ```
-*/
-function createConfigContext(options) {
-	const contextId = Symbol.for(`@optique/config:${Math.random()}`);
-	return {
-		id: contextId,
-		schema: options.schema,
-		getAnnotations(parsed) {
-			if (!parsed) return {};
-			return {};
-		}
-	};
-}
-/**
-* Binds a parser to configuration values with fallback priority.
-*
-* The binding implements the following priority order:
-* 1. CLI argument (if provided)
-* 2. Config file value (if available)
-* 3. Default value (if specified)
-* 4. Error (if none of the above)
-*
-* @template M The parser mode (sync or async).
-* @template TValue The parser value type.
-* @template TState The parser state type.
-* @template T The config data type.
-* @param parser The parser to bind to config values.
-* @param options Binding options including context, key, and default.
-* @returns A new parser with config fallback behavior.
-* @since 0.10.0
-*
-* @example
-* ```typescript
-* import { bindConfig } from "@optique/config";
-* import { option } from "@optique/core/primitives";
-* import { string } from "@optique/core/valueparser";
-*
-* const hostParser = bindConfig(option("--host", string()), {
-*   context: configContext,
-*   key: "host",
-*   default: "localhost",
-* });
-* ```
-*/
-function bindConfig(parser, options) {
-	return {
-		$mode: parser.$mode,
-		$valueType: parser.$valueType,
-		$stateType: parser.$stateType,
-		priority: parser.priority,
-		usage: options.default !== void 0 ? [{
-			type: "optional",
-			terms: parser.usage
-		}] : parser.usage,
-		initialState: parser.initialState,
-		parse: (context) => {
-			const annotations = (0, __optique_core_annotations.getAnnotations)(context.state);
-			const result = parser.parse(context);
-			if (!(result instanceof Promise)) {
-				if (result.success) {
-					const newState$1 = {
-						hasCliValue: true,
-						cliState: result.next.state,
-						...annotations && { [__optique_core_annotations.annotationKey]: annotations }
-					};
-					return {
-						success: true,
-						next: {
-							...result.next,
-							state: newState$1
-						},
-						consumed: result.consumed
-					};
-				}
-				const newState = {
-					hasCliValue: false,
-					...annotations && { [__optique_core_annotations.annotationKey]: annotations }
-				};
-				return {
-					success: true,
-					next: {
-						...context,
-						state: newState
-					},
-					consumed: []
-				};
-			}
-			return result.then((res) => {
-				if (res.success) {
-					const newState$1 = {
-						hasCliValue: true,
-						cliState: res.next.state,
-						...annotations && { [__optique_core_annotations.annotationKey]: annotations }
-					};
-					return {
-						success: true,
-						next: {
-							...res.next,
-							state: newState$1
-						},
-						consumed: res.consumed
-					};
-				}
-				const newState = {
-					hasCliValue: false,
-					...annotations && { [__optique_core_annotations.annotationKey]: annotations }
-				};
-				return {
-					success: true,
-					next: {
-						...context,
-						state: newState
-					},
-					consumed: []
-				};
-			});
-		},
-		complete: (state) => {
-			const bindState = state;
-			if (bindState?.hasCliValue && bindState.cliState !== void 0) {
-				const innerResult = parser.complete(bindState.cliState);
-				if (innerResult instanceof Promise) return innerResult.then((res) => {
-					if (res.success) return {
-						success: true,
-						value: res.value
-					};
-					return res;
-				});
-				if (innerResult.success) return {
-					success: true,
-					value: innerResult.value
-				};
-				return innerResult;
-			}
-			return getConfigOrDefault(state, options);
-		},
-		suggest: parser.suggest,
-		getDocFragments(state, upperDefaultValue) {
-			const defaultValue = upperDefaultValue ?? options.default;
-			return parser.getDocFragments(state, defaultValue);
-		}
-	};
-}
-/**
-* Helper function to get value from config or default.
-* Checks both annotations (for top-level parsers) and the active config
-* registry (for parsers nested inside object() when used with runWithConfig).
-*/
-function getConfigOrDefault(state, options) {
-	const annotations = (0, __optique_core_annotations.getAnnotations)(state);
-	let configData = annotations?.[configKey];
-	if (configData === void 0 || configData === null) {
-		const contextId = options.context.id;
-		configData = getActiveConfig(contextId);
-	}
-	let configValue;
-	if (configData !== void 0 && configData !== null) if (typeof options.key === "function") try {
-		configValue = options.key(configData);
-	} catch {
-		configValue = void 0;
-	}
-	else configValue = configData[options.key];
-	if (configValue !== void 0) return {
-		success: true,
-		value: configValue
-	};
-	if (options.default !== void 0) return {
-		success: true,
-		value: options.default
-	};
-	return {
-		success: false,
-		error: __optique_core_message.message`Missing required configuration value.`
-	};
-}
-
-//#endregion
-Object.defineProperty(exports, '__toESM', {
-  enumerable: true,
-  get: function () {
-    return __toESM;
-  }
-});
-Object.defineProperty(exports, 'bindConfig', {
-  enumerable: true,
-  get: function () {
-    return bindConfig;
-  }
-});
-Object.defineProperty(exports, 'clearActiveConfig', {
-  enumerable: true,
-  get: function () {
-    return clearActiveConfig;
-  }
-});
-Object.defineProperty(exports, 'configKey', {
-  enumerable: true,
-  get: function () {
-    return configKey;
-  }
-});
-Object.defineProperty(exports, 'createConfigContext', {
-  enumerable: true,
-  get: function () {
-    return createConfigContext;
-  }
-});
-Object.defineProperty(exports, 'getActiveConfig', {
-  enumerable: true,
-  get: function () {
-    return getActiveConfig;
-  }
-});
-Object.defineProperty(exports, 'setActiveConfig', {
-  enumerable: true,
-  get: function () {
-    return setActiveConfig;
-  }
-});