@intlayer/docs 9.0.0-canary.2 → 9.0.0-canary.4

package/docs/tr/packages/vue-intlayer/usePathname.md

@@ -0,0 +1,109 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname Fonksiyon Dokümantasyonu | vue-intlayer
+description: vue-intlayer paketinden usePathname fonksiyonunu nasıl kullanacağınızı öğrenin
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Uluslararasılaştırma
+  - Dokümantasyon
+  - Vue
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - vue-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname yardımcı programı eklendi"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Geçmişi başlat"
+author: aymericzip
+---
+
+# Vue Entegrasyonu: `usePathname` Dokümantasyonu
+
+`usePathname` fonksiyonu, locale segmenti kaldırılmış mevcut tarayıcı pathname'ini bir Vue `ComputedRef<string>` olarak döndürür. Bu, locale önekini manuel olarak çıkarmak zorunda kalmadan, locale duyarlı bir navigasyon oluşturmak — örneğin, hangi nav öğesinin aktif olduğunu belirlemek — için faydalıdır.
+
+## Vue'da `usePathname` İçe Aktarımı
+
+```typescript
+import { usePathname } from "vue-intlayer";
+```
+
+## Genel Bakış
+
+`usePathname`, `window.location.pathname` okuyan, `getPathWithoutLocale` aracılığıyla locale önekini kaldıran ve tarayıcı her `popstate` olayı (geri/ileri gezinme) tetiklediğinde değerini güncelleyen bir Vue hesaplanmış referansı (computed ref) oluşturur. Bu değer doğrudan Vue şablonlarınızda veya setup fonksiyonlarınızda kullanılabilir.
+
+## Kullanım
+
+```vue fileName="src/components/NavItem.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const props = defineProps<{
+  href: string;
+  label: string;
+}>();
+
+const pathname = usePathname();
+</script>
+
+<template>
+  <a :href="href" :aria-current="pathname === href ? 'page' : undefined">
+    {{ label }}
+  </a>
+</template>
+```
+
+## Dönüş Değeri
+
+| Tür                   | Açıklama                                                                            |
+| --------------------- | ----------------------------------------------------------------------------------- |
+| `ComputedRef<string>` | Locale öneki olmadan geçerli tarayıcı pathname'ini içeren Vue Computed Ref nesnesi. |
+
+## Davranış
+
+- **Locale çıkarma**: Baştaki locale segmentini kaldırır (örn. `/tr/dashboard` → `/dashboard`).
+- **Reaktif**: Her `popstate` olayında (tarayıcının geri / ileri gezinmesi) değeri günceller.
+- **SSR güvenli**: `window` kullanılamadığında `""` döndürür.
+- **Temizleme (Cleanup)**: `popstate` dinleyicisi başlatıldığında global olarak eklenir ve Vue'nun yaşam döngüsünü nasıl yönettiği sayesinde genellikle bileşen başına manuel temizlik gerektirmez.
+
+## Örnek
+
+```vue fileName="src/components/Sidebar.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Kontrol Paneli" },
+  { href: "/settings", label: "Ayarlar" },
+];
+
+const pathname = usePathname();
+</script>
+
+<template>
+  <nav>
+    <a
+      v-for="link in links"
+      :key="link.href"
+      :href="link.href"
+      :style="{ fontWeight: pathname === link.href ? 'bold' : 'normal' }"
+    >
+      {{ link.label }}
+    </a>
+  </nav>
+</template>
+```
+
+## İlgili
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/vue-intlayer/useLocale.md) — mevcut locale + locale değiştirici
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getPathWithoutLocale.md) — bu hook tarafından kullanılan temel yardımcı program

package/docs/tr/plugins/sync-json.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-12-13
+updatedAt: 2026-06-21
 title: JSON Senkronizasyon Eklentisi
 description: Intlayer sözlüklerini üçüncü taraf i18n JSON dosyalarıyla (i18next, next-intl, react-intl, vue-i18n ve daha fazlası) senkronize edin. Mevcut i18n yapınızı koruyarak Intlayer ile mesajlarınızı yönetin, çevirin ve test edin.
 keywords:
