@intlayer/docs 9.4.0-canary.0 → 9.4.0

package/docs/pl/cli/watch.md

@@ -48,5 +48,3 @@ Ta komenda jest równoważna z `npx intlayer build --watch --skip-prepare`.
 - **`--with`**: Uruchom komendę równolegle z obserwacją.
 
   > Przykład: `npx intlayer watch --with "next dev --turbopack"`
-
-  > Przykład: `npx intlayer watch --with "next dev --turbopack"`

package/docs/pl/compiler.md

@@ -40,6 +40,12 @@ author: aymericzip
 
 ## Dlaczego warto używać Intlayer Compiler?
 
+- **Automation**: Eliminates manual copy-pasting of content into dictionaries.
+
+- **Speed**: Zoptymalizowana ekstrakcja treści zapewniająca szybki proces budowania.
+
+- **Developer Experience**: Trzymaj deklaracje zawartości tam, gdzie są używane, poprawiając łatwość utrzymania.
+
 - **Automatyzacja**: Eliminuje ręczne kopiowanie i wklejanie treści do słowników.
 - **Szybkość**: Optymalizowane wydobywanie treści zapewnia szybki proces budowania.
 - **Doświadczenie programisty**: Zachowaj deklaracje treści dokładnie tam, gdzie są używane, co poprawia utrzymanie kodu.
@@ -54,12 +60,16 @@ Chociaż kompilator oferuje doskonałe doświadczenie "działa od razu", wprowad
 - **Niejednoznaczność heurystyczna**: Kompilator musi zgadywać, co jest treścią skierowaną do użytkownika, a co logiką aplikacji (np. `className="active"`, kody statusu, ID produktów). W złożonych bazach kodu może to prowadzić do fałszywych pozytywów lub pominiętych ciągów znaków, które wymagają ręcznych adnotacji i wyjątków.
 - **Tylko statyczna ekstrakcja**: Ekstrakcja oparta na kompilatorze opiera się na analizie statycznej. Ciągi znaków, które istnieją tylko w czasie wykonywania (kody błędów API, pola CMS itp.), nie mogą być odkryte ani przetłumaczone przez sam kompilator, więc nadal potrzebujesz uzupełniającej strategii i18n czasu wykonywania.
 
+- **Ekstrakcja tylko statyczna**: Ekstrakcja oparta na kompilatorze polega na analizie statycznej. Ciągi znaków, które istnieją tylko w czasie wykonywania (kody błędów API, pola CMS itp.), nie mogą być odkryte ani przetłumaczone przez sam kompilator, dlatego nadal potrzebujesz dodatkowej strategii i18n w czasie wykonywania.
+
 Aby uzyskać głębsze porównanie architektoniczne, zobacz wpis na blogu [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/pl/compiler_vs_declarative_i18n.md).
 
 Jako alternatywę, aby zautomatyzować proces i18n przy zachowaniu pełnej kontroli nad treścią, Intlayer zapewnia również polecenie auto-ekstrakcji `intlayer extract` (zobacz [dokumentację CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/extract.md)) lub polecenie `Intlayer: extract content to Dictionary` z rozszerzenia Intlayer VS Code (zobacz [dokumentację rozszerzenia VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/vs_code_extension.md)).
 
 ## Użycie
 
+> Najszybszym sposobem na podłączenie compilera jest interaktywna konfiguracja: uruchom `npx intlayer init --interactive` i wybierz **Compiler**. Na Vite nie ma nic do konfiguracji — compiler jest podłączony bezpośrednio przez główny plugin `intlayer()` (aktywuje się automatycznie, gdy `compiler.enabled` jest ustawiony i ścieżka `compiler.output` jest skonfigurowana). Na Next.js polecenie generuje plik `babel.config.js` pokazany poniżej. Nieinteraktywne `intlayer init` pozostawia konfigurację compilera bez zmian.
+
 <Tabs>
  <Tab value='vite'>
 
