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

package/docs/uk/packages/svelte-intlayer/usePathname.md

@@ -0,0 +1,103 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Документація функції usePathname | svelte-intlayer
+description: Дізнайтеся, як використовувати функцію usePathname з пакету svelte-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Інтернаціоналізація
+  - Документація
+  - Svelte
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - svelte-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Додано утиліту usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Ініціалізація історії"
+author: aymericzip
+---
+
+# Інтеграція зі Svelte: Документація `usePathname`
+
+Функція `usePathname` повертає поточний шлях (pathname) браузера із видаленим сегментом локалі у вигляді Svelte-стору `Readable<string>`. Це корисно для створення навігації, що враховує локаль — наприклад, для визначення активного пункту меню — без необхідності вручну видаляти префікс локалі.
+
+## Імпорт `usePathname` у Svelte
+
+```typescript
+import { usePathname } from "svelte-intlayer";
+```
+
+## Огляд
+
+`usePathname` створює Svelte readable store, який зчитує `window.location.pathname`, видаляє префікс локалі за допомогою `getPathWithoutLocale`, та видає нове значення кожного разу, коли браузер ініціює подію `popstate` (навігація назад/вперед). Підписуйтесь на стор за допомогою синтаксису `$` у компонентах.
+
+## Використання
+
+```svelte fileName="src/components/NavItem.svelte"
+<script lang="ts">
+  import { usePathname } from "svelte-intlayer";
+
+  export let href: string;
+  export let label: string;
+
+  const pathname = usePathname();
+</script>
+
+<a {href} aria-current={$pathname === href ? "page" : undefined}>
+  {label}
+</a>
+```
+
+## Значення, що повертається
+
+| Тип                | Опис                                                                                              |
+| ------------------ | ------------------------------------------------------------------------------------------------- |
+| `Readable<string>` | Svelte readable store (реактивний стор), що містить поточний шлях (pathname) без префікса локалі. |
+
+## Поведінка
+
+- **Видалення локалі**: Видаляє початковий сегмент локалі (наприклад, `/uk/dashboard` → `/dashboard`).
+- **Реактивність**: Автоматично видає нове значення при подіях `popstate` (навігація назад/вперед у браузері).
+- **Безпека для SSR**: Повертає `""`, якщо об'єкт `window` недоступний.
+- **Очищення**: Слухач `popstate` автоматично видаляється, коли відписується останній підписник.
+
+## Приклад
+
+```svelte fileName="src/components/Sidebar.svelte"
+<script lang="ts">
+  import { usePathname } from "svelte-intlayer";
+
+  const links = [
+    { href: "/dashboard", label: "Дашборд" },
+    { href: "/settings", label: "Налаштування" },
+  ];
+
+  const pathname = usePathname();
+</script>
+
+<nav>
+  {#each links as link}
+    <a
+      href={link.href}
+      style:font-weight={$pathname === link.href ? "bold" : "normal"}
+    >
+      {link.label}
+    </a>
+  {/each}
+</nav>
+```
+
+## Пов'язані функції
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/svelte-intlayer/useLocale.md) — поточна локаль + перемикач локалей
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getPathWithoutLocale.md) — базова утиліта, що використовується цим хуком

package/docs/uk/packages/vue-intlayer/exports.md

@@ -14,6 +14,9 @@ slugs:
   - vue-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Додано утиліту usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Уніфікована документація для всіх експортів"
@@ -59,6 +62,7 @@ import "vue-intlayer";
 | `useDictionaryAsync`   | Те саме, що `useDictionary`, але обробляє асинхронні словники.                                                                          | -                                                                                                                     |
 | `useDictionaryDynamic` | Те саме, що `useDictionary`, але обробляє динамічні словники.                                                                           | -                                                                                                                     |
 | `useLocale`            | Повертає поточну локаль та функцію для її встановлення.                                                                                 | -                                                                                                                     |
