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

package/docs/pl/cli/doc-review.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: Przegląd dokumentu
 description: Dowiedz się, jak przeglądać pliki dokumentacji pod kątem jakości, spójności i kompletności w różnych lokalizacjach.
 keywords:
@@ -15,6 +15,10 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "Dodaj opcję --log"
 author: aymericzip
 ---
 
@@ -55,8 +59,110 @@ W większości przypadków,
 
 ## Argumenty:
 
-Polecenie `doc review` akceptuje te same argumenty co `doc translate`, co pozwala na przeglądanie konkretnych plików dokumentacji i stosowanie kontroli jakości.
+**Opcje listy plików:**
 
-Jeśli aktywowałeś jedną z opcji git, polecenie przejrzy tylko te części plików, które uległy zmianie. Skrypt podzieli plik na fragmenty i przejrzy każdy z nich. Jeśli w danym fragmencie nie ma zmian, skrypt go pominie, aby przyspieszyć proces przeglądu i ograniczyć koszty korzystania z API dostawcy AI.
+- **`--doc-pattern [docPattern...]`**: Wzorce glob do dopasowania plików dokumentacji do przeglądu.
 
-- Pełną listę argumentów znajdziesz w dokumentacji polecenia [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/doc-translate.md).
+  > Przykład: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Wzorce glob do wykluczenia z przeglądu.
+
+  > Przykład: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Pomiń plik, jeśli został zmodyfikowany przed podanym czasem.
+  - Może to być czas absolutny, np. "2025-12-05" (string lub Date)
+  - Może to być czas względny w ms `1 * 60 * 60 * 1000` (1 godzina)
+  - Ta opcja sprawdza czas aktualizacji pliku za pomocą metody `fs.stat`. Może więc być wpływana przez Git lub inne narzędzia modyfikujące plik.
+
+  > Przykład: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Pomiń plik, jeśli został zmodyfikowany w podanym czasie.
+  - Może to być czas absolutny, np. "2025-12-05" (string lub Date)
+  - Może to być czas względny w ms `1 * 60 * 60 * 1000` (1 godzina)
+  - Ta opcja sprawdza czas aktualizacji pliku za pomocą metody `fs.stat`. Może więc być wpływana przez Git lub inne narzędzia modyfikujące plik.
+
+  > Przykład: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Pomiń plik, jeśli już istnieje.
+
+  > Przykład: `npx intlayer doc review --skip-if-exists`
+
+**Opcje trybu przeglądu:**
+
+- **`--log`**: Tryb tylko logowania. Nie tłumaczy za pomocą AI; zamiast tego loguje bloki wymagające uwagi (wraz z numerami linii i zawartością) dla bazowych i docelowych lokalizacji, aby pomóc innemu agentowi w wygenerowaniu tłumaczeń.
+
+  > Przykład: `npx intlayer doc review --log`
+
+**Opcje wyjścia wpisu:**
+
+- **`--locales [locales...]`**: Docelowe lokalizacje, dla których ma być przejrzana dokumentacja.
+
+  > Przykład: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Źródłowa lokalizacja (bazowy dokument), z którą należy porównać.
+
+  > Przykład: `npx intlayer doc review --base-locale en`
+
+**Opcje przetwarzania plików:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Liczba plików przetwarzanych jednocześnie podczas przeglądu.
+
+  > Przykład: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**Opcje AI:**
+
+- **`--model [model]`**: Model AI używany do przeglądu (np. `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Dostawca AI używany do przeglądu.
+- **`--temperature [temperature]`**: Ustawienie temperatury dla modelu AI.
+- **`--api-key [apiKey]`**: Podaj własny klucz API dla usługi AI.
+- **`--application-context [applicationContext]`**: Podaj dodatkowy kontekst dla przeglądu AI.
+- **`--data-serialization [dataSerialization]`**: Format serializacji danych dla funkcji AI w Intlayer. Opcje: `json` (standardowy, niezawodny), `toon` (mniej tokenów, mniej spójny).
+- **`--custom-prompt [prompt]`**: Dostosuj podstawowy prompt używany do przeglądu. (Uwaga: W większości przypadków zaleca się użycie opcji `--custom-instructions`, ponieważ zapewnia lepszą kontrolę.)
+
+  > Przykład: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Moja aplikacja to sklep z kotami"`
+
+**Opcje zmiennych środowiskowych:**
+
+- **`--env`**: Określ środowisko (np. `development`, `production`).
+- **`--env-file [envFile]`**: Podaj niestandardowy plik środowiskowy do załadowania zmiennych.
+- **`--base-dir`**: Określ katalog bazowy projektu.
+- **`--no-cache`**: Wyłącz pamięć podręczną.
+
+  > Przykład: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**Opcje logowania:**
+
+- **`--verbose`**: Włącz szczegółowe logowanie do debugowania. (domyślnie true przy użyciu CLI)
+
+  > Przykład: `npx intlayer doc review --verbose`
+
+**Opcje niestandardowych instrukcji:**
+
+- **`--custom-instructions [customInstructions]`**: Niestandardowe instrukcje dodane do promptu. Przydatne do stosowania specyficznych reguł dotyczących formatowania, tłumaczenia URL itp.
+
+  > Przykład: `npx intlayer doc review --custom-instructions "Unikaj tłumaczenia URL-i i zachowaj format markdown"`
+
+  > Przykład: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Opcje Git:**
+
+- **`--git-diff`**: Uruchom tylko na plikach, które zawierają zmiany od bazy (domyślnie `origin/main`) do bieżącej gałęzi (domyślnie `HEAD`).
+- **`--git-diff-base`**: Określ bazowe odniesienie dla git diff (domyślnie `origin/main`).
+- **`--git-diff-current`**: Określ bieżące odniesienie dla git diff (domyślnie `HEAD`).
+- **`--uncommitted`**: Uwzględnij niezacommitowane zmiany.
+- **`--unpushed`**: Uwzględnij niepushowane zmiany.
+- **`--untracked`**: Uwzględnij nieśledzone pliki.
+
+  > Przykład: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Przykład: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> Zauważ, że ścieżka pliku wyjściowego zostanie określona przez zastąpienie następujących wzorców:
+>
+> - `/{{baseLocale}}/` na `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` na `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` na `_{{locale}}.`
+> - `{{baseLocale}}_` na `{{locale}}_`
+> - `.{{baseLocaleName}}.` na `.{{localeName}}.`
+>
+> Jeśli wzorzec nie zostanie znaleziony, plik wyjściowy doda `.{{locale}}` do rozszerzenia pliku. `./my/file.md` zostanie przejrzany i zaktualizowany do `./my/file.fr.md` dla lokalizacji francuskiej.

package/docs/pl/cli/index.md

@@ -17,7 +17,7 @@ slugs:
   - concept
   - cli
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Dodano polecenie scan"
   - version: 8.6.4

package/docs/pl/cli/scan.md

@@ -18,7 +18,7 @@ slugs:
   - cli
   - scan
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Dodano polecenie scan"
 author: aymericzip

package/docs/pl/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-05-12
+updatedAt: 2026-06-17
 title: Konfiguracja
 description: Dowiedz się, jak skonfigurować Intlayer dla swojej aplikacji. Zrozum różne ustawienia i opcje dostępne do dostosowania Intlayer do Twoich potrzeb.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.10.0
+    date: 2026-06-17
+    changes: "Dodano opcję `format` do konfiguracji słownika"
   - version: 8.9.4
     date: 2026-05-12
     changes: "Dodano obsługę dostawcy LM Studio"
@@ -135,6 +138,7 @@ Intlayer akceptuje formaty plików konfiguracyjnych JSON, JS, MJS i TS:
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
+import { syncJSON } from "@intlayer/sync-json-plugin";
 import { z } from "zod";
 
 /**
@@ -582,10 +586,38 @@ const config: IntlayerConfig = {
     }),
   },
 
+  /**
+   * Konfiguracja słownika.
+   */
+  dictionary: {
+    /**
+     * Kontroluje sposób importowania słowników.
+     * - "static": Importowane statycznie podczas budowania.
+     * - "dynamic": Importowane dynamicznie przy użyciu Suspense.
+     * - "fetch": Pobierane dynamicznie przez API synchronizacji na żywo.
+     */
+    importMode: "static",
+
+    /**
+     * Domyślny format komunikatów dla wszystkich słowników w projekcie.
+     * - 'intlayer': Natywny format intlayer (domyślny).
+     * - 'icu': Format komunikatów ICU.
+     * - 'i18next': Format i18next.
+     * - 'vue-i18n': Format Vue I18n.
+     * - 'po': Format GNU Gettext PO.
+     */
+    format: "icu",
+  },
+
   /**
    * Konfiguracja wtyczek.
    */
-  plugins: [],
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./messages/${locale}.json`,
+    }),
+  ],
 };
 
 export default config;
@@ -862,6 +894,7 @@ Opcje kontrolujące operacje na słownikach, w tym zachowanie automatycznego uzu
 | `contentAutoTransformation` | Czy automatycznie przekształcać ciągi znaków treści w typowane węzły (Markdown, HTML lub wstawki).                                                                                  | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`      | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')` .<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')` .<br/>• Wstawki : `Hello {{name}}` → `insert('Hello {{name}}')` .                                                                                                                                                                                                                                               |
 | `location`                  | Wskazuje na lokalizację przechowywania plików słowników oraz sposób ich synchronizacji z CMS.                                                                                       | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`    | `'hybrid'`                                                                                  | • `'local'`: Tylko lokalne zarządzanie.<br/>• `'remote'`: Tylko zdalne zarządzanie (CMS).<br/>• `'hybrid'`: Zarządzanie zarówno lokalne, jak i zdalne.<br/>• `'plugin'` lub własne ciągi: Zarządzanie przez wtyczkę lub własne źródło.                                                                                                                                                                                      |
 | `importMode`                | Kontroluje sposób importowania słowników.                                                                                                                                           | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`   | `'dynamic'`                                                                                 | • `'static'`: Statyczny import.<br/>• `'dynamic'`: Dynamiczny import przez Suspense.<br/>• `'fetch'`: Pobieranie przez API Live Sync; rezerwowa opcja `'dynamic'` w razie błędu.<br/>• Wymagane wtyczki `@intlayer/babel` i `@intlayer/swc`.<br/>• Klucze muszą być zadeklarowane statycznie.<br/>• Ignorowane, jeśli `optimize` jest wyłączone.<br/>• Nie wpływa na `getIntlayer`, `getDictionary` itp.                    |
+| `format`                    | Domyślny format komunikatów dla wszystkich słowników w projekcie.                                                                                                                   | `'intlayer'` &#124; <br/> `'icu'` &#124; <br/> `'i18next'` &#124; <br/> `'vue-i18n'` &#124; <br/> `'po'`        | `'intlayer'` | `'icu'`                                                                                     | • `'intlayer'`: Natywny format intlayer.<br/>• `'icu'`: Format komunikatów ICU.<br/>• `'i18next'`: Format i18next.<br/>• `'vue-i18n'`: Format Vue I18n.<br/>• `'po'`: Format GNU Gettext PO.                                                                                                                                                                                                                                |
 | `priority`                  | Priorytet słownika. Przy rozwiązywaniu konfliktów między słownikami wyższa wartość ma pierwszeństwo przed niższą.                                                                   | `number`                                                                                                        | `undefined`  | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                             |
 | `live`                      | ZDEPRECJONOWANE - używaj `importMode: 'fetch'`. Wcześniej wskazywało, czy należy pobierać treść słownika dynamicznie przez API Live Sync.                                           | `boolean`                                                                                                       | `undefined`  |                                                                                             | Przemianowano na `importMode: 'fetch'` w v8.0.0.                                                                                                                                                                                                                                                                                                                                                                            |
 | `schema`                    | Generowane automatycznie przez Intlayer do walidacji schematu JSON.                                                                                                                 | `'https://intlayer.org/schema.json'`                                                                            | Automatyczne |                                                                                             | Nie edytuj ręcznie.                                                                                                                                                                                                                                                                                                                                                                                                         |

package/docs/pl/dictionary/condition.md

@@ -71,7 +71,10 @@ export default myConditionalContent;
 
 ## Używanie zawartości warunkowej z React Intlayer
 
-Aby wykorzystać zawartość warunkową w komponencie React, zaimportuj i użyj hooka `useIntlayer` z pakietu `react-intlayer`. Hook ten pobiera zawartość dla określonego klucza i pozwala przekazać warunek, aby wybrać odpowiedni wynik.
+<Tabs group="framework">
+  <Tab label="React" value="react">
+
+To utilize conditional content within a React component, import and use the `useIntlayer` hook from the `react-intlayer` package. This hook fetches the content for the specified key and allows you to pass in a condition to select the appropriate output.
 
 ```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
