@optique/env 1.0.0-dev.1810 → 1.0.0-dev.1826

package/dist/index.cjs

@@ -28,31 +28,6 @@ const __optique_core_parser = __toESM(require("@optique/core/parser"));
 const __optique_core_valueparser = __toESM(require("@optique/core/valueparser"));
 
 //#region src/index.ts
-const activeEnvSourceRegistry = /* @__PURE__ */ new Map();
-/**
-* Sets active environment source data for a context.
-*
-* @internal
-*/
-function setActiveEnvSource(contextId, sourceData) {
-	activeEnvSourceRegistry.set(contextId, sourceData);
-}
-/**
-* Gets active environment source data for a context.
-*
-* @internal
-*/
-function getActiveEnvSource(contextId) {
-	return activeEnvSourceRegistry.get(contextId);
-}
-/**
-* Clears active environment source data for a context.
-*
-* @internal
-*/
-function clearActiveEnvSource(contextId) {
-	activeEnvSourceRegistry.delete(contextId);
-}
 function defaultEnvSource(key) {
 	const denoGlobal = globalThis.Deno;
 	if (typeof denoGlobal?.env?.get === "function") return denoGlobal.env.get(key);
@@ -62,6 +37,11 @@ function defaultEnvSource(key) {
 /**
 * Creates an environment context for use with Optique runners.
 *
+* 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.
+*
 * @param options Environment context options.
 * @returns A context that provides environment source annotations.
 * @throws {TypeError} If `prefix` is not a string.
@@ -86,12 +66,9 @@ function createEnvContext(options = {}) {
 				prefix,
 				source
 			};
-			setActiveEnvSource(contextId, sourceData);
 			return { [contextId]: sourceData };
 		},
-		[Symbol.dispose]() {
-			clearActiveEnvSource(contextId);
-		}
+		[Symbol.dispose]() {}
 	};
 }
 /**
@@ -274,7 +251,7 @@ function bindEnv(parser, options) {
 */
 function getEnvOrDefault(state, options, mode, innerParser, innerState, exec) {
 	const annotations = (0, __optique_core_annotations.getAnnotations)(state);
-	const sourceData = annotations?.[options.context.id] ?? getActiveEnvSource(options.context.id);
+	const sourceData = annotations?.[options.context.id];
 	const fullKey = `${sourceData?.prefix ?? options.context.prefix}${options.key}`;
 	const rawValue = sourceData?.source(fullKey);
 	const validateSync = (parsed) => {
@@ -322,10 +299,9 @@ function getEnvOrDefault(state, options, mode, innerParser, innerState, exec) {
 /**
 * Resolves an env-backed dependency source with env and default fallbacks.
 *
-* This first checks annotations or the active env registry for the bound
-* variable. If no env-backed value is available, it falls back to
-* `options.default` and finally delegates to the wrapped parser's source
-* extractor.
+* This first checks annotations for the bound variable. If no env-backed value
+* is available, it falls back to `options.default` and finally delegates to
+* the wrapped parser's source extractor.
 *
 * When `innerParser` exposes a `validateValue` hook, env-sourced values
 * and the configured default are re-validated against the inner parser's
@@ -350,7 +326,7 @@ function getEnvOrDefault(state, options, mode, innerParser, innerState, exec) {
 */
 function getEnvSourceValue(state, options, innerState, extractInnerSourceValue, innerParser) {
 	const annotations = (0, __optique_core_annotations.getAnnotations)(state);
-	const sourceData = annotations?.[options.context.id] ?? getActiveEnvSource(options.context.id);
+	const sourceData = annotations?.[options.context.id];
 	const fullKey = `${sourceData?.prefix ?? options.context.prefix}${options.key}`;
 	const rawValue = sourceData?.source(fullKey);
 	const validateFallback = (parsed) => {
@@ -442,7 +418,4 @@ function bool(options = {}) {
 //#endregion
 exports.bindEnv = bindEnv;
 exports.bool = bool;
-exports.clearActiveEnvSource = clearActiveEnvSource;
-exports.createEnvContext = createEnvContext;
-exports.getActiveEnvSource = getActiveEnvSource;
-exports.setActiveEnvSource = setActiveEnvSource;
+exports.createEnvContext = createEnvContext;

package/dist/index.d.cts

@@ -11,10 +11,6 @@ import { NonEmptyString, ValueParser } from "@optique/core/valueparser";
  * @since 1.0.0
  */
 type EnvSource = (key: string) => string | undefined;
-interface EnvSourceData {
-  readonly prefix: string;
-  readonly source: EnvSource;
-}
 /**
  * Context for environment-variable-based fallback values.
  *
@@ -49,27 +45,14 @@ interface EnvContextOptions {
    */
   readonly source?: EnvSource;
 }
-/**
- * Sets active environment source data for a context.
- *
- * @internal
- */
-declare function setActiveEnvSource(contextId: symbol, sourceData: EnvSourceData): void;
-/**
- * Gets active environment source data for a context.
- *
- * @internal
- */
-declare function getActiveEnvSource(contextId: symbol): EnvSourceData | undefined;
-/**
- * Clears active environment source data for a context.
- *
- * @internal
- */
-declare function clearActiveEnvSource(contextId: symbol): void;
 /**
  * Creates an environment context for use with Optique runners.
  *
+ * 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.
+ *
  * @param options Environment context options.
  * @returns A context that provides environment source annotations.
  * @throws {TypeError} If `prefix` is not a string.
@@ -168,4 +151,4 @@ interface BoolOptions {
  */
 declare function bool(options?: BoolOptions): ValueParser<"sync", boolean>;
 //#endregion
-export { BindEnvOptions, BoolOptions, EnvContext, EnvContextOptions, EnvSource, bindEnv, bool, clearActiveEnvSource, createEnvContext, getActiveEnvSource, setActiveEnvSource };
+export { BindEnvOptions, BoolOptions, EnvContext, EnvContextOptions, EnvSource, bindEnv, bool, createEnvContext };

package/dist/index.d.ts

@@ -11,10 +11,6 @@ import { SourceContext } from "@optique/core/context";
  * @since 1.0.0
  */
 type EnvSource = (key: string) => string | undefined;
-interface EnvSourceData {
-  readonly prefix: string;
-  readonly source: EnvSource;
-}
 /**
  * Context for environment-variable-based fallback values.
  *
@@ -49,27 +45,14 @@ interface EnvContextOptions {
    */
   readonly source?: EnvSource;
 }
-/**
- * Sets active environment source data for a context.
- *
- * @internal
- */
-declare function setActiveEnvSource(contextId: symbol, sourceData: EnvSourceData): void;
-/**
- * Gets active environment source data for a context.
- *
- * @internal
- */
-declare function getActiveEnvSource(contextId: symbol): EnvSourceData | undefined;
-/**
- * Clears active environment source data for a context.
- *
- * @internal
- */
-declare function clearActiveEnvSource(contextId: symbol): void;
 /**
  * Creates an environment context for use with Optique runners.
  *
+ * 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.
+ *
  * @param options Environment context options.
  * @returns A context that provides environment source annotations.
  * @throws {TypeError} If `prefix` is not a string.
@@ -168,4 +151,4 @@ interface BoolOptions {
  */
 declare function bool(options?: BoolOptions): ValueParser<"sync", boolean>;
 //#endregion
-export { BindEnvOptions, BoolOptions, EnvContext, EnvContextOptions, EnvSource, bindEnv, bool, clearActiveEnvSource, createEnvContext, getActiveEnvSource, setActiveEnvSource };
+export { BindEnvOptions, BoolOptions, EnvContext, EnvContextOptions, EnvSource, bindEnv, bool, createEnvContext };

package/dist/index.js

@@ -5,31 +5,6 @@ import { composeWrappedSourceMetadata, defineInheritedAnnotationParser, getDeleg
 import { ensureNonEmptyString, isValueParser } from "@optique/core/valueparser";
 
 //#region src/index.ts
-const activeEnvSourceRegistry = /* @__PURE__ */ new Map();
-/**
-* Sets active environment source data for a context.
-*
-* @internal
-*/
-function setActiveEnvSource(contextId, sourceData) {
-	activeEnvSourceRegistry.set(contextId, sourceData);
-}
-/**
-* Gets active environment source data for a context.
-*
-* @internal
-*/
-function getActiveEnvSource(contextId) {
-	return activeEnvSourceRegistry.get(contextId);
-}
-/**
-* Clears active environment source data for a context.
-*
-* @internal
-*/
-function clearActiveEnvSource(contextId) {
-	activeEnvSourceRegistry.delete(contextId);
-}
 function defaultEnvSource(key) {
 	const denoGlobal = globalThis.Deno;
 	if (typeof denoGlobal?.env?.get === "function") return denoGlobal.env.get(key);
@@ -39,6 +14,11 @@ function defaultEnvSource(key) {
 /**
 * Creates an environment context for use with Optique runners.
 *
+* 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.
+*
 * @param options Environment context options.
 * @returns A context that provides environment source annotations.
 * @throws {TypeError} If `prefix` is not a string.
@@ -63,12 +43,9 @@ function createEnvContext(options = {}) {
 				prefix,
 				source
 			};
-			setActiveEnvSource(contextId, sourceData);
 			return { [contextId]: sourceData };
 		},
-		[Symbol.dispose]() {
-			clearActiveEnvSource(contextId);
-		}
+		[Symbol.dispose]() {}
 	};
 }
 /**
@@ -251,7 +228,7 @@ function bindEnv(parser, options) {
 */
 function getEnvOrDefault(state, options, mode, innerParser, innerState, exec) {
 	const annotations = getAnnotations(state);
-	const sourceData = annotations?.[options.context.id] ?? getActiveEnvSource(options.context.id);
+	const sourceData = annotations?.[options.context.id];
 	const fullKey = `${sourceData?.prefix ?? options.context.prefix}${options.key}`;
 	const rawValue = sourceData?.source(fullKey);
 	const validateSync = (parsed) => {
@@ -299,10 +276,9 @@ function getEnvOrDefault(state, options, mode, innerParser, innerState, exec) {
 /**
 * Resolves an env-backed dependency source with env and default fallbacks.
 *
-* This first checks annotations or the active env registry for the bound
-* variable. If no env-backed value is available, it falls back to
-* `options.default` and finally delegates to the wrapped parser's source
-* extractor.
+* This first checks annotations for the bound variable. If no env-backed value
+* is available, it falls back to `options.default` and finally delegates to
+* the wrapped parser's source extractor.
 *
 * When `innerParser` exposes a `validateValue` hook, env-sourced values
 * and the configured default are re-validated against the inner parser's
@@ -327,7 +303,7 @@ function getEnvOrDefault(state, options, mode, innerParser, innerState, exec) {
 */
 function getEnvSourceValue(state, options, innerState, extractInnerSourceValue, innerParser) {
 	const annotations = getAnnotations(state);
-	const sourceData = annotations?.[options.context.id] ?? getActiveEnvSource(options.context.id);
+	const sourceData = annotations?.[options.context.id];
 	const fullKey = `${sourceData?.prefix ?? options.context.prefix}${options.key}`;
 	const rawValue = sourceData?.source(fullKey);
 	const validateFallback = (parsed) => {
@@ -417,4 +393,4 @@ function bool(options = {}) {
 }
 
 //#endregion
-export { bindEnv, bool, clearActiveEnvSource, createEnvContext, getActiveEnvSource, setActiveEnvSource };
+export { bindEnv, bool, createEnvContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/env",
-  "version": "1.0.0-dev.1810+8961582d",
+  "version": "1.0.0-dev.1826+dae48c84",
   "description": "Environment variable support for Optique",
   "keywords": [
     "CLI",
@@ -54,7 +54,7 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@optique/core": "1.0.0-dev.1810+8961582d"
+    "@optique/core": "1.0.0-dev.1826+dae48c84"
   },
   "devDependencies": {
     "@types/node": "^20.19.9",