@intlayer/docs 8.9.4 → 8.9.6-canary.0

package/docs/pt/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-04-08
+updatedAt: 2026-05-12
 title: Configuração (Configuration)
 description: Saiba como configurar o Intlayer para a sua aplicação. Entenda as várias configurações e opções disponíveis para personalizar o Intlayer conforme as suas necessidades.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.9.4
+    date: 2026-05-12
+    changes: "Adicionar suporte para o provedor LM Studio"
   - version: 8.7.0
     date: 2026-04-08
     changes: "Adicionadas as opções `prune` e `minify` à configuração de build"
@@ -350,7 +353,7 @@ const config: IntlayerConfig = {
   ai: {
     /**
      * Provedor de IA a utilizar.
-     * Opções: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
+     * Opções: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai', 'lmstudio'
      * Padrão: 'openai'
      */
     provider: "openai",
@@ -919,16 +922,17 @@ O Intlayer suporta múltiplos provedores de IA para máxima flexibilidade. Os pr
 - **Groq**
 - **Amazon Bedrock**
 - **Together.ai**
-
-| Campo                | Descrição                                                                                                                             | Tipo                                                                                                                                                                                                                                                                                                                                                                                           | Padrão      | Exemplo                                                       | Nota                                                                                                                                                                                                  |
-| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `provider`           | O provedor a utilizar para as funcionalidades de IA do Intlayer.                                                                      | `'openai'` &#124; <br/> `'anthropic'` &#124; <br/> `'mistral'` &#124; <br/> `'deepseek'` &#124; <br/> `'gemini'` &#124; <br/> `'ollama'` &#124; <br/> `'openrouter'` &#124; <br/> `'alibaba'` &#124; <br/> `'fireworks'` &#124; <br/> `'groq'` &#124; <br/> `'huggingface'` &#124; <br/> `'bedrock'` &#124; <br/> `'googleaistudio'` &#124; <br/> `'googlevertex'` &#124; <br/> `'togetherai'` | `undefined` | `'anthropic'`                                                 | Diferentes provedores requerem diferentes chaves de API e têm preços diferentes.                                                                                                                      |
-| `model`              | O modelo a utilizar para as funcionalidades de IA.                                                                                    | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Nenhum      | `'gpt-4o-2024-11-20'`                                         | O modelo específico varia de acordo com o provedor.                                                                                                                                                   |
-| `temperature`        | Controla a aleatoriedade das respostas da IA.                                                                                         | `number`                                                                                                                                                                                                                                                                                                                                                                                       | Nenhum      | `0.1`                                                         | Temperatura mais alta = mais criativo e menos previsível.                                                                                                                                             |
-| `apiKey`             | A sua chave de API para o provedor selecionado.                                                                                       | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Nenhum      | `process.env.OPENAI_API_KEY`                                  | Para ser mantido secreto; armazenar em variáveis de ambiente.                                                                                                                                         |
-| `applicationContext` | Contexto adicional sobre a sua aplicação para ajudar a IA a gerar traduções mais precisas (domínio, público-alvo, tom, terminologia). | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Nenhum      | `'O meu contexto de aplicação'`                               | Pode ser usado para adicionar regras (ex: `"Não deves transformar os URLs"`).                                                                                                                         |
-| `baseURL`            | O URL base para a API de IA.                                                                                                          | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Nenhum      | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Pode apontar para um endpoint de API de IA local ou personalizado.                                                                                                                                    |
-| `dataSerialization`  | Formato de serialização de dados para as funcionalidades de IA.                                                                       | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                 | `undefined` | `'toon'`                                                      | • `'json'`: padrão, fiável; consome mais tokens.<br/>• `'toon'`: menos tokens, menos consistente.<br/>• Parâmetros adicionais são passados para o modelo como contexto (esforço de raciocínio, etc.). |
+- **LM Studio**
+
+| Campo                | Descrição                                                                                                                             | Tipo                                                                                                                                                                                                                                                                                                                                                                                                                     | Padrão      | Exemplo                                                       | Nota                                                                                                                                                                                                  |
+| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `provider`           | O provedor a utilizar para as funcionalidades de IA do Intlayer.                                                                      | `'openai'` &#124; <br/> `'anthropic'` &#124; <br/> `'mistral'` &#124; <br/> `'deepseek'` &#124; <br/> `'gemini'` &#124; <br/> `'ollama'` &#124; <br/> `'openrouter'` &#124; <br/> `'alibaba'` &#124; <br/> `'fireworks'` &#124; <br/> `'groq'` &#124; <br/> `'huggingface'` &#124; <br/> `'bedrock'` &#124; <br/> `'googleaistudio'` &#124; <br/> `'googlevertex'` &#124; <br/> `'togetherai'` &#124; <br/> `'lmstudio'` | `undefined` | `'anthropic'`                                                 | Diferentes provedores requerem diferentes chaves de API e têm preços diferentes.                                                                                                                      |
+| `model`              | O modelo a utilizar para as funcionalidades de IA.                                                                                    | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Nenhum      | `'gpt-4o-2024-11-20'`                                         | O modelo específico varia de acordo com o provedor.                                                                                                                                                   |
+| `temperature`        | Controla a aleatoriedade das respostas da IA.                                                                                         | `number`                                                                                                                                                                                                                                                                                                                                                                                                                 | Nenhum      | `0.1`                                                         | Temperatura mais alta = mais criativo e menos previsível.                                                                                                                                             |
+| `apiKey`             | A sua chave de API para o provedor selecionado.                                                                                       | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Nenhum      | `process.env.OPENAI_API_KEY`                                  | Para ser mantido secreto; armazenar em variáveis de ambiente.                                                                                                                                         |
+| `applicationContext` | Contexto adicional sobre a sua aplicação para ajudar a IA a gerar traduções mais precisas (domínio, público-alvo, tom, terminologia). | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Nenhum      | `'O meu contexto de aplicação'`                               | Pode ser usado para adicionar regras (ex: `"Não deves transformar os URLs"`).                                                                                                                         |
+| `baseURL`            | O URL base para a API de IA.                                                                                                          | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Nenhum      | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Pode apontar para um endpoint de API de IA local ou personalizado.                                                                                                                                    |
+| `dataSerialization`  | Formato de serialização de dados para as funcionalidades de IA.                                                                       | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                           | `undefined` | `'toon'`                                                      | • `'json'`: padrão, fiável; consome mais tokens.<br/>• `'toon'`: menos tokens, menos consistente.<br/>• Parâmetros adicionais são passados para o modelo como contexto (esforço de raciocínio, etc.). |
 
 ---
 

package/docs/pt/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2026-01-28
+updatedAt: 2026-05-12
 title: Arquivo de Conteúdo
 description: Aprenda como personalizar as extensões para seus arquivos de declaração de conteúdo. Siga esta documentação para implementar condições de forma eficiente em seu projeto.
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 8.9.0
+    date: 2026-05-12
+    changes: "Adicionar tipo de nó de conteúdo `plural`"
   - version: 8.0.0
     date: 2026-01-28
     changes: "Adicionar tipo de nó de conteúdo `html`"
@@ -63,6 +66,7 @@ import { type ReactNode } from "react";
 import {
   t,
   enu,
+  plural,
   cond,
   nest,
   md,
@@ -82,6 +86,7 @@ interface Content {
   };
   multilingualContent: string;
   quantityContent: string;
+  pluralContent: string;
   conditionalContent: string;
   markdownContent: never;
   htmlContent: never;
@@ -118,6 +123,10 @@ export default {
       ">5": "Alguns carros",
       ">19": "Muitos carros",
     }),
+    pluralContent: plural({
+      one: "One car",
+      other: "{{count}} cars",
+    }),
     conditionalContent: cond({
       true: "Validação está ativada",
       false: "Validação está desativada",
@@ -172,6 +181,13 @@ export default {
         ">5": "Alguns carros",
         ">19": "Muitos carros",
       },
+      "pluralContent": {
+        "nodeType": "plural",
+        "plural": {
+          "one": "One car",
+          "other": "{{count}} cars",
+        },
+      },
     },
     "conditionalContent": {
       "nodeType": "condition",
@@ -219,6 +235,7 @@ Nós de conteúdo são os blocos de construção do conteúdo do dicionário. El
 - **Valores primitivos**: strings, números, booleanos, null, undefined
 - **Nós tipados**: Tipos especiais de conteúdo como traduções, condições, markdown, etc.
 - **Funções**: Conteúdo dinâmico que pode ser avaliado em tempo de execução [veja Busca por Função](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/function_fetching.md)
+- **Conteúdo Plural**: Veja Conteúdo Plural [Veja Conteúdo Plural](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/plural.md)
 - **Conteúdo aninhado**: Referências a outros dicionários
 
 #### Tipos de Conteúdo
@@ -544,6 +561,8 @@ multilingualContent: t({
 });
 ```
 
+> Veja [Conteúdo de Tradução (`t`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/translation.md) para mais informações.
+
 ### Conteúdo Condicional (`cond`)
 
 Conteúdo que muda com base em condições booleanas:
@@ -557,6 +576,8 @@ conditionalContent: cond({
 });
 ```
 
+> Veja [Conteúdo Condicional (`cond`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/condition.md) para mais informações.
+
 ### Conteúdo de Enumeração (`enu`)
 
 Conteúdo que varia com base em valores enumerados:
@@ -571,6 +592,23 @@ statusContent: enu({
 });
 ```
 
+> Veja [Conteúdo de Enumeração (`enu`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/enumeration.md) para mais informações.
+
+### Conteúdo Plural (`plural`)
+
+Conteúdo que varia com base nas regras de plural:
+
+```typescript
+import { plural } from "intlayer";
+
+pluralContent: plural({
+  one: "One car",
+  other: "{{count}} cars",
+});
+```
+
+> Veja [Conteúdo Plural Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/plural.md) para mais informações.
+
 ### Conteúdo de Inserção (`insert`)
 
 Conteúdo que pode ser inserido em outros conteúdos:
@@ -581,6 +619,8 @@ import { insert } from "intlayer";
 insertionContent: insert("Este texto pode ser inserido em qualquer lugar");
 ```
 
+> Veja [Conteúdo de Inserção (`insert`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/insertion.md) para mais informações.
+
 ### Conteúdo Aninhado (`nest`)
 
 Referências a outros dicionários:
@@ -591,6 +631,8 @@ import { nest } from "intlayer";
 nestedContent: nest("about-page");
 ```
 
+> Veja [Conteúdo Aninhado (`nest`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/nesting.md) para mais informações.
+
 ### Conteúdo Markdown (`md`)
 
 Conteúdo de texto rico em formato Markdown:
@@ -603,6 +645,8 @@ markdownContent: md(
 );
 ```
 
+> Veja [Conteúdo Markdown (`md`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/markdown.md) para mais informações.
+
 ### Conteúdo HTML (`html`)
 
 Conteúdo HTML rico que pode usar tags padrão ou componentes personalizados:
@@ -620,6 +664,8 @@ localizedHtmlContent: t({
 });
 ```
 
+> Veja [Conteúdo HTML (`html`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/html.md) para mais informações.
+
 ### Conteúdo por Gênero (`gender`)
 
 Conteúdo que varia com base no gênero:
@@ -634,6 +680,8 @@ genderContent: gender({
 });
 ```
 
+> Veja [Conteúdo por Gênero (`gender`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/gender.md) para mais informações.
+
 ### Conteúdo de Arquivo (`file`)
 
 Referências a arquivos externos:
@@ -644,6 +692,8 @@ import { file } from "intlayer";
 fileContent: file("./path/to/content.txt");
 ```
 
+> Veja [Conteúdo de Arquivo (`file`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/file.md) para mais informações.
+
 ## Criando Arquivos de Conteúdo
 
 ### Estrutura Básica de Arquivo de Conteúdo

package/docs/pt/plugins/sync-po.md

@@ -160,30 +160,9 @@ syncPO({
   source: ({ key, locale }) => string, // obrigatório
   location?: string, // rótulo opcional, padrão: "sync-po::path/to/source"
   priority?: number, // prioridade opcional para resolução de conflitos, padrão: 0
-  format?: 'icu' | 'i18next' | 'vue-i18n', // opcional, necessário apenas quando seus valores msgstr usam uma sintaxe de interpolação específica
 });
 ```
 
-#### `format` ('icu' | 'i18next' | 'vue-i18n')
-
-Arquivos PO são sempre arquivos Gettext Portable Object — isso é fixo. Esta opção descreve apenas a **sintaxe de interpolação** usada dentro dos valores `msgstr`, para que o Intlayer possa convertê-los em seu próprio formato no momento da análise (via `formatDictionary`) e de volta ao gravar a saída.
-
-- `undefined` _(padrão)_: os valores `msgstr` são tratados como strings simples — sem transformação. Use isso para a maioria dos arquivos PO.
-- `'icu'`: os valores `msgstr` usam a sintaxe de mensagem ICU (ex: `{count, plural, one {# item} other {# items}}`).
-- `'i18next'`: os valores `msgstr` usam a sintaxe de interpolação i18next (ex: `{{variable}}`).
-- `'vue-i18n'`: os valores `msgstr` usam a sintaxe Vue I18n.
-
-> A transformação é aplicada pelo `formatDictionary` do `@intlayer/chokidar` no carregamento e revertida com `formatDictionaryOutput` na gravação. Para regras complexas como plurais ICU, a fidelidade de ida e volta não é garantida.
-
-**Exemplo — arquivos PO contêm interpolação no estilo i18next:**
-
-```ts
-syncPO({
-  source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
-  format: "i18next",
-}),
-```
-
 ### Múltiplas fontes PO e prioridade
 
 Você pode adicionar vários plugins `syncPO` para sincronizar diferentes fontes PO. Isso é útil quando você tem várias fontes de tradução ou estruturas PO diferentes em seu projeto.

package/docs/ru/benchmark/nextjs.md

@@ -61,6 +61,13 @@ history:
 
 Intlayer пытается оптимизировать все эти аспекты.
 
+## TL;DR
+
+- **Intlayer** и **next-translate**: Лучшие варианты для производительности Next.js, предлагающие минимальный размер и лучшую поддержку статического рендеринга.
+- **next-intl**: Самый модный вариант, но тяжелый и сложный в оптимизации для больших приложений.
+- **next-i18next**: Популярный и богатый плагинами, но имеет значительный вес бандла (~3× Intlayer).
+- **Избегайте**: **gt-next** и **lingo.dev** из-за серьезных проблем с производительностью, привязки к вендору и багов, ломающих сборку.
+
 ## Проверьте свое приложение
 
 Чтобы выявить эти проблемы, я создал бесплатный сканер, который вы можете попробовать [здесь](https://intlayer.org/i18n-seo-scanner).
@@ -99,14 +106,14 @@ Intlayer пытается оптимизировать все эти аспек
 Для этого бенчмарка мы сравнили следующие библиотеки:
 
 - `Base App` (Без библиотеки i18n)
-- `next-intlayer` (v8.7.5)
+- `next-intlayer` (v8.7.12)
 - `next-i18next` (v16.0.5)
 - `next-intl` (v4.9.1)
 - `@lingui/core` (v5.3.0)
 - `next-translate` (v3.1.2)
 - `next-international` (v1.3.1)
 - `@inlang/paraglide-js` (v2.15.1)
-- `tolgee` (v7.0.0)
+- `@tolgee/react` (v7.0.0)
 - `@lingo.dev/compiler` (v0.4.0)
 - `wuchale` (v0.22.11)
 - `gt-next` (v6.16.5)
@@ -161,10 +168,10 @@ Intlayer пытается оптимизировать все эти аспек
 
 **(General Translation)** (`gt-next@6.16.5`):
 
-- Для приложения весом 110 КБ `gt-react` добавляет более 440 КБ сверху.
+- Для приложения весом 110 КБ `gt-next` добавляет более 440 КБ сверху.
 - `Quota Exceeded, please upgrade your plan` (Квота превышена, пожалуйста, обновите тарифный план) при самой первой сборке с General Translation.
 - Переводы не отображаются; я получаю ошибку `Error: <T> used on the client-side outside of <GTProvider>`, что кажется багом библиотеки.
-- При внедрении **gt-tanstack-start-react** я также столкнулся с [проблемой](https://github.com/generaltranslation/gt/issues/1210#event-24510646961) в библиотеке: `does not provide an export named 'printAST' - @formatjs/icu-messageformat-parser`, которая приводила к поломке приложения. После сообщения об этой проблеме сопровождающий исправил ее в течение 24 часов.
+- При внедрении **gt-next** я также столкнулся с [проблемой](https://github.com/generaltranslation/gt/issues/1210#event-24510646961) в библиотеке: `does not provide an export named 'printAST' - @formatjs/icu-messageformat-parser`, которая приводила к поломке приложения. После сообщения об этой проблеме сопровождающий исправил ее в течение 24 часов.
 - Библиотека блокирует статический рендеринг страниц Next.js.
 
 **(Lingo.dev)** (`@lingo.dev/compiler@0.4.0`):
@@ -186,9 +193,11 @@ Intlayer пытается оптимизировать все эти аспек
 Лично мне не нравится необходимость перегенерировать JS-файлы перед каждым пушем, что создает постоянный риск конфликтов слияния в PR. Инструмент также кажется более ориентированным на Vite, чем на Next.js.
 Наконец, по сравнению с другими решениями, Paraglide не использует хранилище (например, React context) для получения текущей локали для рендеринга контента. Для каждого обрабатываемого узла он запрашивает локаль из localStorage / куки и т.д. Это приводит к выполнению ненужной логики, которая влияет на реактивность компонентов.
 
+> Примечание по paraglide: решение внедряет код в вашу кодовую базу для импорта, в результате показатель 'размер библиотеки' в отчете о бенчмарке практически равен 0. Генерация кода — это хорошо, так как используемая функция будет включать только необходимую логику (все префиксы против отсутствия префиксов, куки против хранилища и т.д.). В сравнении с этим, Intlayer выполняет фильтрацию с помощью внедрения переменных окружения в сборку, чтобы заставить сборщик исключить контент в зависимости от логики. Благодаря этому paraglide и intlayer оказываются в 6-10 раз легче, чем i18next или next-intl.
+
 ### 3 — Приемлемые решения
 
-**(Tolgee)** (`tolgee@7.0.0`):
+**(Tolgee)** (`@tolgee/react@7.0.0`):
 
 `Tolgee` решает многие из упомянутых ранее проблем. Мне показалось, что его сложнее внедрить, чем аналогичные инструменты. Он не обеспечивает типобезопасность, что также затрудняет отлов отсутствующих ключей на этапе компиляции. Мне пришлось обернуть функции Tolgee своими собственными, чтобы добавить обнаружение отсутствующих ключей.
 
@@ -216,7 +225,7 @@ Intlayer пытается оптимизировать все эти аспек
 
 `next-translate` — моя основная рекомендация, если вам нравится API в стиле `t()`. Он элегантен благодаря `next-translate-plugin`, загружая пространства имен через `getStaticProps` с помощью загрузчика Webpack / Turbopack. Это также самый легкий вариант (~2.5 КБ). Что касается пространств имен, их определение для каждой страницы или маршрута в конфиге хорошо продумано и проще в обслуживании, чем основные альтернативы, такие как **next-intl** или **next-i18next**. В версии `3.1.2` я заметил, что статический рендеринг не работал; Next.js откатывался к динамическому рендерингу.
 
-**(Intlayer)** (`next-intlayer@8.7.5`):
+**(Intlayer)** (`next-intlayer@8.7.12`):
 
 Я не буду лично судить о `next-intlayer` ради объективности, так как это мое собственное решение.
 

package/docs/ru/benchmark/solid.md

@@ -0,0 +1,155 @@
+---
+createdAt: 2026-04-20
+updatedAt: 2026-04-21
+title: Лучшее i18n решение для Solid в 2026 году - Отчет о бенчмарке
+description: Сравните библиотеки интернационализации (i18n) для Solid, такие как solid-primitives, solid-i18next и Intlayer. Подробный отчет о производительности, размере бандла, утечках и реактивности.
+keywords:
+  - benchmark
+  - i18n
+  - intl
+  - solid
+  - производительность
+  - intlayer
+slugs:
+  - doc
+  - benchmark
+  - solid
+author: Aymeric PINEAU
+applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-solid-template
+history:
+  - version: 8.7.12
+    date: 2026-01-06
+    changes: "Инициализация бенчмарка"
+---
+
+# Библиотеки i18n для Solid — Отчет о бенчмарке 2026
+
+Эта страница представляет собой отчет о бенчмарке i18n-решений для Solid.
+
+## Содержание
+
+<Toc/>
+
+## Интерактивный бенчмарк
+
+<I18nBenchmark framework="vite-solid" vertical/>
+
+## Ссылка на результаты:
+
+<iframe 
+  src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_solid.md" 
+  width="100%" 
+  height="600px"
+  style="border:none;">
+</iframe>
+
+> https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_solid.md
+
+Полный репозиторий бенчмарка можно найти [здесь](https://github.com/intlayer-org/benchmark-i18n/tree/main).
+
+## Введение
+
+Решения для интернационализации являются одними из самых тяжелых зависимостей в Solid-приложении. Основной риск заключается в передаче ненужного контента: переводов для других страниц и других локалей в бандле одного маршрута.
+
+По мере роста вашего приложения эта проблема может быстро привести к раздуванию JavaScript, отправляемого клиенту, и замедлению навигации.
+
+На практике в наименее оптимизированных реализациях интернационализированная страница может оказаться в несколько раз тяжелее версии без i18n.
+
+Другой аспект — это опыт разработчика: то, как вы объявляете контент, типы, организацию пространств имен, динамическую загрузку и реактивность при смене локали.
+
+## TL;DR
+
+- **Intlayer**: Рекомендуемый выбор для профессиональных Solid-приложений, требующих расширенных функций и оптимизации (v8.7.12).
+- **@solid-primitives/i18n**: Отличная легкая альтернатива для простых проектов, хотя ей не хватает расширенных функций, таких как ленивая загрузка.
+- **solid-i18next**: Стандартный, но тяжелый вариант (~4.7 раза больше Intlayer) с теми же недостатками, что и React i18next.
+- **Paraglide**: Инновационный подход, но сложный DX и проблемы с tree-shaking в некоторых конфигурациях.
+
+## Проверьте свое приложение
+
+Чтобы быстро выявить проблемы с утечкой i18n, я настроил бесплатный сканер, доступный [здесь](https://intlayer.org/i18n-seo-scanner).
+
+<iframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+
+## Проблема
+
+Два рычага необходимы для ограничения стоимости мультиязычного приложения:
+
+- Разделение контента по страницам / пространствам имен, чтобы не загружать целые словари, когда они вам не нужны.
+- Динамическая загрузка нужной локали только тогда, когда она требуется.
+
+Понимание технических ограничений этих подходов:
+
+**Динамическая загрузка**
+
+Без динамической загрузки большинство решений хранят сообщения в памяти с первого рендеринга, что создает значительные накладные расходы для приложений с множеством маршрутов и локалей.
+
+При использовании динамической загрузки вы идете на компромисс: меньше начального JS, но иногда дополнительный запрос при переключении языка.
+
+**Разделение контента**
+
+Синтаксис, построенный вокруг `t('a.b.c')`, очень удобен, но часто способствует хранению больших JSON-объектов во время выполнения. Эта модель затрудняет tree-shaking, если библиотека не предлагает реальную стратегию разделения контента для каждой страницы.
+
+## Методология
+
+Для этого бенчмарка мы сравнили следующие библиотеки:
+
+- `Base App` (Без библиотеки i18n)
+- `solid-intlayer` (v8.7.12)
+- `@solid-primitives/i18n` (v2.2.1)
+- `solid-i18next` (v17.0.2)
+- `@inlang/paraglide-js` (v2.17.0)
+
+Фреймворк — `Solid` с мультиязычным приложением из **10 страниц** и **10 языков**.
+
+Мы сравнили **четыре стратегии загрузки**:
+
+| Стратегия                 | Без пространств имен (глобальная)               | С пространствами имен (локальная/scoped)                                         |
+| :------------------------ | :---------------------------------------------- | :------------------------------------------------------------------------------- |
+| **Статическая загрузка**  | **Static**: Все в памяти при запуске.           | **Scoped static**: Разделено по пространствам имен; все загружается при запуске. |
+| **Динамическая загрузка** | **Dynamic**: Загрузка по требованию для локали. | **Scoped dynamic**: Гранулярная загрузка по пространствам имен и локалям.        |
+
+## Резюме стратегий
+
+- **Статическая (Static)**: Простота; отсутствие задержек сети после начальной загрузки. Минус: большой размер бандла.
+- **Динамическая (Dynamic)**: Уменьшает начальный вес (ленивая загрузка). Идеально при наличии множества локалей.
+- **Локальная статическая (Scoped static)**: Позволяет организовать код (логическое разделение) без сложных дополнительных сетевых запросов.
+- **Локальная динамическая (Scoped dynamic)**: Лучший подход для _разделения кода_ и производительности. Минимизирует использование памяти, загружая только то, что нужно для текущего представления и активной локали.
+
+## Результаты в деталях
+
+### 1 — Решения, которых следует избегать
+
+> В экосистеме Solid нет однозначных решений, которых следует избегать.
+
+### 2 — Приемлемые решения
+
+**(solid-i18next)** (`solid-i18next@17.0.2`):
+
+`solid-i18next`, вероятно, является самым популярным вариантом, так как был одним из первых решений для нужд i18n в JavaScript-приложениях. У него также есть широкий набор плагинов от сообщества для конкретных задач.
+
+Пакет тяжелый (~14.6 КБ, что примерно в 4.7 раза больше `solid-intlayer`).
+
+Тем не менее, у него те же основные недостатки, что и у стеков, построенных на `t('a.b.c')`: оптимизация возможна, но отнимает очень много времени, а большие проекты рискуют столкнуться с плохими практиками (пространства имен + динамическая загрузка + типы).
+
+**(@solid-primitives/i18n)** (`@solid-primitives/i18n@2.2.1`):
+
+Solid primitive чрезвычайно легкий и эффективный. Я рекомендую это решение для небольших проектов, но ему может быстро перестать хватать функций для профессиональных решений, включая управление куки, перенаправление прокси, форматировщики и т. д.
+В нем также отсутствует ленивая загрузка и разделение пространств имен для оптимизации размера страницы.
+
+**(Paraglide)** (`@inlang/paraglide-js@2.17.0`):
+
+`Paraglide` предлагает инновационный, хорошо продуманный подход. Тем не менее, в этом бенчмарке рекламируемый ими tree-shaking не сработал для моей реализации. Процесс работы и DX также сложнее, чем у других вариантов.
+Лично мне не нравится необходимость регенерировать JS-файлы перед каждым пушем, что создает постоянный риск конфликтов при слиянии в PR.
+Наконец, по сравнению с другими решениями, Paraglide не использует стор (например, Solid signal) для получения текущей локали для рендеринга. Для каждого обработанного узла он запрашивает локаль из localStorage / куки и т.д. Это приводит к выполнению ненужной логики, что влияет на реактивность компонентов.
+
+### 3 — Рекомендации
+
+**(Intlayer)** (`solid-intlayer@8.7.12`):
+
+Я не буду лично оценивать `solid-intlayer` ради объективности, так как это мое собственное решение.
+
+### Личное примечание
+
+Это примечание является личным и не влияет на результаты бенчмарка. Тем не менее, в мире i18n часто можно встретить консенсус вокруг паттерна типа `const t = useTranslation('xx')` + `<>{t('xx.xx')}</>` для переведенного контента.
+
+В Solid-приложениях внедрение функции в качестве `JSX.Element` является, на мой взгляд, антипаттерном. Это также добавляет лишнюю сложность и накладные расходы на выполнение JavaScript (даже если это почти незаметно).