@intlayer/docs 9.0.0-canary.6 → 9.0.0-canary.8

package/docs/pl/intlayer_with_react_router_v7.md

@@ -598,6 +598,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"
@@ -607,7 +609,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_react_router_v7_fs_routes.md

@@ -706,6 +706,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"
@@ -715,7 +717,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_storybook.md

@@ -173,7 +173,13 @@ const config: StorybookConfig = {
     } as const;
 
     const viteConfig = defineConfig(() => ({
-      plugins: [intlayer()],
+      plugins: [
+        intlayer({
+          proxy: {
+            ignore: (req) => req.url?.startsWith("/api"),
+          },
+        }),
+      ],
     }));
 
     return mergeConfig(baseConfig, viteConfig(env));

package/docs/pl/intlayer_with_svelte_kit.md

@@ -597,14 +597,17 @@ Aby dodać backend proxy do swojej aplikacji SvelteKit, możesz użyć funkcji `
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 import { sveltekit } from "@sveltejs/kit/vite";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     sveltekit(),
   ],],
 });
@@ -702,6 +705,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"
@@ -711,7 +716,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_tanstack+solid.md

@@ -210,11 +210,15 @@ export default defineConfig({
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solidPlugin({ ssr: true }),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -550,22 +554,25 @@ Możesz również użyć `intlayerProxy`, aby dodać routing po stronie serwera
 
 > Zauważ, że aby korzystać z `intlayerProxy` w środowisku produkcyjnym, musisz przenieść pakiet `vite-intlayer` z `devDependencies` do `dependencies`.
 
-```typescript {7,14-17} fileName="vite.config.ts"
+```typescript fileName="vite.config.ts"
 import { tanstackStart } from "@tanstack/solid-start/plugin/vite";
 import solid from "vite-plugin-solid";
 import { nitro } from "nitro/vite";
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // Proxy powinno być umieszczone przed serwerem, jeśli używasz Nitro
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solid(),
@@ -808,6 +815,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 swoje `vite.config.ts`, aby dołączyć wtyczkę `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -823,12 +832,12 @@ export default defineConfig({
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solidPlugin({ ssr: true }),
     intlayer(),
-    intlayerCompiler(),
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/pl/intlayer_with_tanstack.md

@@ -224,11 +224,15 @@ import { intlayer } from "vite-intlayer";
 const config = defineConfig({
   plugins: [
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     viteReact(),
@@ -632,22 +636,25 @@ Możesz również użyć `intlayerProxy`, aby dodać routing po stronie serwera
 
 > Uwaga: aby używać `intlayerProxy` w produkcji, musisz przenieść pakiet `vite-intlayer` z `devDependencies` do `dependencies`.
 
-```typescript {7,14-17} fileName="vite.config.ts"
+```typescript fileName="vite.config.ts"
 import { tanstackStart } from "@tanstack/react-start/plugin/vite";
 import viteReact from "@vitejs/plugin-react";
 import { nitro } from "nitro/vite";
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // Proxy powinno być umieszczone przed serwerem, jeśli używasz Nitro
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     viteReact(),
@@ -908,6 +915,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"
@@ -917,7 +926,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+lit.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"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -457,7 +463,7 @@ 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: [intlayer(), intlayerProxy()],

package/docs/pl/intlayer_with_vite+preact.md

@@ -813,6 +813,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"
@@ -822,7 +824,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+react.md

@@ -498,14 +498,17 @@ Równolegle możesz również użyć `intlayerProxy`, aby dodać routing po stro
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     react(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -809,6 +812,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"
@@ -818,7 +823,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+react_compiler.md

@@ -213,11 +213,18 @@ Dodaj wtyczkę intlayer do swojej konfiguracji.
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [react(), intlayer(), intlayerCompiler()],
+  plugins: [
+    react(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/pl/intlayer_with_vite+solid.md

@@ -579,6 +579,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"
@@ -588,7 +590,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+svelte.md

@@ -442,7 +442,7 @@ Równolegle możesz również użyć `intlayerProxy`, aby dodać routing po stro
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { svelte } from "@sveltejs/vite-plugin-svelte";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
   plugins: [intlayerProxy(), // should be placed first
  svelte(), intlayer()],
@@ -552,6 +552,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"
@@ -561,7 +563,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+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`.