Function replaceVariableInString

src/formatters/formatter.ts:891–982

(input: string)

	}

	protected async replaceVariableInString(input: string) {
		let output = input;

		// Pass 1: resolve named suggester definitions up front (see above).
		await this.resolveNamedSuggesterDefinitions(output);

		// Pass 2: replace every VALUE token in document order.
		const regex = new RegExp(VARIABLE_REGEX.source, 'gi'); // preserve case-insensitive + global
		const propertyTypesEnabled = this.isTemplatePropertyTypesEnabled();
		let match: RegExpExecArray | null;

		while ((match = regex.exec(output)) !== null) {
			if (!match[1]) {
				throw new Error(`Unable to parse variable. Invalid syntax in: "${output.substring(Math.max(0, match.index - 10), Math.min(output.length, match.index + 30))}..."`);
			}

			const parsed = parseValueToken(match[1]);
			if (!parsed) {
				throw new Error(`Unable to parse variable. Invalid syntax in: "${output.substring(Math.max(0, match.index - 10), Math.min(output.length, match.index + 30))}..."`);
			}

			const { variableName } = parsed;

			const effectiveKey = await this.ensureValueVariableResolved(parsed);

			// Get the raw value from variables
			const rawValue = this.variables.get(effectiveKey);
			const effectiveRawValue = this.applyValueTokenOptions(rawValue, parsed);

			// Offer this variable to the property collector for YAML post-processing.
			// Collecting structured values (arrays/objects/numbers/booleans) into a
			// processFrontMatter pass is always-on inside a collection scope so that
			// scripts returning real arrays produce valid YAML regardless of the
			// beta toggle. Only the string -> structured *heuristic* is flag-gated.
			const collectionActive = this.templatePropertyCollectionDepth > 0;
			const structuredYamlValue = this.propertyCollector.maybeCollect({
				input: output,
				matchStart: match.index,
				matchEnd: match.index + match[0].length,
				rawValue: effectiveRawValue,
				fallbackKey: variableName,
				collectionActive,
				// |type:text forces a string: never run the string->structured
				// heuristic on it, or a comma/bracket value (`a,b`, `[x]`) would be
				// collected as a List and bypass the quoting path below.
				heuristicEnabled:
					propertyTypesEnabled &&
					collectionActive &&
					parsed.inputTypeOverride !== "text",
			});

			// Keep the interim frontmatter YAML-parseable until post-processing
			// writes the real structured value back through Obsidian. Coerce the
			// fallback replacement to a string so non-string variable values (e.g.
			// arrays from scripts on the non-collected path) don't desync the scanner.
			const placeholder = getYamlPlaceholder(structuredYamlValue);
			let replacement: string;
			if (placeholder !== undefined) {