@intlayer/docs 9.0.0-canary.5 → 9.0.0-canary.6

package/docs/pt/packages/react-native-intlayer/exports.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-06-25
 title: Documentação do pacote react-native-intlayer
-description: Suporte a React Native para o Intlayer, fornecendo providers e polyfills.
+description: Suporte a React Native para o Intlayer, fornecendo providers, hooks, polyfills e configuração Metro.
 keywords:
   - react-native-intlayer
   - react-native
@@ -14,6 +14,9 @@ slugs:
   - react-native-intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Reexportar a API completa do react-intlayer (hooks, utilitários, subcaminhos format/html/markdown) para que um aplicativo React Native dependa apenas de react-native-intlayer"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentação unificada para todas as exportações"
@@ -22,7 +25,9 @@ author: aymericzip
 
 # Pacote react-native-intlayer
 
-O pacote `react-native-intlayer` fornece as ferramentas necessárias para integrar o Intlayer em aplicações React Native. Inclui um provider e polyfills para suporte a locale.
+O pacote `react-native-intlayer` fornece as ferramentas necessárias para integrar o Intlayer em aplicações React Native. Reexporta a API completa do `react-intlayer` (hooks e utilitários) com um `IntlayerProvider` pronto para React Native, além dos polyfills e da configuração Metro exigidos pelo React Native.
+
+> Em um aplicativo React Native, importe **tudo** de `react-native-intlayer`. Você não precisa instalar ou importar `react-intlayer` diretamente.
 
 ## Instalação
 
@@ -34,14 +39,30 @@ npm install react-native-intlayer
 
 ### Provider
 
-| Componente         | Descrição                                                                       |
-| ------------------ | ------------------------------------------------------------------------------- |
-| `IntlayerProvider` | Componente Provider que envolve sua aplicação e fornece o contexto do Intlayer. |
+| Componente         | Descrição                                                                                                                        |
+| ------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerProvider` | Componente Provider que envolve sua aplicação e fornece o contexto do Intlayer. Aplica automaticamente os polyfills necessários. |
+
+```tsx
+import { IntlayerProvider } from "react-native-intlayer";
+```
+
+### Hooks e utilitários
+
+Estes são reexportados de `react-intlayer`, portanto você pode importá-los diretamente de `react-native-intlayer`:
 
-Import:
+| Exportação                                                                                                        | Descrição                                                |
+| ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| `useIntlayer`                                                                                                     | Acessa conteúdo localizado para uma chave de dicionário. |
+| `useLocale`                                                                                                       | Lê e altera o locale atual.                              |
+| `useDictionary`, `useDictionaryAsync`, `useDictionaryDynamic`, `useLoadDynamic`                                   | Carrega conteúdo de dicionário de diversas formas.       |
+| `useI18n`                                                                                                         | Hook compatível com i18next.                             |
+| `t`                                                                                                               | Auxiliar de tradução inline.                             |
+| `getIntlayer`, `getDictionary`                                                                                    | Getters imperativos de conteúdo.                         |
+| `localeCookie`, `localeInStorage`, `setLocaleCookie`, `setLocaleInStorage`, `useLocaleCookie`, `useLocaleStorage` | Auxiliares de persistência de locale.                    |
 
 ```tsx
-import "react-native-intlayer";
+import { useIntlayer, useLocale, t } from "react-native-intlayer";
 ```
 
 ### Polyfill
@@ -50,10 +71,25 @@ import "react-native-intlayer";
 | ------------------ | --------------------------------------------------------------------------------------- |
 | `intlayerPolyfill` | Função que aplica os polyfills necessários para o React Native dar suporte ao Intlayer. |
 
-Import:
+```tsx
+import { intlayerPolyfill } from "react-native-intlayer";
+```
+
+> O polyfill é aplicado automaticamente quando você importa `IntlayerProvider`. Chame `intlayerPolyfill` manualmente apenas se precisar dos polyfills antes que o provider seja montado.
+
+### Formatadores
+
+Hooks de formatação numérica, de data e outros baseados em Intl estão disponíveis no subcaminho `/format`:
+
+```tsx
+import { useNumber, useDate } from "react-native-intlayer/format";
+```
+
+### Renderização de Markdown e HTML
 
 ```tsx
-import "react-native-intlayer";
+import { MarkdownProvider } from "react-native-intlayer/markdown";
+import { HTMLProvider } from "react-native-intlayer/html";
 ```
 
 ### Configuração do Metro
@@ -66,8 +102,6 @@ O pacote `react-native-intlayer` fornece utilitários de configuração do Metro
 | `configMetroIntlayerSync` | Função síncrona que mescla a configuração do Metro sem preparar os recursos do Intlayer.     |
 | `exclusionList`           | Cria um padrão RegExp para o blockList do Metro para excluir arquivos de conteúdo do bundle. |
 
-Importação:
-
 ```tsx