+| `usePathname`          | Повертає поточний pathname як `ComputedRef<string>` з видаленим сегментом локалі. Реактивний до подій `popstate`.                       | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/vue-intlayer/usePathname.md)     |
 | `useRewriteURL`        | Composable на стороні клієнта для керування переписуванням URL. Автоматично оновлює URL, якщо існує локалізоване правило переписування. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/vue-intlayer/useRewriteURL.md) |
 | `useIntl`              | Повертає об'єкт Intl для поточної локалі.                                                                                               | -                                                                                                                     |
 | `useLoadDynamic`       | Composable для завантаження динамічних словників.                                                                                       | -                                                                                                                     |

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

@@ -0,0 +1,109 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Документація функції usePathname | vue-intlayer
+description: Дізнайтеся, як використовувати функцію usePathname з пакета vue-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Інтернаціоналізація
+  - Документація
+  - Vue
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - vue-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Додано утиліту usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Ініціалізація історії"
+author: aymericzip
+---
+
+# Інтеграція з Vue: Документація `usePathname`
+
+Функція `usePathname` повертає поточний шлях браузера (pathname) з видаленим сегментом локалі, як Vue `ComputedRef<string>`. Це корисно для створення навігації, що залежить від локалі — наприклад, щоб визначити, який елемент навігації є активним — без необхідності обробляти префікс локалі вручну.
+
+## Імпорт `usePathname` у Vue
+
+```typescript
+import { usePathname } from "vue-intlayer";
+```
+
+## Огляд
+
+`usePathname` створює Vue обчислюване посилання (computed ref), яке зчитує `window.location.pathname`, видаляє префікс локалі через `getPathWithoutLocale` і оновлює своє значення щоразу, коли браузер ініціює подію `popstate` (навігація назад/вперед). Це значення можна безпосередньо використовувати у ваших шаблонах Vue або функціях setup.
+
+## Використання
+
+```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>
+```
+
+## Значення, що повертається
+
+| Тип                   | Опис                                                                                |
+| --------------------- | ----------------------------------------------------------------------------------- |
+| `ComputedRef<string>` | Vue Computed Ref, що містить поточний шлях браузера (pathname) без префіксу локалі. |
+
+## Поведінка
+
+- **Видалення локалі (Locale stripping)**: Видаляє початковий сегмент локалі (наприклад, `/uk/dashboard` → `/dashboard`).
+- **Реактивність**: Оновлює значення при кожній події `popstate` (навігація браузера назад / вперед).
+- **Безпека для SSR**: Повертає `""`, коли `window` недоступний.
+- **Очищення (Cleanup)**: Слухач події `popstate` додається глобально під час ініціалізації і зазвичай не потребує ручного очищення в кожному компоненті завдяки тому, як Vue керує життєвим циклом.
+
+## Приклад
+
+```vue fileName="src/components/Sidebar.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Дашборд" },
+  { href: "/settings", label: "Налаштування" },
+];
+
+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>
+```
+
+## Пов'язане
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/vue-intlayer/useLocale.md) — поточна локаль + перемикач локалі
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getPathWithoutLocale.md) — базова утиліта, що використовується цим хуком

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

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-12-13
+updatedAt: 2026-06-21
 title: Плагін Sync JSON
 description: Синхронізуйте словники Intlayer із зовнішніми i18n JSON-файлами (i18next, next-intl, react-intl, vue-i18n та ін.). Залишайте ваш існуючий i18n-стек і використовуйте Intlayer для керування, перекладу та тестування повідомлень.
 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: "Додано опцію splitKeys (один словник на ключ простору імен верхнього рівня) для макетів next-intl / react-intl з одним файлом"
   - version: 7.5.0
     date: 2025-12-13
     changes: "Додано підтримку форматів ICU та i18next"
@@ -182,6 +185,7 @@ syncJSON({
   location?: string, // необов'язковий ярлик, за замовчуванням: "plugin"
   priority?: number, // необов'язковий пріоритет для вирішення конфліктів, за замовчуванням: 0
   format?: 'intlayer' | 'icu' | 'i18next', // необов'язковий форматтер, використовується для сумісності з intlayer runtime
+  splitKeys?: boolean, // необов'язково, розділяє один файл на один словник для кожного ключа простору імен верхнього рівня (автоматично визначається)
 });
 ```
 
@@ -205,6 +209,38 @@ syncJSON({
 }),
 ```
 
