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

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.1602+d81eb3b1",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",