@@ -92,12 +102,18 @@ export default defineConfig({
 });
 ```
 
+> Standalone plugin `intlayerCompiler()` jest nadal eksportowany dla zaawansowanych konfiguracji. Rejestrowanie go obok `intlayer()` jest bezpieczne — compiler deduplikuje się i uruchamia tylko raz.
+
 See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
 
 #### Wsparcie dla frameworków
 
 Wtyczka Vite automatycznie wykrywa i obsługuje różne typy plików:
 
+- **React / JSX / TSX**: Obsługiwane natywnie.
+
+- **Vue**: Wymaga `@intlayer/vue-compiler`.
+
 - **React / JSX / TSX**: Obsługiwane natywnie.
 - **Vue**: Wymaga `@intlayer/vue-compiler`.
 - **Svelte**: Wymaga `@intlayer/svelte-compiler`.

package/docs/pl/configuration.md

@@ -735,8 +735,6 @@ Definiuje ustawienia edytora wizualnego, w tym port serwera i status aktywacji.
 | `liveSyncPort`               | Port serwera Live Sync.                                                                                                                                                      | `number`                          | `4000`                              | `4000`                                                                                          |                                                                                                                                                                                                                                                 |
 | `liveSyncURL`                | URL serwera Live Sync.                                                                                                                                                       | `string`                          | `'http://localhost:{liveSyncPort}'` | `'https://example.com'`                                                                         | Domyślnie wskazuje na localhost; można zmienić na zdalny serwer Live Sync.                                                                                                                                                                      |
 
----
-
 ### Konfiguracja analityki (Analytics)
 
 Definiuje ustawienia związane z analityką Intlayer: zbieranie informacji o tym, jakie treści są faktycznie wyświetlane użytkownikom (odsłony strony, ekspozycje treści) oraz obsługę testów A/B treści.
@@ -988,6 +986,13 @@ Ustawienia związane ze ścieżkami wewnętrznymi i wynikami wyjściowymi Intlay
 
 Opcje kontrolujące operacje na słownikach, w tym zachowanie automatycznego uzupełniania i generowanie treści.
 
+Ta konfiguracja słownika służy dwóm głównym celom:
+
+1. **Wartości domyślne**: Zdefiniuj wartości domyślne podczas tworzenia plików deklaracji treści
+2. **Zachowanie awaryjne**: Podaj wartości awaryjne, gdy określone pola nie są zdefiniowane, co pozwala na globalnego zdefiniowania zachowania operacji słownika
+
+Aby uzyskać więcej informacji o plikach deklaracji zawartości i sposobie zastosowania wartości konfiguracji, zobacz [Dokumentację pliku zawartości](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/content_file.md).
+
 | Pole                        | Opis                                                                                                                                                                                | Typ                                                                                                             | Domyślnie    | Przykład                                                                                    | Uwagi                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `fill`                      | Kontroluje generowanie plików wyjściowych automatycznego uzupełniania (tłumaczenia AI).                                                                                             | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`       | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: Domyślna ścieżka (ten sam plik co źródło).<br/>• `false`: Wyłączone.<br/>• Wzorzec ciągu/funkcji pozwala na generowanie na poziomie lokali.<br/>• Obiekt na poziomie lokali: Każde locale ma własny wzorzec; `false` wyklucza locale.<br/>• Uwzględnienie `{{locale}}` pozwala na generowanie na poziomie lokali.<br/>• Ustawienie `fill` na poziomie słownika zawsze ma priorytet nad tym globalnym ustawieniem. |
@@ -1027,8 +1032,6 @@ Ustawienia dostosowywania wyjścia logów Intlayer.
 | `mode`   | Wskazuje tryb loggera.                      | `'default'` &#124; <br/> `'verbose'` &#124; <br/> `'disabled'` | `'default'`     | `'verbose'`        | • `'verbose'`: Zapisuje więcej informacji do debugowania.<br/>• `'disabled'`: Całkowicie wyłącza loggera. |
 | `prefix` | Prefiks dla wszystkich wiadomości w logach. | `string`                                                       | `'[intlayer] '` | `'[mój prefiks] '` |                                                                                                           |
 
----
-
 ### Konfiguracja AI (AI)
 
 Ustawienia do zarządzania funkcjami AI w Intlayer, w tym dostawca, model i klucz API.
@@ -1068,8 +1071,6 @@ Intlayer obsługuje szeroką gamę dostawców AI, aby zapewnić maksymalną elas
 | `baseURL`            | Bazowy URL dla API AI.                                                                                                               | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | Brak        | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Może wskazywać na lokalne lub własne punkty końcowe API AI.                                                                                                                                  |
 | `dataSerialization`  | Format serializacji danych dla funkcji AI.                                                                                           | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                                                       | `undefined` | `'toon'`                                                      | • `'json'`: domyślnie, niezawodne; zużywa więcej tokenów.<br/>• `'toon'`: mniej tokenów, mniej stabilne.<br/>• Przekazuje modelowi kontekst jako dodatkowy parametr (reasoning effort itp.). |
 
----
-
 ### Konfiguracja budowania (Build)
 
 Ustawienia kontrolujące sposób, w jaki Intlayer optymalizuje i kompiluje internacjonalizację aplikacji.
@@ -1107,8 +1108,6 @@ Kontroluje ustawienia kompilatora Intlayer, który kolekcjonuje słowniki bezpo
 | `noMetadata`          | Jeśli `true`, kompilator usuwa metadane słownika (klucz, content wrapper) z wyniku.                                                                                                                                                                                                                                     | `boolean`                                                                                                       | `false`     | `false` → `{"key":"my-key","content":{"key":"value"}}` <br/> `true` → `{"key":"value"}`                                                                  | • Przydatne dla formatów i18next lub ICU MessageFormat JSON na język.<br/>• Dobrze współpracuje z wtyczką `loadJSON`.                                                                                                                         |
 | `dictionaryKeyPrefix` | Prefiks klucza słownika                                                                                                                                                                                                                                                                                                 | `string`                                                                                                        | `''`        |                                                                                                                                                          | Dodaje opcjonalny prefiks do wyodrębnionych kluczy słownika                                                                                                                                                                                   |
 
----
-
 ### Własne schematy (Custom Schemas)
 
 | Pole      | Opis                                                                     | Typ                         |

package/docs/pl/custom_domains.md

@@ -138,6 +138,35 @@ getMultilingualUrls("/about", { currentDomain: "intlayer.org" });
 
 Te bezwzględne adresy URL są gotowe do użycia w tagach `<link rel="alternate" hreflang="...">` dla SEO.
 
+## Wnioskowanie typów
+
+`routing.domains` jest serializowany do wygenerowanego augmentacji modułu, więc
+`getLocalizedUrl` i `getLocalizedPath` zawężają swój typ zwracany do dokładnego
+URL-a, do którego rozwiązuje się locale kierowany domeną — wraz z supresją prefiksu.
+
+```ts
+// routing: { mode: 'prefix-no-default', domains: { en: 'intlayer.org', zh: 'intlayer.zh' } }
+
+getLocalizedUrl("/about", "zh");
+//     ^? "https://intlayer.zh/about" | "/about"
+
+getLocalizedPath("/about", "zh");
+//     ^? "/about"   (nigdy origin, i brak prefiksu /zh/)
+```
+
+Typ URL to **unia** dwóch wartości, które funkcja może zwrócić: bezwzględny URL na domenie locale'a i względny, który zwraca, gdy strona będąca renderowana już znajduje się na tej domenie. `getLocalizedPath` nie ma takiej niejednoznaczności — nigdy nie emituje origin — więc pozostaje pojedynczą literałem.
+
+Locale'a, które dzielą domenę, zachowują swój normalny prefiks również w typie:
+
+```ts
+getLocalizedUrl("/about", "fr");
+//     ^? "https://intlayer.org/fr/about" | "/fr/about"
+```
+
+> Regeneruj typy (`npx intlayer build`, lub dowolny dev server run) po
+> zmianie `routing.domains` — zawężenie pochodzi z wygenerowanego
+> `__RoutingRegistry`, a nie z samego pliku konfiguracyjnego.
+
 ## Zachowanie Proxy
 
 ### Next.js
@@ -170,6 +199,8 @@ GET intlayer.zh/about
 
 Plugin Vite `intlayerProxy` stosuje tę samą logikę podczas programowania:
 
+> Od wersji Intlayer v9, `intlayerProxy()` jest zawarty bezpośrednio w pluginie `intlayer()` i jest domyślnie włączony za pomocą opcji `routing.enableProxy` (`true` domyślnie). Rejestrowanie go osobno, jak pokazano poniżej, jest teraz opcjonalne — jest zachowywane dla kompatybilności wstecznej i dla konfiguracji, które muszą kontrolować kolejność pluginów. Ustaw `routing.enableProxy: false`, aby zrezygnować. Zobacz [notatki wydania v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/releases/v9.md).
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/pl/custom_url_rewrites.md

@@ -248,7 +248,7 @@ Aby zapewnić, że pasek adresu przeglądarki zawsze odzwierciedla „ładny”
 
 <Tabs group='framework'>
   <Tab label="Next.js" value="nextjs">
-  
+
     ```tsx
     'use client';
 
@@ -263,7 +263,7 @@ Aby zapewnić, że pasek adresu przeglądarki zawsze odzwierciedla „ładny”
   </Tab>
 
   <Tab label="React Router" value="reactrouter">
-  
+
     ```tsx
     'use client';
 
@@ -279,7 +279,7 @@ Aby zapewnić, że pasek adresu przeglądarki zawsze odzwierciedla „ładny”
   </Tab>
 
   <Tab label="Vue" value="vue">
-  
+
     ```vue
     <script setup>
     import { useRewriteURL } from "vue-intlayer";
@@ -291,7 +291,7 @@ Aby zapewnić, że pasek adresu przeglądarki zawsze odzwierciedla „ładny”
 
   </Tab>
   <Tab label="Solid" value="solid">
-  
+
     ```tsx
     import { useRewriteURL } from "solid-intlayer";
 
@@ -303,7 +303,7 @@ Aby zapewnić, że pasek adresu przeglądarki zawsze odzwierciedla „ładny”
 
   </Tab>
   <Tab label="Svelte" value="svelte">
