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

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/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/package.json

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