forlogic-core 2.1.3 → 2.1.5

package/docs/design-system/patterns/combo-tree.md

@@ -1,23 +1,23 @@
-# Padrão: ComboTree — Seleção Hierárquica
-
-O componente `ComboTree` permite a seleção de dados hierárquicos com busca recursiva e separação entre expansão (chevron) e seleção (label).
-
-## Layout
-- O **chevron** (▶/▼) fica no **final da linha** (à direita), indicando que o nó tem filhos
-- O **check** (✓) e o **ícone** ficam no início, seguidos pelo label
-- Nós sem filhos não exibem chevron
-
-## Ícones customizados por nó
-
-- `icon` — ícone padrão (nó colapsado e não selecionado)
-- `iconOpen` — ícone quando o nó está **expandido** (fallback para `icon`)
-- `iconSelected` — ícone quando o nó está **selecionado** (fallback para `iconOpen` se expandido, senão `icon`)
-- `iconClassName` — classe CSS para cor/estilo do ícone (fallback: `text-muted-foreground`)
-
-Prioridade de resolução:
-- Selecionado + Expandido → `iconSelected ?? iconOpen ?? icon`
-- Selecionado + Colapsado → `iconSelected ?? icon`
-- Não selecionado + Expandido → `iconOpen ?? icon`
-- Não selecionado + Colapsado → `icon`
-
-A busca preserva e auto-expande o caminho dos ancestrais para os itens encontrados.
+# Padrão: ComboTree — Seleção Hierárquica
+
+O componente `ComboTree` permite a seleção de dados hierárquicos com busca recursiva e separação entre expansão (chevron) e seleção (label).
+
+## Layout
+- O **chevron** (▶/▼) fica no **final da linha** (à direita), indicando que o nó tem filhos
+- O **check** (✓) e o **ícone** ficam no início, seguidos pelo label
+- Nós sem filhos não exibem chevron
+
+## Ícones customizados por nó
+
+- `icon` — ícone padrão (nó colapsado e não selecionado)
+- `iconOpen` — ícone quando o nó está **expandido** (fallback para `icon`)
+- `iconSelected` — ícone quando o nó está **selecionado** (fallback para `iconOpen` se expandido, senão `icon`)
+- `iconClassName` — classe CSS para cor/estilo do ícone (fallback: `text-muted-foreground`)
+
+Prioridade de resolução:
+- Selecionado + Expandido → `iconSelected ?? iconOpen ?? icon`
+- Selecionado + Colapsado → `iconSelected ?? icon`
+- Não selecionado + Expandido → `iconOpen ?? icon`
+- Não selecionado + Colapsado → `icon`
+
+A busca preserva e auto-expande o caminho dos ancestrais para os itens encontrados.

package/docs/design-system/patterns/components-registry.md

@@ -1,17 +1,17 @@
-# Referência: Registry de Componentes Consolidados
-
-Design System mantém um registro de componentes documentados em conjunto sob entradas únicas:
-
-- **Breadcrumb** (documenta Breadcrumb e PageBreadcrumb)
-- **Calendar & Date Picker** (documenta Calendar e DatePicker)
-- **Combobox** (documenta Combobox com Command usado internamente)
-- **Toggle & Group** (documenta Toggle e ToggleGroup)
-- **Skeleton** (documenta base Skeleton e todas as variantes)
-- **AppSidebar** (documenta AppSidebar, Sidebar base, SidebarProvider, SidebarMenu*, Collapsible)
-- **Accordion** (documenta Accordion e Collapsible)
-- **Input** (documenta Input, InputGroup, InputGroupAddon, InputGroupButton)
-- **Grid & Stack** (documenta Grid e Stack layout components)
-- **Dialog** (documenta Dialog, AlertDialog, Sheet, Drawer)
-- **Tabs** (documenta Tabs e TabPageLayout)
-
-Este registro deve ser consultado antes de criar nova documentação para evitar duplicatas.
+# Referência: Registry de Componentes Consolidados
+
+Design System mantém um registro de componentes documentados em conjunto sob entradas únicas:
+
+- **Breadcrumb** (documenta Breadcrumb e PageBreadcrumb)
+- **Calendar & Date Picker** (documenta Calendar e DatePicker)
+- **Combobox** (documenta Combobox com Command usado internamente)
+- **Toggle & Group** (documenta Toggle e ToggleGroup)
+- **Skeleton** (documenta base Skeleton e todas as variantes)
+- **AppSidebar** (documenta AppSidebar, Sidebar base, SidebarProvider, SidebarMenu*, Collapsible)
+- **Accordion** (documenta Accordion e Collapsible)
+- **Input** (documenta Input, InputGroup, InputGroupAddon, InputGroupButton)
+- **Grid & Stack** (documenta Grid e Stack layout components)
+- **Dialog** (documenta Dialog, AlertDialog, Sheet, Drawer)
+- **Tabs** (documenta Tabs e TabPageLayout)
+
+Este registro deve ser consultado antes de criar nova documentação para evitar duplicatas.

