From 3626151a7574fb92808ee321fec3aad65368390e Mon Sep 17 00:00:00 2001
From: Matt Brophy <matt@brophy.org>
Date: Fri, 11 Oct 2024 10:06:25 -0400
Subject: [PATCH] Stabilize the optimizeDeps future flag (#10092)

---
 .changeset/hot-dingos-attend.md               |  5 +++++
 docs/guides/dependency-optimization.md        |  2 +-
 docs/start/future-flags.md                    | 20 +++++++++++++++++--
 .../remix-dev/__tests__/readConfig-test.ts    |  2 +-
 packages/remix-dev/config.ts                  |  4 ++--
 packages/remix-dev/vite/plugin.ts             |  2 +-
 6 files changed, 28 insertions(+), 7 deletions(-)
 create mode 100644 .changeset/hot-dingos-attend.md

diff --git a/.changeset/hot-dingos-attend.md b/.changeset/hot-dingos-attend.md
new file mode 100644
index 00000000000..6122e6e836e
--- /dev/null
+++ b/.changeset/hot-dingos-attend.md
@@ -0,0 +1,5 @@
+---
+"@remix-run/dev": minor
+---
+
+Stabilize the `future.unstable_optimizeDeps` flag into `future.v3_optimizeDeps`
diff --git a/docs/guides/dependency-optimization.md b/docs/guides/dependency-optimization.md
index 48877769a3e..a92f9b3733c 100644
--- a/docs/guides/dependency-optimization.md
+++ b/docs/guides/dependency-optimization.md
@@ -6,7 +6,7 @@ title: Dependency optimization
 
 # Dependency optimization
 
-Remix introduced automatic dependency optimization in development behind the `future.unstable_optimizeDeps` [Future Flag][future-flags].
+Remix introduced automatic dependency optimization in development behind the `future.v3_optimizeDeps` [Future Flag][future-flags].
 This allows you to opt-into this behavior which will become the default in the next major version of Remix - a.k.a. React Router v7 ([1][rr-v7], [2][rr-v7-2]).
 
 In development, Vite aims to [prebundle dependencies][prebundle-dependencies] so that it can efficiently serve up those dependencies on-demand.
diff --git a/docs/start/future-flags.md b/docs/start/future-flags.md
index 728da129fb0..1356d4937d1 100644
--- a/docs/start/future-flags.md
+++ b/docs/start/future-flags.md
@@ -472,9 +472,25 @@ You shouldn't need to make any changes to your application code for this feature
 
 You may find some usage for the new [`<Link discover>`][discover-prop] API if you wish to disable eager route discovery on certain links.
 
-## unstable_optimizeDeps
+## v3_optimizeDeps
 
-Opt into automatic [dependency optimization][dependency-optimization] during development.
+**Background**
+
+This flag allows you to opt-into automatic [dependency optimization][dependency-optimization] during development when using Vite.
+
+👉 **Enable the Flag**
+
+```ts filename=vite.config.ts
+remix({
+  future: {
+    v3_optimizeDeps: true,
+  },
+});
+```
+
+**Update your Code**
+
+You shouldn't need to make any changes to your application code for this feature to work.
 
 [development-strategy]: ../guides/api-development-strategy
 [fetcherpersist-rfc]: https://github.com/remix-run/remix/discussions/7698
diff --git a/packages/remix-dev/__tests__/readConfig-test.ts b/packages/remix-dev/__tests__/readConfig-test.ts
index f528c16f15e..bd06d50309f 100644
--- a/packages/remix-dev/__tests__/readConfig-test.ts
+++ b/packages/remix-dev/__tests__/readConfig-test.ts
@@ -36,9 +36,9 @@ describe("readConfig", () => {
         "entryServerFile": "entry.server.tsx",
         "entryServerFilePath": Any<String>,
         "future": {
-          "unstable_optimizeDeps": false,
           "v3_fetcherPersist": false,
           "v3_lazyRouteDiscovery": false,
+          "v3_optimizeDeps": false,
           "v3_relativeSplatPath": false,
           "v3_singleFetch": false,
           "v3_throwAbortReason": false,
diff --git a/packages/remix-dev/config.ts b/packages/remix-dev/config.ts
index 16065ff01af..b6cb6dd8f01 100644
--- a/packages/remix-dev/config.ts
+++ b/packages/remix-dev/config.ts
@@ -39,7 +39,7 @@ interface FutureConfig {
   v3_throwAbortReason: boolean;
   v3_singleFetch: boolean;
   v3_lazyRouteDiscovery: boolean;
-  unstable_optimizeDeps: boolean;
+  v3_optimizeDeps: boolean;
 }
 
 type NodeBuiltinsPolyfillOptions = Pick<
@@ -605,7 +605,7 @@ export async function resolveConfig(
     v3_throwAbortReason: appConfig.future?.v3_throwAbortReason === true,
     v3_singleFetch: appConfig.future?.v3_singleFetch === true,
     v3_lazyRouteDiscovery: appConfig.future?.v3_lazyRouteDiscovery === true,
-    unstable_optimizeDeps: appConfig.future?.unstable_optimizeDeps === true,
+    v3_optimizeDeps: appConfig.future?.v3_optimizeDeps === true,
   };
 
   if (appConfig.future) {
diff --git a/packages/remix-dev/vite/plugin.ts b/packages/remix-dev/vite/plugin.ts
index 53ce6400b57..c886f7fcbcf 100644
--- a/packages/remix-dev/vite/plugin.ts
+++ b/packages/remix-dev/vite/plugin.ts
@@ -1075,7 +1075,7 @@ export const remixVitePlugin: RemixVitePlugin = (remixUserConfig = {}) => {
               : undefined,
           },
           optimizeDeps: {
-            entries: ctx.remixConfig.future.unstable_optimizeDeps
+            entries: ctx.remixConfig.future.v3_optimizeDeps
               ? [
                   ctx.entryClientFilePath,
                   ...Object.values(ctx.remixConfig.routes).map((route) =>