@optique/core 1.0.0-dev.1616 → 1.0.0-dev.1658

package/dist/dependency.cjs

@@ -35,14 +35,21 @@ const defaultValues = Symbol.for("@optique/core/dependency/defaultValues");
 /**
 * A unique symbol used to store the single default value thunk on derived
 * parsers created by {@link DependencySource.derive}.  Unlike
-* {@link defaultValues} (which `createDeferredParseState` reads eagerly),
-* this symbol is only read by the dependency-metadata bridge so that
+* {@link defaultValues} (which `createDeferredParseState` only falls back to
+* when no parse-time snapshot is available), this symbol is only read by the
+* dependency-metadata bridge so that
 * single-source defaults are accessible without double evaluation.
 * @internal
-* @since 1.0.0
 */
 const singleDefaultValue = Symbol.for("@optique/core/dependency/singleDefaultValue");
 /**
+* A unique symbol used to store the snapshotted default dependency values on
+* a parse result produced by a derived parser's default path.
+*
+* @internal
+*/
+const defaultDependencyValueSnapshot = Symbol.for("@optique/core/dependency/defaultDependencyValueSnapshot");
+/**
 * A unique symbol used to access the parseWithDependency method on derived parsers.
 * @since 0.10.0
 */
@@ -228,6 +235,52 @@ function normalizeWithDerivedParser(value, getParser) {
 	}
 	return value;
 }