package/docs/design-system/patterns/core-providers.md

@@ -1,39 +1,39 @@
-# Padrão: CoreProviders Setup
-
-## Providers incluídos
-
-| Provider | Descrição |
-|----------|-----------|
-| ErrorBoundary | Captura erros de renderização React |
-| I18nextProvider | Sistema de internacionalização |
-| QueryClientProvider | Cache e queries (React Query) |
-| AuthProvider | Autenticação e sessão |
-| LocaleProvider | Idioma, timezone, formato de data |
-| ModuleProvider | Configuração de módulo ativo |
-| ModuleAccessGuard | Bloqueio de acesso por módulo |
-
-## Uso básico
-
-```tsx
-<CoreProviders moduleAlias="performance" appTranslations={{ 'pt-BR': ptBR }}>
-  <BrowserRouter>
-    <Routes />
-  </BrowserRouter>
-</CoreProviders>
-```
-
-## Props
-
-| Prop | Tipo | Obrigatório | Descrição |
-|------|------|-------------|-----------|
-| children | ReactNode | Sim | Componentes filhos |
-| queryClient | QueryClient | Não | Instância customizada (default criado automaticamente) |
-| moduleAlias | string | Não | Alias do módulo para verificação de acesso |
-| moduleAccessGuardProps | object | Não | Props para o ModuleAccessGuard |
-| appTranslations | Record<string, Record<string, string>> | Não | Traduções por idioma no namespace 'app' |
-
-## QueryClient default
-
-```ts
-{ defaultOptions: { queries: { staleTime: 5 * 60 * 1000, retry: 1 } } }
-```
+# Padrão: CoreProviders Setup
+
+## Providers incluídos
+
+| Provider | Descrição |
+|----------|-----------|
+| ErrorBoundary | Captura erros de renderização React |
+| I18nextProvider | Sistema de internacionalização |
+| QueryClientProvider | Cache e queries (React Query) |
+| AuthProvider | Autenticação e sessão |
+| LocaleProvider | Idioma, timezone, formato de data |
+| ModuleProvider | Configuração de módulo ativo |
+| ModuleAccessGuard | Bloqueio de acesso por módulo |
+
+## Uso básico
+
+```tsx
+<CoreProviders moduleAlias="performance" appTranslations={{ 'pt-BR': ptBR }}>
+  <BrowserRouter>
+    <Routes />
+  </BrowserRouter>
+</CoreProviders>
+```
+
+## Props
+
+| Prop | Tipo | Obrigatório | Descrição |
+|------|------|-------------|-----------|
+| children | ReactNode | Sim | Componentes filhos |
+| queryClient | QueryClient | Não | Instância customizada (default criado automaticamente) |
+| moduleAlias | string | Não | Alias do módulo para verificação de acesso |
+| moduleAccessGuardProps | object | Não | Props para o ModuleAccessGuard |
+| appTranslations | Record<string, Record<string, string>> | Não | Traduções por idioma no namespace 'app' |
+
+## QueryClient default
+
+```ts
+{ defaultOptions: { queries: { staleTime: 5 * 60 * 1000, retry: 1 } } }
+```

package/docs/design-system/patterns/crud-bulk-actions.md

