@intlayer/docs 9.3.3 → 9.4.0

package/docs/pl/packages/intlayer/getIntlayer.md

@@ -0,0 +1,197 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Dokumentacja funkcji getIntlayer | intlayer
+description: Zobacz jak używać funkcji getIntlayer dla pakietu intlayer
+keywords:
+  - getIntlayer
+  - dictionary
+  - content
+  - selector
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Dokumentacja początkowa"
+author: aymericzip
+---
+
+# Dokumentacja: Funkcja `getIntlayer` w `intlayer`
+
+## Opis
+
+Funkcja `getIntlayer` wybiera jeden słownik po jego kluczu i zwraca jego zawartość zinterpretowaną dla danego ustawienia regionalne. Jest to odpowiednik niezależny od frameworka hooka `useIntlayer`: ta sama zawartość, te same selektory, ale możliwy do użycia wszędzie tam, gdzie kontekst React nie jest dostępny — skrypty Node, funkcje serwera, loadery tras, budowniczy metadanych, handlery Express/Fastify, testy.
+
+Odczytuje słowniki wygenerowane przez Intlayer w `.intlayer/`, więc argument `key` jest typowany i autocomplete'owany z Twoich własnych deklaracji zawartości, a zwrócony obiekt jest w pełni typowany do każdego liścia.
+
+**Kluczowe funkcje:**
+
+- Typowane klucze słownika i typowana zwrócona zawartość
+- Interpretuje każdy węzeł zawartości (`t()`, `enu()`, `cond()`, `insert()`, `nest()`, `md()`, `html()`, `file()`, `gender()`)
+- Akceptuje ustawienie regionalne lub obiekt selektora (kolekcje, warianty)
+- Wyniki są zapamiętywane dla `key + locale + selector`
+- Spada do bezpiecznego proxy w trybie development, gdy słownik brakuje, zamiast się wysypać
+
+---
+
+## Sygnatura funkcji
+
+```typescript
+getIntlayer(
+  key: DictionaryKeys,                        // Wymagane
+  localeOrSelector?: LocalesValues | DictionarySelector, // Opcjonalne
+  plugins?: Plugins[]                         // Opcjonalne
+): DeepTransformContent<...>
+```
+
+---
+
+## Parametry
+
+- `key: DictionaryKeys`
+  - **Description**: Klucz słownika do odczytania, zadeklarowany w plikach zawartości.
+  - **Type**: `DictionaryKeys` — suma wszystkich zadeklarowanych kluczy słownika.
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: Locale do interpretacji zawartości lub obiekt selektora dla [dynamicznych słowników](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/index.md).
+    - `'fr'` — locale
+    - `{ item: 2 }` — element [kolekcji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/collections.md) (pomiń `item`, aby uzyskać każdy element jako tablicę)
+    - `{ variant: 'black-friday' }` — nazwana [wariacja](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/variants.md) (pomiń dla domyślnej)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — wariacja strukturalna
+    - Każdy selektor może zawierać locale: `{ item: 2, locale: 'fr' }`
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — domyślnie do skonfigurowanego `defaultLocale`.
+
+- `plugins: Plugins[]`
+  - **Description**: Niestandardowe transformery węzłów zastępujące bazowe pluginy interpretera. Zaawansowane użycie; pomiń, aby zachować domyślne zachowanie.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Zwracane wartości
+
+- **Type**: Zinterpretowana zawartość słownika, wpisana na podstawie Twojej deklaracji.
+- **Description**: Zwykły obiekt odzwierciedlający pole `content` słownika, gdzie każdy węzeł Intlayer został rozwiązany do jego ostatecznej wartości dla żądanego ustawienia regionalne.
+
+---
+
+## Przykład użycia
+
+### Podstawowe użycie
+
+```typescript fileName="src/app.content.ts" codeFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: t({
+      pl: "Cześć",
+      en: "Hello",
+      fr: "Bonjour",
+    }),
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app", "pl"); // "Cześć"
+```
+
+### Bez locale
+
+Pominięcie locale interpretuje zawartość przy użyciu `defaultLocale` zadeklarowanego w Twojej [konfiguracji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md).
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app"); // Interpretowane przy użyciu domyślnego locale
+```
+
+### Wewnątrz handlera serwera
+
+```typescript fileName="src/routes/greeting.ts" codeFormat="typescript"
+import { getIntlayer, getLocale } from "intlayer";
+
+export const greetingHandler = async (request: Request) => {
+  const locale = await getLocale({
+    getHeader: (name) => request.headers.get(name) ?? undefined,
+  });
+
+  const { title } = getIntlayer("app", locale);
+
+  return Response.json({ title });
+};
+```
+
+### Z selektorem (kolekcje i warianty)
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+// Pojedynczy element kolekcji
+const secondPost = getIntlayer("blog-post", { item: 2, locale: "fr" });
+
+// Każdy element kolekcji jako uporządkowana tablica
+const allPosts = getIntlayer("blog-post", { locale: "fr" });
+
+// Nazwany wariant
+const banner = getIntlayer("banner", { variant: "black-friday", locale: "fr" });
+```
+
+---
+
+## Notatki dotyczące zachowania
+
+### Buforowanie
+
+Wyniki są zapamiętane w pamięci podręcznej na poziomie modułu, której kluczem jest `key + locale + selector`. Wielokrotne wywołanie `getIntlayer("app", "fr")` interpretuje słownik raz i zwraca ten sam obiekt.
+
+### Brakujące słowniki
+
+W trakcie rozwoju, żądanie klucza, który nie ma wygenerowanego słownika, loguje ostrzeżenie raz i zwraca bezpieczny proxy fallback: odczytanie `content.title` zwraca ciąg `"app.title"` zamiast rzucać błąd. To utrzymuje stronę użyteczną, podczas gdy brakująca deklaracja jest naprawiana. Uruchom kompilację Intlayer (lub serwer dev), aby słownik został wygenerowany.
+
+### Rozmiar pakietu
+
+`getIntlayer` reads the merged dictionary, which holds **every** locale. In client bundles, the [build plugins](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/bundle_optimization.md) rewrite the call so only the required content is shipped. When you read content outside of rendering (metadata, loaders, server functions) and want a single locale loaded on demand, use [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getIntlayerAsync.md) instead.
+
+---
+
+## Powiązane funkcje
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getIntlayerAsync.md): Asynchroniczny odpowiednik ładujący pojedynczy chunk lokalizacji.
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getDictionary.md): Interpretuje obiekt słownika, który sam przekazujesz, zamiast szukać go po kluczu.
+- [`useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/react-intlayer/useIntlayer.md): Równoważny hook React'a, odczytujący lokalizację od dostawcy.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayer<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  DictionaryRegistryResult<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```

package/docs/pl/packages/intlayer/getIntlayerAsync.md

@@ -0,0 +1,141 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: Dokumentacja funkcji getIntlayerAsync | intlayer
+description: Dowiedz się, jak używać funkcji getIntlayerAsync z pakietu intlayer
+keywords:
+  - getIntlayerAsync
+  - dictionary
+  - dynamic import
+  - metadata
+  - bundle optimization
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayerAsync
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Dokumentacja: Funkcja `getIntlayerAsync` w `intlayer`
+
+## Opis
+
+Funkcja `getIntlayerAsync` wybiera jeden słownik po jego kluczu i rozwiązuje jego zawartość dla danego locale'a, **ładując tylko ten locale**.
+
+Jest to asynchroniczny odpowiednik [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getIntlayer.md), przeznaczony dla miejsc, gdzie słownik jest odczytywany poza renderowaniem — konstruktory `head` / metadanych tras, loadery, funkcje serwerowe.
+
+Podczas gdy `getIntlayer` ładuje scalony słownik zawierający każdy locale, [wtyczki budowania](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/bundle_optimization.md) (`@intlayer/babel`, `@intlayer/swc`) przepisują to wywołanie na `getDictionaryAsync(loaderMap, key, locale)`, wskazując na fragmenty poszczególnych locale'ów w `.intlayer/dynamic_dictionaries/`. Bundle w związku z tym zawiera tylko rzeczywiście żądany locale.
+
+Bez tych wtyczek — niezoptymalizowana kompilacja — wywołanie rozwiązuje się zamiast tego poprzez synchroniczny rejestr słownika: ta sama zawartość, bez podziału na locale'a.
+
+**Kluczowe funkcje:**
+
+- Takie same wpisane klucze, selektory i zwracana zawartość co `getIntlayer`
+- Ładuje tylko żądany fragment locale'a w zoptymalizowanych kompilacjach
+- Współbieżne wywołania dla tego samego fragmentu współdzielą jedno ładowanie
+- Bezpieczne do użycia w asynchronicznych konstruktorach metadanych, loaderach i funkcjach serwerowych
+
+---
+
+## Sygnatura Funkcji
+
+```typescript
+getIntlayerAsync(
+  key: DictionaryKeys,                        // Wymagane
+  localeOrSelector?: LocalesValues | DictionarySelector, // Opcjonalne
+  plugins?: Plugins[]                         // Opcjonalne
+): Promise<DeepTransformContent<...>>
+```
+
+---
+
+## Parametry
+
+- `key: DictionaryKeys`
+  - **Description**: Klucz słownika do odczytania, zadeklarowany w plikach zawartości.
+  - **Type**: `DictionaryKeys` — unija wszystkich zadeklarowanych kluczy słownika.
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: Locale do interpretacji zawartości lub obiekt selektora dla [słowników dynamicznych](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/index.md).
+    - `'fr'` — locale
+    - `{ item: 2 }` — element [kolekcji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/collections.md) (pomiń `item`, aby otrzymać wszystkie elementy jako tablicę)
+    - `{ variant: 'black-friday' }` — nazwana [wariant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/variants.md) (pomiń dla wariantu `default`)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — wariant strukturyzowany
+    - Każdy selektor może zawierać locale: `{ item: 2, locale: 'fr' }`
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — domyślnie skonfigurowany `defaultLocale`.
+
+- `plugins: Plugins[]`
+  - **Description**: Niestandardowe transformatory węzłów zastępujące podstawowe pluginy interpretera. Zaawansowane użycie tylko.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Zwracane
+
+- **Typ**: `Promise<Content>` — promise rozwiązujący się do interpretowanej zawartości słownika, typizowanej z Twojej deklaracji.
+
+---
+
+## Przykład użycia
+
+### Podstawowe użycie
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayerAsync } from "intlayer";
+
+const { title } = await getIntlayerAsync("app", "fr"); // "Bonjour"
+```
+
+---
+
+## `getIntlayer` vs `getIntlayerAsync`
+
+|                         | [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getIntlayer.md) | `getIntlayerAsync`                                |
+| ----------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
+| Zwraca                  | Zawartość                                                                                                       | Obietnicę zawartości                              |
+| Słownik załadowany      | Połączony słownik (wszystkie języki)                                                                            | Chunk tylko żądanego języka                       |
+| Najlepiej nadaje się do | Renderowanie, synchroniczne ścieżki kodu                                                                        | Metadane, loadery, funkcje serwerowe              |
+| Wymaga pluginu?         | Nie                                                                                                             | Nie — podział na języki wymaga pluginów budowania |
+
+Obie funkcje akceptują te same argumenty i zwracają tę samą zawartość: przełączenie się między nimi zmienia tylko **kiedy** i **ile** jest ładowane.
+
+---
+
+## Powiązane funkcje
+
+- [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getIntlayer.md): Synchroniczny odpowiednik odczytujący scalony słownik.
+- [`getDictionaryAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getDictionaryAsync.md): Funkcja niskiego poziomu, którą wtyczki kompilacji przepisują do tego wywołania.
+- [`getLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getLocale.md): Wykrywa locale przychodzącego żądania.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayerAsync<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): Promise<
+  DeepTransformContent<
+    DictionaryRegistryResult<T, A>,
+    IInterpreterPluginState,
+    ExtractSelectorLocale<A>
+  >
+>;
+```

package/docs/pl/packages/intlayer/getLocalizedPath.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 Funkcja `getLocalizedPath` przekształca kanoniczną ścieżkę (wewnętrzną ścieżkę aplikacji) w jej zlokalizowany odpowiednik na podstawie podanego locale i reguł przepisywania (rewrite rules). Jest szczególnie przydatna do generowania przyjaznych dla SEO adresów URL, które różnią się w zależności od języka.
 
+To względny odpowiednik [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getLocalizedUrl.md) — dla względnych danych wejściowych oba zwracają tę samą wartość. W przeciwieństwie do `getLocalizedUrl`, nigdy nie zwraca absolutnego URL: konfiguracja `domains` jest ignorowana, więc locale obsługiwane z własnej domeny nadal zwraca ścieżkę. Absolutne dane wejściowe są akceptowane, ale ich pochodzenie jest odrzucane — przechowywane są tylko ścieżka, ciąg zapytania i hash.
+
 **Główne cechy:**
 
 - Obsługuje dynamiczne parametry tras przy użyciu składni `[param]`.
@@ -60,18 +62,23 @@ getLocalizedPath(
   - **Typ**: `string`
   - **Wymagane**: Tak
 
-- `locale: Locales`
-  - **Opis**: Docelowy locale, dla którego ścieżka ma być zlokalizowana.
-  - **Typ**: `Locales`
-  - **Wymagane**: Tak
-
 ### Opcjonalne parametry
 
+- `locale?: Locales`
+  - **Description**: Docelowy język, dla którego ścieżka powinna być zlokalizowana.
+  - **Type**: `Locales`
+  - **Default**: Domyślny język konfiguracji Twojego projektu.
+
 - `rewriteRules?: RoutingConfig['rewrite']`
   - **Opis**: Obiekt definiujący niestandardowe reguły przepisywania. Jeśli nie zostanie podany, domyślnie używana jest właściwość `routing.rewrite` z konfiguracji projektu.
   - **Typ**: `RoutingConfig['rewrite']`
   - **Domyślnie**: `configuration.routing.rewrite`
 
+  - `options.locales?: Locales[]` — obsługiwane locales. **Domyślnie**: `configuration.internationalization.locales`
+  - `options.defaultLocale?: Locales` — locale domyślny. **Domyślnie**: `configuration.internationalization.defaultLocale`
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'` — jak locale pojawia się w ścieżce. **Domyślnie**: `configuration.routing.mode`
+  - `options.rewrite?: RoutingConfig['rewrite']` — niestandardowe reguły rewrite. **Domyślnie**: `configuration.routing.rewrite`
+
 ---
 
 ## Zwraca
@@ -79,6 +86,28 @@ getLocalizedPath(
 - **Typ**: `string`
 - **Opis**: Zlokalizowana ścieżka dla podanego locale.
 
+Typ jest zawężany na podstawie reguł przepisywania zadeklarowanych w konfiguracji, więc edytor pokazuje rozpoznaną ścieżkę zamiast zwykłego `string`:
+
+```typescript codeFormat="typescript"
+// Konfiguracja: mode 'prefix-no-default', defaultLocale 'en',
+//                { '/about': { fr: '/a-propos' }, '/product/[id]': { fr: '/produit/[id]' } }
+const about = getLocalizedPath("/about", Locales.FRENCH);
+//    ^? '/fr/a-propos'
+const product = getLocalizedPath("/product/123", Locales.FRENCH);
+//    ^? '/fr/produit/123'
+const contact = getLocalizedPath("/contact", Locales.FRENCH);
+//    ^? '/fr/contact'  (brak pasującego wariantu przepisywania, stosowana jest tylko prefiksacja)
+const home = getLocalizedPath("/", Locales.FRENCH);
+//    ^? '/fr'
+```
+
+To samo zawężenie trafia do [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getLocalizedUrl.md), która stosuje reguły przepisywania przed dodaniem prefiksu locale'a.
+
+Dwa przypadki pozostają poszerzone do `string`, ponieważ nie mogą być rozwiązane w czasie kompilacji:
+
+- ścieżka, która nie jest literałem łańcucha (np. zbudowana ze zmiennej);
+- ścieżka dopasowana przez regułę używającą parametru wielosegmentowego lub opcjonalnego (`[...slug]`, `[[...slug]]`, `:param?`).
+
 ---
 
 ## Przykład użycia
@@ -126,6 +155,18 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 // Output: "/contactez-nous"
 ```
 
+### Pomijanie ustawień regionalnych
+
+Gdy nie podano ustawień regionalnych, ścieżka jest lokalizowana dla skonfigurowanego domyślnego ustawienia regionalnego:
+
+```typescript codeFormat="typescript"
+import { getLocalizedPath } from "intlayer";
+
+// Konfiguracja: defaultLocale = Locales.ENGLISH, { '/about': { en: '/about', fr: '/a-propos' } }
+getLocalizedPath("/about");
+// Wynik: "/about"
+```
+
 ---
 
 ## Powiązane funkcje

package/docs/pl/packages/intlayer/getLocalizedUrl.md

@@ -70,6 +70,11 @@ getLocalizedUrl(
 
 ### Parametry opcjonalne
 
+- `options?: object`
+  - **Description**: Obiekt konfiguracyjny dla zachowania lokalizacji URL.
+  - **Type**: `object`
+  - **Required**: No (Optional)
+
 - `locales?: Locales[]`
   - **Opis**: Tablica obsługiwanych języków. Jeśli nie zostanie podana, używane są języki skonfigurowane w Twoim projekcie.
   - **Typ**: `Locales[]`
@@ -118,8 +123,6 @@ Możesz zastąpić konfigurację domyślną, podając opcjonalny parametr `optio
 
 ### Podstawowe użycie (Tylko wymagane parametry)
 
-Gdy skonfigurujesz swój projekt z ustawieniami internacjonalizacji, możesz użyć funkcji tylko z wymaganymi parametrami:
-
 ```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { getLocalizedUrl, Locales } from "intlayer";
 
@@ -131,29 +134,6 @@ getLocalizedUrl("/about", Locales.ENGLISH);
 // Wynik: "/about" lub "/en/about" (w zależności od ustawienia prefixDefault)
 ```
 
-```javascript codeFormat="esm"
-import { getLocalizedUrl, Locales } from "intlayer";
-
-// Jawne podanie wszystkich opcjonalnych parametrów
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-javascript codeFormat="commonjs"
-const { getLocalizedUrl, Locales } = require("intlayer");
-
-// Jawne podanie wszystkich opcjonalnych parametrów
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH], // locales
-  Locales.ENGLISH, // defaultLocale
-  false // prefixDefault
-);
-
-// Wynik: "/fr/about" dla lokalizacji francuskiej
-// Wynik: "/about" dla domyślnej lokalizacji (angielskiej)
-```
-
 ### Częściowe nadpisanie konfiguracji
 
 Możesz również podać tylko niektóre z opcjonalnych parametrów. Funkcja użyje konfiguracji Twojego projektu dla wszystkich parametrów, których nie określisz:
@@ -230,6 +210,12 @@ getLocalizedUrl(
 - **Nieobsługiwane lokalizacje:**
   - Dla lokalizacji nie wymienionych w `locales`, funkcja nie stosuje żadnego prefiksu.
 
+- **Tryby routingu:**
+  - `'prefix-no-default'`: Domyślna locale bez prefiksu, pozostałe z prefiksem (np. `/about`, `/fr/about`)
+  - `'prefix-all'`: Wszystkie locale z prefiksami (np. `/en/about`, `/fr/about`)
+  - `'no-prefix'`: Brak prefiksów locale w URL-ach (locale obsługiwana w innym miejscu)
+  - `'search-params'`: Locale określona przez parametr zapytania (np. `/about?locale=fr`)
+
 ---
 
 ## Użycie w aplikacjach

package/docs/pl/packages/intlayer/getMultilingualUrls.md

@@ -138,8 +138,6 @@ getMultilingualUrls(
 // }
 ```
 
----
-
 ### Różne tryby routingu
 
 ```typescript
@@ -205,6 +203,12 @@ getMultilingualUrls("/dashboard", {
 - **Nieobsługiwane lokalizacje:**
   - Tylko lokalizacje podane w tablicy `locales` są brane pod uwagę przy generowaniu URL-i.
 
+- **Tryby routingu:**
+  - `'prefix-no-default'`: Locale domyślny nie ma prefiksu, inne go mają (np. `/dashboard`, `/fr/dashboard`)
+  - `'prefix-all'`: Wszystkie locale'y mają prefiksy (np. `/en/dashboard`, `/fr/dashboard`)
+  - `'no-prefix'`: Brak prefiksów locale'ów w URL-ach (wszystkie locale'y zwracają ten sam URL)
+  - `'search-params'`: Locale określony poprzez parametr zapytania (np. `/dashboard?locale=fr`)
+
 ---
 
 ## Użycie w aplikacjach

package/docs/pl/packages/intlayer/getTranslation.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 Funkcja `getTranslationContent` pobiera zawartość odpowiadającą określonemu locale z zestawu konfigurowalnych treści językowych. Jeśli podany locale nie zostanie znaleziony, domyślnie zwraca zawartość dla domyślnego locale skonfigurowanego w projekcie.
 
+Aby uzyskać więcej szczegółów na temat deklarowania tłumaczeń, zapoznaj się z [dokumentacją Tłumaczeń](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/translation.md).
+
 ## Parametry
 
 - `languageContent: CustomizableLanguageContent<Content>`

package/docs/pl/packages/next-intlayer/t.md

@@ -159,6 +159,23 @@ W `next-intlayer` bieżąca lokalizacja jest zarządzana przez dostawców kontek
 
 #### Przykład:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -174,6 +191,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+ </Tab>
+</Tabs>
+
 ---
 
 ## Częste błędy i rozwiązywanie problemów

package/docs/pl/packages/next-intlayer/useIntlayer.md

@@ -79,6 +79,9 @@ Instrukcje dotyczące konfigurowania plików deklaracji zawartości są dostępn
 
 Oto jak można zaimplementować hook `useIntlayer` na stronie Next.js, aby dynamicznie ładować zlokalizowaną zawartość w oparciu o aktualną lokalizację aplikacji:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +107,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat="typescript"
 "use-client";
 

package/docs/pl/packages/react-intlayer/useDictionary.md

@@ -30,8 +30,6 @@ Hook `useDictionary` umożliwia przetwarzanie obiektu wyglądającego jak słown
 
 ## Integracja z serwerem
 
-Jeśli używasz hooka `useDictionary` poza `IntlayerProvider`, locale musi być jawnie przekazane jako parametr podczas renderowania komponentu:
-
 ```tsx fileName="./ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer/server";

package/docs/pl/packages/react-intlayer/useI18n.md

@@ -77,6 +77,9 @@ Wszystkie klucze słownika muszą być zadeklarowane w plikach deklaracji zawart
 
 Przykłady użycia hooka `useI18n` w komponentach React:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +104,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```jsx fileName="src/components/ComponentExample.jsx" codeFormat="esm"
 import { useI18n } from "react-intlayer";
 
@@ -116,6 +122,9 @@ const ComponentExample = () => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```jsx fileName="src/components/ComponentExample.cjs" codeFormat="commonjs"
 const { useI18n } = require("react-intlayer");
 

package/docs/pl/packages/react-intlayer/useIntlayer.md

@@ -31,32 +31,6 @@ Ta sekcja zawiera szczegółowe wskazówki dotyczące używania hooka `useIntlay
 
 ## Przykład użycia w React
 
-Demonstracja hooka `useIntlayer` w komponencie React:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useIntlayer } from "react-intlayer";
@@ -73,21 +47,6 @@ const ComponentExample: FC = () => {
 };
 ```
 
-```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import { useIntlayer } from "react-intlayer/server";
-
-const ServerComponentExample = () => {
-  const content = useIntlayer("server-component");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p> {/* opis komponentu serwera */}
-    </div>
-  );
-};
-```
-
 ## Dodatkowe Zasoby
 
 - **Intlayer Visual Editor**: Dla bardziej intuicyjnego zarządzania treścią, zapoznaj się z dokumentacją edytora wizualnego [tutaj](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md).