@intlayer/docs 7.5.10 → 7.5.12

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

@@ -105,18 +105,22 @@ 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', // opcjonalny formatator, używany dla kompatybilności z runtime 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.
+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 runtime Intlayer.
 
+- `undefined`: Żaden formatator nie będzie używany, zawartość JSON będzie używana bez zmian.
 - `'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).
 
+> Należy pamiętać, że użycie formatora przekształci zawartość JSON na wejściu i wyjściu. W przypadku złożonych reguł JSON, takich jak liczba mnoga ICU, parsowanie może nie zapewnić mapowania 1 do 1 między wejściem a wyjściem.
+> Jeśli nie używasz runtime Intlayer, możesz preferować nie ustawiać formatora.
+
 **Przykład:**
 
 ```ts

package/docs/pt/cli/ci.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-01-06
+updatedAt: 2026-01-06
+title: Comando CI
+description: Aprenda como usar o comando Intlayer CI para executar comandos Intlayer com credenciais auto-injetadas em pipelines CI/CD e monorepos.
+keywords:
+  - CI
+  - CI/CD
+  - Automação
+  - Monorepo
+  - Credenciais
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - ci
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Adicionar comando CI
+---
+
+# Comando CI
+
+```bash
+npx intlayer ci <command...>
+```
+
+O comando CI é projetado para automação e pipelines CI/CD. Ele injeta automaticamente credenciais da variável de ambiente `INTLAYER_PROJECT_CREDENTIALS` e pode executar comandos Intlayer em vários projetos em um monorepo.
+
+## Como funciona
+
+O comando CI opera em dois modos:
+
+1. **Modo de projeto único**: Se o diretório de trabalho atual corresponder a um dos caminhos do projeto em `INTLAYER_PROJECT_CREDENTIALS`, ele executa o comando apenas para esse projeto específico.
+
+2. **Modo de iteração**: Se nenhum contexto de projeto específico for detectado, ele itera sobre todos os projetos configurados e executa o comando para cada um.
+
+## Variável de ambiente
+
+O comando requer que a variável de ambiente `INTLAYER_PROJECT_CREDENTIALS` seja definida. Esta variável deve conter um objeto JSON mapeando caminhos de projeto para suas credenciais:
+
+```json
+{
+  "packages/app": {
+    "clientId": "your-client-id-1",
+    "clientSecret": "your-client-secret-1"
+  },
+  "packages/admin": {
+    "clientId": "your-client-id-2",
+    "clientSecret": "your-client-secret-2"
+  }
+}
+```
+
+## Detecção do gerenciador de pacotes
+
+O comando CI detecta automaticamente qual gerenciador de pacotes está sendo usado (npm, yarn, pnpm ou bun) com base na variável de ambiente `npm_config_user_agent` e usa o comando apropriado para executar Intlayer.
+
+## Argumentos
+
+- **`<command...>`**: O comando Intlayer a ser executado (por exemplo, `fill`, `push`, `build`). Você pode passar qualquer comando Intlayer e seus argumentos.
+
+  > Exemplo: `npx intlayer ci fill --verbose`
+  >
+  > Exemplo: `npx intlayer ci push`
+  >
+  > Exemplo: `npx intlayer ci build`
+
+## Exemplos
+
+### Executar um comando no modo de projeto único
+
+Se você estiver em um diretório de projeto que corresponde a um dos caminhos em `INTLAYER_PROJECT_CREDENTIALS`:
+
+```bash
+cd packages/app
+npx intlayer ci fill
+```
+
+Isso executará o comando `fill` com credenciais automaticamente injetadas para o projeto `packages/app`.
+
+### Executar um comando em todos os projetos
+
+Se você estiver em um diretório que não corresponde a nenhum caminho de projeto, o comando iterará sobre todos os projetos configurados:
+
+```bash
+cd /path/to/monorepo
+npx intlayer ci push
+```
+
+Isso executará o comando `push` para cada projeto configurado em `INTLAYER_PROJECT_CREDENTIALS`.
+
+### Passar flags adicionais
+
+Você pode passar quaisquer flags para o comando Intlayer subjacente:
+
+```bash
+npx intlayer ci fill --verbose --mode complete
+```
+
+### Usar em pipelines CI/CD
+
+Em sua configuração CI/CD (por exemplo, GitHub Actions, GitLab CI), defina `INTLAYER_PROJECT_CREDENTIALS` como um segredo:
+
+```yaml
+# Exemplo GitHub Actions
+env:
+  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
+
+steps:
+  - name: Preencher dicionários
+    run: npx intlayer ci fill
+```
+
+## Tratamento de erros
+
+- Se `INTLAYER_PROJECT_CREDENTIALS` não estiver definida, o comando sairá com um erro.
+- Se `INTLAYER_PROJECT_CREDENTIALS` não for um JSON válido, o comando sairá com um erro.
+- Se um caminho de projeto não existir, ele será ignorado com um aviso.
+- Se algum projeto falhar, o comando sairá com um código de status diferente de zero.
+
+## Casos de uso
+
+- **Automação de monorepo**: Executar comandos Intlayer em vários projetos em um monorepo
+- **Pipelines CI/CD**: Automatizar o gerenciamento de dicionários em fluxos de trabalho de integração contínua
+- **Operações em massa**: Realizar a mesma operação em vários projetos Intlayer de uma vez
+- **Gerenciamento de segredos**: Gerenciar com segurança credenciais para vários projetos usando variáveis de ambiente
+
+## Melhores práticas de segurança
+
+- Armazene `INTLAYER_PROJECT_CREDENTIALS` como segredos criptografados em sua plataforma CI/CD
+- Nunca faça commit de credenciais no controle de versão
+- Use credenciais específicas do ambiente para diferentes ambientes de implantação
+- Rotacione credenciais regularmente

