@intlayer/docs 9.0.0-canary.5 → 9.0.0-canary.7

package/docs/pl/intlayer_with_vite+vanilla.md

@@ -188,7 +188,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -449,12 +455,15 @@ Najpierw dodaj `intlayerProxy` do konfiguracji Vite:
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // powinien być umieszczony jako pierwszy
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -586,6 +595,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Kompilator Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Zaktualizuj `vite.config.ts`, aby dołączyć wtyczkę `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -595,7 +606,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Dodaje wtyczkę kompilatora
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/pl/intlayer_with_vite+vue.md

@@ -624,14 +624,17 @@ Równolegle możesz również użyć `intlayerProxy`, aby dodać routowanie po s
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     vue(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -1006,6 +1009,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Kompilator Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Zaktualizuj `vite.config.ts`, aby dołączyć wtyczkę `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -1015,7 +1020,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Dodaje wtyczkę kompilatora
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/pl/packages/@intlayer_babel/export.md

@@ -0,0 +1,131 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: "Dokumentacja pakietu @intlayer/babel"
+description: Wtyczki Babel dla Intlayer do obsługi ekstrakcji zawartości, optymalizacji importu, oczyszczania nieużywanych pól i maskowania nazw pól podczas budowania.
+keywords:
+  - "@intlayer/babel"
+  - babel
+  - plugin
+  - umiędzynarodowienie
+  - i18n
+  - kompilator
+  - optymalizuj
+  - oczyść
+  - minifikuj
+slugs:
+  - doc
+  - packages
+  - "@intlayer/babel"
+  - export
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Ujednolicona dokumentacja wszystkich eksportów"
+author: aymericzip
+---
+
+# Pakiet @intlayer/babel
+
+Pakiet `@intlayer/babel` dostarcza zestaw wyspecjalizowanych wtyczek Babel dla Intlayer. Wtyczki te obejmują cały cykl budowania: ekstrahowanie deklaracji zawartości, przepisywanie wywołań `useIntlayer` / `getIntlayer` do zoptymalizowanych importów słowników, oczyszczanie nieużywanych pól i minifikację nazw pól.
+
+## Instalacja
+
+```bash
+npm install @intlayer/babel
+```
+
+## Eksporty
+
+Import:
+
+```ts
+import { ... } from "@intlayer/babel";
+```
+
+---
+
+### Wtyczki
+
+| Funkcja / Klasa                | Opis                                                                                                                                                                                                                      |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayerExtractBabelPlugin`   | Wtyczka Babel, która ekstrahuje przetłumaczalną zawartość z plików źródłowych i automatycznie wstrzykuje hooki `useIntlayer` / `getIntlayer`. Przeznaczona do użytku z Next.js i narzędziami budowania opartymi na Babel. |
+| `intlayerOptimizeBabelPlugin`  | Wtyczka Babel, która przekształca wywołania `useIntlayer` i `getIntlayer` oraz przepisuje ich importy do zoptymalizowanych importów słowników JSON (statycznych, dynamicznych lub przez fetch).                           |
+| `intlayerPurgeBabelPlugin`     | Wtyczka Babel, która analizuje pliki źródłowe i przepisuje skompilowane pliki JSON słowników w celu usunięcia nieużywanych pól (`build.purge`) lub zmiany ich nazw na krótkie aliasy (`build.minify`).                    |
+| `intlayerMinifyBabelPlugin`    | Wtyczka Babel, która przepisuje pliki źródłowe w celu użycia krótkich aliasów pól przypisanych podczas fazy minifikacji (np. `content.title` ← `content.a`). Zależy od `intlayerPurgeBabelPlugin`.                        |
+| `makeFieldRenameBabelPlugin`   | Funkcja fabryczna (factory), która tworzy wtyczkę Babel do zmiany nazw dostępów do pól zawartości słownika w plikach źródłowych zgodnie z `dictionaryKeyToFieldRenameMap` wypełnioną w `PruneContext`.                    |
+| `makeUsageAnalyzerBabelPlugin` | Funkcja fabryczna, która tworzy wtyczkę Babel do analizowania użycia `useIntlayer` / `getIntlayer` w kodzie źródłowym i agregowania danych o użyciu pól we wspólnym `PruneContext`.                                       |
+| `getSharedPruneContext`        | Funkcja pomocnicza, która zwraca wspólny obiekt `PruneContext` dla określonego katalogu bazowego lub `null`, jeśli nie został jeszcze zainicjowany.                                                                       |
+
+---
+
+### Narzędzia konfiguracji wtyczek
+
+| Funkcja                    | Opis                                                                                                                                       |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| `getExtractPluginOptions`  | Ładuje konfigurację Intlayer i zwraca `ExtractPluginOptions` gotowe do użycia z `intlayerExtractBabelPlugin`.                              |
+| `getOptimizePluginOptions` | Ładuje konfigurację Intlayer i skompilowane słowniki oraz zwraca `OptimizePluginOptions` gotowe do użycia z `intlayerOptimizeBabelPlugin`. |
+| `getPurgePluginOptions`    | Ładuje konfigurację Intlayer i zwraca `PurgePluginOptions` gotowe do użycia z `intlayerPurgeBabelPlugin`.                                  |
+| `getMinifyPluginOptions`   | Ładuje konfigurację Intlayer i zwraca `MinifyPluginOptions` gotowe do użycia z `intlayerMinifyBabelPlugin`.                                |
+
+---
+
+### Typy
+
+| Typ                     | Opis                                                                                                                       |
+| ----------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `CompilerMode`          | Tryb kompilatora: `'dev'` do programowania ze wsparciem HMR lub `'build'` dla kompilacji produkcyjnych.                    |
+| `ExtractPluginOptions`  | Opcje dla `intlayerExtractBabelPlugin`: lista plików, konfiguracja, callback `onExtract` itp.                              |
+| `ExtractResult`         | Wynik ekstrakcji: klucz słownika, ścieżka do pliku, zawartość i język.                                                     |
+| `OptimizePluginOptions` | Opcje dla `intlayerOptimizeBabelPlugin`: ścieżki słowników, tryb importu, mapa trybów dla słownika itp.                    |
+| `PurgePluginOptions`    | Opcje dla `intlayerPurgeBabelPlugin`: katalog bazowy, flagi purge/minify/optimize, lista plików komponentów.               |
+| `MinifyPluginOptions`   | Opcje dla `intlayerMinifyBabelPlugin`: katalog bazowy, flagi minify/optimize/editorEnabled.                                |
+| `PruneContext`          | Stan współdzielony między wtyczkami analizującymi i oczyszczającymi: mapy użycia pól, mapy zmiany nazw itp.                |
+| `DictionaryFieldUsage`  | Wynik użycia pola dla pojedynczego słownika: `Set<string>` lub `'all'`, gdy analiza statyczna jest niejednoznaczna.        |
+| `NestedRenameEntry`     | Węzeł w drzewie zmiany nazw: `shortName` i mapa dzieci.                                                                    |
+| `NestedRenameMap`       | Jeden poziom w drzewie zmiany nazw: `Map<string, NestedRenameEntry>`.                                                      |
+| `CompatCallerConfig`    | Konfiguracja dla kompatybilnego analizatora użycia dla pakietów compat-adapter (nazwa wywołującego i opcje przetwarzania). |
+| `ScriptBlock`           | Blok skryptu wyekstrahowany z pliku SFC (Vue lub Svelte): zawartość, przesunięcie początkowe i przesunięcie końcowe.       |
+
+---
+
+### Funkcje pomocnicze
+
+| Funkcja                           | Opis                                                                                                                                                        |
+| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `generateShortFieldName`          | Konwertuje liczbę całkowitą (zaczynając od zera) na krótki identyfikator alfabetyczny: `0` → `'a'`, `25` → `'z'`, `26` → `'aa'`, itp.                       |
+| `buildNestedRenameMapFromContent` | Rekurencyjnie buduje `NestedRenameMap` z wartości zawaktu skompilowanego słownika, przestrzegając struktur węzłów Intlayer (translation, enumeration itp.). |
+| `createPruneContext`              | Tworzy nowy pusty obiekt `PruneContext` zainicjowany wartościami domyślnymi.                                                                                |
+| `extractScriptBlocks`             | Ekstrahuje bloki `<script>` z plików SFC (Vue / Svelte) do późniejszej analizy Babel.                                                                       |
+| `BABEL_PARSER_OPTIONS`            | Stała reprezentująca opcje parsera Babel obejmująca obsługiwane frameworki (React/Vue/Svelte/Angular/...).                                                  |
+| `INTLAYER_CALLER_NAMES`           | Stała lista oryginalnych nazw wywołujących Intlayer: `['useIntlayer', 'getIntlayer']`.                                                                      |
+
+---
+
+## Przykładowe użycie
+
+```js
+// babel.config.js
+const {
+  intlayerExtractBabelPlugin,
+  intlayerPurgeBabelPlugin,
+  intlayerMinifyBabelPlugin,
+  intlayerOptimizeBabelPlugin,
+  getExtractPluginOptions,
+  getPurgePluginOptions,
+  getMinifyPluginOptions,
+  getOptimizePluginOptions,
+} = require("@intlayer/babel");
+
+module.exports = {
+  presets: ["next/babel"],
+  plugins: [
+    [intlayerExtractBabelPlugin, getExtractPluginOptions()],
+    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
+    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
+    [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],
+  ],
+};
+```
+
+> **Uwaga:** Wtyczka `intlayerPurgeBabelPlugin` musi być zadeklarowana **przed** `intlayerMinifyBabelPlugin`, ponieważ ta druga odczytuje mapę zmian nazw utworzoną przez tę pierwszą. Ponadto obie muszą być poprzedzone wtyczką `intlayerOptimizeBabelPlugin`, aby mogła ona zobaczyć klucze słownika przed przepisaniem wywołań do `useIntlayer`.

package/docs/pl/packages/react-native-intlayer/exports.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-06-25
 title: Dokumentacja pakietu react-native-intlayer
-description: Wsparcie React Native dla Intlayer, zapewniające providerów i polyfille.
+description: Wsparcie React Native dla Intlayer, zapewniające providerów, hooki, polyfille i konfigurację Metro.
 keywords:
   - react-native-intlayer
   - react-native
@@ -14,6 +14,9 @@ slugs:
   - react-native-intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Reeksportowanie pełnego API react-intlayer (hooki, narzędzia, podścieżki format/html/markdown), aby aplikacja React Native zależała tylko od react-native-intlayer"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Ujednolicona dokumentacja dla wszystkich eksportów"
@@ -22,7 +25,9 @@ author: aymericzip
 
 # Pakiet react-native-intlayer
 
-Pakiet `react-native-intlayer` dostarcza niezbędne narzędzia do integracji Intlayer z aplikacjami React Native. Zawiera provider oraz polyfille wspierające obsługę lokalizacji.
+Pakiet `react-native-intlayer` dostarcza niezbędne narzędzia do integracji Intlayer z aplikacjami React Native. Reeksportuje pełne API `react-intlayer` (hooki i narzędzia) wraz z gotowym na React Native `IntlayerProvider`, a także polyfille i konfigurację Metro wymaganą przez React Native.
+
+> W aplikacji React Native importuj **wszystko** z `react-native-intlayer`. Nie musisz instalować ani importować `react-intlayer` bezpośrednio.
 
 ## Instalacja
 
@@ -34,14 +39,30 @@ npm install react-native-intlayer
 
 ### Provider
 
-| Komponent          | Opis                                                                             |
-| ------------------ | -------------------------------------------------------------------------------- |
-| `IntlayerProvider` | Komponent Provider, który otacza Twoją aplikację i udostępnia kontekst Intlayer. |
+| Komponent          | Opis                                                                                                                       |
+| ------------------ | -------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerProvider` | Komponent Provider, który otacza Twoją aplikację i udostępnia kontekst Intlayer. Automatycznie stosuje wymagane polyfille. |
+
+```tsx
+import { IntlayerProvider } from "react-native-intlayer";
+```
+
+### Hooki i narzędzia
+
+Są reeksportowane z `react-intlayer`, więc możesz importować je bezpośrednio z `react-native-intlayer`:
 
