feat: enable hmr when running tests in development with vite dev server

Author: ElMassimo

docs/config/index.md

@@ -66,7 +66,8 @@ If you followed the [installation] section, it should look similar to:
   },
   "test": {
     "autoBuild": true,
-    "publicOutputDir": "vite-test"
+    "publicOutputDir": "vite-test",
+    "port": 3037
   }
 }
 ```

docs/guide/development.md

@@ -137,3 +137,22 @@ Tag helpers are provided in the framework-specific integrations:
   - [Hanami](/guide/hanami)
   - [Padrino](/guide/padrino)
   - [Plugin Legacy](/guide/plugin-legacy)
+
+## HMR for Integration Tests ✅
+
+When iterating on integration tests locally, you can [avoid rebuilds] by starting
+an additional Vite dev server for tests with <kbd>bin/vite dev --mode=test</kbd>.
+
+To reuse the same Vite dev server from development, you can configure <kbd>[publicOutputDir]</kbd> and <kbd>[port]</kbd> in `test` to match the `development` config.
+
+::: tip Intended for quick iteration
+The trade-off is that your app might not even build correctly.
+
+It's safe if you are running tests in a CI as it will build in production mode.
+
+When running tests locally, you can test the production build by not starting the Vite dev server for tests, or by setting the `CI` environment varialbe.
+:::
+
+[avoid rebuilds]: https://github.com/ElMassimo/vite_ruby/tree/main/examples/rails/spec/features/home_spec.rb#15
+[publicOutputDir]: /config/#publicoutputdir
+[port]: /config/#port

examples/hanami_bookshelf/config/vite.json

@@ -10,6 +10,7 @@
   },
   "test": {
     "autoBuild": true,
-    "publicOutputDir": "vite-test"
+    "publicOutputDir": "vite-test",
+    "port": 3037
   }
 }

examples/padrino_blog_tutorial/config/vite.json

@@ -10,6 +10,7 @@
   },
   "test": {
     "autoBuild": true,
-    "publicOutputDir": "vite-test"
+    "publicOutputDir": "vite-test",
+    "port": 3037
   }
 }

examples/rails/config/vite.json

@@ -10,6 +10,7 @@
   },
   "test": {
     "autoBuild": true,
-    "publicOutputDir": "vite-test"
+    "publicOutputDir": "vite-test",
+    "port": 3037
   }
 }

test/mounted_app/test/dummy/config/vite.json

@@ -10,6 +10,7 @@
   },
   "test": {
     "autoBuild": true,
-    "publicOutputDir": "vite-test"
+    "publicOutputDir": "vite-test",
+    "port": 3037
   }
 }

vite-plugin-ruby/example/config/vite.json

@@ -16,6 +16,7 @@
   },
   "test": {
     "autoBuild": true,
-    "publicOutputDir": "vite-test"
+    "publicOutputDir": "vite-test",
+    "port": 3037
   }
 }

vite_hanami/templates/config/hanami-vite.json

@@ -10,6 +10,7 @@
   },
   "test": {
     "autoBuild": true,
-    "publicOutputDir": "vite-test"
+    "publicOutputDir": "vite-test",
+    "port": 3037
   }
 }

vite_padrino/templates/config/padrino-vite.json

@@ -10,6 +10,7 @@
   },
   "test": {
     "autoBuild": true,
-    "publicOutputDir": "vite-test"
+    "publicOutputDir": "vite-test",
+    "port": 3037
   }
 }

vite_rails/templates/config/rails-vite.json

@@ -10,6 +10,7 @@
   },
   "test": {
     "autoBuild": true,
-    "publicOutputDir": "vite-test"
+    "publicOutputDir": "vite-test",
+    "port": 3037
   }
 }