Function parseValueToken

src/utils/valueSyntax.ts:682–860

(
	raw: string,
	opts?: { quiet?: boolean },
)

}

export function parseValueToken(
	raw: string,
	opts?: { quiet?: boolean },
): ParsedValueToken | null {
	if (!raw) return null;
	const quiet = opts?.quiet ?? false;

	const parts = splitPipeParts(raw);
	const variablePart = (parts.shift() ?? "").trim();
	if (!variablePart) return null;

	const suggestedValues = splitQuotedCommaList(variablePart)
		.map((value) => value.trim())
		.filter(Boolean);
	const hasOptions = suggestedValues.length > 1;

	const {
		remaining: optionParts,
		optional: bareOptional,
		trim: bareTrim,
	} = extractBareValueFlags(parts);
	const options = parseOptions(optionParts, hasOptions, true, quiet);
	let { label, caseStyle, defaultValue, allowCustomInput } = options;
	let multiSelect = options.multiSelect ?? false;
	const multiEmit: MultiEmit = options.multiEmit ?? "text";
	const optional = options.optionalExplicit ?? bareOptional;
	const trim = options.trimExplicit ?? bareTrim;

	if (!options.usesOptions) {
		const legacyDefault = defaultValue;
		allowCustomInput = hasOptions && legacyDefault.toLowerCase() === "custom";
		defaultValue = allowCustomInput ? "" : legacyDefault;
	}

	// Option-list defaults may contain a comma, which is only expressible as a
	// quoted value (|default:"a, b"); unwrap it so it matches its now-unquoted
	// option in both the preflight form and the runtime empty-submission fallback.
	if (hasOptions && defaultValue) {
		defaultValue = unwrapQuotedValue(defaultValue);
	}

	const tokenDisplay = `{{VALUE:${raw}}}`;
	const inputTypeOverride = resolveInputType(
		options.inputTypeOverride,
		{
			tokenDisplay,
			hasOptions,
			allowCustomInput,
		},
		quiet,
	);
	const numericInput = resolveNumericInput(
		options,
		tokenDisplay,
		inputTypeOverride,
		quiet,
	);
	let displayValues: string[] | undefined;