-Import:
+| Eksport                                                                                                           | Opis                                                     |
+| ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| `useIntlayer`                                                                                                     | Dostęp do zlokalizowanej zawartości dla klucza słownika. |
+| `useLocale`                                                                                                       | Odczyt i zmiana bieżącej lokalizacji.                    |
+| `useDictionary`, `useDictionaryAsync`, `useDictionaryDynamic`, `useLoadDynamic`                                   | Ładowanie zawartości słownika na różne sposoby.          |
+| `useI18n`                                                                                                         | Hook kompatybilny z i18next.                             |
+| `t`                                                                                                               | Pomocnik tłumaczenia inline.                             |
+| `getIntlayer`, `getDictionary`                                                                                    | Imperatywne gettery zawartości.                          |
+| `localeCookie`, `localeInStorage`, `setLocaleCookie`, `setLocaleInStorage`, `useLocaleCookie`, `useLocaleStorage` | Pomocniki trwałości lokalizacji.                         |
 
 ```tsx
-import "react-native-intlayer";
+import { useIntlayer, useLocale, t } from "react-native-intlayer";
 ```
 
 ### Polyfill
@@ -50,10 +71,25 @@ import "react-native-intlayer";
 | ------------------ | ----------------------------------------------------------------------------------- |
 | `intlayerPolyfill` | Funkcja, która stosuje niezbędne polyfille dla React Native, aby wspierać Intlayer. |
 
