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

package/dist/src-loxvrkxq.cjs

@@ -1,359 +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");
-/**
-* 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 = (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];
-	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: __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, 'clearActiveConfigMeta', {
-  enumerable: true,
-  get: function () {
-    return clearActiveConfigMeta;
-  }
-});
-Object.defineProperty(exports, 'configKey', {
-  enumerable: true,
-  get: function () {
-    return configKey;
-  }
-});
-Object.defineProperty(exports, 'configMetaKey', {
-  enumerable: true,
-  get: function () {
-    return configMetaKey;
-  }
-});
-Object.defineProperty(exports, 'createConfigContext', {
-  enumerable: true,
-  get: function () {
-    return createConfigContext;
-  }
-});
-Object.defineProperty(exports, 'getActiveConfig', {
-  enumerable: true,
-  get: function () {
-    return getActiveConfig;
-  }
-});
-Object.defineProperty(exports, 'getActiveConfigMeta', {
-  enumerable: true,
-  get: function () {
-    return getActiveConfigMeta;
-  }
-});
-Object.defineProperty(exports, 'setActiveConfig', {
-  enumerable: true,
-  get: function () {
-    return setActiveConfig;
-  }
-});
-Object.defineProperty(exports, 'setActiveConfigMeta', {
-  enumerable: true,
-  get: function () {
-    return setActiveConfigMeta;
-  }
-});