@@ -1,12 +1,12 @@
-# Padrão: CRUD — Ações em Lote
-
-As ações em lote foram unificadas em um dropdown "Ações em lote" no CrudActionBar.
-
-**Comportamento:**
-- O menu permanece visível se habilitado
-- Exibe um badge com a contagem de itens selecionados
-- As opções internas são desabilitadas se a seleção for zero
-
-**Regras:**
-- O componente `BulkActionBar` foi **removido** para evitar barras duplicadas e layout shifts
-- Na CrudTable, a coluna de ações de linha não deve ter label no cabeçalho (usar apenas ícone ⋮ ou tooltip) para evitar confusão com o menu de ações em lote da toolbar
+# Padrão: CRUD — Ações em Lote
+
+As ações em lote foram unificadas em um dropdown "Ações em lote" no CrudActionBar.
+
+**Comportamento:**
+- O menu permanece visível se habilitado
+- Exibe um badge com a contagem de itens selecionados
+- As opções internas são desabilitadas se a seleção for zero
+
+**Regras:**
+- O componente `BulkActionBar` foi **removido** para evitar barras duplicadas e layout shifts
+- Na CrudTable, a coluna de ações de linha não deve ter label no cabeçalho (usar apenas ícone ⋮ ou tooltip) para evitar confusão com o menu de ações em lote da toolbar

package/docs/design-system/patterns/crud-config-props.md

@@ -1,16 +1,16 @@
-# Padrão: CRUD — Props Padronizadas de Configuração
-
-A interface CrudPageConfig foi estendida para padronizar a UX em todos os CRUDs (createCrudPage, CrudTable, CrudGrid).
-
-**Props disponíveis:**
-
-| Prop | Default | Descrição |
-|------|---------|-----------|
-| `showNewButton` | `true` | Exibe botão de criação |
-| `showSearch` | `true` | Exibe campo de busca |
-| `showBulkActions` | — | Alias para `enableBulkActions` |
-| `showActionBar` | `true` | Exibe a barra de ações (substitui `hideActionBar`) |
-| `newButtonLabel` | — | Customiza texto do botão de criação |
-| `searchPlaceholder` | — | Customiza placeholder da busca |
-
-Esta padronização garante que todos os CRUDs ofereçam as mesmas capacidades de busca, criação e ações em lote de forma consistente.
+# Padrão: CRUD — Props Padronizadas de Configuração
+
+A interface CrudPageConfig foi estendida para padronizar a UX em todos os CRUDs (createCrudPage, CrudTable, CrudGrid).
+
+**Props disponíveis:**
+
+| Prop | Default | Descrição |
+|------|---------|-----------|
+| `showNewButton` | `true` | Exibe botão de criação |
+| `showSearch` | `true` | Exibe campo de busca |
+| `showBulkActions` | — | Alias para `enableBulkActions` |
+| `showActionBar` | `true` | Exibe a barra de ações (substitui `hideActionBar`) |
+| `newButtonLabel` | — | Customiza texto do botão de criação |
+| `searchPlaceholder` | — | Customiza placeholder da busca |
+
+Esta padronização garante que todos os CRUDs ofereçam as mesmas capacidades de busca, criação e ações em lote de forma consistente.

package/docs/design-system/patterns/crud-defaults.md

@@ -1,17 +1,17 @@
-# Padrão: CRUD — Defaults Obrigatórios
-
-Todos os CRUDs (CrudTable, createCrudPage) incluem por padrão:
-
-| Feature | Default | Nota |
-|---------|---------|------|
-| Column resize | `true` ✓ | Já obrigatório |
-| Column manager | `true` ✓ | Botão ⋮ no header da coluna "Ações" |
-| Sort | `true` ✓ | Todas as colunas ordenáveis por padrão. Use `sortable: false` para desabilitar |
-| Busca | Header global | Para busca na action bar, usar `showSearch=true` |
-| Paginação | 25 itens/página | — |
-
-**NÃO vem por padrão:**
-- **Agrupamento** (`enableGrouping=false`) — precisa ser habilitado explicitamente
-- **Busca na action bar** (`showSearch=false`) — padrão é busca no header
-
-**Storage keys:** `createCrudPage` gera automaticamente `columnManagerStorageKey` e `resizeStorageKey` a partir do `entityName`.
+# Padrão: CRUD — Defaults Obrigatórios
+
+Todos os CRUDs (CrudTable, createCrudPage) incluem por padrão:
+
+| Feature | Default | Nota |
+|---------|---------|------|
+| Column resize | `true` ✓ | Já obrigatório |
+| Column manager | `true` ✓ | Botão ⋮ no header da coluna "Ações" |
+| Sort | `true` ✓ | Todas as colunas ordenáveis por padrão. Use `sortable: false` para desabilitar |
+| Busca | Header global | Para busca na action bar, usar `showSearch=true` |
+| Paginação | 25 itens/página | — |
+
+**NÃO vem por padrão:**
+- **Agrupamento** (`enableGrouping=false`) — precisa ser habilitado explicitamente
+- **Busca na action bar** (`showSearch=false`) — padrão é busca no header
+
+**Storage keys:** `createCrudPage` gera automaticamente `columnManagerStorageKey` e `resizeStorageKey` a partir do `entityName`.