-Import:
+```tsx
+import { intlayerPolyfill } from "react-native-intlayer";
+```
+
+> Polyfill jest stosowany automatycznie podczas importowania `IntlayerProvider`. Wywołaj `intlayerPolyfill` ręcznie tylko wtedy, gdy potrzebujesz polyfilli przed zamontowaniem providera.
+
+### Formatery
+
+Hooki do formatowania liczb, dat i inne oparte na Intl są dostępne z podścieżki `/format`:
+
+```tsx
+import { useNumber, useDate } from "react-native-intlayer/format";
+```
+
+### Renderowanie Markdown i HTML
 
 ```tsx
-import "react-native-intlayer";
+import { MarkdownProvider } from "react-native-intlayer/markdown";
+import { HTMLProvider } from "react-native-intlayer/html";
 ```
 
 ### Konfiguracja Metro
@@ -66,8 +102,6 @@ Pakiet `react-native-intlayer` dostarcza narzędzia do konfiguracji Metro, aby z
 | `configMetroIntlayerSync` | Funkcja synchroniczna, która scala konfigurację Metro bez przygotowywania zasobów Intlayer. |
 | `exclusionList`           | Tworzy wzorzec RegExp dla blockList Metro, aby wykluczyć pliki zawartości z bundla.         |
 
