@optique/core 0.10.0-dev.294 → 0.10.0-dev.296

package/dist/dependency.cjs

@@ -1,3 +1,4 @@
+const require_message = require('./message.cjs');
 
 //#region src/dependency.ts
 /**
@@ -200,7 +201,16 @@ function createSyncDerivedFromParser(sourceId, options) {
 			return derivedParser.parse(input);
 		},
 		[ParseWithDependency](input, dependencyValue) {
-			const derivedParser = options.factory(...dependencyValue);
+			let derivedParser;
+			try {
+				derivedParser = options.factory(...dependencyValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return {
+					success: false,
+					error: require_message.message`Factory error: ${msg}`
+				};
+			}
 			return derivedParser.parse(input);
 		},
 		format(value) {
@@ -233,7 +243,16 @@ function createAsyncDerivedFromParserFromAsyncFactory(sourceId, options) {
 			return derivedParser.parse(input);
 		},
 		[ParseWithDependency](input, dependencyValue) {
-			const derivedParser = options.factory(...dependencyValue);
+			let derivedParser;
+			try {
+				derivedParser = options.factory(...dependencyValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: require_message.message`Factory error: ${msg}`
+				});
+			}
 			return derivedParser.parse(input);
 		},
 		format(value) {
@@ -266,7 +285,16 @@ function createAsyncDerivedFromParserFromSyncFactory(sourceId, options) {
 			return Promise.resolve(derivedParser.parse(input));
 		},
 		[ParseWithDependency](input, dependencyValue) {
-			const derivedParser = options.factory(...dependencyValue);
+			let derivedParser;
+			try {
+				derivedParser = options.factory(...dependencyValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: require_message.message`Factory error: ${msg}`
+				});
+			}
 			return Promise.resolve(derivedParser.parse(input));
 		},
 		format(value) {
@@ -311,7 +339,16 @@ function createSyncDerivedParser(sourceId, options) {
 			return derivedParser.parse(input);
 		},
 		[ParseWithDependency](input, dependencyValue) {
-			const derivedParser = options.factory(dependencyValue);
+			let derivedParser;
+			try {
+				derivedParser = options.factory(dependencyValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return {
+					success: false,
+					error: require_message.message`Factory error: ${msg}`
+				};
+			}
 			return derivedParser.parse(input);
 		},
 		format(value) {
@@ -342,7 +379,16 @@ function createAsyncDerivedParserFromAsyncFactory(sourceId, options) {
 			return derivedParser.parse(input);
 		},
 		[ParseWithDependency](input, dependencyValue) {
-			const derivedParser = options.factory(dependencyValue);
+			let derivedParser;
+			try {
+				derivedParser = options.factory(dependencyValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: require_message.message`Factory error: ${msg}`
+				});
+			}
 			return derivedParser.parse(input);
 		},
 		format(value) {
@@ -373,7 +419,16 @@ function createAsyncDerivedParserFromSyncFactory(sourceId, options) {
 			return Promise.resolve(derivedParser.parse(input));
 		},
 		[ParseWithDependency](input, dependencyValue) {
-			const derivedParser = options.factory(dependencyValue);
+			let derivedParser;
+			try {
+				derivedParser = options.factory(dependencyValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: require_message.message`Factory error: ${msg}`
+				});
+			}
 			return Promise.resolve(derivedParser.parse(input));
 		},
 		format(value) {
@@ -457,6 +512,73 @@ function createDependencySourceState(result, dependencyId) {
 	};
 }
 /**
+* A unique symbol used to identify pending dependency source states.
+* @since 0.10.0
+*/
+const PendingDependencySourceStateMarker = Symbol.for("@optique/core/dependency/PendingDependencySourceStateMarker");
+/**
+* Checks if a value is a {@link PendingDependencySourceState}.
+*
+* @param value The value to check.
+* @returns `true` if the value is a pending dependency source state.
+* @since 0.10.0
+*/
+function isPendingDependencySourceState(value) {
+	return typeof value === "object" && value !== null && PendingDependencySourceStateMarker in value && value[PendingDependencySourceStateMarker] === true;
+}
+/**
+* Creates a pending dependency source state.
+*
+* @param dependencyId The dependency ID.
+* @returns A PendingDependencySourceState object.
+* @since 0.10.0
+*/
+function createPendingDependencySourceState(dependencyId) {
+	return {
+		[PendingDependencySourceStateMarker]: true,
+		[DependencyId]: dependencyId
+	};
+}
+/**
+* A unique symbol used to identify parsers that wrap a dependency source.
+* This is used by withDefault to indicate it contains an inner parser
+* with a PendingDependencySourceState initialState.
+* @since 0.10.0
+*/
+const WrappedDependencySourceMarker = Symbol.for("@optique/core/dependency/WrappedDependencySourceMarker");
+/**
+* A unique symbol used to indicate that a wrapper transforms the dependency
+* source value. This is used by withDefault to determine whether its default
+* value should be registered as the dependency value.
+*
+* When a wrapper has this marker set to `true`, it means the wrapper transforms
+* the dependency source value (e.g., via map()), so the wrapper's output is NOT
+* a valid dependency source value.
+*
+* @since 0.10.0
+*/
+const TransformsDependencyValueMarker = Symbol.for("@optique/core/dependency/TransformsDependencyValueMarker");
+/**
+* Checks if a parser transforms the dependency value (has TransformsDependencyValueMarker).
+*
+* @param parser The parser to check.
+* @returns `true` if the parser transforms the dependency value.
+* @since 0.10.0
+*/
+function transformsDependencyValue(parser) {
+	return typeof parser === "object" && parser !== null && TransformsDependencyValueMarker in parser && parser[TransformsDependencyValueMarker] === true;
+}
+/**
+* Checks if a parser wraps a dependency source (has WrappedDependencySourceMarker).
+*
+* @param parser The parser to check.
+* @returns `true` if the parser wraps a dependency source.
+* @since 0.10.0
+*/
+function isWrappedDependencySource(parser) {
+	return typeof parser === "object" && parser !== null && WrappedDependencySourceMarker in parser;
+}
+/**
 * A registry for storing resolved dependency values during parsing.
 * This is used to pass dependency values from DependencySource options
 * to DerivedValueParser options.
@@ -530,8 +652,12 @@ exports.DependencySourceMarker = DependencySourceMarker;
 exports.DependencySourceStateMarker = DependencySourceStateMarker;
 exports.DerivedValueParserMarker = DerivedValueParserMarker;
 exports.ParseWithDependency = ParseWithDependency;
+exports.PendingDependencySourceStateMarker = PendingDependencySourceStateMarker;
+exports.TransformsDependencyValueMarker = TransformsDependencyValueMarker;
+exports.WrappedDependencySourceMarker = WrappedDependencySourceMarker;
 exports.createDeferredParseState = createDeferredParseState;
 exports.createDependencySourceState = createDependencySourceState;
+exports.createPendingDependencySourceState = createPendingDependencySourceState;
 exports.dependency = dependency;
 exports.deriveFrom = deriveFrom;
 exports.deriveFromAsync = deriveFromAsync;
@@ -540,4 +666,7 @@ exports.formatDependencyError = formatDependencyError;
 exports.isDeferredParseState = isDeferredParseState;
 exports.isDependencySource = isDependencySource;
 exports.isDependencySourceState = isDependencySourceState;
-exports.isDerivedValueParser = isDerivedValueParser;
+exports.isDerivedValueParser = isDerivedValueParser;
+exports.isPendingDependencySourceState = isPendingDependencySourceState;
+exports.isWrappedDependencySource = isWrappedDependencySource;
+exports.transformsDependencyValue = transformsDependencyValue;

package/dist/dependency.d.cts

@@ -556,6 +556,84 @@ declare function isDependencySourceState<T>(value: unknown): value is Dependency
  * @since 0.10.0
  */
 declare function createDependencySourceState<T>(result: ValueParserResult<T>, dependencyId: symbol): DependencySourceState<T>;
