Method suggestForFile

src/formatters/completeFormatter.ts:904–1022

(parsed: ParsedFileToken)

	}

	protected async suggestForFile(parsed: ParsedFileToken): Promise<string | string[]> {
		this.assertInteractivePrompt(
			`{{FILE}} (pick a file from ${parsed.folderPath})`,
		);
		// Route the final picker to a remote interactive session (Raycast) when one
		// is driving; the vault-side file filtering below still runs unchanged.
		const provider = this.choiceExecutor?.promptProvider;
		try {
			const files = EnhancedFieldSuggestionFileFilter.filterFiles(
				this.app.vault.getMarkdownFiles(),
				parsed.filter,
				(file) => this.app.metadataCache.getFileCache(file),
			);

			const placeholder =
				parsed.label ?? `Select a file from ${parsed.folderPath}`;

			// Empty folder (or no match): fall back to free-text so a capture never
			// dead-ends, mirroring suggestForField. A typed value is stored as custom
			// (never resolved to a real file); an empty/skip stays "".
			if (files.length === 0) {
				const description = `No markdown files found in "${parsed.folderPath}". Type a value or leave empty.`;
				const typed = provider
					? await provider.inputPrompt(placeholder, description)
					: await GenericInputPrompt.Prompt(
							this.app,
							placeholder,
							description,
							undefined,
							undefined,
							parsed.optional ? { optional: true } : undefined,
						);
				if (parsed.multiSelect) {
					return typed ? [`${FILE_CUSTOM_PREFIX}${typed}`] : [];
				}
				return typed ? `${FILE_CUSTOM_PREFIX}${typed}` : "";
			}

			const displayItems = buildFileDisplayLabels(
				files,
				(file) => this.app.metadataCache.getFileCache(file),
			);
			const items = files.map((file) => `${FILE_PICK_PREFIX}${file.path}`);

			if (parsed.multiSelect) {
				const result = provider
					? await provider.suggesterMulti(displayItems, items, {
							placeholder,
							allowCustomInput: parsed.allowCustomInput,
						})
					: await MultiSuggester.Suggest(this.app, displayItems, items, {
							placeholder,
							allowCustomValue: parsed.allowCustomInput,
							...(parsed.optional ? { skippable: true } : {}),
						});
				return result.map((item) =>
					items.includes(item) ? item : `${FILE_CUSTOM_PREFIX}${item}`,
				);