@@ -24,6 +24,9 @@ slugs:
   - sync-json
 youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
 history:
+  - version: 9.0.0
+    date: 2026-06-21
+    changes: "next-intl / react-intl tek dosya düzenleri için splitKeys seçeneği eklendi (üst düzey ad alanı anahtarı başına bir sözlük)"
   - version: 7.5.0
     date: 2025-12-13
     changes: "ICU ve i18next format desteği eklendi"
@@ -62,7 +65,63 @@ pnpm add -D @intlayer/sync-json-plugin
 npm i -D @intlayer/sync-json-plugin
 ```
 
-## Hızlı başlangıç
+## Plugins
+
+Bu paket iki eklenti sağlar:
+
+- `loadJSON`: JSON dosyalarını Intlayer sözlüklerine yükler.
+  - Bu eklenti, bir kaynaktan JSON dosyalarını yüklemek için kullanılır ve Intlayer sözlüklerine yüklenecektir. Tüm kod tabanını tarayabilir ve belirli JSON dosyalarını arayabilir.
+    Bu eklenti şu durumlarda kullanılabilir:
+    - JSON'larınızın belirli bir konumda yüklenmesini zorunlu kılan bir i18n kütüphanesi kullanıyorsanız (örn: `next-intl`, `i18next`, `react-intl`, `vue-i18n`, vb.), ancak içerik bildirimlerinizi kod tabanınızda istediğiniz yere yerleştirmek istiyorsanız.
+    - Mesajlarınızı uzak bir kaynaktan (örn: bir CMS, bir API, vb.) almak ve mesajlarınızı JSON dosyalarında saklamak istiyorsanız da kullanılabilir.
+
+  > Arka planda, bu eklenti tüm kod tabanını tarayacak ve belirli JSON dosyalarını arayacak ve bunları Intlayer sözlüklerine yükleyecektir.
+  > Bu eklentinin çıktıyı ve çevirileri JSON dosyalarına geri yazmayacağını unutmayın.
+
+- `syncJSON`: JSON dosyalarını Intlayer sözlükleriyle senkronize eder.
+  - Bu eklenti, JSON dosyalarını Intlayer sözlükleriyle senkronize etmek için kullanılır. Verilen konumu tarayabilir ve belirli JSON dosyaları için desene uyan JSON'u yükleyebilir. Bu eklenti, başka bir i18n kütüphanesi kullanırken Intlayer'ın faydalarından yararlanmak istiyorsanız kullanışlıdır.
+
+## Her iki eklentiyi de kullanma
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON, syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // Mevcut JSON dosyalarınızı Intlayer sözlükleriyle senkronize tutun
+  plugins: [
+    /**
+     * src dizinindeki {key}.i18n.json desenine uyan tüm JSON dosyalarını yükleyecektir
+     */
+    loadJSON({
+      source: ({ key }) => `./src/**/${key}.i18n.json`,
+      locale: Locales.ENGLISH,
+      priority: 1, // Bu JSON dosyalarının `./locales/en/${key}.json` adresindeki dosyalara göre öncelikli olmasını sağlar
+      format: "intlayer", // JSON içeriğinin formatı
+    }),
+    /**
+     * Çıktıyı ve çevirileri locales dizinindeki JSON dosyalarına yükleyecek ve yazacaktır
+     */
+    syncJSON({
+      format: "i18next",
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      priority: 0,
+      format: "i18next",
+    }),
+  ],
+};
+
+export default config;
+```
+
+## `syncJSON` plugin
+
+### Hızlı başlangıç
 
 Eklentiyi `intlayer.config.ts` dosyanıza ekleyin ve mevcut JSON yapınıza işaret edin.
 
@@ -81,6 +140,7 @@ const config: IntlayerConfig = {
     syncJSON({
       // Yerel başına, ad alanı başına düzen (örneğin, next-intl, ad alanları ile i18next)
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      format: "icu",
     }),
   ],
 };