package/docs/pt/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI
 description: Descubra como usar o Intlayer CLI para gerenciar seu site multilíngue. Siga os passos nesta documentação online para configurar seu projeto em poucos minutos.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Adicionado comando projects list
   - version: 7.5.9
     date: 2025-12-30
     changes: Adicionado comando init
@@ -119,6 +122,7 @@ Para ver como configurar os locais disponíveis ou outros parâmetros, consulte
 - **[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
 - **[Observar Dicionários](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/watch.md)** - Observe alterações e construa automaticamente os dicionários
 - **[Verificar Versão do CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/version.md)** - Verifique a versão instalada do Intlayer CLI
+- **[Listar Projetos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/list_projects.md)** - Liste todos os projetos Intlayer em um diretório ou repositório git
 
 ### Gerenciamento de Dicionários
 
@@ -166,6 +170,7 @@ Para ver como configurar os locais disponíveis ou outros parâmetros, consulte
   "intlayer:list": "npx intlayer content list",
   "intlayer:test": "npx intlayer content test",
   "intlayer:transform": "npx intlayer transform",
+  "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
   "intlayer:doc:review": "npx intlayer doc review"
 }
@@ -175,3 +180,4 @@ Para ver como configurar os locais disponíveis ou outros parâmetros, consulte
 >
 > - `npx intlayer list` ao invés de `npx intlayer content list`
 > - `npx intlayer test` ao invés de `npx intlayer content test`
+> - `npx intlayer projects-list` ou `npx intlayer pl` ao invés de `npx intlayer projects list`

package/docs/pt/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: Listar Arquivos de Declaração de Conteúdo
 description: Aprenda como listar todos os arquivos de declaração de conteúdo no seu projeto.
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Adicionar opção de saída absoluta ao comando list
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Adicionar opção de saída JSON ao comando list
 ---
 
 # Listar arquivos de declaração de conteúdo
@@ -27,14 +34,36 @@ npx intlayer content list
 
 Este comando exibe todos os arquivos de declaração de conteúdo no seu projeto, mostrando suas chaves de dicionário e caminhos dos arquivos. É útil para obter uma visão geral de todos os seus arquivos de conteúdo e verificar se eles estão sendo corretamente descobertos pelo Intlayer.
 
-## Exemplo:
+## Argumentos:
+
+- **`--json`**: Exibe os resultados como JSON em vez de texto formatado. Útil para scripts e acesso programático.
+
+  > Exemplo: `npx intlayer content list --json`
+
+## Exemplos:
+
+### Listar arquivos de declaração de conteúdo:
 
 ```bash
 npx intlayer content list
 ```
 
+### Saída como JSON:
+
+```bash
+npx intlayer content list --json
+```
+
+### Saída como caminhos absolutos:
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## Exemplo de saída:
 
+### Saída formatada:
+
 ```bash
 npx intlayer content list
 Content declaration files:
@@ -45,6 +74,14 @@ Content declaration files:
 Total de arquivos de declaração de conteúdo: 3
 ```
 
+### Saída JSON:
+
+```bash
+$ npx intlayer content list --json
+
+[{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
+```
+
 Este comando exibirá:
 
 - Uma lista formatada de todos os arquivos de declaração de conteúdo com suas chaves e caminhos relativos dos arquivos

package/docs/pt/cli/list_projects.md

