@intlayer/docs 9.3.1 → 9.3.3

package/docs/tr/dictionary/function_fetching.md

@@ -87,6 +87,29 @@ JSON dosyasından içerik getirmenin bir yolu yok, bunun yerine .ts veya .js dos
 
 Bu durumda, `fakeFetch` fonksiyonu sunucu yanıt süresini simüle etmek için bir gecikme taklit eder. Intlayer asenkron fonksiyonu çalıştırır ve sonucu `text` anahtarı için içerik olarak kullanır.
 
+## Uzak İçeriği Getirme
+
+Bir içerik alanına doğrudan bir promise de atayabilirsiniz. Intlayer, sözlükleri oluştururken bunu bekler ve çözümlenen değeri gömer:
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import type { Dictionary } from "intlayer";
+
+const remoteContent = {
+  key: "remote_content",
+  content: {
+    externalContent: fetch("https://example.com").then((res) => res.json()),
+  },
+} satisfies Dictionary;
+
+export default remoteContent;
+```
+
+```plaintext fileName="**/*.content.json" contentDeclarationFormat="json"
+JSON dosyasından içerik getirmenin bir yolu yok, bunun yerine .ts veya .js dosyası kullanın
+```
+
+> İstek derleme zamanında çalışır, bu nedenle getirilen veri sözlüğe gömülmüş bir anlık görüntüdür. Yenilemek için sözlüklerinizi yeniden oluşturun.
+
 ## React Bileşenlerinde Fonksiyon Tabanlı İçeriği Kullanma
 
 Bir React bileşeninde fonksiyon tabanlı içeriği kullanmak için, `react-intlayer`'dan `useIntlayer`'ı içe aktarmanız ve içeriği almak için içerik ID'si ile çağırmanız gerekir. İşte bir örnek:

package/docs/tr/eslint.md

@@ -0,0 +1,336 @@
+---
+createdAt: 2026-08-12
+updatedAt: 2026-08-13
+title: ESLint Eklentisi | Intlayer için Lint Kuralları
+description: eslint-plugin-intlayer ile sabit kodlanmış metinleri, Intlayer derleyicisinin optimize edemediği dinamik çağrıları ve kullanılmayan sözlük içeriğini yakalayın. React, Vue, Svelte, Angular ve Astro genelinde ESLint ve oxlint ile çalışır.
+keywords:
+  - Intlayer
+  - ESLint
+  - oxlint
+  - Linting
+  - i18n
+  - Uluslararasılaştırma
+  - no-raw-text
+  - Sabit kodlanmış metinler
+  - Kullanılmayan çeviriler
+  - Ölü içerik
+  - React
+  - Vue
+  - Svelte
+  - Angular
+slugs:
+  - doc
+  - eslint
+history:
+  - version: 9.3.1
+    date: 2026-08-12
+    changes: "Başlangıç geçmişi"
+author: aymericzip
+---
+
+# ESLint x OXLint Eklentisi
+
+`eslint-plugin-intlayer`, TypeScript'in yakalayamadığı i18n hatalarını tespit eder:
+
+1. Bir sözlüğe hiç eklenmemiş **sabit kodlanmış metinler (hardcoded text)**.
+2. Tip kontrolünden geçen ve çalışan ancak Intlayer derleyicisinin optimize edemediği **dinamik çağrılar**.
+3. **Ölü içerik (Dead content)** — projedeki hiçbir yerin okumadığı sözlükler ve alanlar (isteğe bağlı).
+
+Bilinmeyen sözlük anahtarları, bilinmeyen alan yolları ve eksik yerel ayarlar zaten derleme hataları olduğundan, eklenti bunları tekrar bildirmez.
+
+## Kurulum
+
+```bash packageManager="npm"
+npm install --save-dev eslint-plugin-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add --save-dev eslint-plugin-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add --dev eslint-plugin-intlayer
+```
+
+ESLint 9 veya üzerini gerektirir (flat config). ESLint 10 desteklenir.
+
+## Kullanım
+
+Eklenti hem ESLint hem de [oxlint](https://oxc.rs) üzerinde aynı kurallar ve aynı seçeneklerle çalışır.
+
+<Tabs defaultTab="eslint">
+  <Tab label="ESLint" value="eslint">
+
+```javascript fileName="eslint.config.mjs"
+import intlayer from "eslint-plugin-intlayer";
+
+export default [...intlayer.configs.recommended];
+```
+
+Veya bir yapılandırmayı yayın ve önem düzeylerini kendiniz belirleyin:
+
+```javascript fileName="eslint.config.mjs"
+import intlayer from "eslint-plugin-intlayer";
+
+export default [
+  ...intlayer.configs.recommended,
+  {
+    rules: {
+      "intlayer/no-raw-text": "warn",
+      "intlayer/static-dictionary-key": "error",
+      "intlayer/no-dynamic-field-access": "error",
+      "intlayer/enforce-adapter-import": "warn",
+      "intlayer/no-unused-content": "warn",
+    },
+  },
+];
+```
+
+  </Tab>
+  <Tab label="oxlint" value="oxlint">
+
+```json fileName=".oxlintrc.json"
+{
+  "jsPlugins": ["eslint-plugin-intlayer"],
+  "rules": {
+    "intlayer/no-raw-text": "warn",
+    "intlayer/static-dictionary-key": "error",
+    "intlayer/no-dynamic-field-access": "error",
+    "intlayer/enforce-adapter-import": "warn"
+  }
+}
+```
+
+İki uyarı: oxlint'in JS eklenti desteği henüz alfa aşamasındadır ve oxlint özel ayrıştırıcıları (custom parsers) desteklemez — bu nedenle `.vue`, `.svelte`, `.astro` ve Angular şablonları orada denetlenmez. JS/TS/JSX dosyalarınız için oxlint'i çalıştırın ve geri kalanı için ESLint'i kullanın.
+
+`no-unused-content` yukarıda kasıtlı olarak hariç tutulmuştur: kural bağlamından çalışma dizinine ve denetlenen dosya yoluna ihtiyaç duyar; alfa JS eklenti köprüsü bunu garanti etmez. ESLint altında çalıştırın.
+
+  </Tab>
+</Tabs>
+
+### Yapılandırmalar (Configs)
+
+| Yapılandırma    | `no-raw-text`              | `static-dictionary-key` | `no-dynamic-field-access` | `enforce-adapter-import` | `no-unused-content` |
+| --------------- | -------------------------- | ----------------------- | ------------------------- | ------------------------ | ------------------- |
+| `recommended`   | warn                       | error                   | error                     | off                      | off                 |
+| `strict`        | error (+ JSX dışı dizeler) | error                   | error                     | error                    | off                 |
+| `contract-only` | off                        | error                   | error                     | off                      | off                 |
+
+`recommended`, `no-raw-text` kuralını kasıtlı olarak `warn` seviyesinde tutar: bunu mevcut bir kod tabanına yöneltmek tüm çevrilmemiş dizeleri aynı anda ortaya çıkarır ve bu durum derlemenizi ilk günden bozmamalıdır.
+
+`enforce-adapter-import` varsayılan olarak kapalıdır — istiyorsanız açıkça etkinleştirin.
+
+`no-unused-content`, `strict` dahil tüm yapılandırmalarda kapalıdır. Intlayer yapılandırmanızı okuyan ve kaynak dosyalarınızı diskten tarayan tek kuraldır; bu nedenle açılması, bir ön ayarın sizin yerinize yapmasından ziyade bilinçli bir seçim olmalıdır.
+
+## Kurallar
+
+### `no-raw-text`
+
+Bir sözlükte bildirilmemiş kullanıcıya yönelik metinleri bildirir. `intlayer extract` ile aynı algılamayı kullanır; bu nedenle marka adları, CSS sınıfları ve teknik tanımlayıcılar yoksayılır.
+
+```jsx
+// ✗ Bildirildi
+<h1>Welcome to our documentation</h1>
+<input placeholder="Enter your email address" />
+
+// ✓ Sorunsuz
+const { title } = useIntlayer("home");
+<h1>{title}</h1>
+```
+
+İçerik bildirim dosyaları (`*.content.ts`, …) atlanır.
+
+Tüm bir dosyayı tek seferde düzeltmek için `npx intlayer extract` komutunu çalıştırın ve derleyicinin dizeleri sizin için bir sözlüğe taşımasına izin verin.
+
+**Seçenekler**
+
+```javascript fileName="eslint.config.mjs"
+{
+  "intlayer/no-raw-text": [
+    "warn",
+    {
+      // Değeri kullanıcıya yönelik metin olan öznitelikler.
+      // Varsayılan: title, placeholder, alt, aria-label, label
+      attributes: ["title", "placeholder", "alt", "aria-label", "label"],
+
+      // İçeriği asla kullanıcıya yönelik metin olmayan öğeler.
+      // Varsayılan: code, pre, script, style
+      ignoreElements: ["code", "pre", "script", "style"],
+
+      // Asla bildirilmeyecek metinler için düzenli ifadeler.
+      ignorePatterns: ["^Powered by"],
+
+      // Biçimlendirme dışındaki dize sabitlerini de bildirin. Varsayılan: false
+      includeStringLiterals: false,
+    },
+  ],
+}
+```
+
+### `static-dictionary-key`
+
+Sözlük anahtarının bir dize sabiti olmasını gerektirir.
+
+Derleyici, bir sözlüğü yalnızca çağrı noktasında anahtarı doğrudan okuyabildiğinde önceden yükleyebilir. Hesaplanmış bir anahtarla optimizasyonu sessizce atlar ve bunun yerine her sözlüğü paketler.
+
+```typescript
+// ✗ Bildirildi
+useIntlayer(dictionaryKey);
+useIntlayer(`home-${suffix}`);
+getTranslations({ namespace: page });
+
+// ✗ Değişken hala bir dize sabiti değildir
+const key = "home";
+useIntlayer(key);
+
+// ✓ Sorunsuz
+useIntlayer("home");
+getTranslations({ namespace: "home" });
+```
+
+Bu durum `useIntlayer`, `getIntlayer` ve tüm uyumluluk bağdaştırıcıları (`useTranslation`, `useTranslations`, `formatMessage`, `<FormattedMessage id>`, `<Trans i18nKey>`, …) için geçerlidir.
+
+### `no-dynamic-field-access`
+
+Bir sözlükten okuduğunuz alanın statik olarak bilinmesini gerektirir.
+
+Derleyici, kullanıldığını görmediği alanları kaldırır. Hesaplanmış bir erişim onun için görünmezdir, bu nedenle okuma işlemi çalışma zamanında `undefined` döndürebilir.
+
+```typescript
+// ✗ Bildirildi
+const content = useIntlayer("home");
+content[fieldName];
+
+const t = useTranslations("home");
+t(messageKey);
+
+// ✓ Sorunsuz
+content.title;
+content["title"];
+content.items[0];
+t("hero.title");
+```
+
+### `enforce-adapter-import`
+
+Orijinal paket yerine `@intlayer/*` uyumluluk bağdaştırıcısını tercih eder. Orijinal paket yalnızca paketleyici takma adı yapılandırıldığında Intlayer'a çözümlenir; bağdaştırıcı her zaman çözümlenir. `--fix` ile otomatik düzeltilebilir.
+
+```typescript
+// ✗ Bildirildi
+import { useTranslation } from "react-i18next";
+import { getTranslations } from "next-intl/server";
+
+// ✓ Sorunsuz
+import { useTranslation } from "@intlayer/react-i18next";
+import { getTranslations } from "@intlayer/next-intl/server";
+```
+
+### `no-unused-content`
+
+**Varsayılan olarak kapalıdır.** Projenizdeki hiçbir yerin okumadığı içeriği ve birden fazla yerde bildirilen sözlük anahtarlarını bildirir.
+
+```typescript fileName="src/home.content.ts"
+export default {
+  key: "home", // ✗ Projede hiçbir çağıran "home" istemediğinde bildirilir
+  content: {
+    title: t({ tr: "Başlık", en: "Title" }),
+
+    // ✗ `hero` alanını hiçbir şey okumadığında bildirilir
+    hero: {
+      subtitle: t({ tr: "Alt Başlık", en: "Subtitle" }),
+    },
+  },
+};
+```
+
+Diğer kuralların aksine, bu kural yalnızca önündeki dosyadan karar veremez — bir alan yalnızca tüm projeye göre kullanılmamış sayılır. Bir lint çalıştırmasının ilk içerik bildiriminde Intlayer yapılandırmanızı yükler, bu yapılandırmanın bildirdiği kaynak dosyaları (`build.traversePattern`, `compiler.transformPattern`) tarar ve `@intlayer/lsp` ile VS Code uzantısındaki "kullanılmayan" üstü çizili metni destekleyen aynı kullanım çözümleyicisini çalıştırır. Sonuç `cacheTtl` milisaniye boyunca önbelleğe alınır, böylece tarama dosya başına değil çalıştırma başına bir kez gerçekleşir.
+
+**Seçenekler**
+
+```javascript fileName="eslint.config.mjs"
+{
+  "intlayer/no-unused-content": [
+    "warn",
+    {
+      // Hiçbir şeyin başvurmadığı sözlük anahtarlarını bildirin. Varsayılan: true
+      reportUnusedDictionaries: true,
+
+      // Hiçbir şeyin okumadığı içerik alanlarını bildirin. Varsayılan: true
+      reportUnusedFields: true,
+
+      // Birden fazla yerde bildirilen anahtarları bildirin. Varsayılan: true
+      reportDuplicateKeys: true,
+
+      // Asla bildirilmeyecek alan yolları için düzenli ifadeler.
+      ignoreFields: ["^meta"],
+
+      // Taramanın başlayacağı proje kökü. Varsayılan: ESLint çalışma dizini
+      baseDir: process.cwd(),
+
+      // Bir proje taramasının yeniden kullanılma süresi (ms). Varsayılan: 30000
+      cacheTtl: 30000,
+    },
+  ],
+}
+```
+
+Uzun süre çalışan bir düzenleyici sunucusundan lint işlemi yaparken ve düzenlemelerinizin daha erken yansımasını istediğinizde `cacheTtl` değerini düşürün; tek bir lint çalıştırması bir monorepodaki birkaç Intlayer projesini kapsadığında `baseDir` değerini ayarlayın.
+
+> **Sessiz kalmaya meyillidir.** Buradaki yanlış bir pozitif sonuç bir çeviriyi silebilir; bu nedenle sözlük analizin izleyemeyeceği bir şekilde kullanıldığında hiçbir şey bildirilmez: içerik nesnesinin bir bütün olarak aktarılması, ondan bağlanan bir çevirici işlevi (`const t = useTranslations("home")`), doğrudan içe aktarma yoluyla ulaşılan bir bildirim (`useDictionary(myDictionary)`), başka bir sözlükten bir `nest()` veya bir yayma (spread) operatörü ile kapsamlı olmaktan çıkarılan bir alan listesi. Tek dosyalı bileşenler (`.vue`, `.svelte`, `.astro`), komut dosyası blokları burada ayrıştırılmadığı için bahsettikleri sözlüklerin her alanını kullanıyor sayılır.
+
+`reportDuplicateKeys`, derlemenin `.intlayer/` altına yazdığı birleştirilmemiş sözlükleri okur, bu nedenle proje en az bir kez derlenene kadar sessiz kalır. Bir anahtarı paylaşan iki bildirim birleştirilir ve bu meşru bir kalıptır — bu raporlama mekanizması, her iki tarafta tanımlanan bir alanın sessizce iki değerden yalnızca birini koruması nedeniyle mevcuttur.
+
+Çözümleyici, ESM olarak dağıtılan `@intlayer/lsp` paketinden yüklenir. Bu nedenle kural, bir ES modülünü `require()` edebilen bir Node sürümüne ihtiyaç duyar — Node 20.19+ veya 22.12+. Daha eski sürümlerde lint çalıştırmasını başarısız kılmak yerine hiçbir şey bildirmez.
+
+## Çerçeveler (Frameworks)
+
+Her kural, Vue, Svelte ve Angular şablonları dahil olmak üzere tüm Intlayer entegrasyonlarında çalışır. ESLint'e yalnızca her dosya türünü hangi ayrıştırıcının okuyacağını belirtmeniz gerekir.
+
+| Çerçeve                   | Dosyalar          | Ayrıştırıcı (Parser)              |
+| ------------------------- | ----------------- | --------------------------------- |
+| React, Preact, Solid, Lit | `.jsx` `.tsx`     | `typescript-eslint`               |
+| Next.js                   | `.jsx` `.tsx`     | `typescript-eslint`               |
+| Vue, Nuxt                 | `.vue`            | `vue-eslint-parser`               |
+| Svelte, SvelteKit         | `.svelte`         | `svelte-eslint-parser`            |
+| Angular                   | `.ts`             | `typescript-eslint`               |
+| Angular Şablonları        | `.component.html` | `@angular-eslint/template-parser` |
+| Astro                     | `.astro`          | `astro-eslint-parser`             |
+
+```javascript fileName="eslint.config.mjs"
+import intlayer from "eslint-plugin-intlayer";
+import tseslint from "typescript-eslint";
+import vueParser from "vue-eslint-parser";
+import svelteParser from "svelte-eslint-parser";
+import angularTemplateParser from "@angular-eslint/template-parser";
+
+export default [
+  ...intlayer.configs.recommended,
+
+  {
+    files: ["**/*.{ts,tsx,jsx}"],
+    languageOptions: { parser: tseslint.parser },
+  },
+  {
+    files: ["**/*.vue"],
+    languageOptions: {
+      parser: vueParser,
+      parserOptions: { parser: tseslint.parser },
+    },
+  },
+  {
+    files: ["**/*.svelte"],
+    languageOptions: {
+      parser: svelteParser,
+      parserOptions: { parser: tseslint.parser },
+    },
+  },
+  {
+    files: ["**/*.component.html"],
+    languageOptions: { parser: angularTemplateParser },
+  },
+];
+```
+
+Yalnızca projenizin ihtiyaç duyduğu ayrıştırıcıları yükleyin.
+
+> **Bilinen sınırlama.** Vue ve Angular şablonlarında `{{ content[key] }}` gibi bir ifade `no-dynamic-field-access` tarafından kontrol edilmez. Script bloğunda yazılan dinamik okumalar normal şekilde yakalanır.

package/docs/uk/configuration.md

@@ -478,6 +478,30 @@ const config: IntlayerConfig = {
      */
     purge: true,
 
+    /**
+     * Групувати чанки словників за локаллю відповідно до межі розділення коду, яка
+     * їх використовує, щоб ліниво завантажена сторінка отримувала свій вміст одним
+     * запитом.
+     * За замовчуванням: true
+     *
+     * Примітка:
+     * - Застосовується лише до словників з `importMode: 'dynamic'`.
+     */
+    chunkGrouping: true,
+
+    /**
+     * Завантажувати словник разом із чанком, який його використовує, замість
+     * отримання після рендерингу цього чанка. Читання рендеряться синхронно
+     * замість призупинення, тому під час навігації більше не блимає стан
+     * завантаження.
+     * За замовчуванням: true
+     *
+     * Примітка:
+     * - Очікується лише визначена локаль, тому сторінка завантажує тільки ту мову,
+     *   яку відображає.
+     */
+    dictionariesPreload: true,
+
     /**
      * Формат виводу для згенерованих файлів словників.
      * За замовчуванням: ['cjs', 'esm']
@@ -1054,15 +1078,17 @@ Intlayer підтримує широкий спектр провайдерів A
 
 > Під час оптимізації Intlayer замінює виклики словників для оптимізації поділу коду (chunking), щоб підсумковий пакет імпортував лише ті словники, які фактично використовуються.
 
-| Поле              | Опис                                                                    | Тип                              | За замовчуванням                                                                                                                                                                  | Приклад                                                                       | Примітки                                                                                                                                                                                                                                                                                                           |
-| ----------------- | ----------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `mode`            | Керує режимом збірки.                                                   | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: Збірка запускається автоматично під час збірки додатка.<br/>• `'manual'`: Виконується лише через явну команду збірки.<br/>• Може використовуватися для запобігання збірці словників (наприклад, щоб уникнути запуску в середовищі Node.js).                                                            |
-| `optimize`        | Керує виконанням оптимізації збірки.                                    | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • Якщо не визначено, оптимізація запускається під час збірки фреймворку (Vite/Next.js).<br/>• `true` форсує оптимізацію навіть у режимі розробки.<br/>• `false` вимикає її.<br/>• Якщо ввімкнено, замінює виклики словників для оптимізації chunking.<br/>• Потрібні плагіни `@intlayer/babel` та `@intlayer/swc`. |
-| `minify`          | Мініфікувати словники для зменшення розміру бандла.                     | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Чи слід мініфікувати пакет.<br/>• За замовчуванням: `true` у виробничому середовищі.<br/>• Цей параметр буде ігноруватися, якщо `optimize` вимкнено.<br/>• Цей параметр буде ігноруватися, якщо `editor.enabled` має значення true.                                                                              |
-| `purge`           | Видалити невикористані ключі в словниках.                               | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Чи слід очищати пакет.<br/>• За замовчуванням: `true` у виробничому середовищі.<br/>• Цей параметр буде ігноруватися, якщо `optimize` вимкнено.                                                                                                                                                                  |
-| `checkTypes`      | Вказує, чи має збірка перевіряти типи TypeScript та записувати помилки. | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Може сповільнити процес збірки.                                                                                                                                                                                                                                                                                    |
-| `outputFormat`    | Керує форматом виводу словників.                                        | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                    |
-| `traversePattern` | Шаблон для файлів, які слід сканувати під час оптимізації.              | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Покращує продуктивність збірки, обмежуючи оптимізацію відповідними файлами.<br/>• Ігнорується, якщо `optimize` вимкнено.<br/>• Використовує glob-патерни.                                                                                                                                                        |
+| Поле                  | Опис                                                                                                                              | Тип                              | За замовчуванням                                                                                                                                                                  | Приклад                                                                       | Примітки                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| --------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`                | Керує режимом збірки.                                                                                                             | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: Збірка запускається автоматично під час збірки додатка.<br/>• `'manual'`: Виконується лише через явну команду збірки.<br/>• Може використовуватися для запобігання збірці словників (наприклад, щоб уникнути запуску в середовищі Node.js).                                                                                                                                                                                                                                                                                           |
+| `optimize`            | Керує виконанням оптимізації збірки.                                                                                              | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • Якщо не визначено, оптимізація запускається під час збірки фреймворку (Vite/Next.js).<br/>• `true` форсує оптимізацію навіть у режимі розробки.<br/>• `false` вимикає її.<br/>• Якщо ввімкнено, замінює виклики словників для оптимізації chunking.<br/>• Потрібні плагіни `@intlayer/babel` та `@intlayer/swc`.                                                                                                                                                                                                                                |
+| `minify`              | Мініфікувати словники для зменшення розміру бандла.                                                                               | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Чи слід мініфікувати пакет.<br/>• За замовчуванням: `true` у виробничому середовищі.<br/>• Цей параметр буде ігноруватися, якщо `optimize` вимкнено.<br/>• Цей параметр буде ігноруватися, якщо `editor.enabled` має значення true.                                                                                                                                                                                                                                                                                                             |
+| `purge`               | Видалити невикористані ключі в словниках.                                                                                         | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Чи слід очищати пакет.<br/>• За замовчуванням: `true` у виробничому середовищі.<br/>• Цей параметр буде ігноруватися, якщо `optimize` вимкнено.                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `checkTypes`          | Вказує, чи має збірка перевіряти типи TypeScript та записувати помилки.                                                           | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Може сповільнити процес збірки.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `chunkGrouping`       | Визначає, чи слід групувати чанки словників за локаллю відповідно до межі розділення коду, яка їх використовує.                   | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • Без групування сторінка, зібрана з багатьох компонентів, надсилає по одному запиту на кожен словник.<br/>• Словники, досяжні з кількох меж, переносяться до спільного чанка, тому жодна сторінка не містить вміст іншої.<br/>• Застосовується лише до словників з `importMode: 'dynamic'`.<br/>• Застосовується лише до клієнтської збірки і лише під час бандлінгу (не в режимі розробки).                                                                                                                                                     |
+| `dictionariesPreload` | Визначає, чи має словник завантажуватися разом із чанком, який його використовує, замість отримання після рендерингу цього чанка. | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • Згенерована точка входу очікує локаль перегляду на верхньому рівні, тому ліниво завантажений маршрут не вважається завантаженим, доки його вміст не готовий.<br/>• Читання рендеряться синхронно замість призупинення, тому під час навігації більше не блимає стан завантаження.<br/>• Очікується лише визначена локаль, тому сторінка завантажує тільки ту мову, яку відображає.<br/>• Застосовується лише до словників з `importMode: 'dynamic'` у клієнтській збірці.<br/>• Потребує бандлера з підтримкою top-level await (Vite, esbuild). |
+| `outputFormat`        | Керує форматом виводу словників.                                                                                                  | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `traversePattern`     | Шаблон для файлів, які слід сканувати під час оптимізації.                                                                        | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Покращує продуктивність збірки, обмежуючи оптимізацію відповідними файлами.<br/>• Ігнорується, якщо `optimize` вимкнено.<br/>• Використовує glob-патерни.                                                                                                                                                                                                                                                                                                                                                                                       |
 
 ---
 

