@intlayer/docs 9.3.3 → 9.4.0

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

@@ -31,48 +31,6 @@ Bu bölüm, React uygulamalarında içerik yerelleştirmesini etkinleştirmek i
 
 ## React'te Örnek Kullanım
 
-React bileşeninde `useIntlayer` hook'unun gösterimi:
-
-```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/tr/packages/solid-intlayer/useRewriteURL.md

@@ -46,8 +46,6 @@ const Layout = (props) => {
 
 ## Neden kullanılır?
 
-/// **Yetkili URL'ler**: Her yerelleştirilmiş içerik sürümü için tek bir URL uygulanmasını sağlar; bu SEO için çok önemlidir.
-
 - **Geliştirici Kolaylığı**: İç rota tanımlarınızı kanonik tutmanıza izin verirken, dışarıya kullanıcı dostu, yerelleştirilmiş yollar sunmanızı sağlar.
 - **Tutarlılık**: Kullanıcılar tercih ettiğiniz yerelleştirme kurallarına uymayan bir yolu elle yazdığında URL'leri düzeltir.
 

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

@@ -56,7 +56,7 @@ export default defineConfig({
 2. `build.optimize` değeri `true` (veya derlemeler için varsayılan olarak `true` olan `undefined`) olduğunda.
 3. Intlayer yapılandırmanızda `build.minify` değeri `true` olduğunda.
 
-Editörün tam ve insan tarafından okunabilir sözlük içeriğine ihtiyacı olduğundan, `editor.enabled` değeri `true` olduğunda otomatik olarak **devre dışı bırakılır**.
+`editor.enabled` `true` olduğunda eklenti çalışmaya devam eder ama **alan adı değiştirmeyi atlar**: yeniden adlandırma, yorumlayıcının dolaştığı içerik anahtarlarını yeniden yazar, bu yüzden görsel düzenleyicinin aldığı `keyPath`, düzenlediği birleştirilmemiş sözlüklerle artık eşleşmez. Boşluk sıkıştırma ve üst düzey meta veri temizleme etkin kalmaya devam eder.
 
 ## Neler Sıkıştırılır?
 

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

@@ -28,6 +28,8 @@ author: aymericzip
 
 `intlayerPrune` Vite eklentisi, uygulama paketinizden kullanılmayan sözlükleri tree-shake edip budamak için kullanılır. Bu, yalnızca gerekli çokdilli içeriği dahil ederek son bundle boyutunu azaltmaya yardımcı olur.
 
+> Plugin, [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/vite-intlayer/intlayer.md) kullanırken otomatik olarak dahil edilir ve yapılandırılır. Plugin stack'ini kendiniz oluşturuyorsanız, bunu yalnızca manuel olarak kaydetmeniz gerekir.
+
 ## Kullanım
 
 ### `intlayer()` kapsamında (önerilen)
@@ -115,4 +117,4 @@ Budama başarılı olduğunda, `intlayerPrune` ayrıca `pruneContext.dictionaryK
 2. `build.optimize` `true` olur (veya `undefined`, derlemeler için varsayılan olarak `true` olur).
 3. `build.purge` Intlayer yapılandırmanızda `true` olur.
 
-`editor.enabled` `true` olduğunda otomatik olarak **devre dışı bırakılır** çünkü düzenleyici tam sözlük içeriğine ihtiyaç duyar.
+`editor.enabled` `true` olduğunda etkin kalmaya devam eder: görsel düzenleyici, bu eklentinin asla dokunmadığı birleştirilmemiş sözlüklere karşı her düzenlemeyi `dictionaryKey` + `keyPath` üzerinden çözer ve temizlenen bir alan hiçbir bileşenin okumadığı bir alandır — bu yüzden asla render edilmez ve sayfada seçilemez.

package/docs/tr/per_locale_file.md

