@intlayer/docs 8.9.4 → 8.9.6-canary.0

package/docs/ko/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-04-08
+updatedAt: 2026-05-12
 title: 구성 (Configuration)
 description: 애플리케이션에 Intlayer를 구성하는 방법을 알아보세요. 필요에 따라 Intlayer를 맞춤설정하는 데 사용할 수 있는 다양한 설정과 옵션을 이해하세요.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.9.4
+    date: 2026-05-12
+    changes: "LM Studio 공급자 지원 추가"
   - version: 8.7.0
     date: 2026-04-08
     changes: "빌드 구성에 `prune` 및 `minify` 옵션 추가"
@@ -350,7 +353,7 @@ const config: IntlayerConfig = {
   ai: {
     /**
      * 사용할 AI 프로바이더.
-     * 옵션: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
+     * 옵션: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai', 'lmstudio'
      * 기본값: 'openai'
      */
     provider: "openai",
@@ -916,16 +919,17 @@ Intlayer는 최대의 유연성을 보장하기 위해 다양한 AI 프로바이
 - **Groq**
 - **Amazon Bedrock**
 - **Together.ai**
-
-| 필드                 | 설명                                                                                                             | 타입                                                                                                                                                                                                                                                                                                                                                                                           | 기본값      | 예시                                                          | 참고                                                                                                                                                                                       |
-| -------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `provider`           | Intlayer AI 기능에 사용할 프로바이더.                                                                            | `'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'`                                                 | 여러 프로바이더는 서로 다른 API 키가 필요하며 가격 구조도 다릅니다.                                                                                                                        |
-| `model`              | AI 기능에 사용할 AI 모델.                                                                                        | `string`                                                                                                                                                                                                                                                                                                                                                                                       | 없음        | `'gpt-4o-2024-11-20'`                                         | 특정 모델은 프로바이더에 따라 다릅니다.                                                                                                                                                    |
-| `temperature`        | AI 응답의 무작위성을 제어합니다.                                                                                 | `number`                                                                                                                                                                                                                                                                                                                                                                                       | 없음        | `0.1`                                                         | 온도가 높을수록 창의적이지만 신뢰성이 낮아집니다.                                                                                                                                          |
-| `apiKey`             | 선택한 프로바이더의 API 키.                                                                                      | `string`                                                                                                                                                                                                                                                                                                                                                                                       | 없음        | `process.env.OPENAI_API_KEY`                                  | 비밀로 유지해야 하며 환경 변수를 사용하세요.                                                                                                                                               |
-| `applicationContext` | AI가 더 정확한 번역을 생성할 수 있도록 돕는 애플리케이션에 대한 추가 컨텍스트(도메인, 대상 고객, 어조, 용어 등). | `string`                                                                                                                                                                                                                                                                                                                                                                                       | 없음        | `'my custom app context'`                                     | 규칙을 추가하는 데 사용할 수 있습니다 (예: `"URL은 번역하지 마세요"` ).                                                                                                                    |
-| `baseURL`            | AI API에 대한 기본 URL.                                                                                          | `string`                                                                                                                                                                                                                                                                                                                                                                                       | 없음        | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | 로컬 또는 맞춤형 AI API 엔드포인트를 가리킬 수 있습니다.                                                                                                                                   |
-| `dataSerialization`  | AI 기능에 대한 데이터 직렬화 형식.                                                                               | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                 | `undefined` | `'toon'`                                                      | • `'json'`: 기본값, 안정적임; 더 많은 토큰 소비.<br/>• `'toon'`: 더 적은 토큰 소모, 덜 안정적임.<br/>• 모델에 로직 실행을 위한 추가 파라미터(추론 노력(reasoning effort) 등)를 전달합니다. |
+- **LM Studio**
+
+| 필드                 | 설명                                                                                                             | 타입                                                                                                                                                                                                                                                                                                                                                                                                                     | 기본값      | 예시                                                          | 참고                                                                                                                                                                                       |
+| -------------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `provider`           | Intlayer AI 기능에 사용할 프로바이더.                                                                            | `'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'`                                                 | 여러 프로바이더는 서로 다른 API 키가 필요하며 가격 구조도 다릅니다.                                                                                                                        |
+| `model`              | AI 기능에 사용할 AI 모델.                                                                                        | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | 없음        | `'gpt-4o-2024-11-20'`                                         | 특정 모델은 프로바이더에 따라 다릅니다.                                                                                                                                                    |
+| `temperature`        | AI 응답의 무작위성을 제어합니다.                                                                                 | `number`                                                                                                                                                                                                                                                                                                                                                                                                                 | 없음        | `0.1`                                                         | 온도가 높을수록 창의적이지만 신뢰성이 낮아집니다.                                                                                                                                          |
+| `apiKey`             | 선택한 프로바이더의 API 키.                                                                                      | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | 없음        | `process.env.OPENAI_API_KEY`                                  | 비밀로 유지해야 하며 환경 변수를 사용하세요.                                                                                                                                               |
+| `applicationContext` | AI가 더 정확한 번역을 생성할 수 있도록 돕는 애플리케이션에 대한 추가 컨텍스트(도메인, 대상 고객, 어조, 용어 등). | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | 없음        | `'my custom app context'`                                     | 규칙을 추가하는 데 사용할 수 있습니다 (예: `"URL은 번역하지 마세요"` ).                                                                                                                    |
+| `baseURL`            | AI API에 대한 기본 URL.                                                                                          | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | 없음        | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | 로컬 또는 맞춤형 AI API 엔드포인트를 가리킬 수 있습니다.                                                                                                                                   |
+| `dataSerialization`  | AI 기능에 대한 데이터 직렬화 형식.                                                                               | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                           | `undefined` | `'toon'`                                                      | • `'json'`: 기본값, 안정적임; 더 많은 토큰 소비.<br/>• `'toon'`: 더 적은 토큰 소모, 덜 안정적임.<br/>• 모델에 로직 실행을 위한 추가 파라미터(추론 노력(reasoning effort) 등)를 전달합니다. |
 
 ---
 

package/docs/ko/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2026-01-28
+updatedAt: 2026-05-12
 title: 콘텐츠 파일
 description: 콘텐츠 선언 파일의 확장자를 사용자 정의하는 방법을 배우세요. 이 문서를 따라 프로젝트에서 조건을 효율적으로 구현하세요.
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 8.9.0
+    date: 2026-05-12
+    changes: "`plural` 콘텐츠 노드 유형 추가"
   - version: 8.0.0
     date: 2026-01-28
     changes: "`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": "몇 대의 자동차",
       ">19": "많은 자동차",
     }),
