Function buildFileDisplayInfos

src/utils/fileSyntax.ts:296–328

(
	files: TFile[],
	metadataCache?: (file: TFile) => CachedMetadata | null,
)

}

export function buildFileDisplayInfos(
	files: TFile[],
	metadataCache?: (file: TFile) => CachedMetadata | null,
): FileDisplayInfo[] {
	const baseLabels = files.map((file) => {
		const metadata = metadataCache?.(file) ?? null;
		const basename = basenameFor(file);
		const primary =
			frontmatterTitle(metadata?.frontmatter as Record<string, unknown> | undefined) ??
			firstLevelHeading(metadata) ??
			basename;
		const label = primary === basename
			? basename
			: `${primary} (${basename})`;
		return { file, primary, label };
	});

	const counts = new Map<string, number>();
	for (const { label } of baseLabels) {
		counts.set(label, (counts.get(label) ?? 0) + 1);
	}

	return baseLabels.map(({ file, primary, label }) => {
		const uniqueLabel = (counts.get(label) ?? 0) <= 1
			? label
			: `${label} - ${parentLabel(file)}`;
		return {
			primary,
			secondary: file.path,
			label: uniqueLabel,
		};
	});
}

/**
 * Display labels for a folder's files: readable title/H1 labels first, with the