-import "react-native-intlayer/metro";
+import { configMetroIntlayer } from "react-native-intlayer/metro";
 ```

package/docs/ru/intlayer_with_react_native+expo.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-06-18
-updatedAt: 2026-05-31
+updatedAt: 2026-06-25
 title: "Expo + React Native i18n - Полное руководство по переводу вашего приложения"
 description: "Больше никакого i18next. Руководство 2026 по созданию многоязычного (i18n) приложения Expo + React Native. Переводите с помощью ИИ-агентов и оптимизируйте размер бандла, SEO и производительность."
 keywords:
@@ -17,6 +17,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-react-native-template
 applicationShowcase: https://intlayer-react-native.vercel.app
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Импорт провайдеров и хуков напрямую из react-native-intlayer; react-intlayer больше не нужен как прямая зависимость"
   - version: 8.9.0
     date: 2026-05-04
     changes: "Обновление использования API useIntlayer в Solid для прямого доступа к свойствам"
@@ -37,7 +40,7 @@ author: aymericzip
 <iframe
   src="https://ide.intlayer.org/aymericzip/intlayer-react-native-template?file=intlayer.config.ts"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Demo CodeSandbox - Intlayer"
+  title="Demo CodeSandbox - How to Internationalize your application using Intlayer"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -56,56 +59,66 @@ author: aymericzip
   </Tab>
 </Tabs>
 
-Смотрите [Шаблон приложения](https://github.com/aymericzip/intlayer-react-native-template) на GitHub.
+## Содержание
 
-## Шаг 1. Установите зависимости
+<TOC/>
 
-См. [Шаблон приложения](https://github.com/aymericzip/intlayer-react-native-template) на GitHub.
+## Почему Intlayer, а не альтернативы?
 
-Из вашего проекта React Native установите следующие пакеты:
+По сравнению с основными решениями, такими как `react-native-localize` или `i18next`, Intlayer — это решение, включающее такие интегрированные оптимизации, как:
 
-```bash packageManager="npm"
-npm установить intlayer
-npm install --save-dev реагирование-native-intlayer
-Инициализация промежуточного слоя npx
-```
+<AccordionGroup>
 
-```bash packageManager="pnpm"
-pnpm добавить промежуточный слой
-pnpm добавить --save-dev реагирование-native-intlayer
-инициализация промежуточного слоя pnpm
-```
+<Accordion header="Полная поддержка React Native">
 
-```bash packageManager="yarn"
-пряжа добавить промежуточный слой
-пряжа добавить --save-dev
-инициализация промежуточного слоя пряжи
-```
+Intlayer оптимизирован для идеальной работы с React Native и Expo, предлагая **определение контента на уровне компонентов**, **поддержку TypeScript** и все необходимые функции для масштабирования интернационализации (i18n) в мобильных приложениях.
 
-```bash packageManager="булочка"
-булочка добавить промежуточный слой
-булочка добавить --dev response-native-intlayer
-инициализация промежуточного слоя булочки x
-```
+</Accordion>
 
-### Пакеты
+<Accordion header="Поддерживаемость">
 
-- **промежуточный слой**  
-  Базовый набор инструментов i18n для настройки, содержимого словаря, генерации типов и команд CLI.
+Организация контента по отдельным областям (scoping) **упрощает сопровождение** крупных приложений. Вы можете скопировать или удалить папку с функцией без необходимости просматривать всю кодовую базу контента. Кроме того, Intlayer **полностью типизирован (fully typed)**, что обеспечивает точность вашего контента.
 
-- **реакция-intlayer**  
-  Интеграция React, которая предоставляет поставщиков контекста и перехватчики React, которые вы будете использовать в React Native для получения и переключения локалей.
+</Accordion>
 
-- **реагировать-родной-intlayer**  
-  Интеграция React Native, предоставляющая плагин Metro для интеграции Intlayer с упаковщиком React Native.
+<Accordion header="ИИ-агент">
 
----
+Совместное размещение контента **сокращает контекст, необходимый** для больших языковых моделей (LLM). Intlayer также поставляется с набором инструментов, таких как **CLI** для проверки отсутствующих переводов, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** и **[навыки агента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**, чтобы сделать опыт разработчика (DX) ещё более комфортным для ИИ-агентов.
+
+</Accordion>
+
+<Accordion header="Автоматизация">
+
+Используйте автоматизацию для перевода в вашем CI/CD-пайплайне с помощью LLM по вашему выбору за счёт вашего провайдера ИИ. Intlayer также предлагает **компилятор** для автоматизации извлечения контента, а также [веб-платформу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md), чтобы помочь **переводить в фоновом режиме**.
+
+</Accordion>
+
+<Accordion header="Производительность">
+
+Подключение больших JSON-файлов к компонентам может привести к проблемам с производительностью и реактивностью. Intlayer оптимизирует загрузку контента во время сборки (build time).
+
+</Accordion>
+
+<Accordion header="Масштабирование с не-разработчиками">
+
+Будучи больше, чем просто решением для i18n, Intlayer предлагает **собственный [визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** и **[полноценную CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)**, чтобы помочь вам управлять многоязычным контентом в **реальном времени**, делая сотрудничество с переводчиками, копирайтерами и другими членами команды бесперебойным. Контент может храниться локально и/или удалённо.
+
+</Accordion>
+
+<Accordion header="Размер бандла">
+
+Вместо загрузки огромных JSON-файлов на ваши страницы загружайте только необходимый контент. Intlayer помогает **уменьшить размер вашего бандла и представлений до 50%**.
+
+</Accordion>
+</AccordionGroup>
 
 <Steps>
 
-<Step number={1} title="Установка зависимостей">
+<Step number={1} title="Установите зависимости">
+
+См. [Шаблон приложения](https://github.com/aymericzip/intlayer-react-native-template) на GitHub.
 
-В вашем проекте React Native установите следующие пакеты:
+Из вашего проекта React Native установите следующие пакеты:
 
 ```bash packageManager="npm"
 npx intlayer-cli init --interactive