package/docs/design-system/patterns/crud-toolbar.md

@@ -1,28 +1,28 @@
-# Padrão: CRUD Toolbar — Layout 3 Zonas
-
-O CrudActionBar implementa um layout rígido de 3 zonas:
-
-| Zona | Posição | Conteúdo |
-|------|---------|----------|
-| Esquerda | `justify-start` | Botão "Novo" (ação principal) + Dropdown ações em lote |
-| Centro | `flex-1 max-w-md` | Campo de busca (FilterBar/Input) |
-| Direita | `justify-end` | Filtros customizados + Toggle de visualização |
-
-```tsx
-// ✅ CORRETO
-<div className="flex items-center gap-4">
-  <Button>Novo Item</Button>
-  <div className="flex-1 max-w-md">
-    <Input placeholder="Buscar..." />
-  </div>
-  <div className="flex gap-2">
-    <Button variant="outline">Filtrar</Button>
-    <ActionButton items={actions} />
-  </div>
-</div>
-```
-
-**Regras:**
-- Botão de criação NUNCA deve ficar isolado no cabeçalho do Card
-- Este componente substitui implementações locais de barra de ferramentas
-- Garante visual consistente (bg-muted/50), comportamento e espaçamento em todos os CRUDs
+# Padrão: CRUD Toolbar — Layout 3 Zonas
+
+O CrudActionBar implementa um layout rígido de 3 zonas:
+
+| Zona | Posição | Conteúdo |
+|------|---------|----------|
+| Esquerda | `justify-start` | Botão "Novo" (ação principal) + Dropdown ações em lote |
+| Centro | `flex-1 max-w-md` | Campo de busca (FilterBar/Input) |
+| Direita | `justify-end` | Filtros customizados + Toggle de visualização |
+
+```tsx
+// ✅ CORRETO
+<div className="flex items-center gap-4">
+  <Button>Novo Item</Button>
+  <div className="flex-1 max-w-md">
+    <Input placeholder="Buscar..." />
+  </div>
+  <div className="flex gap-2">
+    <Button variant="outline">Filtrar</Button>
+    <ActionButton items={actions} />
+  </div>
+</div>
+```
+
+**Regras:**
+- Botão de criação NUNCA deve ficar isolado no cabeçalho do Card
+- Este componente substitui implementações locais de barra de ferramentas
+- Garante visual consistente (bg-muted/50), comportamento e espaçamento em todos os CRUDs

package/docs/design-system/patterns/delete-confirmation.md

