bump to v0.18.3

Author: teplostanski

docs/recipes/svelte-support.md

@@ -58,3 +58,29 @@ bun add -D rollup-plugin-svelte svelte svelte-preprocess
 Чтобы сгенерировать `.d.ts` для компонентов Svelte, обычно используют пакет [`svelte2tsx`](https://www.npmjs.com/package/svelte2tsx). Рекомендуется применять специальный шаблон Svelte, в котором уже предусмотрен этап генерации деклараций на основе `svelte2tsx` после сборки.
 
 :::
+
+## Дистрибуция
+
+В соответствии с практикой сообщества и руководством [Packaging](https://svelte.dev/docs/kit/packaging) для SvelteKit, не публикуйте предварительно скомпилированные JS-компоненты. Вместо этого распространяйте исходные `.svelte`‑файлы и позвольте инструментам сборки пользователей (например, Vite с `@sveltejs/vite-plugin-svelte`) компилировать их в их собственных проектах.
+
+Почему не стоит публиковать предварительно скомпилированный JS:
+
+- Совместимость версий. Предварительно собранный код зависит от конкретной версии компилятора и пакета `svelte/internal`; несовпадения могут привести к ошибкам при работе или гидрации на сервере (SSR).
+- Согласованность SSR и гидрации. Различные параметры компиляции (`generate`, `hydratable`, `dev`, и т.п.) в библиотеке и приложении могут вызывать проблемы с гидрацией.
+- Интеграция с инструментами. Исходные `.svelte`‑файлы позволяют использовать улучшенные возможности HMR, диагностику, оптимизацию CSS и tree‑shaking; при дистрибуции JS эти преимущества теряются.
+- Упрощённая поддержка. Меньше переизданий при обновлении Svelte — пользователи сами компилируют библиотеку нужной им версией.
+
+Когда стоит публиковать JS:
+
+- Если вы поставляете артефакты, которые можно использовать вне Svelte (например, веб-компоненты с `customElement`).
+- В сценариях, где используется CDN и отсутствует этап сборки на стороне потребителя.
+
+Для подробной настройки упаковки (например, полей `exports`, `types`, `files`, `sideEffects`, подэкспортов и карт деклараций) см. официальное руководство.
+
+::: tip
+Основы работы с tsdown:
+
+- Отметьте пакеты `svelte`/`svelte/*` как внешние (`external`) в конфигурации `tsdown` и добавьте `svelte` в `peerDependencies`.
+- Используйте `rollup-plugin-svelte` для препроцессинга и интеграции, оставляя `.svelte`‑файлы в исходном виде при дистрибуции.
+- Применяйте `svelte2tsx`, чтобы создавать `.d.ts`‑файлы, соответствующие вашим подэкспортам из `exports`.
+  :::

docs/reference/cli.md

@@ -31,9 +31,7 @@ tsdown src/index.ts src/util.ts
 
 ## Опция `--config-loader <загрузчик>`
 
-Позволяет выбрать загрузчик конфигурационного файла, который будет использоваться при запуске `tsdown`.
-
-Поддерживаемые значения загрузчика описаны в разделе «Загрузчики конфигурации» и включают: `auto`, `native`, `unconfig`.
+Указывает, какой загрузчик конфигурации использовать.
 
 См. также [Файл конфигурации](../options/config-file.md).
 
@@ -183,6 +181,28 @@ tsdown --env.NODE_ENV=production
 
 Обратите внимание, что переменные окружения, определённые с помощью `--env.VAR_NAME`, могут быть доступны только как `import.meta.env.VAR_NAME` или `process.env.VAR_NAME`.
 
+## `--env-file <file>`
+
+Загружает переменные окружения из указанного файла. Если используется вместе с параметром `--env`, приоритет имеют переменные, переданные через `--env`.
+
+:::tip
+Чтобы избежать случайной утечки конфиденциальных данных, по умолчанию подставляются только переменные окружения с префиксом `TSDOWN_`. Это поведение можно изменить с помощью флага [`--env-prefix`](#env-prefix).
+:::
+
+```bash
+tsdown --env-file .env.production
+```
+
+## `--env-prefix <prefix>` {#env-prefix}
+
+При загрузке переменных окружения через `--env-file` включаются только те переменные, чьи имена начинаются с указанных префиксов.
+
+- **По умолчанию:** `TSDOWN_`
+
+```bash
+tsdown --env-file .env --env-prefix APP_ --env-prefix TSDOWN_
+```
+
 ## `--debug-logs [feat]`
 
 Показывает отладочные логи.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsdown.ru",
-  "version": "0.18.2",
+  "version": "0.18.3",
   "type": "module",
   "scripts": {
     "docs:dev": "vitepress dev docs",