+    pluralContent: plural({
+      one: "One car",
+      other: "{{count}} cars",
+    }),
     conditionalContent: cond({
       true: "검증이 활성화됨",
       false: "검증이 비활성화됨",
@@ -172,6 +181,13 @@ export default {
         ">5": "몇 대의 차",
         ">19": "많은 차",
       },
+      "pluralContent": {
+        "nodeType": "plural",
+        "plural": {
+          "one": "One car",
+          "other": "{{count}} cars",
+        },
+      },
     },
     "conditionalContent": {
       "nodeType": "condition",
@@ -219,6 +235,7 @@ export default {
 - **원시 값**: 문자열, 숫자, 불리언, null, undefined
 - **타입이 지정된 노드**: 번역, 조건, 마크다운 등과 같은 특수 콘텐츠 유형
 - **함수**: 런타임에 평가될 수 있는 동적 콘텐츠 [함수 가져오기 참조](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/function_fetching.md)
+- **복수형 콘텐츠**: 자세한 내용은 복수형 콘텐츠 [자세한 내용은 복수형 콘텐츠](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/plural.md)
 - **중첩 콘텐츠**: 다른 사전에 대한 참조
 
 #### 콘텐츠 유형
@@ -564,6 +581,8 @@ multilingualContent: t({
 });
 ```
 
+> 자세한 내용은 [번역 콘텐츠 (`t`) 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/translation.md) 를 참조하세요.
+
 ### 조건 콘텐츠 (`cond`)
 
 불리언 조건에 따라 변경되는 콘텐츠:
@@ -577,6 +596,8 @@ conditionalContent: cond({
 });
 ```
 
+> 자세한 내용은 [조건 콘텐츠 (`cond`) 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/condition.md) 를 참조하세요.
+
 ### 열거형 콘텐츠 (`enu`)
 
 열거형 값에 따라 달라지는 콘텐츠:
@@ -591,6 +612,23 @@ statusContent: enu({
 });
 ```
 
+> 자세한 내용은 [열거형 콘텐츠 (`enu`) 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/enumeration.md) 를 참조하세요.
+
+### 복수형 콘텐츠 (`plural`)
+
+복수형 규칙에 따라 달라지는 콘텐츠:
+
+```typescript
+import { plural } from "intlayer";
+
+pluralContent: plural({
+  one: "One car",
+  other: "{{count}} cars",
+});
+```
+
+> 자세한 내용은 [복수형 콘텐츠 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/plural.md) 를 참조하세요.
+
 ### 삽입 콘텐츠 (`insert`)
 
 다른 콘텐츠에 삽입할 수 있는 콘텐츠:
@@ -601,6 +639,8 @@ import { insert } from "intlayer";
 insertionContent: insert("이 텍스트는 어디에나 삽입할 수 있습니다");
 ```
 
+> 자세한 내용은 [삽입 콘텐츠 (`insert`) 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/insertion.md) 를 참조하세요.
+
 ### 중첩 콘텐츠 (`nest`)
 
 다른 사전에 대한 참조:
@@ -611,6 +651,8 @@ import { nest } from "intlayer";
 nestedContent: nest("about-page");
 ```
 
+> 자세한 내용은 [중첩 콘텐츠 (`nest`) 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/nesting.md) 를 참조하세요.
+
 ### 마크다운 콘텐츠 (`md`)
 
 마크다운 형식의 리치 텍스트 콘텐츠:
@@ -623,6 +665,8 @@ markdownContent: md(
 );
 ```
 
+> 자세한 내용은 [마크다운 콘텐츠 (`md`) 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/markdown.md) 를 참조하세요.
+
 ### HTML 콘텐츠 (`html`)
 
 표준 태그 또는 사용자 정의 컴포넌트를 사용할 수 있는 리치 HTML 콘텐츠:
@@ -640,6 +684,8 @@ localizedHtmlContent: t({
 });
 ```
 
+> 자세한 내용은 [HTML 콘텐츠 (`html`) 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/html.md) 를 참조하세요.
+
 ### 성별에 따른 콘텐츠 (`gender`)
 
 성별에 따라 달라지는 콘텐츠:
@@ -654,6 +700,8 @@ genderContent: gender({
 });
 ```
 
+> 자세한 내용은 [성별에 따른 콘텐츠 (`gender`) 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/gender.md) 를 참조하세요.
+
 ### 파일 콘텐츠 (`file`)
 
 외부 파일에 대한 참조:
@@ -664,6 +712,8 @@ import { file } from "intlayer";
 fileContent: file("./path/to/content.txt");
 ```
 
+> 자세한 내용은 [파일 콘텐츠 (`file`) 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/file.md) 를 참조하세요.
+
 ## 콘텐츠 파일 생성하기
 
 ### 기본 콘텐츠 파일 구조

package/docs/ko/intlayer_with_nextjs_no_locale_path.md

@@ -625,7 +625,7 @@ Intlayer는 TypeScript의 이점을 얻고 코드베이스를 더욱 견고하
 
 TypeScript 구성에 자동 생성된 타입들이 포함되어 있는지 확인하세요.
 
-````json5 fileName="tsconfig.json"
+```json5 fileName="tsconfig.json"
 {
   // ... 기존 TypeScript 구성
   "include": [
@@ -633,6 +633,7 @@ TypeScript 구성에 자동 생성된 타입들이 포함되어 있는지 확인
     ".intlayer/**/*.ts", // 자동으로 생성된 타입 포함
   ],
 }
+```
 
 ### Git 구성
 
@@ -643,7 +644,7 @@ Intlayer에 의해 생성된 파일을 무시하는 것을 권장합니다. 이
 ```plaintext fileName=".gitignore"
 # Intlayer에 의해 생성된 파일 무시
 .intlayer
-````
+```
 
 ### VS Code 확장
 

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

@@ -160,30 +160,9 @@ syncPO({
   source: ({ key, locale }) => string, // 필수
   location?: string, // 선택적 레이블, 기본값: "sync-po::path/to/source"
   priority?: number, // 충돌 해결을 위한 선택적 우선순위, 기본값: 0
-  format?: 'icu' | 'i18next' | 'vue-i18n', // 선택적, msgstr 값이 특정 보간 구문을 사용하는 경우에만 필요
 });
 ```
 
-#### `format` ('icu' | 'i18next' | 'vue-i18n')
-
-PO 파일은 항상 Gettext Portable Object 파일입니다. 이는 고정되어 있습니다. 이 옵션은 `msgstr` 값 내부에서 사용되는 **보간 구문**만 설명합니다. 이를 통해 Intlayer는 파싱 시점(`formatDictionary`를 통해)에 자체 형식으로 변환하고 출력을 쓸 때 다시 변환할 수 있습니다.
-
-- `undefined` _(기본값)_: `msgstr` 값은 일반 문자열로 처리되며 변환되지 않습니다. 대부분의 PO 파일에 이를 사용하세요.
-- `'icu'`: `msgstr` 값은 ICU 메시지 구문을 사용합니다(예: `{count, plural, one {# item} other {# items}}`).
-- `'i18next'`: `msgstr` 값은 i18next 보간 구문을 사용합니다(예: `{{variable}}`).
-- `'vue-i18n'`: `msgstr` 값은 Vue I18n 구문을 사용합니다.
-
-> 변환은 로드 시 `@intlayer/chokidar`의 `formatDictionary`에 의해 적용되고, 쓰기 시 `formatDictionaryOutput`에 의해 역전됩니다. ICU 복수형과 같은 복잡한 규칙의 경우 라운드 트립 충실도가 보장되지 않습니다.
-
-**예 — PO 파일에 i18next 스타일 보간이 포함된 경우:**
-
-```ts
-syncPO({
-  source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
-  format: "i18next",
-}),
-```
-
 ### 여러 PO 소스 및 우선순위
 
 서로 다른 PO 소스를 동기화하기 위해 여러 개의 `syncPO` 플러그인을 추가할 수 있습니다. 이는 프로젝트에 여러 번역 소스가 있거나 서로 다른 PO 구조가 있는 경우에 유용합니다.

package/docs/nl/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-04-08
+updatedAt: 2026-05-12
 title: Configuratie (Configuration)
 description: Leer hoe u Intlayer configureert voor uw applicatie. Begrijp de verschillende instellingen en opties die beschikbaar zijn om Intlayer aan uw behoeften aan te passen.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.9.4
+    date: 2026-05-12
+    changes: "Ondersteuning voor LM Studio-provider toegevoegd"
   - version: 8.7.0
     date: 2026-04-08
     changes: "Opties `prune` en `minify` toegevoegd aan de buildconfiguratie"
@@ -350,7 +353,7 @@ const config: IntlayerConfig = {
   ai: {
     /**
      * Gebruikte AI-provider.
-     * Opties: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
+     * Opties: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai', 'lmstudio'
      * Standaard: 'openai'
      */
     provider: "openai",
@@ -916,16 +919,17 @@ Intlayer ondersteunt meerdere AI-providers voor maximale flexibiliteit. Momentee
 - **Groq**
 - **Amazon Bedrock**
 - **Together.ai**
-
-| Veld                 | Beschrijving                                                                                                                        | Type                                                                                                                                                                                                                                                                                                                                                                                           | Standaard   | Voorbeeld                                                     | Opmerking                                                                                                                                                                                                   |
-| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `provider`           | Provider gebruikt voor AI-functies van 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'`                                                 | Verschillende providers vereisen verschillende API-sleutels en hebben verschillende prijzen.                                                                                                                |
-| `model`              | Model gebruikt voor AI-functies.                                                                                                    | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Geen        | `'gpt-4o-2024-11-20'`                                         | Het specifieke model hangt af van de provider.                                                                                                                                                              |
-| `temperature`        | Regelt de willekeur van de AI-antwoorden.                                                                                           | `number`                                                                                                                                                                                                                                                                                                                                                                                       | Geen        | `0.1`                                                         | Hogere temperatuur = creatiever en minder voorspelbaar.                                                                                                                                                     |
-| `apiKey`             | Uw API-sleutel voor de gekozen provider.                                                                                            | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Geen        | `process.env.OPENAI_API_KEY`                                  | Moet geheim worden gehouden; gebruik omgevingsvariabelen.                                                                                                                                                   |
-| `applicationContext` | Extra context over uw applicatie om de AI te helpen nauwkeurigere vertalingen te genereren (domein, doelgroep, toon, terminologie). | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Geen        | `'Mijn eigen applicatiecontext'`                              | Kan worden gebruikt om regels toe te voegen (bijv.: `"U moet URL's niet transformeren"`).                                                                                                                   |
-| `baseURL`            | Basis URL voor de AI API.                                                                                                           | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Geen        | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Kan verwijzen naar een lokaal of aangepast endpoint van de AI API.                                                                                                                                          |
-| `dataSerialization`  | Formaat van de dataserialisatie voor AI-functies.                                                                                   | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                 | `undefined` | `'toon'`                                                      | • `'json'`: standaard, betrouwbaar; verbruikt meer tokens.<br/>• `'toon'`: minder tokens, minder stabiel.<br/>• Extra parameters worden als context aan het model doorgegeven (redenaties-inspanning enz.). |
+- **LM Studio**
+
+| Veld                 | Beschrijving                                                                                                                        | Type                                                                                                                                                                                                                                                                                                                                                                                                                     | Standaard   | Voorbeeld                                                     | Opmerking                                                                                                                                                                                                   |
+| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `provider`           | Provider gebruikt voor AI-functies van 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'`                                                 | Verschillende providers vereisen verschillende API-sleutels en hebben verschillende prijzen.                                                                                                                |
+| `model`              | Model gebruikt voor AI-functies.                                                                                                    | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Geen        | `'gpt-4o-2024-11-20'`                                         | Het specifieke model hangt af van de provider.                                                                                                                                                              |
+| `temperature`        | Regelt de willekeur van de AI-antwoorden.                                                                                           | `number`                                                                                                                                                                                                                                                                                                                                                                                                                 | Geen        | `0.1`                                                         | Hogere temperatuur = creatiever en minder voorspelbaar.                                                                                                                                                     |
+| `apiKey`             | Uw API-sleutel voor de gekozen provider.                                                                                            | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Geen        | `process.env.OPENAI_API_KEY`                                  | Moet geheim worden gehouden; gebruik omgevingsvariabelen.                                                                                                                                                   |
+| `applicationContext` | Extra context over uw applicatie om de AI te helpen nauwkeurigere vertalingen te genereren (domein, doelgroep, toon, terminologie). | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Geen        | `'Mijn eigen applicatiecontext'`                              | Kan worden gebruikt om regels toe te voegen (bijv.: `"U moet URL's niet transformeren"`).                                                                                                                   |
+| `baseURL`            | Basis URL voor de AI API.                                                                                                           | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Geen        | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Kan verwijzen naar een lokaal of aangepast endpoint van de AI API.                                                                                                                                          |
+| `dataSerialization`  | Formaat van de dataserialisatie voor AI-functies.                                                                                   | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                           | `undefined` | `'toon'`                                                      | • `'json'`: standaard, betrouwbaar; verbruikt meer tokens.<br/>• `'toon'`: minder tokens, minder stabiel.<br/>• Extra parameters worden als context aan het model doorgegeven (redenaties-inspanning enz.). |
 
 ---
 

package/docs/pl/benchmark/index.md

@@ -30,6 +30,3 @@ Poniżej znajdziesz szczegółowe raporty i dokumentację techniczną dla każde
 - [**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)
-- [**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)

package/docs/pl/benchmark/nextjs.md

@@ -61,6 +61,13 @@ Ponieważ problem jest trudny, istnieje wiele rozwiązań — niektóre koncentr
 
 Intlayer stara się optymalizować we wszystkich tych wymiarach.
 
+## TL;DR
+
+- **Intlayer** i **next-translate**: Najlepsze wybory dla wydajności Next.js, oferujące najmniejszy rozmiar i najlepsze wsparcie dla statycznego renderowania.
+- **next-intl**: Najmodniejsza obecnie opcja, ale ciężka i skomplikowana w optymalizacji dla dużych aplikacji.
+- **next-i18next**: Popularna i bogata w pluginy, ale niesie ze sobą znaczny ciężar pakietu (~3× Intlayer).
+- **Unikaj**: **gt-next** i **lingo.dev** ze względu na poważne problemy z wydajnością, uzależnienie od dostawcy (vendor lock-in) i błędy blokujące budowanie.
+
 ## Przetestuj swoją aplikację
 
 Aby ujawnić te problemy, zbudowałem darmowy skaner, który możesz wypróbować [tutaj](https://intlayer.org/i18n-seo-scanner).
@@ -99,14 +106,14 @@ Wreszcie, `Intlayer` stosuje optymalizację w czasie budowania, dzięki czemu `u
 W tym benchmarku porównaliśmy następujące biblioteki:
 
 - `Base App` (Brak biblioteki 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 @@ Napotkane problemy:
 
 **(General Translation)** (`gt-next@6.16.5`):
 
-- W przypadku aplikacji o rozmiarze 110 KB, `gt-react` dodaje ponad 440 KB ekstra.
+- W przypadku aplikacji o rozmiarze 110 KB, `gt-next` dodaje ponad 440 KB ekstra.
 - Komunikat `Quota Exceeded, please upgrade your plan` przy pierwszej próbie budowania z General Translation.
 - Tłumaczenia nie są renderowane; otrzymuję błąd `Error: <T> used on the client-side outside of <GTProvider>`, co wydaje się być błędem w bibliotece.
-- Podczas wdrażania **gt-tanstack-start-react** napotkałem również [problem](https://github.com/generaltranslation/gt/issues/1210#event-24510646961) z biblioteką: błąd `does not provide an export named 'printAST' - @formatjs/icu-messageformat-parser`, który powodował awarię aplikacji. Po zgłoszeniu tego problemu opiekun naprawił go w ciągu 24 godzin.
+- Podczas wdrażania **gt-next** napotkałem również [problem](https://github.com/generaltranslation/gt/issues/1210#event-24510646961) z biblioteką: błąd `does not provide an export named 'printAST' - @formatjs/icu-messageformat-parser`, który powodował awarię aplikacji. Po zgłoszeniu tego problemu opiekun naprawił go w ciągu 24 godzin.
 - Biblioteka blokuje statyczne renderowanie stron Next.js.
 
 **(Lingo.dev)** (`@lingo.dev/compiler@0.4.0`):
@@ -186,9 +193,11 @@ Idea stojąca za `Wuchale` jest interesująca, ale nie jest to jeszcze opłacaln
 Osobiście nie podoba mi się konieczność regenerowania plików JS przed każdym przesłaniem kodu (push), co stwarza ciągłe ryzyko konfliktów scalania (merge conflicts) przy Pull Requestach. Narzędzie wydaje się również bardziej skoncentrowane na Vite niż na Next.js.
 Wreszcie, w porównaniu z innymi rozwiązaniami, Paraglide nie używa magazynu (np. React context) do pobierania bieżącej lokalizacji w celu renderowania treści. Dla każdego przeanalizowanego węzła żąda lokalizacji z localStorage / cookie itp. Prowadzi to do wykonywania niepotrzebnej logiki, co wpływa na reaktywność komponentu.
 
+> Notatka o paraglide: rozwiązanie to wstrzykuje kod do Twojej bazy kodu w celu importu, w wyniku czego metryka 'rozmiar biblioteki' w raporcie benchmarka wynosi prawie 0. Generowanie kodu to dobra rzecz, ponieważ używana funkcja będzie zawierać tylko niezbędną logikę (wszystkie prefiksy vs brak prefiksów, ciasteczka vs storage itp.). Dla porównania, Intlayer wykonuje to filtrowanie poprzez wstrzykiwanie zmiennych środowiskowych w procesie budowania, aby wymusić na bundlerze usunięcie treści (tree-shake) w zależności od logiki. Dzięki temu paraglide i intlayer okazują się być od 6 do 10 razy lżejszymi rozwiązaniami niż i18next czy next-intl.
+
 ### 3 — Akceptowalne rozwiązania
 
-**(Tolgee)** (`tolgee@7.0.0`):
+**(Tolgee)** (`@tolgee/react@7.0.0`):
 
 `Tolgee` rozwiązuje wiele z wymienionych wcześniej problemów. Uznałem jednak, że trudniej go wdrożyć niż podobne narzędzia. Nie zapewnia on bezpieczeństwa typów (type safety), co utrudnia również wyłapywanie brakujących kluczy w czasie kompilacji. Musiałem opakować funkcje Tolgee we własne funkcje, aby dodać wykrywanie brakujących kluczy.
 
@@ -216,7 +225,7 @@ Różnią się również formaty komunikatów: `next-intl` używa ICU MessageFor
 
 `next-translate` to moja główna rekomendacja, jeśli lubisz API w stylu `t()`. Działa on elegancko poprzez `next-translate-plugin`, ładując przestrzenie nazw przez `getStaticProps` za pomocą loadera Webpack / Turbopack. Jest to również najlżejsza opcja w tym zestawieniu (~2.5 KB). Jeśli chodzi o przestrzenie nazw, definiowanie ich na poziomie strony lub trasy w konfiguracji jest przemyślane i łatwiejsze w utrzymaniu niż w przypadku głównych alternatyw, takich jak **next-intl** czy **next-i18next**. W wersji `3.1.2` zauważyłem, że statyczne renderowanie nie działało; Next.js powracał do renderowania dynamicznego.
 
-**(Intlayer)** (`next-intlayer@8.7.5`):
+**(Intlayer)** (`next-intlayer@8.7.12`):
 
 Nie będę osobiście oceniał `next-intlayer` ze względu na obiektywizm, ponieważ jest to moje własne rozwiązanie.
 

package/docs/pl/benchmark/solid.md

@@ -0,0 +1,155 @@
+---
+createdAt: 2026-04-20
+updatedAt: 2026-04-21
+title: Najlepsze rozwiązanie i18n dla Solid w 2026 r. — raport z benchmarku
+description: Porównaj biblioteki internacjonalizacji (i18n) dla Solid, takie jak solid-primitives, solid-i18next i Intlayer. Szczegółowy raport wydajności dotyczący rozmiaru paczki, wycieków i reaktywności.
+keywords:
+  - benchmark
+  - i18n
+  - intl
+  - solid
+  - wydajność
+  - 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: "Inicjalizacja benchmarku"
+---
+
+# Biblioteki i18n dla Solid — raport z benchmarku 2026
+
+Ta strona zawiera raport z benchmarku rozwiązań i18n dla Solid.
+
+## Spis treści
+
+<Toc/>
+
+## Interaktywny benchmark
+
+<I18nBenchmark framework="vite-solid" vertical/>
+
+## Referencja wyników:
+
+<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
+
+Pełne repozytorium benchmarku znajdziesz [tutaj](https://github.com/intlayer-org/benchmark-i18n/tree/main).
+
+## Wstęp
+
+Rozwiązania do internacjonalizacji należą do najcięższych zależności w aplikacji Solid. Głównym ryzykiem jest wysyłanie niepotrzebnych treści: tłumaczeń dla innych stron i innych lokalizacji w paczce (bundle) pojedynczej trasy.
+
+W miarę rozwoju aplikacji problem ten może szybko zwiększyć ilość JavaScriptu wysyłanego do klienta i spowolnić nawigację.
+
+W praktyce, w przypadku najmniej zoptymalizowanych implementacji, strona zinternacjonalizowana może okazać się kilkukrotnie cięższa niż wersja bez i18n.
+
+Innym skutkiem jest wpływ na doświadczenie programisty (DX): sposób deklarowania treści, typy, organizacja przestrzeni nazw (namespaces), dynamiczne ładowanie i reaktywność przy zmianie lokalizacji.
+
+## TL;DR
+
+- **Intlayer**: Zalecany wybór dla profesjonalnych aplikacji Solid wymagających zaawansowanych funkcji i optymalizacji (v8.7.12).
+- **@solid-primitives/i18n**: Doskonała lekka alternatywa dla prostych projektów, choć brakuje jej zaawansowanych funkcji, takich jak lazy loading.
+- **solid-i18next**: Standardowa, ale ciężka opcja (~4.7x Intlayer) z tymi samymi wadami co React i18next.
+- **Paraglide**: Innowacyjne podejście, ale złożone DX i problemy z tree-shakingiem w niektórych konfiguracjach.
+
+## Przetestuj swoją aplikację
+
+Aby szybko wykryć problemy z wyciekami i18n, przygotowałem darmowy skaner dostępny [tutaj](https://intlayer.org/i18n-seo-scanner).
+
+<iframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+
+## Problem
+
+Dwa dźwignie są kluczowe dla ograniczenia kosztów aplikacji wielojęzycznej:
+
+- Dzielenie treści według stron / przestrzeni nazw, aby nie ładować całych słowników, gdy nie są potrzebne.
+- Dynamiczne ładowanie odpowiedniej lokalizacji tylko wtedy, gdy jest potrzebna.
+
+Zrozumienie technicznych ograniczeń tych podejść:
+
+**Dynamiczne ładowanie**
+
+Bez dynamicznego ładowania większość rozwiązań przechowuje komunikaty w pamięci od pierwszego renderowania, co dodaje znaczny narzut w przypadku aplikacji z wieloma trasami i lokalizacjami.
+
+Dzięki dynamicznemu ładowaniu akceptujesz kompromis: mniej początkowego JS, ale czasami dodatkowe zapytanie przy zmianie języka.
+
+**Dzielenie treści (Splitting)**
+
+Składnie zbudowane wokół `t('a.b.c')` są bardzo wygodne, ale często zachęcają do utrzymywania dużych obiektów JSON w czasie wykonywania. Ten model utrudnia tree-shaking, chyba że biblioteka oferuje rzeczywistą strategię dzielenia na poszczególne strony.
+
+## Metodologia badań
+
+W tym benchmarku porównaliśmy następujące biblioteki:
+
+- `Base App` (Brak biblioteki i18n)
+- `solid-intlayer` (v8.7.12)
+- `@solid-primitives/i18n` (v2.2.1)
+- `solid-i18next` (v17.0.2)
+- `@inlang/paraglide-js` (v2.17.0)
+
+Framework to `Solid` z aplikacją wielojęzyczną składającą się z **10 stron** i **10 języków**.
+
+Porównaliśmy **cztery strategie ładowania**:
+
+| Strategia                | Brak przestrzeni nazw (globalna)                  | Z przestrzeniami nazw (scoped)                                                   |
+| :----------------------- | :------------------------------------------------ | :------------------------------------------------------------------------------- |
+| **Ładowanie statyczne**  | **Static**: Wszystko w pamięci przy starcie.      | **Scoped static**: Podział na przestrzenie nazw; wszystko ładowane przy starcie. |
+| **Ładowanie dynamiczne** | **Dynamic**: Ładowanie na żądanie na lokalizację. | **Scoped dynamic**: Szczegółowe ładowanie na przestrzeń nazw i lokalizację.      |
+
+## Podsumowanie strategii
+
+- **Static**: Proste; brak opóźnień sieciowych po początkowym załadowaniu. Minus: duży rozmiar paczki.
+- **Dynamic**: Zmniejsza początkową wagę (lazy-loading). Idealne, gdy masz wiele lokalizacji.
+- **Scoped static**: Utrzymuje porządek w kodzie (logiczna separacja) bez skomplikowanych dodatkowych zapytań sieciowych.
+- **Scoped dynamic**: Najlepsze podejście dla _code splittingu_ i wydajności. Minimalizuje zużycie pamięci, ładując tylko to, czego potrzebuje bieżący widok i aktywna lokalizacja.
+
+## Wyniki szczegółowe
+
+### 1 — Rozwiązania, których należy unikać
+
+> W ekosystemie Solid nie ma jednoznacznego rozwiązania, którego należy unikać.
+
+### 2 — Rozwiązania akceptowalne
+
+**(solid-i18next)** (`solid-i18next@17.0.2`):
+
+`solid-i18next` jest prawdopodobnie najpopularniejszą opcją, ponieważ był jednym z pierwszych rozwiązań zaspokajających potrzeby i18n aplikacji JavaScript. Posiada również szeroki zestaw wtyczek społecznościowych dla konkretnych problemów.
+
+Paczka jest ciężka (~14.6kb, co stanowi około 4.7x `solid-intlayer`).
+
+Mimo to dzieli te same główne wady co stosy technologiczne zbudowane na `t('a.b.c')`: optymalizacje są możliwe, ale bardzo czasochłonne, a duże projekty niosą ze sobą ryzyko złych praktyk (przestrzenie nazw + dynamiczne ładowanie + typy).
+
+**(@solid-primitives/i18n)** (`@solid-primitives/i18n@2.2.1`):
+
+Solid primitive jest niezwykle lekki i wydajny. Polecam to rozwiązanie dla lekkich projektów, ale może w nim szybko zabraknąć funkcji dla profesjonalnych rozwiązań, w tym zarządzania plikami cookie, przekierowań proxy, formaterów itp.
+Brakuje mu również lazy loadingu i scopingu przestrzeni nazw w celu optymalizacji rozmiaru strony.
+
+**(Paraglide)** (`@inlang/paraglide-js@2.17.0`):
+
+`Paraglide` oferuje innowacyjne, przemyślane podejście. Mimo to w tym benchmarku reklamowany przez nich tree-shaking nie zadziałał w mojej implementacji. Workflow i DX są również bardziej złożone niż w przypadku innych opcji.
+Osobiście nie lubię konieczności regeneracji plików JS przed każdym pushem, co stwarza ciągłe ryzyko konfliktów przy mergowaniu poprzez PR-y.
+Wreszcie, w porównaniu z innymi rozwiązaniami, Paraglide nie używa store'a (np. Solid signal) do pobierania aktualnej lokalizacji w celu renderowania treści. Dla każdego sparsowanego węzła będzie żądać lokalizacji z localStorage / cookie itp. Prowadzi to do wykonywania niepotrzebnej logiki, która wpływa na reaktywność komponentu.
+
+### 3 — Rekomendacje
+
+**(Intlayer)** (`solid-intlayer@8.7.12`):
+
+Nie będę osobiście oceniać `solid-intlayer` ze względu na obiektywizm, ponieważ jest to moje własne rozwiązanie.
+
+### Notatka osobista
+
+Ta notatka jest osobista i nie wpływa na wyniki benchmarku. Mimo to w świecie i18n często widać konsensus wokół wzorca takiego jak `const t = useTranslation('xx')` + `<>{t('xx.xx')}</>` dla treści przetłumaczonych.
+
+W aplikacjach Solid wstrzykiwanie funkcji jako `JSX.Element` jest moim zdaniem antywzorcem. Dodaje to również złożoność, której można uniknąć, oraz narzut na wykonywanie JavaScriptu (nawet jeśli jest on ledwo zauważalny).