@intlayer/docs 7.4.0 → 7.5.0-canary.1

package/docs/pl/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2025-09-20
+updatedAt: 2025-12-13
 title: Plik z Treścią
 description: Dowiedz się, jak dostosować rozszerzenia dla plików deklaracji treści. Postępuj zgodnie z tą dokumentacją, aby efektywnie wdrażać warunki w swoim projekcie.
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 7.5.0
+    date: 2025-12-13
+    changes: Dodano obsługę formatów ICU i i18next
   - version: 7.0.0
     date: 2025-10-23
     changes: Zmiana nazwy `autoFill` na `fill`
@@ -387,6 +390,26 @@ Tablica łańcuchów znaków służąca do kategoryzacji i organizacji słownik
 }
 ```
 
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+Określa formatter do użycia dla zawartości słownika. Pozwala to na używanie różnych składni formatowania wiadomości.
+
+- `'intlayer'`: Domyślny formatter Intlayer.
+- `'icu'`: Używa formatowania wiadomości ICU.
+- `'i18next'`: Używa formatowania wiadomości i18next.
+
+**Przykład:**
+
+```typescript
+{
+  key: "my-dictionary",
+  format: "icu",
+  content: {
+    message: "Hello {name}, you have {count, plural, one {# message} other {# messages}}"
+  }
+}
+```
+
 #### `locale` (LocalesValues)
 
 Przekształca słownik w słownik per-lokalizacyjny, gdzie każde pole zadeklarowane w zawartości zostanie automatycznie przekształcone w węzeł tłumaczenia. Gdy ta właściwość jest ustawiona:

package/docs/pl/intlayer_with_astro.md

@@ -2,7 +2,7 @@
 createdAt: 2024-03-07
 updatedAt: 2025-10-03
 title: Jak przetłumaczyć swoją aplikację Astro – przewodnik i18n 2025
-description: Dowiedz się, jak dodać internacjonalizację (i18n) do swojej aplikacji Vite i React za pomocą Intlayer. Postępuj zgodnie z tym przewodnikiem, aby uczynić swoją aplikację wielojęzyczną.
+description: Dowiedz się, jak dodać internacjonalizację (i18n) do swojej strony Astro za pomocą Intlayer. Postępuj zgodnie z tym przewodnikiem, aby uczynić swoją stronę wielojęzyczną.
 keywords:
   - Internacjonalizacja
   - Dokumentacja
@@ -28,7 +28,7 @@ Aby pójść dalej, możesz zaimplementować [edytor wizualny](https://github.co
 createdAt: 2024-03-07
 updatedAt: 2025-10-03
 title: Jak przetłumaczyć swoją aplikację Astro – przewodnik i18n 2025
-description: Dowiedz się, jak dodać internacjonalizację (i18n) do swojej aplikacji Vite i React za pomocą Intlayer. Postępuj zgodnie z tym przewodnikiem, aby uczynić swoją aplikację wielojęzyczną.
+description: Dowiedz się, jak dodać internacjonalizację (i18n) do swojej strony Astro za pomocą Intlayer. Postępuj zgodnie z tym przewodnikiem, aby uczynić swoją stronę wielojęzyczną.
 keywords:
 
 - Internacjonalizacja

package/docs/pl/intlayer_with_express.md

@@ -2,7 +2,7 @@
 createdAt: 2025-08-23
 updatedAt: 2025-08-23
 title: Jak przetłumaczyć backend Express – przewodnik i18n 2025
-description: Dowiedz się, jak uczynić swój backend vite wielojęzycznym. Postępuj zgodnie z dokumentacją, aby internacjonalizować (i18n) i tłumaczyć.
+description: Dowiedz się, jak uczynić swój backend Express wielojęzycznym. Postępuj zgodnie z dokumentacją, aby internacjonalizować (i18n) i tłumaczyć.
 keywords:
   - Internacjonalizacja
   - Dokumentacja

package/docs/pl/intlayer_with_nestjs.md

@@ -2,7 +2,7 @@
 createdAt: 2025-09-09
 updatedAt: 2025-09-09
 title: Jak przetłumaczyć backend Nest – przewodnik i18n 2025
-description: Dowiedz się, jak uczynić swój backend vite wielojęzycznym. Postępuj zgodnie z dokumentacją, aby internacjonalizować (i18n) i tłumaczyć.
+description: Dowiedz się, jak uczynić swój backend NestJS wielojęzycznym. Postępuj zgodnie z dokumentacją, aby internacjonalizować (i18n) i tłumaczyć.
 keywords:
   - Internacjonalizacja
   - Dokumentacja

package/docs/pl/intlayer_with_next-i18next.md

@@ -581,6 +581,7 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/pl/intlayer_with_next-intl.md

@@ -419,6 +419,7 @@ const config: IntlayerConfig = {
   plugins: [
     // Zachowaj strukturę folderów per namespace w synchronizacji z Intlayer
     syncJSON({
+      format: "icu",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],

package/docs/pl/intlayer_with_tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
+updatedAt: 2025-12-11
 title: Jak przetłumaczyć swoją aplikację Tanstack Start – przewodnik i18n 2025
 description: Dowiedz się, jak dodać internacjonalizację (i18n) do swojej aplikacji Tanstack Start za pomocą Intlayer. Postępuj zgodnie z tym kompleksowym przewodnikiem, aby uczynić swoją aplikację wielojęzyczną z routingiem uwzględniającym lokalizację.
 keywords:
@@ -624,17 +624,6 @@ export function NotFoundComponent() {
 }
 ```
 
