@intlayer/docs 8.9.4 → 8.9.5

package/docs/it/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-04-08
+updatedAt: 2026-05-12
 title: Configurazione
 description: Scopri come configurare Intlayer per la tua applicazione. Comprendi le diverse impostazioni e opzioni disponibili per personalizzare Intlayer secondo le tue necessità.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.9.4
+    date: 2026-05-12
+    changes: "Aggiunto il supporto per il provider LM Studio"
   - version: 8.7.0
     date: 2026-04-08
     changes: "Aggiunte le opzioni `prune` e `minify` alla configurazione di build"
@@ -350,7 +353,7 @@ const config: IntlayerConfig = {
   ai: {
     /**
      * Fornitore IA da utilizzare.
-     * Opzioni: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
+     * Opzioni: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai', 'lmstudio'
      * Predefinito: 'openai'
      */
     provider: "openai",
@@ -919,16 +922,17 @@ Intlayer supporta diversi fornitori IA per la massima flessibilità. I fornitori
 - **Groq**
 - **Amazon Bedrock**
 - **Together.ai**
-
-| Campo                | Descrizione                                                                                                                                             | Tipo                                                                                                                                                                                                                                                                                                                                                                                           | Predefinito | Esempio                                                       | Commenti                                                                                                                                                                                  |
-| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `provider`           | Fornitore IA da utilizzare per le funzionalità IA di 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'`                                                 | Fornitori diversi richiedono chiavi API diverse e hanno prezzi diversi.                                                                                                                   |
-| `model`              | Modello IA da utilizzare per le funzionalità IA.                                                                                                        | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Nessuno     | `'gpt-4o-2024-11-20'`                                         | I modelli specifici dipendono dal fornitore.                                                                                                                                              |
-| `temperature`        | Controlla la casualità della risposta IA.                                                                                                               | `number`                                                                                                                                                                                                                                                                                                                                                                                       | Nessuno     | `0.1`                                                         | Temperatura più alta = più creativo e meno affidabile.                                                                                                                                    |
-| `apiKey`             | La tua chiave API per il fornitore selezionato.                                                                                                         | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Nessuno     | `process.env.OPENAI_API_KEY`                                  | Deve essere mantenuto segreto; usa le variabili d'ambiente.                                                                                                                               |
-| `applicationContext` | Contesto aggiuntivo sulla tua applicazione per aiutare l'IA a generare traduzioni più accurate (dominio, pubblico di destinazione, tono, terminologia). | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Nessuno     | `'Mio contesto applicativo personalizzato'`                   | Può essere utilizzato per aggiungere regole (es: `"Non dovresti tradurre i tuoi URL"`).                                                                                                   |
-| `baseURL`            | URL base per l'API IA.                                                                                                                                  | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Nessuno     | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Può puntare a endpoint API IA locali o personalizzati.                                                                                                                                    |
-| `dataSerialization`  | Formato di serializzazione dei dati per le funzionalità IA.                                                                                             | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                 | `undefined` | `'toon'`                                                      | • `'json'`: predefinito, affidabile; utilizza più token.<br/>• `'toon'`: meno token, meno stabile.<br/>• Passa il contesto al modello come parametro aggiuntivo (reasoning effort, ecc.). |
+- **LM Studio**
+
+| Campo                | Descrizione                                                                                                                                             | Tipo                                                                                                                                                                                                                                                                                                                                                                                                                     | Predefinito | Esempio                                                       | Commenti                                                                                                                                                                                  |
+| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `provider`           | Fornitore IA da utilizzare per le funzionalità IA di 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'`                                                 | Fornitori diversi richiedono chiavi API diverse e hanno prezzi diversi.                                                                                                                   |
+| `model`              | Modello IA da utilizzare per le funzionalità IA.                                                                                                        | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Nessuno     | `'gpt-4o-2024-11-20'`                                         | I modelli specifici dipendono dal fornitore.                                                                                                                                              |
+| `temperature`        | Controlla la casualità della risposta IA.                                                                                                               | `number`                                                                                                                                                                                                                                                                                                                                                                                                                 | Nessuno     | `0.1`                                                         | Temperatura più alta = più creativo e meno affidabile.                                                                                                                                    |
+| `apiKey`             | La tua chiave API per il fornitore selezionato.                                                                                                         | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Nessuno     | `process.env.OPENAI_API_KEY`                                  | Deve essere mantenuto segreto; usa le variabili d'ambiente.                                                                                                                               |
+| `applicationContext` | Contesto aggiuntivo sulla tua applicazione per aiutare l'IA a generare traduzioni più accurate (dominio, pubblico di destinazione, tono, terminologia). | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Nessuno     | `'Mio contesto applicativo personalizzato'`                   | Può essere utilizzato per aggiungere regole (es: `"Non dovresti tradurre i tuoi URL"`).                                                                                                   |
+| `baseURL`            | URL base per l'API IA.                                                                                                                                  | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Nessuno     | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Può puntare a endpoint API IA locali o personalizzati.                                                                                                                                    |
+| `dataSerialization`  | Formato di serializzazione dei dati per le funzionalità IA.                                                                                             | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                           | `undefined` | `'toon'`                                                      | • `'json'`: predefinito, affidabile; utilizza più token.<br/>• `'toon'`: meno token, meno stabile.<br/>• Passa il contesto al modello come parametro aggiuntivo (reasoning effort, ecc.). |
 
 ---
 

package/docs/it/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2026-01-28
+updatedAt: 2026-05-12
 title: File di Contenuto
 description: Scopri come personalizzare le estensioni per i tuoi file di dichiarazione dei contenuti. Segui questa documentazione per implementare condizioni in modo efficiente nel tuo progetto.
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 8.9.0
+    date: 2026-05-12
+    changes: "Aggiungi il tipo di nodo di contenuto `plural`"
   - version: 8.0.0
     date: 2026-01-28
     changes: "Aggiunto tipo di nodo contenuto `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": "Alcune macchine",
       ">19": "Molte macchine",
     }),
