@intlayer/docs 9.4.0-canary.0 → 9.4.0

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,8 +155,6 @@ 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:

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).

package/docs/pl/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 Wtyczka Vite `intlayerPrune` służy do tree-shakingu i usuwania nieużywanych słowników z bundla Twojej aplikacji. Pomaga to zmniejszyć końcowy rozmiar bundla, uwzględniając jedynie niezbędne wielojęzyczne treści.
 
+> Plugin jest już automatycznie włączony i skonfigurowany, gdy używasz [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vite-intlayer/intlayer.md). Musisz go zarejestrować ręcznie tylko wtedy, gdy skomponujesz stos pluginów samodzielnie.
+
 ## Użycie
 
 ### W ramach `intlayer()` (zalecane)

package/docs/pl/per_locale_file.md

@@ -76,6 +76,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.pl.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "pl", // Ważne
+  "content": {
+    "multilingualContent": "Tytuł mojego komponentu",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -94,6 +105,8 @@ module.exports = helloWorldContent;
 
 > Zalecane: Ten format jest najlepszy podczas korzystania z wizualnego edytora Intlayer lub zarządzania tłumaczeniami bezpośrednio w kodzie.
 
+> Uwaga: W obu przypadkach plik deklaracji zawartości musi być zgodny ze wzorem nazewnictwa `*.content.{ts,tsx,js,jsx,mjs,cjs,json}`, aby być rozpoznany przez Intlayer. Sufiks `.[locale]` jest opcjonalny i używany tylko jako konwencja nazewnictwa.
+
 ### Globalna konfiguracja dla plików dla poszczególnych lokali
 
 Możesz skonfigurować globalną konfigurację dla plików dla poszczególnych lokali, dodając poniższą treść do pliku `intlayer.config.ts`:
@@ -145,17 +158,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // Ważne
-  "content": {
-    "multilingualContent": "Tytuł mojego komponentu",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -169,8 +171,6 @@ export default helloWorldContent;
 
 > Ważne: Upewnij się, że pole locale jest zdefiniowane. Informuje Intlayer, jakiego języka dotyczy plik.
 
-> Uwaga: W obu przypadkach plik deklaracji zawartości musi mieć nazwę zgodną z wzorcem `*.content.{ts,tsx,js,jsx,mjs,cjs,json}`, aby został rozpoznany przez Intlayer. Sufiks `.[locale]` jest opcjonalny i służy tylko jako konwencja nazewnicza.
-
 ## Mieszanie formatów
 
 Możesz łączyć oba podejścia deklaracji dla tego samego klucza zawartości. Na przykład:

package/docs/pl/readme.md

@@ -225,8 +225,8 @@ Poznaj naszą obszerną dokumentację, aby rozpocząć pracę z Intlayer i dowie
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
   <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
-  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
-  <li>
+  <li><a href="https://intlayer.org/doc/environment/solid-start" rel=''>Solid Start</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>  <li>
      <a href="https://intlayer.org/doc/environment/express" rel=''>Backend</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ Poznaj naszą obszerną dokumentację, aby rozpocząć pracę z Intlayer i dowie
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>

package/docs/pl/releases/v9.md

@@ -373,6 +373,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 Instalator pobiera `docker-compose.yml` i `.env`, automatycznie generuje wymagane sekrety i uruchamia `docker compose up -d`. Wszystko — panel, API, baza danych, magazyn obiektów oraz transakcyjne wiadomości e-mail — działa lokalnie w kontenerach.
 
+---
+
 ## Uwagi dotyczące migracji z wersji v8
 
 Jeśli aktualizujesz aplikację z wersji v8, pamiętaj, że wersja v9 nie zawiera zmian wprowadzających niekompatybilność wsteczną (breaking changes). Oto jednak kluczowe zmiany:

package/docs/pl/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer może działać w całości na Twojej własnej infrastrukturze — konto Intlayer Cloud nie jest wymagane. Jedno polecenie uruchamia gotowy do produkcji stos:
 
+Jedno polecenie instaluje wszystko:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 Instalator pobiera plik `docker-compose.yml` oraz `.env`, automatycznie generuje wymagane sekrety i uruchamia wszystkie kontenery za pomocą `docker compose up -d`.
 
+Jedyną zewnętrzną zależnością jest **MongoDB**: backend łączy się z klastrem MongoDB **Atlas**, który Ty dostarczasz. Wszystko inne działa wewnątrz kontenera.
+
 ## Spis treści
 
 <TOC/>
@@ -60,40 +64,82 @@ Chromium (używany do generowania zrzutów ekranu przez Puppeteer) jest dołącz
 - Porty `3000`, `3100`, `8025`, `9000` i `9001` dostępne na hoście.
 - Host Linux lub macOS (lub WSL2 na Windows).
 
+Wszystko inne — Bun, Redis, MinIO, Chromium — jest dołączone do obrazu.
+
 ---
 
 ## Szybki start
 
-Pobierz i uruchom opublikowany obraz, podając swoje poświadczenia i sekrety MongoDB Atlas:
+### 1. Uruchom instalator
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Instalator sprawdza, czy Docker jest zainstalowany i uruchomiony, zapisuje `./intlayer.env` z już wygenerowanymi `BETTER_AUTH_SECRET` i `S3_SECRET_ACCESS_KEY`, a następnie pobiera obraz. Nie uruchamia kontenera — backend nie może się uruchomić bez poświadczeń bazy danych.
+
+Ponowne uruchomienie instalatora jest bezpieczne: istniejący plik `intlayer.env` nigdy nie zostanie nadpisany, co czyni to również ścieżką aktualizacji.
+
+### 2. Wypełnij swoje dane uwierzytelniające
+
+Otwórz `intlayer.env` i uzupełnij wartości oznaczone `TODO`:
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+Plik zawiera również skomentowane bloki dla opcjonalnych funkcji — [SMTP mailer](#global-mailer), `OPENAI_API_KEY` i dostawcy OAuth. Odkomentuj to, czego potrzebujesz.
+
+> Plik jest odczytywany przez `docker run --env-file`, który nie usuwa cudzysłowów i traktuje wszystko po `=` jako wartość. Wpisz wartości bez cudzysłowów i przechowuj komentarze na własnych liniach.
+
+### 3. Uruchom kontener
+
+To jest polecenie, które instalator wypisuje po zakończeniu:
 
 ```sh
 docker run -d --name intlayer \
+  --restart unless-stopped \
   -p 3000:3000 \
   -p 3100:3100 \
   -p 9000:9000 \
   -p 9001:9001 \
   -v intlayer-data:/data \
-  -e DB_ID="<atlas-user>" \
-  -e DB_MDP="<atlas-password>" \
-  -e DB_CLUSTER="<cluster>.xxxxx.mongodb.net" \
-  -e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \
-  -e S3_SECRET_ACCESS_KEY="$(openssl rand -hex 16)" \
-  -e RESEND_API_KEY="<your-resend-key>" \
-  aymericzip/intlayer-selfhost
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
 ```
 
-Następnie otwórz **http://localhost:3000**.
+Następnie otwórz **http://localhost:3000**. Pierwszy boot inicjalizuje magazyny danych, więc daj mu minutę.
 
-> Dashboard jest obsługiwany na `localhost`. Zapoznaj się z [Ograniczeniami](#limitations) — domeny niestandardowe nie są obsługiwane przez opublikowany obraz.
+> Dashboard jest serwowany na `localhost`. Zobacz [Ograniczenia](#limitations) — niestandardowe domeny nie są obsługiwane przez opublikowany obraz.
 
----
+### Ustawienia instalatora
 
-## Szybki start
+Installer odczytuje kilka zmiennych środowiskowych. Ponieważ są one przesyłane do `sh`, przekaż je do powłoki zamiast do `curl`:
 
 ```sh
-curl -fsSL https://intlayer.org/install.sh | sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
 ```
 
+| Zmienna                   | Domyślnie                                     | Opis                               |
+| ------------------------- | --------------------------------------------- | ---------------------------------- |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Obraz do pobrania                  |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Gdzie zapisać plik env             |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Nazwa kontenera                    |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Named volume zamontowany w `/data` |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Port hosta dla dashboardu          |
+| `INTLAYER_API_PORT`       | `3100`                                        | Port hosta dla API                 |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Port hosta dla MinIO S3 API        |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Port hosta dla konsoli MinIO       |
+
+> Cztery zmienne portów zmieniają tylko **stronę hosta** mapowania wydrukowanego w poleceniu `docker run`. Opublikowany obraz ma `http://localhost:3000`, `http://localhost:3100` i `http://localhost:9000` skompilowane w bundle'u dashboardu w czasie kompilacji, dlatego zmapowanie ich na nowo powoduje, że przeglądarka wskazuje na stare porty. Zachowaj wartości domyślne, chyba że budujesz swój własny obraz — zobacz [Ograniczenia](#limitations).
+
+---
+
+## Szybki start
+
 Co robi instalator:
 
 1.  Sprawdza, czy `docker` i `docker compose` są obecne.
@@ -117,8 +163,6 @@ Po uruchomieniu stosu, otwórz **http://localhost:3000** i utwórz swoje pierwsz
 | **minio**     | `minio/minio`                         | `9000` (S3), `9001` (konsola)            | Przechowywanie obiektów zgodne z S3 dla awatarów i zrzutów ekranu |
 | **mailpit**   | `axllent/mailpit`                     | `1025` (SMTP), `8025` (interfejs webowy) | Lokalny odbiornik transakcyjnych wiadomości e-mail                |
 
-Wewnętrzne porty (mongo, redis) nie są domyślnie udostępniane na hoście.
-
 > Port MinIO `9000` musi być osiągalny przez przeglądarkę, ponieważ przesłane zasoby (awatary, zrzuty ekranu) są ładowane bezpośrednio z `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
 ---
@@ -174,8 +218,6 @@ Wewnętrzne porty (mongo, redis) nie są domyślnie udostępniane na hoście.
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Logowanie LinkedIn OAuth                                                                        |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Logowanie Atlassian OAuth                                                                       |
 
----
-
 ### Globalny dostawca poczty
 
 Domyślnie wszystkie transakcyjne wiadomości e-mail są wysyłane za pośrednictwem Resend przy użyciu `RESEND_API_KEY`. Wdrożenia self-hosted mogą zamiast tego kierować **każdy** e-mail — w tym e-maile niezwiązane z organizacją, takie jak resetowanie hasła i linki magiczne — za pośrednictwem globalnego dostawcy poczty skonfigurowanego zmiennymi środowiskowymi.
@@ -261,16 +303,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## Aktualizacja
 
-Ponowne uruchomienie instalatora na istniejącym wdrożeniu wykonuje aktualizację krokową:
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 Spowoduje to pobranie najnowszych obrazów i ponowne uruchomienie kontenerów za pomocą `docker compose pull && docker compose up -d`. Istniejące woluminy (`mongo-data`, `redis-data`, `minio-data`) zostaną zachowane — brak utraty danych.
 
-Aby ręcznie zaktualizować z poziomu katalogu `./intlayer/`:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -334,15 +368,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Poszukaj `MongoDB connection error` w górnej części dziennika.
+
 ### Pulpit nawigacyjny nie może dotrzeć do API
 
 Sprawdź, czy `VITE_BACKEND_URL` odpowiada adresowi URL, pod którym backend jest osiągalny z **przeglądarki** (nie z sieci Docker). Jeśli zmieniłeś port backendu lub dodałeś reverse proxy, ponownie zbuduj obraz pulpitu nawigacyjnego:
 
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### Brak zasobnika MinIO
 
 Jeśli jednorazowa usługa `minio-init` nie uruchomiła się (lub uruchomiła się, zanim MinIO było gotowe), utwórz zasobnik ręcznie:

package/docs/pt/benchmark/tanstack.md

@@ -194,6 +194,8 @@ O `Paraglide` oferece uma abordagem inovadora e bem pensada. Mesmo assim, neste
 
 O `Tolgee` resolve muitos dos problemas mencionados anteriormente. Achei mais difícil de começar com ele do que com outras ferramentas com abordagens semelhantes. Ele não fornece segurança de tipos, o que também torna muito difícil encontrar chaves ausentes no momento da compilação. Tive que envolver as APIs do Tolgee com as minhas para adicionar a detecção de chaves ausentes.
 
+O package é bastante pesado (~11.1kb, o que é mais de 2× `react-intlayer`).
+
 No TanStack Start também tive problemas de reatividade: na mudança de localidade, tive que forçar o provedor a renderizar novamente e me inscrever em eventos de mudança de localidade para que o carregamento em outro idioma se comportasse corretamente.
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ O `react-i18next` é provavelmente a opção mais popular porque foi uma das pri
 
 Ainda assim, compartilha os mesmos grandes pontos negativos que as stacks baseadas em `t('a.b.c')`: as otimizações são possíveis, mas consomem muito tempo, e grandes projetos correm o risco de cair em más práticas (namespaces + carregamento dinâmico + tipos).
 
+O package é especialmente pesado (~17.3kb, o que é aproximadamente 3.5× `react-intlayer`).
+
 Os formatos de mensagem também divergem: o `use-intl` usa ICU MessageFormat, enquanto o `i18next` usa seu próprio formato - o que complica o ferramental ou migrações se você os misturar.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ O `Lingui` é frequentemente elogiado. Pessoalmente, achei o fluxo de trabalho e
 
 O `react-intl` é uma implementação de alto desempenho da equipe do Format.js. O DX permanece prolixo: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` adiciona complexidade, trabalho extra de JavaScript e vincula a instância global de i18n a muitos nós na árvore React.
 
+O package também é pesado (~14.4kb, o que é cerca de 3× `react-intlayer`).
+
 ### 4 - Recomendações
 
 Este benchmark do TanStack Start não possui um equivalente direto do `next-translate` (plugin Next.js + `getStaticProps`). Para as equipes que realmente desejam uma API `t()` com um ecossistema maduro, o `react-i18next` e o `use-intl` continuam sendo escolhas "razoáveis", mas espere investir muito tempo otimizando para evitar vazamentos.

package/docs/pt/cli/ci.md

@@ -128,6 +128,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 ### Usar em pipelines CI/CD
 
+Executar `intlayer init` gera dois workflows prontos para usar do GitHub Actions para você (veja [GitHub Actions gerados](#scaffolded-github-actions) abaixo). O exemplo aqui mostra a configuração equivalente usando o comando `ci` para um monorepo, onde as credenciais são injetadas por projeto a partir de `INTLAYER_PROJECT_CREDENTIALS`.
+
 Em sua configuração CI/CD (por exemplo, GitHub Actions, GitLab CI), defina `INTLAYER_PROJECT_CREDENTIALS` como um segredo:
 
 ```yaml

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

@@ -91,7 +91,15 @@ Para a maioria dos casos de uso,
 
 - **`--log`**: Modo apenas de registro (log-only). Não traduz com IA; em vez disso, registra os blocos que precisam de atenção (com números de linha e conteúdo) para as localidades base e de destino, a fim de ajudar outro agente a gerar as traduções.
 
-  > Exemplo: `npx intlayer doc review --log`
+- The **English (en) source content** for BLOCK 1
+- The **Portuguese (pt) current translation** for BLOCK 1
+- Confirmation of the **action mode** you'd like me to use (`apply`, `report`, or `synthesis`)
+
+> Exemplo: `npx intlayer doc review --mode report`
+
+> Exemplo: `npx intlayer doc review --log`
+
+Seja qual for o modo, a execução termina com uma síntese listando os documentos que estão alinhados com seu documento base e os que ainda têm blocos para editar.
 
 **Opções de saída da entrada:**
 

package/docs/pt/cli/fill.md

@@ -39,14 +39,6 @@ bun x intlayer fill
 
 Este comando analisa seus arquivos de declaração de conteúdo em busca de possíveis problemas, como traduções faltantes, inconsistências estruturais ou incompatibilidades de tipo. Se encontrar algum problema, o **intlayer fill** irá propor ou aplicar atualizações para manter seus dicionários consistentes e completos.
 
-Pontos-chave:
-
-- Divide arquivos JSON grandes em partes para permanecer dentro dos limites da janela de contexto do modelo de IA.
-- Tenta novamente a tradução se o formato de saída estiver incorreto.
-- Incorpora contexto específico da aplicação e do arquivo para melhorar a precisão da tradução.
-- Preserva traduções existentes ao não sobrescrevê-las.
-- Processa arquivos, partes e locales em paralelo usando um sistema de fila para aumentar a velocidade.
-
 ## Pontos-Chave:
 
 - Divide arquivos JSON grandes em chunks para se manter dentro dos limites da janela de contexto do modelo de IA.