@intlayer/docs 8.4.10 → 8.5.1

package/docs/pl/intlayer_with_vite+vue.md

@@ -454,14 +454,14 @@ Aby wykorzystać funkcje internacjonalizacji Intlayer w całej aplikacji Vue, na
 
 ```javascript fileName=main.js
 import { createApp } from "vue";
-import { installIntlayer } from "vue-intlayer";
+import { intlayer } from "vue-intlayer";
 import App from "./App.vue";
 import "./style.css";
 
 const app = createApp(App);
 
 // Wstrzyknij providera na najwyższym poziomie
-installIntlayer(app);
+app.use(intlayer);
 
 // Zamontuj aplikację
 app.mount("#app");
@@ -642,7 +642,7 @@ import {
   localeFlatMap,
   type Locale,
 } from 'intlayer';
-import { createIntlayerClient } from 'vue-intlayer';
+import { createIntlayerClient } from "vue-intlayer";
 import { createRouter, createWebHistory } from 'vue-router';
 import HomeView from './views/home/HomeView.vue';
 import RootView from './views/root/Root.vue';
@@ -732,7 +732,11 @@ import { intlayer, intlayerProxy } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [vue(), intlayer(), intlayerProxy()],
+  plugins: [
+    intlayerProxy(), // should be placed first
+    vue(),
+    intlayer(),
+  ],
 });
 ```
 
@@ -743,7 +747,11 @@ import { intlayer, intlayerProxy } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [vue(), intlayer(), intlayerProxy()],
+  plugins: [
+    intlayerProxy(), // should be placed first
+    vue(),
+    intlayer(),
+  ],
 });
 ```
 
@@ -754,7 +762,11 @@ const { intlayer, intlayerProxy } = require("vite-intlayer");
 
 // https://vitejs.dev/config/
 module.exports = defineConfig({
-  plugins: [vue(), intlayer(), intlayerProxy()],
+  plugins: [
+    intlayerProxy(), // should be placed first
+    vue(),
+    intlayer(),
+  ],
 });
 ```
 
@@ -1024,7 +1036,7 @@ import { installIntlayer, installIntlayerMarkdown } from "vue-intlayer";
 
 const app = createApp(App);
 
