feat(vike-server): Add smart dependency handling for standalone builds

.github/workflows/ci.yml

@@ -30,8 +30,6 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - uses: pnpm/action-setup@v4
-        with:
-          version: 9.2.0
       - uses: actions/setup-node@v4
         with:
           node-version: 20

.github/workflows/formatting.yml

@@ -7,7 +7,5 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - uses: pnpm/action-setup@v4
-        with:
-          version: 9.2.0
       - run: pnpm install
       - run: pnpm run format:check

.npmrc

@@ -1 +1,3 @@
-shamefully-hoist=true
+shamefully-hoist=true
+link-workspace-packages=true
+prefer-workspace-packages=true

MIGRATION.md

@@ -0,0 +1,81 @@
+## Migration from `vike-node`
+
+### Vike extension syntax
+Replace `vike-node` Vite plugin by `vike-server` Vike extension:
+
+#### `vite.config.ts`
+```diff
+-import vikeNode from 'vike-node/plugin'
+
+export default {
+  // ...
+-  plugins: [vikeNode('server/index.js')]
+}
+```
+
+#### `+config.ts`
+```diff
++import vikeServer from 'vike-server/config'
+
+export const config = {
+  // ...
++  extends: [vikeServer],
++  server: 'server/index.js'
+}
+```
+
+### Server entry
+Example with a server entry using `express`:
+
+```diff
+// server/index.js
+-import vike from 'vike-node/express'
++import { apply } from 'vike-server/express'
++import { serve } from 'vike-server/express/serve'
+
+-startServer()
+
+function startServer() {
+  const app = express()
+-  app.use(vike())
++  apply(app)
+  const port = process.env.PORT || 3000
+
+-  app.listen(port, () => console.log(`Server running at http://localhost:${port}`))
++  return serve(app, { port })
+}
+
++export default startServer()
+```
+
+### `external` config
+`vike-node`'s `external` config as been removed, but can be replaced by the following Vite config:
+```js
+// vite.config.ts
+export default {
+  // ...
+  resolve: {
+    external: [...]
+  },
+}
+```
+
+When used with in `standalone` mode, `+config.ts` also needs to be updated:
+```ts
+// +config.ts
+
+export const config = {
+  // ...
+  server: {
+    standalone: {
+      external: [...]
+    }
+  }
+}
+```
+
+### Cloudflare support
+TODO
+
+### Vercel support
+TODO

README.md

@@ -0,0 +1,6 @@
+Source code of Vike Server extension: [Vike Docs > Server](https://vike.dev/server).
+
+See [packages/vike-server](packages/vike-server).
+
+> [!NOTE]
+> Migrating from `vike-node`? Take a look at the [migration doc](MIGRATION.md).

biome.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
   "files": {
-    "ignore": ["dist/", ".vercel/", "package.json", "test/vike-node/build"]
+    "ignore": ["dist/", ".vercel/", "package.json", "test/vike-server/build"]
   },
   "formatter": {
     "indentWidth": 2,

examples/express-react/+config.js

@@ -0,0 +1,9 @@
+export { config }
+
+import vikeServer from 'vike-server/config'
+
+const config = {
+  // https://vike.dev/extends
+  extends: [vikeServer],
+  server: 'server/index.js'
+}

examples/express-react/.test-dev.test.ts

@@ -0,0 +1,3 @@
+import { testRun } from './.testRun'
+
+testRun('pnpm run dev')

examples/express-react/.test-prod.test.ts

@@ -0,0 +1,3 @@
+import { testRun } from './.testRun'
+
+testRun('pnpm run dev')