@@ -91,14 +151,27 @@ export default config;
 Alternatif: her yerel için tek dosya (i18next/react-intl yapılandırmalarında yaygın):
 
 ```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale }) => `./locales/${locale}.json`,
-  }),
-];
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncJSON({
+      format: "i18next",
+      source: ({ locale }) => `./locales/${locale}.json`,
+      format: "i18next",
+    }),
+  ],
+};
+
+export default config;
 ```
 
-### Nasıl çalışır
+#### Nasıl çalışır
 
 - Okuma: eklenti, `source` yapıcınızdan JSON dosyalarını keşfeder ve bunları Intlayer sözlükleri olarak yükler.
 - Yazma: derlemeler ve doldurmalar sonrası, yerelleştirilmiş JSON'u aynı yollara yazar (biçimlendirme sorunlarını önlemek için sonuna yeni satır ekleyerek).
@@ -112,6 +185,7 @@ syncJSON({
   location?: string, // isteğe bağlı etiket, varsayılan: "plugin"
   priority?: number, // isteğe bağlı öncelik, çakışma çözümü için, varsayılan: 0
   format?: 'intlayer' | 'icu' | 'i18next', // isteğe bağlı formatlayıcı, Intlayer runtime uyumluluğu için kullanılır
+  splitKeys?: boolean, // isteğe bağlı, tek bir dosyayı üst düzey anahtar başına bir sözlüğe böler (otomatik algılanır)
 });
 ```
 
@@ -136,18 +210,49 @@ syncJSON({
 }),
 ```
 
-## Birden fazla JSON kaynağı ve öncelik
+#### `splitKeys` (boolean)
+
+**İlk düzey anahtarları ad alanları olan** tek bir JSON dosyasının, tüm dosyayı tutan tek bir sözlük yerine, üst düzey anahtar başına bir sözlük haline gelip gelmeyeceğini kontrol eder.
+
+Bu, `next-intl` ve `react-intl` gibi kütüphanelerin ad alanı modeline uyar; burada bir `messages/{locale}.json` dosyası, ilk düzey anahtarlarıyla birden çok ad alanını gruplandırır ve her biri bağımsız olarak ele alınır (örneğin, `useTranslations('Hero')` `Hero` sözlüğüne çözümlenir).
+
+- `undefined` (varsayılan): **otomatik algılanır** — `source` deseninde `{key}` segmenti yoksa dosya bölünür (bir dosya her ad alanını tutar), aksi takdirde tek bir sözlük olarak kalır (anahtar başına bir dosya).
+- `true`: her üst düzey anahtarı her zaman kendi sözlüğüne böler.
+- `false`: asla bölmez; tüm dosya tek bir sözlük haline gelir.
+
+Tek bir `messages/{locale}.json` dosyası verildiğinde:
+
+```json fileName="messages/en.json"
+{
+  "Hero": { "title": "Full-stack developer" },
+  "Nav": { "work": "Work", "about": "About" },
+  "About": { "lead": "I build apps end to end." }
+}
+```
+
+```ts fileName="intlayer.config.ts"
+syncJSON({
+  format: "icu",
+  source: ({ locale }) => `./messages/${locale}.json`,
+  // splitKeys: true, // desenin `{key}` segmenti olmadığı için ima edilir
+}),
+```
+
+Bu, üç sözlük (`Hero`, `Nav` ve `About`) üretir, böylece `useTranslations('Hero')` (next-intl) doğru şekilde çözümlenir. Geri yazma işleminde, tüm ad alanları aynı yerel başına dosyada yeniden birleştirilir.
+
+> `source` içinde açık `{key}` segmentini koruduğunuzda (örneğin, `./locales/${locale}/${key}.json`), her dosya zaten bir ad alanıdır, bu nedenle bölme varsayılan olarak devre dışıdır.
+
+### Multiple JSON sources and priority
 
 Farklı JSON kaynaklarını senkronize etmek için birden fazla `syncJSON` eklentisi ekleyebilirsiniz. Bu, projenizde birden fazla i18n kütüphanesi veya farklı JSON yapıları olduğunda faydalıdır.
 