-  
+
     ```svelte
     <script>
     import { useRewriteURL } from "svelte-intlayer";
@@ -340,6 +340,8 @@ export function middleware(request: NextRequest) {
 
 Dla SolidJS, Vue i Svelte wtyczka Vite `intlayerProxy` zarządza przepisywaniami (rewrites) podczas developmentu.
 
+> Od Intlayer v9, `intlayerProxy()` jest wbudowany bezpośrednio w plugin `intlayer()` i domyślnie włączony za pośrednictwem opcji `routing.enableProxy` (`true` domyślnie). Rejestrowanie go osobno, jak pokazano poniżej, jest teraz opcjonalne — jest utrzymywane ze względu na kompatybilność wsteczną i konfiguracje, które muszą kontrolować kolejność pluginów. Ustaw `routing.enableProxy: false`, aby zrezygnować. Przeczytaj [informacje o wydaniu v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/releases/v9.md).
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/pl/dictionary/file.md

@@ -29,174 +29,8 @@ W Intlayer funkcja `file` pozwala na osadzenie zawartości zewnętrznego pliku w
 
 ## Dlaczego używać `file` zamiast `import`, `require` lub `fs`?
 
-<Tabs group="framework">
-  <Tab label="React" value="react">
-
-To use embedded file content in a React component, import and use the `useIntlayer` hook from the `react-intlayer` package. This retrieves the content from the specified key and allows it to be displayed dynamically.
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const FileComponent: FC = () => {
-  const { myFile } = useIntlayer("my_key");
-
-  return (
-    <div>
-      <pre>{myFile}</pre>
-    </div>
-  );
-};
-
-export default FileComponent;
-```
-
-  </Tab>
-  <Tab label="Next.js" value="nextjs">
-
 To use embedded file content in Next.js Client Components, retrieve it via the `useIntlayer` hook. Here's an example:
 
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-"use client";
-
-import type { FC } from "react";
-import { useIntlayer } from "next-intlayer";
-
-const FileComponent: FC = () => {
-  const { myFile } = useIntlayer("my_key");
-
-  return (
-    <div>
-      <pre>{myFile}</pre>
-    </div>
-  );
-};
-
-export default FileComponent;
-```
-
-  </Tab>
-  <Tab label="Vue" value="vue">
-
-To use embedded file content in Vue components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```vue fileName="**/*.vue"
-<script setup lang="ts">
-import { useIntlayer } from "vue-intlayer";
-
-const { myFile } = useIntlayer("my_key");
-</script>
-
-<template>
-  <div>
-    <pre>{{ myFile }}</pre>
-  </div>
-</template>
-```
-
-  </Tab>
-  <Tab label="Svelte" value="svelte">
-
-To use embedded file content in Svelte components, retrieve it via the `useIntlayer` hook. The store is accessed with `$`. Here's an example:
-
-```svelte fileName="**/*.svelte"
-<script lang="ts">
-import { useIntlayer } from "svelte-intlayer";
-
-const content = useIntlayer("my_key");
-</script>
-
-<div>
-  <pre>{$content.myFile}</pre>
-</div>
-```
-
-  </Tab>
-  <Tab label="Preact" value="preact">
-
-To use embedded file content in Preact components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "preact";
-import { useIntlayer } from "preact-intlayer";
-
-const FileComponent: FC = () => {
-  const { myFile } = useIntlayer("my_key");
-
-  return (
-    <div>
-      <pre>{myFile}</pre>
-    </div>
-  );
-};
-
-export default FileComponent;
-```
-
-  </Tab>
-  <Tab label="Solid" value="solid">
-
-To use embedded file content in SolidJS components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { Component } from "solid-js";
-import { useIntlayer } from "solid-intlayer";
-
-const FileComponent: Component = () => {
-  const { myFile } = useIntlayer("my_key");
-
-  return (
-    <div>
-      <pre>{myFile}</pre>
-    </div>
-  );
-};
-
-export default FileComponent;
-```
-
-  </Tab>
-  <Tab label="Angular" value="angular">
-
-To use embedded file content in Angular components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```typescript fileName="app.component.ts" codeFormat="typescript"
-import { Component } from "@angular/core";
-import { useIntlayer } from "angular-intlayer";
-
-@Component({
-  selector: "app-file",
-  template: `
-    <div>
-      <pre>{{ content().myFile }}</pre>
-    </div>
-  `,
-})
-export class FileComponent {
-  content = useIntlayer("my_key");
-}
-```
-
-  </Tab>
-  <Tab label="Vanilla JS" value="vanilla">
-
-To use embedded file content with `vanilla-intlayer`, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```typescript fileName="**/*.ts" codeFormat={["typescript", "esm"]}
-import { installIntlayer, useIntlayer } from "vanilla-intlayer";
-
-installIntlayer();
-
-const content = useIntlayer("my_key").onChange((newContent) => {
-  document.getElementById("file-content")!.textContent = newContent.myFile;
-});
-
-// Initial render
-document.getElementById("file-content")!.textContent = content.myFile;
-```
-
-  </Tab>
-</Tabs>
 ## Konfiguracja zawartości pliku
 
 Aby osadzić zawartość pliku w projekcie Intlayer, użyj funkcji `file` w module zawartości. Poniżej znajdują się przykłady różnych implementacji.

package/docs/pl/dictionary/gender.md

@@ -294,6 +294,4 @@ Aby uzyskać bardziej szczegółowe informacje na temat konfiguracji i użytkowa
 - [Dokumentacja React Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_create_react_app.md)
 - [Dokumentacja Next Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_nextjs_15.md)
 
-Te zasoby oferują dodatkowe informacje na temat konfiguracji i użytkowania Intlayer w różnych środowiskach i frameworkach.
-
 Te zasoby oferują dodatkowe informacje na temat konfiguracji i użytkowania Intlayer w różnych środowiskach i ramach pracy.

package/docs/pl/dictionary/html.md

@@ -248,7 +248,7 @@ Możesz skonfigurować renderowanie HTML globalnie dla całej aplikacji. To idea
 
 <Tabs group="framework">
   <Tab label="React / Next.js" value="react">
-  
+
     ```tsx fileName="AppProvider.tsx"
     import { HTMLProvider } from "react-intlayer/html";
 
