@intlayer/docs 9.3.3 → 9.4.0

package/docs/pl/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-08-06
+updatedAt: 2026-08-22
 title: Konfiguracja
 description: Dowiedz się, jak skonfigurować Intlayer dla swojej aplikacji. Zrozum różne ustawienia i opcje dostępne do dostosowania Intlayer do Twoich potrzeb.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "Domyślne włączenie analityki, gdy zainstalowano `@intlayer/analytics`"
   - version: 9.1.3
     date: 2026-08-06
     changes: "Uczynienie `routing.enableProxy` trójstanowym: nieustawione (auto), `true`, `false`"
@@ -380,8 +383,8 @@ const config: IntlayerConfig = {
   analytics: {
     /**
      * Czy zbieranie danych analitycznych jest włączone (odsłony strony, ekspozycje treści, zdarzenia A/B).
-     * Wymaga ustawienia `editor.clientId` na potrzeby atrybucji.
-     * Domyślnie: false
+     * Wymaga zainstalowanego pakietu `@intlayer/analytics` oraz ustawienia `editor.clientId` na potrzeby atrybucji.
+     * Domyślnie: true
      */
     enabled: true,
 
@@ -732,19 +735,17 @@ 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.
 
-Analityka jest ściśle opt-in: nic nie jest zbierane, dopóki `analytics.enabled` nie zostanie jawnie ustawione na `true` **i** nie skonfigurowano klucza projektu (`editor.clientId`) na potrzeby atrybucji. Gdy jest wyłączona (domyślnie), cała integracja analityczna jest usuwana z pakietu aplikacji (dead-code elimination).
+Analityka działa na zasadzie opt-out: jest włączona domyślnie i zaczyna zbierać dane, gdy tylko pakiet `@intlayer/analytics` jest zainstalowany **i** skonfigurowano klucz projektu (`editor.clientId`) na potrzeby atrybucji. Ustaw `analytics.enabled` na `false` — albo nie instaluj pakietu — a cała integracja analityczna zostanie usunięta z pakietu aplikacji (dead-code elimination).
 
-| Pole            | Opis                                                                                      | Typ       | Domyślnie | Przykład | Uwaga                                                                                                                                             |
-| --------------- | ----------------------------------------------------------------------------------------- | --------- | --------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `enabled`       | Włącza zbieranie danych analitycznych (odsłony strony, ekspozycje treści, zdarzenia A/B). | `boolean` | `false`   | `true`   | Wymaga ustawienia `editor.clientId` na potrzeby atrybucji; w przeciwnym razie analityka pozostaje wyłączona, nawet jeśli `enabled` wynosi `true`. |
-| `flushInterval` | Milisekundy między automatycznymi zbiorczymi wysyłkami do backendu.                       | `number`  | `20000`   | `10000`  |                                                                                                                                                   |
-| `sampleRate`    | Ułamek sesji do rejestrowania, od `0` (brak) do `1` (wszystkie).                          | `number`  | `1`       | `0.5`    | Próbkowanie jest deterministyczne dla sesji, więc zarejestrowana sesja raportuje wszystkie swoje zdarzenia (bez częściowych lejków).              |
+| Pole            | Opis                                                                                      | Typ       | Domyślnie | Przykład | Uwaga                                                                                                                                                                                                |
+| --------------- | ----------------------------------------------------------------------------------------- | --------- | --------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Włącza zbieranie danych analitycznych (odsłony strony, ekspozycje treści, zdarzenia A/B). | `boolean` | `true`    | `false`  | Wymaga zainstalowanego pakietu `@intlayer/analytics` oraz ustawienia `editor.clientId` na potrzeby atrybucji; w przeciwnym razie analityka pozostaje wyłączona, nawet jeśli `enabled` wynosi `true`. |
+| `flushInterval` | Milisekundy między automatycznymi zbiorczymi wysyłkami do backendu.                       | `number`  | `20000`   | `10000`  |                                                                                                                                                                                                      |
+| `sampleRate`    | Ułamek sesji do rejestrowania, od `0` (brak) do `1` (wszystkie).                          | `number`  | `1`       | `0.5`    | Próbkowanie jest deterministyczne dla sesji, więc zarejestrowana sesja raportuje wszystkie swoje zdarzenia (bez częściowych lejków).                                                                 |
 
 ---
 
@@ -985,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. |
@@ -1024,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.
@@ -1065,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.
@@ -1104,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>`.