Function ensureDefaultBasesViewFiles

src/bootstrap/defaultBasesFiles.ts:56–122

(
	host: DefaultBasesFileHost,
	options: DefaultBasesFileOptions = {}
)

}

export async function ensureDefaultBasesViewFiles(
	host: DefaultBasesFileHost,
	options: DefaultBasesFileOptions = {}
): Promise<DefaultBasesFileResult> {
	const created: string[] = [];
	const updated: string[] = [];
	const skipped: string[] = [];
	const overwriteExisting = options.overwriteExisting === true;

	try {
		const vault = host.app.vault;
		const adapter = vault.adapter;
		const commandFileMapping = {
			...DEFAULT_SETTINGS.commandFileMapping,
			...(host.settings.commandFileMapping ?? {}),
		};
		host.settings.commandFileMapping = commandFileMapping;

		for (const [commandId, rawPath] of Object.entries(commandFileMapping)) {
			if (!rawPath) {
				continue;
			}

			const normalizedPath = normalizePath(rawPath);
			const template = host.generateTemplate(commandId);
			if (!template) {
				skipped.push(rawPath);
				continue;
			}

			if (await adapter.exists(normalizedPath)) {
				if (!overwriteExisting) {
					skipped.push(rawPath);
					continue;
				}

				const existing = vault.getAbstractFileByPath(normalizedPath);
				if (!(existing instanceof TFile)) {
					host.warn?.(
						`[TaskNotes][Bases] Cannot update default Bases file because path is not a file: ${normalizedPath}`
					);
					skipped.push(rawPath);
					continue;
				}

				await vault.modify(existing, template);
				updated.push(rawPath);
				continue;
			}

			const lastSlashIndex = normalizedPath.lastIndexOf("/");
			const directory =
				lastSlashIndex >= 0 ? normalizedPath.substring(0, lastSlashIndex) : "";

			if (directory) {
				await ensureFolderHierarchy(vault, directory);
			}