-Import:
-
 ```tsx
-import "react-native-intlayer/metro";
+import { configMetroIntlayer } from "react-native-intlayer/metro";
 ```

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

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Dokumentacja wtyczki Vite intlayerCompiler | vite-intlayer
+description: Wtyczka Vite, która ekstrahuje wbudowane deklaracje zawartości Intlayer z plików komponentów i zapisuje je do plików JSON słownika w czasie budowania/transformacji.
+keywords:
+  - intlayerCompiler
+  - vite
+  - wtyczka
+  - kompilator
+  - zawartość
+  - słownik
+  - umiędzynarodowienie
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerCompiler
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Zintegrowano z intlayer(); inicjalizacja dokumentacji"
+author: aymericzip
+---
+
+# intlayerCompiler
+
+`intlayerCompiler` to wtyczka Vite, która skanuje pliki źródłowe komponentów w poszukiwaniu **wbudowanych deklaracji zawartości Intlayer** (inline declarations) — zawartości zdefiniowanej bezpośrednio w komponencie, a nie w osobnym pliku `.content.ts` — i zapisuje je do plików JSON słownika podczas fazy transformacji.
+
+> **Od Intlayer v9** `intlayerCompiler` jest automatycznie dołączany do głównej wtyczki [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vite-intlayer/intlayer.md), gdy zarówno `compiler.enabled` ma wartość `true`, jak i `compiler.output` jest ustawiony w konfiguracji Intlayer. Musisz go zarejestrować osobno tylko wtedy, gdy chcesz mieć pełną kontrolę nad konfiguracją specyficzną dla kompilatora.
+
+## Użycie
+
+### Jako część `intlayer()` (zalecane, v9+)
+
+Włącz kompilator w konfiguracji Intlayer:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  compiler: {
+    enabled: true,
+    output: "./src/dictionaries", // gdzie zapisywane są wyekstrahowane słowniki
+  },
+});
+```
+
+Następnie użyj standardowej wtyczki bez dodatkowej rejestracji:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Samodzielnie (w razie potrzeby)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerCompiler()],
+});
+```
+
+## Opcje
+
+```ts
+import type { IntlayerCompilerOptions } from "vite-intlayer";
+```
+
+| Opcja            | Typ                       | Opis                                                                                                |
+| ---------------- | ------------------------- | --------------------------------------------------------------------------------------------------- |
+| `configOptions`  | `GetConfigurationOptions` | Nadpisania konfiguracji Intlayer przekazywane do `getConfiguration()`.                              |
+| `compilerConfig` | `Partial<CompilerConfig>` | Nadpisania sekcji konfiguracji specyficznej dla kompilatora (np. `enabled`, `output`, `filesList`). |
+
+### Przykład
+
+```ts
+intlayerCompiler({
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+  compilerConfig: { enabled: true, output: "./src/dictionaries" },
+});
+```
+
+## Jak to działa
+
+### Faza transformacji
+
+Dla każdego pliku źródłowego, który pasuje do `compiler.filesList`, wtyczka kompilatora:
+
+1. Przekazuje zawartość pliku do `extractContent` z pakietu `@intlayer/babel`.
+2. Wywołuje `onExtract` dla każdej znalezionej deklaracji, co zapisuje wynikowy słownik JSON do ścieżki `compiler.output`.
+3. Zwraca przetransformowany kod źródłowy z wbudowanymi deklaracjami zastąpionymi standardowymi wywołaniami `useIntlayer('key')` / `getIntlayer('key')`.
+
+Obsługiwane typy plików: `.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`, `.astro`.
+
+### HMR (Hot Module Replacement)
+
+Gdy plik komponentu zostanie zapisany w trybie deweloperskim, kompilator:
+
+1. Wykrywa zmianę pliku za pomocą hooka `handleHotUpdate` w Vite.
+2. Ponownie ekstrahuje zawartość ze zaktualizowanego pliku.
+3. Zapisuje zaktualizowany słownik JSON.
+4. Wyzwala pełne przeładowanie strony (`server.ws.send({ type: 'full-reload' })`).
+
+Debounce o wartości 500 ms zapobiega zapętleniu ponownej ekstrakcji spowodowanemu przez sam zapis słownika (który również wyzwala zdarzenie zmiany pliku).
+
+### Deduplikacja
+
+`intlayerCompiler` używa tego samego mechanizmu deduplikacji `createPrimaryInstanceGuard` co inne wbudowane wtyczki. Gdy obecne są zarówno `intlayer()` (który zawiera kompilator), jak i ręczne wywołanie `intlayerCompiler()`, uruchamiana jest tylko pierwsza zarejestrowana instancja — żadne słowniki nie są zapisywane dwukrotnie.

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