@@ -285,7 +285,7 @@ Możesz skonfigurować renderowanie HTML globalnie dla całej aplikacji. To idea
 
   </Tab>
   <Tab label="Vue" value="vue">
-  
+
     ```typescript fileName="main.ts"
     import { createApp, h } from "vue";
     import { intlayer } from "vue-intlayer";
@@ -330,7 +330,7 @@ Możesz skonfigurować renderowanie HTML globalnie dla całej aplikacji. To idea
 
   </Tab>
   <Tab label="Svelte" value="svelte">
-   
+
     ```svelte fileName="App.svelte"
     <script lang="ts">
       import { HTMLProvider } from "svelte-intlayer/html";
@@ -367,7 +367,7 @@ Możesz skonfigurować renderowanie HTML globalnie dla całej aplikacji. To idea
 
   </Tab>
   <Tab label="Preact" value="preact">
-   
+
     ```tsx fileName="AppProvider.tsx"
     import { HTMLProvider } from "preact-intlayer/html";
 
@@ -403,7 +403,7 @@ Możesz skonfigurować renderowanie HTML globalnie dla całej aplikacji. To idea
 
   </Tab>
   <Tab label="Solid" value="solid">
-   
+
     ```tsx fileName="AppProvider.tsx"
     import { HTMLProvider } from "solid-intlayer/html";
 
