Function applyTemplateToNote

src/engine/applyTemplateToActiveNote.ts:116–230

(
	app: App,
	plugin: QuickAdd,
	params: ApplyTemplateToNoteParams,
)

 * and "bottom" otherwise.
 */
export async function applyTemplateToNote(
	app: App,
	plugin: QuickAdd,
	params: ApplyTemplateToNoteParams,
): Promise<TFile | null> {
	const file = params.file ?? app.workspace.getActiveFile();
	if (!file || file.extension !== "md") {
		new Notice("QuickAdd: No active markdown note to apply a template to.");
		return null;
	}

	// This path runs a template through the executor WITHOUT going through
	// ChoiceExecutor.execute(), so beginExecutionContext() never captures the
	// trigger context. Seed it here so {{FIELD:<field>|default-from:active}} in
	// the applied template can read the note being applied to (issue #1429): the
	// active note for the command, or the explicit params.file for the API path.
	// Seed only when absent (never clobber a caller-supplied context) and restore
	// the prior value in `finally`, so a reused executor — e.g. a script applying
	// templates to several notes in turn, or a later `format()` on the same API
	// object — never inherits this call's note for a subsequent default-from:active.
	const previousTriggerContext = params.choiceExecutor.triggerContext;
	if (previousTriggerContext == null) {
		params.choiceExecutor.triggerContext = { activeFile: file };
	}

	try {
		const interactive = !params.templatePath;
		let source: TemplatePickerItem;
		if (params.templatePath) {
			source = { kind: "file", path: params.templatePath };
		} else {
			const picked = await pickTemplate(app, plugin);
			if (!picked) return null;
			source = picked;
		}

		const templatePath =
			source.kind === "choice" ? source.choice.templatePath : source.path;

		if (!isMarkdownTemplatePath(templatePath)) {
			new Notice(
				"QuickAdd: Only markdown templates can be applied to a note. Canvas and base templates create their own file types.",
			);
			return null;
		}

		const noteContent = await app.vault.cachedRead(file);
		const noteIsEmpty = isNoteEffectivelyEmpty(noteContent);

		let mode: TemplateInsertModeId;
		if (params.mode) {
			mode = params.mode;
		} else if (noteIsEmpty) {
			// Empty-note fast path: the most common case is a freshly created
			// blank note, so skip the mode picker and apply the template as-is.
			mode = "replace";
		} else if (!interactive) {
			mode = "bottom";