@intlayer/docs 9.3.3 → 9.4.0

package/docs/ru/packages/react-intlayer/useI18n.md

@@ -77,6 +77,34 @@ author: aymericzip
 
 Примеры использования хука `useI18n` в React-компонентах:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +129,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";

package/docs/ru/packages/react-intlayer/useIntlayer.md

@@ -31,48 +31,6 @@ author: aymericzip
 
 ## Пример использования в React
 
-Демонстрация использования хука `useIntlayer` в React-компоненте:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
-```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const ComponentExample: FC = () => {
-  const content = useIntlayer("component-example");
-
-  return (
-    <div>
-      <h1>{content.title}</h1> {/* Заголовок компонента */}
-      <p>{content.description}</p> {/* Описание компонента */}
-    </div>
-  );
-};
-```
-
 ```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import { useIntlayer } from "react-intlayer/server";
 

package/docs/ru/packages/react-intlayer/useLocale.md

@@ -83,34 +83,6 @@ export default LocaleSwitcher;
 
 При вызове хука `useLocale` он возвращает объект, содержащий следующие свойства:
 
-- **`locale`**: Текущая локаль, установленная в контексте React.
-- **`defaultLocale`**: Основная локаль, определённая в конфигурации.
-- **`availableLocales`**: Список всех доступных локалей, определённых в конфигурации.
-
-```typescript
-import { useLocale } from "react-intlayer";
-
-const LocaleSelector = () => {
-  const { locale, setLocale, availableLocales } = useLocale();
-
-  const handleLocaleChange = (newLocale) => {
-    setLocale(newLocale);
-  };
-
-  return (
-    <select value={locale} onChange={(e) => handleLocaleChange(e.target.value)}>
-      {availableLocales.map((locale) => (
-        <option key={locale} value={locale}>
-          {locale}
-        </option>
-      ))}
-    </select>
-  );
-};
-
-export default LocaleSelector;
-```
-
 ```jsx fileName="src/components/LocaleSelector.mjx" codeFormat="esm"
 import { useLocale } from "react-intlayer";
 