package/docs/uk/dictionary/content_file.md

@@ -542,28 +542,6 @@ export default aboutPageMetaContent;
 
 > Див. [Варіанти](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/variants.md) для отримання додаткової інформації.
 
-#### `meta` (`Record<string, string | number | boolean>`)
-
-Використовується разом із Динамічними Записами, це поле дозволяє оголошувати записи, керовані CMS, або довільні дані, отримані під час виконання за непрозорим ID. Ідентичність словника визначається довільним набором пар ключ-значення, оголошених у цьому полі `meta`.
-
-**Приклад:**
-
-```typescript
-{
-  key: "product-copy",
-  meta: {
-    id: "prod_abc",
-    userId: "user_123"
-  },
-  content: {
-    name: "Widget Pro",
-    description: "The best widget."
-  }
-}
-```
-
-> Див. [Динамічні Записи](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/dynamic_content.md) для отримання додаткової інформації.
-
 ### Властивості CMS
 
 ##### `version` (string)

package/docs/uk/dictionary/function_fetching.md

@@ -87,6 +87,29 @@ export default asyncFunctionContent;
 
 У цьому випадку функція `fakeFetch` імітує затримку, щоб симулювати час відповіді сервера. Intlayer виконує асинхронну функцію і використовує результат як вміст для ключа `text`.
 
+## Отримання віддаленого вмісту
+
+Ви також можете призначити проміс безпосередньо полю вмісту. Intlayer дочекається його під час збирання словників і вставить отримане значення:
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import type { Dictionary } from "intlayer";
+
+const remoteContent = {
+  key: "remote_content",
+  content: {
+    externalContent: fetch("https://example.com").then((res) => res.json()),
+  },
+} satisfies Dictionary;
+
+export default remoteContent;
+```
+
+```plaintext fileName="**/*.content.json" contentDeclarationFormat="json"
+Неможливо отримати вміст із JSON-файлу, використовуйте натомість .ts або .js файл
+```
+
+> Запит виконується під час збирання, тому отримані дані — це знімок, вбудований у словник. Перезберіть словники, щоб оновити його.
+
 ## Використання контенту на основі функцій у React-компонентах
 
 Щоб використовувати контент на основі функцій у React-компоненті, потрібно імпортувати `useIntlayer` з `react-intlayer` і викликати його з ідентифікатором контенту, щоб отримати вміст. Ось приклад: