Function replaceValueInString

src/formatters/formatter.ts:270–323

(input: string)

	protected abstract promptForValue(header?: string): Promise<string> | string;

	protected async replaceValueInString(input: string): Promise<string> {
		let output: string = input;

		// Fast path: nothing to do.
		if (!NAME_VALUE_REGEX.test(output)) return output;

		this.valuePromptContext = this.getValuePromptContext(output);

		// Preserve programmatic VALUE injection via reserved variable name `value`.
		if (this.hasConcreteVariable("value")) {
			const existingValue = this.variables.get("value");
			this.value = formatUnknownValue(existingValue);
		}

		// Prompt only once per formatter run (empty string is a valid value).
		if (this.value === undefined) {
			this.value = await this.promptForValue();
		}

		// Replace all occurrences in a single non-recursive pass.
		// Important: use a replacer function so `$` in user input is treated literally.
		const regex = new RegExp(NAME_VALUE_REGEX.source, "gi");
		output = output.replace(regex, (...args) => {
			const token = args[0];
			const offset = args[args.length - 2] as number;
			const source = args[args.length - 1] as string;
			const inner = token.slice(2, -2);
			const optionsIndex = inner.indexOf("|");
			if (optionsIndex === -1) return this.value;
			const rawOptions = inner.slice(optionsIndex);
			const parsed = parseAnonymousValueOptions(rawOptions);
			// Apply |default on an empty submission, mirroring the named path
			// (ensureValueVariableResolved): the |default pre-fills the prompt, but
			// a user who clears the box should still get the default unless the
			// token is |optional (an optional empty is taken at face value).
			const effectiveValue =
				this.value === "" && parsed.defaultValue && !parsed.optional
					? parsed.defaultValue
					: this.value;
			const transformed = this.applyValueTextOptions(effectiveValue, parsed);
			// |type:text on the anonymous {{VALUE|...}} form quotes the same way
			// as the named form (see replaceVariableInString).
			if (
				parsed.inputTypeOverride === "text" &&
				transformed !== "" &&
				shouldQuoteTextScalar(source, offset, offset + token.length)
			) {
				return quoteYamlDouble(transformed);
			}
			return transformed;
		});

		return output;
	}

	private applyValueTextOptions(
		value: unknown,