@intlayer/docs 9.4.0-canary.0 → 9.4.0

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/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.

package/docs/tr/cli/ci.md

@@ -130,6 +130,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 CI/CD yapılandırmanızda (örneğin, GitHub Actions, GitLab CI), `INTLAYER_PROJECT_CREDENTIALS`'i bir sır olarak ayarlayın:
 
+> **AI erişimi**: `fill` komutu, çevirileri oluşturmak için AI erişimine ihtiyaç duyar. `INTLAYER_PROJECT_CREDENTIALS` içinden `ci` tarafından enjekte edilen kimlik bilgileri (Intlayer CMS erişim anahtarları) Intlayer backend aracılığıyla AI erişimi sağlar, bu nedenle ayrı bir AI sağlayıcı anahtarı gerekli değildir. Bunun yerine kendi sağlayıcı anahtarınızı kullanmayı tercih ederseniz, `intlayer ci fill` komutuna `--provider`, `--model` ve `--api-key` seçeneklerini geçin. `test` komutu AI erişimi gerektirmez.
+
 ```yaml
 # GitHub Actions örneği
 env:

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

@@ -91,7 +91,13 @@ Zaten çevrilmiş dosyaları incelemek ve çevirinin doğru olup olmadığını
 
 - **`--log`**: Yalnızca günlükleme modu. AI ile çeviri yapmaz; bunun yerine başka bir temsilcinin çevirileri oluşturmasına yardımcı olmak için temel ve hedef yerel ayarlar için dikkat gerektiren blokları (satır numaraları ve içerikleriyle birlikte) günlüğe kaydeder.
 
-  > Örnek: `npx intlayer doc review --log`
+I'm ready to audit the Turkish translation. However, I need you to provide:
+
+> Örnek: `npx intlayer doc review --mode report`
+
+> Örnek: `npx intlayer doc review --log`
+
+Hangi mod olursa olsun, çalıştırma, temel belgesiyle hizalı olan belgeleri ve düzenlenmesi gereken blokların hala var olan belgelerini listeleyen bir sentez ile sona erer.
 
 **Girdi çıktı seçenekleri:**
 

package/docs/tr/cli/fill.md

@@ -39,14 +39,6 @@ bun x intlayer fill
 
 Bu komut, içerik bildirim dosyalarınızı eksik çeviriler, yapısal tutarsızlıklar veya tür uyuşmazlıkları gibi potansiyel sorunlar açısından analiz eder. Herhangi bir problem bulursa, **intlayer fill** sözlüklerinizi tutarlı ve eksiksiz tutmak için güncellemeler önerir veya uygular.
 
-Önemli noktalar:
-
-- Büyük JSON dosyalarını AI modelinin bağlam penceresi sınırları içinde kalmak için parçalara böler.
-- Çıktı formatı yanlışsa çeviriyi yeniden dener.
-- Çeviri doğruluğunu artırmak için uygulama ve dosya özel bağlamını dahil eder.
-- Mevcut çevirileri üzerine yazmayarak korur.
-- Hızı artırmak için bir kuyruk sistemi kullanarak dosyaları, parçaları ve yerel ayarları paralel olarak işler.
-
 ## Ana Noktalar:
 
 - Büyük JSON dosyalarını AI modelinin context window limitine uymak için parçalara böler.

package/docs/tr/cli/index.md

@@ -127,6 +127,8 @@ Mevcut dillerin veya diğer parametrelerin nasıl yapılandırılacağını öğ
 
 - **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/login.md)** - Intlayer CMS ile kimlik doğrulaması yapın ve erişim kimlik bilgilerini alın
 
+> `intlayer login` bir **erişim anahtarı** (`clientId` / `clientSecret`) verir ve her kimlik bilgili komut bu anahtarı kullanır. Gizli anahtar, sunucu tarafı bir kimlik bilgisidir ve hiçbir zaman istemci paketinize ulaşmaz — [Erişim anahtarını güvenli tutma](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/login.md#keeping-the-access-key-safe) bölümüne bakın.
+
 ### Temel Komutlar
 
 - **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/build.md)** - İçerik bildirimi dosyalarından sözlüklerinizi oluşturun

package/docs/tr/cli/list_projects.md

@@ -52,8 +52,6 @@ Bu komut, Intlayer yapılandırma dosyalarını içeren dizinleri bularak tüm I
 
   > Örnek: `npx intlayer projects list --base-dir /path/to/workspace`
 
-  > Örnek: `npx intlayer projects list --base-dir /path/to/workspace`
-
 - **`--git-root`**: Temel dizin yerine git kök dizininden arama yapar. Bu, monorepo veya git deposundaki tüm Intlayer projelerini bulmak için faydalıdır.
 
   > Örnek: `npx intlayer projects list --git-root`
@@ -200,8 +198,4 @@ $ npx intlayer projects list --json
 - **CI/CD**: Otomatik iş akışlarında Intlayer projelerini doğrulama
 - **Dokümantasyon**: Intlayer kullanan tüm projeleri listeleyen dokümantasyon oluşturma
 
-Çıktı, her proje dizinine mutlak yollar sağlar; bu da bu dizinlere gitmeyi veya birden çok Intlayer projesi üzerinde betik tabanlı işlemler yapmayı kolaylaştırır.
-
-- **Dokümantasyon**: Intlayer kullanan tüm projelerin listesini içeren dokümantasyon oluşturma
-
 Çıktı, her proje dizinine mutlak yollar sağlar; bu da birden fazla Intlayer projesine kolayca erişmeyi veya bu projeler üzerinde betiklerle işlem yapmayı kolaylaştırır.

package/docs/tr/cli/login.md

@@ -122,6 +122,34 @@ typescript
 }
 ```
 
