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

package/dist/modifiers.cjs

@@ -2,6 +2,7 @@ const require_annotations = require('./annotations.cjs');
 const require_message = require('./message.cjs');
 const require_dependency = require('./dependency.cjs');
 const require_mode_dispatch = require('./mode-dispatch.cjs');
+const require_dependency_metadata = require('./dependency-metadata.cjs');
 
 //#region src/modifiers.ts
 /**
@@ -186,6 +187,10 @@ function optional(parser) {
 			enumerable: false
 		});
 	}
+	if (parser.dependencyMetadata != null) {
+		const composed = require_dependency_metadata.composeDependencyMetadata(parser.dependencyMetadata, "optional");
+		if (composed != null) optionalParser.dependencyMetadata = composed;
+	}
 	return optionalParser;
 }
 /**
@@ -434,6 +439,28 @@ function withDefault(parser, defaultValue, options) {
 			enumerable: false
 		});
 	}
+	if (parser.dependencyMetadata != null) {
+		const composed = require_dependency_metadata.composeDependencyMetadata(parser.dependencyMetadata, "withDefault", { defaultValue: () => {
+			let v;
+			try {
+				v = typeof defaultValue === "function" ? defaultValue() : defaultValue;
+			} catch (e) {
+				const error = e instanceof WithDefaultError ? e.errorMessage : require_message.message`${e instanceof Error ? e.message : String(e)}`;
+				return {
+					success: false,
+					error
+				};
+			}
+			if (typeof parser.normalizeValue === "function") try {
+				v = parser.normalizeValue(v);
+			} catch {}
+			return {
+				success: true,
+				value: v
+			};
+		} });
+		if (composed != null) withDefaultParser.dependencyMetadata = composed;
+	}
 	return withDefaultParser;
 }
 /**
@@ -559,6 +586,43 @@ function map(parser, transform) {
 		configurable: true,
 		enumerable: false
 	});
+	if (parser.dependencyMetadata != null) {
+		let composed = require_dependency_metadata.composeDependencyMetadata(parser.dependencyMetadata, "map");
+		if (composed?.derived != null) {
+			const innerReplay = composed.derived.replayParse;
+			const applyMappedReplay = (r) => {
+				if (!r.success) return r;
+				if (r.deferred) try {
+					return {
+						success: true,
+						value: transform(r.value),
+						deferred: true
+					};
+				} catch {
+					return {
+						success: true,
+						value: void 0,
+						deferred: true
+					};
+				}
+				return {
+					success: true,
+					value: transform(r.value)
+				};
+			};
+			composed = {
+				...composed,
+				derived: {
+					...composed.derived,
+					replayParse: (rawInput, depValues) => {
+						const result = innerReplay(rawInput, depValues);
+						return result instanceof Promise ? result.then(applyMappedReplay) : applyMappedReplay(result);
+					}
+				}
+			};
+		}
+		if (composed != null) mappedParser.dependencyMetadata = composed;
+	}
 	return mappedParser;
 }
 /**

package/dist/modifiers.js

@@ -2,6 +2,7 @@ import { annotateFreshArray, getAnnotations, inheritAnnotations, isInjectedAnnot
 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";
+import { composeDependencyMetadata } from "./dependency-metadata.js";
 
 //#region src/modifiers.ts
 /**
@@ -186,6 +187,10 @@ function optional(parser) {
 			enumerable: false
 		});
 	}
+	if (parser.dependencyMetadata != null) {
+		const composed = composeDependencyMetadata(parser.dependencyMetadata, "optional");
+		if (composed != null) optionalParser.dependencyMetadata = composed;
+	}
 	return optionalParser;
 }
 /**
@@ -434,6 +439,28 @@ function withDefault(parser, defaultValue, options) {
 			enumerable: false
 		});
 	}
+	if (parser.dependencyMetadata != null) {
+		const composed = composeDependencyMetadata(parser.dependencyMetadata, "withDefault", { defaultValue: () => {
+			let v;
+			try {
+				v = typeof defaultValue === "function" ? defaultValue() : defaultValue;
+			} catch (e) {
+				const error = e instanceof WithDefaultError ? e.errorMessage : message`${e instanceof Error ? e.message : String(e)}`;
+				return {
+					success: false,
+					error
+				};
+			}
+			if (typeof parser.normalizeValue === "function") try {
+				v = parser.normalizeValue(v);
+			} catch {}
+			return {
+				success: true,
+				value: v
+			};
+		} });
+		if (composed != null) withDefaultParser.dependencyMetadata = composed;
+	}
 	return withDefaultParser;
 }
 /**
@@ -559,6 +586,43 @@ function map(parser, transform) {
 		configurable: true,
 		enumerable: false
 	});
+	if (parser.dependencyMetadata != null) {
+		let composed = composeDependencyMetadata(parser.dependencyMetadata, "map");
+		if (composed?.derived != null) {
+			const innerReplay = composed.derived.replayParse;
+			const applyMappedReplay = (r) => {
+				if (!r.success) return r;
+				if (r.deferred) try {
+					return {
+						success: true,
+						value: transform(r.value),
+						deferred: true
+					};
+				} catch {
+					return {
+						success: true,
+						value: void 0,
+						deferred: true
+					};
+				}
+				return {
+					success: true,
+					value: transform(r.value)
+				};
+			};
+			composed = {
+				...composed,
+				derived: {
+					...composed.derived,
+					replayParse: (rawInput, depValues) => {
+						const result = innerReplay(rawInput, depValues);
+						return result instanceof Promise ? result.then(applyMappedReplay) : applyMappedReplay(result);
+					}
+				}
+			};
+		}
+		if (composed != null) mappedParser.dependencyMetadata = composed;
+	}
 	return mappedParser;
 }
 /**

package/dist/parser.d.cts

@@ -4,6 +4,8 @@ import { Usage } from "./usage.cjs";
 import { DocFragments, DocPage } from "./doc.cjs";
 import { DependencyRegistryLike } from "./registry-types.cjs";
 import { DeferredMap, ValueParserResult } from "./valueparser.cjs";
+import { ParserDependencyMetadata } from "./dependency-metadata.cjs";
+import { DependencyRuntimeContext } from "./dependency-runtime.cjs";
 import { ConditionalErrorOptions, ConditionalOptions, DuplicateOptionError, GroupOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OrErrorOptions, OrOptions, TupleOptions, concat, conditional, group, longestMatch, merge, object, or, tuple } from "./constructs.cjs";
 import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOptions, map, multiple, nonEmpty, optional, withDefault } from "./modifiers.cjs";
 import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, fail, flag, option, passThrough } from "./primitives.cjs";
@@ -251,6 +253,14 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    * @since 1.0.0
    */
   normalizeValue?(value: TValue): TValue;
