feat: Allow localization of the "Milestones" header

Author: cr7pt0gr4ph7

src/flow-scanner.ts

@@ -1,5 +1,5 @@
 import type { App, TFile, CachedMetadata } from "obsidian";
-import { FlowProject, nextActionsHeaderText, PluginSettings } from "./types";
+import { FlowProject, milestonesHeaderText, nextActionsHeaderText, PluginSettings } from "./types";
 import { ProjectNode, buildProjectHierarchy } from "./project-hierarchy";
 
 export class FlowProjectScanner {
@@ -65,7 +65,7 @@ export class FlowProjectScanner {
       mtime: file.stat.mtime,
       nextActions: this.extractSection(content, `## ${nextActionsHeaderText(this.settings)}`),
       parentProject: frontmatter["parent-project"],
-      milestones: this.extractSectionText(content, "## Milestones"),
+      milestones: this.extractSectionText(content, `## ${milestonesHeaderText(this.settings)}`),
       coverImage: frontmatter["cover-image"],
       current: frontmatter.current === true,
     };

src/settings-tab.ts

@@ -379,6 +379,22 @@ export class FlowGTDSettingTab extends PluginSettingTab {
           })
       );
 
+    // Milestones Header Text
+    new Setting(containerEl)
+      .setName("Milestones Header Text")
+      .setDesc(
+        "Alternative text for the \"Milestones\" header in project files."
+      )
+      .addText((text) =>
+        text
+          .setPlaceholder("Milestones")
+          .setValue(this.plugin.settings.milestonesHeaderText)
+          .onChange(async (value) => {
+            this.plugin.settings.milestonesHeaderText = value;
+            await this.plugin.saveSettings();
+          })
+      );
+
     // Default Inbox File
     new Setting(containerEl)
       .setName("Default Inbox File")

src/types/settings.ts

@@ -18,6 +18,7 @@ export interface PluginSettings {
   inboxFolderPath: string;
   processedInboxFolderPath: string;
   nextActionsHeaderText: string; // Header text to use instead of "Next actions"
+  milestonesHeaderText: string; // Header text to use instead of "Milestones"
   nextActionsFilePath: string;
   somedayFilePath: string;
   projectsFolderPath: string;
@@ -53,6 +54,7 @@ export const DEFAULT_SETTINGS: PluginSettings = {
   processedInboxFolderPath: "Processed Inbox Folder Notes",
   nextActionsFilePath: "Next actions.md",
   nextActionsHeaderText: "Next actions",
+  milestonesHeaderText: "Milestones",
   somedayFilePath: "Someday.md",
   projectsFolderPath: "Projects",
   projectTemplateFilePath: "Templates/Project.md",
@@ -82,3 +84,15 @@ export function nextActionsHeaderText(settings: PluginSettings): string {
   }
   return "Next actions";
 }
+
+/**
+ * Returns "Milestones" header text from settings if present;
+ * returns a fallback text otherwise.
+ */
+export function milestonesHeaderText(settings: PluginSettings): string {
+  const headerText = settings.milestonesHeaderText;
+  if (headerText && headerText.trim().length > 0) {
+    return headerText;
+  }
+  return "Milestones";
+}