@@ -0,0 +1,134 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Listar Projetos Intlayer
+description: Aprenda como listar todos os projetos Intlayer em um diretório ou repositório git.
+keywords:
+  - Listar
+  - Projetos
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Adicionar opção de saída absoluta ao comando list projects
+---
+
+# Listar Projetos Intlayer
+
+```bash
+npx intlayer projects list
+```
+
+Este comando procura e lista todos os projetos Intlayer ao encontrar diretórios que contenham ficheiros de configuração do Intlayer. É útil para descobrir todos os projetos Intlayer em um monorepo, workspace ou repositório git.
+
+## Atalhos:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## Argumentos:
+
+- **`--base-dir [path]`**: Especifica o diretório base a partir do qual pesquisar. O padrão é o diretório de trabalho atual.
+
+  > Exemplo: `npx intlayer projects list --base-dir /path/to/workspace`
+
+  > Exemplo: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: Pesquise a partir do diretório raiz do git em vez do diretório base. Isto é útil para encontrar todos os projetos Intlayer num monorepo ou repositório git.
+
+  > Exemplo: `npx intlayer projects list --git-root`
+
+- **`--json`**: Exibe os resultados como JSON em vez de texto formatado. Útil para scripts e acesso programático.
+
+  > Exemplo: `npx intlayer projects list --json`
+
+- **`--absolute`**: Exibe os resultados como caminhos absolutos em vez de caminhos relativos.
+
+  > Exemplo: `npx intlayer projects list --absolute`
+
+## Como funciona:
+
+O comando procura ficheiros de configuração do Intlayer no diretório especificado (ou na raiz do git se `--git-root` for usado). Procura pelos seguintes padrões de ficheiro de configuração:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Cada diretório que contiver um destes ficheiros é considerado um projeto Intlayer e será listado na saída.
+
+## Exemplos:
+
+### Listar projetos no diretório atual:
+
+```bash
+npx intlayer projects list
+```
+
+### Listar projetos em um diretório específico:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### Listar todos os projetos no repositório git:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### Usando o alias de atalho:
+
+```bash
+npx intlayer pl --git-root
+```
+
+### Saída como JSON:
+
+```bash
+npx intlayer projects list --json
+```
+
+## Exemplo de saída:
+
+### Saída formatada:
+
+```bash
+$ npx intlayer projects list --git-root
+
+Found 3 Intlayer project(s):
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### Saída JSON:
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## Casos de uso:
+
+- **Gestão de monorepo**: Descobrir todos os projetos Intlayer numa estrutura monorepo
+- **Descoberta de projetos**: Encontrar todos os projetos com Intlayer num workspace
+- **CI/CD**: Verificar projetos Intlayer em workflows automatizados
+- **Documentação**: Gerar documentação listando todos os projetos que usam Intlayer
+
+A saída fornece caminhos absolutos para cada diretório de projeto, facilitando a navegação ou a automatização de operações em múltiplos projetos Intlayer.
+
+- **Documentação**: Gerar documentação listando todos os projetos que usam o Intlayer
+
+A saída fornece caminhos absolutos para cada diretório de projeto, tornando fácil navegar até eles ou escrever scripts para executar operações em vários projetos Intlayer.

package/docs/pt/intlayer_CMS.md

@@ -71,6 +71,26 @@ Para integração com Vite + React, consulte o [guia de configuração](https://
 
 ## Configuração
 
+Execute o seguinte comando para fazer login no Intlayer CMS:
+
+```bash packageManager="npm"
+npx intlayer login
+```
+
+```bash packageManager="yarn"
+yarn intlayer login
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer login
+```
+
+```bash packageManager="bun"
+bunx intlayer login
+```
+
+Isso abrirá 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.
+
 No seu arquivo de configuração do Intlayer, você pode personalizar as configurações do CMS:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/pt/intlayer_with_next-i18next.md

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

package/docs/pt/intlayer_with_nextjs_14.md

@@ -74,6 +74,34 @@ bunx intlayer init
 
 ### Passo 2: Configure Seu Projeto
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Crie um arquivo de configuração para configurar os idiomas da sua aplicação:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/pt/intlayer_with_nextjs_15.md

@@ -84,6 +84,34 @@ bunx intlayer init
 
 ### Passo 2: Configure Seu Projeto
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Crie um arquivo de configuração para configurar os idiomas da sua aplicação:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/pt/intlayer_with_nextjs_16.md

@@ -104,6 +104,34 @@ bunx intlayer init
 
 ### Passo 2: Configure Seu Projeto
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── proxy.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Crie um arquivo de configuração para configurar os idiomas da sua aplicação:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"