+/**
+ * A unique symbol used to identify pending dependency source states.
+ * @since 0.10.0
+ */
+declare const PendingDependencySourceStateMarker: unique symbol;
+/**
+ * Represents a pending dependency source state.
+ * This is used when a dependency source option was not provided, but its
+ * dependency ID still needs to be tracked for later resolution with a
+ * default value.
+ *
+ * @since 0.10.0
+ */
+interface PendingDependencySourceState {
+  /**
+   * Marker to identify this as a pending dependency source state.
+   */
+  readonly [PendingDependencySourceStateMarker]: true;
+  /**
+   * The dependency ID of the source.
+   */
+  readonly [DependencyId]: symbol;
+}
+/**
+ * Checks if a value is a {@link PendingDependencySourceState}.
+ *
+ * @param value The value to check.
+ * @returns `true` if the value is a pending dependency source state.
+ * @since 0.10.0
+ */
+declare function isPendingDependencySourceState(value: unknown): value is PendingDependencySourceState;
+/**
+ * Creates a pending dependency source state.
+ *
+ * @param dependencyId The dependency ID.
+ * @returns A PendingDependencySourceState object.
+ * @since 0.10.0
+ */
+declare function createPendingDependencySourceState(dependencyId: symbol): PendingDependencySourceState;
+/**
+ * A unique symbol used to identify parsers that wrap a dependency source.
+ * This is used by withDefault to indicate it contains an inner parser
+ * with a PendingDependencySourceState initialState.
+ * @since 0.10.0
+ */
+declare const WrappedDependencySourceMarker: unique symbol;
+/**
+ * A unique symbol used to indicate that a wrapper transforms the dependency
+ * source value. This is used by withDefault to determine whether its default
+ * value should be registered as the dependency value.
+ *
+ * When a wrapper has this marker set to `true`, it means the wrapper transforms
+ * the dependency source value (e.g., via map()), so the wrapper's output is NOT
+ * a valid dependency source value.
+ *
+ * @since 0.10.0
+ */
+declare const TransformsDependencyValueMarker: unique symbol;
+/**
+ * Checks if a parser transforms the dependency value (has TransformsDependencyValueMarker).
+ *
+ * @param parser The parser to check.
+ * @returns `true` if the parser transforms the dependency value.
+ * @since 0.10.0
+ */
+declare function transformsDependencyValue(parser: unknown): parser is {
+  [TransformsDependencyValueMarker]: true;
+};
+/**
+ * Checks if a parser wraps a dependency source (has WrappedDependencySourceMarker).
+ *
+ * @param parser The parser to check.
+ * @returns `true` if the parser wraps a dependency source.
+ * @since 0.10.0
+ */
+declare function isWrappedDependencySource(parser: unknown): parser is {
+  [WrappedDependencySourceMarker]: PendingDependencySourceState;
+};
 /**
  * Represents a resolved dependency value stored during parsing.
  * @since 0.10.0
@@ -635,4 +713,4 @@ type DependencyError = {
  */
 declare function formatDependencyError(error: DependencyError): Message;
 //#endregion
