@optique/config 1.0.0-dev.429 → 1.0.0-dev.432

package/dist/run.js

@@ -1,127 +0,0 @@
-import { clearActiveConfig, clearActiveConfigMeta, configKey, configMetaKey, setActiveConfig, setActiveConfigMeta } from "./src-DaFxoeAp.js";
-import { readFile } from "node:fs/promises";
-import { basename, dirname, resolve } 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;
-			let configMeta;
-			if ("load" in options) {
-				const customOptions = options;
-				const loaded = await Promise.resolve(customOptions.load(parsed));
-				const validation = context.schema["~standard"].validate(loaded.config);
-				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;
-				configMeta = loaded.meta;
-			} else {
-				const singleFileOptions = options;
-				const configPath = singleFileOptions.getConfigPath(parsed);
-				if (configPath) {
-					const absoluteConfigPath = resolve(configPath);
-					const singleFileMeta = {
-						configDir: dirname(absoluteConfigPath),
-						configPath: absoluteConfigPath
-					};
-					try {
-						const contents = await readFile(absoluteConfigPath);
-						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;
-						configMeta = singleFileMeta;
-					} catch (error) {
-						if (isErrnoException(error) && error.code === "ENOENT") configData = void 0;
-						else if (error instanceof SyntaxError) throw new Error(`Failed to parse config file ${absoluteConfigPath}: ${error.message}`);
-						else throw error;
-					}
-				}
-			}
-			if (configData !== void 0 && configData !== null) {
-				setActiveConfig(context.id, configData);
-				if (configMeta !== void 0) {
-					setActiveConfigMeta(context.id, configMeta);
-					return {
-						[configKey]: configData,
-						[configMetaKey]: configMeta
-					};
-				}
-				return { [configKey]: configData };
-			}
-			return {};
-		}
-	};
-}
-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);
-		clearActiveConfigMeta(context.id);
-	}
-}
-
-//#endregion
-export { runWithConfig };

package/dist/src-DaFxoeAp.js

@@ -1,271 +0,0 @@
-import { annotationKey, getAnnotations } from "@optique/core/annotations";
-import { message } from "@optique/core/message";
-
-//#region src/index.ts
-/**
-* Unique symbol for config data in annotations.
-* @since 0.10.0
-*/
-const configKey = Symbol.for("@optique/config");
-/**
-* Unique symbol for config metadata in annotations.
-* @since 1.0.0
-*/
-const configMetaKey = Symbol.for("@optique/config/meta");
-/**
-* 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();
-/**
-* Internal registry for active config metadata during runWithConfig execution.
-* @internal
-*/
-const activeConfigMetaRegistry = /* @__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);
-}
-/**
-* Sets active config metadata for a context.
-* @internal
-*/
-function setActiveConfigMeta(contextId, meta) {
-	activeConfigMetaRegistry.set(contextId, meta);
-}
-/**
-* Gets active config metadata for a context.
-* @internal
-*/
-function getActiveConfigMeta(contextId) {
-	return activeConfigMetaRegistry.get(contextId);
-}
-/**
-* Clears active config metadata for a context.
-* @internal
-*/
-function clearActiveConfigMeta(contextId) {
-	activeConfigMetaRegistry.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.
-* @template TConfigMeta The metadata type for config sources.
-* @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 = 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 && { [annotationKey]: annotations }
-					};
-					return {
-						success: true,
-						next: {
-							...result.next,
-							state: newState$1
-						},
-						consumed: result.consumed
-					};
-				}
-				const newState = {
-					hasCliValue: false,
-					...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 && { [annotationKey]: annotations }
-					};
-					return {
-						success: true,
-						next: {
-							...res.next,
-							state: newState$1
-						},
-						consumed: res.consumed
-					};
-				}
-				const newState = {
-					hasCliValue: false,
-					...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 = getAnnotations(state);
-	let configData = annotations?.[configKey];
-	let configMeta = annotations?.[configMetaKey];
-	if (configData === void 0 || configData === null) {
-		const contextId = options.context.id;
-		configData = getActiveConfig(contextId);
-		configMeta = getActiveConfigMeta(contextId);
-	}
-	let configValue;
-	if (configData !== void 0 && configData !== null) if (typeof options.key === "function") try {
-		configValue = options.key(configData, configMeta);
-	} 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: message`Missing required configuration value.`
-	};
-}
-
-//#endregion
-export { bindConfig, clearActiveConfig, clearActiveConfigMeta, configKey, configMetaKey, createConfigContext, getActiveConfig, getActiveConfigMeta, setActiveConfig, setActiveConfigMeta };