@@ -123,28 +136,24 @@ yarn dlx intlayer-cli init --interactive
 bunx intlayer-cli init --interactive
 ```
 
-> флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.
+> Флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.
 
 > Эта команда определит вашу среду и установит необходимые пакеты. Например:
 
 ```bash packageManager="npm"
-npm install intlayer react-intlayer
-npm install --save-dev react-native-intlayer
+npm install intlayer react-native-intlayer
 ```
 
 ```bash packageManager="pnpm"
-pnpm add intlayer react-intlayer
-pnpm add --save-dev react-native-intlayer
+pnpm add intlayer react-native-intlayer
 ```
 
 ```bash packageManager="yarn"
-yarn add intlayer react-intlayer
-yarn add --save-dev react-native-intlayer
+yarn add intlayer react-native-intlayer
 ```
 
 ```bash packageManager="bun"
-bun add intlayer react-intlayer
-bun add --dev react-native-intlayer
+bun add intlayer react-native-intlayer
 ```
 
 ### Пакеты
@@ -152,11 +161,8 @@ bun add --dev react-native-intlayer
 - **intlayer**  
   Основной набор инструментов i18n для конфигурации, содержимого словарей, генерации типов и команд CLI.
 
-- **react-intlayer**  
-  Интеграция с React, предоставляющая провайдеры контекста и React-хуки, которые вы будете использовать в React Native для получения и переключения локалей.
-
 - **react-native-intlayer**  
-  Интеграция с React Native, предоставляющая плагин Metro для интеграции Intlayer с бандлером React Native.
+  Интеграция с React Native, предоставляющая провайдеры контекста и React-хуки, которые вы будете использовать для получения и переключения локалей, полифилы React Native, а также плагин Metro для интеграции Intlayer с бандлером React Native. Он реэкспортирует всё из `react-intlayer`, поэтому в приложении React Native достаточно этого единственного пакета.
 
 ---
 
@@ -198,7 +204,7 @@ export default config;
 
 <Step number={3} title="Добавьте плагин Metro">
 
-Metro - это сборщик для React Native. Он является сборщиком по умолчанию для проектов React Native, созданных с помощью команды `react-native init`. Чтобы использовать Intlayer с Metro, необходимо добавить плагин в файл `metro.config.js`:
+Metro — это сборщик для React Native. Он является сборщиком по умолчанию для проектов React Native, созданных с помощью команды `react-native init`. Чтобы использовать Intlayer с Metro, необходимо добавить плагин в файл `metro.config.js`:
 
 ```js fileName="metro.config.js"
 const { getDefaultConfig } = require("expo/metro-config");