+    pluralContent: plural({
+      one: "One car",
+      other: "{{count}} cars",
+    }),
     conditionalContent: cond({
       true: "La validazione è abilitata",
       false: "La validazione è disabilitata",
@@ -172,6 +181,13 @@ export default {
         ">5": "Alcune auto",
         ">19": "Molte auto",
       },
+      "pluralContent": {
+        "nodeType": "plural",
+        "plural": {
+          "one": "One car",
+          "other": "{{count}} cars",
+        },
+      },
     },
     "conditionalContent": {
       "nodeType": "condizione",
@@ -219,6 +235,7 @@ I nodi di contenuto sono i mattoni fondamentali del contenuto del dizionario. Po
 - **Valori primitivi**: stringhe, numeri, booleani, null, undefined
 - **Nodi tipizzati**: Tipi di contenuto speciali come traduzioni, condizioni, markdown, ecc.
 - **Funzioni**: Contenuto dinamico che può essere valutato a runtime [vedi Recupero Funzioni](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/function_fetching.md)
+- **Contenuto Plurale**: Vedere Contenuto Plurale [Vedere Contenuto Plurale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/plural.md)
 - **Contenuto annidato**: Riferimenti ad altri dizionari
 
 #### Tipi di Contenuto
@@ -544,6 +561,8 @@ multilingualContent: t({
 });
 ```
 
+> Vedere [Contenuto di Traduzione (`t`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/translation.md) per ulteriori informazioni.
+
 ### Contenuto Condizionale (`cond`)
 
 Contenuto che cambia in base a condizioni booleane:
@@ -557,6 +576,8 @@ conditionalContent: cond({
 });
 ```
 
+> Vedere [Contenuto Condizionale (`cond`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/condition.md) per ulteriori informazioni.
+
 ### Contenuto Enumerato (`enu`)
 
 Contenuto che varia in base a valori enumerati:
@@ -571,6 +592,23 @@ statusContent: enu({
 });
 ```
 
+> Vedere [Contenuto Enumerato (`enu`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/enumeration.md) per ulteriori informazioni.
+
+### Contenuto Plurale (`plural`)
+
+Contenuto che varia in base alle regole del plurale:
+
+```typescript
+import { plural } from "intlayer";
+
+pluralContent: plural({
+  one: "One car",
+  other: "{{count}} cars",
+});
+```
+
+> Vedere [Contenuto Plurale Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/plural.md) per ulteriori informazioni.
+
 ### Contenuto di Inserimento (`insert`)
 
 Contenuto che può essere inserito in altri contenuti:
@@ -581,6 +619,8 @@ import { insert } from "intlayer";
 insertionContent: insert("Questo testo può essere inserito ovunque");
 ```
 
+> Vedere [Contenuto di Inserimento (`insert`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/insertion.md) per ulteriori informazioni.
+
 ### Contenuto Nidificato (`nest`)
 
 Riferimenti ad altri dizionari:
@@ -591,6 +631,8 @@ import { nest } from "intlayer";
 nestedContent: nest("about-page");
 ```
 
+> Vedere [Contenuto Nidificato (`nest`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/nesting.md) per ulteriori informazioni.
+
 ### Contenuto Markdown (`md`)
 
 Contenuto di testo ricco in formato Markdown:
@@ -603,6 +645,8 @@ markdownContent: md(
 );
 ```
 
+> Vedere [Contenuto Markdown (`md`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/markdown.md) per ulteriori informazioni.
+
 ### Contenuto HTML (`html`)
 
 Contenuto HTML ricco che può usare tag standard o componenti personalizzati:
@@ -620,6 +664,8 @@ localizedHtmlContent: t({
 });
 ```
 
+> Vedere [Contenuto HTML (`html`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/html.md) per ulteriori informazioni.
+
 ### Contenuto per Genere (`gender`)
 
 Contenuto che varia in base al genere:
@@ -634,6 +680,8 @@ genderContent: gender({
 });
 ```
 
+> Vedere [Contenuto per Genere (`gender`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/gender.md) per ulteriori informazioni.
+
 ### Contenuto da File (`file`)
 
 Riferimenti a file esterni:
@@ -644,6 +692,8 @@ import { file } from "intlayer";
 fileContent: file("./path/to/content.txt");
 ```
 
+> Vedere [Contenuto da File (`file`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/file.md) per ulteriori informazioni.
+
 ## Creazione di File di Contenuto
 
 ### Struttura Base di un File di Contenuto

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

@@ -160,30 +160,9 @@ syncPO({
   source: ({ key, locale }) => string, // richiesto
   location?: string, // etichetta opzionale, default: "sync-po::path/to/source"
   priority?: number, // priorità opzionale per la risoluzione dei conflitti, default: 0
-  format?: 'icu' | 'i18next' | 'vue-i18n', // opzionale, necessario solo quando i valori msgstr utilizzano una specifica sintassi di interpolazione
 });
 ```
 
-#### `format` ('icu' | 'i18next' | 'vue-i18n')
-
-I file PO sono sempre file Gettext Portable Object — questo è fisso. Questa opzione descrive solo la **sintassi di interpolazione** utilizzata all'interno dei valori `msgstr`, in modo che Intlayer possa convertirli nel proprio formato al momento del parsing (tramite `formatDictionary`) e viceversa durante la scrittura dell'output.
-
-- `undefined` _(default)_: i valori `msgstr` sono trattati come stringhe semplici — nessuna trasformazione. Usa questo per la maggior parte dei file PO.
-- `'icu'`: i valori `msgstr` utilizzano la sintassi dei messaggi ICU (es. `{count, plural, one {# item} other {# items}}`).
-- `'i18next'`: i valori `msgstr` utilizzano la sintassi di interpolazione i18next (es. `{{variable}}`).
-- `'vue-i18n'`: i valori `msgstr` utilizzano la sintassi Vue I18n.
-
-> La trasformazione è applicata da `formatDictionary` di `@intlayer/chokidar` al caricamento e invertita con `formatDictionaryOutput` alla scrittura. Per regole complesse come i plurali ICU, la fedeltà del round-trip non è garantita.
-
-**Esempio — i file PO contengono interpolazione in stile i18next:**
-
-```ts
-syncPO({
-  source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
-  format: "i18next",
-}),
-```
-
 ### Sorgenti PO multiple e priorità
 
 Puoi aggiungere più plugin `syncPO` per sincronizzare diverse sorgenti PO. Questo è utile quando hai più sorgenti di traduzione o diverse strutture PO nel tuo progetto.

package/docs/ja/benchmark/index.md

@@ -25,8 +25,8 @@ Benchmark Bloom は、複数の React フレームワークとロード戦略に
 
 各フレームワークの詳細レポートと技術ドキュメントは次のとおりです。
 
-- [**Next.js Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/nextjs.md)
-- [**TanStack Start Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/tanstack.md)
-- [**Vue Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/vue.md)
-- [**Solid Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/solid.md)
-- [**Svelte Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/svelte.md)
+- [**Next.js ベンチマークレポート**](./nextjs.md)
+- [**TanStack Start ベンチマークレポート**](./tanstack.md)
+- [**Vue ベンチマークレポート**](./vue.md)
+- [**Solid ベンチマークレポート**](./solid.md)
+- [**Svelte ベンチマークレポート**](./svelte.md)

package/docs/ja/benchmark/nextjs.md

@@ -61,6 +61,13 @@ history:
 
 Intlayerは、これらの各側面において最適化を試みています。
 
+## TL;DR
+
+- **Intlayer** & **next-translate**: Next.jsのパフォーマンスにおいて最適な選択肢。最小のフットプリントと最高の静的レンダリングサポートを提供。
+- **next-intl**: 最もトレンドのオプションだが、大規模なアプリケーション向けに最適化するには重く、複雑。
+- **next-i18next**: 人気がありプラグインも豊富だが、バンドル重量が非常に大きい（Intlayer의約3倍）。
+- **避けるべき**: **gt-next** と **lingo.dev**。深刻なパフォーマンスの問題、ベンダーロックイン、ビルドを破壊するバグのため。
+
 ## アプリをテストする
 
 これらの問題を顕在化させるために、無料のスキャナーを作成しました。[こちら](https://intlayer.org/i18n-seo-scanner)で試すことができます。
@@ -99,14 +106,14 @@ WebpackやTurbopackを使用し、`[locale]/page.tsx`のようなルートを宣
 このベンチマークでは、以下のライブラリを比較しました。
 
 - `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 @@ Next.jsのバージョンは`16.2.4`（App Router）を使用しました。
 
 **(General Translation)** (`gt-next@6.16.5`):
 
-- 110kbのアプリに対して、`gt-react`は440kb以上の余分なデータを追加します。
+- 110kbのアプリに対して、`gt-next`は440kb以上の余分なデータを追加します。
 - General Translationを使用した最初のビルドで「Quota Exceeded, please upgrade your plan（クォータ超過、プランをアップグレードしてください）」と表示されました。
 - 翻訳がレンダリングされません。`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 @@ Next.jsのバージョンは`16.2.4`（App Router）を使用しました。
 個人的には、プッシュのたびにJSファイルを再生成しなければならないのが嫌いです。これはPRを通じて常にマージ競合のリスクを生み出します。また、このツールはNext.jsよりもViteにフォーカスしているように見えます。
 最後に、他のソリューションと比較して、Paraglideはコンテンツをレンダリングするために現在のロケールを取得するためのストア（例：Reactコンテキスト）を使用しません。パースされる各ノードについて、localStorageやクッキーなどからロケールをリクエストします。これにより、コンポーネントの反応性に影響を与える不要なロジックが実行されます。
 
+> paraglideについての注意：このソリューションは、インポートのためにコードベースにコードを注入します。その結果、ベンチマークレポートの「ライブラリサイズ」指標はほぼ0になります。コード生成は良いことです。なぜなら、使用される関数には必要なロジック（すべてのプレフィックス対プレフィックスなし、クッキー対ストレージなど）のみが含まれるからです。対照的に、Intlayerはビルド時に環境変数を注入して、ロジックに応じてコンテンツをツリーシェイキングするようバンドラーに強制します。このおかげで、paraglideとintlayerは、i18nextやnext-intlよりも6〜10倍軽量なソリューションとなっています。
+
 ### 3 — 許容できるソリューション
 
-**(Tolgee)** (`tolgee@7.0.0`):
+**(Tolgee)** (`@tolgee/react@7.0.0`):
 
 `Tolgee`は前述の問題の多くに対処しています。しかし、同様のツールよりも導入が難しいと感じました。型安全性が提供されていないため、コンパイル時に紛失したキーを見つけることも困難です。キーの不備を検出するために、Tolgeeの関数を自前の関数でラップする必要がありました。
 
@@ -216,7 +225,7 @@ Next.jsのバージョンは`16.2.4`（App Router）を使用しました。
 
 `t()`スタイルのAPIがお好みなら、`next-translate`が私の主な推奨事項です。`next-translate-plugin`を介して優雅に動作し、Webpack / Turbopackローダーを使用して`getStaticProps`経由でネームスペースをロードします。また、今回の中で最も軽量な選択肢です（約2.5kb）。ネームスぺーシングについては、設定ファイルでページやルートごとにネームスペースを定義する方法がよく考えられており、**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/ja/benchmark/solid.md

@@ -0,0 +1,155 @@
+---
+createdAt: 2026-04-20
+updatedAt: 2026-04-21
+title: 2026年 Solid向けの最高のi18nソリューション - ベンチマークレポート
+description: solid-primitives、solid-i18next、IntlayerなどのSolid国際化（i18n）ライブラリを比較します。バンドルサイズ、リーク、反応性に関する詳細なパフォーマンスレポート。
+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: "ベンチマークの初期化"
+---
+
+# Solid i18nライブラリ - 2026年ベンチマークレポート
+
+このページは、Solidにおけるi18nソリューションのベンチマークレポートです。
+
+## 目次
+
+<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なしのバージョンよりも数倍重くなることがあります。
+
+もう一つの影響は、開発者エクスペリエンス（DX）です。コンテンツの宣言方法、型、名前空間の構成、動的ロード、ロケール変更時の反応性などが含まれます。
+
+## TL;DR
+
+- **Intlayer**: 高度な機能と最適化を必要とするプロフェッショナルなSolidアプリケーションに推奨される選択肢（v8.7.12）。
+- **@solid-primitives/i18n**: シンプルなプロジェクトには優れた軽量な代替案ですが、遅延ロードなどの高度な機能に欠けます。
+- **solid-i18next**: 標準的ですが重い選択肢（Intlayerの約4.7倍）で、React i18nextと同じ欠点があります。
+- **Paraglide**: 革新的なアプローチですが、一部のセットアップではDXが複雑で、ツリーシェイキングの問題があります。
+
+## アプリをテストする
+
+i18nリークの問題を素早く特定するために、無料のスキャナーを用意しました。[こちら](https://intlayer.org/i18n-seo-scanner)でお試しいただけます。
+
+<iframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+
+## 問題点
+
+多言語アプリのコストを抑えるためには、2つのレバーが不可欠です。
+
+- ページ/名前空間ごとにコンテンツを分割し、不要な時に辞書全体をロードしないようにする。
+- 必要な時にだけ、適切なロケールを動的にロードする。
+
+これらのアプローチの技術的限界を理解する：
+
+**動的ロード**
+
+動的ロードがない場合、ほとんどのソリューションは最初のレンダリングからメッセージをメモリに保持するため、ルートやロケールが多いアプリでは大きなオーバーヘッドとなります。
+
+動的ロードを使用する場合、トレードオフを受け入れることになります。初期JSは減りますが、言語切り替え時などに追加のリクエストが発生することがあります。
+
+**コンテンツの分割**
+
+`t('a.b.c')` を中心に構築された構文は非常に便利ですが、実行時に大きなJSONオブジェクトを保持することを助長しがちです。このモデルでは、ライブラリがページごとの分割戦略を提供していない限り、ツリーシェイキングが難しくなります。
+
+## 研究方法
+
+このベンチマークでは、以下のライブラリを比較しました。
+
+- `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言語**を持つ多言語アプリを使用しました。
+
+**4つのロード戦略**を比較しました。
+
+| 戦略           | 名前空間なし（グローバル）                      | 名前空間あり（スコープ）                                   |
+| :------------- | :---------------------------------------------- | :--------------------------------------------------------- |
+| **静的ロード** | **Static**: 起動時にすべてをメモリに保持。      | **Scoped static**: 名前空間で分割。起動時にすべてロード。  |
+| **動的ロード** | **Dynamic**: ロケールごとのオンデマンドロード。 | **Scoped dynamic**: 名前空間とロケールごとの詳細なロード。 |
+
+## 戦略のまとめ
+
+- **静的（Static）**: シンプル。初期ロード後のネットワーク遅延なし。欠点：バンドルサイズが大きい。
+- **動的（Dynamic）**: 初期重量を削減（遅延ロード）。ロケールが多い場合に理想的。
+- **名前空間付き静的（Scoped static）**: 複雑な追加リクエストなしで、コードを整理（論理的分離）した状態に保つ。
+- **名前空間付き動的（Scoped dynamic）**: コード分割とパフォーマンスのための最善のアプローチ。現在のビューとアクティブなロケールに必要なものだけをロードし、メモリ使用量を最小限に抑える。
+
+## 結果の詳細
+
+### 1 - 避けるべきソリューション
+
+> Solidエコシステムにおいて、明確に避けるべきソリューションはありません。
+
+### 2 - 許容できるソリューション
+
+**(solid-i18next)** (`solid-i18next@17.0.2`):
+
+`solid-i18next` は、JavaScriptアプリのi18nニーズに応えた最初のソリューションの一つであったため、おそらく最も人気のあるオプションです。また、特定の問題を解決するためのコミュニティプラグインも幅広く揃っています。
+
+パッケージは重いです（~14.6kb。これは `solid-intlayer` の約4.7倍です）。
+
+それでも、`t('a.b.c')` 上に構築されたスタックと同じ主要な欠点を共有しています。最適化は可能ですが非常に時間がかかり、大規模なプロジェクトでは悪い習慣（名前空間 + 動的ロード + 型）に陥るリスクがあります。
+
+**(@solid-primitives/i18n)** (`@solid-primitives/i18n@2.2.1`):
+
+Solid primitive は非常に軽量で効率的です。小規模なプロジェクトにはこのソリューションを推奨しますが、クッキー管理、プロキシリダイレクト、フォーマッタなどを含むプロフェッショナルなソリューションには機能が不足しがちです。
+また、ページサイズの最適化のための遅延ロードや名前空間のスコーピングも欠けています。
+
+**(Paraglide)** (`@inlang/paraglide-js@2.17.0`):
+
+`Paraglide` は革新的でよく考えられたアプローチを提供しています。それでも、このベンチマークでは、彼らが宣伝しているツリーシェイキングは私の実装では機能しませんでした。ワークフローとDXも他のオプションより複雑です。
+個人的には、プッシュする前に毎回JSファイルを再生成しなければならないのが好きではありません。
+最後に、他のソリューションと比較して、Paraglide はコンテンツをレンダリングするための現在のロケールを取得するためにストア（例：Solid signal）を使用しません。パースされる各ノードに対して、localStorage / cookie などからロケールを要求します。これにより、コンポーネントの反応性に影響を与える不要なロジックの実行が発生します。
+
+### 3 - 推奨事項
+
+**(Intlayer)** (`solid-intlayer@8.7.12`):
+
+客観性を保つため、`solid-intlayer` については私自身のソリューションであるため、個人的な評価は控えます。
+
+### 個人メモ
+
+このメモは個人的なものであり、ベンチマーク結果には影響しません。それでも、i18nの世界では翻訳されたコンテンツに対して `const t = useTranslation('xx')` + `<>{t('xx.xx')}</>` のようなパターンが一般的です。
+
+Solidアプリにおいて、関数を `JSX.Element` として注入することは、私の考えではアンチパターンです。また、回避可能な複雑さとJavaScriptの実行オーバーヘッド（たとえほとんど目立たなくても）を追加することになります。