+  /**
+   * Internal dependency metadata describing this parser's dependency
+   * capabilities.  Used by the dependency runtime to resolve dependencies
+   * without relying on state-shape protocols.
+   * @internal
+   * @since 1.0.0
+   */
+  readonly dependencyMetadata?: ParserDependencyMetadata;
 }
 /**
  * Parser-local frame data containing the input buffer and parser state.
@@ -308,6 +318,13 @@ interface ExecutionContext {
    * @since 0.10.0
    */
   readonly dependencyRegistry?: DependencyRegistryLike;
+  /**
+   * The dependency runtime context for dependency resolution.
+   * Coexists with `dependencyRegistry` during the transition period.
+   * @internal
+   * @since 1.0.0
+   */
+  readonly dependencyRuntime?: DependencyRuntimeContext;
 }
 /**
  * The context of the parser, which includes the input buffer and the state.

package/dist/parser.d.ts

@@ -4,6 +4,8 @@ import { Usage } from "./usage.js";
 import { DocFragments, DocPage } from "./doc.js";
 import { DependencyRegistryLike } from "./registry-types.js";
 import { DeferredMap, ValueParserResult } from "./valueparser.js";
+import { ParserDependencyMetadata } from "./dependency-metadata.js";
+import { DependencyRuntimeContext } from "./dependency-runtime.js";
 import { ConditionalErrorOptions, ConditionalOptions, DuplicateOptionError, GroupOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OrErrorOptions, OrOptions, TupleOptions, concat, conditional, group, longestMatch, merge, object, or, tuple } from "./constructs.js";
 import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOptions, map, multiple, nonEmpty, optional, withDefault } from "./modifiers.js";
 import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, fail, flag, option, passThrough } from "./primitives.js";
@@ -251,6 +253,14 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    * @since 1.0.0
    */
   normalizeValue?(value: TValue): TValue;