@@ -211,13 +217,18 @@ module.exports = (async () => {
 })();
 ```
 
+> Примечание: `configMetroIntlayer` — это асинхронная функция. Используйте `configMetroIntlayerSync`, если хотите использовать её синхронно, или избегайте IIFE (Immediately Invoked Function Expression).
+> Примечание: `configMetroIntlayerSync` не позволяет собирать словари intlayer при запуске сервера
+
 </Step>
 
 <Step number={4} title="Добавьте провайдер Intlayer">
 
-Чтобы синхронизировать язык пользователя во всем приложении, необходимо обернуть корневой компонент в компонент `IntlayerProvider` из `react-intlayer-native`.
+Чтобы синхронизировать язык пользователя по всему приложению, необходимо обернуть корневой компонент в компонент `IntlayerProvider` из `react-native-intlayer`.
+
+> Всегда импортируйте из `react-native-intlayer`. Его `IntlayerProvider` включает полифилы для веб-API, используемого Intlayer, и пакет реэкспортирует все хуки и утилиты из `react-intlayer`.
 
-> Убедитесь, что вы используете провайдер из `react-native-intlayer`, а не из `react-intlayer`. Экспорт из `react-native-intlayer` включает полифилы для веб-API.
+Также необходимо добавить функцию `intlayerPolyfill` в ваш файл `index.js`, чтобы обеспечить корректную работу Intlayer.
 
 ```tsx fileName="app/_layout.tsx" codeFormat={["typescript", "esm"]}
 import { Stack } from "expo-router";
@@ -321,7 +332,7 @@ export default homeScreenContent;
 
 ```tsx fileName="app/(tabs)/index.tsx" codeFormat={["typescript", "esm"]}
 import { Image, StyleSheet, Platform } from "react-native";
-import { useIntlayer } from "react-intlayer";
+import { useIntlayer } from "react-native-intlayer";
 import { HelloWave } from "@/components/HelloWave";
 import ParallaxScrollView from "@/components/ParallaxScrollView";
 import { ThemedText } from "@/components/ThemedText";
@@ -368,7 +379,7 @@ export default HomeScreen;
 
 </Step>
 
-<Step number={7} title="Изменение локали приложения">
+<Step number={7} title="Изменение локали приложения" isOptional={true}>
 
 Для переключения локалей изнутри ваших компонентов вы можете использовать метод `setLocale` хука `useLocale`:
 
@@ -376,7 +387,7 @@ export default HomeScreen;
 import { type FC } from "react";
 import { View, Text, TouchableOpacity, StyleSheet } from "react-native";
 import { getLocaleName } from "intlayer";
-import { useLocale } from "react-intlayer";
+import { useLocale } from "react-native-intlayer";
 
 export const LocaleSwitcher: FC = () => {
   const { setLocale, availableLocales } = useLocale();
@@ -453,7 +464,7 @@ Intlayer генерирует определения типов в скрыто
 Чтобы избежать коммита автоматически сгенерированных файлов Intlayer, добавьте следующее в ваш `.gitignore`:
 
 ```bash
-#  Игнорировать файлы, сгенерированные Intlayer
+# Игнорировать файлы, сгенерированные Intlayer
 .intlayer
 ```
 
@@ -490,13 +501,13 @@ Intlayer генерирует определения типов в скрыто
 
 React Native может быть менее стабильным, чем React Web, поэтому обратите особое внимание на выравнивание версий.
 
-Intlayer в основном ориентирован на Web Intl API; в React Native вы должны включить соответствующие polyfills.
+Intlayer в основном ориентирован на Web Intl API; в React Native вы должны включить соответствующие полифилы.
 
 Контрольный список:
 
-- Используйте последние версии `intlayer`, `react-intlayer` и `react-native-intlayer`.
-- Включите Intlayer polyfill.
-- Если вы используете `getLocaleName` или другие утилиты на основе Intl API, импортируйте эти polyfills рано (например, в `index.js` или `App.tsx`):
+- Используйте последние версии `intlayer` и `react-native-intlayer`.
+- Включите Intlayer полифил.
+- Если вы используете `getLocaleName` или другие утилиты на основе Intl API, импортируйте эти полифилы рано (например, в `index.js` или `App.tsx`):
 
 ```ts
 import "intl";

package/docs/ru/packages/react-native-intlayer/exports.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-06-25
 title: Документация пакета react-native-intlayer
-description: Поддержка React Native для Intlayer, предоставляющая провайдеры и полифилы.
+description: Поддержка React Native для Intlayer, предоставляющая провайдеры, хуки, полифилы и конфигурацию Metro.
 keywords:
   - react-native-intlayer
   - react-native
@@ -14,6 +14,9 @@ slugs:
   - react-native-intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Реэкспорт полного API react-intlayer (хуки, утилиты, подпути format/html/markdown), чтобы приложение React Native зависело только от react-native-intlayer"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Унифицированная документация для всех экспортов"