-### Öncelik sistemi
+#### Öncelik sistemi
 
 Birden fazla eklenti aynı sözlük anahtarını hedeflediğinde, `priority` parametresi hangi eklentinin öncelikli olduğunu belirler:
 
 - Daha yüksek öncelik numaraları, daha düşük olanlara karşı kazanır
-
 - `.content` dosyalarının varsayılan önceliği `0`'dır
-- Eklentilerin içerik dosyalarının varsayılan önceliği `-1`'dir
+- Eklentilerin varsayılan önceliği `0`'dır
 - Aynı önceliğe sahip eklentiler, yapılandırmada göründükleri sırayla işlenir
 
 ```ts fileName="intlayer.config.ts"
@@ -190,73 +295,140 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-### Çakışma çözümü
+## Load JSON plugin
 
-Aynı çeviri anahtarı birden fazla JSON kaynağında mevcutsa:
+### Hızlı başlangıç
 
-1. En yüksek önceliğe sahip eklenti nihai değeri belirler
-2. Daha düşük öncelikli kaynaklar, eksik anahtarlar için yedek olarak kullanılır
-3. Bu, eski çevirileri korumanıza ve yeni yapılara kademeli olarak geçiş yapmanıza olanak tanır
+Mevcut JSON dosyalarını Intlayer sözlükleri olarak almak için eklentiyi `intlayer.config.ts` dosyanıza ekleyin. Bu eklenti salt okunurdur (diske yazma yapmaz):
 
-## Entegrasyonlar
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON } from "@intlayer/sync-json-plugin";
 
-Aşağıda yaygın eşlemeler bulunmaktadır. Çalışma zamanınızı değiştirmeyin; sadece eklentiyi ekleyin.
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
 
-### i18next
+  plugins: [
+    // Kaynak ağacınızın herhangi bir yerinde bulunan JSON mesajlarını alın
+    loadJSON({
+      source: ({ key }) => `./src/**/${key}.i18n.json`,
+      // Eklenti örneği başına tek bir yerel yükleyin (yapılandırma varsayılan yereline ayarlanır)
+      locale: Locales.ENGLISH,
+      priority: 0,
+    }),
+  ],
+};
 
-Tipik dosya düzeni: `./public/locales/{locale}/{namespace}.json` veya `./locales/{locale}/{namespace}.json`.
+export default config;
+```
+
+Alternatif: yerel başına düzen, yine salt okunur (yalnızca seçilen yerel yüklenir):
 
 ```ts fileName="intlayer.config.ts"
-import { syncJSON } from "@intlayer/sync-json-plugin";
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON } from "@intlayer/sync-json-plugin";
 
-export default {
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
   plugins: [
-    syncJSON({
-      format: "i18next",
+    loadJSON({
+      // Bu desenden yalnızca Locales.FRENCH için dosyalar yüklenecektir
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      locale: Locales.FRENCH,
     }),
   ],
 };
+
+export default config;
 ```
 
-### next-intl
+### Nasıl çalışır
+
+- Keşfet: `source` yapıcınızdan bir glob oluşturur ve eşleşen JSON dosyalarını toplar.
+- Al: her JSON dosyasını sağlanan `locale` ile bir Intlayer sözlüğü olarak yükler.
+- Salt okunur: çıktı dosyalarını yazmaz veya biçimlendirmez; gidiş-dönüş senkronizasyonuna ihtiyacınız varsa `syncJSON` kullanın.
+- Otomatik doldurmaya hazır: `fill` deseni tanımlar, böylece `intlayer content fill` eksik anahtarları CLI aracılığıyla doldurabilir.
 