+/**
+* Attaches a default dependency snapshot to a derived parser's parse result.
+*
+* @param result The parse result to annotate.
+* @param values The dependency values used for the default-path parse.
+* @returns A cloned parse result with an internal snapshot attached.
+* @internal
+*/
+function snapshotDefaultDependencyValues(result, values) {
+	const snapshot = getSnapshottedDefaultDependencyValues(result) ?? values;
+	return attachDefaultDependencySnapshot(result, snapshot);
+}
+function attachDefaultDependencySnapshot(result, values) {
+	const annotated = Object.create(Object.getPrototypeOf(result), Object.getOwnPropertyDescriptors(result));
+	Object.defineProperty(annotated, defaultDependencyValueSnapshot, {
+		value: [...values],
+		configurable: true,
+		enumerable: false
+	});
+	return annotated;
+}
+/**
+* Reads the snapshotted default dependency values from a parse result.
+*
+* @param result The parse result to inspect.
+* @returns The snapshotted dependency values, if present.
+* @internal
+*/
+function getSnapshottedDefaultDependencyValues(result) {
+	return result[defaultDependencyValueSnapshot];
+}
+async function parseDerivedResultAsync(parser, input) {
+	return await parser.parse(input);
+}
+function parseDerivedResultSync(parser, input) {
+	const result = parser.parse(input);
+	if (isPromiseLike(result)) throw new TypeError("Sync derived parser parse() returned a promise-like result. Use an async derived parser instead.");
+	return result;
+}
+function isPromiseLike(value) {
+	return value != null && (typeof value === "object" || typeof value === "function") && "then" in value && typeof value.then === "function";
+}
+async function parseDerivedResultWithSnapshotAsync(parser, input, sourceValues) {
+	const snapshot = [...sourceValues];
+	return attachDefaultDependencySnapshot(await parseDerivedResultAsync(parser, input), snapshot);
+}
 function createSyncDerivedFromParser(sourceId, options) {
 	const alldependencyIds = options.dependencies.map((dep) => dep[dependencyId]);
 	return {
@@ -246,21 +299,27 @@ function createSyncDerivedFromParser(sourceId, options) {
 		[defaultValues]: options.defaultValues,
 		parse(input) {
 			let derivedParser;
+			let sourceValues;
 			try {
-				const sourceValues = options.defaultValues();
+				sourceValues = options.defaultValues();
 				derivedParser = options.factory(...sourceValues);
 			} catch (e) {
 				const msg = e instanceof Error ? e.message : String(e);
-				return {
+				const failure = {
 					success: false,
 					error: require_message.message`Derived parser error: ${msg}`
 				};
+				return sourceValues == null ? failure : snapshotDefaultDependencyValues(failure, sourceValues);
 			}
-			if (isAsyncModeParser(derivedParser)) return {
-				success: false,
-				error: require_message.message`Factory returned an async parser where a sync parser is required.`
-			};
-			return derivedParser.parse(input);
+			if (isAsyncModeParser(derivedParser)) {
+				const failure = {
+					success: false,
+					error: require_message.message`Factory returned an async parser where a sync parser is required.`
+				};
+				return sourceValues == null ? failure : snapshotDefaultDependencyValues(failure, sourceValues);
+			}
+			const snapshot = [...sourceValues];
+			return attachDefaultDependencySnapshot(parseDerivedResultSync(derivedParser, input), snapshot);
 		},
 		[parseWithDependency](input, dependencyValue) {
 			let derivedParser;
@@ -273,11 +332,14 @@ function createSyncDerivedFromParser(sourceId, options) {
 					error: require_message.message`Factory error: ${msg}`
 				};
 			}
-			if (isAsyncModeParser(derivedParser)) return {
-				success: false,
-				error: require_message.message`Factory returned an async parser where a sync parser is required.`
-			};
-			return derivedParser.parse(input);
+			if (isAsyncModeParser(derivedParser)) {
+				const failure = {
+					success: false,
+					error: require_message.message`Factory returned an async parser where a sync parser is required.`
+				};
+				return failure;
+			}
+			return parseDerivedResultSync(derivedParser, input);
 		},
 		format(value) {
 			let derivedParser;
@@ -340,32 +402,34 @@ function createAsyncDerivedFromParserFromAsyncFactory(sourceId, options) {
 		[dependencyId]: sourceId,
 		[dependencyIds]: alldependencyIds,
 		[defaultValues]: options.defaultValues,
-		parse(input) {
+		async parse(input) {
 			let derivedParser;
+			let sourceValues;
 			try {
-				const sourceValues = options.defaultValues();
+				sourceValues = options.defaultValues();
 				derivedParser = options.factory(...sourceValues);
 			} catch (e) {
 				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
+				const failure = {
 					success: false,
 					error: require_message.message`Derived parser error: ${msg}`
-				});
+				};
+				return sourceValues == null ? failure : snapshotDefaultDependencyValues(failure, sourceValues);
 			}
-			return Promise.resolve(derivedParser.parse(input));
+			return await parseDerivedResultWithSnapshotAsync(derivedParser, input, sourceValues);
 		},
-		[parseWithDependency](input, dependencyValue) {
+		async [parseWithDependency](input, dependencyValue) {
 			let derivedParser;
 			try {
 				derivedParser = options.factory(...dependencyValue);
 			} catch (e) {
 				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
+				return {
 					success: false,
 					error: require_message.message`Factory error: ${msg}`
-				});
+				};
 			}
-			return Promise.resolve(derivedParser.parse(input));
+			return await parseDerivedResultAsync(derivedParser, input);
 		},
 		format(value) {
 			let derivedParser;
@@ -426,32 +490,34 @@ function createAsyncDerivedFromParserFromSyncFactory(sourceId, options) {
 		[dependencyId]: sourceId,
 		[dependencyIds]: alldependencyIds,
 		[defaultValues]: options.defaultValues,
-		parse(input) {
+		async parse(input) {
 			let derivedParser;
+			let sourceValues;
 			try {
-				const sourceValues = options.defaultValues();
+				sourceValues = options.defaultValues();
 				derivedParser = options.factory(...sourceValues);
 			} catch (e) {
 				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
+				const failure = {
 					success: false,
 					error: require_message.message`Derived parser error: ${msg}`
-				});
+				};
+				return sourceValues == null ? failure : snapshotDefaultDependencyValues(failure, sourceValues);
 			}
-			return Promise.resolve(derivedParser.parse(input));
+			return await parseDerivedResultWithSnapshotAsync(derivedParser, input, sourceValues);
 		},
-		[parseWithDependency](input, dependencyValue) {
+		async [parseWithDependency](input, dependencyValue) {
 			let derivedParser;
 			try {
 				derivedParser = options.factory(...dependencyValue);
 			} catch (e) {
 				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
+				return {
 					success: false,
 					error: require_message.message`Factory error: ${msg}`
-				});
+				};
 			}
-			return Promise.resolve(derivedParser.parse(input));
+			return await parseDerivedResultAsync(derivedParser, input);
 		},
 		format(value) {
 			let derivedParser;
@@ -517,21 +583,28 @@ function createSyncDerivedParser(sourceId, options) {
 		[singleDefaultValue]: options.defaultValue,
 		parse(input) {
 			let derivedParser;
+			let hasSourceValue = false;
+			let sourceValue;
 			try {
-				const sourceValue = options.defaultValue();
+				sourceValue = options.defaultValue();
+				hasSourceValue = true;
 				derivedParser = options.factory(sourceValue);
 			} catch (e) {
 				const msg = e instanceof Error ? e.message : String(e);
-				return {
+				const failure = {
 					success: false,
 					error: require_message.message`Derived parser error: ${msg}`
 				};
+				return hasSourceValue ? snapshotDefaultDependencyValues(failure, [sourceValue]) : failure;
 			}
-			if (isAsyncModeParser(derivedParser)) return {
-				success: false,
-				error: require_message.message`Factory returned an async parser where a sync parser is required.`
-			};
-			return derivedParser.parse(input);
+			if (isAsyncModeParser(derivedParser)) {
+				const failure = {
+					success: false,
+					error: require_message.message`Factory returned an async parser where a sync parser is required.`
+				};
+				return hasSourceValue ? snapshotDefaultDependencyValues(failure, [sourceValue]) : failure;
+			}
+			return attachDefaultDependencySnapshot(parseDerivedResultSync(derivedParser, input), [sourceValue]);
 		},
 		[parseWithDependency](input, dependencyValue) {
 			let derivedParser;
@@ -548,7 +621,7 @@ function createSyncDerivedParser(sourceId, options) {
 				success: false,
 				error: require_message.message`Factory returned an async parser where a sync parser is required.`
 			};
-			return derivedParser.parse(input);
+			return parseDerivedResultSync(derivedParser, input);
 		},
 		format(value) {
 			let derivedParser;
@@ -608,32 +681,36 @@ function createAsyncDerivedParserFromAsyncFactory(sourceId, options) {
 		[derivedValueParserMarker]: true,
 		[dependencyId]: sourceId,
 		[singleDefaultValue]: options.defaultValue,
-		parse(input) {
+		async parse(input) {
 			let derivedParser;
+			let hasSourceValue = false;
+			let sourceValue;
 			try {
-				const sourceValue = options.defaultValue();
+				sourceValue = options.defaultValue();
+				hasSourceValue = true;
 				derivedParser = options.factory(sourceValue);
 			} catch (e) {
 				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
+				const failure = {
 					success: false,
 					error: require_message.message`Derived parser error: ${msg}`
-				});
+				};
+				return hasSourceValue ? snapshotDefaultDependencyValues(failure, [sourceValue]) : failure;
 			}
-			return Promise.resolve(derivedParser.parse(input));
+			return await parseDerivedResultWithSnapshotAsync(derivedParser, input, [sourceValue]);
 		},
-		[parseWithDependency](input, dependencyValue) {
+		async [parseWithDependency](input, dependencyValue) {
 			let derivedParser;
 			try {
 				derivedParser = options.factory(dependencyValue);
 			} catch (e) {
 				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
+				return {
 					success: false,
 					error: require_message.message`Factory error: ${msg}`
-				});
+				};
 			}
-			return Promise.resolve(derivedParser.parse(input));
+			return await parseDerivedResultAsync(derivedParser, input);
 		},
 		format(value) {
 			let derivedParser;
@@ -688,32 +765,36 @@ function createAsyncDerivedParserFromSyncFactory(sourceId, options) {
 		[derivedValueParserMarker]: true,
 		[dependencyId]: sourceId,
 		[singleDefaultValue]: options.defaultValue,
-		parse(input) {
+		async parse(input) {
 			let derivedParser;
+			let hasSourceValue = false;
+			let sourceValue;
 			try {
-				const sourceValue = options.defaultValue();
+				sourceValue = options.defaultValue();
+				hasSourceValue = true;
 				derivedParser = options.factory(sourceValue);
 			} catch (e) {
 				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
+				const failure = {
 					success: false,
 					error: require_message.message`Derived parser error: ${msg}`
-				});
+				};
+				return hasSourceValue ? snapshotDefaultDependencyValues(failure, [sourceValue]) : failure;
 			}
-			return Promise.resolve(derivedParser.parse(input));
+			return await parseDerivedResultWithSnapshotAsync(derivedParser, input, [sourceValue]);
 		},
-		[parseWithDependency](input, dependencyValue) {
+		async [parseWithDependency](input, dependencyValue) {
 			let derivedParser;
 			try {
 				derivedParser = options.factory(dependencyValue);
 			} catch (e) {
 				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
+				return {
 					success: false,
 					error: require_message.message`Factory error: ${msg}`
-				});
+				};
 			}
-			return Promise.resolve(derivedParser.parse(input));
+			return await parseDerivedResultAsync(derivedParser, input);
 		},
 		format(value) {
 			let derivedParser;
@@ -784,9 +865,12 @@ function getDependencyIds(parser) {
 	return [parser[dependencyId]];
 }
 /**
-* Gets the default values function from a derived parser, if present.
-* This function is available on parsers created with `deriveFrom` that
-* specify default values for their dependencies.
+* Gets the default values function from a multi-source derived parser, if
+* present.
+*
+* Single-source `derive()` defaults must stay lazy during suggestion-time
+* replay so missing dependencies do not eagerly evaluate side-effectful
+* `defaultValue()` thunks.
 *
 * @param parser The derived value parser to get the default values function from.
 * @returns The default values function, or undefined if not available.
@@ -794,7 +878,7 @@ function getDependencyIds(parser) {
 * @since 0.10.0
 */
 function getDefaultValuesFunction(parser) {
-	if (defaultValues in parser) return parser[defaultValues];
+	if (Object.hasOwn(parser, defaultValues)) return parser[defaultValues];
 	return void 0;
 }
 /**
@@ -810,8 +894,14 @@ function getDefaultValuesFunction(parser) {
 */
 function createDeferredParseState(rawInput, parser, preliminaryResult) {
 	const multipleIds = dependencyIds in parser ? parser[dependencyIds] : void 0;
-	const defaultValuesFn = defaultValues in parser ? parser[defaultValues] : void 0;
-	const defaultVals = defaultValuesFn ? defaultValuesFn() : void 0;
+	const defaultValuesFn = getDefaultValuesFunction(parser);
+	let defaultVals = getSnapshottedDefaultDependencyValues(preliminaryResult);
+	if (defaultVals != null) defaultVals = [...defaultVals];
+	if (defaultVals == null && defaultValuesFn != null) try {
+		defaultVals = [...defaultValuesFn()];
+	} catch {
+		defaultVals = void 0;
+	}
 	return {
 		[deferredParseMarker]: true,
 		rawInput,
@@ -990,6 +1080,7 @@ exports.DependencyRegistry = DependencyRegistry;
 exports.createDeferredParseState = createDeferredParseState;
 exports.createDependencySourceState = createDependencySourceState;
 exports.createPendingDependencySourceState = createPendingDependencySourceState;
+exports.defaultDependencyValueSnapshot = defaultDependencyValueSnapshot;
 exports.defaultValues = defaultValues;
 exports.deferredParseMarker = deferredParseMarker;
 exports.dependency = dependency;
@@ -1004,6 +1095,7 @@ exports.derivedValueParserMarker = derivedValueParserMarker;
 exports.formatDependencyError = formatDependencyError;
 exports.getDefaultValuesFunction = getDefaultValuesFunction;
 exports.getDependencyIds = getDependencyIds;
+exports.getSnapshottedDefaultDependencyValues = getSnapshottedDefaultDependencyValues;
 exports.isDeferredParseState = isDeferredParseState;
 exports.isDependencySource = isDependencySource;
 exports.isDependencySourceState = isDependencySourceState;
@@ -1013,6 +1105,7 @@ exports.isWrappedDependencySource = isWrappedDependencySource;
 exports.parseWithDependency = parseWithDependency;
 exports.pendingDependencySourceStateMarker = pendingDependencySourceStateMarker;
 exports.singleDefaultValue = singleDefaultValue;
+exports.snapshotDefaultDependencyValues = snapshotDefaultDependencyValues;
 exports.suggestWithDependency = suggestWithDependency;
 exports.transformsDependencyValue = transformsDependencyValue;
 exports.transformsDependencyValueMarker = transformsDependencyValueMarker;

package/dist/dependency.d.cts

@@ -40,13 +40,20 @@ declare const defaultValues: unique symbol;
 /**
  * A unique symbol used to store the single default value thunk on derived
  * parsers created by {@link DependencySource.derive}.  Unlike
- * {@link defaultValues} (which `createDeferredParseState` reads eagerly),
- * this symbol is only read by the dependency-metadata bridge so that
+ * {@link defaultValues} (which `createDeferredParseState` only falls back to
+ * when no parse-time snapshot is available), this symbol is only read by the
+ * dependency-metadata bridge so that
  * single-source defaults are accessible without double evaluation.
  * @internal
- * @since 1.0.0
  */
 declare const singleDefaultValue: unique symbol;
+/**
+ * A unique symbol used to store the snapshotted default dependency values on
+ * a parse result produced by a derived parser's default path.
+ *
+ * @internal
+ */
+declare const defaultDependencyValueSnapshot: unique symbol;
 /**
  * A unique symbol used to access the parseWithDependency method on derived parsers.
  * @since 0.10.0
@@ -378,7 +385,6 @@ interface DerivedValueParser<M extends Mode = "sync", T = unknown, S = unknown>
    * Read by the dependency-metadata bridge; not consumed by
    * `createDeferredParseState()`.
    * @internal
-   * @since 1.0.0
    */
   readonly [singleDefaultValue]?: () => S;
   /**
@@ -513,6 +519,23 @@ declare function deriveFromSync<Deps extends readonly AnyDependencySource[], T>(
  * @since 0.10.0
  */
 declare function deriveFromAsync<Deps extends readonly AnyDependencySource[], T>(options: DeriveFromAsyncOptions<Deps, T>): DerivedValueParser<"async", T, DependencyValues<Deps>>;
+/**
+ * Attaches a default dependency snapshot to a derived parser's parse result.
+ *
+ * @param result The parse result to annotate.
+ * @param values The dependency values used for the default-path parse.
+ * @returns A cloned parse result with an internal snapshot attached.
+ * @internal
+ */
+declare function snapshotDefaultDependencyValues<T>(result: ValueParserResult<T>, values: readonly unknown[]): ValueParserResult<T>;
+/**
+ * Reads the snapshotted default dependency values from a parse result.
+ *
+ * @param result The parse result to inspect.
+ * @returns The snapshotted dependency values, if present.
+ * @internal
+ */
+declare function getSnapshottedDefaultDependencyValues<T>(result: ValueParserResult<T>): readonly unknown[] | undefined;
 /**
  * A unique symbol used to identify deferred parse states.
  * @since 0.10.0
@@ -585,9 +608,12 @@ declare function isDeferredParseState<T>(value: unknown): value is DeferredParse
  */
 declare function getDependencyIds<M extends Mode, T, S>(parser: DerivedValueParser<M, T, S>): readonly symbol[];
 /**
- * Gets the default values function from a derived parser, if present.
- * This function is available on parsers created with `deriveFrom` that
- * specify default values for their dependencies.
+ * Gets the default values function from a multi-source derived parser, if
+ * present.
+ *
+ * Single-source `derive()` defaults must stay lazy during suggestion-time
+ * replay so missing dependencies do not eagerly evaluate side-effectful
+ * `defaultValue()` thunks.
  *
  * @param parser The derived value parser to get the default values function from.
  * @returns The default values function, or undefined if not available.
@@ -809,4 +835,4 @@ type DependencyError = {
  */
 declare function formatDependencyError(error: DependencyError): Message;
 //#endregion
-export { AnyDependencySource, CombineMode, CombinedDependencyMode, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, PendingDependencySourceState, ResolvedDependency, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, formatDependencyError, getDefaultValuesFunction, getDependencyIds, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isPendingDependencySourceState, isWrappedDependencySource, parseWithDependency, pendingDependencySourceStateMarker, singleDefaultValue, suggestWithDependency, transformsDependencyValue, transformsDependencyValueMarker, wrappedDependencySourceMarker };
+export { AnyDependencySource, CombineMode, CombinedDependencyMode, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, PendingDependencySourceState, ResolvedDependency, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultDependencyValueSnapshot, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, formatDependencyError, getDefaultValuesFunction, getDependencyIds, getSnapshottedDefaultDependencyValues, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isPendingDependencySourceState, isWrappedDependencySource, parseWithDependency, pendingDependencySourceStateMarker, singleDefaultValue, snapshotDefaultDependencyValues, suggestWithDependency, transformsDependencyValue, transformsDependencyValueMarker, wrappedDependencySourceMarker };

package/dist/dependency.d.ts

@@ -40,13 +40,20 @@ declare const defaultValues: unique symbol;
 /**
  * A unique symbol used to store the single default value thunk on derived
  * parsers created by {@link DependencySource.derive}.  Unlike
- * {@link defaultValues} (which `createDeferredParseState` reads eagerly),
- * this symbol is only read by the dependency-metadata bridge so that
+ * {@link defaultValues} (which `createDeferredParseState` only falls back to
+ * when no parse-time snapshot is available), this symbol is only read by the
+ * dependency-metadata bridge so that
  * single-source defaults are accessible without double evaluation.
  * @internal
- * @since 1.0.0
  */
 declare const singleDefaultValue: unique symbol;
+/**
+ * A unique symbol used to store the snapshotted default dependency values on
+ * a parse result produced by a derived parser's default path.
+ *
+ * @internal
+ */
+declare const defaultDependencyValueSnapshot: unique symbol;
 /**
  * A unique symbol used to access the parseWithDependency method on derived parsers.
  * @since 0.10.0
@@ -378,7 +385,6 @@ interface DerivedValueParser<M extends Mode = "sync", T = unknown, S = unknown>
    * Read by the dependency-metadata bridge; not consumed by
    * `createDeferredParseState()`.
    * @internal
-   * @since 1.0.0
    */
   readonly [singleDefaultValue]?: () => S;
   /**
@@ -513,6 +519,23 @@ declare function deriveFromSync<Deps extends readonly AnyDependencySource[], T>(
  * @since 0.10.0
  */
 declare function deriveFromAsync<Deps extends readonly AnyDependencySource[], T>(options: DeriveFromAsyncOptions<Deps, T>): DerivedValueParser<"async", T, DependencyValues<Deps>>;
+/**
+ * Attaches a default dependency snapshot to a derived parser's parse result.
+ *
+ * @param result The parse result to annotate.
+ * @param values The dependency values used for the default-path parse.
+ * @returns A cloned parse result with an internal snapshot attached.
+ * @internal
+ */
+declare function snapshotDefaultDependencyValues<T>(result: ValueParserResult<T>, values: readonly unknown[]): ValueParserResult<T>;
+/**
+ * Reads the snapshotted default dependency values from a parse result.
+ *
+ * @param result The parse result to inspect.
+ * @returns The snapshotted dependency values, if present.
+ * @internal
+ */
+declare function getSnapshottedDefaultDependencyValues<T>(result: ValueParserResult<T>): readonly unknown[] | undefined;
 /**
  * A unique symbol used to identify deferred parse states.
  * @since 0.10.0
@@ -585,9 +608,12 @@ declare function isDeferredParseState<T>(value: unknown): value is DeferredParse
  */
 declare function getDependencyIds<M extends Mode, T, S>(parser: DerivedValueParser<M, T, S>): readonly symbol[];
 /**
- * Gets the default values function from a derived parser, if present.
- * This function is available on parsers created with `deriveFrom` that
- * specify default values for their dependencies.
+ * Gets the default values function from a multi-source derived parser, if
+ * present.
+ *
+ * Single-source `derive()` defaults must stay lazy during suggestion-time
+ * replay so missing dependencies do not eagerly evaluate side-effectful
+ * `defaultValue()` thunks.
  *
  * @param parser The derived value parser to get the default values function from.
  * @returns The default values function, or undefined if not available.
@@ -809,4 +835,4 @@ type DependencyError = {
  */
 declare function formatDependencyError(error: DependencyError): Message;
 //#endregion
-export { AnyDependencySource, CombineMode, CombinedDependencyMode, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, PendingDependencySourceState, ResolvedDependency, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, formatDependencyError, getDefaultValuesFunction, getDependencyIds, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isPendingDependencySourceState, isWrappedDependencySource, parseWithDependency, pendingDependencySourceStateMarker, singleDefaultValue, suggestWithDependency, transformsDependencyValue, transformsDependencyValueMarker, wrappedDependencySourceMarker };
+export { AnyDependencySource, CombineMode, CombinedDependencyMode, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, PendingDependencySourceState, ResolvedDependency, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultDependencyValueSnapshot, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, formatDependencyError, getDefaultValuesFunction, getDependencyIds, getSnapshottedDefaultDependencyValues, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isPendingDependencySourceState, isWrappedDependencySource, parseWithDependency, pendingDependencySourceStateMarker, singleDefaultValue, snapshotDefaultDependencyValues, suggestWithDependency, transformsDependencyValue, transformsDependencyValueMarker, wrappedDependencySourceMarker };