Function overwriteFileWithTemplate

src/engine/TemplateEngine.ts:659–706

(
		file: TFile,
		resolvedTemplatePath: string
	)

	protected async overwriteFileWithTemplate(
		file: TFile,
		resolvedTemplatePath: string
	) {
		try {
			const templateContent: string = await this.getTemplateContent(
				resolvedTemplatePath
			);

			// Use the existing file's basename as the title
			const fileBasename = file.basename;
			this.formatter.setTitle(fileBasename);
			// {{FOLDER}} reflects the existing file's folder, which can differ
			// from the choice's configured folder.
			this.formatter.setTargetFolderPath(parentFolderPath(file.path));

			const formattedTemplateContent: string =
				await this.formatter.withTemplatePropertyCollection(() =>
					this.formatter.formatFileContent(templateContent),
				);

			// Get template variables before modifying the file
			const templateVars = this.formatter.getAndClearTemplatePropertyVars();

			log.logMessage(`TemplateEngine.overwriteFileWithTemplate: Collected ${templateVars.size} template property variables for ${file.path}`);
			if (templateVars.size > 0) {
				log.logMessage(`Variables: ${Array.from(templateVars.keys()).join(', ')}`);
			}

			await this.app.vault.modify(file, formattedTemplateContent);

			// Post-process front matter for template property types BEFORE Templater
			if (shouldPostProcessFrontMatter(file, templateVars)) {
				await postProcessFrontMatter(this.app, file, templateVars);
			}

			// Process Templater commands
			await overwriteTemplaterOnce(this.app, file);

			return file;
		} catch (err) {
			if (isMacroAbortError(err)) {
				throw err;
			}
			reportError(err, "Could not overwrite file with template");
			return null;
		}
	}

	protected async appendToFileWithTemplate(
		file: TFile,