fix(deps)!: update dependency dotenv-expand to v12 (#18697)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: sapphi-red <49056869+sapphi-red@users.noreply.github.com>

Author: renovate[bot]

docs/guide/migration.md

@@ -99,6 +99,8 @@ There are other breaking changes which only affect few users.
   - This PR not only introduces a breaking change mentioned above as "Default value for `resolve.conditions`", but also makes `resolve.mainFields` to not be used for no-externalized dependencies in SSR. If you were using `resolve.mainFields` and want to apply that to no-externalized dependencies in SSR, you can use [`ssr.resolve.mainFields`](/config/ssr-options#ssr-resolve-mainfields).
 - [[#18493] refactor!: remove fs.cachedChecks option](https://github.com/vitejs/vite/pull/18493)
   - This opt-in optimization was removed due to edge cases when writing a file in a cached folder and immediately importing it.
+- [[#18697] fix(deps)!: update dependency dotenv-expand to v12](https://github.com/vitejs/vite/pull/18697)
+  - Variables used in interpolation should be declared before the interpolation now. For more details, see [the `dotenv-expand` changelog](https://github.com/motdotla/dotenv-expand/blob/v12.0.1/CHANGELOG.md#1200-2024-11-16).
 
 ## Migration from v4
 

packages/vite/package.json

@@ -116,7 +116,7 @@
     "debug": "^4.3.7",
     "dep-types": "link:./src/types",
     "dotenv": "^16.4.5",
-    "dotenv-expand": "^11.0.7",
+    "dotenv-expand": "^12.0.1",
     "es-module-lexer": "^1.5.4",
     "escape-html": "^1.0.3",
     "estree-walker": "^3.0.3",

playground/env/.env

@@ -2,10 +2,10 @@ VITE_CUSTOM_ENV_VARIABLE=1
 CUSTOM_PREFIX_ENV_VARIABLE=1
 VITE_EFFECTIVE_MODE_FILE_NAME=.env
 VITE_BOOL=true
+DEPEND_ENV=depend
 VITE_EXPAND_A=$EXPAND
 VITE_EXPAND_B=$DEPEND_ENV
 VITE_ESCAPE_A=escape\$
 VITE_ESCAPE_B=escape$
 IRRELEVANT_ENV=$DEPEND_ENV
 IRRELEVANT_ESCAPE_ENV=irrelevant$
-DEPEND_ENV=depend