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

package/dist/src-Dm_17c1d.js

@@ -1,237 +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");
-/**
-* 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 = 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];
-	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: message`Missing required configuration value.`
-	};
-}
-
-//#endregion
-export { bindConfig, clearActiveConfig, configKey, createConfigContext, getActiveConfig, setActiveConfig };