@optique/config 1.0.0-dev.1818 → 1.0.0-dev.1826

package/dist/index.cjs

@@ -30,64 +30,10 @@ const __optique_core_mode_dispatch = __toESM(require("@optique/core/mode-dispatc
 
 //#region src/index.ts
 const phase2UndefinedParsedValueKey = Symbol("@optique/config/phase2UndefinedParsedValue");
-/**
-* Internal registry for active config data during config context 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 config context execution.
-* @internal
-*/
-const activeConfigMetaRegistry = /* @__PURE__ */ new Map();
 const phase1ConfigAnnotationMarker = Symbol("@optique/config/phase1Annotation");
 function isPhase2UndefinedParsedValue(value) {
 	return value != null && typeof value === "object" && phase2UndefinedParsedValueKey in value;
 }
-/**
-* 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);
-}
 function getTypeName(value) {
 	if (value === null) return "null";
 	if (Array.isArray(value)) return "array";
@@ -149,6 +95,10 @@ function validateWithSchema(schema, rawData) {
 * The config context implements the `SourceContext` interface and can be used
 * with `runWith()` from *@optique/core* or `run()`/`runAsync()` from
 * *@optique/run* to provide configuration file support.
+* When calling `context.getAnnotations()` manually, pass the returned
+* annotations to low-level APIs such as `parse()`, `parseAsync()`,
+* `parser.complete()`, `suggest()`, or `getDocPage()`. Calling
+* `getAnnotations()` by itself does not affect later parses.
 *
 * @template T The output type of the config schema.
 * @template TConfigMeta The metadata type for config sources.
@@ -197,21 +147,13 @@ function createConfigContext(options) {
 			if (!opts.load && opts.getConfigPath !== void 0 && typeof opts.getConfigPath !== "function") throw new TypeError(`Expected getConfigPath to be a function, but got: ${getTypeName(opts.getConfigPath)}.`);
 			const parsedValue = isPhase2UndefinedParsedValue(parsed) ? void 0 : parsed;
 			const parsedPlaceholder = parsedValue;
-			const emptyAnnotations = () => {
-				clearActiveConfig(contextId);
-				clearActiveConfigMeta(contextId);
-				return {};
-			};
+			const emptyAnnotations = () => ({});
 			const buildAnnotations = (configData, configMeta) => {
 				if (configData === void 0 || configData === null) return emptyAnnotations();
-				setActiveConfig(contextId, configData);
-				if (configMeta !== void 0) {
-					setActiveConfigMeta(contextId, configMeta);
-					return { [contextId]: {
-						data: configData,
-						meta: configMeta
-					} };
-				}
+				if (configMeta !== void 0) return { [contextId]: {
+					data: configData,
+					meta: configMeta
+				} };
 				return { [contextId]: { data: configData } };
 			};
 			const validateAndBuildAnnotations = (rawData, configMeta) => {
@@ -257,10 +199,7 @@ function createConfigContext(options) {
 			}
 			return emptyAnnotations();
 		},
-		[Symbol.dispose]() {
-			clearActiveConfig(contextId);
-			clearActiveConfigMeta(contextId);
-		}
+		[Symbol.dispose]() {}
 	};
 	return context;
 }
@@ -438,9 +377,7 @@ function bindConfig(parser, options) {
 }
 /**
 * 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 context-aware
-* runners).
+* Reads only from explicit annotations carried by the current parse state.
 *
 * When `innerParser.validateValue` is available, the returned fallback
 * value is routed through it so that the inner CLI parser's constraints
@@ -462,12 +399,8 @@ function getConfigOrDefault(state, options, mode, innerParser) {
 	const annotations = (0, __optique_core_annotations.getAnnotations)(state);
 	const contextId = options.context.id;
 	const annotationValue = annotations?.[contextId];
-	let configData = annotationValue?.data;
-	let configMeta = annotationValue?.meta;
-	if (configData === void 0 || configData === null) {
-		configData = getActiveConfig(contextId);
-		configMeta = getActiveConfigMeta(contextId);
-	}
+	const configData = annotationValue?.data;
+	const configMeta = annotationValue?.meta;
 	let configValue;
 	if (configData !== void 0 && configData !== null) if (typeof options.key === "function") {
 		configValue = options.key(configData, configMeta);
@@ -503,10 +436,9 @@ function validateFallbackValue(mode, innerParser, value) {
 /**
 * Resolves a config-backed dependency source with fallback priority.
 *
-* This first checks annotations or the active config registry via
-* {@link getConfigOrDefault}. If no config-backed value is available, it falls
-* back to `options.default` and finally delegates to the wrapped parser's
-* source extractor.
+* This first checks annotations via {@link getConfigOrDefault}. If no
+* config-backed value is available, it falls back to `options.default` and
+* finally delegates to the wrapped parser's source extractor.
 *
 * When `innerParser` exposes `validateValue`, the returned fallback is
 * routed through it so that the inner CLI parser's constraints are
@@ -534,7 +466,7 @@ function getConfigSourceValue(state, options, innerState, extractInnerSourceValu
 	const annotations = (0, __optique_core_annotations.getAnnotations)(state);
 	const contextId = options.context.id;
 	const annotationValue = annotations?.[contextId];
-	const configData = annotationValue?.data ?? getActiveConfig(contextId);
+	const configData = annotationValue?.data;
 	const validateFallback = (parsed) => {
 		if (!parsed.success) return parsed;
 		if (innerParser == null || typeof innerParser.validateValue !== "function") return parsed;
@@ -553,10 +485,4 @@ function getConfigSourceValue(state, options, innerState, extractInnerSourceValu
 
 //#endregion
 exports.bindConfig = bindConfig;
-exports.clearActiveConfig = clearActiveConfig;
-exports.clearActiveConfigMeta = clearActiveConfigMeta;
-exports.createConfigContext = createConfigContext;
-exports.getActiveConfig = getActiveConfig;
-exports.getActiveConfigMeta = getActiveConfigMeta;
-exports.setActiveConfig = setActiveConfig;
-exports.setActiveConfigMeta = setActiveConfigMeta;
+exports.createConfigContext = createConfigContext;

package/dist/index.d.cts

@@ -19,36 +19,6 @@ interface ConfigMeta {
    */
   readonly configPath: string;
 }
-/**
- * Sets active config data for a context.
- * @internal
- */
-declare function setActiveConfig<T>(contextId: symbol, data: T): void;
-/**
- * Gets active config data for a context.
- * @internal
- */
-declare function getActiveConfig<T>(contextId: symbol): T | undefined;
-/**
- * Clears active config data for a context.
- * @internal
- */
-declare function clearActiveConfig(contextId: symbol): void;
-/**
- * Sets active config metadata for a context.
- * @internal
- */
-declare function setActiveConfigMeta<T>(contextId: symbol, meta: T): void;
-/**
- * Gets active config metadata for a context.
- * @internal
- */
-declare function getActiveConfigMeta<T>(contextId: symbol): T | undefined;
-/**
- * Clears active config metadata for a context.
- * @internal
- */
-declare function clearActiveConfigMeta(contextId: symbol): void;
 /**
  * Options for creating a config context.
  *
@@ -157,6 +127,10 @@ interface ConfigContext<T, TConfigMeta = ConfigMeta> extends SourceContext<Confi
  * The config context implements the `SourceContext` interface and can be used
  * with `runWith()` from *@optique/core* or `run()`/`runAsync()` from
  * *@optique/run* to provide configuration file support.
+ * When calling `context.getAnnotations()` manually, pass the returned
+ * annotations to low-level APIs such as `parse()`, `parseAsync()`,
+ * `parser.complete()`, `suggest()`, or `getDocPage()`. Calling
+ * `getAnnotations()` by itself does not affect later parses.
  *
  * @template T The output type of the config schema.
  * @template TConfigMeta The metadata type for config sources.
@@ -245,4 +219,4 @@ interface BindConfigOptions<T, TValue, TConfigMeta = ConfigMeta> {
  */
 declare function bindConfig<M extends "sync" | "async", TValue, TState, T, TConfigMeta = ConfigMeta>(parser: Parser<M, TValue, TState>, options: BindConfigOptions<T, TValue, TConfigMeta>): Parser<M, TValue, TState>;
 //#endregion
-export { BindConfigOptions, ConfigContext, ConfigContextOptions, ConfigContextRequiredOptions, ConfigLoadResult, ConfigMeta, bindConfig, clearActiveConfig, clearActiveConfigMeta, createConfigContext, getActiveConfig, getActiveConfigMeta, setActiveConfig, setActiveConfigMeta };
+export { BindConfigOptions, ConfigContext, ConfigContextOptions, ConfigContextRequiredOptions, ConfigLoadResult, ConfigMeta, bindConfig, createConfigContext };

package/dist/index.d.ts

@@ -19,36 +19,6 @@ interface ConfigMeta {
    */
   readonly configPath: string;
 }
-/**
- * Sets active config data for a context.
- * @internal
- */
-declare function setActiveConfig<T>(contextId: symbol, data: T): void;
-/**
- * Gets active config data for a context.
- * @internal
- */
-declare function getActiveConfig<T>(contextId: symbol): T | undefined;
-/**
- * Clears active config data for a context.
- * @internal
- */
-declare function clearActiveConfig(contextId: symbol): void;
-/**
- * Sets active config metadata for a context.
- * @internal
- */
-declare function setActiveConfigMeta<T>(contextId: symbol, meta: T): void;
-/**
- * Gets active config metadata for a context.
- * @internal
- */
-declare function getActiveConfigMeta<T>(contextId: symbol): T | undefined;
-/**
- * Clears active config metadata for a context.
- * @internal
- */
-declare function clearActiveConfigMeta(contextId: symbol): void;
 /**
  * Options for creating a config context.
  *
@@ -157,6 +127,10 @@ interface ConfigContext<T, TConfigMeta = ConfigMeta> extends SourceContext<Confi
  * The config context implements the `SourceContext` interface and can be used
  * with `runWith()` from *@optique/core* or `run()`/`runAsync()` from
  * *@optique/run* to provide configuration file support.
+ * When calling `context.getAnnotations()` manually, pass the returned
+ * annotations to low-level APIs such as `parse()`, `parseAsync()`,
+ * `parser.complete()`, `suggest()`, or `getDocPage()`. Calling
+ * `getAnnotations()` by itself does not affect later parses.
  *
  * @template T The output type of the config schema.
  * @template TConfigMeta The metadata type for config sources.
@@ -245,4 +219,4 @@ interface BindConfigOptions<T, TValue, TConfigMeta = ConfigMeta> {
  */
 declare function bindConfig<M extends "sync" | "async", TValue, TState, T, TConfigMeta = ConfigMeta>(parser: Parser<M, TValue, TState>, options: BindConfigOptions<T, TValue, TConfigMeta>): Parser<M, TValue, TState>;
 //#endregion
-export { BindConfigOptions, ConfigContext, ConfigContextOptions, ConfigContextRequiredOptions, ConfigLoadResult, ConfigMeta, bindConfig, clearActiveConfig, clearActiveConfigMeta, createConfigContext, getActiveConfig, getActiveConfigMeta, setActiveConfig, setActiveConfigMeta };
+export { BindConfigOptions, ConfigContext, ConfigContextOptions, ConfigContextRequiredOptions, ConfigLoadResult, ConfigMeta, bindConfig, createConfigContext };

package/dist/index.js

@@ -7,64 +7,10 @@ import { mapModeValue, wrapForMode } from "@optique/core/mode-dispatch";
 
 //#region src/index.ts
 const phase2UndefinedParsedValueKey = Symbol("@optique/config/phase2UndefinedParsedValue");
-/**
-* Internal registry for active config data during config context 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 config context execution.
-* @internal
-*/
-const activeConfigMetaRegistry = /* @__PURE__ */ new Map();
 const phase1ConfigAnnotationMarker = Symbol("@optique/config/phase1Annotation");
 function isPhase2UndefinedParsedValue(value) {
 	return value != null && typeof value === "object" && phase2UndefinedParsedValueKey in value;
 }
-/**
-* 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);
-}
 function getTypeName(value) {
 	if (value === null) return "null";
 	if (Array.isArray(value)) return "array";
@@ -126,6 +72,10 @@ function validateWithSchema(schema, rawData) {
 * The config context implements the `SourceContext` interface and can be used
 * with `runWith()` from *@optique/core* or `run()`/`runAsync()` from
 * *@optique/run* to provide configuration file support.
+* When calling `context.getAnnotations()` manually, pass the returned
+* annotations to low-level APIs such as `parse()`, `parseAsync()`,
+* `parser.complete()`, `suggest()`, or `getDocPage()`. Calling
+* `getAnnotations()` by itself does not affect later parses.
 *
 * @template T The output type of the config schema.
 * @template TConfigMeta The metadata type for config sources.
@@ -174,21 +124,13 @@ function createConfigContext(options) {
 			if (!opts.load && opts.getConfigPath !== void 0 && typeof opts.getConfigPath !== "function") throw new TypeError(`Expected getConfigPath to be a function, but got: ${getTypeName(opts.getConfigPath)}.`);
 			const parsedValue = isPhase2UndefinedParsedValue(parsed) ? void 0 : parsed;
 			const parsedPlaceholder = parsedValue;
-			const emptyAnnotations = () => {
-				clearActiveConfig(contextId);
-				clearActiveConfigMeta(contextId);
-				return {};
-			};
+			const emptyAnnotations = () => ({});
 			const buildAnnotations = (configData, configMeta) => {
 				if (configData === void 0 || configData === null) return emptyAnnotations();
-				setActiveConfig(contextId, configData);
-				if (configMeta !== void 0) {
-					setActiveConfigMeta(contextId, configMeta);
-					return { [contextId]: {
-						data: configData,
-						meta: configMeta
-					} };
-				}
+				if (configMeta !== void 0) return { [contextId]: {
+					data: configData,
+					meta: configMeta
+				} };
 				return { [contextId]: { data: configData } };
 			};
 			const validateAndBuildAnnotations = (rawData, configMeta) => {
@@ -234,10 +176,7 @@ function createConfigContext(options) {
 			}
 			return emptyAnnotations();
 		},
-		[Symbol.dispose]() {
-			clearActiveConfig(contextId);
-			clearActiveConfigMeta(contextId);
-		}
+		[Symbol.dispose]() {}
 	};
 	return context;
 }
@@ -415,9 +354,7 @@ function bindConfig(parser, options) {
 }
 /**
 * 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 context-aware
-* runners).
+* Reads only from explicit annotations carried by the current parse state.
 *
 * When `innerParser.validateValue` is available, the returned fallback
 * value is routed through it so that the inner CLI parser's constraints
@@ -439,12 +376,8 @@ function getConfigOrDefault(state, options, mode, innerParser) {
 	const annotations = getAnnotations(state);
 	const contextId = options.context.id;
 	const annotationValue = annotations?.[contextId];
-	let configData = annotationValue?.data;
-	let configMeta = annotationValue?.meta;
-	if (configData === void 0 || configData === null) {
-		configData = getActiveConfig(contextId);
-		configMeta = getActiveConfigMeta(contextId);
-	}
+	const configData = annotationValue?.data;
+	const configMeta = annotationValue?.meta;
 	let configValue;
 	if (configData !== void 0 && configData !== null) if (typeof options.key === "function") {
 		configValue = options.key(configData, configMeta);
@@ -480,10 +413,9 @@ function validateFallbackValue(mode, innerParser, value) {
 /**
 * Resolves a config-backed dependency source with fallback priority.
 *
-* This first checks annotations or the active config registry via
-* {@link getConfigOrDefault}. If no config-backed value is available, it falls
-* back to `options.default` and finally delegates to the wrapped parser's
-* source extractor.
+* This first checks annotations via {@link getConfigOrDefault}. If no
+* config-backed value is available, it falls back to `options.default` and
+* finally delegates to the wrapped parser's source extractor.
 *
 * When `innerParser` exposes `validateValue`, the returned fallback is
 * routed through it so that the inner CLI parser's constraints are
@@ -511,7 +443,7 @@ function getConfigSourceValue(state, options, innerState, extractInnerSourceValu
 	const annotations = getAnnotations(state);
 	const contextId = options.context.id;
 	const annotationValue = annotations?.[contextId];
-	const configData = annotationValue?.data ?? getActiveConfig(contextId);
+	const configData = annotationValue?.data;
 	const validateFallback = (parsed) => {
 		if (!parsed.success) return parsed;
 		if (innerParser == null || typeof innerParser.validateValue !== "function") return parsed;
@@ -529,4 +461,4 @@ function getConfigSourceValue(state, options, innerState, extractInnerSourceValu
 }
 
 //#endregion
-export { bindConfig, clearActiveConfig, clearActiveConfigMeta, createConfigContext, getActiveConfig, getActiveConfigMeta, setActiveConfig, setActiveConfigMeta };
+export { bindConfig, createConfigContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/config",
-  "version": "1.0.0-dev.1818+1aa43bd4",
+  "version": "1.0.0-dev.1826+dae48c84",
   "description": "Configuration file support for Optique with Standard Schema validation",
   "keywords": [
     "CLI",
@@ -59,7 +59,7 @@
     "@standard-schema/spec": "^1.1.0"
   },
   "dependencies": {
-    "@optique/core": "1.0.0-dev.1818+1aa43bd4"
+    "@optique/core": "1.0.0-dev.1826+dae48c84"
   },
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",
@@ -67,7 +67,7 @@
     "tsdown": "^0.13.0",
     "typescript": "^5.8.3",
     "zod": "^3.25.0 || ^4.0.0",
-    "@optique/env": "1.0.0-dev.1818+1aa43bd4"
+    "@optique/env": "1.0.0-dev.1826+dae48c84"
   },
   "scripts": {
     "build": "tsdown",