@optique/core 1.0.0-dev.1495 → 1.0.0-dev.1500

package/dist/constructs.cjs

@@ -1225,6 +1225,8 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				}
 				const resolvedState = resolveDeferredParseStates(preCompletedState);
 				const result = {};
+				const deferredKeys = /* @__PURE__ */ new Map();
+				let hasDeferred = false;
 				const getCompletionFieldState = createFieldStateGetter(state);
 				for (const field of parserKeys) {
 					const fieldKey = field;
@@ -1232,8 +1234,12 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					const fieldParser = parsers[field];
 					if (require_dependency.isDependencySourceState(fieldResolvedState) && preCompletedKeys.has(fieldKey)) {
 						const depResult = fieldResolvedState.result;
-						if (depResult.success) result[fieldKey] = depResult.value;
-						else return {
+						if (depResult.success) {
+							result[fieldKey] = depResult.value;
+							if (depResult.deferred) if (depResult.deferredKeys) deferredKeys.set(fieldKey, depResult.deferredKeys);
+							else if (depResult.value == null || typeof depResult.value !== "object") deferredKeys.set(fieldKey, null);
+							else hasDeferred = true;
+						} else return {
 							success: false,
 							error: depResult.error
 						};
@@ -1241,15 +1247,24 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					}
 					const completionState = fieldResolvedState === void 0 ? getCompletionFieldState(field, fieldParser) : fieldResolvedState;
 					const valueResult = fieldParser.complete(completionState);
-					if (valueResult.success) result[fieldKey] = valueResult.value;
-					else return {
+					if (valueResult.success) {
+						result[fieldKey] = valueResult.value;
+						if (valueResult.deferred) if (valueResult.deferredKeys) deferredKeys.set(fieldKey, valueResult.deferredKeys);
+						else if (valueResult.value == null || typeof valueResult.value !== "object") deferredKeys.set(fieldKey, null);
+						else hasDeferred = true;
+					} else return {
 						success: false,
 						error: valueResult.error
 					};
 				}
+				const isDeferred = deferredKeys.size > 0 || hasDeferred;
 				return {
 					success: true,
-					value: result
+					value: result,
+					...isDeferred ? {
+						deferred: true,
+						...deferredKeys.size > 0 ? { deferredKeys } : {}
+					} : {}
 				};
 			}, async () => {
 				const preCompletedState = {};
@@ -1286,6 +1301,8 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				}
 				const resolvedState = await resolveDeferredParseStatesAsync(preCompletedState);
 				const result = {};
+				const deferredKeys = /* @__PURE__ */ new Map();
+				let hasDeferred = false;
 				const getCompletionFieldState = createFieldStateGetter(state);
 				for (const field of parserKeys) {
 					const fieldKey = field;
@@ -1293,8 +1310,12 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					const fieldParser = parsers[field];
 					if (require_dependency.isDependencySourceState(fieldResolvedState) && preCompletedKeys.has(fieldKey)) {
 						const depResult = fieldResolvedState.result;
-						if (depResult.success) result[fieldKey] = depResult.value;
-						else return {
+						if (depResult.success) {
+							result[fieldKey] = depResult.value;
+							if (depResult.deferred) if (depResult.deferredKeys) deferredKeys.set(fieldKey, depResult.deferredKeys);
+							else if (depResult.value == null || typeof depResult.value !== "object") deferredKeys.set(fieldKey, null);
+							else hasDeferred = true;
+						} else return {
 							success: false,
 							error: depResult.error
 						};
@@ -1302,15 +1323,24 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					}
 					const completionState = fieldResolvedState === void 0 ? getCompletionFieldState(field, fieldParser) : fieldResolvedState;
 					const valueResult = await fieldParser.complete(completionState);
-					if (valueResult.success) result[fieldKey] = valueResult.value;
-					else return {
+					if (valueResult.success) {
+						result[fieldKey] = valueResult.value;
+						if (valueResult.deferred) if (valueResult.deferredKeys) deferredKeys.set(fieldKey, valueResult.deferredKeys);
+						else if (valueResult.value == null || typeof valueResult.value !== "object") deferredKeys.set(fieldKey, null);
+						else hasDeferred = true;
+					} else return {
 						success: false,
 						error: valueResult.error
 					};
 				}
+				const isDeferred = deferredKeys.size > 0 || hasDeferred;
 				return {
 					success: true,
-					value: result
+					value: result,
+					...isDeferred ? {
+						deferred: true,
+						...deferredKeys.size > 0 ? { deferredKeys } : {}
+					} : {}
 				};
 			});
 		},
@@ -1550,6 +1580,8 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				const resolvedState = resolveDeferredParseStates(preCompletedState);
 				const resolvedArray = resolvedState;
 				const result = [];
