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

package/dist/constructs.cjs

@@ -879,6 +879,31 @@ async function completeDependencySourceDefaultsAsync(context, parserPairs, regis
 * mappings from its child `object()` (or nested `merge()`) parsers.
 * @internal
 */
+/**
+* Removes entries for duplicate field names from a pre-completed results
+* map.  When a child construct's field-parser pairs contain the same field
+* name more than once (e.g., inner merges with overlapping output keys),
+* the flat map collapses branch-specific results.  This function strips
+* only the ambiguous entries, preserving cached results for unique fields.
+*
+* Returns `undefined` if the filtered map is empty (no cacheable fields).
+*
+* @see https://github.com/dahlia/optique/issues/762
+* @internal
+*/
+function filterDuplicateKeys(preCompleted, pairs) {
+	const counts = /* @__PURE__ */ new Map();
+	for (const [field] of pairs) counts.set(field, (counts.get(field) ?? 0) + 1);
+	let hasDuplicates = false;
+	for (const count of counts.values()) if (count > 1) {
+		hasDuplicates = true;
+		break;
+	}
+	if (!hasDuplicates) return preCompleted;
+	const filtered = /* @__PURE__ */ new Map();
+	for (const [field, value] of preCompleted) if ((counts.get(field) ?? 0) <= 1) filtered.set(field, value);
+	return filtered.size > 0 ? filtered : void 0;
+}
 function collectChildFieldParsers(parsers) {
 	const pairs = [];
 	for (const parser of parsers) if (fieldParsersKey in parser) pairs.push(...parser[fieldParsersKey]);
@@ -901,7 +926,14 @@ function collectChildFieldParsers(parsers) {
 */
 function preCompleteAndRegisterDependencies(state, fieldParserPairs, registry, exec) {
 	const preCompleted = /* @__PURE__ */ new Map();
+	const parentResults = exec?.preCompletedByParser;
 	for (const [field, fieldParser] of fieldParserPairs) {
+		const cached = parentResults?.get(field);
+		if (cached !== void 0) {
+			preCompleted.set(field, cached);
+			registerCompletedDependency(cached, registry);
+			continue;
+		}
 		const fieldState = state[field];
 		if (Array.isArray(fieldState) && fieldState.length === 1 && require_dependency.isPendingDependencySourceState(fieldState[0])) {
 			const completed = fieldParser.complete(fieldState, exec);
@@ -932,7 +964,14 @@ function preCompleteAndRegisterDependencies(state, fieldParserPairs, registry, e
 */
 async function preCompleteAndRegisterDependenciesAsync(state, fieldParserPairs, registry, exec) {
 	const preCompleted = /* @__PURE__ */ new Map();
+	const parentResults = exec?.preCompletedByParser;
 	for (const [field, fieldParser] of fieldParserPairs) {
+		const cached = parentResults?.get(field);
+		if (cached !== void 0) {
+			preCompleted.set(field, cached);
+			registerCompletedDependency(cached, registry);
+			continue;
+		}
 		const fieldState = state[field];
 		if (Array.isArray(fieldState) && fieldState.length === 1 && require_dependency.isPendingDependencySourceState(fieldState[0])) {
 			const completed = await fieldParser.complete(fieldState, exec);
@@ -1304,7 +1343,12 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					...exec,
 					dependencyRuntime: runtime
 				};
-				const preCompleted = preCompleteAndRegisterDependencies(state, parserPairs, runtime.registry, childExec);
+				const typedParserPairs = parserPairs;
+				const preCompleted = preCompleteAndRegisterDependencies(state, typedParserPairs, runtime.registry, childExec);
+				const phase3Exec = {
+					...childExec,
+					preCompletedByParser: void 0
+				};
 				const getFieldState = createFieldStateGetter(state);
 				const annotatedState = {};
 				for (const field of parserKeys) {
@@ -1324,7 +1368,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					if (preCompletedResult !== void 0) valueResult = unwrapCompleteResult(preCompletedResult);
 					else {
 						const fieldState = resolvedFieldStates[fieldKey];
-						valueResult = unwrapCompleteResult(fieldParser.complete(fieldState, childExec));
+						valueResult = unwrapCompleteResult(fieldParser.complete(fieldState, phase3Exec));
 					}
 					if (valueResult.success) {
 						result[fieldKey] = valueResult.value;
@@ -1351,7 +1395,12 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					...exec,
 					dependencyRuntime: runtime
 				};
-				const preCompleted = await preCompleteAndRegisterDependenciesAsync(state, parserPairs, runtime.registry, childExec);
+				const asyncParserPairs = parserPairs;
+				const preCompleted = await preCompleteAndRegisterDependenciesAsync(state, asyncParserPairs, runtime.registry, childExec);
+				const phase3Exec = {
+					...childExec,
+					preCompletedByParser: void 0
+				};
 				const getFieldState = createFieldStateGetter(state);
 				const annotatedState = {};
 				for (const field of parserKeys) {
@@ -1371,7 +1420,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					if (preCompletedResult !== void 0) valueResult = unwrapCompleteResult(preCompletedResult);
 					else {
 						const fieldState = resolvedFieldStates[fieldKey];
-						valueResult = unwrapCompleteResult(await fieldParser.complete(fieldState, childExec));
+						valueResult = unwrapCompleteResult(await fieldParser.complete(fieldState, phase3Exec));
 					}
 					if (valueResult.success) {
 						result[fieldKey] = valueResult.value;
@@ -1644,6 +1693,10 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				const tuplePairs = syncParsers.map((p, i) => [String(i), p]);
 				const tupleState = Object.fromEntries(stateArray.map((s, i) => [String(i), s]));
 				const preCompleted = preCompleteAndRegisterDependencies(tupleState, tuplePairs, runtime.registry, childExec);
+				const phase3Exec = {
+					...childExec,
+					preCompletedByParser: void 0
+				};
 				const resolvedArray = require_dependency_runtime.resolveStateWithRuntime(stateArray, runtime);
 				const result = [];
 				const deferredKeys = /* @__PURE__ */ new Map();
@@ -1655,7 +1708,7 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					if (preCompletedResult !== void 0) valueResult = unwrapCompleteResult(preCompletedResult);
 					else {
 						const elementState = prepareStateForCompletion(resolvedArray[i], elementParser);
-						valueResult = unwrapCompleteResult(elementParser.complete(elementState, childExec));
+						valueResult = unwrapCompleteResult(elementParser.complete(elementState, phase3Exec));
 					}
 					if (valueResult.success) {
 						result[i] = valueResult.value;
@@ -1686,6 +1739,10 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				const tuplePairs = parsers.map((p, i) => [String(i), p]);
 				const tupleState = Object.fromEntries(stateArray.map((s, i) => [String(i), s]));
 				const preCompleted = await preCompleteAndRegisterDependenciesAsync(tupleState, tuplePairs, runtime.registry, childExec);
+				const phase3Exec = {
+					...childExec,
+					preCompletedByParser: void 0
+				};
 				const resolvedArray = await require_dependency_runtime.resolveStateWithRuntimeAsync(stateArray, runtime);
 				const result = [];
 				const deferredKeys = /* @__PURE__ */ new Map();
@@ -1697,7 +1754,7 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					if (preCompletedResult !== void 0) valueResult = unwrapCompleteResult(preCompletedResult);
 					else {
 						const elementState = prepareStateForCompletion(resolvedArray[i], elementParser);
-						valueResult = unwrapCompleteResult(await elementParser.complete(elementState, childExec));
+						valueResult = unwrapCompleteResult(await elementParser.complete(elementState, phase3Exec));
 					}
 					if (valueResult.success) {
 						result[i] = valueResult.value;
@@ -1963,8 +2020,14 @@ function merge(...args) {
 					...exec,
 					dependencyRuntime: runtime
 				};
-				const childFieldPairs = collectChildFieldParsers(syncParsers);
-				preCompleteAndRegisterDependencies(state, childFieldPairs, runtime.registry, childExec);
+				const perChildCache = syncParsers.map((parser) => {
+					if (fieldParsersKey in parser) {
+						const pairs = parser[fieldParsersKey];
+						const preCompleted = preCompleteAndRegisterDependencies(state, pairs, runtime.registry, childExec);
+						return filterDuplicateKeys(preCompleted, pairs);
+					}
+					return void 0;
+				});
 				const resolvedState = require_dependency_runtime.resolveStateWithRuntime(state, runtime);
 				const object$1 = {};
 				const deferredKeys = /* @__PURE__ */ new Map();
@@ -1972,7 +2035,11 @@ function merge(...args) {
 				for (let i = 0; i < syncParsers.length; i++) {
 					const parser = syncParsers[i];
 					const parserState = extractCompleteState(parser, resolvedState, i);
-					const result = unwrapCompleteResult(parser.complete(parserState, childExec));
+					const cache = perChildCache[i];
+					const result = unwrapCompleteResult(parser.complete(parserState, {
+						...childExec,
+						preCompletedByParser: cache
+					}));
 					if (!result.success) return result;
 					const resultValue = result.value;
 					for (const field in resultValue) {
@@ -1998,8 +2065,12 @@ function merge(...args) {
 					...exec,
 					dependencyRuntime: runtime
 				};
-				const childFieldPairs = collectChildFieldParsers(parsers);
-				await preCompleteAndRegisterDependenciesAsync(state, childFieldPairs, runtime.registry, childExec);
+				const perChildCache = [];
+				for (const parser of parsers) if (fieldParsersKey in parser) {
+					const pairs = parser[fieldParsersKey];
+					const preCompleted = await preCompleteAndRegisterDependenciesAsync(state, pairs, runtime.registry, childExec);
+					perChildCache.push(filterDuplicateKeys(preCompleted, pairs));
+				} else perChildCache.push(void 0);
 				const resolvedState = await require_dependency_runtime.resolveStateWithRuntimeAsync(state, runtime);
 				const object$1 = {};
 				const deferredKeys = /* @__PURE__ */ new Map();
@@ -2007,7 +2078,11 @@ function merge(...args) {
 				for (let i = 0; i < parsers.length; i++) {
 					const parser = parsers[i];
 					const parserState = extractCompleteState(parser, resolvedState, i);
-					const result = unwrapCompleteResult(await parser.complete(parserState, childExec));
+					const asyncCache = perChildCache[i];
+					const result = unwrapCompleteResult(await parser.complete(parserState, {
+						...childExec,
+						preCompletedByParser: asyncCache
+					}));
 					if (!result.success) return result;
 					const resultValue = result.value;
 					for (const field in resultValue) {
@@ -2400,7 +2475,8 @@ function concat(...parsers) {
 		const runtime = exec?.dependencyRuntime ?? require_dependency_runtime.createDependencyRuntimeContext(exec?.dependencyRegistry);
 		const childExec = {
 			...exec,
-			dependencyRuntime: runtime
+			dependencyRuntime: runtime,
+			preCompletedByParser: void 0
 		};
 		const resolvedArray = require_dependency_runtime.resolveStateWithRuntime(stateArray, runtime);
 		const results = [];
@@ -2442,7 +2518,8 @@ function concat(...parsers) {
 		const runtime = exec?.dependencyRuntime ?? require_dependency_runtime.createDependencyRuntimeContext(exec?.dependencyRegistry);
 		const childExec = {
 			...exec,
-			dependencyRuntime: runtime
+			dependencyRuntime: runtime,
+			preCompletedByParser: void 0
 		};
 		const resolvedArray = await require_dependency_runtime.resolveStateWithRuntimeAsync(stateArray, runtime);
 		const results = [];

package/dist/constructs.js

@@ -879,6 +879,31 @@ async function completeDependencySourceDefaultsAsync(context, parserPairs, regis
 * mappings from its child `object()` (or nested `merge()`) parsers.
 * @internal
 */
+/**
+* Removes entries for duplicate field names from a pre-completed results
+* map.  When a child construct's field-parser pairs contain the same field
+* name more than once (e.g., inner merges with overlapping output keys),
+* the flat map collapses branch-specific results.  This function strips
+* only the ambiguous entries, preserving cached results for unique fields.
+*
+* Returns `undefined` if the filtered map is empty (no cacheable fields).
+*
+* @see https://github.com/dahlia/optique/issues/762
+* @internal
+*/
+function filterDuplicateKeys(preCompleted, pairs) {
+	const counts = /* @__PURE__ */ new Map();
+	for (const [field] of pairs) counts.set(field, (counts.get(field) ?? 0) + 1);
+	let hasDuplicates = false;
+	for (const count of counts.values()) if (count > 1) {
+		hasDuplicates = true;
+		break;
+	}
+	if (!hasDuplicates) return preCompleted;
+	const filtered = /* @__PURE__ */ new Map();
+	for (const [field, value] of preCompleted) if ((counts.get(field) ?? 0) <= 1) filtered.set(field, value);
+	return filtered.size > 0 ? filtered : void 0;
+}
 function collectChildFieldParsers(parsers) {
 	const pairs = [];
 	for (const parser of parsers) if (fieldParsersKey in parser) pairs.push(...parser[fieldParsersKey]);
@@ -901,7 +926,14 @@ function collectChildFieldParsers(parsers) {
 */
 function preCompleteAndRegisterDependencies(state, fieldParserPairs, registry, exec) {
 	const preCompleted = /* @__PURE__ */ new Map();
+	const parentResults = exec?.preCompletedByParser;
 	for (const [field, fieldParser] of fieldParserPairs) {
+		const cached = parentResults?.get(field);
+		if (cached !== void 0) {
+			preCompleted.set(field, cached);
+			registerCompletedDependency(cached, registry);
+			continue;
+		}
 		const fieldState = state[field];
 		if (Array.isArray(fieldState) && fieldState.length === 1 && isPendingDependencySourceState(fieldState[0])) {
 			const completed = fieldParser.complete(fieldState, exec);
@@ -932,7 +964,14 @@ function preCompleteAndRegisterDependencies(state, fieldParserPairs, registry, e
 */
 async function preCompleteAndRegisterDependenciesAsync(state, fieldParserPairs, registry, exec) {
 	const preCompleted = /* @__PURE__ */ new Map();
+	const parentResults = exec?.preCompletedByParser;
 	for (const [field, fieldParser] of fieldParserPairs) {
+		const cached = parentResults?.get(field);
+		if (cached !== void 0) {
+			preCompleted.set(field, cached);
+			registerCompletedDependency(cached, registry);
+			continue;
+		}
 		const fieldState = state[field];
 		if (Array.isArray(fieldState) && fieldState.length === 1 && isPendingDependencySourceState(fieldState[0])) {
 			const completed = await fieldParser.complete(fieldState, exec);
@@ -1304,7 +1343,12 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					...exec,
 					dependencyRuntime: runtime
 				};
-				const preCompleted = preCompleteAndRegisterDependencies(state, parserPairs, runtime.registry, childExec);
+				const typedParserPairs = parserPairs;
+				const preCompleted = preCompleteAndRegisterDependencies(state, typedParserPairs, runtime.registry, childExec);
+				const phase3Exec = {
+					...childExec,
+					preCompletedByParser: void 0
+				};
 				const getFieldState = createFieldStateGetter(state);
 				const annotatedState = {};
 				for (const field of parserKeys) {
@@ -1324,7 +1368,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					if (preCompletedResult !== void 0) valueResult = unwrapCompleteResult(preCompletedResult);
 					else {
 						const fieldState = resolvedFieldStates[fieldKey];
-						valueResult = unwrapCompleteResult(fieldParser.complete(fieldState, childExec));
+						valueResult = unwrapCompleteResult(fieldParser.complete(fieldState, phase3Exec));
 					}
 					if (valueResult.success) {
 						result[fieldKey] = valueResult.value;
@@ -1351,7 +1395,12 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					...exec,
 					dependencyRuntime: runtime
 				};
-				const preCompleted = await preCompleteAndRegisterDependenciesAsync(state, parserPairs, runtime.registry, childExec);
+				const asyncParserPairs = parserPairs;
+				const preCompleted = await preCompleteAndRegisterDependenciesAsync(state, asyncParserPairs, runtime.registry, childExec);
+				const phase3Exec = {
+					...childExec,
+					preCompletedByParser: void 0
+				};
 				const getFieldState = createFieldStateGetter(state);
 				const annotatedState = {};
 				for (const field of parserKeys) {
@@ -1371,7 +1420,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					if (preCompletedResult !== void 0) valueResult = unwrapCompleteResult(preCompletedResult);
 					else {
 						const fieldState = resolvedFieldStates[fieldKey];
-						valueResult = unwrapCompleteResult(await fieldParser.complete(fieldState, childExec));
+						valueResult = unwrapCompleteResult(await fieldParser.complete(fieldState, phase3Exec));
 					}
 					if (valueResult.success) {
 						result[fieldKey] = valueResult.value;
@@ -1644,6 +1693,10 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				const tuplePairs = syncParsers.map((p, i) => [String(i), p]);
 				const tupleState = Object.fromEntries(stateArray.map((s, i) => [String(i), s]));
 				const preCompleted = preCompleteAndRegisterDependencies(tupleState, tuplePairs, runtime.registry, childExec);
+				const phase3Exec = {
+					...childExec,
+					preCompletedByParser: void 0
+				};
 				const resolvedArray = resolveStateWithRuntime(stateArray, runtime);
 				const result = [];
 				const deferredKeys = /* @__PURE__ */ new Map();
@@ -1655,7 +1708,7 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					if (preCompletedResult !== void 0) valueResult = unwrapCompleteResult(preCompletedResult);
 					else {
 						const elementState = prepareStateForCompletion(resolvedArray[i], elementParser);
-						valueResult = unwrapCompleteResult(elementParser.complete(elementState, childExec));
+						valueResult = unwrapCompleteResult(elementParser.complete(elementState, phase3Exec));
 					}
 					if (valueResult.success) {
 						result[i] = valueResult.value;
@@ -1686,6 +1739,10 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				const tuplePairs = parsers.map((p, i) => [String(i), p]);
 				const tupleState = Object.fromEntries(stateArray.map((s, i) => [String(i), s]));
 				const preCompleted = await preCompleteAndRegisterDependenciesAsync(tupleState, tuplePairs, runtime.registry, childExec);
+				const phase3Exec = {
+					...childExec,
+					preCompletedByParser: void 0
+				};
 				const resolvedArray = await resolveStateWithRuntimeAsync(stateArray, runtime);
 				const result = [];
 				const deferredKeys = /* @__PURE__ */ new Map();
@@ -1697,7 +1754,7 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					if (preCompletedResult !== void 0) valueResult = unwrapCompleteResult(preCompletedResult);
 					else {
 						const elementState = prepareStateForCompletion(resolvedArray[i], elementParser);
-						valueResult = unwrapCompleteResult(await elementParser.complete(elementState, childExec));
+						valueResult = unwrapCompleteResult(await elementParser.complete(elementState, phase3Exec));
 					}
 					if (valueResult.success) {
 						result[i] = valueResult.value;
@@ -1963,8 +2020,14 @@ function merge(...args) {
 					...exec,
 					dependencyRuntime: runtime
 				};
-				const childFieldPairs = collectChildFieldParsers(syncParsers);
-				preCompleteAndRegisterDependencies(state, childFieldPairs, runtime.registry, childExec);
+				const perChildCache = syncParsers.map((parser) => {
+					if (fieldParsersKey in parser) {
+						const pairs = parser[fieldParsersKey];
+						const preCompleted = preCompleteAndRegisterDependencies(state, pairs, runtime.registry, childExec);
+						return filterDuplicateKeys(preCompleted, pairs);
+					}
+					return void 0;
+				});
 				const resolvedState = resolveStateWithRuntime(state, runtime);
 				const object$1 = {};
 				const deferredKeys = /* @__PURE__ */ new Map();
@@ -1972,7 +2035,11 @@ function merge(...args) {
 				for (let i = 0; i < syncParsers.length; i++) {
 					const parser = syncParsers[i];
 					const parserState = extractCompleteState(parser, resolvedState, i);
-					const result = unwrapCompleteResult(parser.complete(parserState, childExec));
+					const cache = perChildCache[i];
+					const result = unwrapCompleteResult(parser.complete(parserState, {
+						...childExec,
+						preCompletedByParser: cache
+					}));
 					if (!result.success) return result;
 					const resultValue = result.value;
 					for (const field in resultValue) {
@@ -1998,8 +2065,12 @@ function merge(...args) {
 					...exec,
 					dependencyRuntime: runtime
 				};
-				const childFieldPairs = collectChildFieldParsers(parsers);
-				await preCompleteAndRegisterDependenciesAsync(state, childFieldPairs, runtime.registry, childExec);
+				const perChildCache = [];
+				for (const parser of parsers) if (fieldParsersKey in parser) {
+					const pairs = parser[fieldParsersKey];
+					const preCompleted = await preCompleteAndRegisterDependenciesAsync(state, pairs, runtime.registry, childExec);
+					perChildCache.push(filterDuplicateKeys(preCompleted, pairs));
+				} else perChildCache.push(void 0);
 				const resolvedState = await resolveStateWithRuntimeAsync(state, runtime);
 				const object$1 = {};
 				const deferredKeys = /* @__PURE__ */ new Map();
@@ -2007,7 +2078,11 @@ function merge(...args) {
 				for (let i = 0; i < parsers.length; i++) {
 					const parser = parsers[i];
 					const parserState = extractCompleteState(parser, resolvedState, i);
-					const result = unwrapCompleteResult(await parser.complete(parserState, childExec));
+					const asyncCache = perChildCache[i];
+					const result = unwrapCompleteResult(await parser.complete(parserState, {
+						...childExec,
+						preCompletedByParser: asyncCache
+					}));
 					if (!result.success) return result;
 					const resultValue = result.value;
 					for (const field in resultValue) {
@@ -2400,7 +2475,8 @@ function concat(...parsers) {
 		const runtime = exec?.dependencyRuntime ?? createDependencyRuntimeContext(exec?.dependencyRegistry);
 		const childExec = {
 			...exec,
-			dependencyRuntime: runtime
+			dependencyRuntime: runtime,
+			preCompletedByParser: void 0
 		};
 		const resolvedArray = resolveStateWithRuntime(stateArray, runtime);
 		const results = [];
@@ -2442,7 +2518,8 @@ function concat(...parsers) {
 		const runtime = exec?.dependencyRuntime ?? createDependencyRuntimeContext(exec?.dependencyRegistry);
 		const childExec = {
 			...exec,
-			dependencyRuntime: runtime
+			dependencyRuntime: runtime,
+			preCompletedByParser: void 0
 		};
 		const resolvedArray = await resolveStateWithRuntimeAsync(stateArray, runtime);
 		const results = [];

package/dist/dependency-runtime.cjs

@@ -168,6 +168,7 @@ function resolveSingleDeferred(deferred, runtime) {
 		defaultValues: deferred.defaultValues
 	});
 	if (resolution.kind !== "resolved") return deferred.preliminaryResult;
+	if (resolution.usedDefaults.every((d) => d)) return deferred.preliminaryResult;
 	const depValue = isMultiDep ? resolution.values : resolution.values[0];
 	const result = deferred.parser[require_dependency.parseWithDependency](deferred.rawInput, depValue);
 	if (result instanceof Promise) return deferred.preliminaryResult;
@@ -266,6 +267,7 @@ async function resolveDeferredInStateAsync(state, runtime, visited = /* @__PURE_
 			defaultValues: deferred.defaultValues
 		});
 		if (resolution.kind !== "resolved") return deferred.preliminaryResult;
+		if (resolution.usedDefaults.every((d) => d)) return deferred.preliminaryResult;
 		const depValue = isMultiDep ? resolution.values : resolution.values[0];
 		return Promise.resolve(deferred.parser[require_dependency.parseWithDependency](deferred.rawInput, depValue));
 	}

package/dist/dependency-runtime.js

@@ -168,6 +168,7 @@ function resolveSingleDeferred(deferred, runtime) {
 		defaultValues: deferred.defaultValues
 	});
 	if (resolution.kind !== "resolved") return deferred.preliminaryResult;
+	if (resolution.usedDefaults.every((d) => d)) return deferred.preliminaryResult;
 	const depValue = isMultiDep ? resolution.values : resolution.values[0];
 	const result = deferred.parser[parseWithDependency](deferred.rawInput, depValue);
 	if (result instanceof Promise) return deferred.preliminaryResult;
@@ -266,6 +267,7 @@ async function resolveDeferredInStateAsync(state, runtime, visited = /* @__PURE_
 			defaultValues: deferred.defaultValues
 		});
 		if (resolution.kind !== "resolved") return deferred.preliminaryResult;
+		if (resolution.usedDefaults.every((d) => d)) return deferred.preliminaryResult;
 		const depValue = isMultiDep ? resolution.values : resolution.values[0];
 		return Promise.resolve(deferred.parser[parseWithDependency](deferred.rawInput, depValue));
 	}

package/dist/parser.cjs

@@ -1,5 +1,7 @@
 const require_annotations = require('./annotations.cjs');
 const require_message = require('./message.cjs');
+const require_dependency = require('./dependency.cjs');
+const require_dependency_runtime = require('./dependency-runtime.cjs');
 const require_mode_dispatch = require('./mode-dispatch.cjs');
 const require_usage = require('./usage.cjs');
 const require_doc = require('./doc.cjs');
@@ -83,11 +85,15 @@ function parseSync(parser, args, options) {
 			error: require_message.message`Unexpected option or argument: ${context.buffer[0]}.`
 		};
 	} while (context.buffer.length > 0);
+	const runtime = require_dependency_runtime.createDependencyRuntimeContext();
+	const resolvedState = require_dependency.isDeferredParseState(context.state) ? require_dependency_runtime.resolveStateWithRuntime(context.state, runtime) : context.state;
 	const completeExec = {
 		...exec,
-		phase: "complete"
+		phase: "complete",
+		dependencyRuntime: runtime,
+		dependencyRegistry: runtime.registry
 	};
-	const endResult = parser.complete(context.state, completeExec);
+	const endResult = parser.complete(resolvedState, completeExec);
 	return endResult.success ? {
 		success: true,
 		value: shouldUnwrapAnnotatedValue ? require_annotations.unwrapInjectedAnnotationWrapper(endResult.value) : endResult.value,
@@ -150,11 +156,15 @@ async function parseAsync(parser, args, options) {
 			error: require_message.message`Unexpected option or argument: ${context.buffer[0]}.`
 		};
 	} while (context.buffer.length > 0);
+	const runtime = require_dependency_runtime.createDependencyRuntimeContext();
+	const resolvedState = require_dependency.isDeferredParseState(context.state) ? await require_dependency_runtime.resolveStateWithRuntimeAsync(context.state, runtime) : context.state;
 	const completeExec = {
 		...exec,
-		phase: "complete"
+		phase: "complete",
+		dependencyRuntime: runtime,
+		dependencyRegistry: runtime.registry
 	};
-	const endResult = await parser.complete(context.state, completeExec);
+	const endResult = await parser.complete(resolvedState, completeExec);
 	return endResult.success ? {
 		success: true,
 		value: shouldUnwrapAnnotatedValue ? require_annotations.unwrapInjectedAnnotationWrapper(endResult.value) : endResult.value,
@@ -241,12 +251,31 @@ function suggestSync(parser, args, options) {
 	});
 	while (context.buffer.length > 0) {
 		const result = parser.parse(context);
-		if (!result.success) return Array.from(parser.suggest(context, prefix));
+		if (!result.success) return Array.from(parser.suggest(withSuggestRuntime(context), prefix));
 		const previousBuffer = context.buffer;
 		context = result.next;
 		if (isBufferUnchanged(previousBuffer, context.buffer)) return [];
 	}
-	return Array.from(parser.suggest(context, prefix));
+	return Array.from(parser.suggest(withSuggestRuntime(context), prefix));
+}
+/**
+* Creates a dependency runtime from the current parser state and returns
+* a context with the populated registry.  Used by top-level suggest
+* functions to mirror the construct-owned model where suggest() receives
+* a context with a dependency registry.
+* @internal
+*/
+function withSuggestRuntime(context) {
+	const runtime = require_dependency_runtime.createDependencyRuntimeContext();
+	require_dependency_runtime.collectSourcesFromState(context.state, runtime);
+	return {
+		...context,
+		dependencyRegistry: runtime.registry,
+		exec: context.exec ? {
+			...context.exec,
+			dependencyRegistry: runtime.registry
+		} : void 0
+	};
 }
 /**
 * Generates command-line suggestions based on current parsing state.
@@ -284,16 +313,18 @@ async function suggestAsync(parser, args, options) {
 	while (context.buffer.length > 0) {
 		const result = await parser.parse(context);
 		if (!result.success) {
+			const ctx$1 = withSuggestRuntime(context);
 			const suggestions$1 = [];
-			for await (const suggestion of parser.suggest(context, prefix)) suggestions$1.push(suggestion);
+			for await (const suggestion of parser.suggest(ctx$1, prefix)) suggestions$1.push(suggestion);
 			return suggestions$1;
 		}
 		const previousBuffer = context.buffer;
 		context = result.next;
 		if (isBufferUnchanged(previousBuffer, context.buffer)) return [];
 	}
+	const ctx = withSuggestRuntime(context);
 	const suggestions = [];
-	for await (const suggestion of parser.suggest(context, prefix)) suggestions.push(suggestion);
+	for await (const suggestion of parser.suggest(ctx, prefix)) suggestions.push(suggestion);
 	return suggestions;
 }
 /**

package/dist/parser.d.cts

@@ -325,6 +325,25 @@ interface ExecutionContext {
    * @since 1.0.0
    */
   readonly dependencyRuntime?: DependencyRuntimeContext;
+  /**
+   * Immutable map of pre-completed results from the parent construct's
+   * Phase 1, keyed by field name.  Each construct passes its own
+   * `preCompleteAndRegisterDependencies` results directly to children
+   * in Phase 3.  Children read it in their own Phase 1 to avoid
+   * re-evaluating non-idempotent default thunks, but never write to
+   * it — this prevents sibling completions from leaking into each
+   * other.
+   *
+   * Field-name keying naturally handles parser reuse across different
+   * fields (e.g., `merge(object({a: shared}), object({b: shared}))`)
+   * because each field maps to its own result regardless of whether
+   * the underlying parser instance is the same.
+   *
+   * @see https://github.com/dahlia/optique/issues/762
+   * @internal
+   * @since 1.0.0
+   */
+  readonly preCompletedByParser?: ReadonlyMap<string | symbol, unknown>;
 }
 /**
  * The context of the parser, which includes the input buffer and the state.

package/dist/parser.d.ts

@@ -325,6 +325,25 @@ interface ExecutionContext {
    * @since 1.0.0
    */
   readonly dependencyRuntime?: DependencyRuntimeContext;
+  /**
+   * Immutable map of pre-completed results from the parent construct's
+   * Phase 1, keyed by field name.  Each construct passes its own
+   * `preCompleteAndRegisterDependencies` results directly to children
+   * in Phase 3.  Children read it in their own Phase 1 to avoid
+   * re-evaluating non-idempotent default thunks, but never write to
+   * it — this prevents sibling completions from leaking into each
+   * other.
+   *
+   * Field-name keying naturally handles parser reuse across different
+   * fields (e.g., `merge(object({a: shared}), object({b: shared}))`)
+   * because each field maps to its own result regardless of whether
+   * the underlying parser instance is the same.
+   *
+   * @see https://github.com/dahlia/optique/issues/762
+   * @internal
+   * @since 1.0.0
+   */
+  readonly preCompletedByParser?: ReadonlyMap<string | symbol, unknown>;
 }
 /**
  * The context of the parser, which includes the input buffer and the state.

package/dist/parser.js

@@ -1,5 +1,7 @@
 import { injectAnnotations, isInjectedAnnotationWrapper, unwrapInjectedAnnotationWrapper } from "./annotations.js";
 import { cloneMessage, message } from "./message.js";
+import { isDeferredParseState } from "./dependency.js";
+import { collectSourcesFromState, createDependencyRuntimeContext, resolveStateWithRuntime, resolveStateWithRuntimeAsync } from "./dependency-runtime.js";
 import { dispatchByMode } from "./mode-dispatch.js";
 import { cloneUsage, normalizeUsage } from "./usage.js";
 import { cloneDocEntry, isDocEntryHidden } from "./doc.js";
@@ -83,11 +85,15 @@ function parseSync(parser, args, options) {
 			error: message`Unexpected option or argument: ${context.buffer[0]}.`
 		};
 	} while (context.buffer.length > 0);
+	const runtime = createDependencyRuntimeContext();
+	const resolvedState = isDeferredParseState(context.state) ? resolveStateWithRuntime(context.state, runtime) : context.state;
 	const completeExec = {
 		...exec,
-		phase: "complete"
+		phase: "complete",
+		dependencyRuntime: runtime,
+		dependencyRegistry: runtime.registry
 	};
-	const endResult = parser.complete(context.state, completeExec);
+	const endResult = parser.complete(resolvedState, completeExec);
 	return endResult.success ? {
 		success: true,
 		value: shouldUnwrapAnnotatedValue ? unwrapInjectedAnnotationWrapper(endResult.value) : endResult.value,
@@ -150,11 +156,15 @@ async function parseAsync(parser, args, options) {
 			error: message`Unexpected option or argument: ${context.buffer[0]}.`
 		};
 	} while (context.buffer.length > 0);
+	const runtime = createDependencyRuntimeContext();
+	const resolvedState = isDeferredParseState(context.state) ? await resolveStateWithRuntimeAsync(context.state, runtime) : context.state;
 	const completeExec = {
 		...exec,
-		phase: "complete"
+		phase: "complete",
+		dependencyRuntime: runtime,
+		dependencyRegistry: runtime.registry
 	};
-	const endResult = await parser.complete(context.state, completeExec);
+	const endResult = await parser.complete(resolvedState, completeExec);
 	return endResult.success ? {
 		success: true,
 		value: shouldUnwrapAnnotatedValue ? unwrapInjectedAnnotationWrapper(endResult.value) : endResult.value,
@@ -241,12 +251,31 @@ function suggestSync(parser, args, options) {
 	});
 	while (context.buffer.length > 0) {
 		const result = parser.parse(context);
-		if (!result.success) return Array.from(parser.suggest(context, prefix));
+		if (!result.success) return Array.from(parser.suggest(withSuggestRuntime(context), prefix));
 		const previousBuffer = context.buffer;
 		context = result.next;
 		if (isBufferUnchanged(previousBuffer, context.buffer)) return [];
 	}
-	return Array.from(parser.suggest(context, prefix));
+	return Array.from(parser.suggest(withSuggestRuntime(context), prefix));
+}
+/**
+* Creates a dependency runtime from the current parser state and returns
+* a context with the populated registry.  Used by top-level suggest
+* functions to mirror the construct-owned model where suggest() receives
+* a context with a dependency registry.
+* @internal
+*/
+function withSuggestRuntime(context) {
+	const runtime = createDependencyRuntimeContext();
+	collectSourcesFromState(context.state, runtime);
+	return {
+		...context,
+		dependencyRegistry: runtime.registry,
+		exec: context.exec ? {
+			...context.exec,
+			dependencyRegistry: runtime.registry
+		} : void 0
+	};
 }
 /**
 * Generates command-line suggestions based on current parsing state.
@@ -284,16 +313,18 @@ async function suggestAsync(parser, args, options) {
 	while (context.buffer.length > 0) {
 		const result = await parser.parse(context);
 		if (!result.success) {
+			const ctx$1 = withSuggestRuntime(context);
 			const suggestions$1 = [];
-			for await (const suggestion of parser.suggest(context, prefix)) suggestions$1.push(suggestion);
+			for await (const suggestion of parser.suggest(ctx$1, prefix)) suggestions$1.push(suggestion);
 			return suggestions$1;
 		}
 		const previousBuffer = context.buffer;
 		context = result.next;
 		if (isBufferUnchanged(previousBuffer, context.buffer)) return [];
 	}
+	const ctx = withSuggestRuntime(context);
 	const suggestions = [];
-	for await (const suggestion of parser.suggest(context, prefix)) suggestions.push(suggestion);
+	for await (const suggestion of parser.suggest(ctx, prefix)) suggestions.push(suggestion);
 	return suggestions;
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.0.0-dev.1608+66e67b9f",
+  "version": "1.0.0-dev.1616+17abc525",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",