+  /**
+   * Internal dependency metadata describing this parser's dependency
+   * capabilities.  Used by the dependency runtime to resolve dependencies
+   * without relying on state-shape protocols.
+   * @internal
+   * @since 1.0.0
+   */
+  readonly dependencyMetadata?: ParserDependencyMetadata;
 }
 /**
  * Parser-local frame data containing the input buffer and parser state.
@@ -308,6 +318,13 @@ interface ExecutionContext {
    * @since 0.10.0
    */
   readonly dependencyRegistry?: DependencyRegistryLike;
+  /**
+   * The dependency runtime context for dependency resolution.
+   * Coexists with `dependencyRegistry` during the transition period.
+   * @internal
+   * @since 1.0.0
+   */
+  readonly dependencyRuntime?: DependencyRuntimeContext;
 }
 /**
  * The context of the parser, which includes the input buffer and the state.

package/dist/primitives.cjs

@@ -6,6 +6,7 @@ const require_validate = require('./validate.cjs');
 const require_usage = require('./usage.cjs');
 const require_suggestion = require('./suggestion.cjs');
 const require_usage_internals = require('./usage-internals.cjs');
+const require_dependency_metadata = require('./dependency-metadata.cjs');
 const require_valueparser = require('./valueparser.cjs');
 
 //#region src/primitives.ts
@@ -598,6 +599,10 @@ function option(...args) {
 		enumerable: false,
 		writable: false
 	});
+	if (valueParser != null) {
+		const depMeta = require_dependency_metadata.extractDependencyMetadata(valueParser);
+		if (depMeta != null) result.dependencyMetadata = depMeta;
+	}
 	return result;
 }
 /**
@@ -963,6 +968,8 @@ function argument(valueParser, options = {}) {
 		configurable: true,
 		enumerable: false
 	});
+	const depMeta = require_dependency_metadata.extractDependencyMetadata(valueParser);
+	if (depMeta != null) result.dependencyMetadata = depMeta;
 	return result;
 }
 function* suggestCommandSync(context, prefix, name, parser, options) {

package/dist/primitives.js

@@ -6,6 +6,7 @@ import { validateCommandNames, validateOptionNames } from "./validate.js";
 import { extractOptionNames, isDocHidden, isSuggestionHidden } from "./usage.js";
 import { DEFAULT_FIND_SIMILAR_OPTIONS, createErrorWithSuggestions, createSuggestionMessage, findSimilar } from "./suggestion.js";
 import { extractLeadingCommandNames } from "./usage-internals.js";
+import { extractDependencyMetadata } from "./dependency-metadata.js";
 import { isValueParser } from "./valueparser.js";
 
 //#region src/primitives.ts
@@ -598,6 +599,10 @@ function option(...args) {
 		enumerable: false,
 		writable: false
 	});
+	if (valueParser != null) {
+		const depMeta = extractDependencyMetadata(valueParser);
+		if (depMeta != null) result.dependencyMetadata = depMeta;
+	}
 	return result;
 }
 /**
@@ -963,6 +968,8 @@ function argument(valueParser, options = {}) {
 		configurable: true,
 		enumerable: false
 	});
+	const depMeta = extractDependencyMetadata(valueParser);
+	if (depMeta != null) result.dependencyMetadata = depMeta;
 	return result;
 }
 function* suggestCommandSync(context, prefix, name, parser, options) {

package/package.json

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