chore: add webpack 4 migration guide / workarounds

Author: AtofStryker

docs/app/references/migration-guide.mdx

@@ -20,6 +20,69 @@ Cypress requires [Node.js](https://nodejs.org/en) in order to install the Cypres
 Node.js versions 18 and 23 are no longer supported.
 [See Node's release schedule](https://github.com/nodejs/Release).
 
+### Webpack `4` is no longer supported
+
+Cypress is no longer supporting Webpack `4` as it is no longer maintained by the core Webpack team and Webpack `5` has been available since Q4 2020. This includes Webpack `4` support for:
+
+- `@cypress/webpack-batteries-included-preprocessor` and `@cypress/webpack-preprocessor` for end-to-end testing. This is mostly a passive change unless you are using a specific webpack configuration to preprocess your tests, which is uncommon.
+- `@cypress/webpack-dev-server` for component testing. This use case is more common and will require an to update to Webpack `5`.
+
+#### To continue using Webpack `4`
+
+##### End-to-End Testing
+
+If you haven't been able to migrate away from Webpack `4` and still need to be able to run your end-to-end tests with Webpack `4`, you can install the following packages independently:
+
+```sh
+npm install --save-dev @cypress/[email protected] @cypress/[email protected]
+```
+
+and configure the preprocessor within your `cypress.config.js` or `cypress.config.ts` file:
+
+```js
+import { defineConfig } from 'cypress'
+import webpackPreprocessor from '@cypress/webpack-batteries-included-preprocessor'
+
+export default defineConfig({
+  e2e: {
+    setupNodeEvents(on, config) {
+      on('file:preprocessor', webpackPreprocessor())
+    },
+  },
+})
+```
+
+More information on how to configure the preprocessor can be found in the [Preprocessors API documentation](https://docs.cypress.io/api/node-events/preprocessors-api#Usage), the [Webpack Batteries Included Preprocessor documentation](https://github.com/cypress-io/cypress/blob/v14.3.2/npm/webpack-batteries-included-preprocessor/README.md), and [Webpack Preprocessor documentation](https://github.com/cypress-io/cypress/blob/v14.3.2/npm/webpack-preprocessor/README.md).
+
+##### Component Testing
+
+If you haven't been able to migrate away from Webpack `4` and still need to be able to run your component tests with Webpack `4`, you can install the following packages independently:
+
+```sh
+npm install --save-dev @cypress/[email protected]
+```
+
+and configure the dev server within your `cypress.config.js` or `cypress.config.ts` file:
+
+```js
+import { devServer } from '@cypress/webpack-dev-server'
+import { defineConfig } from 'cypress'
+
+export default defineConfig({
+  component: {
+    devServer(devServerConfig) {
+      return devServer({
+        ...devServerConfig,
+        framework: 'react',
+        webpackConfig: require('./webpack.config.js'),
+      })
+    },
+  },
+})
+```
+
+More information on how to configure the dev server can be found in the [Cypress Webpack Dev Server documentation](https://github.com/cypress-io/cypress/blob/v14.3.2/npm/webpack-dev-server/README.md) and [Custom Dev Server documentation](https://docs.cypress.io/app/component-testing/component-framework-configuration#Custom-Dev-Server/).
+
 ### Angular `17` CT no longer supported
 
 With [LTS ending](https://angular.dev/reference/releases#actively-supported-versions) for Angular 17, the minimum required Angular version for component testing is now `18.0.0`.