test(e2e): add file collision behavior coverage

.gitignore

@@ -17,4 +17,7 @@ styles.css
 data.json
 
 **/*.map
-src/**/*.js
+src/**/*.js
+
+# e2e test failure artifacts
+.obsidian-e2e-artifacts

README.md

@@ -18,10 +18,23 @@ Throughout your choices, you can use the [QuickAdd format syntax](https://quicka
 
 QuickAdd can be installed through the community plugin browser in Obsidian, or through manual installation. See the [installation documentation](https://quickadd.obsidian.guide/docs/#installation) for more information.
 
-## Getting Started
-
-For detailed instructions and examples on using QuickAdd, see the [QuickAdd documentation](https://quickadd.obsidian.guide/).
-
-## Support
-
-If you have any questions or encounter any problems while using QuickAdd, you can use the [community discussions](https://github.com/chhoumann/quickadd/discussions) for support.
+## Getting Started
+
+For detailed instructions and examples on using QuickAdd, see the [QuickAdd documentation](https://quickadd.obsidian.guide/).
+
+## Development
+
+QuickAdd uses `bun` for local development tasks:
+
+- `bun run test` runs the unit test suite.
+- `bun run build` type-checks and bundles the plugin.
+- `bun run test:e2e` runs Obsidian-backed end-to-end tests.
+
+The E2E suite is local-only today. It depends on a locally installed Obsidian
+app, the `obsidian` CLI being available on `PATH`, and the `dev` vault being
+open and reachable. Failed E2E runs may write artifacts to
+`.obsidian-e2e-artifacts/`.
+
+## Support
+
+If you have any questions or encounter any problems while using QuickAdd, you can use the [community discussions](https://github.com/chhoumann/quickadd/discussions) for support.

package.json

@@ -10,7 +10,8 @@
     "build-with-lint": "tsc -noEmit -skipLibCheck && bun lint && node esbuild.config.mjs production",
     "version": "node version-bump.mjs && git add manifest.json versions.json",
     "semantic-release": "semantic-release",
-    "test": "vitest run --config vitest.config.mts --passWithNoTests"
+    "test": "vitest run --config vitest.config.mts --passWithNoTests",
+    "test:e2e": "vitest run --config vitest.e2e.config.mts"
   },
   "keywords": [],
   "author": "Christian B. B. Houmann",
@@ -34,6 +35,7 @@
     "jsdom": "^26.1.0",
     "obsidian": "1.11.4",
     "obsidian-dataview": "^0.5.68",
+    "obsidian-e2e": "0.4.0",
     "semantic-release": "^24.2.6",
     "svelte": "^4.2.19",
     "svelte-check": "^3.8.6",