-installIntlayer(app);
+app.use(intlayer);
 
 const md = new MarkdownIt({
   html: true, // zezwól na tagi HTML

package/docs/pl/packages/react-intlayer/MarkdownRenderer.md

@@ -28,7 +28,7 @@ Komponent `MarkdownRenderer` renderuje zawartość Markdown przy użyciu niestan
 ## Użycie
 
 ```tsx
-import { MarkdownRenderer } from "react-intlayer";
+import { MarkdownRenderer } from "react-intlayer/markdown";
 
 const MyComponent = () => (
   <MarkdownRenderer># My Title My content</MarkdownRenderer>

package/docs/pl/packages/svelte-intlayer/useRewriteURL.md

@@ -29,7 +29,7 @@ Wywołaj hook wewnątrz komponentu Svelte.
 
 ```svelte
 <script>
-  import { useRewriteURL } from 'svelte-intlayer';
+  import { useRewriteURL } from "svelte-intlayer";
 
   // Automatycznie poprawia /fr/tests na /fr/essais w pasku adresu, jeśli istnieje reguła przepisywania
   useRewriteURL();

package/docs/pl/releases/v8.md

@@ -69,7 +69,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **1. Użycie komponentu:**
 
     ```tsx
-    import { MarkdownRenderer } from "react-intlayer";
+    import { MarkdownRenderer } from "react-intlayer/markdown";
 
     <MarkdownRenderer
       forceBlock={true}
@@ -84,7 +84,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **2. Użycie hooka:**
 
     ```tsx
-    import { useMarkdownRenderer } from "react-intlayer";
+    import { useMarkdownRenderer } from "react-intlayer/markdown";
 
     const renderMarkdown = useMarkdownRenderer({
       components: {
@@ -98,7 +98,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **3. Użycie funkcji narzędziowej:**
 
     ```tsx
-    import { renderMarkdown } from "react-intlayer";
+    import { renderMarkdown } from "react-intlayer/markdown";
 
     const html = renderMarkdown("# Mój Tytuł", {
       forceBlock: true
@@ -112,7 +112,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
 
     ```vue
     <script setup>
-    import { MarkdownRenderer } from "vue-intlayer";
+    import { MarkdownRenderer } from "vue-intlayer/markdown";
     </script>
 
     <template>
@@ -127,7 +127,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
 
     ```svelte
     <script>
-      import { MarkdownRenderer } from "svelte-intlayer";
+      import { MarkdownRenderer } from "svelte-intlayer/markdown";
     </script>
 
     <MarkdownRenderer forceBlock={true} value="# Mój Tytuł" />
@@ -137,7 +137,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
 
     ```svelte
     <script>
-      import { useMarkdownRenderer } from "svelte-intlayer";
+      import { useMarkdownRenderer } from "svelte-intlayer/markdown";
       const render = useMarkdownRenderer();
     </script>
 
@@ -148,7 +148,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
 
     ```svelte
     <script>
-      import { renderMarkdown } from "svelte-intlayer";
+      import { renderMarkdown } from "svelte-intlayer/markdown";
     </script>
 
     {@html renderMarkdown("# Mój Tytuł")}
@@ -179,7 +179,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **1. Użycie komponentu:**
 
     ```tsx
-    import { MarkdownRenderer } from "solid-intlayer";
+    import { MarkdownRenderer } from "solid-intlayer/markdown";
 
     <MarkdownRenderer forceBlock={true}>
       {"# Mój Tytuł"}
@@ -189,7 +189,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **2. Użycie hooka:**
 
     ```tsx
-    import { useMarkdownRenderer } from "solid-intlayer";
+    import { useMarkdownRenderer } from "solid-intlayer/markdown";
 
     const render = useMarkdownRenderer();
 
@@ -199,7 +199,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **3. Użycie funkcji narzędziowej:**
 
     ```tsx
-    import { renderMarkdown } from "solid-intlayer";
+    import { renderMarkdown } from "solid-intlayer/markdown";
 
     return <div>{renderMarkdown("# Mój Tytuł")}</div>;
     ```
@@ -210,7 +210,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **1. Użycie komponentu:**
 
     ```tsx
-    import { MarkdownRenderer } from "preact-intlayer";
+    import { MarkdownRenderer } from "preact-intlayer/markdown";
 
     <MarkdownRenderer forceBlock={true}>
       {"# Mój Tytuł"}
@@ -220,7 +220,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **2. Użycie hooka:**
 
     ```tsx
-    import { useMarkdownRenderer } from "preact-intlayer";
+    import { useMarkdownRenderer } from "preact-intlayer/markdown";
 
     const render = useMarkdownRenderer();
 
@@ -230,7 +230,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **3. Użycie funkcji narzędziowej:**
 
     ```tsx
-    import { renderMarkdown } from "preact-intlayer";
+    import { renderMarkdown } from "preact-intlayer/markdown";
 
     return <div>{renderMarkdown("# Mój Tytuł")}</div>;
     ```
@@ -246,7 +246,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **1. Użycie komponentu:**
 
     ```tsx
-    import { HTMLRenderer } from "react-intlayer";
+    import { HTMLRenderer } from "react-intlayer/html";
 
     <HTMLRenderer
       components={{
@@ -260,7 +260,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **2. Użycie hooka:**
 
     ```tsx
-    import { useHTMLRenderer } from "react-intlayer";
+    import { useHTMLRenderer } from "react-intlayer/html";
 
     const renderHTML = useHTMLRenderer({
       components: {
@@ -274,7 +274,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **3. Użycie funkcji narzędziowej:**
 
     ```tsx
-    import { renderHTML } from "react-intlayer";
+    import { renderHTML } from "react-intlayer/html";
 
     const html = renderHTML("<p>Witaj świecie</p>");
     ```
@@ -286,7 +286,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
 
     ```vue
     <script setup>
-    import { HTMLRenderer } from "vue-intlayer";
+    import { HTMLRenderer } from "vue-intlayer/html";
     </script>
 
     <template>
@@ -301,7 +301,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
 
     ```svelte
     <script>
-      import { HTMLRenderer } from "svelte-intlayer";
+      import { HTMLRenderer } from "svelte-intlayer/html";
     </script>
 
     <HTMLRenderer value="<p>Witaj świecie</p>" />
@@ -311,7 +311,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
 
     ```svelte
     <script>
-      import { useHTMLRenderer } from "svelte-intlayer";
+      import { useHTMLRenderer } from "svelte-intlayer/html";
       const render = useHTMLRenderer();
     </script>
 
@@ -322,7 +322,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
 
     ```svelte
     <script>
-      import { renderHTML } from "svelte-intlayer";
+      import { renderHTML } from "svelte-intlayer/html";
     </script>
 
     {@html renderHTML("<p>Witaj świecie</p>")}
@@ -345,7 +345,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **1. Użycie komponentu:**
 
     ```tsx
-    import { HTMLRenderer } from "solid-intlayer";
+    import { HTMLRenderer } from "solid-intlayer/html";
 
     <HTMLRenderer>
       {"<p>Witaj świecie</p>"}
@@ -355,7 +355,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **2. Użycie hooka:**
 
     ```tsx
-    import { useHTMLRenderer } from "solid-intlayer";
+    import { useHTMLRenderer } from "solid-intlayer/html";
 
     const render = useHTMLRenderer();
 
@@ -365,7 +365,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **3. Użycie funkcji narzędziowej:**
 
     ```tsx
-    import { renderHTML } from "solid-intlayer";
+    import { renderHTML } from "solid-intlayer/html";
 
     return <div>{renderHTML("<p>Witaj świecie</p>")}</div>;
     ```
@@ -376,7 +376,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **1. Użycie komponentu:**
 
     ```tsx
-    import { HTMLRenderer } from "preact-intlayer";
+    import { HTMLRenderer } from "preact-intlayer/html";
 
     <HTMLRenderer>
       {"<p>Witaj świecie</p>"}
@@ -386,7 +386,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **2. Użycie hooka:**
 
     ```tsx
-    import { useHTMLRenderer } from "preact-intlayer";
+    import { useHTMLRenderer } from "preact-intlayer/html";
 
     const render = useHTMLRenderer();
 
@@ -396,7 +396,7 @@ Wprowadziliśmy nowe, samodzielne funkcje renderujące i komponenty, aby dać Ci
     **3. Użycie funkcji narzędziowej:**
 
     ```tsx
-    import { renderHTML } from "preact-intlayer";
+    import { renderHTML } from "preact-intlayer/html";
 
     return <div>{renderHTML("<p>Witaj świecie</p>")}</div>;
     ```
@@ -1032,7 +1032,7 @@ Intlayer v8 zawiera nową warstwę cache'owania dla kompilatora Markdown i HTML.
    
     ```typescript fileName="vite.config.js"
     import { defineConfig } from 'vite';
-    import {intlayer, intlayerCompiler} from 'vite-intlayer';
+    import { intlayer, intlayerCompiler } from "vite-intlayer";
 
     export default defineConfig({
       plugins: [intlayer(), intlayerCompiler()],

package/docs/pt/compiler.md

@@ -207,8 +207,11 @@ const config: IntlayerConfig = {
     output: ({ fileName, extension }) => `./${fileName}${extension}`,
 
     /**
-     * Indica se os componentes devem ser salvos após serem transformados.
-     * Dessa forma, o compilador pode ser executado apenas uma vez para transformar o app e depois removido.
+     * Se deve guardar as componentes após serem transformadas.
+     *
+     * - Se `true`, o compilador reescreverá o arquivo do componente no disco. Portanto, a transformação será permanente, e o compilador pulará a transformação para o próximo processo. Dessa forma, o compilador pode transformar o app, e então pode ser removido.
+     *
+     * - Se `false`, o compilador injetará a chamada da função `useIntlayer()` no código apenas na saída da build, e manterá a base de código original intacta. A transformação será feita apenas em memória.
      */
     saveComponents: false,
 
@@ -287,6 +290,8 @@ As seguintes propriedades podem ser configuradas no bloco `compiler` do seu arqu
   - _Tipo_: `boolean`
   - _Padrão_: `false`
   - _Descrição_: Indica se os componentes devem ser salvos após serem transformados.
+    - Se `true`, o compilador reescreverá o arquivo do componente no disco. A transformação será permanente, e o compilador poderá ser removido.
+    - Se `false`, o compilador injetará a chamada da função `useIntlayer()` no código apenas na saída da build, mantendo a base de código original intacta. A transformação será feita apenas em memória.
 
 ### Preencher traduções ausentes
 

package/docs/pt/configuration.md

@@ -518,7 +518,10 @@ const config: IntlayerConfig = {
 
     /**
      * Se deve guardar as componentes após serem transformadas.
-     * Desta forma, o compilador pode ser executado apenas uma vez para transformar a app e depois ser removido.
+     *
+     * - Se `true`, o compilador reescreverá o arquivo do componente no disco. Portanto, a transformação será permanente, e o compilador pulará a transformação para o próximo processo. Dessa forma, o compilador pode transformar o app, e então pode ser removido.
+     *
+     * - Se `false`, o compilador injetará a chamada da função `useIntlayer()` no código apenas na saída da build, e manterá a base de código original intacta. A transformação será feita apenas em memória.
      */
     saveComponents: false,
 
@@ -932,14 +935,13 @@ Estas definições são para casos de uso avançados e configuração interna do
 
 Configurações que controlam o compilador do Intlayer, que extrai dicionários diretamente das suas componentes.
 
-| Campo                 | Descrição                                                                                                                                                                                                                                                                                                                    | Tipo                                                                                                            | Padrão      | Exemplo                                                                                                                                                  | Nota                                                                                                                                                                                                   |
-| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `enabled`             | Indica se o compilador deve estar ativado para a extração de dicionários.                                                                                                                                                                                                                                                    | `boolean` &#124; <br/> `'build-only'`                                                                           | `true`      | `'build-only'`                                                                                                                                           | `'build-only'` ignora o compilador durante o desenvolvimento para acelerar as builds; executado apenas nos comandos de build.                                                                          |
-| `dictionaryKeyPrefix` | Prefixo para as chaves de dicionário extraídas.                                                                                                                                                                                                                                                                              | `string`                                                                                                        | `''`        | `'meu-prefixo-'`                                                                                                                                         | Adicionado à chave gerada (baseada no nome do ficheiro) para evitar conflitos.                                                                                                                         |
-| `saveComponents`      | Se deve guardar as componentes após serem transformadas.                                                                                                                                                                                                                                                                     | `boolean`                                                                                                       | `false`     |                                                                                                                                                          | • Se `true`, substitui os ficheiros originais pelas versões transformadas.<br/>• O compilador pode ser removido após uma execução.                                                                     |
-| `output`              | Define o caminho para os ficheiros de saída. Substitui `outputDir`. Suporta variáveis de template: `{{fileName}}`, <br/> `{{key}}`, <br/> `{{locale}}`, <br/> `{{extension}}`, <br/> `{{componentFileName}}`, <br/> `{{componentExtension}}`, <br/> `{{format}}`, <br/> `{{componentFormat}}`, <br/> `{{componentDirPath}}`. | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `undefined` | `'./{{fileName}}{{extension}}'` <br/> `'/locales/{{locale}}/{{key}}.json'` <br/> `{ en: ({ key }) => './locales/en/${key}.json', fr: '...', es: false }` | • Caminhos `./` são resolvidos em relação ao diretório da componente.<br/>• Caminhos `/` em relação à raiz.<br/>• `{{locale}}` ativa a geração por idioma.<br/>• Suporta notação de objeto por idioma. |
-| `noMetadata`          | Se `true`, o compilador omite os metadados do dicionário (chave, wrapper de conteúdo) da saída.                                                                                                                                                                                                                              | `boolean`                                                                                                       | `false`     | `false` → `{"key":"minha-chave","content":{"key":"valor"}}` <br/> `true` → `{"key":"valor"}`                                                             | • Útil para saídas i18next ou ICU MessageFormat JSON.<br/>• Funciona bem com o plugin `loadJSON`.                                                                                                      |
-| `dictionaryKeyPrefix` | Prefixo da chave do dicionário                                                                                                                                                                                                                                                                                               | `string`                                                                                                        | `''`        |                                                                                                                                                          | Adicionar prefixo opcional para as chaves de dicionário extraídas                                                                                                                                      |
+| Campo                 | Descrição                                                                                                                                                                                                                                                                                                                    | Tipo                                                                                                            | Padrão      | Exemplo                                                                                                                                                  | Nota                                                                                                                                                                                                                                                                                                     |
+| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`             | Indica se o compilador deve estar ativado para a extração de dicionários.                                                                                                                                                                                                                                                    | `boolean` &#124; <br/> `'build-only'`                                                                           | `true`      | `'build-only'`                                                                                                                                           | `'build-only'` ignora o compilador durante o desenvolvimento para acelerar as builds; executado apenas nos comandos de build.                                                                                                                                                                            |
+| `dictionaryKeyPrefix` | Prefixo para as chaves de dicionário extraídas.                                                                                                                                                                                                                                                                              | `string`                                                                                                        | `''`        | `'meu-prefixo-'`                                                                                                                                         | Adicionado à chave gerada (baseada no nome do ficheiro) para evitar conflitos.                                                                                                                                                                                                                           |
+| `saveComponents`      | Indica se os componentes devem ser salvos após serem transformados.                                                                                                                                                                                                                                                          | `boolean`                                                                                                       | `false`     |                                                                                                                                                          | • Se `true`, o compilador reescreverá o arquivo do componente no disco. A transformação será permanente, e o compilador poderá ser removido.<br/>• Se `false`, o compilador injetará a chamada da função `useIntlayer()` no código apenas na saída da build, mantendo a base de código original intacta. |
+| `output`              | Define o caminho para os ficheiros de saída. Substitui `outputDir`. Suporta variáveis de template: `{{fileName}}`, <br/> `{{key}}`, <br/> `{{locale}}`, <br/> `{{extension}}`, <br/> `{{componentFileName}}`, <br/> `{{componentExtension}}`, <br/> `{{format}}`, <br/> `{{componentFormat}}`, <br/> `{{componentDirPath}}`. | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `undefined` | `'./{{fileName}}{{extension}}'` <br/> `'/locales/{{locale}}/{{key}}.json'` <br/> `{ en: ({ key }) => './locales/en/${key}.json', fr: '...', es: false }` | • Caminhos `./` são resolvidos em relação ao diretório da componente.<br/>• Caminhos `/` em relação à raiz.<br/>• `{{locale}}` ativa a geração por idioma.<br/>• Suporta notação de objeto por idioma.                                                                                                   |
+| `noMetadata`          | Se `true`, o compilador omite os metadados do dicionário (chave, wrapper de conteúdo) da saída.                                                                                                                                                                                                                              | `boolean`                                                                                                       | `false`     | `false` → `{"key":"minha-chave","content":{"key":"valor"}}` <br/> `true` → `{"key":"valor"}`                                                             | • Útil para saídas i18next ou ICU MessageFormat JSON.<br/>• Funciona bem com o plugin `loadJSON`.                                                                                                                                                                                                        |
 
 ---