-Her yerel için JSON mesajları (genellikle `./messages/{locale}.json`) veya her ad alanı için.
+### API
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale, key }) => `./messages/${locale}/${key}.json`,
-  }),
-];
+```ts
+loadJSON({
+  // JSON'unuza giden yolları oluşturun. Yapınızda yerel segment yoksa `locale` isteğe bağlıdır
+  source: ({ key, locale }) => string,
+
+  // Bu eklenti örneği tarafından yüklenen sözlükler için hedef yerel
+  // configuration.internationalization.defaultLocale varsayılanına ayarlanır
+  locale?: Locale,
+
+  // Kaynağı tanımlamak için isteğe bağlı etiket
+  location?: string, // varsayılan: "plugin"
+
+  // Diğer kaynaklara karşı çakışma çözümü için kullanılan öncelik
+  priority?: number, // varsayılan: 0
+
+  // JSON içeriği için isteğe bağlı formatlayıcı
+  format?: 'intlayer' | 'icu' | 'i18next', // varsayılan: 'intlayer'
+
+  // Tek bir dosyayı üst düzey anahtar başına bir sözlüğe böler (otomatik algılanır)
+  splitKeys?: boolean,
+});
 ```
 
-Ayrıca bakınız: `docs/tr/intlayer_with_next-intl.md`.
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+JSON dosyalarını yüklerken sözlük içeriği için kullanılacak formatlayıcıyı belirtir. Bu, çeşitli i18n kütüphaneleriyle uyumlu farklı mesaj formatlama sözdizimlerini kullanmanıza olanak tanır.
 
-### react-intl
+- `'intlayer'`: Varsayılan Intlayer formatlayıcısı (varsayılan).
+- `'icu'`: ICU mesaj formatlamasını kullanır (react-intl, vue-i18n gibi kütüphanelerle uyumlu).
+- `'i18next'`: i18next mesaj formatlamasını kullanır (i18next, next-i18next, Solid-i18next ile uyumlu).
 
-Her yerel için tek JSON yaygındır:
+**Örnek:**
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale }) => `./locales/${locale}.json`,
-  }),
-];
+```ts
+loadJSON({
+  source: ({ key }) => `./src/**/${key}.i18n.json`,
+  locale: Locales.ENGLISH,
+  format: "icu", // Uyumluluk için ICU formatlaması kullan
+}),
 ```
 
-### vue-i18n
+#### `splitKeys` (boolean)
 
-Her yerel için ya da her ad alanı için tek bir dosya olabilir:
+[`syncJSON`](#splitkeys-boolean) ile aynı davranış: tek bir JSON dosyası, ilk düzey anahtarlarıyla birden çok ad alanını gruplandırdığında, her üst düzey anahtar kendi sözlüğü haline gelir.
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ key, locale }) => `./src/locales/${locale}/${key}.json`,
-  }),
-];
+- `undefined` (varsayılan): **otomatik algılanır** — `source` deseninde `{key}` segmenti yoksa bölünür, aksi takdirde tek bir sözlük olur.
+- `true` / `false`: bölmeyi zorlar veya devre dışı bırakır.
+
+```ts
+loadJSON({
+  source: ({ locale }) => `./messages/${locale}.json`,
+  format: "icu",
+  // splitKeys otomatik etkinleştirildi: `Hero`, `Nav`, `About`, … her biri bir sözlük haline gelir
+}),
 ```
 