-export { AnyDependencySource, CombineMode, CombinedDependencyMode, DeferredParseMarker, DeferredParseState, DependencyError, DependencyId, DependencyIds, DependencyMode, DependencyRegistry, DependencySource, DependencySourceMarker, DependencySourceState, DependencySourceStateMarker, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DerivedValueParserMarker, ParseWithDependency, ResolvedDependency, createDeferredParseState, createDependencySourceState, dependency, deriveFrom, deriveFromAsync, deriveFromSync, formatDependencyError, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser };
+export { AnyDependencySource, CombineMode, CombinedDependencyMode, DeferredParseMarker, DeferredParseState, DependencyError, DependencyId, DependencyIds, DependencyMode, DependencyRegistry, DependencySource, DependencySourceMarker, DependencySourceState, DependencySourceStateMarker, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DerivedValueParserMarker, ParseWithDependency, PendingDependencySourceState, PendingDependencySourceStateMarker, ResolvedDependency, TransformsDependencyValueMarker, WrappedDependencySourceMarker, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, dependency, deriveFrom, deriveFromAsync, deriveFromSync, formatDependencyError, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isPendingDependencySourceState, isWrappedDependencySource, transformsDependencyValue };

package/dist/dependency.d.ts

@@ -556,6 +556,84 @@ declare function isDependencySourceState<T>(value: unknown): value is Dependency
  * @since 0.10.0
  */
 declare function createDependencySourceState<T>(result: ValueParserResult<T>, dependencyId: symbol): DependencySourceState<T>;
