Update Environment API

dragomano · dragomano · commit 6313d9c5d0e5 · 2025-07-08T07:31:25.000+05:00
Closes #95
diff --git a/docs/changes/index.md b/docs/changes/index.md
@@ -6,18 +6,17 @@
 
 Эти изменения запланированы для следующей основной версии Vite. Депрекации или предупреждения об использовании будут направлять вас, где это возможно, и мы связываемся с авторами фреймворков, плагинов и пользователями, чтобы применить эти изменения.
 
-- _Пока нет запланированных изменений_
+- [`this.environment` в хуках](/changes/this-environment-in-hooks)
+- [Хук `hotUpdate` плагина HMR](/changes/hotupdate-hook)
+- [SSR с использованием API `ModuleRunner`](/changes/ssr-using-modulerunner)
 
 ## Рассматривается {#considering}
 
 Эти изменения рассматриваются и часто являются экспериментальными API, которые намерены улучшить текущие шаблоны использования. Поскольку не все изменения перечислены здесь, пожалуйста, ознакомьтесь с [Экспериментальной меткой в обсуждениях Vite на GitHub](https://github.com/vitejs/vite/discussions/categories/feedback?discussions_q=label%3Aexperimental+category%3AFeedback) для полного списка.
 
 Мы не рекомендуем пока переходить на эти API. Они включены в Vite, чтобы помочь нам собрать отзывы. Пожалуйста, ознакомьтесь с этими предложениями и дайте нам знать, как они работают в вашем случае использования в обсуждениях на GitHub.
 
-- [`this.environment` в хуках](/changes/this-environment-in-hooks)
-- [Хук `hotUpdate` плагина HMR](/changes/hotupdate-hook)
 - [Переход на API для каждой среды](/changes/per-environment-apis)
-- [SSR с использованием `ModuleRunner` API](/changes/ssr-using-modulerunner)
 - [Общие плагины во время сборки](/changes/shared-plugins-during-build)
 
 ## Прошлые изменения {#past}
diff --git a/docs/guide/api-environment-frameworks.md b/docs/guide/api-environment-frameworks.md
@@ -1,7 +1,9 @@
 # Environment API для фреймворков {#environment-api-for-frameworks}
 
-:::warning Экспериментально
-Environment API находится на экспериментальной стадии. Мы будем сохранять стабильность API между крупными релизами, чтобы дать экосистеме возможность экспериментировать и развивать их. Планируется стабилизировать эти новые API (с возможными значительными изменениями) в будущем крупном релизе после того, как проекты-потребители смогут протестировать новые функции и подтвердить их работоспособность.
+:::info Релиз-кандидат
+Environment API находится на стадии релиз-кандидата. Мы будем поддерживать стабильность API между основными релизами, чтобы экосистема могла экспериментировать и развиваться на их основе. Однако обратите внимание, что [некоторые конкретные API](/changes/#considering) всё ещё считаются экспериментальными.
+
+Мы планируем стабилизировать эти новые API (с возможными критическими изменениями) в будущем крупном релизе, как только проекты, зависящие от них, получат достаточно времени для экспериментов и проверки новых функций.
 
 Ресурсы:
 
diff --git a/docs/guide/api-environment-instances.md b/docs/guide/api-environment-instances.md
@@ -1,7 +1,9 @@
 # Использование экземпляров `Environment` {#using-environment-instances}
 
-:::warning Экспериментально
-Environment API находится на экспериментальной стадии. Мы будем сохранять стабильность API между крупными релизами, чтобы дать экосистеме возможность экспериментировать и развивать их. Планируется стабилизировать эти новые API (с возможными значительными изменениями) в будущем крупном релизе после того, как проекты-потребители смогут протестировать новые функции и подтвердить их работоспособность.
+:::info Релиз-кандидат
+Environment API находится на стадии релиз-кандидата. Мы будем поддерживать стабильность API между основными релизами, чтобы экосистема могла экспериментировать и развиваться на их основе. Однако обратите внимание, что [некоторые конкретные API](/changes/#considering) всё ещё считаются экспериментальными.
+
+Мы планируем стабилизировать эти новые API (с возможными критическими изменениями) в будущем крупном релизе, как только проекты, зависящие от них, получат достаточно времени для экспериментов и проверки новых функций.
 
 Ресурсы:
 
diff --git a/docs/guide/api-environment-plugins.md b/docs/guide/api-environment-plugins.md
@@ -1,7 +1,9 @@
 # Environment API для плагинов {#environment-api-for-plugins}
 
-:::warning Экспериментально
-Environment API находится на экспериментальной стадии. Мы будем сохранять стабильность API между крупными релизами, чтобы дать экосистеме возможность экспериментировать и развивать их. Планируется стабилизировать эти новые API (с возможными значительными изменениями) в будущем крупном релизе после того, как проекты-потребители смогут протестировать новые функции и подтвердить их работоспособность.
+:::info Релиз-кандидат
+Environment API находится на стадии релиз-кандидата. Мы будем поддерживать стабильность API между основными релизами, чтобы экосистема могла экспериментировать и развиваться на их основе. Однако обратите внимание, что [некоторые конкретные API](/changes/#considering) всё ещё считаются экспериментальными.
+
+Мы планируем стабилизировать эти новые API (с возможными критическими изменениями) в будущем крупном релизе, как только проекты, зависящие от них, получат достаточно времени для экспериментов и проверки новых функций.
 
 Ресурсы:
 
diff --git a/docs/guide/api-environment-runtimes.md b/docs/guide/api-environment-runtimes.md
@@ -1,7 +1,9 @@
 # Environment API для сред выполнения {#environment-api-for-runtimes}
 
-:::warning Экспериментально
-Environment API находится на экспериментальной стадии. Мы будем сохранять стабильность API между крупными релизами, чтобы дать экосистеме возможность экспериментировать и развивать их. Планируется стабилизировать эти новые API (с возможными значительными изменениями) в будущем крупном релизе после того, как проекты-потребители смогут протестировать новые функции и подтвердить их работоспособность.
+:::info Релиз-кандидат
+Environment API находится на стадии релиз-кандидата. Мы будем поддерживать стабильность API между основными релизами, чтобы экосистема могла экспериментировать и развиваться на их основе. Однако обратите внимание, что [некоторые конкретные API](/changes/#considering) всё ещё считаются экспериментальными.
+
+Мы планируем стабилизировать эти новые API (с возможными критическими изменениями) в будущем крупном релизе, как только проекты, зависящие от них, получат достаточно времени для экспериментов и проверки новых функций.
 
 Ресурсы:
 
diff --git a/docs/guide/api-environment.md b/docs/guide/api-environment.md
@@ -1,7 +1,9 @@
 # Environment API {#environment-api}
 
-:::warning Экспериментально
-Environment API находится на экспериментальной стадии. Мы будем сохранять стабильность API между крупными релизами, чтобы дать экосистеме возможность экспериментировать и развивать их. Планируется стабилизировать эти новые API (с возможными значительными изменениями) в будущем крупном релизе после того, как проекты-потребители смогут протестировать новые функции и подтвердить их работоспособность.
+:::info Релиз-кандидат
+Environment API находится на стадии релиз-кандидата. Мы будем поддерживать стабильность API между основными релизами, чтобы экосистема могла экспериментировать и развиваться на их основе. Однако обратите внимание, что [некоторые конкретные API](/changes/#considering) всё ещё считаются экспериментальными.
+
+Мы планируем стабилизировать эти новые API (с возможными критическими изменениями) в будущем крупном релизе, как только проекты, зависящие от них, получат достаточно времени для экспериментов и проверки новых функций.
 
 Ресурсы:
 
@@ -13,7 +15,7 @@ Environment API находится на экспериментальной ст
 
 ## Формализация окружений {#formalizing-environments}
 
-Vite 6 формализует концепцию окружений. До Vite 5 существовало два неявных окружения (`client` и, при необходимости, `ssr`). Новый Environment API позволяет пользователям и авторам фреймворков создавать столько окружений, сколько необходимо, чтобы отразить способ работы их приложений в продакшен-среде. Эта новая возможность потребовала значительной внутренней реорганизации, но было приложено много усилий для обеспечения обратной совместимости. Начальная цель Vite 6 — плавно перевести экосистему на новый мажорный релиз, откладывая принятие этих новых экспериментальных API до тех пор, пока достаточное количество пользователей не мигрирует, а фреймворки и авторы плагинов не подтвердят новый дизайн.
+Vite 6 формализует концепцию окружений. До версии Vite 5 существовало два неявных окружения (`client` и, опционально, `ssr`). Новый Environment API позволяет пользователям и авторам фреймворков создавать столько окружений, сколько необходимо для соответствия работы их приложений в продакшене. Эта новая возможность потребовала масштабной внутренней переработки, но большое внимание было уделено обратной совместимости. Основная цель Vite 6 — обеспечить максимально плавный переход экосистемы на новую мажорную версию, откладывая внедрение новых API до тех пор, пока достаточное количество пользователей не перейдёт на неё, а авторы фреймворков и плагинов не подтвердят работоспособность нового дизайна.
 
 ## Сокращение разрыва между сборкой и разработкой {#closing-the-gap-between-build-and-dev}
 
@@ -117,7 +119,7 @@ export default {
 
 ## Обратная совместимость {#backward-compatibility}
 
-Текущий Server API Vite ещё не устарел и обратно совместим с Vite 5. Новый Environment API является экспериментальным.
+Текущий Server API Vite ещё не помечен как устаревший и сохраняет обратную совместимость с Vite 5.
 
 `server.moduleGraph` возвращает смешанный вид графов модулей клиента и SSR. Обратно совместимые смешанные узлы модулей будут возвращены из всех его методов. Та же схема используется для узлов модулей, передаваемых в `handleHotUpdate`.
 
