Add NonInheritBadge

Closes #111

Author: dragomano

docs/.vitepress/theme/components/NonInheritBadge.vue

@@ -0,0 +1,8 @@
+<template>
+  <a
+    href="/guide/api-environment#environments-configuration"
+    class="ignore-header"
+  >
+    <Badge type="info" text="non-inherit" />
+  </a>
+</template>

docs/.vitepress/theme/index.ts

@@ -8,6 +8,7 @@ import './styles/landing.css'
 import AsideSponsors from './components/AsideSponsors.vue'
 import SvgImage from './components/SvgImage.vue'
 import YouTubeVideo from './components/YouTubeVideo.vue'
+import NonInheritBadge from './components/NonInheritBadge.vue'
 import 'virtual:group-icons.css'
 
 export default {
@@ -20,6 +21,7 @@ export default {
   enhanceApp({ app }) {
     app.component('SvgImage', SvgImage)
     app.component('YouTubeVideo', YouTubeVideo)
+    app.component('NonInheritBadge', NonInheritBadge)
     app.use(TwoslashFloatingVue)
   },
 } satisfies Theme

docs/config/dep-optimization-options.md

@@ -4,15 +4,15 @@
 
 Если не указано иное, параметры в этом разделе применяются только к оптимизатору зависимостей, который используется только в режиме разработки.
 
-## optimizeDeps.entries
+## optimizeDeps.entries <NonInheritBadge />
 
 - **Тип:** `string | string[]`
 
 По умолчанию Vite будет просматривать все ваши `.html` файлы, чтобы обнаружить зависимости, которые необходимо предварительно объединить (игнорируя `node_modules`, `build.outDir`, `__tests__` и `coverage`). Если указано `build.rollupOptions.input`, Vite будет просматривать эти точки входа вместо этого.
 
 Если ни один из этих вариантов не подходит, вы можете указать пользовательские записи с помощью этой опции — значение должно быть шаблоном [`tinyglobby`](https://github.com/SuperchupuDev/tinyglobby) или массивом шаблонов, заданных относительно корня проекта Vite. Это переопределит автоматическое определение записей по умолчанию. По умолчанию будут игнорироваться только папки `node_modules` и `build.outDir`, если `optimizeDeps.entries` явно определён. Если нужно игнорировать другие папки, можно использовать игнорирующий шаблон, начинающийся с `!`. Папка `node_modules` не будет игнорироваться для шаблонов, которые явно включают строку `node_modules`.
 
-## optimizeDeps.exclude
+## optimizeDeps.exclude <NonInheritBadge />
 
 - **Тип:** `string[]`
 
@@ -33,7 +33,7 @@ export default defineConfig({
 
 :::
 
-## optimizeDeps.include
+## optimizeDeps.include <NonInheritBadge />
 
 - **Тип:** `string[]`
 
@@ -51,7 +51,7 @@ export default defineConfig({
 })
 ```
 
-## optimizeDeps.esbuildOptions
+## optimizeDeps.esbuildOptions <NonInheritBadge />
 
 - **Тип:** [`Omit`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys)`<`[`EsbuildBuildOptions`](https://esbuild.github.io/api/#general-options)`,
 | 'bundle'
@@ -78,22 +78,22 @@ export default defineConfig({
 
 Установите значение `true`, чтобы принудительно выполнить предварительное объединение зависимостей, игнорируя ранее кэшированные оптимизированные зависимости.
 
-## optimizeDeps.noDiscovery
+## optimizeDeps.noDiscovery <NonInheritBadge />
 
 - **Тип:** `boolean`
 - **По умолчанию:** `false`
 
 Когда установлено значение `true`, автоматическое обнаружение зависимостей будет отключено, и оптимизироваться будут только зависимости, указанные в `optimizeDeps.include`. Зависимости, использующие только CJS, должны быть указаны в `optimizeDeps.include` во время разработки.
 
-## optimizeDeps.holdUntilCrawlEnd
+## optimizeDeps.holdUntilCrawlEnd <NonInheritBadge />
 
 - **Экспериментально:** [Оставить отзыв](https://github.com/vitejs/vite/discussions/15834)
 - **Тип:** `boolean`
 - **По умолчанию:** `true`
 
 При включении эта опция будет удерживать результаты первых оптимизированных зависимостей до тех пор, пока все статические импорты не будут просканированы при холодном старте. Это позволяет избежать необходимости полной перезагрузки страницы, когда обнаруживаются новые зависимости, и они вызывают генерацию новых общих чанков. Если все зависимости найдены сканером, а также явно определённые в `include`, лучше отключить эту опцию, чтобы браузер мог обрабатывать больше запросов параллельно.
 
-## optimizeDeps.disabled
+## optimizeDeps.disabled <NonInheritBadge />
 
 - **Устарело**
 - **Экспериментально:** [Оставить отзыв](https://github.com/vitejs/vite/discussions/13839)
@@ -108,7 +108,7 @@ export default defineConfig({
 Оптимизация зависимостей во время сборки была **экспериментальной** функцией. Проекты, пробующие эту стратегию, также удалили `@rollup/plugin-commonjs`, используя `build.commonjsOptions: { include: [] }`. Если вы сделали это, предупреждение подскажет вам повторно включить его для поддержки только CJS пакетов во время объединения.
 :::
 
-## optimizeDeps.needsInterop
+## optimizeDeps.needsInterop <NonInheritBadge />
 
 - **Экспериментально**
 - **Тип:** `string[]`

docs/config/shared-options.md

@@ -114,7 +114,7 @@ declare const __APP_VERSION__: string
 Для сборок SSR дедупликация не работает для выходных данных сборки ESM, настроенных с помощью `build.rollupOptions.output`. Обходным решением является использование выходных данных сборки CJS, пока ESM не получит лучшую поддержку плагинов для загрузки модулей.
 :::
 
-## resolve.conditions
+## resolve.conditions <NonInheritBadge />
 
 - **Тип:** `string[]`
 - **По умолчанию:** `['module', 'browser', 'development|production']` (`defaultClientConditions`)
@@ -140,7 +140,7 @@ declare const __APP_VERSION__: string
 
 Обратите внимание, что условия `import`, `require`, `default` всегда применяются, если требования выполнены.
 
-## resolve.mainFields
+## resolve.mainFields <NonInheritBadge />
 
 - **Тип:** `string[]`
 - **По умолчанию:** `['browser', 'module', 'jsnext:main', 'jsnext']` (`defaultClientMainFields`)

docs/guide/api-environment.md

@@ -70,7 +70,7 @@ export default {
 }
 ```
 
-Когда не задокументировано явно, окружение наследует настроенные параметры верхнего уровня конфигурации (например, новые окружения `server` и `edge` будут наследовать параметр `build.sourcemap: false`). Небольшое количество параметров верхнего уровня, таких как `optimizeDeps`, применяются только к окружению `client`, так как они не работают должным образом, когда применяются по умолчанию к серверным окружениям. Окружение `client` также может быть настроено явно через `environments.client`, но мы рекомендуем делать это с помощью параметров верхнего уровня, чтобы конфигурация клиента оставалась неизменной при добавлении новых окружений.
+Когда не задокументировано явно, окружение наследует настроенные параметры верхнего уровня конфигурации (например, новые окружения `server` и `edge` будут наследовать параметр `build.sourcemap: false`). Небольшое количество параметров верхнего уровня, таких как `optimizeDeps`, применяются только к окружению `client`, так как они не работают должным образом, когда применяются по умолчанию к серверным окружениям. Значок `<NonInheritBadge />` в [справочнике](/config/) указывает, что опции `server.ssrFixStacktrace` и `server.ssrRewriteStacktrace` не наследуются из родительских конфигураций. Это означает, что их значения должны быть явно заданы в конфигурации, где они используются, поскольку они не принимают автоматически значения из конфигураций более высокого уровня или конфигураций по умолчанию. Окружение `client` также может быть настроено явно через `environments.client`, но мы рекомендуем делать это с помощью параметров верхнего уровня, чтобы конфигурация клиента оставалась неизменной при добавлении новых окружений.
 
 Интерфейс `EnvironmentOptions` предоставляет все параметры для каждого окружения. Существуют параметры окружения, которые применяются как к `build`, так и к `dev`, такие как `resolve`. Также есть `DevEnvironmentOptions` и `BuildEnvironmentOptions` для параметров, специфичных для разработки и сборки (например, `dev.warmup` или `build.outDir`). Некоторые параметры, такие как `optimizeDeps`, применяются только к разработке, но остаются на верхнем уровне вместо того, чтобы быть вложенными в `dev`, для обеспечения обратной совместимости.