@@ -133,28 +105,6 @@ const LocaleSelector = () => {
 };
 ```
 
-```jsx fileName="src/components/LocaleSelector.csx" codeFormat="commonjs"
-const { useLocale } = require("react-intlayer");
-
-const LocaleSelector = () => {
-  const { locale, setLocale, availableLocales } = useLocale();
-
-  const handleLocaleChange = (newLocale) => {
-    setLocale(newLocale);
-  };
-
-  return (
-    <select value={locale} onChange={(e) => handleLocaleChange(e.target.value)}>
-      {availableLocales.map((locale) => (
-        <option key={locale} value={locale}>
-          {locale}
-        </option>
-      ))}
-    </select>
-  );
-};
-```
-
 ## Заключение
 
 Хук `useLocale` из `react-intlayer` является важным инструментом для управления локалями в ваших React-приложениях, предоставляя функциональность, необходимую для эффективной адаптации вашего приложения к различным международным аудиториям.

package/docs/ru/packages/vite-intlayer/intlayerMinify.md

@@ -56,7 +56,7 @@ export default defineConfig({
 2. `build.optimize` имеет значение `true` (или `undefined`, что по умолчанию равно `true` для сборок).
 3. `build.minify` имеет значение `true` в вашей конфигурации Intlayer.
 
-Он автоматически **отключается**, когда `editor.enabled` имеет значение `true`, так как редактору требуется полное, понятное человеку содержимое словарей.
+Когда `editor.enabled` имеет значение `true`, плагин продолжает работать, но **пропускает переименование полей**: переименование переписывает ключи контента, по которым проходит интерпретатор, поэтому `keyPath`, получаемый визуальным редактором, больше не будет совпадать с не объединёнными словарями, которые он редактирует. Сжатие пробелов и удаление метаданных верхнего уровня остаются активными.
 
 ## Что минимизируется
 

package/docs/ru/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 Плагин Vite `intlayerPrune` используется для tree-shake и удаления неиспользуемых словарей из бандла вашего приложения. Это помогает уменьшить итоговый размер бандла, включая только необходимое мультиязычное содержимое.
 
+> Плагин уже включен и автоматически настроен при использовании [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/vite-intlayer/intlayer.md). Вам нужно только зарегистрировать его вручную, если вы самостоятельно составляете стек плагинов.
+
 ## Использование
 
 ### As part of `intlayer()` (recommended)
@@ -115,4 +117,4 @@ const { title, description } = useIntlayer("myDict");
 2. `build.optimize` имеет значение `true` (или `undefined`, что по умолчанию равно `true` для сборок).
 3. `build.purge` имеет значение `true` в вашей конфигурации Intlayer.
 
-Он автоматически **отключается** когда `editor.enabled` имеет значение `true`, потому что редактор требует полного содержимого словаря.
+Он остаётся активным, когда `editor.enabled` имеет значение `true`: визуальный редактор разрешает каждую правку через `dictionaryKey` + `keyPath` относительно не объединённых словарей, которых этот плагин никогда не касается, а очищенное поле — это поле, которое не читает ни один компонент, поэтому оно никогда не отображается и не может быть выбрано на странице.

package/docs/ru/per_locale_file.md

@@ -43,6 +43,18 @@ Intlayer поддерживает два способа объявления м
 
 Это рекомендуемый подход для большинства случаев использования. Он централизует переводы, что облегчает итерации и интеграцию с CMS.
 
+```tsx fileName="hello-world.ru.content.ts" contentDeclarationFormat=["typescript", "esm", "cjs"]
+import { t, Locales, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.RUSSIAN, // Важно
+  content: { multilingualContent: "Название моего компонента" },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
 ```tsx fileName="hello-world.content.ts" contentDeclarationFormat={["typescript", "esm"]}
 import { t, type Dictionary } from "intlayer";
 
@@ -95,6 +107,8 @@ module.exports = helloWorldContent;
 
 > Рекомендуется: Этот формат лучше всего подходит при использовании визуального редактора Intlayer или управлении переводами непосредственно в коде.
 
+> Примечание: В обоих случаях файл объявления содержимого должен следовать схеме именования `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` для распознавания Intlayer. Суффикс `.[locale]` необязателен и используется только как соглашение об именовании.
+
 ### Глобальная конфигурация для per-locale файлов
 
 Вы можете настроить глобальную конфигурацию для per-locale файлов, добавив следующее в ваш файл `intlayer.config.ts`:
@@ -157,21 +171,8 @@ export default helloWorldContent;
 }
 ```
 
-```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "es", // Важно
-  "content": {
-    "multilingualContent": "Título de mi componente",
-  },
-}
-```
-
 > Важно: Убедитесь, что поле locale определено. Оно сообщает Intlayer, на каком языке представлен файл.
 
-> Примечание: В обоих случаях файл декларации контента должен соответствовать шаблону именования `*.content.{ts,tsx,js,jsx,mjs,cjs,json}`, чтобы Intlayer мог его распознать. Суффикс `.[locale]` является необязательным и используется только как соглашение об именовании.
-
 ## Смешивание форматов
 
 Вы можете комбинировать оба подхода объявления для одного и того же ключа контента. Например:

package/docs/ru/readme.md

@@ -225,8 +225,8 @@ const HomePage = () => {
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
   <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
-  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
-  <li>
+  <li><a href="https://intlayer.org/doc/environment/solid-start" rel=''>Solid Start</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>  <li>
      <a href="https://intlayer.org/doc/environment/express" rel=''>Бэкэнд</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ const HomePage = () => {
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>

package/docs/ru/releases/v6.md

@@ -116,6 +116,8 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
+Автоматически заполните ваши отсутствующие переводы, используя команду `npx intlayer fill`.
+
 Вы все еще можете тонко настраивать каждый словарь, используя поле `autoFill` в файлах контента. Полную справку смотрите в `doc/autoFill` и `doc/dictionary/content_file`.
 
 ---
@@ -169,13 +171,24 @@ bun x intlayer fill
 - Панель инструментов в представлении словарей: Build, Pull, Push, Fill, Refresh, Test, Create Dictionary File
 - Контекстные меню: Pull/Push для словарей; Fill для файлов
 
-- Автоматическое выделение: текущий файл редактора подсвечивается в дереве словарей, если применимо
-- Новые команды доступны из Палитры команд: Заполнить словари и Тестировать словари
-
 Подробности смотрите в документации [Официальное расширение VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/vs_code_extension.md).
 
 ---
 
+Обновлен MCP server для поддержки новых функций.
+
+- Автозаполнение
+- Тестирование отсутствующих переводов
+- Живые обновления
+- Логирование
+- Валидация
+- Примечания миграции
+- Документация
+
+> MCP server помогает автоматизировать проекты, использующие Intlayer. Тестирование недостающих переводов для автогенерируемого кода. Помогает понять вашу конфигурацию и встроить документацию Intlayer в вашу IDE.
+
+---
+
 ## Производительность: в 10 раз быстрее
 
 - Параллельное разрешение локальных и удалённых словарей
@@ -297,8 +310,6 @@ bun x intlayer live --with 'vite preview'
 
 См. [CMS и Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) и [Конфигурация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md) для полного руководства.
 
----
-
 ## Параллельный процесс для отслеживания файлов на turbopack
 
 При использовании Turbopack на Next.js 14 и выше в качестве сервера разработки с командой `next dev --turbopack` изменения словарей не будут автоматически обнаруживаться по умолчанию.

package/docs/ru/releases/v9.md

@@ -374,6 +374,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 Установщик загружает `docker-compose.yml` и `.env`, автоматически генерирует необходимые секреты и запускает `docker compose up -d`. Всё — дашборд, API, база данных, хранилище объектов и транзакционная электронная почта — работает локально в контейнерах.
 
+---
+
 ## Примечания по миграции с v8
 
 Если вы обновляетесь с v8, обратите внимание, что v9 не содержит ломающих изменений (breaking changes). Однако вот ключевые изменения:

package/docs/ru/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer может полностью работать на вашей собственной инфраструктуре — аккаунт Intlayer Cloud не требуется. Одна команда запускает готовый к production стек:
 
+Одна команда устанавливает всё:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 Установщик загружает `docker-compose.yml` и `.env`, автоматически генерирует необходимые секреты и запускает все контейнеры с помощью `docker compose up -d`.
 
+Единственная внешняя зависимость — это **MongoDB**: backend подключается к кластеру MongoDB **Atlas**, который вы предоставляете. Всё остальное работает внутри контейнера.
+
 ## Оглавление
 
 <TOC/>
@@ -60,40 +64,82 @@ Chromium (используемый для генерации скриншото
 - Порты `3000`, `3100`, `8025`, `9000` и `9001` должны быть доступны на хосте.
 - Хост на Linux или macOS (или WSL2 на Windows).
 
+Всё остальное — Bun, Redis, MinIO, Chromium — поставляется внутри образа.
+
 ---
 
 ## Быстрый старт
 
-Извлеките и запустите опубликованный образ, указав учетные данные и секреты MongoDB Atlas:
+### 1. Запустите установщик
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Установщик проверяет наличие установленного и запущенного Docker, создает файл `./intlayer.env` с уже сгенерированными `BETTER_AUTH_SECRET` и `S3_SECRET_ACCESS_KEY`, и загружает образ. Он не запускает контейнер — backend не может загрузиться без ваших учетных данных базы данных.
+
+Повторный запуск установщика безопасен: существующий файл `intlayer.env` никогда не будет перезаписан, поэтому это также служит путем для обновления.
+
+### 2. Заполните ваши учетные данные
+
+Откройте `intlayer.env` и заполните значения, отмеченные `TODO`:
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+Файл также содержит закомментированные блоки для опциональных функций — [SMTP mailer](#global-mailer), `OPENAI_API_KEY` и OAuth провайдеров. Раскомментируйте необходимое.
+
+> Файл читается с помощью `docker run --env-file`, который не удаляет кавычки и рассматривает все значение после `=` как значение. Пишите значения без кавычек и оставляйте комментарии на отдельных строках.
+
+### 3. Запустите контейнер
+
+Это команда, которую выводит установщик по завершении:
 
 ```sh
 docker run -d --name intlayer \
+  --restart unless-stopped \
   -p 3000:3000 \
   -p 3100:3100 \
   -p 9000:9000 \
   -p 9001:9001 \
   -v intlayer-data:/data \
-  -e DB_ID="<atlas-user>" \
-  -e DB_MDP="<atlas-password>" \
-  -e DB_CLUSTER="<cluster>.xxxxx.mongodb.net" \
-  -e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \
-  -e S3_SECRET_ACCESS_KEY="$(openssl rand -hex 16)" \
-  -e RESEND_API_KEY="<your-resend-key>" \
-  aymericzip/intlayer-selfhost
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
 ```
 
-Затем откройте **http://localhost:3000**.
+Затем откройте **http://localhost:3000**. При первой загрузке инициализируются хранилища данных, поэтому подождите минуту.
 
-> Dashboard доступен на `localhost`. См. [Ограничения](#limitations) — опубликованный образ не поддерживает пользовательские домены.
+> Панель управления обслуживается на `localhost`. См. [Ограничения](#limitations) — пользовательские домены не поддерживаются опубликованным образом.
 
----
+### Параметры установщика
 
-## Быстрый старт
+Установщик читает несколько переменных окружения. Поскольку он передаётся в `sh`, передавайте их в shell, а не в `curl`:
 
 ```sh
-curl -fsSL https://intlayer.org/install.sh | sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
 ```
 
+| Переменная                | По умолчанию                                  | Описание                                |
+| ------------------------- | --------------------------------------------- | --------------------------------------- |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Образ для загрузки                      |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Где записать env файл                   |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Имя контейнера                          |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Именованный том, подключённый в `/data` |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Порт хоста для панели управления        |
+| `INTLAYER_API_PORT`       | `3100`                                        | Порт хоста для API                      |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Порт хоста для MinIO S3 API             |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Порт хоста для консоли MinIO            |
+
+> Четыре переменные портов изменяют только **хост** часть маппинга, выведённую в команде `docker run`. Опубликованный образ имеет `http://localhost:3000`, `http://localhost:3100` и `http://localhost:9000`, встроенные в bundle панели управления во время сборки, поэтому переназначение их оставляет браузер указывающим на старые порты. Сохраняйте значения по умолчанию, если вы не создаёте свой собственный образ — см. [Ограничения](#limitations).
+
+---
+
+## Быстрый старт
+
 Что делает установщик:
 
 1.  Проверяет наличие `docker` и `docker compose`.
@@ -117,8 +163,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | **minio**   | `minio/minio`                         | `9000` (S3), `9001` (консоль)         | S3-совместимое объектное хранилище для аватаров и скриншотов      |
 | **mailpit** | `axllent/mailpit`                     | `1025` (SMTP), `8025` (веб-интерфейс) | Локальный приемник транзакционных электронных писем               |
 
-Внутренние порты (mongo, redis) по умолчанию не открыты на хосте.
-
 > Порт MinIO `9000` должен быть доступен из браузера, поскольку загруженные активы (аватары, скриншоты) загружаются непосредственно из `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
 ---
@@ -174,8 +218,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Вход через LinkedIn OAuth                                                                 |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Вход через Atlassian OAuth                                                                |
 
----
-
 ### Глобальная почтовая система
 
 По умолчанию все транзакционные письма отправляются через Resend с использованием `RESEND_API_KEY`. Самостоятельно размещенные развертывания могут вместо этого маршрутизировать **все** письма — включая письма, не связанные с организацией, такие как сброс пароля и магические ссылки — через глобальную почтовую систему, настроенную с помощью переменных окружения.
@@ -261,16 +303,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## Обновление
 
-Повторный запуск установщика на существующем развертывании выполняет скользящее обновление:
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 Это загружает последние образы и перезапускает контейнеры с помощью `docker compose pull && docker compose up -d`. Существующие тома (`mongo-data`, `redis-data`, `minio-data`) сохраняются — потери данных нет.
 
-Для обновления вручную из директории `./intlayer/`:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -334,15 +368,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Найдите `MongoDB connection error` ближе к началу логов.
+
 ### Панель управления не может связаться с API
 
 Убедитесь, что `VITE_BACKEND_URL` соответствует URL, по которому бэкенд доступен из **браузера** (а не из сети Docker). Если вы изменили порт бэкенда или добавили обратный прокси, пересоберите образ панели управления:
 
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### Отсутствует корзина MinIO
 
 Если одноразовый сервис `minio-init` не запустился (или запустился до того, как MinIO был готов), создайте корзину вручную:

package/docs/tr/agent_skills.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2026-02-09
 updatedAt: 2026-03-03
-title: Agent Becerileri
+title: Agent Skills
 description: Intlayer Agent Skills'i kullanarak, Metadata, Sitemap ve Server Action'lar için kapsamlı kurulum kılavuzları da dahil olmak üzere AI ajanınızın projenizi anlamasını nasıl geliştireceğinizi öğrenin.
 keywords:
   - Intlayer
-  - Agent Becerileri
+  - Agent Skills
   - AI Ajanı
   - Uluslararasılaştırma
   - Dokümantasyon
@@ -19,13 +19,13 @@ history:
 author: aymericzip
 ---
 
-# Agent Becerileri
+# Agent Skills
 
 ## Kurulum
 
 ### CLI Kullanarak
 
-`intlayer init skills` komutu, projenizde ajan becerilerini kurmanın en kolay yoludur. Ortamınızı tespit eder ve tercih ettiğiniz platformlar için gerekli yapılandırma dosyalarını yükler.
+`intlayer init skills` komutu, projenizde Agent Skills kurmanın en kolay yoludur. Ortamınızı tespit eder ve tercih ettiğiniz platformlar için gerekli yapılandırma dosyalarını yükler.
 
 ```bash packageManager="npm"
 npx intlayer init skills
@@ -54,10 +54,10 @@ npx skills add aymericzip/intlayer-skills
 1. Komut Paletini açın (Ctrl+Shift+P veya Cmd+Shift+P).
 2. `Intlayer: Setup AI Agent Skills` yazın.
 3. Kullandığınız platformu seçin (ör. `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace` vb.).
-4. Yüklemek istediğiniz Becerileri seçin (ör. `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
+4. Yüklemek istediğiniz Agent Skills'i seçin (ör. `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
 5. Enter'a basın.
 
-## Beceri Listesi
+## Agent Skills Listesi
 
 **intlayer-config**
 

package/docs/tr/analytics.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-07-08
-updatedAt: 2026-07-08
+updatedAt: 2026-08-22
 title: Intlayer Analytics | İçerik gösterimini izleyin ve A/B testleri çalıştırın
 description: "@intlayer/analytics'in sayfa/yerel ayar görünümlerini ve içerik gösterimini nasıl izlediğini ve Intlayer içeriğiniz üzerinde A/B testleri çalıştırmak için onu nasıl kullanacağınızı keşfedin."
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - concept
   - analytics
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "`@intlayer/analytics` kuruluyken analitiği varsayılan olarak etkinleştir"
   - version: 9.0.0
     date: 2026-07-08
     changes: "Init doc — @intlayer/analytics paketi, provider/node düzeyinde izleme, A/B testi, gösterge paneli"
@@ -57,7 +60,7 @@ Intlayer zaten içerik [Varyantları (Variants)](https://github.com/aymericzip/i
 
 ## Kurulum
 
-`@intlayer/analytics` **eş düzey, isteğe bağlı (peer, optional)** bir bağımlılıktır — bir çerçeve (framework) paketi tarafından asla otomatik olarak kurulmaz. `intlayer`'ın yanına ekleyin:
+`@intlayer/analytics`, her framework paketinin (`react-intlayer`, `next-intlayer`, `vue-intlayer`, …) **isteğe bağlı bağımlılığıdır**; bu nedenle çoğu projede zaten bulunur. Kurulumunuz isteğe bağlı bağımlılıkları atlıyorsa (`npm install --no-optional`, …) paketi açıkça kurun:
 
 ```bash packageManager="npm"
 npm install @intlayer/analytics
@@ -75,11 +78,11 @@ pnpm add @intlayer/analytics
 bun add @intlayer/analytics
 ```
 
-Kurmazsanız, her entegrasyon noktası etkisiz bir işlem (no-op) olarak çözülür — aşağıdaki [Kurulmadığında sıfır maliyet](#kurulmadiginda-sifir-maliyet) bölümüne bakın.
+Analitiği açmak için paketi kurmanız yeterlidir: `analytics.enabled` varsayılan olarak `true`'dur ve paket projenizde bulunamadığında `@intlayer/config` bunu `false` olarak çözümler. Kurmazsanız, her entegrasyon noktası etkisiz bir işlem (no-op) olarak çözülür — aşağıdaki [Kurulmadığında sıfır maliyet](#kurulmadiginda-sifir-maliyet) bölümüne bakın.
 
 ## Yapılandırma
 
-Analytics, **mevcut `editor` yapılandırma bloğunu yeniden kullanır** — doldurulacak ayrı bir `analytics` yapılandırma şeması yoktur:
+Analitiğin başlaması için yapılandırma gerekmez: **varsayılan olarak etkindir** ve uç nokta ile proje anahtarı için **mevcut `editor` yapılandırma bloğunu yeniden kullanır**.
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import type { IntlayerConfig } from "intlayer";
@@ -100,6 +103,26 @@ export default config;
 
 Intlayer'ı kendi başınıza barındırıyorsanız (self-host), analiz otomatik olarak `editor.backendURL`'yi paylaştığı için kendi örneğinize (instance) işaret eder.
 
+### Devre dışı bırakma
+
+İsteğe bağlı `analytics` bloğu veri toplamayı ayarlar — ya da tamamen kapatır:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  analytics: {
+    enabled: false, // Varsayılan: true — tüm entegrasyonu paketin dışında bırakır
+    flushInterval: 20_000, // İki toplu gönderim arasındaki milisaniye
+    sampleRate: 1, // Kaydedilecek oturum oranı, 0 (hiçbiri) ile 1 (tümü) arasında
+  },
+};
+
+export default config;
+```
+
+`@intlayer/analytics` paketini kaldırmak `enabled: false` ile aynı etkiye sahiptir. Alanların tam listesi için [yapılandırma referansına](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md) bakın.
+
 ## Çerçeve (Framework) Desteği
 
 Analytics, `react-intlayer`'dan paylaşılan `IntlayerProvider`'a bağlanmıştır, bu nedenle bugün bu sağlayıcının kullanıldığı her yerde mevcuttur:
@@ -177,7 +200,7 @@ const variant = client?.getVariant("homepage-hero", [
 `@intlayer/analytics`, `@intlayer/editor` ile tamamen aynı isteğe bağlı bağımlılık desenini izler:
 
 - Her entegrasyon noktası, paketi **`try/catch` içine sarılmış dinamik bir `import()`** aracılığıyla yükler — `@intlayer/analytics`'i hiç kurmayan bir uygulama hiçbir zaman paket boyutu veya çalışma zamanı (runtime) maliyeti ödemez ve hiçbir zaman bir hata görmez;
-- `editor.clientId` yapılandırılmadığında `@intlayer/config` tarafından otomatik olarak `'false'` olarak ayarlanan derleme zamanı (compile-time) ortam değişkeni (`INTLAYER_ANALYTICS_ENABLED`), paketleyicilerin (bundlers) tüm entegrasyonu **ölü kod olarak elemesini (dead-code-eliminate)** sağlar;
+- derleme zamanı ortam değişkeni (`INTLAYER_ANALYTICS_ENABLED`), paket kurulu değilse, `analytics.enabled` `false` ise ya da `editor.clientId` yapılandırılmamışsa `@intlayer/config` tarafından otomatik olarak `'false'` yapılır ve paketleyicilerin tüm entegrasyonu **ölü kod olarak kaldırmasını (dead-code-eliminate)** sağlar;
 - Analytics, Intlayer düzenleyicisi (editor)/CMS önizleme (preview) iframe'i içinde devre dışı bırakılır, böylece düzenleyici oturumları (editor sessions) hiçbir zaman gerçek trafik olarak sayılmaz.
 
 ## Gösterge Paneli (Dashboard): Analytics sayfası

package/docs/tr/benchmark/tanstack.md

@@ -194,6 +194,8 @@ Karşılaşılan sorunlar:
 
 `Tolgee` daha önce bahsedilen sorunların çoğunu ele alıyor. Benzer yaklaşımlara sahip diğer araçlara göre başlamasının daha zor olduğunu gördüm. Tip güvenliği sağlamıyor, bu da eksik anahtarların build zamanında yakalanmasını çok zorlaştırıyor. Eksik anahtar algılama özelliği eklemek için Tolgee'nin API'larını kendi API'larımla sarmak zorunda kaldım.
 
+Package oldukça ağır (~11.1kb, bu `react-intlayer`'ın 2× katından fazladır).
+
 TanStack Start üzerinde de reaktivite problemlerim oldu: yerel ayar değiştiğinde, sağlayıcıyı yeniden render etmeye zorlamam ve yerel ayar değişikliği olaylarına abone olmam gerekiyordu, böylece başka bir dildeki yükleme düzgün davrandı.
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ TanStack Start'ta Next.js'e özgü tuzaklardan ( `setRequestLocale`, statik rend
 
 Yine de, `t('a.b.c')` üzerine kurulu teknoloji yığınlarıyla aynı büyük dezavantajları paylaşır: optimizasyonlar mümkündür ancak çok zaman alıcıdır ve büyük projeler kötü uygulamalara (ad alanları + dinamik yükleme + tipler) düşme riski taşır.
 
+Paket özellikle ağır (~17.3kb, bu `react-intlayer`'ın yaklaşık 3.5× kadarı).
+
 Mesaj formatları da farklıdır: `use-intl` ICU MessageFormat kullanırken, `i18next` kendi formatını kullanır - bu da bunları karıştırdığınızda araçları veya geçişleri karmaşıklaştırır.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ Mesaj formatları da farklıdır: `use-intl` ICU MessageFormat kullanırken, `i1
 
 `react-intl`, Format.js ekibinin performans odaklı bir uygulamasıdır. DX "verbose" kalır: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` karmaşıklık, ek JavaScript yükü ekler ve global i18n örneğini React ağacındaki birçok düğüme bağlar.
 
+Paket ayrıca ağırdır (~14.4kb, bu yaklaşık 3× `react-intlayer`).
+
 ### 4 - Öneriler
 
 Bu TanStack Start benchmark'ının `next-translate` (Next.js eklentisi + `getStaticProps`) için doğrudan bir karşılığı yoktur. Gerçekten olgun bir ekosisteme sahip bir `t()` API'si isteyen ekipler için `react-i18next` ve `use-intl` "makul" seçenekler olmaya devam ediyor, ancak sızıntıyı önlemek için optimizasyon yapmaya çok zaman ayırmaya hazırlıklı olun.