@@ -76,6 +76,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.tr.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "tr", // Önemli
+  "content": {
+    "multilingualContent": "Bileşenimin Başlığı",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -94,6 +105,8 @@ module.exports = helloWorldContent;
 
 > Önerilen: Bu format, Intlayer'ın görsel düzenleyicisini kullanırken veya çevirileri doğrudan kodda yönetirken en iyisidir.
 
+> Not: Her iki durumda da, içerik deklarasyon dosyası Intlayer tarafından tanınması için `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` adlandırma desenini takip etmelidir. `.[locale]` son eki isteğe bağlıdır ve yalnızca bir adlandırma kuralı olarak kullanılır.
+
 ### Yerel Ayar Başına Dosyalar İçin Global Yapılandırma
 
 Aşağıdakileri `intlayer.config.ts` dosyanıza ekleyerek yerel ayar başına dosyalar için global yapılandırmayı ayarlayabilirsiniz:
@@ -145,17 +158,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // Önemli
-  "content": {
-    "multilingualContent": "Title of my component",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -169,8 +171,6 @@ export default helloWorldContent;
 
 > Önemli: Yerel ayar alanının tanımlandığından emin olun. Bu, Intlayer'a dosyanın hangi dili temsil ettiğini söyler.
 
-> Not: Her iki durumda da, içerik bildirim dosyası Intlayer tarafından tanınmak için `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` adlandırma desenini takip etmelidir. `.[locale]` soneki isteğe bağlıdır ve sadece adlandırma kuralı olarak kullanılır.
-
 ## Formatları Karıştırma
 
 Aynı içerik anahtarı için her iki bildirim yaklaşımını da birleştirebilirsiniz. Örneğin:

package/docs/tr/readme.md

@@ -225,8 +225,8 @@ Intlayer ile başlamanıza yardımcı olacak kapsamlı dokümantasyonumuzu keşf
   <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=''>Backend</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ Intlayer ile başlamanıza yardımcı olacak kapsamlı dokümantasyonumuzu keşf
       <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/tr/releases/v6.md

@@ -118,6 +118,8 @@ export default config;
 
 İçerik dosyalarındaki `autoFill` alanını kullanarak her sözlük için ince ayar yapmaya devam edebilirsiniz. Tam referans için `doc/autoFill` ve `doc/dictionary/content_file` dosyalarına bakınız.
 
+Yine de `autoFill` alanını kullanarak sözlük başına ince ayar yapabilirsiniz. Intlayer önce sözlük başına yapılandırmayı dikkate alacak, ardından global yapılandırmaya geri dönecektir. [Auto-fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/autoFill.md) ve [Content file reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/content_file.md) adresinden tam referansa bakınız.
+
 ---
 
 ## Fill komutu: daha güvenli varsayılanlar
@@ -175,6 +177,20 @@ Detaylar için [Resmi VS Code Eklentisi](https://github.com/aymericzip/intlayer/
 
 ---
 
+MCP sunucusunu yeni özellikleri desteklemek için güncellendi.
+
+- Otomatik doldurma
+- Eksik çevirileri test et
+- Canlı güncellemeler
+- Logging
+- Doğrulama
+- Geçiş notları
+- Dokumentasyon
+
+> MCP server, Intlayer kullanan projelerin otomasyonu için yardımcı olur. Otomatik olarak oluşturulan kod için eksik çeviriler test eder. Config'inizi anlamanıza ve Intlayer belgelerini IDE'nize yerleştirmenize yardımcı olur.
+
+---
+
 ## Performans: 10× daha hızlı
 
 - Yerel ve uzak sözlüklerin paralel çözümü
@@ -296,8 +312,6 @@ Notlar:
 
 Tam rehberlik için [CMS ve Canlı Senkronizasyon](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md) ve [Yapılandırma](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md) sayfalarına bakın.
 
----
-
 ## Turbopack üzerinde dosyaları izlemek için paralel işlem
 
 `next dev --turbopack` komutuyla Next.js 14 ve üstü sürümlerinde geliştirme sunucusu olarak Turbopack kullanırken, sözlük değişiklikleri varsayılan olarak otomatik olarak algılanmayacaktır.

package/docs/tr/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer, tamamen kendi altyapınızda çalışabilir; Intlayer Cloud hesabı gerekmez. Tek bir komutla üretime hazır bir yığını başlatabilirsiniz:
 
+Tek bir komut her şeyi kurar:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 Yükleyici, bir `docker-compose.yml` ve bir `.env` indirir, gerekli gizli anahtarları otomatik olarak oluşturur ve tüm kapsayıcıları `docker compose up -d` ile başlatır.
 
+Tek dış bağımlılık **MongoDB**'dir: backend, sağladığınız bir MongoDB **Atlas** cluster'ına bağlanır. Diğer her şey kontainer içinde çalışır.
+
 ## İçindekiler
 
 <TOC/>
@@ -60,23 +64,77 @@ Chromium (Puppeteer ekran görüntüsü oluşturma için kullanılır) backend g
 - Ana bilgisayarda `3000`, `3100`, `8025`, `9000` ve `9001` bağlantı noktalarının kullanılabilir olması.
 - Bir Linux veya macOS ana bilgisayarı (veya Windows'ta WSL2).
 
+Diğer her şey — Bun, Redis, MinIO, Chromium — image içinde gelir.
+
 ---
 
-## Hızlı Başlangıç
+## Hızlı başlangıç
+
+### 1. Installer'ı çalıştırın
 
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
-Yükleyicinin yaptığı işlemler:
+Docker'ın yüklü ve çalışır durumda olduğunu doğrular, `BETTER_AUTH_SECRET` ve `S3_SECRET_ACCESS_KEY` zaten oluşturulmuş şekilde `./intlayer.env` dosyasını yazar ve image'ı çeker. Container'ı başlatmaz — backend, veritabanı kimlik bilgileriniz olmadan önyüklenemiyor.
+
+Installer'ı yeniden çalıştırmak güvenlidir: mevcut `intlayer.env` asla üzerine yazılmaz, bu nedenle güncelleme yolu olarak da işlev görür.
+
+### 2. Kimlik bilgilerinizi doldurun
+
+`intlayer.env` dosyasını açın ve `TODO` ile işaretlenmiş değerleri tamamlayın:
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+Dosya ayrıca isteğe bağlı özellikler için yorum satırı içeren bloklar taşır — [SMTP mailer](#global-mailer), `OPENAI_API_KEY` ve OAuth sağlayıcıları. İhtiyacınız olanların yorum satırını kaldırın.
+
+> Dosya `docker run --env-file` tarafından okunur ve tırnak işaretlerini kaldırmaz ve `=` işaretinden sonraki her şeyi değer olarak kabul eder. Çıplak değerler yazın ve açıklamaları kendi satırlarında tutun.
+
+### 3. Container'ı başlat
+
+Bu, yükleyici bittiğinde yazdıran komuttur:
+
+```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 \
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
+```
+
+Ardından **http://localhost:3000** adresini açın. İlk başlangıçta veri depolarını başlatır, bu nedenle bir dakika bekleyin.
+
+> Dashboard `localhost` üzerinde sunulur. Bkz. [Sınırlamalar](#limitations) — yayınlanan görüntü özel alanları desteklemez.
 
-1. `docker` ve `docker compose`'un mevcut olduğunu kontrol eder.
-2. `docker-compose.yml` ve `.env.example` dosyalarını `./intlayer/` dizinine indirir.
-3. `.env` dosyası mevcut değilse, örneği kopyalar ve `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` ve `S3_SECRET_ACCESS_KEY` için `openssl rand` aracılığıyla rastgele gizli anahtarlar oluşturur.
-4. `docker compose pull` + `docker compose up -d` komutlarını çalıştırır.
-5. URL'leri yazdırır: kontrol paneli `:3000`, API `:3100`, e-posta arayüzü `:8025`, MinIO konsolu `:9001`.
+### Installer ayarları
 
-Yığın çalışmaya başladıktan sonra **http://localhost:3000** adresini açın ve ilk hesabınızı oluşturun.
+Installer birkaç ortam değişkenini okur. `sh` içine yönlendirildiği için, onları `curl` yerine shell'e iletin:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
+```
+
+| Değişken                  | Varsayılan                                    | Açıklama                      |
+| ------------------------- | --------------------------------------------- | ----------------------------- |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Çekilecek image               |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Env dosyasının yazılacağı yer |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Container adı                 |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | `/data` dizinine bağlı volume |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Dashboard için host portu     |
+| `INTLAYER_API_PORT`       | `3100`                                        | API için host portu           |
+| `INTLAYER_S3_PORT`        | `9000`                                        | MinIO S3 API için host portu  |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | MinIO konsolu için host portu |
+
+> Dört port değişkeni yalnızca `docker run` komutunda yazdırılan eşlemenin **host** tarafını değiştirir. Yayınlanan image, derleme zamanında dashboard bundle'ına `http://localhost:3000`, `http://localhost:3100` ve `http://localhost:9000` derlenmiş olarak sahiptir, bu nedenle onları yeniden eşlemek tarayıcıyı eski portlara işaret ettirir. Kendi image'ınızı oluşturmıyorsanız varsayılanları tutun — [Sınırlamalar](#limitations)'a bakın.
 
 ---
 
@@ -103,8 +161,6 @@ Bir admin mevcut olduğunda, `/init` standart oturum açma sayfasına yönlendir
 | **minio**   | `minio/minio`                                     | `9000` (S3), `9001` (konsol)          | Avatarlar ve ekran görüntüleri için S3 uyumlu nesne depolama |
 | **mailpit** | `axllent/mailpit`                                 | `1025` (SMTP), `8025` (web UI)        | Yerel işlem e-postası alıcısı                                |
 
-Dahili bağlantı noktaları (mongo, redis) varsayılan olarak ana bilgisayara açık değildir.
-
 > MinIO bağlantı noktası `9000` tarayıcı tarafından erişilebilir olmalıdır çünkü yüklenen varlıklar (avatarlar, ekran görüntüleri) doğrudan `S3_PUBLIC_URL=http://localhost:9000/intlayer` adresinden yüklenir.
 
 ---
@@ -160,8 +216,6 @@ Dahili bağlantı noktaları (mongo, redis) varsayılan olarak ana bilgisayara a
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | LinkedIn OAuth girişi                                                       |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Atlassian OAuth girişi                                                      |
 
----
-
 ### Global mailer
 
 Varsayılan olarak, tüm işlemsel e-postalar Resend üzerinden `RESEND_API_KEY` kullanılarak gönderilir. Self-hosted dağıtımlar bunun yerine **tüm** e-postaları — şifre sıfırlamaları ve magic linkler gibi organizasyon dışı e-postalar dahil — ortam değişkenleriyle yapılandırılmış global bir mailer üzerinden yönlendirebilir.
@@ -247,16 +301,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## Yükseltme
 
-Mevcut bir dağıtım üzerinde yükleyiciyi yeniden çalıştırmak, kademeli bir yükseltme gerçekleştirir:
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 Bu, en son görüntüleri çeker ve kapsayıcıları `docker compose pull && docker compose up -d` ile yeniden başlatır. Mevcut birimler (`mongo-data`, `redis-data`, `minio-data`) korunur; veri kaybı olmaz.
 
-Manuel olarak `./intlayer/` dizini içinden yükseltme yapmak için:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -320,15 +366,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Log dosyasının üst kısmına yakın yerde `MongoDB connection error` (MongoDB bağlantı hatası) ifadesini arayın.
+
 ### Kontrol Paneli API'ye Ulaşamıyor
 
 `VITE_BACKEND_URL`'in backend'e **tarayıcıdan** (Docker ağı değil) erişilebilen URL ile eşleştiğini doğrulayın. Backend portunu değiştirdiyseniz veya bir ters proxy eklediyseniz, kontrol paneli görüntüsünü yeniden oluşturun:
 
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### MinIO Kovası Eksik
 
 Eğer `minio-init` tek seferlik servisi çalışmadıysa (veya MinIO hazır olmadan önce çalıştıysa), kovayı manuel olarak oluşturun:

package/docs/uk/CI_CD.md

@@ -100,6 +100,8 @@ npx intlayer fill --unpushed --mode fill    # Заповнює лише відс
 >
 > If you have multiple apps in your repo using separate intlayer instances, you can use the `--base-dir` argument like this:
 
+> Якщо у вашому репозиторіумі є кілька програм, які використовують окремі екземпляри intlayer, ви можете використовувати аргумент `--base-dir` таким чином:
+
 ```bash fileName=".husky/pre-push"
 # Додаток 1
 npx intlayer build --base-dir ./app1

package/docs/uk/agent_skills.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2026-02-09
 updatedAt: 2026-03-03
-title: Навички агента
+title: Agent Skills
 description: Дізнайтеся, як використовувати Intlayer Agent Skills, щоб покращити розуміння вашого проєкту вашим AI-агентом, включаючи вичерпні посібники з налаштування метаданих, карт сайту та серверних дій.
 keywords:
   - Intlayer
@@ -19,13 +19,13 @@ history:
 author: aymericzip
 ---
 
-# Навички агента
+# Agent Skills
 
 ## Налаштування
 
 ### Використання CLI
 
-Команда `intlayer init skills` - найпростіший спосіб налаштувати навички агента у вашому проєкті. Вона визначає ваше середовище й встановлює необхідні конфігураційні файли для обраних платформ.
+Команда `intlayer init skills` - найпростіший спосіб налаштувати Agent Skills у вашому проєкті. Вона визначає ваше середовище й встановлює необхідні конфігураційні файли для обраних платформ.
 
 ```bash packageManager="npm"
 npx intlayer init skills
@@ -54,10 +54,10 @@ npx skills add aymericzip/intlayer-skills
 1. Відкрийте палітру команд (Ctrl+Shift+P або Cmd+Shift+P).
 2. Введіть `Intlayer: Setup AI Agent Skills`
 3. Виберіть платформу, яку ви використовуєте (наприклад, `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace` тощо).
-4. Виберіть навички, які ви хочете встановити (наприклад, `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
+4. Виберіть Agent Skills, які ви хочете встановити (наприклад, `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
 5. Натисніть Enter.
 
-## Список навичок
+## Список Agent Skills
 
 **intlayer-config**
 

package/docs/uk/analytics.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-07-08
-updatedAt: 2026-07-08
+updatedAt: 2026-08-22
 title: Intlayer Analytics | Відстеження показів контенту та проведення A/B-тестування
 description: Дізнайтеся, як @intlayer/analytics відстежує перегляди сторінок/локалей та покази контенту, і як використовувати це для проведення A/B-тестування вашого контенту в Intlayer.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - concept
   - analytics
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "Аналітику увімкнено за замовчуванням, якщо встановлено `@intlayer/analytics`"
   - version: 9.0.0
     date: 2026-07-08
     changes: "Init doc — пакет @intlayer/analytics, відстеження на рівні провайдера/вузла, A/B-тестування, дашборд"
@@ -57,7 +60,7 @@ Intlayer вже дозволяє вам оголошувати [Варіанти
 
 ## Встановлення
 
-`@intlayer/analytics` — це **однорангова (peer), необов'язкова** залежність. Вона ніколи автоматично не встановлюється фреймворками. Додайте її разом з `intlayer`:
+`@intlayer/analytics` — це **необов'язкова залежність** кожного пакета фреймворку (`react-intlayer`, `next-intlayer`, `vue-intlayer`, …), тож у більшості проєктів вона вже є. Встановіть її явно, якщо ваша конфігурація пропускає необов'язкові залежності (`npm install --no-optional`, …):
 
 ```bash packageManager="npm"
 npm install @intlayer/analytics
@@ -75,11 +78,11 @@ pnpm add @intlayer/analytics
 bun add @intlayer/analytics
 ```
 
-Якщо ви її не встановите, всі точки інтеграції будуть розв'язуватися у порожні операції (no-op) — див. [Нульові витрати, якщо не встановлено](#нульові-витрати-якщо-не-встановлено) нижче.
+Щоб увімкнути аналітику, достатньо встановити пакет: `analytics.enabled` за замовчуванням дорівнює `true`, а `@intlayer/config` перетворює його на `false`, якщо пакет не знайдено у вашому проєкті. Якщо ви її не встановите, всі точки інтеграції будуть розв'язуватися у порожні операції (no-op) — див. [Нульові витрати, якщо не встановлено](#нульові-витрати-якщо-не-встановлено) нижче.
 
 ## Налаштування
 
-Аналітика **повторно використовує існуючий блок конфігурації `editor`** — вам не потрібно заповнювати окрему схему конфігурації для `analytics`:
+Аналітиці не потрібна конфігурація, щоб почати працювати: вона **увімкнена за замовчуванням** і **повторно використовує наявний блок конфігурації `editor`** для ендпоінта та ключа проєкту.
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import type { IntlayerConfig } from "intlayer";
@@ -100,6 +103,26 @@ export default config;
 
 Якщо ви самостійно розміщуєте (self-host) Intlayer, аналітика автоматично вказує на ваш власний екземпляр, оскільки вона використовує спільний `editor.backendURL`.
 
+### Як вимкнути
+
+Необов'язковий блок `analytics` налаштовує — або повністю вимикає — збір даних:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  analytics: {
+    enabled: false, // За замовчуванням: true — вилучає всю інтеграцію зі збірки
+    flushInterval: 20_000, // Мілісекунди між двома пакетними відправленнями
+    sampleRate: 1, // Частка записаних сесій, від 0 (жодної) до 1 (усі)
+  },
+};
+
+export default config;
+```
+
+Видалення `@intlayer/analytics` має той самий ефект, що й `enabled: false`. Повний перелік полів дивіться в [довіднику з конфігурації](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md).
+
 ## Підтримка фреймворків
 
 Аналітика вбудована у спільний `IntlayerProvider` з `react-intlayer`, тому вона доступна вже сьогодні скрізь, де використовується цей провайдер:
@@ -177,7 +200,7 @@ const variant = client?.getVariant("homepage-hero", [
 `@intlayer/analytics` дотримується того ж патерну опціональних залежностей, що й `@intlayer/editor`:
 
 - кожна точка інтеграції завантажує пакет через **динамічний `import()`, обгорнутий у `try/catch`** — додаток, який ніколи не встановлює `@intlayer/analytics`, не збільшує розмір збірки (bundle size) і не витрачає ресурси під час виконання, а також ніколи не бачить помилок;
-- змінна середовища часу компіляції (`INTLAYER_ANALYTICS_ENABLED`), що автоматично встановлюється в `'false'` пакетом `@intlayer/config`, коли не налаштовано `editor.clientId`, дозволяє бандлерам **видаляти весь код інтеграції (dead-code-eliminate)**;
+- змінна середовища часу компіляції (`INTLAYER_ANALYTICS_ENABLED`), яку `@intlayer/config` автоматично встановлює у `'false'`, коли пакет не встановлено, `analytics.enabled` дорівнює `false` або не налаштовано `editor.clientId`, дозволяє бандлерам **вилучити всю інтеграцію як мертвий код (dead-code-eliminate)**;
 - аналітика вимкнена всередині iframe попереднього перегляду редактора/CMS Intlayer, тому сесії в редакторі ніколи не враховуються як реальний трафік.
 
 ## Дашборд: Сторінка Analytics

package/docs/uk/benchmark/tanstack.md

@@ -194,6 +194,8 @@ history:
 
 `Tolgee` вирішує багато зі згаданих проблем. Проте почати роботу з ним здалося мені важче, ніж з іншими інструментами з подібними підходами. Він не забезпечує типізацію, що значно ускладнює виявлення відсутніх ключів під час компіляції. Мені довелося обертати Tolgee API своїми рішеннями, щоб додати перевірку відсутніх ключів.
 
+Пакет досить важкий (~11.1kb, що більш ніж у 2 рази більше за `react-intlayer`).
+
 На TanStack Start я також мав проблеми з реактивністю: при зміні локалі довелося примусово перерендерити провайдер і підписуватися на події зміни локалі, щоб завантаження іншою мовою працювало коректно.
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ history:
 
 Проте він має ті ж недоліки, що й стеки на базі `t('a.b.c')`: оптимізація можлива, але забирає багато часу, а великі проекти ризикують скотитися до поганих практик (простори імен + динамічне завантаження + типи).
 
+Пакет особливо важкий (~17.3kb, що становить близько 3.5× `react-intlayer`).
+
 Формати повідомлень також відрізняються: `use-intl` використовує ICU MessageFormat, тоді як `i18next` має власний формат - це ускладнює інструментарій або міграцію, якщо ви їх змішуєте.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ history:
 
 `react-intl` - це продуктивна реалізація від команди Format.js. DX залишається багатослівним: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` додає складності, додаткової роботи JavaScript та прив'язує глобальний екземпляр i18n до багатьох вузлів у React-дереві.
 
+Пакет також важкий (~14.4kb, що становить близько 3× `react-intlayer`).
+
 ### 4 - Рекомендації
 
 Цей бенчмарк TanStack Start не має прямого еквівалента `next-translate` (Next.js плагін + `getStaticProps`). Командам, які справді хочуть API у стилі `t()` зі зрілою екосистемою, `react-i18next` та `use-intl` залишаються "розумним" вибором, але будьте готові витратити багато часу на оптимізацію для уникнення витоків.

package/docs/uk/bundle_optimization.md

@@ -476,7 +476,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> Мініфікація пропускається (skipped), коли `optimize` становить `false`, або коли `editor.enabled` становить `true` (візуальний редактор потребує оригінальних імен полів для їх редагування).
+> Мініфікація пропускається, коли `optimize` становить `false`. Коли `editor.enabled` становить `true`, вона все одно виконується, але без етапу перейменування полів — візуальний редактор визначає правки через `keyPath`, тому оригінальні імена полів мають зберігатися.
 
 > У Next.js мініфікація також пропускається, коли `@intlayer/swc` не встановлено або його неможливо завантажити (Next.js нижче 16.1.0). Плагін — це та половина, що переписує звернення у вихідному коді, тож перейменування словників без нього залишило б ваш код таким, що читає імена полів, яких більше немає.
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> Очищення пропускається, коли `optimize` становить `false`, або коли `editor.enabled` становить `true`. У Next.js його додатково пропускають, коли `@intlayer/swc` недоступний і коли налаштовано викликачів з адаптерів сумісності.
+> Очищення пропускається, коли `optimize` становить `false`. Воно залишається активним, коли `editor.enabled` становить `true` — очищене поле не читає жоден компонент, тому редактор ніколи його не відображає. У Next.js його додатково пропускають, коли `@intlayer/swc` недоступний і коли налаштовано викликачів з адаптерів сумісності.
 
 > Очищення також консервативно пропускається, коли вихідний файл не може бути розпарсений, або коли результат виклику `useIntlayer` присвоюється змінній і далі передається способами, які статичний аналізатор не може відстежити (наприклад, поширюється у вигляді spread-об'єкта чи передається як prop без деструктуризації). В таких випадках весь словник зберігається повністю.
 

package/docs/uk/cli/ci.md

@@ -128,6 +128,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 ### Використання в CI/CD пайплайнах
 
+Запуск `intlayer init` створює два готові до використання workflow'и GitHub Actions для вас (див. [Scaffolded GitHub Actions](#scaffolded-github-actions) нижче). Приклад тут показує еквівалентне налаштування за допомогою команди `ci` для monorepo, де облікові дані вводяться для кожного проекту з `INTLAYER_PROJECT_CREDENTIALS`.
+
 У вашій конфігурації CI/CD (наприклад, GitHub Actions, GitLab CI) встановіть `INTLAYER_PROJECT_CREDENTIALS` як секрет:
 
 ```yaml

package/docs/uk/cli/doc-review.md

@@ -91,7 +91,15 @@ bun x intlayer doc review
 
 - **`--log`**: Режим тільки логування. Не перекладати з допомогою AI; замість цього логувати блоки, які потребують уваги (з номерами рядків і вмістом) для базової та цільової локалей, щоб допомогти іншому агенту згенерувати переклади.
 
-  > Приклад: `npx intlayer doc review --log`
+- The English source file content (BLOCK 1)
+- The Ukrainian translation to audit (BLOCK 2)
+- The mode you'd like me to use (`apply`, `report`, or `synthesis`)
+
+> Приклад: `npx intlayer doc review --mode report`
+
+> Приклад: `npx intlayer doc review --log`
+
+Незалежно від режиму, запуск завершується синтезом, який розраховує документи, вирівняні з їх базовим документом, та ті, які все ще мають блоки для редагування.
 
 **Параметри виводу записів:**
 

package/docs/uk/cli/fill.md

@@ -39,14 +39,6 @@ bun x intlayer fill
 
 Ця команда аналізує ваші файли декларацій контенту на предмет потенційних проблем, таких як відсутні переклади, структурні невідповідності або невідповідності типів. Якщо будуть виявлені якісь проблеми, **intlayer fill** запропонує або застосує оновлення, щоб тримати ваші словники консистентними та повними.
 
-Ключові моменти:
-
-- Розділяє великі JSON-файли на частини, щоб залишатися в межах вікна контексту моделі AI.
-- Повторює переклад, якщо формат виводу невірний.
-- Включає контекст, специфічний для додатка та файлу, для підвищення точності перекладу.
-- Зберігає існуючі переклади, не перезаписуючи їх.
-- Обробляє файли, частини та локалі паралельно, використовуючи систему черг для збільшення швидкості.
-
 ## Ключові моменти:
 
 - Розбиває великі JSON файли на частини, щоб залишатися в межах контекстного вікна AI моделі.

package/docs/uk/cli/index.md

@@ -127,6 +127,8 @@ Intlayer приймає кілька форматів файлів конфіг
 
 - **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/login.md)** - Автентифікація в Intlayer CMS та отримання облікових даних доступу
 
+> `intlayer login` видає **ключ доступу** (`clientId` / `clientSecret`), який використовують всі команди з обліковими даними. Секрет — це облікові дані на стороні сервера і ніколи не потрапляють до вашого bundle клієнта — див. [Keeping the access key safe](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/login.md#keeping-the-access-key-safe).
+
 ### Основні команди
 
 - **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/build.md)** - Створення словників з ваших файлів оголошення контенту

package/docs/uk/cli/login.md

@@ -118,6 +118,34 @@ INTLAYER_CLIENT_SECRET=your_client_secret
 }
 ```
 
+## Збереження ключа доступу в безпеці
+
+`intlayer login` видає **ключ доступу**: пару `clientId` / `clientSecret`, яку використовують усі команди з авторизацією (`push`, `pull`, `fill`, `configuration push`, `live`, …) для аутентифікації.
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+};
+
+export default config;
+```
+
+> **`clientSecret` — це серверна облікові дані.** Вони надають повний доступ до API в межах проекту — читання та запис ваших словників, вашого проекту та вашої організації. Зберігайте це в `.env` (git-ignored) або у вашому сховищі секретів CI, і ніколи не вставляйте це в файл конфігурації.
+
+Intlayer забезпечує це, а не просто документує:
+
+- `clientSecret` **видаляється з конфігурації, яку inline ваш bundler**, тому він не може потрапити в bundle браузера, незалежно від того, яку інтеграцію фреймворку ви використовуєте. Він читається лише на сервері під час виконання з навколишнього середовища.
+- `clientId` інший: це **публічний** ключ проекту, безпечний для розповсюдження, і використовується [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/analytics.md#how-events-are-authenticated) для отримання короткочасного токена лише для прийому.
+
+Закоментування `clientId` достатньо, щоб вимкнути кожну поведінку з авторизацією — отримання віддалених словників, доступ до CMS, аналітику — навіть якщо змінні середовища все ще визначені.
+
+Для конвеєрів CI надавайте перевагу [`ci` команді](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/ci.md), яка вводить облікові дані на час виконання однієї операції, замість того щоб зберігати їх.
+
 ## Ручна конфігурація
 
 Якщо браузер не відкрився автоматично, ви можете вручну перейти за URL, вказаним у терміналі.