+/**
+ * A unique symbol used to identify pending dependency source states.
+ * @since 0.10.0
+ */
+declare const PendingDependencySourceStateMarker: unique symbol;
+/**
+ * Represents a pending dependency source state.
+ * This is used when a dependency source option was not provided, but its
+ * dependency ID still needs to be tracked for later resolution with a
+ * default value.
+ *
+ * @since 0.10.0
+ */
+interface PendingDependencySourceState {
+  /**
+   * Marker to identify this as a pending dependency source state.
+   */
+  readonly [PendingDependencySourceStateMarker]: true;
+  /**
+   * The dependency ID of the source.
+   */
+  readonly [DependencyId]: symbol;
+}
+/**
+ * Checks if a value is a {@link PendingDependencySourceState}.
+ *
+ * @param value The value to check.
+ * @returns `true` if the value is a pending dependency source state.
+ * @since 0.10.0
+ */
+declare function isPendingDependencySourceState(value: unknown): value is PendingDependencySourceState;
+/**
+ * Creates a pending dependency source state.
+ *
+ * @param dependencyId The dependency ID.
+ * @returns A PendingDependencySourceState object.
+ * @since 0.10.0
+ */
+declare function createPendingDependencySourceState(dependencyId: symbol): PendingDependencySourceState;
+/**
+ * A unique symbol used to identify parsers that wrap a dependency source.
+ * This is used by withDefault to indicate it contains an inner parser
+ * with a PendingDependencySourceState initialState.
+ * @since 0.10.0
+ */
+declare const WrappedDependencySourceMarker: unique symbol;
+/**
+ * A unique symbol used to indicate that a wrapper transforms the dependency
+ * source value. This is used by withDefault to determine whether its default
+ * value should be registered as the dependency value.
+ *
+ * When a wrapper has this marker set to `true`, it means the wrapper transforms
+ * the dependency source value (e.g., via map()), so the wrapper's output is NOT
+ * a valid dependency source value.
+ *
+ * @since 0.10.0
+ */
+declare const TransformsDependencyValueMarker: unique symbol;
+/**
+ * Checks if a parser transforms the dependency value (has TransformsDependencyValueMarker).
+ *
+ * @param parser The parser to check.
+ * @returns `true` if the parser transforms the dependency value.
+ * @since 0.10.0
+ */
+declare function transformsDependencyValue(parser: unknown): parser is {
+  [TransformsDependencyValueMarker]: true;
+};
+/**
+ * Checks if a parser wraps a dependency source (has WrappedDependencySourceMarker).
+ *
+ * @param parser The parser to check.
+ * @returns `true` if the parser wraps a dependency source.
+ * @since 0.10.0
+ */
+declare function isWrappedDependencySource(parser: unknown): parser is {
+  [WrappedDependencySourceMarker]: PendingDependencySourceState;
+};
 /**
  * Represents a resolved dependency value stored during parsing.
  * @since 0.10.0
@@ -635,4 +713,4 @@ type DependencyError = {
  */
 declare function formatDependencyError(error: DependencyError): Message;
 //#endregion
