Function replaceFileInString

src/formatters/formatter.ts:1053–1098

* Resolve {{FILE: |...}} tokens: prompt once per identity (full token, * or the shared `|name:` key), cache the chosen file, and render each * occurrence by mode (basename / wikilink / path). Uses the non-mutating * accumulator scan of replaceFieldVarInString — not the in-place splice —

(input: string)

	 * unresolved/empty token can be emitted literally without re-scan loops.
	 */
	protected async replaceFileInString(input: string): Promise<string> {
		const regex = new RegExp(FILE_REGEX.source, "gi");
		let output = "";
		let lastIndex = 0;
		let match: RegExpExecArray | null;

		while ((match = regex.exec(input)) !== null) {
			output += input.slice(lastIndex, match.index);

			const parsed = parseFileToken(match[1] ?? "");
			if (!parsed) {
				// Empty folder / malformed: leave the token literal and move on.
				output += match[0];
				lastIndex = regex.lastIndex;
				continue;
			}

			const key = parsed.variableKey;
			if (!this.hasConcreteVariable(key)) {
				this.variables.set(key, await this.suggestForFile(parsed));
			}

			const renderedValue = renderStoredFileValue(
				this.variables.get(key),
				parsed.mode,
				(stored) => this.getFileLinkForStoredValue(stored),
			);
			if (Array.isArray(renderedValue)) {
				const structuredYamlValue = this.propertyCollector.maybeCollect({
					input,
					matchStart: match.index,
					matchEnd: match.index + match[0].length,
					rawValue: renderedValue,
					fallbackKey: parsed.aliasName ?? parsed.folderPath,
					collectionActive: this.templatePropertyCollectionDepth > 0,
					heuristicEnabled: false,
				});
				output += getYamlPlaceholder(structuredYamlValue) ?? renderedValue.join(",");
			} else {
				output += renderedValue;
			}
			lastIndex = regex.lastIndex;
		}

		return output + input.slice(lastIndex);
	}

	/**
	 * Render a stored FILE value as a wikilink. Only a real pick from the filtered