@optique/core 1.0.0-dev.757 → 1.0.0-dev.767

package/dist/constructs.cjs

@@ -8,6 +8,7 @@ const require_usage_internals = require('./usage-internals.cjs');
 
 //#region src/constructs.ts
 const inheritParentAnnotationsKey = Symbol.for("@optique/core/inheritParentAnnotations");
+const deferPromptUntilConfigResolvesKey = Symbol.for("@optique/config/deferPromptUntilResolved");
 function createUnexpectedInputErrorWithScopedSuggestions(baseError, invalidInput, parsers, customFormatter) {
 	const options = /* @__PURE__ */ new Set();
 	const commands = /* @__PURE__ */ new Set();
@@ -2185,6 +2186,8 @@ function concat(...parsers) {
 	};
 }
 function group(label, parser, options = {}) {
+	const deferPromptHook = Reflect.get(parser, deferPromptUntilConfigResolvesKey);
+	const deferPromptMarker = typeof deferPromptHook === "function" ? { [deferPromptUntilConfigResolvesKey]: deferPromptHook } : {};
 	return {
 		$mode: parser.$mode,
 		$valueType: parser.$valueType,
@@ -2192,6 +2195,7 @@ function group(label, parser, options = {}) {
 		priority: parser.priority,
 		usage: applyHiddenToUsage(parser.usage, options.hidden),
 		initialState: parser.initialState,
+		...deferPromptMarker,
 		parse: (context) => parser.parse(context),
 		complete: (state) => parser.complete(state),
 		suggest: (context, prefix) => {

package/dist/constructs.js

@@ -8,6 +8,7 @@ import { collectLeadingCandidates } from "./usage-internals.js";
 
 //#region src/constructs.ts
 const inheritParentAnnotationsKey = Symbol.for("@optique/core/inheritParentAnnotations");
+const deferPromptUntilConfigResolvesKey = Symbol.for("@optique/config/deferPromptUntilResolved");
 function createUnexpectedInputErrorWithScopedSuggestions(baseError, invalidInput, parsers, customFormatter) {
 	const options = /* @__PURE__ */ new Set();
 	const commands = /* @__PURE__ */ new Set();
@@ -2185,6 +2186,8 @@ function concat(...parsers) {
 	};
 }
 function group(label, parser, options = {}) {
+	const deferPromptHook = Reflect.get(parser, deferPromptUntilConfigResolvesKey);
+	const deferPromptMarker = typeof deferPromptHook === "function" ? { [deferPromptUntilConfigResolvesKey]: deferPromptHook } : {};
 	return {
 		$mode: parser.$mode,
 		$valueType: parser.$valueType,
@@ -2192,6 +2195,7 @@ function group(label, parser, options = {}) {
 		priority: parser.priority,
 		usage: applyHiddenToUsage(parser.usage, options.hidden),
 		initialState: parser.initialState,
+		...deferPromptMarker,
 		parse: (context) => parser.parse(context),
 		complete: (state) => parser.complete(state),
 		suggest: (context, prefix) => {

package/dist/modifiers.cjs

@@ -4,6 +4,7 @@ const require_dependency = require('./dependency.cjs');
 const require_mode_dispatch = require('./mode-dispatch.cjs');
 
 //#region src/modifiers.ts
+const deferPromptUntilConfigResolvesKey = Symbol.for("@optique/config/deferPromptUntilResolved");
 /**
 * Internal helper for optional-style parsing logic shared by optional()
 * and withDefault(). Handles the common pattern of:
@@ -96,6 +97,8 @@ function optional(parser) {
 	const wrappedDependencyMarker = innerHasWrappedDependency ? { [require_dependency.wrappedDependencySourceMarker]: parser[require_dependency.wrappedDependencySourceMarker] } : innerHasDirectDependency ? { [require_dependency.wrappedDependencySourceMarker]: syncParser.initialState } : {};
 	const hasWrappedDependencySource = require_dependency.wrappedDependencySourceMarker in wrappedDependencyMarker;
 	const wrappedPendingState = hasWrappedDependencySource ? wrappedDependencyMarker[require_dependency.wrappedDependencySourceMarker] : void 0;
+	const deferPromptHook = Reflect.get(parser, deferPromptUntilConfigResolvesKey);
+	const deferPromptMarker = typeof deferPromptHook === "function" ? { [deferPromptUntilConfigResolvesKey]: deferPromptHook } : {};
 	return {
 		$mode: parser.$mode,
 		$valueType: [],
@@ -107,12 +110,23 @@ function optional(parser) {
 		}],
 		initialState: void 0,
 		...wrappedDependencyMarker,
+		...deferPromptMarker,
 		parse(context) {
 			return require_mode_dispatch.dispatchByMode(parser.$mode, () => parseOptionalStyleSync(context, syncParser), () => parseOptionalStyleAsync(context, parser));
 		},
 		complete(state) {
 			if (!Array.isArray(state)) {
 				if (innerHasWrappedDependency && wrappedPendingState) return require_mode_dispatch.dispatchByMode(parser.$mode, () => syncParser.complete([wrappedPendingState]), () => parser.complete([wrappedPendingState]));
+				if (typeof deferPromptHook === "function" && state != null && typeof state === "object") {
+					const innerComplete = () => {
+						const innerResult = require_mode_dispatch.dispatchByMode(parser.$mode, () => syncParser.complete(state), () => parser.complete(state));
+						return require_mode_dispatch.mapModeValue(parser.$mode, innerResult, (result) => result.success ? result : {
+							success: true,
+							value: void 0
+						});
+					};
+					return innerComplete();
+				}
 				return {
 					success: true,
 					value: void 0
@@ -125,7 +139,8 @@ function optional(parser) {
 					value: void 0
 				};
 			}
-			return require_mode_dispatch.dispatchByMode(parser.$mode, () => syncParser.complete(state[0]), () => parser.complete(state[0]));
+			const innerElement = require_annotations.getAnnotations(state) != null && state[0] != null && typeof state[0] === "object" ? require_annotations.inheritAnnotations(state, state[0]) : state[0];
+			return require_mode_dispatch.dispatchByMode(parser.$mode, () => syncParser.complete(innerElement), () => parser.complete(innerElement));
 		},
 		suggest(context, prefix) {
 			return require_mode_dispatch.dispatchIterableByMode(parser.$mode, () => suggestSync(context, prefix), () => suggestAsync(context, prefix));
@@ -202,6 +217,8 @@ function withDefault(parser, defaultValue, options) {
 	}
 	const innerInitialState = syncParser.initialState;
 	const wrappedDependencyMarker = require_dependency.isPendingDependencySourceState(innerInitialState) ? { [require_dependency.wrappedDependencySourceMarker]: innerInitialState } : require_dependency.isWrappedDependencySource(parser) ? { [require_dependency.wrappedDependencySourceMarker]: parser[require_dependency.wrappedDependencySourceMarker] } : {};
+	const deferPromptHookDefault = Reflect.get(parser, deferPromptUntilConfigResolvesKey);
+	const deferPromptMarkerDefault = typeof deferPromptHookDefault === "function" ? { [deferPromptUntilConfigResolvesKey]: deferPromptHookDefault } : {};
 	return {
 		$mode: parser.$mode,
 		$valueType: [],
@@ -213,6 +230,7 @@ function withDefault(parser, defaultValue, options) {
 		}],
 		initialState: void 0,
 		...wrappedDependencyMarker,
+		...deferPromptMarkerDefault,
 		parse(context) {
 			return require_mode_dispatch.dispatchByMode(parser.$mode, () => parseOptionalStyleSync(context, syncParser), () => parseOptionalStyleAsync(context, parser));
 		},
@@ -261,6 +279,10 @@ function withDefault(parser, defaultValue, options) {
 						error: error instanceof WithDefaultError ? error.errorMessage : require_message.message`${require_message.text(String(error))}`
 					};
 				}
+				if (typeof deferPromptHookDefault === "function" && state != null && typeof state === "object") {
+					const innerResult = require_mode_dispatch.dispatchByMode(parser.$mode, () => syncParser.complete(state), () => parser.complete(state));
+					return innerResult;
+				}
 				try {
 					const value = typeof defaultValue === "function" ? defaultValue() : defaultValue;
 					return {
@@ -318,7 +340,8 @@ function withDefault(parser, defaultValue, options) {
 					};
 				}
 			}
-			return require_mode_dispatch.dispatchByMode(parser.$mode, () => syncParser.complete(state[0]), () => parser.complete(state[0]));
+			const innerElement = require_annotations.getAnnotations(state) != null && state[0] != null && typeof state[0] === "object" ? require_annotations.inheritAnnotations(state, state[0]) : state[0];
+			return require_mode_dispatch.dispatchByMode(parser.$mode, () => syncParser.complete(innerElement), () => parser.complete(innerElement));
 		},
 		suggest(context, prefix) {
 			return require_mode_dispatch.dispatchIterableByMode(parser.$mode, () => suggestSync(context, prefix), () => suggestAsync(context, prefix));

package/dist/modifiers.js

@@ -1,9 +1,10 @@
-import { annotateFreshArray, inheritAnnotations, isInjectedAnnotationWrapper, unwrapInjectedAnnotationWrapper } from "./annotations.js";
+import { annotateFreshArray, getAnnotations, inheritAnnotations, isInjectedAnnotationWrapper, unwrapInjectedAnnotationWrapper } from "./annotations.js";
 import { formatMessage, message, text } from "./message.js";
 import { createDependencySourceState, dependencyId, isDependencySourceState, isPendingDependencySourceState, isWrappedDependencySource, transformsDependencyValue, transformsDependencyValueMarker, wrappedDependencySourceMarker } from "./dependency.js";
 import { dispatchByMode, dispatchIterableByMode, mapModeValue } from "./mode-dispatch.js";
 
 //#region src/modifiers.ts
+const deferPromptUntilConfigResolvesKey = Symbol.for("@optique/config/deferPromptUntilResolved");
 /**
 * Internal helper for optional-style parsing logic shared by optional()
 * and withDefault(). Handles the common pattern of:
@@ -96,6 +97,8 @@ function optional(parser) {
 	const wrappedDependencyMarker = innerHasWrappedDependency ? { [wrappedDependencySourceMarker]: parser[wrappedDependencySourceMarker] } : innerHasDirectDependency ? { [wrappedDependencySourceMarker]: syncParser.initialState } : {};
 	const hasWrappedDependencySource = wrappedDependencySourceMarker in wrappedDependencyMarker;
 	const wrappedPendingState = hasWrappedDependencySource ? wrappedDependencyMarker[wrappedDependencySourceMarker] : void 0;
+	const deferPromptHook = Reflect.get(parser, deferPromptUntilConfigResolvesKey);
+	const deferPromptMarker = typeof deferPromptHook === "function" ? { [deferPromptUntilConfigResolvesKey]: deferPromptHook } : {};
 	return {
 		$mode: parser.$mode,
 		$valueType: [],
@@ -107,12 +110,23 @@ function optional(parser) {
 		}],
 		initialState: void 0,
 		...wrappedDependencyMarker,
+		...deferPromptMarker,
 		parse(context) {
 			return dispatchByMode(parser.$mode, () => parseOptionalStyleSync(context, syncParser), () => parseOptionalStyleAsync(context, parser));
 		},
 		complete(state) {
 			if (!Array.isArray(state)) {
 				if (innerHasWrappedDependency && wrappedPendingState) return dispatchByMode(parser.$mode, () => syncParser.complete([wrappedPendingState]), () => parser.complete([wrappedPendingState]));
+				if (typeof deferPromptHook === "function" && state != null && typeof state === "object") {
+					const innerComplete = () => {
+						const innerResult = dispatchByMode(parser.$mode, () => syncParser.complete(state), () => parser.complete(state));
+						return mapModeValue(parser.$mode, innerResult, (result) => result.success ? result : {
+							success: true,
+							value: void 0
+						});
+					};
+					return innerComplete();
+				}
 				return {
 					success: true,
 					value: void 0
@@ -125,7 +139,8 @@ function optional(parser) {
 					value: void 0
 				};
 			}
-			return dispatchByMode(parser.$mode, () => syncParser.complete(state[0]), () => parser.complete(state[0]));
+			const innerElement = getAnnotations(state) != null && state[0] != null && typeof state[0] === "object" ? inheritAnnotations(state, state[0]) : state[0];
+			return dispatchByMode(parser.$mode, () => syncParser.complete(innerElement), () => parser.complete(innerElement));
 		},
 		suggest(context, prefix) {
 			return dispatchIterableByMode(parser.$mode, () => suggestSync(context, prefix), () => suggestAsync(context, prefix));
@@ -202,6 +217,8 @@ function withDefault(parser, defaultValue, options) {
 	}
 	const innerInitialState = syncParser.initialState;
 	const wrappedDependencyMarker = isPendingDependencySourceState(innerInitialState) ? { [wrappedDependencySourceMarker]: innerInitialState } : isWrappedDependencySource(parser) ? { [wrappedDependencySourceMarker]: parser[wrappedDependencySourceMarker] } : {};
+	const deferPromptHookDefault = Reflect.get(parser, deferPromptUntilConfigResolvesKey);
+	const deferPromptMarkerDefault = typeof deferPromptHookDefault === "function" ? { [deferPromptUntilConfigResolvesKey]: deferPromptHookDefault } : {};
 	return {
 		$mode: parser.$mode,
 		$valueType: [],
@@ -213,6 +230,7 @@ function withDefault(parser, defaultValue, options) {
 		}],
 		initialState: void 0,
 		...wrappedDependencyMarker,
+		...deferPromptMarkerDefault,
 		parse(context) {
 			return dispatchByMode(parser.$mode, () => parseOptionalStyleSync(context, syncParser), () => parseOptionalStyleAsync(context, parser));
 		},
@@ -261,6 +279,10 @@ function withDefault(parser, defaultValue, options) {
 						error: error instanceof WithDefaultError ? error.errorMessage : message`${text(String(error))}`
 					};
 				}
+				if (typeof deferPromptHookDefault === "function" && state != null && typeof state === "object") {
+					const innerResult = dispatchByMode(parser.$mode, () => syncParser.complete(state), () => parser.complete(state));
+					return innerResult;
+				}
 				try {
 					const value = typeof defaultValue === "function" ? defaultValue() : defaultValue;
 					return {
@@ -318,7 +340,8 @@ function withDefault(parser, defaultValue, options) {
 					};
 				}
 			}
-			return dispatchByMode(parser.$mode, () => syncParser.complete(state[0]), () => parser.complete(state[0]));
+			const innerElement = getAnnotations(state) != null && state[0] != null && typeof state[0] === "object" ? inheritAnnotations(state, state[0]) : state[0];
+			return dispatchByMode(parser.$mode, () => syncParser.complete(innerElement), () => parser.complete(innerElement));
 		},
 		suggest(context, prefix) {
 			return dispatchIterableByMode(parser.$mode, () => suggestSync(context, prefix), () => suggestAsync(context, prefix));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.0.0-dev.757+6abd354f",
+  "version": "1.0.0-dev.767+88628ce6",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",