+### Behavior and conventions
+
+- `source` maskeniz bir yerel yer tutucusu içeriyorsa, yalnızca seçilen `locale` için dosyalar alınır.
+- Maskenizde `{key}` segmenti yoksa, dosyanın her üst düzey anahtarı varsayılan olarak kendi sözlüğü haline gelir (bkz. [`splitKeys`](#splitkeys-boolean)). Bunun yerine tüm dosyayı tek bir `index` sözlüğü olarak yüklemek için `splitKeys: false` olarak ayarlayın.
+- Anahtarlar, `source` yapıcınızdaki `{key}` yer tutucusunun yerine geçirilerek dosya yollarından türetilir.
+- Eklenti yalnızca keşfedilen dosyaları kullanır ve eksik yerelleri veya anahtarları uydurmaz.
+- `fill` yolu, `source`'unuzdan çıkarılır ve CLI aracılığıyla eksik değerleri güncellemek için kullanılır.
+
+## Conflict resolution
+
+Aynı çeviri anahtarı birden fazla JSON kaynağında mevcutsa:
+
+1. En yüksek önceliğe sahip eklenti nihai değeri belirler
+2. Daha düşük öncelikli kaynaklar, eksik anahtarlar için yedek olarak kullanılır
+3. Bu, eski çevirileri korumanıza ve yeni yapılara kademeli olarak geçiş yapmanıza olanak tanır
+
 ## CLI
 
 Eşzamanlanmış JSON dosyaları diğer `.content` dosyaları gibi kabul edilecektir. Bu, tüm intlayer komutlarının eşzamanlanmış JSON dosyaları için de kullanılabilir olduğu anlamına gelir. Şunları içerir:

package/docs/uk/intlayer_with_adonisjs.md

@@ -59,24 +59,40 @@ author: aymericzip
 
 Щоб почати використовувати `adonis-intlayer`, встановіть пакет за допомогою npm:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> прапорець `--interactive` не є обов'язковим. Використовуйте `intlayer-cli init`, якщо ви є ШІ-агентом.
+
+> Ця команда виявить ваше середовище та встановить необхідні пакети. Наприклад:
+
 ```bash packageManager="npm"
 npm install intlayer adonis-intlayer
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer adonis-intlayer
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer adonis-intlayer
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer adonis-intlayer
-bun x intlayer init
 ```
 
 ### Налаштування

package/docs/uk/intlayer_with_analog.md

@@ -118,24 +118,40 @@ Intlayer оптимізовано для ідеальної роботи з Anal
 
 Встановіть необхідні пакети за допомогою npm:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> прапорець `--interactive` не є обов'язковим. Використовуйте `intlayer-cli init`, якщо ви є ШІ-агентом.
+
+> Ця команда виявить ваше середовище та встановить необхідні пакети. Наприклад:
+
 ```bash packageManager="npm"
 npm install intlayer angular-intlayer vite-intlayer
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer angular-intlayer vite-intlayer
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer angular-intlayer vite-intlayer
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer angular-intlayer vite-intlayer
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/uk/intlayer_with_angular_19.md

@@ -121,28 +121,44 @@ Intlayer оптимізовано для ідеальної роботи з Angu
 
 Встановіть необхідні пакети за допомогою npm:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> прапорець `--interactive` не є обов'язковим. Використовуйте `intlayer-cli init`, якщо ви є ШІ-агентом.
+
+> Ця команда виявить ваше середовище та встановить необхідні пакети. Наприклад:
+
 ```bash packageManager="npm"
 npm install intlayer angular-intlayer
 npm install @angular-builders/custom-webpack --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer angular-intlayer
 pnpm add @angular-builders/custom-webpack --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer angular-intlayer
 yarn add @angular-builders/custom-webpack --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer angular-intlayer
 bun add @angular-builders/custom-webpack --dev
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/uk/intlayer_with_angular_21.md

@@ -123,28 +123,44 @@ Intlayer оптимізовано для ідеальної роботи з Angu
 
 Встановіть необхідні пакети за допомогою npm:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> прапорець `--interactive` не є обов'язковим. Використовуйте `intlayer-cli init`, якщо ви є ШІ-агентом.
+
+> Ця команда виявить ваше середовище та встановить необхідні пакети. Наприклад:
+
 ```bash packageManager="npm"
 npm install intlayer angular-intlayer
 npm install @angular-builders/custom-esbuild --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer angular-intlayer
 pnpm add @angular-builders/custom-esbuild --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer angular-intlayer
 yarn add @angular-builders/custom-esbuild --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer angular-intlayer
 bun add @angular-builders/custom-esbuild --dev
-bun x intlayer init
 ```
 
 - **intlayer**