From 888a1511b67d7a85216ffdc7bcb96d17bbfff1e4 Mon Sep 17 00:00:00 2001
From: Syed Sohail Hussain <sohailhussain.syed1992@gmail.com>
Date: Wed, 12 Aug 2026 19:00:53 -0400
Subject: [PATCH] chore(config): add @deprecated tags to plugin hook utilities

---
 packages/vite/src/node/config.ts | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/vite/src/node/config.ts b/packages/vite/src/node/config.ts
index 9fee3e59a93c77..4d802fb07cc435 100644
--- a/packages/vite/src/node/config.ts
+++ b/packages/vite/src/node/config.ts
@@ -1091,9 +1091,15 @@ export function getDefaultEnvironmentOptions(
 }
 
 export interface PluginHookUtils {
+  /**
+   * @deprecated Use `config.environments` instead
+   */
   getSortedPlugins: <K extends keyof Plugin>(
     hookName: K,
   ) => PluginWithRequiredHook<K>[]
+  /**
+   * @deprecated Use `config.environments` instead
+   */
   getSortedPluginHooks: <K extends keyof Plugin>(
     hookName: K,
   ) => NonNullable<HookHandler<Plugin[K]>>[]
@@ -2178,7 +2184,6 @@ export async function resolveConfig(
   patchPlugins?.(resolvedPlugins)
   ;(resolved.plugins as Plugin[]) = resolvedPlugins
 
-  // TODO: Deprecate config.getSortedPlugins and config.getSortedPluginHooks
   Object.assign(resolved, createPluginHookUtils(resolved.plugins))
 
   // call configResolved hooks