Function processFolderTemplate

src/utils/folderTemplateProcessor.ts:225–468

(
	folderTemplate: string,
	options: FolderTemplateOptions = {}
)

 * ```
 */
export function processFolderTemplate(
	folderTemplate: string,
	options: FolderTemplateOptions = {}
): string {
	if (!folderTemplate) {
		return folderTemplate;
	}

	const {
		date = new Date(),
		taskData,
		icsData,
		extractProjectBasename,
		extractProjectFilePath,
	} = options;

	let processedPath = folderTemplate;
	const shouldNormalizeRelativeSegments = hasRelativePathSegments(folderTemplate);

	processedPath = replaceDailyNotesDateTokens(processedPath, date);

	// Replace task variables if taskData is provided
	if (taskData) {
		// Handle single context (first one if multiple)
		const context =
			Array.isArray(taskData.contexts) && taskData.contexts.length > 0
				? taskData.contexts[0]
				: "";
		processedPath = processedPath.replace(/\{\{context\}\}/g, context);

		// Handle single project (first one if multiple)
		const project =
			Array.isArray(taskData.projects) && taskData.projects.length > 0
				? extractProjectBasename
					? extractProjectBasename(taskData.projects[0])
					: taskData.projects[0]
				: "";
		processedPath = processedPath.replace(/\{\{project\}\}/g, project);

		// Handle multiple projects
		const projects =
			Array.isArray(taskData.projects) && taskData.projects.length > 0
				? taskData.projects
						.map((proj) =>
							extractProjectBasename ? extractProjectBasename(proj) : proj
						)
						.join("/")
				: "";
		processedPath = processedPath.replace(/\{\{projects\}\}/g, projects);

		// Handle full project file paths while preserving path separators
		const projectFilePath =
			Array.isArray(taskData.projects) && taskData.projects.length > 0
				? getProjectFilePath(taskData.projects[0], extractProjectFilePath)
				: "";
		processedPath = processedPath.replace(/\{\{projectFilePath\}\}/g, projectFilePath);

		const projectFilePaths =