@optique/core 1.0.0-dev.908 → 1.0.0

package/dist/dependency.cjs

@@ -1,929 +1,8 @@
-const require_message = require('./message.cjs');
+const require_dependency = require('./internal/dependency.cjs');
 
-//#region src/dependency.ts
-/**
-* A unique symbol used to identify dependency sources at compile time.
-* This marker is used to distinguish {@link DependencySource} from regular
-* {@link ValueParser} instances.
-* @since 0.10.0
-*/
-const dependencySourceMarker = Symbol.for("@optique/core/dependency/dependencySourceMarker");
-/**
-* A unique symbol used to identify derived value parsers at compile time.
-* This marker is used to distinguish {@link DerivedValueParser} from regular
-* {@link ValueParser} instances.
-* @since 0.10.0
-*/
-const derivedValueParserMarker = Symbol.for("@optique/core/dependency/derivedValueParserMarker");
-/**
-* A unique symbol used to store the dependency ID on value parsers.
-* @since 0.10.0
-*/
-const dependencyId = Symbol.for("@optique/core/dependency/dependencyId");
-/**
-* A unique symbol used to store multiple dependency IDs on derived parsers
-* that depend on multiple sources (created via {@link deriveFrom}).
-* @since 0.10.0
-*/
-const dependencyIds = Symbol.for("@optique/core/dependency/dependencyIds");
-/**
-* A unique symbol used to store the default values function on derived parsers.
-* This is used during partial dependency resolution to fill in missing values.
-* @since 0.10.0
-*/
-const defaultValues = Symbol.for("@optique/core/dependency/defaultValues");
-/**
-* A unique symbol used to access the parseWithDependency method on derived parsers.
-* @since 0.10.0
-*/
-const parseWithDependency = Symbol.for("@optique/core/dependency/parseWithDependency");
-/**
-* A unique symbol used to access the suggestWithDependency method on derived parsers.
-* This method generates suggestions using the provided dependency values instead of defaults.
-* @since 0.10.0
-*/
-const suggestWithDependency = Symbol.for("@optique/core/dependency/suggestWithDependency");
-/**
-* Creates a dependency source from a {@link ValueParser}.
-*
-* A dependency source wraps an existing value parser and enables creating
-* derived parsers that depend on the parsed value. This is useful for
-* scenarios where one option's valid values depend on another option's value.
-*
-* @template M The execution mode of the value parser.
-* @template T The type of value the parser produces.
-* @param parser The value parser to wrap as a dependency source.
-* @returns A {@link DependencySource} that can be used to create
-*          derived parsers.
-* @example
-* ```typescript
-* import { dependency } from "@optique/core/dependency";
-* import { string } from "@optique/core/valueparser";
-*
-* // Create a dependency source for a directory path
-* const cwdParser = dependency(string({ metavar: "DIR" }));
-*
-* // Create a derived parser that depends on the directory
-* const branchParser = cwdParser.derive({
-*   metavar: "BRANCH",
-*   mode: "sync",
-*   factory: (dir) => gitBranch({ dir }),
-*   defaultValue: () => process.cwd(),
-* });
-* ```
-* @since 0.10.0
-*/
-function dependency(parser) {
-	const id = Symbol();
-	const result = {
-		...parser,
-		[dependencySourceMarker]: true,
-		[dependencyId]: id,
-		derive(options) {
-			if (options.mode !== "sync" && options.mode !== "async") throw new TypeError("derive() requires an explicit mode field (\"sync\" or \"async\").");
-			return createDerivedValueParser(id, parser, options, options.mode);
-		},
-		deriveSync(options) {
-			if (parser.$mode === "async") return createAsyncDerivedParserFromSyncFactory(id, options);
-			return createSyncDerivedParser(id, options);
-		},
-		deriveAsync(options) {
-			return createAsyncDerivedParserFromAsyncFactory(id, options);
-		}
-	};
-	return result;
-}
-/**
-* Checks if a value parser is a {@link DependencySource}.
-*
-* @param parser The value parser to check.
-* @returns `true` if the parser is a dependency source, `false` otherwise.
-* @since 0.10.0
-*/
-function isDependencySource(parser) {
-	return dependencySourceMarker in parser && parser[dependencySourceMarker] === true;
-}
-/**
-* Checks if a value parser is a {@link DerivedValueParser}.
-*
-* @param parser The value parser to check.
-* @returns `true` if the parser is a derived value parser, `false` otherwise.
-* @since 0.10.0
-*/
-function isDerivedValueParser(parser) {
-	return derivedValueParserMarker in parser && parser[derivedValueParserMarker] === true;
-}
-/**
-* Creates a derived value parser from multiple dependency sources.
-*
-* This function allows creating a parser whose behavior depends on
-* multiple other parsers' values. This is useful for scenarios where
-* an option's valid values depend on a combination of other options.
-*
-* @template Deps A tuple of DependencySource types.
-* @template T The type of value the derived parser produces.
-* @param options Configuration for the derived parser.
-* @returns A {@link DerivedValueParser} that depends on the given sources.
-* @example
-* ```typescript
-* import { dependency, deriveFrom } from "@optique/core/dependency";
-* import { string, choice } from "@optique/core/valueparser";
-*
-* const dirParser = dependency(string({ metavar: "DIR" }));
-* const modeParser = dependency(choice(["dev", "prod"]));
-*
-* const configParser = deriveFrom({
-*   metavar: "CONFIG",
-*   mode: "sync",
-*   dependencies: [dirParser, modeParser] as const,
-*   factory: (dir, mode) =>
-*     choice(mode === "dev"
-*       ? [`${dir}/dev.json`, `${dir}/dev.yaml`]
-*       : [`${dir}/prod.json`, `${dir}/prod.yaml`]),
-*   defaultValues: () => ["/config", "dev"],
-* });
-* ```
-* @throws {TypeError} If the `mode` field is missing or invalid.
-* @since 0.10.0
-*/
-function deriveFrom(options) {
-	if (options.mode !== "sync" && options.mode !== "async") throw new TypeError("deriveFrom() requires an explicit mode field (\"sync\" or \"async\").");
-	const depsAsync = options.dependencies.some((dep) => dep.$mode === "async");
-	const sourceId = options.dependencies.length > 0 ? options.dependencies[0][dependencyId] : Symbol();
-	const factoryReturnsAsync = options.mode === "async";
-	const isAsync = depsAsync || factoryReturnsAsync;
-	if (isAsync) {
-		if (factoryReturnsAsync) return createAsyncDerivedFromParserFromAsyncFactory(sourceId, options);
-		return createAsyncDerivedFromParserFromSyncFactory(sourceId, options);
-	}
-	return createSyncDerivedFromParser(sourceId, options);
-}
-/**
-* Creates a derived value parser from multiple dependency sources
-* with a synchronous factory.
-*
-* This function allows creating a parser whose behavior depends on
-* multiple other parsers' values. The factory explicitly returns
-* a sync parser.
-*
-* @template Deps A tuple of DependencySource types.
-* @template T The type of value the derived parser produces.
-* @param options Configuration for the derived parser with sync factory.
-* @returns A {@link DerivedValueParser} that depends on the given sources.
-* @since 0.10.0
-*/
-function deriveFromSync(options) {
-	const depsAsync = options.dependencies.some((dep) => dep.$mode === "async");
-	const sourceId = options.dependencies.length > 0 ? options.dependencies[0][dependencyId] : Symbol();
-	if (depsAsync) return createAsyncDerivedFromParserFromSyncFactory(sourceId, options);
-	return createSyncDerivedFromParser(sourceId, options);
-}
-/**
-* Creates a derived value parser from multiple dependency sources
-* with an asynchronous factory.
-*
-* This function allows creating a parser whose behavior depends on
-* multiple other parsers' values. The factory explicitly returns
-* an async parser.
-*
-* @template Deps A tuple of DependencySource types.
-* @template T The type of value the derived parser produces.
-* @param options Configuration for the derived parser with async factory.
-* @returns A {@link DerivedValueParser} that depends on the given sources.
-* @since 0.10.0
-*/
-function deriveFromAsync(options) {
-	const sourceId = options.dependencies.length > 0 ? options.dependencies[0][dependencyId] : Symbol();
-	return createAsyncDerivedFromParserFromAsyncFactory(sourceId, options);
-}
-function isAsyncModeParser(parser) {
-	return parser.$mode === "async";
-}
-function createSyncDerivedFromParser(sourceId, options) {
-	const alldependencyIds = options.dependencies.map((dep) => dep[dependencyId]);
-	return {
-		$mode: "sync",
-		metavar: options.metavar,
-		[derivedValueParserMarker]: true,
-		[dependencyId]: sourceId,
-		[dependencyIds]: alldependencyIds,
-		[defaultValues]: options.defaultValues,
-		parse(input) {
-			let derivedParser;
-			try {
-				const sourceValues = options.defaultValues();
-				derivedParser = options.factory(...sourceValues);
-			} catch (e) {
-				const msg = e instanceof Error ? e.message : String(e);
-				return {
-					success: false,
-					error: require_message.message`Derived parser error: ${msg}`
-				};
-			}
-			if (isAsyncModeParser(derivedParser)) return {
-				success: false,
-				error: require_message.message`Factory returned an async parser where a sync parser is required.`
-			};
-			return derivedParser.parse(input);
-		},
-		[parseWithDependency](input, dependencyValue) {
-			let derivedParser;
-			try {
-				derivedParser = options.factory(...dependencyValue);
-			} catch (e) {
-				const msg = e instanceof Error ? e.message : String(e);
-				return {
-					success: false,
-					error: require_message.message`Factory error: ${msg}`
-				};
-			}
-			if (isAsyncModeParser(derivedParser)) return {
-				success: false,
-				error: require_message.message`Factory returned an async parser where a sync parser is required.`
-			};
-			return derivedParser.parse(input);
-		},
-		format(value) {
-			let derivedParser;
-			try {
-				const sourceValues = options.defaultValues();
-				derivedParser = options.factory(...sourceValues);
-			} catch {
-				return String(value);
-			}
-			return derivedParser.format(value);
-		},
-		*suggest(prefix) {
-			let derivedParser;
-			try {
-				const sourceValues = options.defaultValues();
-				derivedParser = options.factory(...sourceValues);
-			} catch {
-				return;
-			}
-			if (isAsyncModeParser(derivedParser) || !derivedParser.suggest) return;
-			yield* derivedParser.suggest(prefix);
-		},
-		*[suggestWithDependency](prefix, dependencyValue) {
-			let derivedParser;
-			try {
-				derivedParser = options.factory(...dependencyValue);
-			} catch {
-				try {
-					const sourceValues = options.defaultValues();
-					derivedParser = options.factory(...sourceValues);
-				} catch {
-					return;
-				}
-			}
-			if (isAsyncModeParser(derivedParser) || !derivedParser.suggest) return;
-			yield* derivedParser.suggest(prefix);
-		}
-	};
-}
-/**
-* Creates an async derived parser from multiple dependencies when the
-* factory returns an async parser.
-*/
-function createAsyncDerivedFromParserFromAsyncFactory(sourceId, options) {
-	const alldependencyIds = options.dependencies.map((dep) => dep[dependencyId]);
-	return {
-		$mode: "async",
-		metavar: options.metavar,
-		[derivedValueParserMarker]: true,
-		[dependencyId]: sourceId,
-		[dependencyIds]: alldependencyIds,
-		[defaultValues]: options.defaultValues,
-		parse(input) {
-			let derivedParser;
-			try {
-				const sourceValues = options.defaultValues();
-				derivedParser = options.factory(...sourceValues);
-			} catch (e) {
-				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
-					success: false,
-					error: require_message.message`Derived parser error: ${msg}`
-				});
-			}
-			return Promise.resolve(derivedParser.parse(input));
-		},
-		[parseWithDependency](input, dependencyValue) {
-			let derivedParser;
-			try {
-				derivedParser = options.factory(...dependencyValue);
-			} catch (e) {
-				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
-					success: false,
-					error: require_message.message`Factory error: ${msg}`
-				});
-			}
-			return Promise.resolve(derivedParser.parse(input));
-		},
-		format(value) {
-			let derivedParser;
-			try {
-				const sourceValues = options.defaultValues();
-				derivedParser = options.factory(...sourceValues);
-			} catch {
-				return String(value);
-			}
-			return derivedParser.format(value);
-		},
-		async *suggest(prefix) {
-			let derivedParser;
-			try {
-				const sourceValues = options.defaultValues();
-				derivedParser = options.factory(...sourceValues);
-			} catch {
-				return;
-			}
-			if (derivedParser.suggest) for await (const suggestion of derivedParser.suggest(prefix)) yield suggestion;
-		},
-		async *[suggestWithDependency](prefix, dependencyValue) {
-			let derivedParser;
-			try {
-				derivedParser = options.factory(...dependencyValue);
-			} catch {
-				try {
-					const sourceValues = options.defaultValues();
-					derivedParser = options.factory(...sourceValues);
-				} catch {
-					return;
-				}
-			}
-			if (derivedParser.suggest) for await (const suggestion of derivedParser.suggest(prefix)) yield suggestion;
-		}
-	};
-}
-/**
-* Creates an async derived parser from multiple dependencies when the
-* sources are async but the factory returns a sync parser.
-*/
-function createAsyncDerivedFromParserFromSyncFactory(sourceId, options) {
-	const alldependencyIds = options.dependencies.map((dep) => dep[dependencyId]);
-	return {
-		$mode: "async",
-		metavar: options.metavar,
-		[derivedValueParserMarker]: true,
-		[dependencyId]: sourceId,
-		[dependencyIds]: alldependencyIds,
-		[defaultValues]: options.defaultValues,
-		parse(input) {
-			let derivedParser;
-			try {
-				const sourceValues = options.defaultValues();
-				derivedParser = options.factory(...sourceValues);
-			} catch (e) {
-				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
-					success: false,
-					error: require_message.message`Derived parser error: ${msg}`
-				});
-			}
-			return Promise.resolve(derivedParser.parse(input));
-		},
-		[parseWithDependency](input, dependencyValue) {
-			let derivedParser;
-			try {
-				derivedParser = options.factory(...dependencyValue);
-			} catch (e) {
-				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
-					success: false,
-					error: require_message.message`Factory error: ${msg}`
-				});
-			}
-			return Promise.resolve(derivedParser.parse(input));
-		},
-		format(value) {
-			let derivedParser;
-			try {
-				const sourceValues = options.defaultValues();
-				derivedParser = options.factory(...sourceValues);
-			} catch {
-				return String(value);
-			}
-			return derivedParser.format(value);
-		},
-		async *suggest(prefix) {
-			let derivedParser;
-			try {
-				const sourceValues = options.defaultValues();
-				derivedParser = options.factory(...sourceValues);
-			} catch {
-				return;
-			}
-			if (derivedParser.suggest) yield* derivedParser.suggest(prefix);
-		},
-		*[suggestWithDependency](prefix, dependencyValue) {
-			let derivedParser;
-			try {
-				derivedParser = options.factory(...dependencyValue);
-			} catch {
-				try {
-					const sourceValues = options.defaultValues();
-					derivedParser = options.factory(...sourceValues);
-				} catch {
-					return;
-				}
-			}
-			if (derivedParser.suggest) yield* derivedParser.suggest(prefix);
-		}
-	};
-}
-function createDerivedValueParser(sourceId, sourceParser, options, factoryMode) {
-	const factoryReturnsAsync = factoryMode === "async";
-	const isAsync = sourceParser.$mode === "async" || factoryReturnsAsync;
-	if (isAsync) {
-		if (factoryReturnsAsync) return createAsyncDerivedParserFromAsyncFactory(sourceId, options);
-		return createAsyncDerivedParserFromSyncFactory(sourceId, options);
-	}
-	return createSyncDerivedParser(sourceId, options);
-}
-function createSyncDerivedParser(sourceId, options) {
-	return {
-		$mode: "sync",
-		metavar: options.metavar,
-		[derivedValueParserMarker]: true,
-		[dependencyId]: sourceId,
-		parse(input) {
-			let derivedParser;
-			try {
-				const sourceValue = options.defaultValue();
-				derivedParser = options.factory(sourceValue);
-			} catch (e) {
-				const msg = e instanceof Error ? e.message : String(e);
-				return {
-					success: false,
-					error: require_message.message`Derived parser error: ${msg}`
-				};
-			}
-			if (isAsyncModeParser(derivedParser)) return {
-				success: false,
-				error: require_message.message`Factory returned an async parser where a sync parser is required.`
-			};
-			return derivedParser.parse(input);
-		},
-		[parseWithDependency](input, dependencyValue) {
-			let derivedParser;
-			try {
-				derivedParser = options.factory(dependencyValue);
-			} catch (e) {
-				const msg = e instanceof Error ? e.message : String(e);
-				return {
-					success: false,
-					error: require_message.message`Factory error: ${msg}`
-				};
-			}
-			if (isAsyncModeParser(derivedParser)) return {
-				success: false,
-				error: require_message.message`Factory returned an async parser where a sync parser is required.`
-			};
-			return derivedParser.parse(input);
-		},
-		format(value) {
-			let derivedParser;
-			try {
-				const sourceValue = options.defaultValue();
-				derivedParser = options.factory(sourceValue);
-			} catch {
-				return String(value);
-			}
-			return derivedParser.format(value);
-		},
-		*suggest(prefix) {
-			let derivedParser;
-			try {
-				const sourceValue = options.defaultValue();
-				derivedParser = options.factory(sourceValue);
-			} catch {
-				return;
-			}
-			if (isAsyncModeParser(derivedParser) || !derivedParser.suggest) return;
-			yield* derivedParser.suggest(prefix);
-		},
-		*[suggestWithDependency](prefix, dependencyValue) {
-			let derivedParser;
-			try {
-				derivedParser = options.factory(dependencyValue);
-			} catch {
-				try {
-					derivedParser = options.factory(options.defaultValue());
-				} catch {
-					return;
-				}
-			}
-			if (isAsyncModeParser(derivedParser) || !derivedParser.suggest) return;
-			yield* derivedParser.suggest(prefix);
-		}
-	};
-}
-/**
-* Creates an async derived parser when the factory returns an async parser.
-* The parse result is awaited since the factory returns an async parser.
-*/
-function createAsyncDerivedParserFromAsyncFactory(sourceId, options) {
-	return {
-		$mode: "async",
-		metavar: options.metavar,
-		[derivedValueParserMarker]: true,
-		[dependencyId]: sourceId,
-		parse(input) {
-			let derivedParser;
-			try {
-				const sourceValue = options.defaultValue();
-				derivedParser = options.factory(sourceValue);
-			} catch (e) {
-				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
-					success: false,
-					error: require_message.message`Derived parser error: ${msg}`
-				});
-			}
-			return Promise.resolve(derivedParser.parse(input));
-		},
-		[parseWithDependency](input, dependencyValue) {
-			let derivedParser;
-			try {
-				derivedParser = options.factory(dependencyValue);
-			} catch (e) {
-				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
-					success: false,
-					error: require_message.message`Factory error: ${msg}`
-				});
-			}
-			return Promise.resolve(derivedParser.parse(input));
-		},
-		format(value) {
-			let derivedParser;
-			try {
-				const sourceValue = options.defaultValue();
-				derivedParser = options.factory(sourceValue);
-			} catch {
-				return String(value);
-			}
-			return derivedParser.format(value);
-		},
-		async *suggest(prefix) {
-			let derivedParser;
-			try {
-				const sourceValue = options.defaultValue();
-				derivedParser = options.factory(sourceValue);
-			} catch {
-				return;
-			}
-			if (derivedParser.suggest) for await (const suggestion of derivedParser.suggest(prefix)) yield suggestion;
-		},
-		async *[suggestWithDependency](prefix, dependencyValue) {
-			let derivedParser;
-			try {
-				derivedParser = options.factory(dependencyValue);
-			} catch {
-				try {
-					derivedParser = options.factory(options.defaultValue());
-				} catch {
-					return;
-				}
-			}
-			if (derivedParser.suggest) for await (const suggestion of derivedParser.suggest(prefix)) yield suggestion;
-		}
-	};
-}
-/**
-* Creates an async derived parser when the source is async but the factory
-* returns a sync parser. The sync result is wrapped in a Promise.
-*/
-function createAsyncDerivedParserFromSyncFactory(sourceId, options) {
-	return {
-		$mode: "async",
-		metavar: options.metavar,
-		[derivedValueParserMarker]: true,
-		[dependencyId]: sourceId,
-		parse(input) {
-			let derivedParser;
-			try {
-				const sourceValue = options.defaultValue();
-				derivedParser = options.factory(sourceValue);
-			} catch (e) {
-				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
-					success: false,
-					error: require_message.message`Derived parser error: ${msg}`
-				});
-			}
-			return Promise.resolve(derivedParser.parse(input));
-		},
-		[parseWithDependency](input, dependencyValue) {
-			let derivedParser;
-			try {
-				derivedParser = options.factory(dependencyValue);
-			} catch (e) {
-				const msg = e instanceof Error ? e.message : String(e);
-				return Promise.resolve({
-					success: false,
-					error: require_message.message`Factory error: ${msg}`
-				});
-			}
-			return Promise.resolve(derivedParser.parse(input));
-		},
-		format(value) {
-			let derivedParser;
-			try {
-				const sourceValue = options.defaultValue();
-				derivedParser = options.factory(sourceValue);
-			} catch {
-				return String(value);
-			}
-			return derivedParser.format(value);
-		},
-		async *suggest(prefix) {
-			let derivedParser;
-			try {
-				const sourceValue = options.defaultValue();
-				derivedParser = options.factory(sourceValue);
-			} catch {
-				return;
-			}
-			if (derivedParser.suggest) yield* derivedParser.suggest(prefix);
-		},
-		*[suggestWithDependency](prefix, dependencyValue) {
-			let derivedParser;
-			try {
-				derivedParser = options.factory(dependencyValue);
-			} catch {
-				try {
-					derivedParser = options.factory(options.defaultValue());
-				} catch {
-					return;
-				}
-			}
-			if (derivedParser.suggest) yield* derivedParser.suggest(prefix);
-		}
-	};
-}
-/**
-* A unique symbol used to identify deferred parse states.
-* @since 0.10.0
-*/
-const deferredParseMarker = Symbol.for("@optique/core/dependency/deferredParseMarker");
-/**
-* Checks if a value is a {@link DeferredParseState}.
-*
-* @param value The value to check.
-* @returns `true` if the value is a deferred parse state, `false` otherwise.
-* @since 0.10.0
-*/
-function isDeferredParseState(value) {
-	return typeof value === "object" && value !== null && deferredParseMarker in value && value[deferredParseMarker] === true;
-}
-/**
-* Gets all dependency IDs from a derived parser.
-* If the parser was created with `deriveFrom` (multiple dependencies),
-* returns the array of dependency IDs. Otherwise, returns an array
-* containing the single dependency ID.
-*
-* @param parser The derived value parser to get dependency IDs from.
-* @returns An array of dependency ID symbols.
-* @internal
-* @since 0.10.0
-*/
-function getDependencyIds(parser) {
-	if (dependencyIds in parser) return parser[dependencyIds];
-	return [parser[dependencyId]];
-}
-/**
-* Gets the default values function from a derived parser, if present.
-* This function is available on parsers created with `deriveFrom` that
-* specify default values for their dependencies.
-*
-* @param parser The derived value parser to get the default values function from.
-* @returns The default values function, or undefined if not available.
-* @internal
-* @since 0.10.0
-*/
-function getDefaultValuesFunction(parser) {
-	if (defaultValues in parser) return parser[defaultValues];
-	return void 0;
-}
-/**
-* Creates a deferred parse state for a DerivedValueParser.
-*
-* @template T The type of value the parser will produce.
-* @template S The type of the source dependency value.
-* @param rawInput The raw input string to be parsed.
-* @param parser The DerivedValueParser that will parse the input.
-* @param preliminaryResult The parse result using default dependency value.
-* @returns A DeferredParseState object.
-* @since 0.10.0
-*/
-function createDeferredParseState(rawInput, parser, preliminaryResult) {
-	const multipleIds = dependencyIds in parser ? parser[dependencyIds] : void 0;
-	const defaultValuesFn = defaultValues in parser ? parser[defaultValues] : void 0;
-	const defaultVals = defaultValuesFn ? defaultValuesFn() : void 0;
-	return {
-		[deferredParseMarker]: true,
-		rawInput,
-		parser,
-		dependencyId: parser[dependencyId],
-		dependencyIds: multipleIds,
-		defaultValues: defaultVals,
-		preliminaryResult
-	};
-}
-/**
-* A unique symbol used to identify dependency source parse states.
-* @since 0.10.0
-*/
-const dependencySourceStateMarker = Symbol.for("@optique/core/dependency/dependencySourceStateMarker");
-/**
-* Checks if a value is a {@link DependencySourceState}.
-*
-* @param value The value to check.
-* @returns `true` if the value is a dependency source state, `false` otherwise.
-* @since 0.10.0
-*/
-function isDependencySourceState(value) {
-	return typeof value === "object" && value !== null && dependencySourceStateMarker in value && value[dependencySourceStateMarker] === true;
-}
-/**
-* Creates a dependency source state from a parse result.
-*
-* @template T The type of value the state contains.
-* @param result The parse result.
-* @param depId The dependency ID.
-* @returns A DependencySourceState object.
-* @since 0.10.0
-*/
-function createDependencySourceState(result, depId) {
-	return {
-		[dependencySourceStateMarker]: true,
-		[dependencyId]: depId,
-		result
-	};
-}
-/**
-* A unique symbol used to identify pending dependency source states.
-* @since 0.10.0
-*/
-const pendingDependencySourceStateMarker = Symbol.for("@optique/core/dependency/pendingDependencySourceStateMarker");
-/**
-* Checks if a value is a {@link PendingDependencySourceState}.
-*
-* @param value The value to check.
-* @returns `true` if the value is a pending dependency source state.
-* @since 0.10.0
-*/
-function isPendingDependencySourceState(value) {
-	return typeof value === "object" && value !== null && pendingDependencySourceStateMarker in value && value[pendingDependencySourceStateMarker] === true;
-}
-/**
-* Creates a pending dependency source state.
-*
-* @param depId The dependency ID.
-* @returns A PendingDependencySourceState object.
-* @since 0.10.0
-*/
-function createPendingDependencySourceState(depId) {
-	return {
-		[pendingDependencySourceStateMarker]: true,
-		[dependencyId]: depId
-	};
-}
-/**
-* A unique symbol used to identify parsers that wrap a dependency source.
-* This is used by withDefault to indicate it contains an inner parser
-* with a PendingDependencySourceState initialState.
-* @since 0.10.0
-*/
-const wrappedDependencySourceMarker = Symbol.for("@optique/core/dependency/wrappedDependencySourceMarker");
-/**
-* A unique symbol used to indicate that a wrapper transforms the dependency
-* source value. This is used by withDefault to determine whether its default
-* value should be registered as the dependency value.
-*
-* When a wrapper has this marker set to `true`, it means the wrapper transforms
-* the dependency source value (e.g., via map()), so the wrapper's output is NOT
-* a valid dependency source value.
-*
-* @since 0.10.0
-*/
-const transformsDependencyValueMarker = Symbol.for("@optique/core/dependency/transformsDependencyValueMarker");
-/**
-* Checks if a parser transforms the dependency value (has transformsDependencyValueMarker).
-*
-* @param parser The parser to check.
-* @returns `true` if the parser transforms the dependency value.
-* @since 0.10.0
-*/
-function transformsDependencyValue(parser) {
-	return typeof parser === "object" && parser !== null && transformsDependencyValueMarker in parser && parser[transformsDependencyValueMarker] === true;
-}
-/**
-* Checks if a parser wraps a dependency source (has wrappedDependencySourceMarker).
-*
-* @param parser The parser to check.
-* @returns `true` if the parser wraps a dependency source.
-* @since 0.10.0
-*/
-function isWrappedDependencySource(parser) {
-	return typeof parser === "object" && parser !== null && wrappedDependencySourceMarker in parser;
-}
-/**
-* A registry for storing resolved dependency values during parsing.
-* This is used to pass dependency values from DependencySource options
-* to DerivedValueParser options.
-* @since 0.10.0
-*/
-var DependencyRegistry = class DependencyRegistry {
-	values = /* @__PURE__ */ new Map();
-	/**
-	* Registers a resolved dependency value.
-	* @param id The dependency ID.
-	* @param value The resolved value.
-	*/
-	set(id, value) {
-		this.values.set(id, value);
-	}
-	/**
-	* Gets a resolved dependency value.
-	* @param id The dependency ID.
-	* @returns The resolved value, or undefined if not found.
-	*/
-	get(id) {
-		return this.values.get(id);
-	}
-	/**
-	* Checks if a dependency has been resolved.
-	* @param id The dependency ID.
-	* @returns `true` if the dependency has been resolved.
-	*/
-	has(id) {
-		return this.values.has(id);
-	}
-	/**
-	* Creates a copy of the registry.
-	*/
-	clone() {
-		const copy = new DependencyRegistry();
-		for (const [id, value] of this.values) copy.values.set(id, value);
-		return copy;
-	}
-};
-/**
-* Formats a {@link DependencyError} into a human-readable {@link Message}.
-*
-* @param error The dependency error to format.
-* @returns A Message describing the error.
-* @since 0.10.0
-*/
-function formatDependencyError(error) {
-	switch (error.kind) {
-		case "duplicate": return [{
-			type: "text",
-			text: `Dependency used in multiple locations: ${error.locations.join(", ")}.`
-		}];
-		case "unresolved": return [{
-			type: "text",
-			text: `Unresolved dependency for ${error.derivedParserMetavar}: the dependency was not provided.`
-		}];
-		case "circular": return [{
-			type: "text",
-			text: `Circular dependency detected.`
-		}];
-	}
-}
-
-//#endregion
-exports.DependencyRegistry = DependencyRegistry;
-exports.createDeferredParseState = createDeferredParseState;
-exports.createDependencySourceState = createDependencySourceState;
-exports.createPendingDependencySourceState = createPendingDependencySourceState;
-exports.defaultValues = defaultValues;
-exports.deferredParseMarker = deferredParseMarker;
-exports.dependency = dependency;
-exports.dependencyId = dependencyId;
-exports.dependencyIds = dependencyIds;
-exports.dependencySourceMarker = dependencySourceMarker;
-exports.dependencySourceStateMarker = dependencySourceStateMarker;
-exports.deriveFrom = deriveFrom;
-exports.deriveFromAsync = deriveFromAsync;
-exports.deriveFromSync = deriveFromSync;
-exports.derivedValueParserMarker = derivedValueParserMarker;
-exports.formatDependencyError = formatDependencyError;
-exports.getDefaultValuesFunction = getDefaultValuesFunction;
-exports.getDependencyIds = getDependencyIds;
-exports.isDeferredParseState = isDeferredParseState;
-exports.isDependencySource = isDependencySource;
-exports.isDependencySourceState = isDependencySourceState;
-exports.isDerivedValueParser = isDerivedValueParser;
-exports.isPendingDependencySourceState = isPendingDependencySourceState;
-exports.isWrappedDependencySource = isWrappedDependencySource;
-exports.parseWithDependency = parseWithDependency;
-exports.pendingDependencySourceStateMarker = pendingDependencySourceStateMarker;
-exports.suggestWithDependency = suggestWithDependency;
-exports.transformsDependencyValue = transformsDependencyValue;
-exports.transformsDependencyValueMarker = transformsDependencyValueMarker;
-exports.wrappedDependencySourceMarker = wrappedDependencySourceMarker;
+exports.dependency = require_dependency.dependency;
+exports.deriveFrom = require_dependency.deriveFrom;
+exports.deriveFromAsync = require_dependency.deriveFromAsync;
+exports.deriveFromSync = require_dependency.deriveFromSync;
+exports.isDependencySource = require_dependency.isDependencySource;
+exports.isDerivedValueParser = require_dependency.isDerivedValueParser;