@@ -463,9 +463,9 @@ Możesz skonfigurować renderowanie HTML globalnie dla całej aplikacji. To idea
     export const appConfig: ApplicationConfig = {
       providers: [
         createIntlayerHTMLProvider({
-          renderMarkdown: async (html) => {
-            const { renderMarkdown } = await import('angular-intlayer/html');
-            return renderMarkdown(html);
+          renderHTML: async (html) => {
+            const { renderHTML } = await import('angular-intlayer/html');
+            return renderHTML(html);
           },
         }),
       ],
@@ -522,9 +522,9 @@ Jeśli musisz renderować surowe łańcuchy HTML lub potrzebujesz większej kont
 
   </Tab>
   <Tab label="Vue" value="vue">
-   
+
     #### Komponent `<HTMLRenderer />`
-   
+
     ```vue
     <script setup>
     import { HTMLRenderer } from "vue-intlayer/html";
@@ -537,9 +537,9 @@ Jeśli musisz renderować surowe łańcuchy HTML lub potrzebujesz większej kont
 
   </Tab>
   <Tab label="Svelte" value="svelte">
-  
+
     #### Komponent `<HTMLRenderer />`
-   
+
     ```svelte
     <script lang="ts">
     import { HTMLRenderer } from "svelte-intlayer/html";
@@ -571,9 +571,9 @@ Jeśli musisz renderować surowe łańcuchy HTML lub potrzebujesz większej kont
 
   </Tab>
   <Tab label="Preact" value="preact">
-   
+
     #### Komponent `<HTMLRenderer />`
-   
+
     ```tsx
     import { HTMLRenderer } from "preact-intlayer/html";
 
@@ -602,9 +602,9 @@ Jeśli musisz renderować surowe łańcuchy HTML lub potrzebujesz większej kont
 
   </Tab>
   <Tab label="Solid" value="solid">
-   
+
     #### Komponent `<HTMLRenderer />`
-   
+
     ```tsx
     import { HTMLRenderer } from "solid-intlayer/html";
 
@@ -637,13 +637,13 @@ Jeśli musisz renderować surowe łańcuchy HTML lub potrzebujesz większej kont
     Renderuje ciąg HTML przy użyciu usługi.
 
     ```typescript
-    import { IntlayerHTMLService } from "angular-intlayer";
+    import { IntlayerHTMLService } from "angular-intlayer/html";
 
     export class MyComponent {
       constructor(private markdownService: IntlayerHTMLService) {}
 
       renderHTML(html: string) {
-        return this.markdownService.renderMarkdown(html);
+        return this.markdownService.renderHTML(html);
       }
     }
     ```

package/docs/pl/dictionary/insertion.md

@@ -98,20 +98,6 @@ Aby skonfigurować treść wstawiania w swoim projekcie Intlayer, utwórz moduł
   </Tab>
 </Tabs>
 
-```json5 fileName="**/*.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "my_key",
-  "content": {
-    "myInsertion": {
-      "nodeType": "insertion",
-      "insertion": "Cześć, mam na imię {{name}} i mam {{age}} lat!",
-    },
-    "myInsertion2": "Cześć, mam na imię {{name}} i mam {{age}} lat!", // Since intlayer v8, insertion function is not required anymore. The content will be automatically decorated.
-  },
-}
-```
-
 ## Używanie treści wstawianej z React Intlayer
 
 Aby wykorzystać zawartość wstawki w komponencie React, zaimportuj i użyj hooka `useIntlayer` z pakietu `react-intlayer`. Ten hook pobiera zawartość dla określonego klucza i pozwala przekazać obiekt, który mapuje każde miejsce na wartość, którą chcesz wyświetlić.

package/docs/pl/dictionary/markdown.md

@@ -492,7 +492,7 @@ Te narzędzia renderują **tylko surowe ciągi znaków Markdown** i są niezale
 
 <Tabs group="framework">
   <Tab label="React" value="react">
-  
+
     #### Komponent `<MarkdownRenderer />`
 
     Renderuje ciąg znaków Markdown z określonymi opcjami.
@@ -531,7 +531,7 @@ Te narzędzia renderują **tylko surowe ciągi znaków Markdown** i są niezale
 
   </Tab>
   <Tab label="Next.js" value="nextjs">
-  
+
     #### Komponent `<MarkdownRenderer />`
 
     Renderuje ciąg znaków Markdown z określonymi opcjami.
@@ -957,21 +957,38 @@ Te narzędzia renderują **tylko surowe ciągi znaków Markdown** i są niezale
   </Tab>
   <Tab label="Angular" value="angular">
 
-    ```typescript fileName="app.module.ts"
-    import { NgModule } from '@angular/core';
-    import { IntlayerMarkdownModule } from 'angular-intlayer/markdown';
+    ```typescript fileName="app.config.ts"
+    import { createIntlayerMarkdownProvider } from "angular-intlayer/markdown";
+
+    export const appConfig: ApplicationConfig = {
+      providers: [
+        createIntlayerMarkdownProvider({
+          components: {
+            h1: { class: "text-2xl font-bold" },
+          },
+        }),
+      ],
+    };
+    ```
+
+
+    > MDX jest obsługiwany — każda nazwa komponentu użyta wewnątrz twojego Markdown (np. `<MyCustomJSXComponent />`) jest rozwiązywana względem mapy `components`.
+
+    Możesz również użyć własnego renderera markdown:
+
+    ```typescript fileName="app.config.ts"
+    import { createIntlayerMarkdownProvider } from "angular-intlayer/markdown";
 
-    @NgModule({
-      imports: [
-        IntlayerMarkdownModule.forRoot({
+    export const appConfig: ApplicationConfig = {
+      providers: [
+        createIntlayerMarkdownProvider({
           renderMarkdown: async (md) => {
             const { renderMarkdown } = await import('angular-intlayer/markdown');
             return renderMarkdown(md);
-          }
-        })
-      ]
-    })
-    export class AppModule {}
+          },
+        }),
+      ],
+    };
     ```
 
     > Dynamiczne importowanie twojego renderera Markdown to świetny sposób na zmniejszenie rozmiaru pakietu twojej aplikacji.
@@ -1047,7 +1064,7 @@ const MyComponent = () => {
 ```
 
   </Tab>
- 
+
   <Tab label="Vue" value="vue">
 
 Vue ma wbudowany komponent `<Suspense>`. Zawiń komponent renderujący zawartość Markdown w granicę `<Suspense>`.