@@ -1,40 +1,40 @@
-# Padrão: Dialog de Confirmação de Exclusão
-
-Dialog de exclusão segue padrão visual específico (NÃO usar AlertDialog para deleções simples):
-
-```tsx
-<Dialog open={open} onOpenChange={setOpen}>
-  <DialogContent size="sm" className="bg-white">
-    <DialogHeader showSeparator>
-      <DialogTitle className="sr-only">Confirmação</DialogTitle>
-    </DialogHeader>
-    
-    <div className="flex flex-col items-center text-center space-y-3 py-4">
-      <div className="w-12 h-12 rounded-full bg-destructive/10 flex items-center justify-center">
-        <AlertTriangle className="h-6 w-6 text-destructive" />
-      </div>
-      <h3 className="text-lg font-semibold">Tem certeza?</h3>
-      <p className="text-sm text-muted-foreground">
-        Você está prestes a excluir este registro.<br />
-        Esta ação não pode ser desfeita.
-      </p>
-    </div>
-    
-    <DialogFooter className="justify-center gap-2 mt-6">
-      <Button variant="outline" onClick={() => setOpen(false)}>
-        Cancelar
-      </Button>
-      <Button variant="destructive" onClick={handleDelete}>
-        Sim, excluir
-      </Button>
-    </DialogFooter>
-  </DialogContent>
-</Dialog>
-```
-
-**Regras:**
-- Usar `size="sm"` (~420px quadrado)
-- Background branco (`bg-white`)
-- Ícone AlertTriangle com `bg-destructive/10`
-- Botões lado a lado, centralizados
-- Texto fixo em português
+# Padrão: Dialog de Confirmação de Exclusão
+
+Dialog de exclusão segue padrão visual específico (NÃO usar AlertDialog para deleções simples):
+
+```tsx
+<Dialog open={open} onOpenChange={setOpen}>
+  <DialogContent size="sm" className="bg-white">
+    <DialogHeader showSeparator>
+      <DialogTitle className="sr-only">Confirmação</DialogTitle>
+    </DialogHeader>
+    
+    <div className="flex flex-col items-center text-center space-y-3 py-4">
+      <div className="w-12 h-12 rounded-full bg-destructive/10 flex items-center justify-center">
+        <AlertTriangle className="h-6 w-6 text-destructive" />
+      </div>
+      <h3 className="text-lg font-semibold">Tem certeza?</h3>
+      <p className="text-sm text-muted-foreground">
+        Você está prestes a excluir este registro.<br />
+        Esta ação não pode ser desfeita.
+      </p>
+    </div>
+    
+    <DialogFooter className="justify-center gap-2 mt-6">
+      <Button variant="outline" onClick={() => setOpen(false)}>
+        Cancelar
+      </Button>
+      <Button variant="destructive" onClick={handleDelete}>
+        Sim, excluir
+      </Button>
+    </DialogFooter>
+  </DialogContent>
+</Dialog>
+```
+
+**Regras:**
+- Usar `size="sm"` (~420px quadrado)
+- Background branco (`bg-white`)
+- Ícone AlertTriangle com `bg-destructive/10`
+- Botões lado a lado, centralizados
+- Texto fixo em português

package/docs/design-system/patterns/dialog-body-scroll.md

@@ -1,26 +1,26 @@
-# Padrão: Scroll Interno em Dialogs
-
-Conteúdo de Dialog/Sheet com scroll interno **DEVE** usar o padrão responsivo:
-
-```tsx
-// ✅ CORRETO - padrão obrigatório
-<div className="flex-1 min-h-0 overflow-auto py-4 px-2 -mx-2">
-  {/* Conteúdo scrollável */}
-</div>
-
-// ❌ ERRADO - overflow escondido, sem scroll
-<div className="p-4">
-  {/* Conteúdo pode ser cortado */}
-</div>
-```
-
-**Breakdown das classes:**
-| Classe | Função |
-|--------|--------|
-| `flex-1` | Expande para preencher espaço disponível |
-| `min-h-0` | Permite shrink em flex container |
-| `overflow-auto` | Habilita scroll quando necessário |
-| `py-4` | Padding vertical padrão (16px) |
-| `px-2 -mx-2` | Previne corte de focus rings (8px de respiro) |
-
-**Aplica-se a:** Dialog, Sheet, Drawer, AlertDialog
+# Padrão: Scroll Interno em Dialogs
+
+Conteúdo de Dialog/Sheet com scroll interno **DEVE** usar o padrão responsivo:
+
+```tsx
+// ✅ CORRETO - padrão obrigatório
+<div className="flex-1 min-h-0 overflow-auto py-4 px-2 -mx-2">
+  {/* Conteúdo scrollável */}
+</div>
+
+// ❌ ERRADO - overflow escondido, sem scroll
+<div className="p-4">
+  {/* Conteúdo pode ser cortado */}
+</div>
+```
+
+**Breakdown das classes:**
+| Classe | Função |
+|--------|--------|
+| `flex-1` | Expande para preencher espaço disponível |
+| `min-h-0` | Permite shrink em flex container |
+| `overflow-auto` | Habilita scroll quando necessário |
+| `py-4` | Padding vertical padrão (16px) |
+| `px-2 -mx-2` | Previne corte de focus rings (8px de respiro) |
+
+**Aplica-se a:** Dialog, Sheet, Drawer, AlertDialog

package/docs/design-system/patterns/dialog-structure.md

