@optique/core 1.4.0-dev.2607 → 1.4.0-dev.2608

package/dist/short-option.js

@@ -1,186 +0,0 @@
-import { inheritAnnotations } from "./internal/annotations.js";
-import { extractOptionNames } from "./usage.js";
-import { collectOptionNamesAtCurrentCommandDepth } from "./usage-internals.js";
-
-//#region src/short-option.ts
-const optionScopeKey = Symbol("optionScope");
-const scopeSourceKey = Symbol("optionScopeSource");
-const primitiveScopes = /* @__PURE__ */ new WeakMap();
-function parserScope(parser) {
-	const declared = parser[scopeSourceKey];
-	if (declared != null) return declared;
-	let source = primitiveScopes.get(parser);
-	if (source == null) {
-		source = (_selections, arities) => {
-			if (arities != null) collectOptionNamesAtCurrentCommandDepth(parser.usage, arities, false);
-			return parser.leadingNames;
-		};
-		primitiveScopes.set(parser, source);
-	}
-	return source;
-}
-/** Combines declarations without flattening conditional ownership. @internal */
-function combinedOptionScope(parsers) {
-	return (selections, arities, context) => new Set(parsers.flatMap((parser) => [...parserScope(parser)(selections, arities, context)]));
-}
-/** Tracks declarations after a command or discriminator routes input. @internal */
-function selectableOptionScope(initial) {
-	const source = (selections, arities, context) => (selections.get(source) ?? initial)(selections, arities, context);
-	return {
-		source,
-		select(context, selected) {
-			context[optionScopeKey]?.selections.set(source, selected);
-		}
-	};
-}
-/** Keeps selected conditional names distinct from sibling declarations. @internal */
-function conditionalOptionScope(discriminator, fallback, candidates = []) {
-	const scope = selectableOptionScope((selections, arities, context) => {
-		const canSkip = discriminator.canSkip?.(context == null ? discriminator.initialState : inheritAnnotations(context.state, discriminator.initialState), context?.exec) === true;
-		return combinedOptionScope([
-			discriminator,
-			...canSkip ? candidates : [],
-			...fallback == null ? [] : [fallback]
-		])(selections, arities, context);
-	});
-	return {
-		source: scope.source,
-		select(context, branch) {
-			scope.select(context, combinedOptionScope([discriminator, branch]));
-		}
-	};
-}
-/** Returns the names reachable in this parse scope. @internal */
-function getOptionScope(context) {
-	const scoped = context[optionScopeKey];
-	const names = scoped == null ? extractOptionNames(context.usage, true) : new Set([...scoped.names, ...[...scoped.sources].flatMap((source) => [...source(scoped.selections, void 0, context)])]);
-	return names;
-}
-/** Adds reachable names without consulting the flattened help tree. @internal */
-function withOptionScope(context, names) {
-	const inherited = context[optionScopeKey];
-	return {
-		...context,
-		[optionScopeKey]: {
-			names: new Set([...inherited?.names ?? [], ...names]),
-			sources: inherited?.sources ?? /* @__PURE__ */ new Set(),
-			selections: inherited?.selections ?? /* @__PURE__ */ new Map()
-		}
-	};
-}
-/** Adds a parser's owned declarations, retaining modifier metadata. @internal */
-function withParserOptionScope(context, parser) {
-	const inherited = context[optionScopeKey];
-	return {
-		...context,
-		[optionScopeKey]: {
-			names: inherited?.names ?? /* @__PURE__ */ new Set(),
-			sources: new Set([...inherited?.sources ?? [], parserScope(parser)]),
-			selections: inherited?.selections ?? /* @__PURE__ */ new Map()
-		}
-	};
-}
-/** Isolates route selections while probing a competing branch. @internal */
-function forkOptionScope(context) {
-	const scoped = context[optionScopeKey];
-	return scoped == null ? context : {
-		...context,
-		[optionScopeKey]: {
-			...scoped,
-			selections: new Map(scoped.selections)
-		}
-	};
-}
-/** Publishes winning routes without persisting temporary candidate names. @internal */
-function adoptOptionScope(context, next) {
-	const own = context[optionScopeKey];
-	const child = next[optionScopeKey];
-	if (own != null && child != null) for (const [source, selected] of child.selections) own.selections.set(source, selected);
-	return context;
-}
-/** Removes names reserved only for a speculative probe. @internal */
-function restoreOptionScope(next, parent) {
-	adoptOptionScope(parent, next);
-	const own = parent[optionScopeKey];
-	const child = next[optionScopeKey];
-	return own == null || child == null ? next : {
-		...next,
-		[optionScopeKey]: {
-			...child,
-			names: own.names,
-			selections: own.selections
-		}
-	};
-}
-/** Decorates construct entry points while retaining internal metadata. @internal */
-function scopeParser(parser, source = () => parser.leadingNames, prepare) {
-	const parse = parser.parse;
-	const suggest = parser.suggest;
-	Object.defineProperties(parser, {
-		[scopeSourceKey]: {
-			value: source,
-			enumerable: true
-		},
-		parse: {
-			enumerable: true,
-			configurable: true,
-			writable: true,
-			value: (context) => {
-				const scoped = withParserOptionScope(context, parser);
-				prepare?.(scoped);
-				return parse.call(parser, scoped);
-			}
-		},
-		suggest: {
-			enumerable: true,
-			configurable: true,
-			writable: true,
-			value: (context, prefix) => {
-				const scoped = withParserOptionScope(context, parser);
-				prepare?.(scoped);
-				return suggest.call(parser, scoped, prefix);
-			}
-		}
-	});
-	return parser;
-}
-/** Tests full-name ownership before splitting a short prefix. @internal */
-function fullNameOwnsToken(context, token) {
-	if (!/^-[^-]/.test(token)) return false;
-	for (const name of getOptionScope(context)) if (name.startsWith("-") && !name.startsWith("--") && name.length > 2 && (token === name || token.startsWith(`${name}=`))) return true;
-	return false;
-}
-/** Finds the value part of an attached short-option completion. @internal */
-function attachedValuePrefix(context, prefix, optionNames) {
-	if (!/^-[^-]/.test(prefix)) return void 0;
-	const scope = getOptionScope(context);
-	const names = {
-		value: /* @__PURE__ */ new Set(),
-		flag: /* @__PURE__ */ new Set()
-	};
-	const scoped = context[optionScopeKey];
-	if (scoped == null) collectOptionNamesAtCurrentCommandDepth(context.usage, names, false);
-	else for (const source of scoped.sources) source(scoped.selections, names, context);
-	for (let index = 1; index < prefix.length; index++) {
-		const remainder = `-${prefix.slice(index)}`;
-		for (const name of scope) if (name.startsWith("-") && !name.startsWith("--") && name.length > 2 && (name.startsWith(remainder) || remainder.startsWith(`${name}=`))) return void 0;
-		const short = `-${prefix[index]}`;
-		if (optionNames.includes(short)) return {
-			head: prefix.slice(0, index + 1),
-			value: prefix.slice(index + 1)
-		};
-		if (!scope.has(short) || !names.flag.has(short) || names.value.has(short)) return void 0;
-	}
-	return void 0;
-}
-/** Preserves the prefix when embedding value suggestions in one token. @internal */
-function prefixSuggestion(head, suggestion) {
-	return {
-		kind: "literal",
-		text: head + (suggestion.kind === "literal" ? suggestion.text : suggestion.pattern ?? ""),
-		...suggestion.description != null ? { description: suggestion.description } : {}
-	};
-}
-
-//#endregion
-export { adoptOptionScope, attachedValuePrefix, combinedOptionScope, conditionalOptionScope, forkOptionScope, fullNameOwnsToken, prefixSuggestion, restoreOptionScope, scopeParser, selectableOptionScope, withOptionScope, withParserOptionScope };