@@ -0,0 +1,92 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Dokumentacja wtyczki Vite intlayerMinify | vite-intlayer
+description: Wtyczka Vite, która minifikuje skompilowane pliki JSON słownika Intlayer i opcjonalnie maskuje nazwy pól zawartości w celu zmniejszenia rozmiaru pakietu.
+keywords:
+  - intlayerMinify
+  - vite
+  - wtyczka
+  - minifikacja
+  - rozmiar pakietu
+  - słownik
+  - umiędzynarodowienie
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerMinify
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Inicjalizacja dokumentacji"
+author: aymericzip
+---
+
+# intlayerMinify
+
+`intlayerMinify` to wtyczka Vite, która minifikuje skompilowane pliki JSON słowników podczas kompilacji produkcyjnej. Usuwa wszystkie niepotrzebne białe znaki i, w połączeniu z `intlayerPrune`, opcjonalnie zmienia nazwy pól zawartości na krótkie alfabetyczne aliasy (`a`, `b`, `c`, …), aby jeszcze bardziej zmniejszyć rozmiar pakietu (bundle'a).
+
+> Ta wtyczka jest automatycznie dołączana i konfigurowana, gdy używasz wtyczki [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vite-intlayer/intlayer.md). Musisz ją zarejestrować ręcznie tylko wtedy, gdy samodzielnie tworzysz stos wtyczek.
+
+## Użycie
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerMinify, intlayerPrune } from "vite-intlayer";
+import { createPruneContext } from "@intlayer/babel";
+
+const pruneContext = createPruneContext();
+
+export default defineConfig({
+  plugins: [
+    intlayerPrune(intlayerConfig, pruneContext),
+    intlayerMinify(intlayerConfig, pruneContext),
+  ],
+});
+```
+
+## Warunki aktywacji
+
+`intlayerMinify` jest aktywna **tylko** wtedy, gdy spełnione są wszystkie trzy poniższe warunki:
+
+1. Polecenie Vite to `build` (nie `serve` / dev).
+2. Opcja `build.optimize` ma wartość `true` (lub `undefined`, co dla kompilacji domyślnie oznacza `true`).
+3. Opcja `build.minify` w konfiguracji Intlayer ma wartość `true`.
+
+Wtyczka jest automatycznie **wyłączana**, gdy `editor.enabled` ma wartość `true`, ponieważ edytor wymaga pełnej, czytelnej dla człowieka zawartości słownika.
+
+## Co podlega minifikacji
+
+Wtyczka kieruje swoje działanie na dwie lokalizacje słowników (rozpoznane na podstawie `intlayer.system`):
+
+- `dictionariesDir` — statyczne słowniki dla wszystkich języków (np. `.intlayer/dictionaries/*.json`)
+- `dynamicDictionariesDir` — dynamiczne słowniki dla poszczególnych języków
+
+> Słowniki w trybie pobierania (`fetchDictionariesDir`) **nigdy** nie są minifikowane, ponieważ są serwowane z zewnętrznego API w czasie rzeczywistym przy użyciu ich oryginalnych nazw pól. Zmiana nazw pól stworzyłaby niezgodność między odpowiedzią serwera a dostępem do właściwości po stronie klienta.
+
+## Maskowanie nazw pól (minifikacja właściwości)
+
+Gdy wtyczka `intlayerPrune` przeanalizuje bazę kodu i uzupełni `pruneContext.dictionaryKeyToFieldRenameMap`, wtyczka `intlayerMinify` również zmienia nazwy pól zawartości na krótkie aliasy. Na przykład:
+
+```json
+// przed
+{ "key": "myDict", "content": { "title": "Hello", "description": "World" } }
+
+// po (z maskowaniem)
+{ "key": "myDict", "content": { "a": "Hello", "b": "World" } }
+```
+
+Odpowiednie odwołania do właściwości w plikach źródłowych są zmieniane przez przebieg Babel wewnątrz `intlayerOptimize`, więc zachowanie w czasie rzeczywistym pozostaje niezmienione.
+
+Wewnętrzne pola Intlayer (`nodeType`, `translation` itp.) nigdy nie zmieniają nazw.
+
+## Słowniki z przypadkami brzegowymi
+
+Słowniki oznaczone w `pruneContext.dictionariesWithEdgeCases` (anomalie strukturalne wykryte podczas fazy oczyszczania/prune) są całkowicie pomijane — nie są minifikowane ani maskowane — aby uniknąć dostarczenia uszkodzonych danych.
+
+## Grupy kwalifikowane (kolekcje / warianty / metarekordy)
+
+W przypadku słowników z tablicą `qualifierTypes` (kolekcje, warianty i metarekordy), wtyczka zachowuje tablicę `qualifierTypes` oraz mapę poboczną `meta` w oryginalnej formie. Maskowane są tylko nazwy pól wewnątrz wpisów `content`. Złożone klucze (używane do dopasowywania selektorów w czasie rzeczywistym) nigdy nie są modyfikowane.