@@ -1,32 +1,32 @@
-# Padrão: Dialog — Tamanhos e Estrutura
-
-Dialog possui 3 tamanhos opcionais (sem default) e estrutura obrigatória:
-
-| Size | Width | MaxHeight | Uso |
-|------|-------|-----------|-----|
-| (nenhum) | Auto (className controla) | Auto | Quando classes Tailwind definem o tamanho |
-| `sm` | 30vw (320-480px) | 320px | Confirmações rápidas |
-| `md` | 50vw (480-720px) | 70vh | Formulários padrão |
-| `lg` | 85vw (max 1440px) | 900px | Tabelas, conteúdo extenso |
-
-**Mobile (<640px):** Todos os tamanhos são sobrepostos para ocupar `calc(100vw-2rem)` x `calc(100dvh-2rem)` com padding reduzido (`p-4`).
-
-**Regra de prioridade:** Quando `size` é informado, inline styles são aplicados e vencem sobre className. Sem `size`, className controla livremente.
-
-**Estrutura obrigatória:**
-```tsx
-<DialogContent size="md">
-  <DialogHeader showSeparator>
-    <DialogTitle>Título</DialogTitle>
-  </DialogHeader>
-  <DialogBody>
-    {/* Conteúdo aqui */}
-  </DialogBody>
-  <DialogFooter>...</DialogFooter>
-</DialogContent>
-```
-
-**Regras:**
-- `showSeparator` no DialogHeader para linha divisória
-- DialogBody é obrigatório para scroll interno
-- `size` é opcional — sem ele, classes Tailwind no className controlam o tamanho
+# Padrão: Dialog — Tamanhos e Estrutura
+
+Dialog possui 3 tamanhos opcionais (sem default) e estrutura obrigatória:
+
+| Size | Width | MaxHeight | Uso |
+|------|-------|-----------|-----|
+| (nenhum) | Auto (className controla) | Auto | Quando classes Tailwind definem o tamanho |
+| `sm` | 30vw (320-480px) | 320px | Confirmações rápidas |
+| `md` | 50vw (480-720px) | 70vh | Formulários padrão |
+| `lg` | 85vw (max 1440px) | 900px | Tabelas, conteúdo extenso |
+
+**Mobile (<640px):** Todos os tamanhos são sobrepostos para ocupar `calc(100vw-2rem)` x `calc(100dvh-2rem)` com padding reduzido (`p-4`).
+
+**Regra de prioridade:** Quando `size` é informado, inline styles são aplicados e vencem sobre className. Sem `size`, className controla livremente.
+
+**Estrutura obrigatória:**
+```tsx
+<DialogContent size="md">
+  <DialogHeader showSeparator>
+    <DialogTitle>Título</DialogTitle>
+  </DialogHeader>
+  <DialogBody>
+    {/* Conteúdo aqui */}
+  </DialogBody>
+  <DialogFooter>...</DialogFooter>
+</DialogContent>
+```
+
+**Regras:**
+- `showSeparator` no DialogHeader para linha divisória
+- DialogBody é obrigatório para scroll interno
+- `size` é opcional — sem ele, classes Tailwind no className controlam o tamanho

package/docs/design-system/patterns/dialog-variants.md

