@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.10

package/docs/ru/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Добро пожаловать в Intlayer v7! Этот крупный релиз представляет значительные улучшения в производительности, безопасности типов и опыте разработчика. Ниже приведены основные моменты, а также заметки по миграции и практические примеры.
 
+## Оглавление
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Основные моменты
 
 - Стратегия кэширования для ускорения сборок
@@ -260,6 +264,126 @@ setLocale("en");
 
 ---
 
+## Автоматическое форматирование кода: конфигурация formatCommand
+
+v7 вводит опцию `formatCommand` в конфигурации редактора, позволяя вам автоматически форматировать файлы содержимого при их записи Intlayer. Это обеспечивает согласованный стиль кода и форматирование во всех файлах объявления контента.
+
+Если не установлено, Intlayer попытается автоматически определить команду форматирования. Путем попытки разрешить следующие команды: prettier, biome, eslint.
+
+### Конфигурация
+
+Опция `formatCommand` принимает строковый шаблон, где `{{file}}` будет заменена на фактический путь файла:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### Поддерживаемые форматеры
+
+Вы можете использовать любой форматер кода, который принимает пути к файлам в качестве аргументов:
+
+**Using Biome:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**Using Prettier:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**Using ESLint:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**Using Bun's built-in formatter:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### Преимущества
+
+- **Согласованное форматирование**: Все файлы содержимого автоматически форматируются в соответствии с рекомендациями стиля вашего проекта
+- **Опыт разработчика**: Нет необходимости вручную форматировать файлы после их создания Intlayer
+- **Согласованность команды**: Гарантирует, что все члены команды имеют одинаковое форматирование, применяемое к файлам содержимого
+- **Интеграция CI/CD**: Файлы содержимого сохраняют согласованное форматирование в автоматизированных рабочих процессах
+
+### Как это работает
+
+When Intlayer writes or updates a content declaration file (`.content.ts`, `.content.js`, etc.), it automatically runs the specified format command on the file. The `{{file}}` placeholder is replaced with the actual file path, and the command is executed in the project's base directory.
+
+---
+
+## Dictionary Configuration: Better organization and structure
+
+v7 представляет новый dedicated раздел конфигурации `dictionary`, который обеспечивает лучшую организацию параметров, связанных со словарем, и улучшенное управление содержимым.
+
+### Новая структура конфигурации словаря
+
+Свойство `fill` было перемещено из раздела `content` в новый раздел `dictionary`, обеспечивая более четкое разделение ответственности:
+
+**Конфигурация v6:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**Конфигурация v7:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### Преимущества новой структуры
+
+- **Более четкая организация**: Параметры, характерные для словаря, теперь сгруппированы вместе
+- **Лучшее разделение ответственности**: Обнаружение содержимого и операции со словарем четко разделены
+- **Улучшенная поддерживаемость**: Легче понять и модифицировать конфигурации, связанные со словарем
+- **Будущая расширяемость**: Раздел словаря может вмещать дополнительные параметры, характерные для словаря
+- **Комплексное управление словарем**: Включает свойства, такие как `title`, `live`, `priority`, `tags`, `version` и `description` для создания и управления новыми словарями
+
+### Использование конфигурации
+
+Конфигурация словаря служит двум основным целям:
+
+1. **Значения по умолчанию**: Определение значений по умолчанию при создании файлов объявления контента
+2. **Поведение при отсутствии значения**: Предоставление резервных значений, когда определенные поля не определены, позволяя вам глобально определить поведение операций словаря
+
+Раздел словаря включает комплексные свойства для управления словарем:
+
+- **`fill`**: Поведение автозаполнения при генерации контента
+- **`title`**: Заголовок по умолчанию для новых словарей
+- **`live`**: Конфигурация синхронизации в реальном времени для обновлений
+- **`priority`**: Параметры приоритета для разрешения словаря
+- **`tags`**: Теги по умолчанию для организации контента
+- **`version`**: Управление версиями для обновлений словаря
+- **`description`**: Описание по умолчанию для нового контента
+
+Для получения дополнительной информации о файлах объявления контента и применении значений конфигурации см. [Документация по файлам контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md).
+
+---
+
 ## Команда fill: обновленное поведение для лучшего управления контентом
 
 v7 вводит улучшенное поведение команды `fill`, обеспечивая более предсказуемое и гибкое управление контентом:
@@ -407,6 +531,10 @@ const content = {
 - **`middleware.prefixDefault`**: заменён на `routing.mode`
 - **`middleware.noPrefix`**: заменён на `routing.mode`
 
+### Новые конфигурации
+
+- **`editor.formatCommand`**: Новый параметр для автоматического форматирования кода файлов содержимого
+
 ### Сопоставление миграции
 
 #### Сопоставление конфигураций

package/docs/ru/releases/v8.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-22
-updatedAt: 2026-01-26
+updatedAt: 2026-06-14
 title: Новый Intlayer v8. Что нового?
 description: Узнайте, что нового в Intlayer v8. Существенные улучшения в опыте разработчика, валидации контента и управлении словарями.
 keywords:
@@ -44,7 +44,7 @@ Intlayer v8 вносит значительные улучшения в спос
 
 ### Унифицированный API `.use()`
 
-Мы ввели метод `.use()` как для Markdown, так и для HTML узлов. Этот метод позволяет настраивать HTML-теги или компоненты, используемые при рендеринге.
+Мы ввели метод `.use()` как для Markdown, так и для HTML-узлов. Этот метод позволяет настраивать HTML-теги или компоненты, используемые при рендеринге.
 
 - **Замена компонентов**: Вы можете легко заменить HTML-теги или пользовательские компоненты компонентами вашего фреймворка (например, заменить `<a>` на `NextLink` или `<CustomCmp>` на React-компонент).
 - **Типизация**: Все функции для предоставления компонентов полностью типизированы, что гарантирует получение правильных пропсов.
@@ -409,6 +409,16 @@ Intlayer v8 вносит значительные улучшения в спос
 
 ---
 
+## Файлы контента YAML и Markdown (v8.10.0)
+
+Теперь вы можете объявлять контент напрямую, используя расширения файлов `.content.md` и `.content.yaml`. Это идеально подходит для длинного контента, блогов, документации и политик конфиденциальности.
+
+Эти файлы полностью редактируются в Visual Editor, обеспечивая оптимизированный рабочий процесс для нетехнических членов команды.
+
+Для получения более подробной информации см. [Документацию по файлам контента YAML](https://intlayer.org/doc/concept/content#yaml-content-file) и [Документацию по файлам контента Markdown](https://intlayer.org/doc/concept/content/markdown).
+
+---
+
 ## Пользовательские правила перезаписи URL
 
 Intlayer v8 добавляет поддержку **пользовательских правил перезаписи URL**, позволяя задавать локализованные пути, отличающиеся от стандартной структуры `/locale/path`. Эта мощная функция помогает улучшить локальную SEO и обеспечить более естественный пользовательский опыт для неанглоязычных пользователей.
@@ -753,6 +763,64 @@ export default {
   </Tab>
 </Tabs>
 
+## Unicode CLDR Plural Rules (v8.8.0)
+
+Был добавлен новый хелпер узла `plural`, основанный на правилах множественного числа, определенных проектом Unicode CLDR, что улучшает поддержку сложных языков.
+
+```typescript fileName="src/openings.content.ts"
+import { plural, t, type Dictionary } from "intlayer";
+
+const openingsContent = {
+  key: "total_openings",
+  content: {
+    totalOpenings: t({
+      ru: plural({
+        one: "{{count}} вакансия",
+        few: "{{count}} вакансии",
+        many: "{{count}} вакансий",
+        other: "{{count}} вакансии",
+      }),
+      en: plural({
+        one: "{{count}} opening",
+        other: "{{count}} openings",
+      }),
+      fr: plural({
+        one: "{{count}} offre",
+        other: "{{count}} offres",
+      }),
+    }),
+  },
+} satisfies Dictionary;
+
+export default openingsContent;
+```
+
+Затем вы можете динамически передавать количество в компонент вашего фреймворка:
+
+```tsx
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const OpeningsComponent: FC<{ count: number }> = ({ count }) => {
+  const { totalOpenings } = useIntlayer("total_openings");
+
+  return (
+    <div>
+      {/* На английском:                                  */}
+      {/*  count=0  → "0 openings"   (other)           */}
+      {/*  count=1  → "1 opening"    (one)             */}
+      {/*  count=2  → "2 openings"   (other)           */}
+      {/*  count=21 → "21 openings"  (other)           */}
+      <p>{totalOpenings(count)}</p>
+    </div>
+  );
+};
+```
+
+Для получения дополнительной информации см. [Документацию по плюрализации](https://intlayer.org/doc/concept/content/plural).
+
+---
+
 ## Валидация схемы содержимого
 
 В Intlayer v8 добавлена валидация схем для словарей. Теперь вы можете определить переиспользуемые схемы валидации в вашей конфигурации с помощью Zod и применять их к файлам контента. Это гарантирует, что ваш контент всегда соответствует ожидаемой структуре и позволяет обнаруживать ошибки на этапе сборки.
@@ -797,6 +865,34 @@ export default aboutPageMetaContent;
 
 ---
 
+## TypeScript: Примитивные аксессоры IntlayerNode
+
+Тип `IntlayerNode` был обновлен, чтобы позволить вызывать примитивные методы JavaScript напрямую на узлах контента. Это делает возможным взаимодействие с вашим локализованным контентом напрямую, как если бы он был стандартным примитивом строки, числа, булева значения или массива.
+
+Поддерживается в React, Preact, Solid, Svelte, Vue и Angular.
+
+### Пример со строкой
+
+```typescript
+content.placeholder; // Возвращает IntlayerNode<string>
+content.placeholder.value; // Возвращает string
+content.placeholder.toString(); // Возвращает string
+content.placeholder.toLowerCase(); // Возвращает string
+String(content.placeholder); // Возвращает string
+content.placeholder.toUpperCase(); // Возвращает строку в верхнем регистре
+content.placeholder.replace("a", "b"); // Возвращает измененную строку
+```
+
+### Пример с массивом
+
+```typescript
+content.myArrayOfString             // Возвращает IntlayerNode<Array<string>>
+content.myArrayOfString.find(...)   // Возвращает элемент
+content.myArrayOfString.join(', ')  // Возвращает объединенную строку
+```
+
+---
+
 ### Улучшенное автоматическое определение содержимого
 
 В v8 Intlayer автоматически определяет синтаксис Markdown, HTML-теги и вставки переменных в строках содержимого. Это означает, что вы часто можете опускать вспомогательные функции, такие как `md()`, `html()` или `insert()`.
@@ -1002,6 +1098,17 @@ export default {
 
 ---
 
+## Инструменты: C++ Watcher и LSP на базе OXC (v8.12.0)
+
+Intlayer v8.12.0 приносит важные улучшения в опыт разработчика:
+
+- **Parcel Watcher**: Наблюдатель за контентом был перенесен с `chokidar` на `@parcel/watcher`, используя нативное отслеживание файлов на C++ для обеспечения более быстрых обновлений и значительно меньшего потребления памяти.
+- **Новый Language Server Protocol (LSP)**: Теперь доступен совершенно новый LSP. Созданный на основе парсинга OXC, он помогает вашей IDE и AI-агентам беспрепятственно связывать вызовы `useIntlayer('my-key')` с соответствующими файлами `.content` и наоборот.
+
+Для получения более подробной информации см. [Документацию по LSP](https://intlayer.org/doc/lsp).
+
+---
+
 ## Оптимизации компилятора
 
 Intlayer v8 включает новый уровень кеширования для компилятора Markdown и HTML. Это гарантирует, что идентичные строки контента с одинаковой конфигурацией парсятся только один раз, что значительно снижает накладные расходы при повторных рендерах или при использовании одного и того же контента в нескольких местах.
@@ -1057,6 +1164,48 @@ Intlayer v8 включает новый уровень кеширования д
 
 ---
 
+## Экспериментальные оптимизации сборки: Minify и Purge (v8.7.0)
+
+Intlayer v8.7.0 представляет новые экспериментальные функции сборки в вашем `intlayer.config.ts`, разработанные для оптимизации вашего продакшн-бандла:
+
+- **Минификация словарей**: Минифицирует файлы словарей для уменьшения их размера.
+- **Очистка неиспользуемых ключей (Purging)**: Сканирует и удаляет неиспользуемые ключи перевода из словарей, переименовывая активные ключи в короткие символы (например, `"products" -> "a"`, `"pricing" -> "b"`). Это уменьшает размер бандла до 5%.
+- **Отключение проверок TypeScript**: Ускоряет сборку за счет отключения проверки типов TypeScript на этапе компиляции.
+
+```typescript fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  dictionary: {
+    importMode: "dynamic",
+  },
+  build: {
+    /**
+     * Минификация словарей для уменьшения размера бандла.
+     */
+    minify: true,
+
+    /**
+     * Очистка неиспользуемых ключей в словарях.
+     */
+    purge: true,
+
+    /**
+     * Указывает, должна ли сборка проверять типы TypeScript.
+     */
+    checkTypes: false,
+  },
+};
+
+export default config;
+```
+
+---
+
 ## Гибкость: Унифицированный режим импорта
 
 Булево свойство `live` устарело в пользу более универсального свойства `importMode`. Это позволяет явно задавать, как словари должны загружаться: статически, динамически или посредством синхронизации в реальном времени.
@@ -1204,6 +1353,49 @@ Markdown и HTML-контент в Svelte теперь автоматическ
 
 ---
 
+## Поддержка Angular: Сборщик Vite (v8.11.0)
+
+Для пользователей Angular Intlayer теперь нативно поддерживает сборщик Vite через новый кастомный плагин esbuild, ускоряя время разработки и сборки.
+
+Подробности о конфигурации см. в [Документации по окружению Angular](https://intlayer.org/doc/environment/angular).
+
+---
+
+## Генерация карты сайта (Sitemap) (v8.6.0)
+
+Intlayer теперь автоматически генерирует карты сайта на основе ваших локалей и режима маршрутизации. Это особенно полезно для SEO-оптимизации в архитектурах роутеров, таких как TanStack Router:
+
+```typescript fileName="src/routes/sitemap.xml.ts"
+import { createFileRoute } from "@tanstack/react-router";
+import { generateSitemap } from "intlayer";
+
+const SITE_URL = (
+  import.meta.env.VITE_SITE_URL ?? "http://localhost:3000"
+).replace(/\/$/, "");
+
+export const Route = createFileRoute("/sitemap.xml")({
+  server: {
+    handlers: {
+      GET: async () => {
+        const sitemap = generateSitemap(
+          [
+            { path: "/", changefreq: "daily", priority: 1.0 },
+            { path: "/about", changefreq: "monthly", priority: 0.8 },
+          ],
+          { siteUrl: SITE_URL }
+        );
+
+        return new Response(sitemap, {
+          headers: { "Content-Type": "application/xml" },
+        });
+      },
+    },
+  },
+});
+```
+
+---
+
 ## Примечания по миграции из v7
 
 ### Изменения в конфигурации