+#### `splitKeys` (boolean)
+
+Контролює, чи повинен один JSON-файл, **ключі першого рівня якого є просторами імен**, стати одним словником на ключ верхнього рівня, замість одного словника, що містить весь файл.
+
+Це відповідає моделі просторів імен таких бібліотек, як `next-intl` та `react-intl`, де один файл `messages/{locale}.json` групує кілька просторів імен за ключами першого рівня, кожен з яких адресується незалежно (наприклад, `useTranslations('Hero')` розв'язується до словника `Hero`).
+
+- `undefined` (за замовчуванням): **автоматично визначається** — файл розділяється, коли шаблон `source` не має сегмента `{key}` (один файл містить кожен простір імен), і залишається як єдиний словник в іншому випадку (один файл на ключ).
+- `true`: завжди розділяти кожен ключ верхнього рівня на окремий словник.
+- `false`: ніколи не розділяти; весь файл стає єдиним словником.
+
+Дано один файл `messages/{locale}.json`:
+
+```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, // мається на увазі, оскільки шаблон не має сегмента `{key}`
+}),
+```
+
+Це створює три словники — `Hero`, `Nav` та `About` — тому `useTranslations('Hero')` (next-intl) розв'язується коректно. При зворотному записі всі простори імен знову збираються в той самий файл для кожної локалі.
+
+> Коли ви зберігаєте явний сегмент `{key}` у вашому `source` (наприклад, `./locales/${locale}/${key}.json`), кожен файл вже є одним простором імен, тому розділення за замовчуванням вимкнено.
+
 ### Кілька джерел JSON та пріоритет
 
 Ви можете додавати кілька плагінів `syncJSON` для синхронізації різних джерел JSON. Це корисно, коли у вашому проєкті використовується декілька i18n бібліотек або різні структури JSON.
@@ -337,6 +373,9 @@ loadJSON({
 
   // Необов'язковий форматувач для JSON-вмісту
   format?: 'intlayer' | 'icu' | 'i18next', // за замовчуванням: 'intlayer'
+
+  // Розділяє один файл на один словник для кожного ключа верхнього рівня (автоматично визначається)
+  splitKeys?: boolean,
 });
 ```
 
@@ -358,10 +397,25 @@ loadJSON({
 }),
 ```
 
+#### `splitKeys` (boolean)
+
+Така ж поведінка, як і в [`syncJSON`](#splitkeys-boolean): коли один JSON-файл групує кілька просторів імен за ключами першого рівня, кожен ключ верхнього рівня стає окремим словником.
+
+- `undefined` (за замовчуванням): **автоматично визначається** — розділяється, коли шаблон `source` не має сегмента `{key}`, інакше — єдиний словник.
+- `true` / `false`: примусово ввімкнути або вимкнути розділення.
+
+```ts
+loadJSON({
+  source: ({ locale }) => `./messages/${locale}.json`,
+  format: "icu",
+  // splitKeys auto-enabled: `Hero`, `Nav`, `About`, … each become a dictionary
+}),
+```
+
 ### Поведінка та конвенції
 
 - Якщо ваша маска `source` містить плейсхолдер локалі, імпортуються лише файли для обраної `locale`.
-- Якщо в масці немає сегмента `{key}`, ключ словника, "index".
+- Якщо в масці немає сегмента `{key}`, кожен ключ верхнього рівня файлу за замовчуванням стає окремим словником (див. [`splitKeys`](#splitkeys-boolean)). Встановіть `splitKeys: false`, щоб замість цього завантажити весь файл як єдиний словник `index`.
 - Ключі виводяться зі шляхів файлів шляхом підстановки плейсхолдера `{key}` у вашому source builder.
 - Плагін використовує лише виявлені файли і не створює відсутні локалі чи ключі.
 - Шлях `fill` виводиться з вашого `source` і використовується для оновлення відсутніх значень через CLI, якщо ви погодитесь.

package/docs/ur/intlayer_with_angular_21.md

@@ -85,28 +85,44 @@ GitHub پر [ایپلیکیشن ٹیمپلیٹ](https://github.com/aymericzip/in
 
 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` فلیگ اختیاری ہے۔ اگر آپ AI ایجنٹ ہیں تو `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**

package/docs/ur/intlayer_with_fastify.md

@@ -61,27 +61,39 @@ GitHub پر [ایپلی کیشن ٹیمپلیٹ](https://github.com/aymericzip/i
 `fastify-intlayer` کا استعمال شروع کرنے کے لیے، npm کا استعمال کرتے ہوئے پیکیج انسٹال کریں:
 
 ```bash packageManager="npm"
-npm install intlayer fastify-intlayer
-npx intlayer init
+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` فلیگ اختیاری ہے۔ اگر آپ AI ایجنٹ ہیں تو `intlayer-cli init` استعمال کریں۔
 
+> یہ کمانڈ آپ کے ماحول کا پتہ لگائے گی اور مطلوبہ پیکیجز انسٹال کرے گی۔ مثال کے طور پر:
+
+```bash packageManager="npm"
+npm install intlayer fastify-intlayer
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer fastify-intlayer
-pnpm intlayer init
-
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer fastify-intlayer
-yarn intlayer init
-
 ```
 
 ```bash packageManager="bun"
 bun add intlayer fastify-intlayer
-bun x intlayer init
-
 ```
 
 ### ترتیب

package/docs/ur/intlayer_with_hono.md

@@ -62,24 +62,40 @@ GitHub پر [Application Template](https://github.com/aymericzip/intlayer-hono-t
 
 `hono-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` فلیگ اختیاری ہے۔ اگر آپ AI ایجنٹ ہیں تو `intlayer-cli init` استعمال کریں۔
+
+> یہ کمانڈ آپ کے ماحول کا پتہ لگائے گی اور مطلوبہ پیکیجز انسٹال کرے گی۔ مثال کے طور پر:
+
 ```bash packageManager="npm"
 npm install intlayer hono-intlayer
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer hono-intlayer
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer hono-intlayer
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer hono-intlayer
-bun x intlayer init
 ```
 
 ### سیٹ اپ (Setup)

package/docs/ur/intlayer_with_vite+lit.md

@@ -79,28 +79,44 @@ 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` فلیگ اختیاری ہے۔ اگر آپ AI ایجنٹ ہیں تو `intlayer-cli init` استعمال کریں۔
+
+> یہ کمانڈ آپ کے ماحول کا پتہ لگائے گی اور مطلوبہ پیکیجز انسٹال کرے گی۔ مثال کے طور پر:
+
 ```bash packageManager="npm"
 npm install intlayer lit-intlayer
 npm install vite-intlayer --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer lit-intlayer
 pnpm add vite-intlayer --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer lit-intlayer
 yarn add vite-intlayer --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer lit-intlayer
 bun add vite-intlayer --dev
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/ur/intlayer_with_vite+vanilla.md

@@ -80,28 +80,44 @@ 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` فلیگ اختیاری ہے۔ اگر آپ AI ایجنٹ ہیں تو `intlayer-cli init` استعمال کریں۔
+
+> یہ کمانڈ آپ کے ماحول کا پتہ لگائے گی اور مطلوبہ پیکیجز انسٹال کرے گی۔ مثال کے طور پر:
+
 ```bash packageManager="npm"
 npm install intlayer vanilla-intlayer
 npm install vite-intlayer --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vanilla-intlayer
 pnpm add vite-intlayer --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vanilla-intlayer
 yarn add vite-intlayer --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer vanilla-intlayer
 bun add vite-intlayer --dev
-bun x intlayer init
 ```
 
 - **intlayer**