-```tsx fileName="src/routes/__root.tsx"
-import { createRootRoute } from "@tanstack/react-router";
-
-// Trasa główna służy jako układ najwyższego poziomu
-// Nie obsługuje 404 bezpośrednio - to jest delegowane do tras potomnych
-// To utrzymuje główną trasę prostą i pozwala trasom świadomym locale zarządzać własną logiką 404
-export const Route = createRootRoute({
-  component: Outlet,
-});
-```
-
 ```tsx fileName="src/routes/{-$locale}/route.tsx"
 import { createFileRoute, Outlet, redirect } from "@tanstack/react-router";
 import { validatePrefix } from "intlayer";

package/docs/pl/plugins/sync-json.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-10-05
+updatedAt: 2025-12-13
 title: Wtyczka Sync JSON
 description: Synchronizuj słowniki Intlayer z zewnętrznymi plikami JSON i18n (i18next, next-intl, react-intl, vue-i18n i inne). Zachowaj istniejące i18n, korzystając z Intlayer do zarządzania, tłumaczenia i testowania swoich komunikatów.
 keywords:
@@ -29,7 +29,7 @@ history:
     changes: Pierwsza dokumentacja wtyczki Sync JSON
 ---
 
-# Sync JSON (mosty i18n)
+# Sync JSON (mosty i18n) - Sync JSON z obsługą ICU / i18next
 
 <iframe title="Jak zachować synchronizację tłumaczeń JSON z Intlayer" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
@@ -105,9 +105,27 @@ syncJSON({
   source: ({ key, locale }) => string, // wymagane
   location?: string, // opcjonalna etykieta, domyślnie: "plugin"
   priority?: number, // opcjonalny priorytet do rozstrzygania konfliktów, domyślnie: 0
+  format?: 'intlayer' | 'icu' | 'i18next', // opcjonalny formatator, domyślnie: 'intlayer'
 });
 ```
 
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+Określa formatator, który będzie używany do zawartości słownika podczas synchronizacji plików JSON. Pozwala to na używanie różnych składni formatowania wiadomości zgodnych z różnymi bibliotekami i18n.
+
+- `'intlayer'`: Domyślny formatator Intlayer (domyślnie).
+- `'icu'`: Używa formatowania wiadomości ICU (zgodne z bibliotekami takimi jak react-intl, vue-i18n).
+- `'i18next'`: Używa formatowania wiadomości i18next (zgodne z i18next, next-i18next, Solid-i18next).
+
+**Przykład:**
+
+```ts
+syncJSON({
+  source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+  format: "i18next", // Użyj formatowania i18next dla zgodności
+}),
+```
+
 ## Wiele źródeł JSON i priorytet
 
 Możesz dodać wiele wtyczek `syncJSON`, aby synchronizować różne źródła JSON. Jest to przydatne, gdy masz wiele bibliotek i18n lub różne struktury JSON w swoim projekcie.