-export { AnyDependencySource, CombineMode, CombinedDependencyMode, DeferredParseMarker, DeferredParseState, DependencyError, DependencyId, DependencyIds, DependencyMode, DependencyRegistry, DependencySource, DependencySourceMarker, DependencySourceState, DependencySourceStateMarker, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DerivedValueParserMarker, ParseWithDependency, ResolvedDependency, createDeferredParseState, createDependencySourceState, dependency, deriveFrom, deriveFromAsync, deriveFromSync, formatDependencyError, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser };
+export { AnyDependencySource, CombineMode, CombinedDependencyMode, DeferredParseMarker, DeferredParseState, DependencyError, DependencyId, DependencyIds, DependencyMode, DependencyRegistry, DependencySource, DependencySourceMarker, DependencySourceState, DependencySourceStateMarker, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DerivedValueParserMarker, ParseWithDependency, PendingDependencySourceState, PendingDependencySourceStateMarker, ResolvedDependency, TransformsDependencyValueMarker, WrappedDependencySourceMarker, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, dependency, deriveFrom, deriveFromAsync, deriveFromSync, formatDependencyError, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isPendingDependencySourceState, isWrappedDependencySource, transformsDependencyValue };

package/dist/dependency.js

@@ -1,3 +1,5 @@
+import { message } from "./message.js";
+
 //#region src/dependency.ts
 /**
 * A unique symbol used to identify dependency sources at compile time.
@@ -199,7 +201,16 @@ function createSyncDerivedFromParser(sourceId, options) {
 			return derivedParser.parse(input);
 		},
 		[ParseWithDependency](input, dependencyValue) {
-			const derivedParser = options.factory(...dependencyValue);
+			let derivedParser;
+			try {
+				derivedParser = options.factory(...dependencyValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return {
+					success: false,
+					error: message`Factory error: ${msg}`
+				};
+			}
 			return derivedParser.parse(input);
 		},
 		format(value) {
@@ -232,7 +243,16 @@ function createAsyncDerivedFromParserFromAsyncFactory(sourceId, options) {
 			return derivedParser.parse(input);
 		},
 		[ParseWithDependency](input, dependencyValue) {
-			const derivedParser = options.factory(...dependencyValue);
+			let derivedParser;
+			try {
+				derivedParser = options.factory(...dependencyValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: message`Factory error: ${msg}`
+				});
+			}
 			return derivedParser.parse(input);
 		},
 		format(value) {
@@ -265,7 +285,16 @@ function createAsyncDerivedFromParserFromSyncFactory(sourceId, options) {
 			return Promise.resolve(derivedParser.parse(input));
 		},
 		[ParseWithDependency](input, dependencyValue) {
-			const derivedParser = options.factory(...dependencyValue);
+			let derivedParser;
+			try {
+				derivedParser = options.factory(...dependencyValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: message`Factory error: ${msg}`
+				});
+			}
 			return Promise.resolve(derivedParser.parse(input));
 		},
 		format(value) {
@@ -310,7 +339,16 @@ function createSyncDerivedParser(sourceId, options) {
 			return derivedParser.parse(input);
 		},
 		[ParseWithDependency](input, dependencyValue) {
-			const derivedParser = options.factory(dependencyValue);
+			let derivedParser;
+			try {
+				derivedParser = options.factory(dependencyValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return {
+					success: false,
+					error: message`Factory error: ${msg}`
+				};
+			}
 			return derivedParser.parse(input);
 		},
 		format(value) {
@@ -341,7 +379,16 @@ function createAsyncDerivedParserFromAsyncFactory(sourceId, options) {
 			return derivedParser.parse(input);
 		},
 		[ParseWithDependency](input, dependencyValue) {
-			const derivedParser = options.factory(dependencyValue);
+			let derivedParser;
+			try {
+				derivedParser = options.factory(dependencyValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: message`Factory error: ${msg}`
+				});
+			}
 			return derivedParser.parse(input);
 		},
 		format(value) {
@@ -372,7 +419,16 @@ function createAsyncDerivedParserFromSyncFactory(sourceId, options) {
 			return Promise.resolve(derivedParser.parse(input));
 		},
 		[ParseWithDependency](input, dependencyValue) {
-			const derivedParser = options.factory(dependencyValue);
+			let derivedParser;
+			try {
+				derivedParser = options.factory(dependencyValue);
+			} catch (e) {
+				const msg = e instanceof Error ? e.message : String(e);
+				return Promise.resolve({
+					success: false,
+					error: message`Factory error: ${msg}`
+				});
+			}
 			return Promise.resolve(derivedParser.parse(input));
 		},
 		format(value) {
@@ -456,6 +512,73 @@ function createDependencySourceState(result, dependencyId) {
 	};
 }
 /**
+* A unique symbol used to identify pending dependency source states.
+* @since 0.10.0
+*/
+const PendingDependencySourceStateMarker = Symbol.for("@optique/core/dependency/PendingDependencySourceStateMarker");
+/**
+* Checks if a value is a {@link PendingDependencySourceState}.
+*
+* @param value The value to check.
+* @returns `true` if the value is a pending dependency source state.
+* @since 0.10.0
+*/
+function isPendingDependencySourceState(value) {
+	return typeof value === "object" && value !== null && PendingDependencySourceStateMarker in value && value[PendingDependencySourceStateMarker] === true;
+}
+/**
+* Creates a pending dependency source state.
+*
+* @param dependencyId The dependency ID.
+* @returns A PendingDependencySourceState object.
+* @since 0.10.0
+*/
+function createPendingDependencySourceState(dependencyId) {
+	return {
+		[PendingDependencySourceStateMarker]: true,
+		[DependencyId]: dependencyId
+	};
+}
+/**
+* A unique symbol used to identify parsers that wrap a dependency source.
+* This is used by withDefault to indicate it contains an inner parser
+* with a PendingDependencySourceState initialState.
+* @since 0.10.0
+*/
+const WrappedDependencySourceMarker = Symbol.for("@optique/core/dependency/WrappedDependencySourceMarker");
+/**
+* A unique symbol used to indicate that a wrapper transforms the dependency
+* source value. This is used by withDefault to determine whether its default
+* value should be registered as the dependency value.
+*
+* When a wrapper has this marker set to `true`, it means the wrapper transforms
+* the dependency source value (e.g., via map()), so the wrapper's output is NOT
+* a valid dependency source value.
+*
+* @since 0.10.0
+*/
+const TransformsDependencyValueMarker = Symbol.for("@optique/core/dependency/TransformsDependencyValueMarker");
+/**
+* Checks if a parser transforms the dependency value (has TransformsDependencyValueMarker).
+*
+* @param parser The parser to check.
+* @returns `true` if the parser transforms the dependency value.
+* @since 0.10.0
+*/
+function transformsDependencyValue(parser) {
+	return typeof parser === "object" && parser !== null && TransformsDependencyValueMarker in parser && parser[TransformsDependencyValueMarker] === true;
+}
+/**
+* Checks if a parser wraps a dependency source (has WrappedDependencySourceMarker).
+*
+* @param parser The parser to check.
+* @returns `true` if the parser wraps a dependency source.
+* @since 0.10.0
+*/
+function isWrappedDependencySource(parser) {
+	return typeof parser === "object" && parser !== null && WrappedDependencySourceMarker in parser;
+}
+/**
 * A registry for storing resolved dependency values during parsing.
 * This is used to pass dependency values from DependencySource options
 * to DerivedValueParser options.
@@ -521,4 +644,4 @@ function formatDependencyError(error) {
 }
 
 //#endregion
-export { DeferredParseMarker, DependencyId, DependencyIds, DependencyRegistry, DependencySourceMarker, DependencySourceStateMarker, DerivedValueParserMarker, ParseWithDependency, createDeferredParseState, createDependencySourceState, dependency, deriveFrom, deriveFromAsync, deriveFromSync, formatDependencyError, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser };
+export { DeferredParseMarker, DependencyId, DependencyIds, DependencyRegistry, DependencySourceMarker, DependencySourceStateMarker, DerivedValueParserMarker, ParseWithDependency, PendingDependencySourceStateMarker, TransformsDependencyValueMarker, WrappedDependencySourceMarker, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, dependency, deriveFrom, deriveFromAsync, deriveFromSync, formatDependencyError, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isPendingDependencySourceState, isWrappedDependencySource, transformsDependencyValue };

package/dist/index.cjs

@@ -20,9 +20,12 @@ exports.DependencySourceStateMarker = require_dependency.DependencySourceStateMa
 exports.DerivedValueParserMarker = require_dependency.DerivedValueParserMarker;
 exports.DuplicateOptionError = require_constructs.DuplicateOptionError;
 exports.ParseWithDependency = require_dependency.ParseWithDependency;
+exports.PendingDependencySourceStateMarker = require_dependency.PendingDependencySourceStateMarker;
 exports.RunError = require_facade.RunError;
 exports.RunParserError = require_facade.RunParserError;
+exports.TransformsDependencyValueMarker = require_dependency.TransformsDependencyValueMarker;
 exports.WithDefaultError = require_modifiers.WithDefaultError;
+exports.WrappedDependencySourceMarker = require_dependency.WrappedDependencySourceMarker;
 exports.argument = require_primitives.argument;
 exports.bash = require_completion.bash;
 exports.choice = require_valueparser.choice;
@@ -33,6 +36,7 @@ exports.conditional = require_constructs.conditional;
 exports.constant = require_primitives.constant;
 exports.createDeferredParseState = require_dependency.createDeferredParseState;
 exports.createDependencySourceState = require_dependency.createDependencySourceState;
+exports.createPendingDependencySourceState = require_dependency.createPendingDependencySourceState;
 exports.dependency = require_dependency.dependency;
 exports.deriveFrom = require_dependency.deriveFrom;
 exports.deriveFromAsync = require_dependency.deriveFromAsync;
@@ -60,7 +64,9 @@ exports.isDependencySource = require_dependency.isDependencySource;
 exports.isDependencySourceState = require_dependency.isDependencySourceState;
 exports.isDerivedValueParser = require_dependency.isDerivedValueParser;
 exports.isNonEmptyString = require_nonempty.isNonEmptyString;
+exports.isPendingDependencySourceState = require_dependency.isPendingDependencySourceState;
 exports.isValueParser = require_valueparser.isValueParser;
+exports.isWrappedDependencySource = require_dependency.isWrappedDependencySource;
 exports.locale = require_valueparser.locale;
 exports.longestMatch = require_constructs.longestMatch;
 exports.map = require_modifiers.map;
@@ -90,6 +96,7 @@ exports.suggest = require_parser.suggest;
 exports.suggestAsync = require_parser.suggestAsync;
 exports.suggestSync = require_parser.suggestSync;
 exports.text = require_message.text;
+exports.transformsDependencyValue = require_dependency.transformsDependencyValue;
 exports.tuple = require_constructs.tuple;
 exports.url = require_valueparser.url;
 exports.uuid = require_valueparser.uuid;

package/dist/index.d.cts

@@ -5,9 +5,9 @@ import { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, Doc
 import { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, FloatOptions, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, choice, float, integer, isValueParser, locale, string, url, uuid } from "./valueparser.cjs";
 import { ConditionalErrorOptions, ConditionalOptions, DuplicateOptionError, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OrErrorOptions, OrOptions, TupleOptions, concat, conditional, group, longestMatch, merge, object, or, tuple } from "./constructs.cjs";
 import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOptions, map, multiple, optional, withDefault } from "./modifiers.cjs";
-import { AnyDependencySource, CombineMode, CombinedDependencyMode, DeferredParseMarker, DeferredParseState, DependencyError, DependencyId, DependencyIds, DependencyMode, DependencyRegistry, DependencySource, DependencySourceMarker, DependencySourceState, DependencySourceStateMarker, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DerivedValueParserMarker, ParseWithDependency, ResolvedDependency, createDeferredParseState, createDependencySourceState, dependency, deriveFrom, deriveFromAsync, deriveFromSync, formatDependencyError, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser } from "./dependency.cjs";
+import { AnyDependencySource, CombineMode, CombinedDependencyMode, DeferredParseMarker, DeferredParseState, DependencyError, DependencyId, DependencyIds, DependencyMode, DependencyRegistry, DependencySource, DependencySourceMarker, DependencySourceState, DependencySourceStateMarker, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DerivedValueParserMarker, ParseWithDependency, PendingDependencySourceState, PendingDependencySourceStateMarker, ResolvedDependency, TransformsDependencyValueMarker, WrappedDependencySourceMarker, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, dependency, deriveFrom, deriveFromAsync, deriveFromSync, formatDependencyError, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isPendingDependencySourceState, isWrappedDependencySource, transformsDependencyValue } from "./dependency.cjs";
 import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, flag, option, passThrough } from "./primitives.cjs";
 import { CombineModes, DocState, InferMode, InferValue, Mode, ModeIterable, ModeValue, Parser, ParserContext, ParserResult, Result, Suggestion, getDocPage, getDocPageAsync, getDocPageSync, parse, parseAsync, parseSync, suggest, suggestAsync, suggestSync } from "./parser.cjs";
 import { ShellCompletion, bash, fish, nu, pwsh, zsh } from "./completion.cjs";
 import { RunError, RunOptions, RunParserError, run, runParser, runParserAsync, runParserSync } from "./facade.cjs";
-export { AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CombineMode, CombineModes, CombinedDependencyMode, CommandErrorOptions, CommandOptions, ConditionalErrorOptions, ConditionalOptions, DeferredParseMarker, DeferredParseState, DependencyError, DependencyId, DependencyIds, DependencyMode, DependencyRegistry, DependencySource, DependencySourceMarker, DependencySourceState, DependencySourceStateMarker, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DerivedValueParserMarker, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DuplicateOptionError, FlagErrorOptions, FlagOptions, FloatOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, Message, MessageFormatOptions, MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OptionState, OrErrorOptions, OrOptions, ParseWithDependency, Parser, ParserContext, ParserResult, PassThroughFormat, PassThroughOptions, ResolvedDependency, Result, RunError, RunOptions, RunParserError, ShellCompletion, ShowDefaultOptions, StringOptions, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, ValueSetOptions, WithDefaultError, WithDefaultOptions, argument, bash, choice, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, dependency, deriveFrom, deriveFromAsync, deriveFromSync, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, getDocPageAsync, getDocPageSync, group, integer, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isNonEmptyString, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, pwsh, run, runParser, runParserAsync, runParserSync, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };
+export { AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CombineMode, CombineModes, CombinedDependencyMode, CommandErrorOptions, CommandOptions, ConditionalErrorOptions, ConditionalOptions, DeferredParseMarker, DeferredParseState, DependencyError, DependencyId, DependencyIds, DependencyMode, DependencyRegistry, DependencySource, DependencySourceMarker, DependencySourceState, DependencySourceStateMarker, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DerivedValueParserMarker, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DuplicateOptionError, FlagErrorOptions, FlagOptions, FloatOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, Message, MessageFormatOptions, MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OptionState, OrErrorOptions, OrOptions, ParseWithDependency, Parser, ParserContext, ParserResult, PassThroughFormat, PassThroughOptions, PendingDependencySourceState, PendingDependencySourceStateMarker, ResolvedDependency, Result, RunError, RunOptions, RunParserError, ShellCompletion, ShowDefaultOptions, StringOptions, Suggestion, TransformsDependencyValueMarker, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, ValueSetOptions, WithDefaultError, WithDefaultOptions, WrappedDependencySourceMarker, argument, bash, choice, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, dependency, deriveFrom, deriveFromAsync, deriveFromSync, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, getDocPageAsync, getDocPageSync, group, integer, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isNonEmptyString, isPendingDependencySourceState, isValueParser, isWrappedDependencySource, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, pwsh, run, runParser, runParserAsync, runParserSync, string, suggest, suggestAsync, suggestSync, text, transformsDependencyValue, tuple, url, uuid, value, valueSet, values, withDefault, zsh };