@@ -84,25 +87,25 @@ const ConditionalComponent: FC = () => {
     <div>
       <p>
         {
-          /* Wyjście: moja zawartość, gdy jest prawda */
+          /* Output: my content when it's true */
           myCondition(true)
         }
       </p>
       <p>
         {
-          /* Wyjście: moja zawartość, gdy jest fałsz */
+          /* Output: my content when it's false */
           myCondition(false)
         }
       </p>
       <p>
         {
-          /* Wyjście: moja zawartość, gdy warunek nie jest spełniony */
+          /* Output: my content when the condition fails */
           myCondition("")
         }
       </p>
       <p>
         {
-          /* Wyjście: moja zawartość, gdy warunek nie jest spełniony */
+          /* Output: my content when the condition fails */
           myCondition(undefined)
         }
       </p>
@@ -113,6 +116,165 @@ const ConditionalComponent: FC = () => {
 export default ConditionalComponent;
 ```
 
+  </Tab>
+  <Tab label="Next.js" value="nextjs">
+
+To utilize conditional content in Next.js Client Components, retrieve it via the `useIntlayer` hook. Here's an example:
+
+```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
+"use client";
+
+import type { FC } from "react";
+import { useIntlayer } from "next-intlayer";
+
+const ConditionalComponent: FC = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>{myCondition(true)}</p>
+      <p>{myCondition(false)}</p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+  </Tab>
+  <Tab label="Vue" value="vue">
+
+To utilize conditional content in Vue components, retrieve it via the `useIntlayer` hook. Here's an example:
+
+```vue fileName="**/*.vue"
+<script setup lang="ts">
+import { useIntlayer } from "vue-intlayer";
+
+const { myCondition } = useIntlayer("my_key");
+</script>
+
+<template>
+  <div>
+    <p>{{ myCondition(true) }}</p>
+    <p>{{ myCondition(false) }}</p>
+  </div>
+</template>
+```
+
+  </Tab>
+  <Tab label="Svelte" value="svelte">
+
+To utilize conditional content in Svelte components, retrieve it via the `useIntlayer` hook. The store is accessed with `$`. Here's an example:
+
+```svelte fileName="**/*.svelte"
+<script lang="ts">
+import { useIntlayer } from "svelte-intlayer";
+
+const content = useIntlayer("my_key");
+</script>
+
+<div>
+  <p>{$content.myCondition(true)}</p>
+  <p>{$content.myCondition(false)}</p>
+</div>
+```
+
+  </Tab>
+  <Tab label="Preact" value="preact">
+
+To utilize conditional content in Preact components, retrieve it via the `useIntlayer` hook. Here's an example:
+
+```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "preact";
+import { useIntlayer } from "preact-intlayer";
+
+const ConditionalComponent: FC = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>{myCondition(true)}</p>
+      <p>{myCondition(false)}</p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+  </Tab>
+  <Tab label="Solid" value="solid">
+
+To utilize conditional content in SolidJS components, retrieve it via the `useIntlayer` hook. Here's an example:
+
+```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
+import type { Component } from "solid-js";
+import { useIntlayer } from "solid-intlayer";
+
+const ConditionalComponent: Component = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>{myCondition(true)}</p>
+      <p>{myCondition(false)}</p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+  </Tab>
+  <Tab label="Angular" value="angular">
+
+To utilize conditional content in Angular components, retrieve it via the `useIntlayer` hook. Here's an example:
+
+```typescript fileName="app.component.ts" codeFormat="typescript"
+import { Component } from "@angular/core";
+import { useIntlayer } from "angular-intlayer";
+
+@Component({
+  selector: "app-conditional",
+  template: `
+    <div>
+      <p>{{ content().myCondition(true) }}</p>
+      <p>{{ content().myCondition(false) }}</p>
+    </div>
+  `,
+})
+export class ConditionalComponent {
+  content = useIntlayer("my_key");
+}
+```
+
+  </Tab>
+  <Tab label="Vanilla JS" value="vanilla">
+
+To utilize conditional content with `vanilla-intlayer`, retrieve it via the `useIntlayer` hook. Here's an example:
+
+```typescript fileName="**/*.ts" codeFormat={["typescript", "esm"]}
+import { installIntlayer, useIntlayer } from "vanilla-intlayer";
+
+installIntlayer();
+
+const content = useIntlayer("my_key").onChange((newContent) => {
+  document.getElementById("true-content")!.textContent =
+    newContent.myCondition(true);
+  document.getElementById("false-content")!.textContent =
+    newContent.myCondition(false);
+});
+
+// Initial render
+document.getElementById("true-content")!.textContent =
+  content.myCondition(true);
+document.getElementById("false-content")!.textContent =
+  content.myCondition(false);
+```
+
+  </Tab>
+</Tabs>
+
 ## Dodatkowe zasoby
 
 Aby uzyskać bardziej szczegółowe informacje na temat konfiguracji i użytkowania, zapoznaj się z następującymi zasobami: