@intlayer/docs 9.5.4 → 9.5.6

package/docs/pl/packages/remix-intlayer/Intlayer.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Dokumentacja kontekstu Intlayer | remix-intlayer
+description: Dokumentacja klucza magazynu kontekstu żądania Intlayer w aplikacjach Remix 3.
+keywords:
+  - Intlayer
+  - remix
+  - remix-3
+  - kontekst żądania
+  - internacjonalizacja
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - Intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Początkowa dokumentacja klucza kontekstu Intlayer"
+author: aymericzip
+---
+
+# Klucz kontekstu żądania Intlayer
+
+Eksport `Intlayer` służy jako identyfikator magazynu kontekstu żądania w Remix 3. Pozwala na bezpośrednie pobranie stanu Intlayer z obiektu kontekstu Remix wewnątrz procedur obsługi tras lub niestandardowego middleware.
+
+## Użycie
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer, Intlayer } from "remix-intlayer";
+
+const router = createRouter({
+  middleware: [intlayer()],
+});
+
+router.get("/api/current-locale", (context) => {
+  const intlayerState = context.get(Intlayer);
+
+  return Response.json({
+    locale: intlayerState?.locale,
+  });
+});
+```
+
+## Opis
+
+`Intlayer` jest używany przez middleware `intlayer()` do powiązania bieżącego stanu sesji z kontekstem żądania Remix (`RequestContext`). Zazwyczaj zaleca się korzystanie z hooków, takich jak `useLocale()` lub `useIntlayer()`. Bezpośredni dostęp przez `context.get(Intlayer)` jest przydatny w niskopoziomowych procedurach obsługi middleware lub trasach API, gdzie instancja kontekstu jest przekazywana jawnie.
+
+## Powiązana dokumentacja
+
+- [Middleware `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/intlayerMiddleware.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/useLocale.md)

package/docs/pl/packages/remix-intlayer/exports.md

@@ -0,0 +1,80 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Dokumentacja pakietu remix-intlayer
+description: Dokumentacja eksportów pakietu remix-intlayer, zapewniającego internacjonalizację (i18n) dla aplikacji Remix 3.
+keywords:
+  - remix-intlayer
+  - remix
+  - remix-3
+  - intlayer
+  - internacjonalizacja
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - exports
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Początkowa dokumentacja eksportów remix-intlayer"
+author: aymericzip
+---
+
+# Pakiet remix-intlayer
+
+Pakiet `remix-intlayer` dostarcza narzędzia do integracji Intlayer z aplikacjami Remix 3. Zawiera middleware do wykrywania języka (locale) żądania, dostęp do kontekstu żądania oraz hooki do pobierania słowników i zarządzania językami.
+
+## Instalacja
+
+```bash
+npm install remix-intlayer
+```
+
+## Eksporty pakietu
+
+### Middleware
+
+| Eksport    | Typ                | Opis                                                                                                             | Powiązana dokumentacja                                                                                                             |
+| ---------- | ------------------ | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Funkcja middleware | Middleware dla Remix 3 wykrywające język żądania, zarządzające przekierowaniami i wypełniające kontekst żądania. | [Middleware intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/intlayerMiddleware.md) |
+
+### Przechowywanie kontekstu
+
+| Eksport    | Typ                            | Opis                                                                                                                | Powiązana dokumentacja                                                                                                 |
+| ---------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `Intlayer` | Klucz RequestContext / magazyn | Klucz kontekstu żądania używany do pobierania stanu Intlayer z kontekstu żądania Remix 3 (`context.get(Intlayer)`). | [Kontekst Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/Intlayer.md) |
+
+### Hooki
+
+| Eksport         | Typ  | Opis                                                                                                      | Powiązana dokumentacja                                                                                                       |
+| --------------- | ---- | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Hook | Pobiera i przetwarza zawartość słownika na podstawie klucza dla bieżącego języka żądania.                 | [Hook useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/useIntlayer.md)     |
+| `useDictionary` | Hook | Zwraca zawartość zaimportowanego obiektu słownika odpowiadającą bieżącemu językowi żądania.               | [Hook useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/useDictionary.md) |
+| `useLocale`     | Hook | Zapewnia dostęp do bieżącego języka żądania, domyślnego języka oraz listy dostępnych języków w projekcie. | [Hook useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/useLocale.md)         |
+
+## Szybki start
+
+### Konfiguracja routera z middleware
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer } from "remix-intlayer";
+
+export const router = createRouter({
+  middleware: [intlayer()],
+});
+```
+
+### Wykorzystanie treści w widokach i komponentach
+
+```ts fileName="src/views/home.ts"
+import { useIntlayer } from "remix-intlayer";
+
+export const HomeView = () => {
+  const content = useIntlayer("home");
+
+  return `<h1>${content.title}</h1><p>${content.description}</p>`;
+};
+```

package/docs/pl/packages/remix-intlayer/intlayerMiddleware.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Dokumentacja middleware intlayer | remix-intlayer
+description: Dowiedz się, jak używać middleware intlayer w Remix 3 do wykrywania języka, obsługi przekierowań i wstrzykiwania stanu Intlayer do kontekstu żądania.
+keywords:
+  - intlayer
+  - middleware
+  - remix
+  - remix-3
+  - internacjonalizacja
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - intlayerMiddleware
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Początkowa dokumentacja middleware intlayer"
+author: aymericzip
+---
+
+# Middleware intlayer
+
+Funkcja middleware `intlayer` konfiguruje internacjonalizację dla każdego żądania w aplikacjach Remix 3. Wykrywa język każdego przychodzącego żądania, stosuje reguły przekierowań URL i zachowuje stan języka w kontekście żądania.
+
+## Użycie
+
+Zarejestruj middleware w swoim routerze Remix:
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer } from "remix-intlayer";
+
+export const router = createRouter({
+  middleware: [intlayer()],
+});
+```
+
+## Jak to działa
+
+Middleware wykonuje następujące zadania dla każdego przychodzącego żądania:
+
+1. **Wykrywanie języka**: Wyodrębnia język z prefiksu ścieżki URL (np. `/pl/about`), plików cookie lub nagłówka `Accept-Language` zgodnie z konfiguracją Intlayer.
+2. **Przekierowanie URL**: Jeśli żądana ścieżka nie zawiera prefiksu języka, a konfiguracja wymaga routingu z prefiksem, middleware zwraca odpowiedź przekierowującą (302/307/308) na odpowiedni adres URL z prefiksem.
+3. **Wypełnianie kontekstu żądania**: Zapisuje aktualnie ustalony język w kontekście żądania Remix przy użyciu klucza `Intlayer`, umożliwiając hookom (`useLocale`, `useIntlayer`, `useDictionary`) bezpośredni dostęp.
+4. **Zarządzanie plikami cookie**: Ustawia nagłówek `Set-Cookie`, gdy zachodzi potrzeba utrwalenia preferowanego języka użytkownika.
+
+## Powiązana dokumentacja
+
+- [Kontekst żądania `Intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/Intlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/useLocale.md)
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/useIntlayer.md)

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

@@ -0,0 +1,95 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Dokumentacja hooka useDictionary | remix-intlayer
+description: Zobacz, jak używać hooka useDictionary w aplikacjach Remix 3, aby rozwiązywać obiekty słowników dla bieżącego języka żądania.
+keywords:
+  - useDictionary
+  - dictionary
+  - remix
+  - remix-3
+  - Intlayer
+  - intlayer
+  - internacjonalizacja
+  - dokumentacja
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - useDictionary
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Początkowa dokumentacja hooka useDictionary"
+author: aymericzip
+---
+
+# Dokumentacja hooka useDictionary
+
+Hook `useDictionary` przekształca zaimportowany lub wbudowany obiekt słownika i zwraca jego zawartość rozwiązaną dla języka bieżącego żądania w aplikacjach Remix 3.
+
+W przeciwieństwie do `useIntlayer`, który pobiera słowniki na podstawie ich klucza tekstowego z globalnego rejestru słowników, `useDictionary` przyjmuje bezpośrednio obiekt słownika.
+
+## Użycie
+
+```ts fileName="src/views/home.ts"
+import { useDictionary } from "remix-intlayer";
+import homeContent from "./home.content";
+
+export const HomeView = () => {
+  const content = useDictionary(homeContent);
+
+  return `
+    <div>
+      <h1>${content.title}</h1>
+      <p>${content.subtitle}</p>
+    </div>
+  `;
+};
+```
+
+Możesz także przekazywać wbudowane słowniki zdefiniowane za pomocą `t()`:
+
+```ts
+import { useDictionary } from "remix-intlayer";
+import { t } from "intlayer";
+
+export const FooterView = () => {
+  const content = useDictionary({
+    key: "footer",
+    content: {
+      copyright: t({
+        pl: "Wszelkie prawa zastrzeżone.",
+        en: "All rights reserved.",
+        fr: "Tous droits réservés.",
+        es: "Todos los derechos reservados.",
+      }),
+    },
+  });
+
+  return `<footer>${content.copyright}</footer>`;
+};
+```
+
+## Parametry
+
+```ts
+useDictionary(dictionary, localeOrSelector?)
+```
+
+1. **`dictionary`**: Obiekt słownika lub kwalifikowana grupa słowników.
+2. **`localeOrSelector`** (opcjonalnie): Określony język lub obiekt selektora (`{ item }`, `{ variant }`, opcjonalnie z `locale`). Ma pierwszeństwo przed językiem żądania, jeśli zostanie podany.
+
+## Opis
+
+Hook wykonuje następujące zadania:
+
+1. **Wykrywanie języka**: Odczytuje aktywny język żądania z magazynu `AsyncLocalStorage` utworzonego przez middleware `intlayer()`.
+2. **Rozwiązywanie zawartości**: Ewaluuje tłumaczenia (`t()`), wyliczenia, warunki i zagnieżdżone struktury zgodnie z ustalonym językiem.
+3. **Przetwarzanie selektorów**: Stosuje wszelkie selektory elementów lub wariantów określone w argumentach.
+
+## Powiązana dokumentacja
+
+- [Middleware `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/intlayerMiddleware.md)
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/useLocale.md)

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

@@ -0,0 +1,94 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Dokumentacja hooka useIntlayer | remix-intlayer
+description: Zobacz, jak używać hooka useIntlayer w aplikacjach Remix 3, aby uzyskać dostęp do zlokalizowanej zawartości według klucza.
+keywords:
+  - useIntlayer
+  - dictionary
+  - remix
+  - remix-3
+  - Intlayer
+  - intlayer
+  - internacjonalizacja
+  - dokumentacja
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - useIntlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Początkowa dokumentacja hooka useIntlayer"
+author: aymericzip
+---
+
+# Dokumentacja hooka useIntlayer
+
+Hook `useIntlayer` umożliwia pobieranie zlokalizowanej zawartości ze słownika Intlayer według klucza w aplikacjach Remix 3.
+
+Automatycznie odczytuje aktywny język z bieżącego kontekstu żądania (za pośrednictwem `AsyncLocalStorage`), dzięki czemu nie trzeba przekazywać języka przez procedury obsługi tras, szablony widoków ani komponenty.
+
+## Użycie
+
+### W procedurach obsługi tras
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer, useIntlayer } from "remix-intlayer";
+
+const router = createRouter({
+  middleware: [intlayer()],
+});
+
+router.get("/api/welcome", () => {
+  const content = useIntlayer("home");
+
+  return Response.json({
+    title: content.title,
+    subtitle: content.subtitle,
+  });
+});
+```
+
+### W szablonach widoków i komponentach
+
+```tsx fileName="src/views/home.ts"
+import { useIntlayer } from "remix-intlayer";
+
+export const HomeView = () => {
+  const content = useIntlayer("home");
+
+  return `
+    <main>
+      <h1>${content.title}</h1>
+      <p>${content.subtitle}</p>
+    </main>
+  `;
+};
+```
+
+## Parametry
+
+```ts
+useIntlayer(key, localeOrSelector?)
+```
+
+1. **`key`**: Unikalny klucz słownika (zgodnie z definicją w plikach deklaracji `.content.ts`).
+2. **`localeOrSelector`** (opcjonalnie): Określony język lub obiekt selektora (`{ item }`, `{ variant }`, opcjonalnie z `locale`). Jeśli zostanie podany, nadpisuje język wykryty z kontekstu żądania.
+
+## Opis
+
+Hook wykonuje następujące zadania:
+
+1. **Wykrywanie języka z kontekstu**: Wykrywa bieżący język z zakresu `AsyncLocalStorage` powiązanego z żądaniem, ustanowionego przez middleware `intlayer()`.
+2. **Pobieranie słownika**: Pobiera wstępnie skompilowany słownik odpowiadający podanemu kluczowi.
+3. **Przetwarzanie tłumaczeń**: Rozwiązuje tłumaczenia, wyliczenia, markdown i zawartość warunkową dla ustalonego języka.
+4. **Obsługa fallbacku**: W przypadku wywołania poza aktywnym kontekstem żądania HTTP (np. zadania w tle lub testy jednostkowe bez middleware) bezpiecznie powraca do skonfigurowanego `defaultLocale`.
+
+## Powiązana dokumentacja
+
+- [Middleware `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/intlayerMiddleware.md)
+- [Hook `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/useDictionary.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/useLocale.md)

package/docs/pl/packages/remix-intlayer/useLocale.md

@@ -0,0 +1,104 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Dokumentacja hooka useLocale | remix-intlayer
+description: Zobacz, jak używać hooka useLocale w aplikacjach Remix 3, aby uzyskać bieżący język żądania, domyślny język i dostępne języki.
+keywords:
+  - useLocale
+  - locale
+  - remix
+  - remix-3
+  - Intlayer
+  - intlayer
+  - internacjonalizacja
+  - dokumentacja
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - useLocale
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Początkowa dokumentacja hooka useLocale"
+author: aymericzip
+---
+
+# Dokumentacja hooka useLocale
+
+Hook `useLocale` z `remix-intlayer` zapewnia dostęp do języka aktualnie przetwarzanego żądania HTTP, a także do domyślnego języka i listy dostępnych języków skonfigurowanych w projekcie.
+
+## Użycie
+
+W komponencie Remix (na przykład przełączniku języków):
+
+```tsx fileName="src/components/LocaleSwitcher.tsx"
+import { type FC } from "react";
+import { Link } from "@remix-run/react";
+import { useLocale } from "remix-intlayer";
+import { getLocalizedUrl, getPathWithoutLocale } from "intlayer";
+
+export const LocaleSwitcher: FC = () => {
+  const { locale, availableLocales } = useLocale();
+  const pathWithoutLocale = getPathWithoutLocale();
+
+  return (
+    <nav>
+      <ul>
+        {availableLocales.map((localeItem) => (
+          <li key={localeItem} className="p-1">
+            <Link
+              href={getLocalizedUrl(pathWithoutLocale, localeItem)}
+              aria-current={localeItem === locale ? "page" : undefined}
+            >
+              {localeItem.toUpperCase()}
+            </Link>
+          </li>
+        ))}
+      </ul>
+    </nav>
+  );
+};
+```
+
+W procedurze obsługi trasy:
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer, useLocale } from "remix-intlayer";
+
+const router = createRouter({
+  middleware: [intlayer()],
+});
+
+router.get("/api/locale-info", () => {
+  const { locale, defaultLocale, availableLocales } = useLocale();
+
+  return Response.json({
+    locale,
+    defaultLocale,
+    availableLocales,
+  });
+});
+```
+
+## Wartości zwracane
+
+Hook zwraca obiekt typu `UseLocaleResult`:
+
+| Właściwość         | Typ                 | Opis                                                                           |
+| ------------------ | ------------------- | ------------------------------------------------------------------------------ |
+| `locale`           | `DeclaredLocales`   | Język ustalony dla bieżącego żądania.                                          |
+| `defaultLocale`    | `DeclaredLocales`   | Domyślny język rezerwowy skonfigurowany w `intlayer.config.ts`.                |
+| `availableLocales` | `DeclaredLocales[]` | Tablica wszystkich dostępnych języków skonfigurowanych w `intlayer.config.ts`. |
+
+## Opis
+
+1. **Ustalanie w zakresie żądania**: W aktywnym żądaniu obsługiwanym przez middleware `intlayer()`, `useLocale` odczytuje ustalony język z magazynu żądania.
+2. **Bezpieczny powrót (Fallback)**: W przypadku wywołania poza kontekstem żądania (np. podczas skryptów inicjalizacyjnych lub zestawów testowych), domyślnie przyjmowany jest skonfigurowany `defaultLocale`.
+
+## Powiązana dokumentacja
+
+- [Middleware `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/intlayerMiddleware.md)
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/useIntlayer.md)
+- [Hook `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/remix-intlayer/useDictionary.md)

package/docs/pl/readme.md

@@ -199,7 +199,8 @@ Poznaj naszą obszerną dokumentację, aby rozpocząć pracę z Intlayer i dowie
   <li><a href="https://intlayer.org/doc/environment/create-react-app" rel=''>React CRA</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-react" rel=''>Vite + React</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-react" rel=''>Vite + React używając kompilatora</a></li>
-  <li><a href="https://intlayer.org/doc/environment/vite-and-react/compiler" rel=''>React-router-v7</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-react/react-router-v7" rel=''>React-router-v7</a></li>
+  <li><a href="https://intlayer.org/doc/environment/remix-3" rel=''>Remix 3</a></li>
   <li><a href="https://intlayer.org/doc/environment/tanstack-start" rel=''>Tanstack start</a>
     <ul>
       <li><a href="https://intlayer.org/doc/environment/tanstack-start/solid" rel=''>Solid</a></li>
@@ -211,7 +212,6 @@ Poznaj naszą obszerną dokumentację, aby rozpocząć pracę z Intlayer i dowie
       <li><a href="https://intlayer.org/doc/environment/astro/vue" rel=''>Vue</a></li>
       <li><a href="https://intlayer.org/doc/environment/astro/svelte" rel=''>Svelte</a></li>
       <li><a href="https://intlayer.org/doc/environment/astro/solid" rel=''>Solid</a></li>
-      <li><a href="https://intlayer.org/doc/environment/astro/vanilla" rel=''>Vanilla JS</a></li>
       <li><a href="https://intlayer.org/doc/environment/astro/lit" rel=''>Lit</a></li>
     </ul>
   </li>

package/docs/pl/releases/v8.md

@@ -1325,10 +1325,6 @@ Intlayer generuje teraz automatycznie mapy stron (sitemaps) na podstawie Twoich
 import { createFileRoute } from "@tanstack/react-router";
 import { generateSitemap } from "intlayer";
 
-const SITE_URL = (
-  import.meta.env.VITE_SITE_URL ?? "http://localhost:3000"
-).replace(/\/$/, "");
-
 export const Route = createFileRoute("/sitemap.xml")({
   server: {
     handlers: {
@@ -1338,7 +1334,7 @@ export const Route = createFileRoute("/sitemap.xml")({
             { path: "/", changefreq: "daily", priority: 1.0 },
             { path: "/about", changefreq: "monthly", priority: 0.8 },
           ],
-          { siteUrl: SITE_URL }
+          { siteUrl: "https://example.com" }
         );
 
         return new Response(sitemap, {