Method applyToFile

src/bulk/bulkMetadataEditor.ts:186–222

(
		file: TFile,
		key: string,
		rawValue: string,
		policy: ConflictPolicy,
		wrapInArray: boolean,
	)

	}

	private async applyToFile(
		file: TFile,
		key: string,
		rawValue: string,
		policy: ConflictPolicy,
		wrapInArray: boolean,
	): Promise<BulkOutcome> {
		// Defense in depth at the write boundary: `apply` already rejects reserved
		// keys before the loop, but `applyToFile` is reachable on its own (TS
		// `private` is not runtime-private and `plugin.bulkEditor` is public), so
		// fail closed here too rather than letting a reserved key reach the
		// `frontmatter[key] = ...` assignment below.
		this.assertWritableKey(key);

		let outcome: BulkOutcome = "skipped";

		// Serialize through the controller's per-file write queue so this write is
		// never lost to a concurrent controller `vault.read`+`vault.modify` edit to
		// the same note (see the module docstring). The decision is still made
		// against live frontmatter inside the single processFrontMatter callback.
		await this.plugin.controller.enqueueFrontmatterWrite(file, (frontmatter: Record<string, unknown>) => {
			const exists = Object.prototype.hasOwnProperty.call(frontmatter, key);
			const decision = decideBulkWrite({
				exists,
				currentValue: frontmatter[key],
				rawValue,
				policy,
				wrapInArray,
			});
			outcome = decision.outcome;
			if (decision.action === "write") {
				frontmatter[key] = decision.value;
			}
		});

		return outcome;
	}

	private markdownFilesIn(folder: TFolder): TFile[] {
		const files: TFile[] = [];