+				const deferredKeys = /* @__PURE__ */ new Map();
+				let hasDeferred = false;
 				for (let i = 0; i < syncParsers.length; i++) {
 					const elementResolvedState = resolvedArray[i];
 					const elementParser = syncParsers[i];
@@ -1559,23 +1591,36 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					const wasPreCompletedCase3 = originalElementState === void 0 && require_dependency.isWrappedDependencySource(elementParser);
 					if (require_dependency.isDependencySourceState(elementResolvedState) && (wasPreCompletedCase1 || wasPreCompletedCase2 || wasPreCompletedCase3)) {
 						const depResult = elementResolvedState.result;
-						if (depResult.success) result[i] = depResult.value;
-						else return {
+						if (depResult.success) {
+							result[i] = depResult.value;
+							if (depResult.deferred) if (depResult.deferredKeys) deferredKeys.set(i, depResult.deferredKeys);
+							else if (depResult.value == null || typeof depResult.value !== "object") deferredKeys.set(i, null);
+							else hasDeferred = true;
+						} else return {
 							success: false,
 							error: depResult.error
 						};
 						continue;
 					}
 					const valueResult = elementParser.complete(elementResolvedState);
-					if (valueResult.success) result[i] = valueResult.value;
-					else return {
+					if (valueResult.success) {
+						result[i] = valueResult.value;
+						if (valueResult.deferred) if (valueResult.deferredKeys) deferredKeys.set(i, valueResult.deferredKeys);
+						else if (valueResult.value == null || typeof valueResult.value !== "object") deferredKeys.set(i, null);
+						else hasDeferred = true;
+					} else return {
 						success: false,
 						error: valueResult.error
 					};
 				}
+				const isDeferred = deferredKeys.size > 0 || hasDeferred;
 				return {
 					success: true,
-					value: result
+					value: result,
+					...isDeferred ? {
+						deferred: true,
+						...deferredKeys.size > 0 ? { deferredKeys } : {}
+					} : {}
 				};
 			}, async () => {
 				const stateArray = state;
@@ -1598,6 +1643,8 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				const resolvedState = await resolveDeferredParseStatesAsync(preCompletedState);
 				const resolvedArray = resolvedState;
 				const result = [];
+				const deferredKeys = /* @__PURE__ */ new Map();
+				let hasDeferred = false;
 				for (let i = 0; i < parsers.length; i++) {
 					const elementResolvedState = resolvedArray[i];
 					const elementParser = parsers[i];
@@ -1607,23 +1654,36 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					const wasPreCompletedCase3 = originalElementState === void 0 && require_dependency.isWrappedDependencySource(elementParser);
 					if (require_dependency.isDependencySourceState(elementResolvedState) && (wasPreCompletedCase1 || wasPreCompletedCase2 || wasPreCompletedCase3)) {
 						const depResult = elementResolvedState.result;
-						if (depResult.success) result[i] = depResult.value;
-						else return {
+						if (depResult.success) {
+							result[i] = depResult.value;
+							if (depResult.deferred) if (depResult.deferredKeys) deferredKeys.set(i, depResult.deferredKeys);
+							else if (depResult.value == null || typeof depResult.value !== "object") deferredKeys.set(i, null);
+							else hasDeferred = true;
+						} else return {
 							success: false,
 							error: depResult.error
 						};
 						continue;
 					}
 					const valueResult = await elementParser.complete(elementResolvedState);
-					if (valueResult.success) result[i] = valueResult.value;
-					else return {
+					if (valueResult.success) {
+						result[i] = valueResult.value;
+						if (valueResult.deferred) if (valueResult.deferredKeys) deferredKeys.set(i, valueResult.deferredKeys);
+						else if (valueResult.value == null || typeof valueResult.value !== "object") deferredKeys.set(i, null);
+						else hasDeferred = true;
+					} else return {
 						success: false,
 						error: valueResult.error
 					};
 				}
+				const isDeferred = deferredKeys.size > 0 || hasDeferred;
 				return {
 					success: true,
-					value: result
+					value: result,
+					...isDeferred ? {
+						deferred: true,
+						...deferredKeys.size > 0 ? { deferredKeys } : {}
+					} : {}
 				};
 			});
 		},
@@ -1842,16 +1902,28 @@ function merge(...args) {
 				preCompleteAndRegisterDependencies(state, childFieldPairs, registry);
 				const resolvedState = resolveDeferredParseStates(state, registry);
 				const object$1 = {};
+				const deferredKeys = /* @__PURE__ */ new Map();
+				let hasDeferred = false;
 				for (let i = 0; i < syncParsers.length; i++) {
 					const parser = syncParsers[i];
 					const parserState = extractCompleteState(parser, resolvedState, i);
 					const result = parser.complete(parserState);
 					if (!result.success) return result;
-					for (const field in result.value) object$1[field] = result.value[field];
+					for (const field in result.value) {
+						object$1[field] = result.value[field];
+						if (deferredKeys.has(field) && !(result.deferred && result.deferredKeys?.has(field))) deferredKeys.delete(field);
+					}
+					if (result.deferred && result.deferredKeys) for (const [key, value] of result.deferredKeys) deferredKeys.set(key, value);
+					else if (result.deferred) hasDeferred = true;
 				}
+				const isDeferred = deferredKeys.size > 0 || hasDeferred;
 				return {
 					success: true,
-					value: object$1
+					value: object$1,
+					...isDeferred ? {
+						deferred: true,
+						...deferredKeys.size > 0 ? { deferredKeys } : {}
+					} : {}
 				};
 			}
 			return (async () => {
@@ -1860,16 +1932,28 @@ function merge(...args) {
 				await preCompleteAndRegisterDependenciesAsync(state, childFieldPairs, registry);
 				const resolvedState = await resolveDeferredParseStatesAsync(state, registry);
 				const object$1 = {};
+				const deferredKeys = /* @__PURE__ */ new Map();
+				let hasDeferred = false;
 				for (let i = 0; i < parsers.length; i++) {
 					const parser = parsers[i];
 					const parserState = extractCompleteState(parser, resolvedState, i);
 					const result = await parser.complete(parserState);
 					if (!result.success) return result;
-					for (const field in result.value) object$1[field] = result.value[field];
+					for (const field in result.value) {
+						object$1[field] = result.value[field];
+						if (deferredKeys.has(field) && !(result.deferred && result.deferredKeys?.has(field))) deferredKeys.delete(field);
+					}
+					if (result.deferred && result.deferredKeys) for (const [key, value] of result.deferredKeys) deferredKeys.set(key, value);
+					else if (result.deferred) hasDeferred = true;
 				}
+				const isDeferred = deferredKeys.size > 0 || hasDeferred;
 				return {
 					success: true,
-					value: object$1
+					value: object$1,
+					...isDeferred ? {
+						deferred: true,
+						...deferredKeys.size > 0 ? { deferredKeys } : {}
+					} : {}
 				};
 			})();
 		},
@@ -2249,17 +2333,37 @@ function concat(...parsers) {
 		for (let i = 0; i < stateArray.length; i++) combinedState[i] = stateArray[i];
 		const resolvedCombinedState = resolveDeferredParseStates(combinedState);
 		const results = [];
+		const deferredKeys = /* @__PURE__ */ new Map();
+		let hasDeferred = false;
 		for (let i = 0; i < syncParsers.length; i++) {
 			const parser = syncParsers[i];
 			const parserState = resolvedCombinedState[i];
 			const result = parser.complete(parserState);
 			if (!result.success) return result;
-			if (Array.isArray(result.value)) results.push(...result.value);
-			else results.push(result.value);
+			const baseIndex = results.length;
+			if (Array.isArray(result.value)) {
+				results.push(...result.value);
+				if (result.deferred && result.deferredKeys) for (const [key, value] of result.deferredKeys) {
+					const numKey = typeof key === "string" ? Number(key) : key;
+					if (typeof numKey === "number" && Number.isInteger(numKey)) deferredKeys.set(baseIndex + numKey, value);
+					else deferredKeys.set(key, value);
+				}
+				else if (result.deferred) hasDeferred = true;
+			} else {
+				results.push(result.value);
+				if (result.deferred) if (result.deferredKeys) deferredKeys.set(baseIndex, result.deferredKeys);
+				else if (result.value == null || typeof result.value !== "object") deferredKeys.set(baseIndex, null);
+				else hasDeferred = true;
+			}
 		}
+		const isDeferred = deferredKeys.size > 0 || hasDeferred;
 		return {
 			success: true,
-			value: results
+			value: results,
+			...isDeferred ? {
+				deferred: true,
+				...deferredKeys.size > 0 ? { deferredKeys } : {}
+			} : {}
 		};
 	};
 	const completeAsync = async (state) => {
@@ -2268,17 +2372,37 @@ function concat(...parsers) {
 		for (let i = 0; i < stateArray.length; i++) combinedState[i] = stateArray[i];
 		const resolvedCombinedState = await resolveDeferredParseStatesAsync(combinedState);
 		const results = [];
+		const deferredKeys = /* @__PURE__ */ new Map();
+		let hasDeferred = false;
 		for (let i = 0; i < parsers.length; i++) {
 			const parser = parsers[i];
 			const parserState = resolvedCombinedState[i];
 			const result = await parser.complete(parserState);
 			if (!result.success) return result;
-			if (Array.isArray(result.value)) results.push(...result.value);
-			else results.push(result.value);
+			const baseIndex = results.length;
+			if (Array.isArray(result.value)) {
+				results.push(...result.value);
+				if (result.deferred && result.deferredKeys) for (const [key, value] of result.deferredKeys) {
+					const numKey = typeof key === "string" ? Number(key) : key;
+					if (typeof numKey === "number" && Number.isInteger(numKey)) deferredKeys.set(baseIndex + numKey, value);
+					else deferredKeys.set(key, value);
+				}
+				else if (result.deferred) hasDeferred = true;
+			} else {
+				results.push(result.value);
+				if (result.deferred) if (result.deferredKeys) deferredKeys.set(baseIndex, result.deferredKeys);
+				else if (result.value == null || typeof result.value !== "object") deferredKeys.set(baseIndex, null);
+				else hasDeferred = true;
+			}
 		}
+		const isDeferred = deferredKeys.size > 0 || hasDeferred;
 		return {
 			success: true,
-			value: results
+			value: results,
+			...isDeferred ? {
+				deferred: true,
+				...deferredKeys.size > 0 ? { deferredKeys } : {}
+			} : {}
 		};
 	};
 	return {
@@ -2357,7 +2481,7 @@ function concat(...parsers) {
 	};
 }
 function group(label, parser, options = {}) {
-	return {
+	const groupParser = {
 		$mode: parser.$mode,
 		$valueType: parser.$valueType,
 		$stateType: parser.$stateType,
@@ -2410,6 +2534,14 @@ function group(label, parser, options = {}) {
 			};
 		}
 	};
+	if ("placeholder" in parser) Object.defineProperty(groupParser, "placeholder", {
+		get() {
+			return parser.placeholder;
+		},
+		configurable: true,
+		enumerable: false
+	});
+	return groupParser;
 }
 /**
 * Creates a conditional parser that selects different branch parsers based on
@@ -2699,7 +2831,11 @@ function conditional(discriminator, branches, defaultBranch, options) {
 				if (!defaultResult.success) return defaultResult;
 				return {
 					success: true,
-					value: [void 0, defaultResult.value]
+					value: [void 0, defaultResult.value],
+					...defaultResult.deferred ? {
+						deferred: true,
+						...defaultResult.deferredKeys ? { deferredKeys: new Map([[1, defaultResult.deferredKeys]]) } : defaultResult.value == null || typeof defaultResult.value !== "object" ? { deferredKeys: new Map([[1, null]]) } : {}
+					} : {}
 				};
 			}
 			return {
@@ -2730,7 +2866,11 @@ function conditional(discriminator, branches, defaultBranch, options) {
 		else discriminatorValue = state.selectedBranch.key;
 		return {
 			success: true,
-			value: [discriminatorValue, branchResult.value]
+			value: [discriminatorValue, branchResult.value],
+			...branchResult.deferred ? {
+				deferred: true,
+				...branchResult.deferredKeys ? { deferredKeys: new Map([[1, branchResult.deferredKeys]]) } : branchResult.value == null || typeof branchResult.value !== "object" ? { deferredKeys: new Map([[1, null]]) } : {}
+			} : {}
 		};
 	};
 	const completeAsync = async (state) => {
@@ -2741,7 +2881,11 @@ function conditional(discriminator, branches, defaultBranch, options) {
 				if (!defaultResult.success) return defaultResult;
 				return {
 					success: true,
-					value: [void 0, defaultResult.value]
+					value: [void 0, defaultResult.value],
+					...defaultResult.deferred ? {
+						deferred: true,
+						...defaultResult.deferredKeys ? { deferredKeys: new Map([[1, defaultResult.deferredKeys]]) } : defaultResult.value == null || typeof defaultResult.value !== "object" ? { deferredKeys: new Map([[1, null]]) } : {}
+					} : {}
 				};
 			}
 			return {
@@ -2772,7 +2916,11 @@ function conditional(discriminator, branches, defaultBranch, options) {
 		else discriminatorValue = state.selectedBranch.key;
 		return {
 			success: true,
-			value: [discriminatorValue, branchResult.value]
+			value: [discriminatorValue, branchResult.value],
+			...branchResult.deferred ? {
+				deferred: true,
+				...branchResult.deferredKeys ? { deferredKeys: new Map([[1, branchResult.deferredKeys]]) } : branchResult.value == null || typeof branchResult.value !== "object" ? { deferredKeys: new Map([[1, null]]) } : {}
+			} : {}
 		};
 	};
 	function* suggestSync(context, prefix) {