@@ -22,7 +25,9 @@ author: aymericzip
 
 # Пакет react-native-intlayer
 
-Пакет `react-native-intlayer` предоставляет необходимые инструменты для интеграции Intlayer в приложения React Native. Он включает провайдер и полифилы для поддержки локалей.
+Пакет `react-native-intlayer` предоставляет необходимые инструменты для интеграции Intlayer в приложения React Native. Он реэкспортирует полный API `react-intlayer` (хуки и утилиты) с `IntlayerProvider`, адаптированным для React Native, а также полифилы и конфигурацию Metro, необходимые для работы в React Native.
+
+> В приложении React Native импортируйте **всё** из `react-native-intlayer`. Устанавливать или импортировать `react-intlayer` напрямую не нужно.
 
 ## Установка
 
@@ -34,26 +39,57 @@ npm install react-native-intlayer
 
 ### Провайдер
 
-| Компонент          | Описание                                                                                    |
-| ------------------ | ------------------------------------------------------------------------------------------- |
-| `IntlayerProvider` | Провайдер-компонент, который оборачивает ваше приложение и предоставляет контекст Intlayer. |
+| Компонент          | Описание                                                                                                                                  |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerProvider` | Провайдер-компонент, который оборачивает ваше приложение и предоставляет контекст Intlayer. Автоматически применяет необходимые полифилы. |
+
+```tsx
+import { IntlayerProvider } from "react-native-intlayer";
+```
+
+### Хуки и утилиты
+
+Они реэкспортируются из `react-intlayer`, поэтому вы можете импортировать их напрямую из `react-native-intlayer`:
 
-Импорт:
+| Экспорт                                                                                                           | Описание                                            |
+| ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
+| `useIntlayer`                                                                                                     | Доступ к локализованному контенту по ключу словаря. |
+| `useLocale`                                                                                                       | Чтение и изменение текущей локали.                  |
+| `useDictionary`, `useDictionaryAsync`, `useDictionaryDynamic`, `useLoadDynamic`                                   | Загрузка содержимого словаря различными способами.  |
+| `useI18n`                                                                                                         | Совместимый с i18next хук.                          |
+| `t`                                                                                                               | Вспомогательная функция для встроенного перевода.   |
+| `getIntlayer`, `getDictionary`                                                                                    | Императивные геттеры контента.                      |
+| `localeCookie`, `localeInStorage`, `setLocaleCookie`, `setLocaleInStorage`, `useLocaleCookie`, `useLocaleStorage` | Вспомогательные функции для сохранения локали.      |
 
 ```tsx
-import "react-native-intlayer";
+import { useIntlayer, useLocale, t } from "react-native-intlayer";
 ```
 
-### Полифилл
+### Полифил
 
 | Функция            | Описание                                                                         |
 | ------------------ | -------------------------------------------------------------------------------- |
 | `intlayerPolyfill` | Функция, применяющая необходимые полифилы для поддержки Intlayer в React Native. |
 
-Импорт:
+```tsx
+import { intlayerPolyfill } from "react-native-intlayer";
+```
+
+> Полифил применяется автоматически при импорте `IntlayerProvider`. Вызывайте `intlayerPolyfill` вручную только если вам нужны полифилы до монтирования провайдера.
+
+### Форматтеры
+
+Хуки форматирования чисел, дат и другие функции на базе Intl доступны из подпути `/format`:
+
+```tsx
+import { useNumber, useDate } from "react-native-intlayer/format";
+```
+
+### Markdown и HTML
 
 ```tsx
-import "react-native-intlayer";
+import { MarkdownProvider } from "react-native-intlayer/markdown";
+import { HTMLProvider } from "react-native-intlayer/html";
 ```
 
 ### Конфигурация Metro
@@ -64,11 +100,8 @@ import "react-native-intlayer";
 | ------------------------- | ------------------------------------------------------------------------------------------- |
 | `configMetroIntlayer`     | Асинхронная функция, которая подготавливает Intlayer и объединяет конфигурацию Metro.       |
 | `configMetroIntlayerSync` | Синхронная функция, которая объединяет конфигурацию Metro без подготовки ресурсов Intlayer. |
-| `exclusionList`           | Создаёт шаблон RegExp для blockList Metro, чтобы исключать файлы контента из bundle.        |
-
-Импорт:
+| `exclusionList`           | Создаёт шаблон RegExp для blockList Metro, чтобы исключать файлы контента из бандла.        |
 
 ```tsx
-import "react-native-intlayer/metro";
-import "react-native-intlayer/metro";
+import { configMetroIntlayer } from "react-native-intlayer/metro";
 ```