fix(template): clarify file collision handling

docs/docs/Choices/TemplateChoice.md

@@ -31,20 +31,54 @@ When either enabled mode is selected, you can choose where the link is placed:
 - **New line** - Places the link on a new line below the cursor
 
 
-**Increment file name**. If a file with that name already exists, increment the file name with a number. So if a file called `untitled` already exists, the new file will be called `untitled1`.
+**If the target file already exists**. Choose whether QuickAdd should ask what to do, update the existing file, create another file, or keep the existing file.
 
 **Open**. Will open the file you've created. By default, it opens in the active pane. If you enable **New tab**, it'll open in a new tab in the direction you specified.
 
 ## File Already Exists Behavior
 
-When a file with the target name already exists, QuickAdd will prompt you with several options:
+When a file with the target name already exists, the setting works in two steps:
 
-- **Append to the bottom of the file**: Adds the template content to the end of the existing file
-- **Append to the top of the file**: Adds the template content to the beginning of the existing file  
-- **Overwrite the file**: Replaces the entire file content with the template
-- **Increment the file name**: Creates a new file with a number suffix (e.g., `note1.md`)
-- **Nothing**: Opens the existing file without modification
+- **If the target file already exists**:
+  choose one of these high-level behaviors:
+  **Ask every time**, **Update existing file**, **Create another file**, or
+  **Keep existing file**
+- **Update action**:
+  shown only when you choose **Update existing file**
+- **New file naming**:
+  shown only when you choose **Create another file**
 
-**Note**: When you select "Nothing", the existing file will automatically open, making it easy to quickly access files that already exist without needing to enable the "Open" setting.
+### Ask Every Time
 
-![image](https://user-images.githubusercontent.com/29108628/121773888-3f680980-cb7f-11eb-919b-97d56ef9268e.png)
+QuickAdd prompts you to choose one of these actions each time the target path
+already exists:
+
+- **Append to bottom**
+- **Append to top**
+- **Overwrite file**
+- **Increment trailing number**
+- **Append duplicate suffix**
+- **Do nothing**
+
+### Update Existing File
+
+These options modify the existing markdown, canvas, or base file:
+
+- **Append to bottom**: Adds the template content to the end of the existing file
+- **Append to top**: Adds the template content to the beginning of the existing file
+- **Overwrite file**: Replaces the existing file content with the template
+
+### Create Another File
+
+These options keep the existing file untouched and create a new file instead:
+
+- **Increment trailing number**: Changes trailing digits only while preserving zero padding when present. For example, `note009.md` becomes `note010.md`.
+- **Append duplicate suffix**: Keeps the full base name and adds ` (1)`, ` (2)`, and so on. For example, `note.md` becomes `note (1).md`.
+
+### Keep Existing File
+
+Selecting **Keep existing file** applies the same result as choosing
+**Do nothing** from the prompt:
+
+- **Do nothing**: Leaves the existing file unchanged and opens it
+  automatically. This does not require the separate **Open** setting.

docs/docs/Examples/Template_CreateMOCNoteWithLinkDashboard.md

@@ -85,7 +85,8 @@ outgoing links for this note.
 - **File Name Format**: `{{VALUE:moc_title}}`
 - **Create in folder**: your MOC folder, for example `MOCs`
 - **Open**: enabled
-- **File already exists behavior**: `Increment the file name`
+- **If the target file already exists**: `Create another file`
+- **New file naming**: `Increment trailing number`
 
 4. Run the Template choice and enter a title such as `Alpha Project`.
 

src/constants.ts

@@ -185,20 +185,5 @@ export const TIME_FORMAT_SYNTAX_SUGGEST_REGEX = new RegExp(
 export const QA_INTERNAL_CAPTURE_TARGET_FILE_PATH =
 	"__qa.captureTargetFilePath";
 
-// == File Exists (Template Choice) == //
-export const fileExistsIncrement = "Increment the file name" as const;
-export const fileExistsAppendToBottom =
-	"Append to the bottom of the file" as const;
-export const fileExistsAppendToTop = "Append to the top of the file" as const;
-export const fileExistsOverwriteFile = "Overwrite the file" as const;
-export const fileExistsDoNothing = "Nothing" as const;
-export const fileExistsChoices = [
-	fileExistsAppendToBottom,
-	fileExistsAppendToTop,
-	fileExistsOverwriteFile,
-	fileExistsIncrement,
-	fileExistsDoNothing,
-] as const;
-
 // == MISC == //
 export const WIKI_LINK_REGEX = new RegExp(/\[\[([^\]]*)\]\]/);

src/engine/CaptureChoiceEngine.notice.test.ts

@@ -27,6 +27,7 @@ vi.mock("../quickAddSettingsTab", () => {
 			migrateToMacroIDFromEmbeddedMacro: true,
 			useQuickAddTemplateFolder: false,
 			incrementFileNameSettingMoveToDefaultBehavior: false,
+			consolidateFileExistsBehavior: false,
 			mutualExclusionInsertAfterAndWriteToBottomOfFile: false,
 			setVersionAfterUpdateModalRelease: false,
 			addDefaultAIProviders: false,

src/engine/CaptureChoiceEngine.template-property-types.test.ts

@@ -32,6 +32,7 @@ vi.mock("../quickAddSettingsTab", () => {
 			migrateToMacroIDFromEmbeddedMacro: true,
 			useQuickAddTemplateFolder: false,
 			incrementFileNameSettingMoveToDefaultBehavior: false,
+			consolidateFileExistsBehavior: false,
 			mutualExclusionInsertAfterAndWriteToBottomOfFile: false,
 			setVersionAfterUpdateModalRelease: false,
 			addDefaultAIProviders: false,

src/engine/MacroChoiceEngine.notice.test.ts

@@ -27,6 +27,7 @@ vi.mock("../quickAddSettingsTab", () => {
 			migrateToMacroIDFromEmbeddedMacro: true,
 			useQuickAddTemplateFolder: false,
 			incrementFileNameSettingMoveToDefaultBehavior: false,
+			consolidateFileExistsBehavior: false,
 			mutualExclusionInsertAfterAndWriteToBottomOfFile: false,
 			setVersionAfterUpdateModalRelease: false,
 			addDefaultAIProviders: false,