+## Erişim anahtarını güvende tutma
+
+`intlayer login` bir **erişim anahtarı** yayınlar: her kimlik doğrulamalı komut (`push`, `pull`, `fill`, `configuration push`, `live`, …) tarafından kimlik doğrulaması için kullanılan bir `clientId` / `clientSecret` çiftidir.
+
+```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` sunucu tarafı kimlik bilgisidir.** Proje kapsamlı tam API erişimi verir — sözlükleriniz, projeniz ve kuruluşunuzu okuyup yazabilir. Bunu `.env` dosyasında (git tarafından yok sayılan) veya CI gizli deposunda tutun ve asla yapılandırma dosyasında satır içine yazmayın.
+
+Intlayer bunu yalnızca belgelemek yerine zorunlu kılar:
+
+- `clientSecret` **bundler tarafından satır içine alınan yapılandırmadan çıkarılır**, bu nedenle hangi framework entegrasyonunu kullanırsanız kullanın bir tarayıcı bundle'ına ulaşamaz. Yalnızca sunucu tarafında çalışma zamanında ortamdan okunur.
+- `clientId` farklıdır: bu **genel** proje anahtarıdır, göndermek için güvenlidir ve [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/analytics.md#how-events-are-authenticated) tarafından kısa ömürlü, yalnızca alım tokeni elde etmek için kullanılır.
+
+`clientId` yü açıklama satırına almak, ortam değişkenleri hala tanımlanmış olsa bile her kimlik doğrulamalı davranışı (uzak sözlük getirme, CMS erişimi, analitik) devre dışı bırakmak için yeterlidir.
+
+CI pipeline'ları için, [`ci` komutu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/ci.md)nu tercih edin; bu, kimlik bilgilerini saklamanız yerine tek bir çalıştırmanın süresi boyunca enjekte eder.
+
 ## Manuel Yapılandırma
 
 Tarayıcı otomatik olarak açılmıyorsa, terminalde gösterilen URL'yi kopyalayarak tarayıcınızda manuel olarak ziyaret edebilirsiniz.

package/docs/tr/cli/watch.md

@@ -48,5 +48,3 @@ Bu komut, `npx intlayer build --watch --skip-prepare` komutunun eşdeğeridir.
 - **`--with`**: İzleme ile paralel olarak komutu başlatır.
 
   > Örnek: `npx intlayer watch --with "next dev --turbopack"`
-
-  > Örnek: `npx intlayer watch --with "next dev --turbopack"`

package/docs/tr/compiler.md

@@ -40,6 +40,12 @@ author: aymericzip
 
 ## Neden Intlayer Compiler Kullanmalısınız?
 
+- **Otomasyon**: Sözlüklere içerik el ile kopyalayıp yapıştırma işlemini ortadan kaldırır.
+
+- **Hız**: Optimize edilmiş içerik çıkarma, yapı işleminizin hızlı kalmasını sağlar.
+
+- **Developer Experience**: İçerik deklarasyonlarını kullanıldıkları yerde tutun, bakımı iyileştirin.
+
 - **Otomasyon**: İçeriğin sözlüklere manuel olarak kopyalanıp yapıştırılmasını ortadan kaldırır.
 - **Hız**: Derleme sürecinizin hızlı kalmasını sağlayan optimize edilmiş içerik çıkarımı.
 - **Geliştirici Deneyimi**: İçerik bildirimlerini kullanıldıkları yerde tutarak bakım kolaylığı sağlar.
@@ -54,6 +60,8 @@ Derleyici mükemmel bir "hemen çalışır" deneyimi sunarken, aynı zamanda far
 - **Sezgisel belirsizlik**: Derleyici, kullanıcıya yönelik içerik ile uygulama mantığı arasındaki farkı tahmin etmek zorundadır (örneğin, `className="active"`, durum kodları, ürün kimlikleri). Karmaşık kod tabanlarında, bu manuel açıklamalar ve istisnalar gerektiren yanlış pozitifler veya kaçırılan dizelerle sonuçlanabilir.
 - **Yalnızca statik çıkarım**: Derleyici tabanlı çıkarım statik analize dayanır. Yalnızca çalışma zamanında var olan dizeler (API hata kodları, CMS alanları vb.) derleyici tarafından tek başına keşfedilemez veya çevrilemez, bu nedenle hala tamamlayıcı bir çalışma zamanı i18n stratejisine ihtiyacınız vardır.
 
+- **Sadece statik çıkarma**: Derleyici tabanlı çıkarma, statik analize dayanır. Yalnızca çalışma zamanında var olan dizeler (API hata kodları, CMS alanları, vb.) derleyici tarafından tek başına keşfedilemez veya çevrilemez, bu nedenle yine de tamamlayıcı bir çalışma zamanı i18n stratejisine ihtiyacınız vardır.
+
 Daha derin bir mimari karşılaştırma için [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/tr/compiler_vs_declarative_i18n.md) blog yazısına bakın.
 
 Alternatif olarak, içeriğiniz üzerinde tam kontrolü korurken i18n sürecinizi otomatikleştirmek için, Intlayer ayrıca otomatik çıkarım komutu `intlayer extract` (bkz. [CLI dokümantasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/extract.md)) veya Intlayer VS Code uzantısının `Intlayer: extract content to Dictionary` komutunu (bkz. [VS Code uzantı dokümantasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/vs_code_extension.md)) sağlar.
@@ -94,6 +102,8 @@ export default defineConfig({
 });
 ```
 
+> Bağımsız `intlayerCompiler()` eklentisi, gelişmiş kurulumlar için hala dışa aktarılmaktadır. `intlayer()` ile birlikte kaydetmek güvenlidir — derleyici kendisini çoğaltmaz ve yalnızca bir kez çalışır.
+
 See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
 
 #### Framework Desteği
@@ -104,6 +114,10 @@ Vite eklentisi farklı dosya türlerini otomatik olarak algılar ve işler:
 - **Vue**: `@intlayer/vue-compiler` gerektirir.
 - **Svelte**: `@intlayer/svelte-compiler` gerektirir.
 
+- **Vue**: `@intlayer/vue-compiler` gerektirir.
+
+- **Svelte**: `@intlayer/svelte-compiler` gerektirir.
+
 Framework'ünüz için uygun derleyici paketini kurduğunuzdan emin olun:
 
 ```bash

package/docs/tr/configuration.md

@@ -734,8 +734,6 @@ Sunucu portu ve etkinleştirme durumu dahil olmak üzere yerleşik görsel edit
 | `liveSyncPort`               | Live Sync sunucusunun portu.                                                                                                                                                                       | `number`                          | `4000`                              | `4000`                                                                                          |                                                                                                                                                                                                                                            |
 | `liveSyncURL`                | Live Sync sunucusunun URL'si.                                                                                                                                                                      | `string`                          | `'http://localhost:{liveSyncPort}'` | `'https://example.com'`                                                                         | Varsayılan olarak localhost'u gösterir; uzak bir Live Sync sunucusu için değiştirilebilir.                                                                                                                                                 |
 
----
-
 ### Analitik Yapılandırması (Analytics)
 
 Intlayer analitiğiyle ilgili ayarları tanımlar: kullanıcılara gerçekten gösterilen içeriğin (sayfa görüntülemeleri, içerik gösterimleri) toplanması ve içerik üzerinde A/B testinin desteklenmesi.
@@ -987,6 +985,13 @@ Intlayer'ın iç yolları ve çıktı sonuçlarıyla ilgili ayarlar. Bu ayarlar
 
 Otomatik doldurma davranışı ve içerik oluşturma dahil olmak üzere sözlük işlemlerini kontrol eden parametreler.
 
+Bu sözlük yapılandırması iki ana amaca hizmet eder:
+
+1. **Varsayılan Değerler**: İçerik bildirimi dosyaları oluştururken varsayılan değerler tanımlayın
+2. **Fallback Davranışı**: Belirli alanlar tanımlanmadığında geri dönüş değerleri sağlayarak sözlük işlemi davranışını küresel olarak tanımlamanıza izin verin
+
+İçerik bildirim dosyaları ve yapılandırma değerlerinin nasıl uygulandığı hakkında daha fazla bilgi için [İçerik Dosyası Belgesi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/content_file.md) bölümüne bakın.
+
 | Alan                        | Açıklama                                                                                                                                                                    | Tür                                                                                                             | Varsayılan           | Örnek                                                                                       | Not                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `fill`                      | Otomatik doldurma (yapay zeka çevirisi) çıktı dosyalarının nasıl oluşturulacağını kontrol eder.                                                                             | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`               | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: varsayılan yol (kaynakla aynı dosya).<br/>• `false`: devredışı.<br/>• Dize/fonksiyon kalıbı dil başına dosyalar oluşturur.<br/>• Dil başına nesne: her dil kendi kalıbına karşılık gelir; `false` o dili yok sayar.<br/>• `{{locale}}` eklemek dil başına oluşturmayı tetikler.<br/>• Sözlük düzeyindeki `fill` her zaman bu genel ayardan önceliklidir.                                                                     |
@@ -1026,8 +1031,6 @@ Intlayer'dan gelen günlük çıkışını özelleştirmek için parametreler.
 | `mode`   | Logger modunu belirtir.     | `'default'` &#124; <br/> `'verbose'` &#124; <br/> `'disabled'` | `'default'`     | `'verbose'`        | • `'verbose'`: hata ayıklama için daha fazla bilgi günlüğe kaydeder.<br/>• `'disabled'`: logger'ı tamamen devre dışı bırakır. |
 | `prefix` | Günlük mesajları için önek. | `string`                                                       | `'[intlayer] '` | `'[özel öneğim] '` |                                                                                                                               |
 
----
-
 ### Yapay Zeka (AI) Yapılandırması
 
 Sağlayıcı, model ve API anahtarı dahil olmak üzere Intlayer'ın yapay zeka özelliklerini kontrol eden ayarlar.
@@ -1067,8 +1070,6 @@ Intlayer, maksimum esneklik için birden fazla yapay zeka sağlayıcısını des
 | `baseURL`            | Yapay zeka API'si için temel URL.                                                                                                           | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | Yok         | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Yerel veya özel bir yapay zeka API uç noktasına işaret edebilir.                                                                                                                             |
 | `dataSerialization`  | Yapay zeka özellikleri için veri serileştirme formatı.                                                                                      | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                                                       | `undefined` | `'toon'`                                                      | • `'json'`: varsayılan, güvenilir; daha fazla token kullanır.<br/>• `'toon'`: daha az token, daha az tutarlı.<br/>• Modele bağlam olarak ek parametreler iletilir (akıl yürütme çabası vb.). |
 
----
-
 ### Derleme (Build) Yapılandırması
 
 Intlayer'ın uygulamanızın uluslararasılaştırılmasını nasıl optimize ettiğini ve derlediğini kontrol eden parametreler.
@@ -1106,8 +1107,6 @@ Sözlükleri doğrudan bileşenlerinizden çıkaran Intlayer derleyicisini kontr
 | `noMetadata`          | `true` ise, derleyici sözlük meta verilerini (anahtar, içerik sarmalayıcı) çıktıdan çıkarır.                                                                                                                                                                                                                             | `boolean`                                                                                                       | `false`     | `false` → `{"key":"anahtarım","content":{"key":"değer"}}` <br/> `true` → `{"key":"değer"}`                                                               | • i18next veya ICU MessageFormat JSON çıktıları için yararlıdır.<br/>• `loadJSON` eklentisi ile iyi çalışır.                                                                       |
 | `dictionaryKeyPrefix` | Sözlük anahtar öneki                                                                                                                                                                                                                                                                                                     | `string`                                                                                                        | `''`        |                                                                                                                                                          | Çıkarılan sözlük anahtarları için isteğe bağlı önek ekleyin                                                                                                                        |
 
----
-
 ### Özel Şemalar (Custom Schemas)
 
 | Alan      | Açıklama                                                                          | Tür                         |

package/docs/tr/custom_domains.md

@@ -138,6 +138,32 @@ getMultilingualUrls("/about", { currentDomain: "intlayer.org" });
 
 Bu mutlak URL'ler, SEO için `<link rel="alternate" hreflang="...">` etiketlerinde kullanılmaya hazırdır.
 
+## Tür Çıkarımı
+
+`routing.domains` oluşturulan modül artışına serileştirilir, bu nedenle
+`getLocalizedUrl` ve `getLocalizedPath` dönüş tiplerini, bir etki alanı yönlendirmeli locale'in çözümlediği tam URL'ye daraltır — önek bastırma dahil.
+
+```ts
+// routing: { mode: 'prefix-no-default', domains: { en: 'intlayer.org', zh: 'intlayer.zh' } }
+
+getLocalizedUrl("/about", "zh");
+//     ^? "https://intlayer.zh/about" | "/about"
+
+getLocalizedPath("/about", "zh");
+//     ^? "/about"   (hiçbir zaman origin değil ve /zh/ öneki yok)
+```
+
+URL türü, işlevin döndürebileceği iki değerin **birleşimidir**: locale'in etki alanında kesin URL ve sayfa zaten o etki alanında yer aldığında döndürdüğü göreli URL. `getLocalizedPath`'in böyle bir belirsizliği yoktur - asla bir origin yayınlamaz - bu nedenle tek bir literal olarak kalır.
+
+Bir etki alanını paylaşan locale'ler, tür içinde normal öneklerini de tutar:
+
+```ts
+getLocalizedUrl("/about", "fr");
+//     ^? "https://intlayer.org/fr/about" | "/fr/about"
+```
+
+> `routing.domains` değiştirdikten sonra türleri yeniden oluşturun (`npx intlayer build` veya herhangi bir geliştirme sunucusu çalışması) - daraltma, yapılandırma dosyasının kendisinden değil, oluşturulan `__RoutingRegistry`'den gelir.
+
 ## Proxy Davranışı
 
 ### Next.js
@@ -170,6 +196,8 @@ GET intlayer.zh/about
 
 `intlayerProxy` Vite eklentisi, geliştirme sırasında aynı mantığı uygular:
 
+> Intlayer v9 itibariyle, `intlayerProxy()` doğrudan `intlayer()` eklentisine paketlenmiş ve `routing.enableProxy` seçeneği aracılığıyla varsayılan olarak etkinleştirilmiştir (`true` varsayılandır). Aşağıda gösterildiği gibi ayrı olarak kaydetmek artık isteğe bağlıdır — geriye dönük uyumluluk ve eklenti sırasını kontrol etmesi gereken kurulumlar için tutulmuştur. Devre dışı bırakmak için `routing.enableProxy: false` olarak ayarlayın. [v9 sürüm notlarına](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/releases/v9.md) bakın.
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/tr/custom_url_rewrites.md

@@ -248,7 +248,7 @@ Tarayıcı adres çubuğunun her zaman "pretty" (gösterişli) yerelleştirilmi
 
 <Tabs group='framework'>
   <Tab label="Next.js" value="nextjs">
-  
+
     ```tsx
     'use client';
 
@@ -263,7 +263,7 @@ Tarayıcı adres çubuğunun her zaman "pretty" (gösterişli) yerelleştirilmi
   </Tab>
 
   <Tab label="React Router" value="reactrouter">
-  
+
     ```tsx
     'use client';
 
@@ -279,7 +279,7 @@ Tarayıcı adres çubuğunun her zaman "pretty" (gösterişli) yerelleştirilmi
   </Tab>
 
   <Tab label="Vue" value="vue">
-  
+
     ```vue
     <script setup>
     import { useRewriteURL } from "vue-intlayer";
@@ -291,7 +291,7 @@ Tarayıcı adres çubuğunun her zaman "pretty" (gösterişli) yerelleştirilmi
 
   </Tab>
   <Tab label="Solid" value="solid">
-  
+
     ```tsx
     import { useRewriteURL } from "solid-intlayer";
 
@@ -303,7 +303,7 @@ Tarayıcı adres çubuğunun her zaman "pretty" (gösterişli) yerelleştirilmi
 
   </Tab>
   <Tab label="Svelte" value="svelte">
-  
+
     ```svelte
     <script>
     import { useRewriteURL } from "svelte-intlayer";
@@ -340,6 +340,8 @@ export function middleware(request: NextRequest) {
 
 SolidJS, Vue ve Svelte için `intlayerProxy` Vite eklentisi geliştirme sırasında yeniden yazmaları (rewrites) yönetir.
 
+> Intlayer v9'dan itibaren, `intlayerProxy()` doğrudan `intlayer()` eklentisinin içinde paketlenmiş ve `routing.enableProxy` seçeneği (`varsayılan olarak true`) aracılığıyla varsayılan olarak etkinleştirilmiştir. Aşağıda gösterildiği gibi ayrı olarak kaydetmek artık isteğe bağlıdır — geriye dönük uyumluluk ve eklenti sırasını kontrol etmesi gereken kurulumlar için tutulmuştur. Çıkmak için `routing.enableProxy: false` ayarlayın. [v9 sürüm notlarına](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/releases/v9.md) bakın.
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";