@optique/core 1.3.0-dev.2385 → 1.3.0-dev.2388

package/dist/facade.js

@@ -144,7 +144,8 @@ function createRunWithSessions() {
 		...seedSession,
 		policy: "eager",
 		effectfulSources: /* @__PURE__ */ new Set(),
-		completedByPath: /* @__PURE__ */ new Map()
+		completedByPath: /* @__PURE__ */ new Map(),
+		preparedByPath: /* @__PURE__ */ new Map()
 	};
 	return {
 		seedSession,

package/dist/internal/parser.cjs

@@ -25,7 +25,8 @@ function createEffectfulCompletionSession(policy = "eager") {
 		results: /* @__PURE__ */ new Map(),
 		demanded: /* @__PURE__ */ new Set(),
 		effectfulSources: /* @__PURE__ */ new Set(),
-		completedByPath: /* @__PURE__ */ new Map()
+		completedByPath: /* @__PURE__ */ new Map(),
+		preparedByPath: /* @__PURE__ */ new Map()
 	};
 }
 /**

package/dist/internal/parser.d.cts

@@ -470,6 +470,16 @@ interface EffectfulCompletionSession {
    * the field's final value.
    */
   readonly completedByPath: Map<string, ValueParserResult<unknown>>;
+  /**
+   * Prepared branch selections for `conditional()` parsers whose branch
+   * was resolved during the scheduling pass, keyed by parser occurrence
+   * and serialized path.  Scoped to a single pass like
+   * {@link completedByPath}: phase-two bindings may change the
+   * selection, so the final pass of a `runWith()` run re-prepares.
+   * Final completion consumes the prepared decision instead of
+   * re-completing the discriminator or re-selecting a branch.
+   */
+  readonly preparedByPath: Map<string, unknown>;
 }
 /**
  * Creates a fresh {@link EffectfulCompletionSession}.

package/dist/internal/parser.d.ts

@@ -470,6 +470,16 @@ interface EffectfulCompletionSession {
    * the field's final value.
    */
   readonly completedByPath: Map<string, ValueParserResult<unknown>>;
+  /**
+   * Prepared branch selections for `conditional()` parsers whose branch
+   * was resolved during the scheduling pass, keyed by parser occurrence
+   * and serialized path.  Scoped to a single pass like
+   * {@link completedByPath}: phase-two bindings may change the
+   * selection, so the final pass of a `runWith()` run re-prepares.
+   * Final completion consumes the prepared decision instead of
+   * re-completing the discriminator or re-selecting a branch.
+   */
+  readonly preparedByPath: Map<string, unknown>;
 }
 /**
  * Creates a fresh {@link EffectfulCompletionSession}.

package/dist/internal/parser.js

@@ -25,7 +25,8 @@ function createEffectfulCompletionSession(policy = "eager") {
 		results: /* @__PURE__ */ new Map(),
 		demanded: /* @__PURE__ */ new Set(),
 		effectfulSources: /* @__PURE__ */ new Set(),
-		completedByPath: /* @__PURE__ */ new Map()
+		completedByPath: /* @__PURE__ */ new Map(),
+		preparedByPath: /* @__PURE__ */ new Map()
 	};
 }
 /**

package/dist/primitives.cjs

@@ -1720,6 +1720,16 @@ function command(name, parser, options = {}) {
 		configurable: true,
 		enumerable: false
 	});
+	Object.defineProperty(result, require_dependency_runtime.sourceCollectionExpansionKey, {
+		value: true,
+		configurable: true,
+		enumerable: false
+	});
+	Object.defineProperty(result, require_dependency_runtime.staticSourceScopeKey, {
+		value: [parser],
+		configurable: true,
+		enumerable: false
+	});
 	return require_modifiers.fluent(result);
 }
 /**

package/dist/primitives.js

@@ -4,7 +4,7 @@ import { validateCommandNames, validateOptionNames } from "./validate.js";
 import { extractOptionNames, isDocHidden, isSuggestionHidden } from "./usage.js";
 import { dispatchByMode, dispatchIterableByMode, wrapForMode } from "./internal/mode-dispatch.js";
 import { getDefaultValuesFunction, getDependencyIds, getSnapshottedDefaultDependencyValues, isDerivedValueParser, suggestWithDependency } from "./internal/dependency.js";
-import { effectfulSchedulingNodesKey, replayDerivedParser, replayDerivedParserAsync } from "./dependency-runtime.js";
+import { effectfulSchedulingNodesKey, replayDerivedParser, replayDerivedParserAsync, sourceCollectionExpansionKey, staticSourceScopeKey } from "./dependency-runtime.js";
 import { getWrappedChildParseState, getWrappedChildState, isAnnotationWrappedInitialState, normalizeInjectedAnnotationState } from "./annotation-state.js";
 import { hiddenCommandAliasesKey } from "./internal/command-alias.js";
 import { mergeChildExec, withChildContext, withChildExecPath } from "./execution-context.js";
@@ -1720,6 +1720,16 @@ function command(name, parser, options = {}) {
 		configurable: true,
 		enumerable: false
 	});
+	Object.defineProperty(result, sourceCollectionExpansionKey, {
+		value: true,
+		configurable: true,
+		enumerable: false
+	});
+	Object.defineProperty(result, staticSourceScopeKey, {
+		value: [parser],
+		configurable: true,
+		enumerable: false
+	});
 	return fluent(result);
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.3.0-dev.2385",
+  "version": "1.3.0-dev.2388",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",
@@ -221,7 +221,7 @@
   },
   "sideEffects": false,
   "devDependencies": {
-    "@optique/env": "1.3.0-dev.2385+011936e3",
+    "@optique/env": "1.3.0-dev.2388+055f7a0d",
     "@types/node": "^24.0.0",
     "fast-check": "^4.7.0",
     "tsdown": "^0.13.0",