feat!: remove serve-index dependency and related functionality (#151)

Author: chenjiahan

docs/migrate-v1-to-v2.md

@@ -169,6 +169,44 @@ npm i -D selfsigned@^5.0.0
 # or bun add -D selfsigned@^5.0.0
 ```
 
+### Removed `serve-index` support
+
+`devServer.static.serveIndex` is removed in v2 to reduce third-party dependencies.
+
+If you still need directory listings for a static directory, install [serve-index](https://www.npmjs.com/package/serve-index) and register it with `setupMiddlewares`:
+
+```bash
+npm i -D serve-index
+# or pnpm add -D serve-index
+# or yarn add -D serve-index
+# or bun add -D serve-index
+```
+
+```js
+import path from 'node:path';
+import serveIndex from 'serve-index';
+
+const publicDirectory = path.join(import.meta.dirname, 'public');
+
+export default {
+  devServer: {
+    static: {
+      directory: publicDirectory,
+    },
+    setupMiddlewares: (middlewares) => {
+      middlewares.push({
+        name: 'serve-index',
+        // The same as `static.publicPath`
+        path: '/',
+        middleware: serveIndex(publicDirectory, { icons: true }),
+      });
+
+      return middlewares;
+    },
+  },
+};
+```
+
 ### Removed SockJS support (`ws` only)
 
 In v2, the following SockJS options are no longer available:

package.json

@@ -46,15 +46,13 @@
   },
   "dependencies": {
     "@types/connect-history-api-fallback": "^1.5.4",
-    "@types/serve-index": "^1.9.4",
     "@types/serve-static": "^2.2.0",
     "@types/ws": "^8.18.1",
     "chokidar": "^5.0.0",
     "connect-history-api-fallback": "^2.0.0",
     "connect-next": "^4.0.0",
     "http-proxy-middleware": "^3.0.5",
     "ipaddr.js": "^2.3.0",
-    "serve-index": "^1.9.2",
     "serve-static": "^2.2.1",
     "webpack-dev-middleware": "^7.4.5",
     "ws": "^8.19.0"

pnpm-lock.yaml

@@ -13,7 +13,6 @@ export default defineConfig({
           'webpack-dev-middleware': 'commonjs webpack-dev-middleware',
           'http-proxy-middleware': 'commonjs http-proxy-middleware',
           'serve-static': 'commonjs serve-static',
-          'serve-index': 'commonjs serve-index',
           selfsigned: 'commonjs selfsigned',
         },
       },