@@ -134,6 +152,7 @@ export default defineConfig({
   plugins: [
     // Główne źródło JSON (najwyższy priorytet)
     syncJSON({
+      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
       location: "main-translations",
       priority: 10,
@@ -141,6 +160,7 @@ export default defineConfig({
 
     // Zapasowe źródło JSON (niższy priorytet)
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `./fallback-locales/${locale}.json`,
       location: "fallback-translations",
       priority: 5,
@@ -148,6 +168,7 @@ export default defineConfig({
 
     // Źródło JSON dziedziczone (najniższy priorytet)
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.json`,
       location: "legacy-translations",
       priority: 1,
@@ -178,6 +199,7 @@ import { syncJSON } from "@intlayer/sync-json-plugin";
 export default {
   plugins: [
     syncJSON({
+      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],

package/docs/pt/cli/index.md

@@ -103,6 +103,10 @@ Para ver como configurar os locais disponíveis ou outros parâmetros, consulte
 
 ## Executar comandos intlayer
 
+### Autenticação
+
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/login.md)** - Autenticar-se com o CMS do Intlayer e obter credenciais de acesso
+
 ### Comandos Principais
 
 - **[Construir Dicionários](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/build.md)** - Construa seus dicionários a partir dos arquivos de declaração de conteúdo
@@ -144,6 +148,7 @@ Para ver como configurar os locais disponíveis ou outros parâmetros, consulte
 
 ```json fileName="package.json"
 "scripts": {
+  "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",
   "intlayer:push": "npx intlayer push",

package/docs/pt/cli/login.md

@@ -0,0 +1,186 @@
+---
+createdAt: 2025-12-16
+updatedAt: 2025-12-16
+title: CLI - Login
+description: Aprenda como usar o comando de login do Intlayer CLI para autenticar-se no Intlayer CMS e obter credenciais de acesso.
+keywords:
+  - CLI
+  - Login
+  - Autenticação
+  - CMS
+  - Intlayer
+  - Credenciais
+slugs:
+  - doc
+  - concept
+  - cli
+  - login
+---
+
+# Comando de Login do Intlayer CLI
+
+---
+
+## Descrição
+
+O comando `login` do Intlayer CLI permite que você se autentique no Intlayer CMS. Este comando abre automaticamente o seu navegador padrão para concluir o processo de autenticação e receber as credenciais necessárias (Client ID e Client Secret) para usar os serviços do Intlayer.
+
+## Uso
+
+```bash
+npx intlayer login [options]
+```
+
+ou
+
+```bash
+intlayer login [options]
+```
+
+## Opções
+
+### `--cms-url <url>`
+
+Especifica a URL do Intlayer CMS para se conectar para autenticação.
+
+- **Tipo**: `string`
+- **Padrão**: O valor configurado em `intlayer.config.*` ou `https://intlayer.org`
+- **Exemplo**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### Opções de Configuração
+
+Você também pode usar opções comuns de configuração:
+
+- `--env-file <path>`: Caminho para o arquivo de ambiente
+- `-e, --env <env>`: Ambiente de execução
+- `--base-dir <dir>`: Diretório base do projeto
+- `--verbose`: Habilitar saída detalhada (padrão: true)
+- `--prefix <prefix>`: Prefixo para logs
+
+## Como Funciona
+
+1. **Inicialização do servidor local**: O comando inicia um servidor HTTP local em uma porta aleatória para receber credenciais do CMS
+
+Especifique a URL do Intlayer CMS para se conectar durante a autenticação.
+
+- **Tipo**: `string`
+- **Padrão**: O valor configurado em `intlayer.config.*` ou `https://intlayer.org`
+- **Exemplo**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### Opções de Configuração
+
+Você também pode usar opções de configuração comuns:
+
+- `--env-file <path>`: Caminho para o arquivo de ambiente
+- `-e, --env <env>`: Ambiente de execução
+- `--base-dir <dir>`: Diretório base do projeto
+- `--verbose`: Habilitar saída detalhada (padrão: true)
+- `--prefix <prefix>`: Prefixo para os logs
+
+## Como Funciona
+
+1. **Inicialização do Servidor Local**: O comando inicia um servidor HTTP local em uma porta aleatória para receber as credenciais do CMS
+2. **Abertura do Navegador**: O comando abre automaticamente o seu navegador padrão na URL de login do CMS
+3. **Autenticação**: Complete a autenticação no navegador usando sua conta Intlayer
+4. **Recepção das Credenciais**: O servidor local recebe o Client ID e o Client Secret do CMS
+5. **Instruções**: O comando exibe instruções para configurar as credenciais no seu projeto
+
+## Saída
+
+Após um login bem-sucedido, o comando exibirá:
+
+1. **As credenciais recebidas** (Client ID e Client Secret)
+2. **Instruções para o arquivo `.env`:**
+
+```bash
+INTLAYER_CLIENT_ID=your_client_id
+INTLAYER_CLIENT_SECRET=your_client_secret
+```
+
+3. **Instruções para o arquivo de configuração do Intlayer**:
+
+```typescript
+{
+  editor: {
+    cmsURL: 'https://intlayer.org',
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+}
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+}
+```
+
+## Configuração Manual
+
+Se o navegador não abrir automaticamente, você pode visitar manualmente a URL exibida no terminal.
+
+## Exemplos
+
+### Login com URL do CMS personalizado
+
+```bash
+npx intlayer login --cms-url https://custom-cms.example.com
+```
+
+### Login com Arquivo de Ambiente Específico
+
+```bash
+npx intlayer login --env-file .env.production
+```
+
+### Login em Modo Verbose
+
+```bash
+npx intlayer login --verbose
+```
+
+## Solução de Problemas
+
+### Navegador Não Abre
+
+Se o navegador não abrir automaticamente, copie a URL exibida no terminal e abra-a manualmente no seu navegador.
+
+### Problemas de Conexão
+
+Se você encontrar problemas de conexão, verifique:
+
+1. Que a URL do CMS esteja correta
+2. Que sua conexão com a internet esteja funcionando corretamente
+3. Que não haja firewalls bloqueando a conexão
+
+### Credenciais não recebidas
+
+Se as credenciais não forem recebidas:
+
+1. Certifique-se de que você concluiu o processo de autenticação no navegador
+2. Verifique se a porta local não está bloqueada
+3. Tente executar o comando novamente
+
+## Próximos passos
+
+Após completar o login:
+
+1. Adicione as credenciais ao seu arquivo `.env`
+2. Configure seu arquivo `intlayer.config.*` com as credenciais
+3. Use comandos da CLI para gerenciar seus dicionários:
+   - [`npx intlayer push`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/push.md) - Fazer push de dicionários para o CMS
+   - [`npx intlayer pull`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/pull.md) - Fazer pull de dicionários do CMS
+
+- [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/fill.md) - Preencher traduções faltantes
+
+## Veja também
+
+- [Documentação da CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/index.md)
+- [Configuração do Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md)
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md)

package/docs/pt/configuration.md

@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 7.5.0
+    date: 2025-12-17
+    changes: Adicionar opção `buildMode`
   - version: 6.0.0
     date: 2025-09-16
     changes: Adicionado modo de importação `live`
@@ -524,6 +527,15 @@ As opções de build se aplicam aos plugins `@intlayer/babel` e `@intlayer/swc`.
 
 #### Propriedades
 
+- **mode**:
+  - _Tipo_: `'auto' | 'manual'`
+  - _Padrão_: `'auto'`
+  - _Descrição_: Controla o modo da build.
+  - _Exemplo_: `'manual'`
+  - _Nota_: Se 'auto', a build será habilitada automaticamente quando a aplicação for construída.
+  - _Nota_: Se 'manual', a build será definida apenas quando o comando de build for executado.
+  - _Nota_: Pode ser usado para desabilitar a build de dicionários, por exemplo quando a execução em um ambiente Node.js deve ser evitada.
+
 - **optimize**:
   - _Tipo_: `boolean`
   - _Padrão_: `process.env.NODE_ENV === 'production'`

package/docs/pt/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2025-09-20
+updatedAt: 2025-12-13
 title: Arquivo de Conteúdo
 description: Aprenda como personalizar as extensões para seus arquivos de declaração de conteúdo. Siga esta documentação para implementar condições de forma eficiente em seu projeto.
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 7.5.0
+    date: 2025-12-13
+    changes: Adicionado suporte para formatos ICU e i18next
   - version: 6.0.0
     date: 2025-09-20
     changes: Adição da documentação dos campos
@@ -387,6 +390,26 @@ Array de strings para categorizar e organizar dicionários. As tags fornecem con
 }
 ```
 
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+Especifica o formatador a ser usado para o conteúdo do dicionário. Isso permite usar diferentes sintaxes de formatação de mensagens.
+
+- `'intlayer'`: O formatador Intlayer padrão.
+- `'icu'`: Usa formatação de mensagens ICU.
+- `'i18next'`: Usa formatação de mensagens i18next.
+
+**Exemplo:**
+
+```typescript
+{
+  key: "my-dictionary",
+  format: "icu",
+  content: {
+    message: "Hello {name}, you have {count, plural, one {# message} other {# messages}}"
+  }
+}
+```
+
 #### `locale` (LocalesValues)
 
 Transforma o dicionário em um dicionário por localidade onde cada campo declarado no conteúdo será automaticamente transformado em um nó de tradução. Quando essa propriedade é definida:

package/docs/pt/intlayer_with_astro.md

@@ -2,7 +2,7 @@
 createdAt: 2024-03-07
 updatedAt: 2025-10-03
 title: Como traduzir seu Astro – guia i18n 2025
-description: Aprenda como adicionar internacionalização (i18n) à sua aplicação Vite e React usando Intlayer. Siga este guia para tornar seu app multilíngue.
+description: Aprenda como adicionar internacionalização (i18n) ao seu site Astro usando Intlayer. Siga este guia para tornar seu site multilíngue.
 keywords:
   - Internacionalização
   - Documentação

package/docs/pt/intlayer_with_express.md

@@ -2,7 +2,7 @@
 createdAt: 2024-08-11
 updatedAt: 2025-06-29
 title: Como traduzir seu Express backend – guia i18n 2025
-description: Descubra como tornar seu backend vite multilíngue. Siga a documentação para internacionalizar (i18n) e traduzi-lo.
+description: Descubra como tornar seu backend Express multilíngue. Siga a documentação para internacionalizar (i18n) e traduzi-lo.
 keywords:
   - Internacionalização
   - Documentação

package/docs/pt/intlayer_with_nestjs.md

@@ -2,7 +2,7 @@
 createdAt: 2025-09-09
 updatedAt: 2025-09-09
 title: Como traduzir seu Nest backend – guia i18n 2025
-description: Descubra como tornar seu backend vite multilíngue. Siga a documentação para internacionalizar (i18n) e traduzir.
+description: Descubra como tornar seu backend NestJS multilíngue. Siga a documentação para internacionalizar (i18n) e traduzir.
 keywords:
   - Internacionalização
   - Documentação

package/docs/pt/intlayer_with_next-i18next.md

@@ -580,6 +580,7 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/pt/intlayer_with_next-intl.md

@@ -419,6 +419,7 @@ const config: IntlayerConfig = {
   plugins: [
     // Mantenha sua estrutura de pastas por namespace sincronizada com o Intlayer
     syncJSON({
+      format: "icu",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],