@@ -1,41 +1,41 @@
-# Padrão: Dialog — Variantes Semânticas
-
-O `DialogContent` possui uma prop `variant` que controla o comportamento de fechamento:
-
-## Variantes
-
-| Variante | Clique externo | ESC | Botão X | Uso |
-|----------|---------------|-----|---------|-----|
-| `informative` (padrão) | Fecha | Fecha | Fecha | Avisos, leitura |
-| `form` | Bloqueado | Fecha* | Fecha* | Formulários, edições |
-| `destructive` | Bloqueado | Bloqueado | Oculto | Exclusões, ações irreversíveis |
-
-\* Com `isDirty={true}`, exibe `window.confirm` antes de fechar.
-
-## Props
-
-```typescript
-interface DialogContentProps {
-  variant?: 'informative' | 'form' | 'destructive'; // default: 'informative'
-  isDirty?: boolean; // para variant='form', confirmação antes de fechar
-}
-```
-
-## Padrão de uso
-
-```tsx
-// Formulários
-<DialogContent variant="form" isDirty={form.formState.isDirty}>
-
-// Exclusões
-<DialogContent variant="destructive" size="sm">
-
-// Informativos (comportamento padrão, pode omitir variant)
-<DialogContent variant="informative">
-```
-
-## Regras
-- Default é `'informative'` para compatibilidade com dialogs existentes
-- `destructive` oculta o botão X — fechamento apenas por botões no DialogFooter
-- `form` com `isDirty` usa `window.confirm` nativo para confirmação
-- Tipos exportados: `DialogVariant`, `DialogSize`, `DialogContentProps`
+# Padrão: Dialog — Variantes Semânticas
+
+O `DialogContent` possui uma prop `variant` que controla o comportamento de fechamento:
+
+## Variantes
+
+| Variante | Clique externo | ESC | Botão X | Uso |
+|----------|---------------|-----|---------|-----|
+| `informative` (padrão) | Fecha | Fecha | Fecha | Avisos, leitura |
+| `form` | Bloqueado | Fecha* | Fecha* | Formulários, edições |
+| `destructive` | Bloqueado | Bloqueado | Oculto | Exclusões, ações irreversíveis |
+
+\* Com `isDirty={true}`, exibe `window.confirm` antes de fechar.
+
+## Props
+
+```typescript
+interface DialogContentProps {
+  variant?: 'informative' | 'form' | 'destructive'; // default: 'informative'
+  isDirty?: boolean; // para variant='form', confirmação antes de fechar
+}
+```
+
+## Padrão de uso
+
+```tsx
+// Formulários
+<DialogContent variant="form" isDirty={form.formState.isDirty}>
+
+// Exclusões
+<DialogContent variant="destructive" size="sm">
+
+// Informativos (comportamento padrão, pode omitir variant)
+<DialogContent variant="informative">
+```
+
+## Regras
+- Default é `'informative'` para compatibilidade com dialogs existentes
+- `destructive` oculta o botão X — fechamento apenas por botões no DialogFooter
+- `form` com `isDirty` usa `window.confirm` nativo para confirmação
+- Tipos exportados: `DialogVariant`, `DialogSize`, `DialogContentProps`

package/docs/design-system/patterns/feature-flags.md

@@ -1,20 +1,24 @@
-# Padrão: Feature Flags (Variáveis de Ambiente)
-
-## Variáveis disponíveis
-
-| Variável | Descrição | Padrão |
-|----------|-----------|--------|
-| `VITE_SHOW_USER_PREFERENCES` | Exibe "Preferências" no menu do usuário (idioma, timezone, formato de data) | Não exibe |
-| `VITE_I18N_DEBUG_MODE` | Modo debug de i18n (mostra chaves ao invés de traduções) | `"false"` |
-| `VITE_IS_QUALIEX` | Usa logos Qualiex ao invés de Forlogic | `"false"` |
-| `VITE_SHOW_EDIT_PROFILE` | Exibe "Editar Perfil" no menu do usuário (foto e idioma) | Não exibe |
-
-## Uso
-
-```env
-VITE_SHOW_USER_PREFERENCES=true
-VITE_I18N_DEBUG_MODE=false
-VITE_IS_QUALIEX=true
-```
-
-Variáveis Vite precisam do prefixo `VITE_` para serem expostas ao cliente.
+# Padrão: Feature Flags (Variáveis de Ambiente)
+
+## Variáveis disponíveis
+
+| Variável | Descrição | Padrão |
+|----------|-----------|--------|
+| `VITE_SHOW_USER_PREFERENCES` | Exibe "Preferências" no menu do usuário (idioma, timezone, formato de data) | Não exibe |
+| `VITE_I18N_DEBUG_MODE` | Modo debug de i18n (mostra chaves ao invés de traduções) | `"false"` |
+| `VITE_IS_QUALIEX` | Usa logos Qualiex ao invés de Forlogic | `"false"` |
+| `VITE_SHOW_EDIT_PROFILE` | Exibe "Editar Perfil" no menu do usuário (foto e idioma) | Não exibe |
+| `VITE_WIKI_URL` | Exibe botão "Wiki" no header da aplicação. O valor é a URL que será aberta ao clicar | Não exibe |
+| `VITE_SHOW_ADMIN_REPORTS` | Exibe relatórios administrativos | `"false"` |
+
+## Uso
+
+```env
+VITE_SHOW_USER_PREFERENCES=true
+VITE_I18N_DEBUG_MODE=false
+VITE_IS_QUALIEX=true
+VITE_WIKI_URL=https://wiki.example.com
+VITE_SHOW_ADMIN_REPORTS=false
+```
+
+Variáveis Vite precisam do prefixo `VITE_` para serem expostas ao cliente.