@intlayer/docs 9.5.4 → 9.5.5

package/docs/ru/packages/remix-intlayer/useDictionary.md

@@ -0,0 +1,95 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Документация хука useDictionary | remix-intlayer
+description: Узнайте, как использовать хук useDictionary в приложениях Remix 3 для получения содержимого объектов словарей для текущей локали запроса.
+keywords:
+  - useDictionary
+  - dictionary
+  - remix
+  - remix-3
+  - Intlayer
+  - intlayer
+  - интернационализация
+  - Документация
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - useDictionary
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Начальная документация по хуку useDictionary"
+author: aymericzip
+---
+
+# Документация хука useDictionary
+
+Хук `useDictionary` преобразует импортированный или встроенный объект словаря и возвращает его содержимое, разрешенное для локали текущего запроса в приложениях Remix 3.
+
+В отличие от `useIntlayer`, который находит словари по строковому ключу из глобального реестра словарей, `useDictionary` принимает объект словаря напрямую.
+
+## Использование
+
+```ts fileName="src/views/home.ts"
+import { useDictionary } from "remix-intlayer";
+import homeContent from "./home.content";
+
+export const HomeView = () => {
+  const content = useDictionary(homeContent);
+
+  return `
+    <div>
+      <h1>${content.title}</h1>
+      <p>${content.subtitle}</p>
+    </div>
+  `;
+};
+```
+
+Вы также можете передавать встроенные словари, определенные с помощью функции `t()`:
+
+```ts
+import { useDictionary } from "remix-intlayer";
+import { t } from "intlayer";
+
+export const FooterView = () => {
+  const content = useDictionary({
+    key: "footer",
+    content: {
+      copyright: t({
+        ru: "Все права защищены.",
+        en: "All rights reserved.",
+        fr: "Tous droits réservés.",
+        es: "Todos los derechos reservados.",
+      }),
+    },
+  });
+
+  return `<footer>${content.copyright}</footer>`;
+};
+```
+
+## Параметры
+
+```ts
+useDictionary(dictionary, localeOrSelector?)
+```
+
+1. **`dictionary`**: Объект словаря или квалифицированная группа словарей.
+2. **`localeOrSelector`** (необязательно): Конкретная локаль или объект селектора (`{ item }`, `{ variant }`, при необходимости с `locale`). Имеет приоритет над локалью запроса, если указан.
+
+## Описание
+
+Хук выполняет следующие задачи:
+
+1. **Определение локали**: Считывает активную локаль запроса из хранилища `AsyncLocalStorage`, созданного промежуточным ПО `intlayer()`.
+2. **Разрешение содержимого**: Вычисляет переводы (`t()`), перечисления, условия и вложенные структуры в соответствии с разрешенной локалью.
+3. **Обработка селектора**: Применяет любые селекторы элементов или вариантов, указанные в аргументах.
+
+## Связанная документация
+
+- [Промежуточное ПО `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/intlayerMiddleware.md)
+- [Хук `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/useIntlayer.md)
+- [Хук `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/useLocale.md)

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

@@ -0,0 +1,94 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Документация хука useIntlayer | remix-intlayer
+description: Узнайте, как использовать хук useIntlayer в приложениях Remix 3 для доступа к локализованному контенту по ключу.
+keywords:
+  - useIntlayer
+  - dictionary
+  - remix
+  - remix-3
+  - Intlayer
+  - intlayer
+  - интернационализация
+  - Документация
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - useIntlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Начальная документация по хуку useIntlayer"
+author: aymericzip
+---
+
+# Документация хука useIntlayer
+
+Хук `useIntlayer` позволяет получать локализованный контент из словаря Intlayer по ключу в приложениях Remix 3.
+
+Он автоматически считывает активную локаль из контекста текущего запроса (через `AsyncLocalStorage`), поэтому вам не требуется передавать локаль через обработчики маршрутов, шаблоны представлений или компоненты.
+
+## Использование
+
+### В обработчиках маршрутов
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer, useIntlayer } from "remix-intlayer";
+
+const router = createRouter({
+  middleware: [intlayer()],
+});
+
+router.get("/api/welcome", () => {
+  const content = useIntlayer("home");
+
+  return Response.json({
+    title: content.title,
+    subtitle: content.subtitle,
+  });
+});
+```
+
+### В шаблонах представлений и компонентах
+
+```tsx fileName="src/views/home.ts"
+import { useIntlayer } from "remix-intlayer";
+
+export const HomeView = () => {
+  const content = useIntlayer("home");
+
+  return `
+    <main>
+      <h1>${content.title}</h1>
+      <p>${content.subtitle}</p>
+    </main>
+  `;
+};
+```
+
+## Параметры
+
+```ts
+useIntlayer(key, localeOrSelector?)
+```
+
+1. **`key`**: Уникальный ключ словаря (определенный в ваших файлах `.content.ts`).
+2. **`localeOrSelector`** (необязательно): Конкретная локаль или объект селектора (`{ item }`, `{ variant }`, при необходимости с `locale`). Если указан, переопределяет локаль, определенную из контекста запроса.
+
+## Описание
+
+Хук выполняет следующие задачи:
+
+1. **Получение локали из контекста**: Определяет текущую локаль из области `AsyncLocalStorage`, привязанной к запросу промежуточным ПО `intlayer()`.
+2. **Получение словаря**: Извлекает предварительно скомпилированный словарь, соответствующий переданному ключу.
+3. **Обработка переводов**: Обрабатывает переводы, перечисления, markdown и условный контент для полученной локали.
+4. **Резервная обработка (Fallback)**: При вызове вне контекста активного HTTP-запроса (например, в фоновых задачах или модульных тестах без промежуточного ПО) безопасно возвращается к настроенной `defaultLocale`.
+
+## Связанная документация
+
+- [Промежуточное ПО `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/intlayerMiddleware.md)
+- [Хук `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/useDictionary.md)
+- [Хук `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/useLocale.md)

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

@@ -0,0 +1,104 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Документация хука useLocale | remix-intlayer
+description: Узнайте, как использовать хук useLocale в приложениях Remix 3 для получения локали текущего запроса, локали по умолчанию и доступных локалей.
+keywords:
+  - useLocale
+  - locale
+  - remix
+  - remix-3
+  - Intlayer
+  - intlayer
+  - интернационализация
+  - Документация
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - useLocale
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Начальная документация по хуку useLocale"
+author: aymericzip
+---
+
+# Документация хука useLocale
+
+Хук `useLocale` из `remix-intlayer` предоставляет доступ к локали обрабатываемого в данный момент HTTP-запроса, а также к локали по умолчанию и списку доступных локалей, настроенных в проекте.
+
+## Использование
+
+В компоненте Remix (например, переключателе языков):
+
+```tsx fileName="src/components/LocaleSwitcher.tsx"
+import { type FC } from "react";
+import { Link } from "@remix-run/react";
+import { useLocale } from "remix-intlayer";
+import { getLocalizedUrl, getPathWithoutLocale } from "intlayer";
+
+export const LocaleSwitcher: FC = () => {
+  const { locale, availableLocales } = useLocale();
+  const pathWithoutLocale = getPathWithoutLocale();
+
+  return (
+    <nav>
+      <ul>
+        {availableLocales.map((localeItem) => (
+          <li key={localeItem} className="p-1">
+            <Link
+              href={getLocalizedUrl(pathWithoutLocale, localeItem)}
+              aria-current={localeItem === locale ? "page" : undefined}
+            >
+              {localeItem.toUpperCase()}
+            </Link>
+          </li>
+        ))}
+      </ul>
+    </nav>
+  );
+};
+```
+
+В обработчике маршрута:
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer, useLocale } from "remix-intlayer";
+
+const router = createRouter({
+  middleware: [intlayer()],
+});
+
+router.get("/api/locale-info", () => {
+  const { locale, defaultLocale, availableLocales } = useLocale();
+
+  return Response.json({
+    locale,
+    defaultLocale,
+    availableLocales,
+  });
+});
+```
+
+## Возвращаемые значения
+
+Хук возвращает объект типа `UseLocaleResult`:
+
+| Свойство           | Тип                 | Описание                                                           |
+| ------------------ | ------------------- | ------------------------------------------------------------------ |
+| `locale`           | `DeclaredLocales`   | Локаль, определенная для текущего запроса.                         |
+| `defaultLocale`    | `DeclaredLocales`   | Резервная локаль по умолчанию, настроенная в `intlayer.config.ts`. |
+| `availableLocales` | `DeclaredLocales[]` | Массив всех доступных локалей, настроенных в `intlayer.config.ts`. |
+
+## Описание
+
+1. **Определение в рамках запроса**: Во время активного запроса, обрабатываемого промежуточным ПО `intlayer()`, хук `useLocale` считывает разрешенную локаль из хранилища контекста запроса.
+2. **Резервное значение (Fallback)**: При вызове вне контекста запроса (например, во время скриптов инициализации или выполнения тестов) возвращается настроенная `defaultLocale`.
+
+## Связанная документация
+
+- [Промежуточное ПО `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/intlayerMiddleware.md)
+- [Хук `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/useIntlayer.md)
+- [Хук `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/remix-intlayer/useDictionary.md)

package/docs/ru/readme.md

@@ -199,7 +199,8 @@ const HomePage = () => {
   <li><a href="https://intlayer.org/doc/environment/create-react-app" rel=''>React CRA</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-react" rel=''>Vite + React</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-react" rel=''>Vite + React с компилятором</a></li>
-  <li><a href="https://intlayer.org/doc/environment/vite-and-react/compiler" rel=''>React-router-v7</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-react/react-router-v7" rel=''>React-router-v7</a></li>
+  <li><a href="https://intlayer.org/doc/environment/remix-3" rel=''>Remix 3</a></li>
   <li><a href="https://intlayer.org/doc/environment/tanstack-start" rel=''>Tanstack start</a>
     <ul>
       <li><a href="https://intlayer.org/doc/environment/tanstack-start/solid" rel=''>Solid</a></li>

package/docs/tr/how_works_intlayer.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-07
-updatedAt: 2025-09-07
+updatedAt: 2026-09-19
 title: Intlayer Nasıl Çalışır
 description: Intlayer'ın dahili olarak nasıl çalıştığını öğrenin. Intlayer'ı güçlü kılan mimari ve bileşenleri anlayın.
 keywords:
@@ -131,49 +131,105 @@ Intlayer, çeviri sürecinde belirli bir rolü olan birkaç paketten oluşur. İ
 
 `intlayer` paketi, içerik dosyalarında içeriği bildirmek için uygulamalarda kullanılır.
 
-### react-intlayer
+### Frontend Framework'leri
+
+<Tabs group="framework">
+  <Tab label="React" value="react">
 
 `react-intlayer` paketi, Intlayer sözlüklerini yorumlamak ve React uygulamalarında kullanılabilir hale getirmek için kullanılır.
 
-### next-intlayer
+  </Tab>
+  <Tab label="Next.js" value="nextjs">
 
 `next-intlayer` paketi, `react-intlayer` üzerine bir katman olarak kullanılır ve Intlayer sözlüklerini Next.js uygulamalarında kullanılabilir hale getirir. Çeviri ara yazılımı, yönlendirme veya `next.config.js` dosyası konfigürasyonu gibi Intlayer'ı bir Next.js ortamında çalışacak şekilde yapmak için gerekli özellikleri entegre eder.
 
-### vue-intlayer
+  </Tab>
+  <Tab label="Vue" value="vue">
 
 `vue-intlayer` paketi, Intlayer sözlüklerini yorumlamak ve Vue uygulamalarında kullanılabilir hale getirmek için kullanılır.
 
-### nuxt-intlayer
+  </Tab>
+  <Tab label="Nuxt" value="nuxt">
 
 `nuxt-intlayer` paketi, Intlayer sözlüklerini Nuxt uygulamalarında kullanılabilir hale getirmek için bir Nuxt modülü olarak kullanılır. Çeviri ara yazılımı, yönlendirme veya `nuxt.config.js` dosyası konfigürasyonu gibi Intlayer'ı bir Nuxt ortamında çalışacak şekilde yapmak için gerekli özellikleri entegre eder.
 
-### svelte-intlayer
+  </Tab>
+  <Tab label="Svelte" value="svelte">
 
 `svelte-intlayer` paketi, Intlayer sözlüklerini yorumlamak ve Svelte uygulamalarında kullanılabilir hale getirmek için kullanılır.
 
-### solid-intlayer (WIP)
+  </Tab>
+  <Tab label="Solid" value="solid">
 
 `solid-intlayer` paketi, Intlayer sözlüklerini yorumlamak ve Solid.js uygulamalarında kullanılabilir hale getirmek için kullanılır.
 
-### preact-intlayer
+  </Tab>
+  <Tab label="Preact" value="preact">
 
 `preact-intlayer` paketi, Intlayer sözlüklerini yorumlamak ve Preact uygulamalarında kullanılabilir hale getirmek için kullanılır.
 
-### angular-intlayer (WIP)
+  </Tab>
+  <Tab label="Angular" value="angular">
 
 `angular-intlayer` paketi, Intlayer sözlüklerini yorumlamak ve Angular uygulamalarında kullanılabilir hale getirmek için kullanılır.
 
-### express-intlayer
+  </Tab>
+  <Tab label="Astro" value="astro">
 
-`express-intlayer` paketi, bir Express.js arka ucunda Intlayer kullanmak için kullanılır.
+`astro-intlayer` paketi, Intlayer'ı Astro uygulamalarına entegre etmek için gerekli araçları sağlar. Locale tabanlı yönlendirme ve sözlük yönetimini yapılandırır.
+
+  </Tab>
+  <Tab label="Remix" value="remix">
+
+`remix-intlayer` paketi, Intlayer'ı Remix uygulamalarına entegre etmek için gerekli araçları sağlar. Locale tabanlı yönlendirme, sunucu tarafı bağlamı ve sözlük yönetimini yapılandırır.
 
-### react-native-intlayer
+  </Tab>
+  <Tab label="React Native" value="react-native">
 
 `react-native-intlayer` paketi, Intlayer'ı Metro paketleyici ile çalışacak şekilde entegre eden eklentiler sağlar.
 
-### lynx-intlayer
+  </Tab>
+  <Tab label="Lit" value="lit">
+
+`lit-intlayer` paketi, Lit uygulamalarında Intlayer sözlüklerini yorumlamak ve kullanmak için araçlar ve bileşenler sağlar.
+
+  </Tab>
+  <Tab label="Vanilla JS" value="vanilla">
+
+`vanilla-intlayer` paketi, Intlayer'ı vanilla JavaScript, HTML veya PHP uygulamalarına entegre etmek için araçlar sağlar.
+
+  </Tab>
+</Tabs>
+
+### Backend Framework'leri
+
+<Tabs group="backend">
+  <Tab label="Express" value="express">
+
+`express-intlayer` paketi, bir Express.js arka ucunda Intlayer kullanmak için kullanılır.
+
+  </Tab>
+  <Tab label="Fastify" value="fastify">
+
+`fastify-intlayer` paketi, Fastify uygulamaları için uluslararasılaştırmayı (internationalization / i18n) yönetmek üzere bir plugin sağlar. Kullanıcının locale'ini algılar ve request nesnesini dekorlar.
 
-`lynx-intlayer` paketi, Intlayer'ı Lynx paketleyici ile çalışacak şekilde entegre eden araçlar sağlar.
+  </Tab>
+  <Tab label="Hono" value="hono">
+
+`hono-intlayer` paketi, uluslararasılaştırmayı yönetmek için Hono uygulamaları için bir ara yazılım (middleware) sağlar. Kullanıcının yerel ayarını algılar ve bağlam nesnesini doldurur.
+
+  </Tab>
+  <Tab label="Elysia" value="elysia">
+
+`elysia-intlayer` paketi, Elysia uygulamaları için uluslararasılaştırmayı (internationalization / i18n) yönetmek üzere bir plugin sağlar. Kullanıcının locale'ini algılar ve route context'ine bir `intlayer` nesnesi enjekte eder.
+
+  </Tab>
+  <Tab label="AdonisJS" value="adonis">
+
+`adonis-intlayer` paketi, AdonisJS uygulamalarının uluslararasılaştırmayı yönetmesi için bir middleware sağlar. Kullanıcının yerel ayarını algılar ve çeviri fonksiyonları sağlar.
+
+  </Tab>
+</Tabs>
 
 ### vite-intlayer
 
@@ -183,6 +239,10 @@ Intlayer, çeviri sürecinde belirli bir rolü olan birkaç paketten oluşur. İ
 
 Create React App tabanlı uygulama ile Intlayer'ı entegre etmek için `react-scripts-intlayer` komutlarını ve eklentileri içerir. Bu eklentiler [craco](https://craco.js.org/) tabanlıdır ve [Webpack](https://webpack.js.org/) paketleyici için ek konfigürasyon içerir.
 
+### eslint-plugin-intlayer
+
+`eslint-plugin-intlayer` paketi, çevrilmemiş dizeleri yakalamak, sözlük tanımlarını doğrulamak ve i18n en iyi uygulamalarını zorunlu kılmak için ESLint ve oxlint kuralları sağlar.
+
 ### intlayer-editor
 
 `intlayer-editor` paketi, görsel düzenleyicinin kullanımına izin vermek için kullanılır. Bu paket, isteğe bağlıdır ve uygulamalarda yüklenebilir ve `react-intlayer` paketi tarafından kullanılacaktır.
@@ -216,6 +276,18 @@ Sunucu, Express tabanlıdır ve görsel düzenleyici isteklerini almak ve içeri
 
 `@intlayer/mcp` paketi, Intlayer ekosistemi için uyarlanmış AI destekli IDE yardımı sağlayan bir MCP (Model Context Protocol) sunucusu sağlar. Dokümantasyonu otomatik olarak yükler ve Intlayer CLI ile entegre olur.
 
+### @intlayer/lsp
+
+`@intlayer/lsp` paketi, Intlayer için özel olarak tasarlanmış bir Language Server Protocol (LSP) sunucusu sağlar. Tanıma Git, Tüm Referansları Bul, üzerine gelindiğinde önizleme, sözlük anahtarlarını otomatik tamamlama ve tanılama uyarıları gibi IDE özelliklerini getirir.
+
+### @intlayer/ai
+
+`@intlayer/ai` paketi, Intlayer uygulamaları için otomatik çeviri ve yapay zeka destekli içerik üretimini etkinleştiren SDK yetenekleri sağlar.
+
+### @intlayer/analytics
+
+`@intlayer/analytics` paketi, içerik gösterim metriklerini, sayfa/yerel ayar ve düğüm düzeyinde analizleri toplamak ve içerik A/B testlerini desteklemek için araçlar sağlar.
+
 ### @intlayer/dictionaries-entry
 
 `@intlayer/dictionaries-entry` paketi, Intlayer sözlüklerinin giriş yolunu döndürür: kökünden birleştirilmiş sözlükleri ve `/unmerged`, `/remote`, `/dynamic` ve `/fetch` alt yollarından birleştirilmemiş, uzak, dinamik ve fetch sözlüklerini. Tarayıcıdan dosya sistemini aramak imkansız olduğu için, Webpack veya Rollup gibi paketleyicileri kullanarak sözlüklerin giriş yolunu almak mümkün değildir. Paket ve alt yolları, Vite, Webpack ve Turbopack gibi çeşitli paketleyicilerde paketleme optimizasyonuna izin vermek için takma adlandırılmak üzere tasarlanmıştır.

package/docs/tr/intlayer_visual_editor.md

@@ -278,6 +278,13 @@ Düzenleyici sitenizi iframe içinde görüntüler, bu nedenle İçerik Güvenli
 
 Geliştirme ve hazırlık (staging) ortamları için tasarlanmıştır. Canlı üretim sitelerindeki anlık düzenlemeler için [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md) önerilir.
 
+</Question>
+<Question title="Görsel düzenleyicinin maliyeti nedir? İhtiyacım yoksa gereksiz yere yük oluşturur mu?">
+
+Intlayer görsel düzenleyicisi ayarlanmadığı sürece uygulamanız üzerinde **sıfır maliyete** sahiptir. Ek mantık yalnızca açıkça etkinleştirildiğinde ve ihtiyaç duyulduğunda yüklenir.
+
+Etkinleştirilse bile maliyet son derece düşüktür (yalnızca etkinleştirildiğinde dinamik olarak yüklenen +5 kB), çünkü mantığın ana kısmı [app.intlayer.org](https://app.intlayer.org) üzerindeki sunucu düzenleyicisi veya `intlayer-editor` paketi tarafından işlenir. Görsel düzenlemeye ihtiyaç duymadan yalnızca basit bir çeviri çözümüne ihtiyacınız varsa, Intlayer uygulamanıza hiçbir ek yük getirmez.
+
 </Question>
 <Question title="Görsel düzenleyici ücretsiz mi?">
 

package/docs/tr/intlayer_with_astro.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2026-06-23
+updatedAt: 2026-09-19
 title: "Astro i18n - Uygulamanızı çevirmek için eksiksiz kılavuz"
 description: "Artık i18next yok. 2026 yılı için çok dilli (i18n) Astro uygulaması oluşturma kılavuzu. Yapay zeka ajanlarıyla çevirin ve bundle boyutu, SEO ve performansı optimize edin."
 keywords:
@@ -18,6 +18,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-astro-template
 applicationShowcase: https://intlayer-astro-template.vercel.app
 history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "astro-intlayer'a useIntlayer / useLocale hook'ları ve Astro.locals ara yazılımı eklendi"
   - version: 8.9.0
     date: 2026-05-04
     changes: "Solid useIntlayer API kullanımını doğrudan özellik erişimine güncelle"
@@ -152,7 +155,7 @@ bun add intlayer astro-intlayer
   Konfigürasyon yönetimi, çeviriler, [içerik deklarasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/content_file.md), transpilasyon ve [CLI komutları](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/index.md) için i18n araçları sağlayan temel paket.
 
 - **astro-intlayer**
-  Intlayer'ı [Vite paketleyici](https://vite.dev/guide/why.html#why-bundle-for-production) ile bağlamak için Astro entegrasyon eklentisi; ayrıca kullanıcının tercih ettiği dili algılamak, çerezleri yönetmek ve URL yönlendirmelerini işlemek için ara yazılım (middleware) içerir.
+  Intlayer'ı [Vite paketleyicisi](https://vite.dev/guide/why.html#why-bundle-for-production) ile entegre etmek için Astro entegrasyon eklentisini, her isteğin yerel ayarını `Astro.locals.intlayer` içine çözümleyen bir ara yazılımı ve `useIntlayer` / `useDictionary` / `useLocale` hook'larını içerir. Aynı içe aktarma yolu, `.astro` frontmatter'ında sunucu uygulamasına ve `<script>` bloklarında istemci uygulamasına (`vanilla-intlayer` destekli) çözümlenir.
 
 </Step>
 <Step number={2} title="Projenizi Yapılandırın">
@@ -230,26 +233,28 @@ export default appContent;
 </Step>
 <Step number={5} title="Astro'da İçeriği Kullanma">
 
-Sözlükleri doğrudan `.astro` dosyalarınızda, `intlayer`'dan dışa aktarılan temel yardımcıları kullanarak tüketebilirsiniz.
+`astro-intlayer` tarafından dışa aktarılan hook'ları kullanarak sözlüklerinizi `.astro` dosyalarında kullanın. Bunlar `react-intlayer` ile aynı imzaları paylaşır: `useIntlayer("key")` bir sözlüğün içeriğini ve `useLocale()` herhangi bir argüman geçirmeden geçerli yerel ayarı döndürür.
+
+Yerel ayar, entegrasyonun kendi `src/middleware.ts` dosyanızın önünde sizin için kaydettiği `astro-intlayer` ara yazılımından gelir. Her istek için yerel ayarı sırasıyla URL ön ekinden, ardından istemci tarafından saklanan yerel ayardan (çerez veya başlık), ardından `Accept-Language` başlığından çözümler ve `Astro.locals.intlayer` içinde saklar. Önceden oluşturulmuş sayfalar her ziyaretçi için bir kez oluşturulduğundan yalnızca URL'yi kullanır.
+
+Ayrıca her sayfaya hreflang ve kurallı (canonical) bağlantılar gibi SEO meta verilerini eklemeli ve kullanıcıların dil değiştirmesine izin vermek için bir dil değiştirici eklemelisiniz.
 
 ```astro fileName="src/pages/index.astro"
 ---
+import { useIntlayer, useLocale } from "astro-intlayer";
 import {
-  getIntlayer,
-  getLocaleFromPath,
   getLocalizedUrl,
   defaultLocale,
   localeMap,
   getHTMLTextDir,
-  type LocalesValues,
 } from "intlayer";
 import LocaleSwitcher from "../components/LocaleSwitcher.astro";
 
-// Get the current locale from the URL (e.g. /es/about -> 'es')
-const locale = getLocaleFromPath(Astro.url.pathname) as LocalesValues;
+// Ara yazılım tarafından çözümlenen yerel ayar (ör. /tr/about -> 'tr')
+const { locale } = useLocale();
 
-// Get the content for the 'app' dictionary
-const { title } = getIntlayer("app", locale);
+// Bu yerel ayar için 'app' sözlüğünün içeriği
+const { title } = useIntlayer("app");
 ---
 
 <!doctype html>
@@ -301,6 +306,8 @@ const { title } = getIntlayer("app", locale);
 </html>
 ```
 
+> `Astro.locals.intlayer` ayrıca `locale`, `defaultLocale` ve `availableLocales` değerlerini kendi ara yazılımlarınıza ve uç noktalarınıza sunar. İstek yerel ayarını tek bir çağrı için geçersiz kılmak üzere ikinci argüman olarak bir yerel ayar veya seçici iletin (`useIntlayer("app", "fr")`, `useIntlayer("faq", { item: 2 })`).
+
 </Step>
 <Step number={6} title="Yerelleştirilmiş Yönlendirme">
 
@@ -325,44 +332,51 @@ Kullanıcıların diller arasında geçiş yapabilmesi için bir `LocaleSwitcher
 
 ```astro fileName="src/components/LocaleSwitcher.astro"
 ---
-import {
-  locales,
-  getLocaleName,
-  getLocalizedUrl,
-  getLocaleFromPath,
-  getPathWithoutLocale,
-  type LocalesValues,
-} from "intlayer";
+import { useLocale } from "astro-intlayer";
+import { getLocaleName, getLocalizedUrl, getPathWithoutLocale } from "intlayer";
 
-const locale = getLocaleFromPath(Astro.url.pathname) as LocalesValues;
+const { locale, availableLocales } = useLocale();
 const pathWithoutLocale = getPathWithoutLocale(Astro.url.pathname);
 ---
 
-<nav>
-  {
-    locales.map((localeItem) => (
-      <a
-        href={getLocalizedUrl(pathWithoutLocale, localeItem)}
-        data-locale={localeItem}
-        aria-current={localeItem === locale ? "page" : undefined}
-      >
-        {getLocaleName(localeItem)}
-      </a>
-    ))
-  }
+<nav aria-label="Languages">
+  <ul>
+    {
+      availableLocales.map((localeItem) => (
+        <li key={localeItem} class="p-1">
+          <a
+            href={getLocalizedUrl(pathWithoutLocale, localeItem)}
+            data-locale={localeItem}
+            aria-current={localeItem === locale ? "page" : undefined}
+          >
+            {getLocaleName(localeItem)}
+          </a>
+        </li>
+      ))
+    }
+  </ul>
 </nav>
 
 <script>
-  import { setLocaleInStorageClient, getLocalizedUrl, type LocalesValues } from "intlayer";
+  // Tarayıcıda aynı içe aktarma istemci uygulamasına çözümlenir
+  import { useLocale } from "astro-intlayer";
+  import { getLocalizedUrl, type LocalesValues } from "intlayer";
+
+  // Seçimi yerel ayar çerezinde saklar, ardından yerelleştirilmiş URL'ye gider
+  const { setLocale } = useLocale({
+    onLocaleChange: (newLocale) => {
+      window.location.href = getLocalizedUrl(window.location.pathname, newLocale);
+    },
+  });
 
   const localeLinks = document.querySelectorAll("[data-locale]");
 
   localeLinks.forEach((link) => {
-    link.addEventListener("click", (e) => {
+    link.addEventListener("click", (event) => {
       const locale = link.getAttribute("data-locale") as LocalesValues;
 
-      // Update the locale cookie
-      setLocaleInStorageClient(locale);
+      event.preventDefault();
+      setLocale(locale);
     });
   });
 </script>
@@ -372,6 +386,13 @@ const pathWithoutLocale = getPathWithoutLocale(Astro.url.pathname);
     display: flex;
     gap: 1rem;
   }
+  ul {
+    display: flex;
+    list-style: none;
+    padding: 0;
+    margin: 0;
+    gap: 0.5rem;
+  }
   a[aria-current="page"] {
     font-weight: bold;
     text-decoration: underline;
@@ -380,7 +401,10 @@ const pathWithoutLocale = getPathWithoutLocale(Astro.url.pathname);
 ```
 
 > **Kalıcılık Hakkında Not:**
-> İstemci tarafı betiğinde `setLocaleInStorageClient` kullanılması, kullanıcının dil tercihinin bir çerezde saklanmasını sağlar. Bu, Intlayer ara yazılımının seçimi hatırlamasına ve gelecekteki ziyaretlerde kullanıcıyı tercih ettiği dile otomatik olarak yönlendirmesine olanak tanır.
+> İstemci tarafındaki `useLocale` hook'undan `setLocale`, kullanıcının dil tercihini bir çerezde kaydeder. Bu, Intlayer ara yazılımının seçimi hatırlamasını ve gelecekteki ziyaretlerde kullanıcıyı otomatik olarak tercih ettiği dile yönlendirmesini sağlar.
+>
+> **Sunucu / İstemci Birlikte Çalışabilirliği:**
+> `astro-intlayer`, frontmatter'da sunucu hook'larına (`Astro.locals` okuyarak) ve `<script>` blokları ile adalarda (islands) `vanilla-intlayer`'ın istemci hook'larına aynı adlar ve içerik yapısıyla çözümlenir. `setLocale` ve `onChange` yalnızca istemcide etki eder; istemci deposunu başlatmak için orada bir kez `installIntlayer()` çağırın. `astro-intlayer/client`, istemci girişini açıkça sunar.
 
 </Step>
 <Step number={8} title="Sitemap ve Robots.txt">