@intlayer/docs 7.5.0-canary.0 → 7.5.0-canary.1

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'`