forlogic-core 2.0.6 → 2.0.8

package/dist/leadership/components/LeadershipPage.d.ts

@@ -13,7 +13,7 @@ export interface LeadershipPageProps {
     columns?: TreeTableColumn<LeaderNode>[];
     /** Header da coluna de nome (default: "Líder") */
     nameHeader?: string;
-    /** Texto da zona de drop raiz (default: "Tornar Líder Raiz") */
+    /** Texto da zona de drop raiz (default: t('leadership_make_root')) */
     rootDropLabel?: string;
 }
 export declare function LeadershipPage({ unassociatedUsers, onAssociateUser, onMoveNode: customMoveNode, onMoveNodes: customMoveNodes, columns: customColumns, nameHeader, rootDropLabel, }?: LeadershipPageProps): import("react/jsx-runtime").JSX.Element;

package/dist/media/components/ImageRenderer.d.ts

@@ -12,7 +12,7 @@
  *   content={{
  *     imageUrl: 'https://example.com/image.jpg',
  *     caption: 'Minha imagem',
- *     alt: 'Descrição da imagem',
+ *     alt: t('image_description'),
  *     alignment: 'center',
  *     allowDownload: true
  *   }}

package/dist/media/components/VideoEditor.d.ts

@@ -1,22 +1,2 @@
-/**
- * Video Editor Component
- *
- * Editor genérico de vídeo para forlogic-core.
- * Suporta URL, upload e código embed.
- *
- * @example
- * ```tsx
- * import { VideoEditor } from 'forlogic-core';
- *
- * <VideoEditor
- *   value={videoData}
- *   onChange={setVideoData}
- *   onSubmit={handleSave}
- *   onCancel={handleCancel}
- *   uploadFunction={myUploadFunction}
- *   uploadOptions={{ bucket: 'videos', folder: 'content' }}
- * />
- * ```
- */
 import type { MediaEditorProps, VideoBlockContent } from '../types';
 export declare function VideoEditor({ value, onChange, onSubmit, onCancel, uploadFunction, deleteFunction, uploadOptions }: MediaEditorProps<VideoBlockContent>): import("react/jsx-runtime").JSX.Element;

package/dist/media/components/VideoRenderer.d.ts

@@ -1,8 +1,2 @@
-/**
- * Video Renderer Component
- *
- * Renderizador genérico de vídeo para forlogic-core.
- * Suporta YouTube, Vimeo e arquivos diretos.
- */
 import type { MediaRendererProps, VideoBlockContent } from '../types';
 export declare function VideoRenderer({ content, className, style }: MediaRendererProps<VideoBlockContent>): import("react/jsx-runtime").JSX.Element;

package/dist/qualiex/components/QualiexUserField.d.ts

@@ -52,7 +52,7 @@ export type QualiexUserDisplayFormat = 'name' | 'name-email' | 'name-role' | 'cu
  * // Display customizado
  * <QualiexUserField
  *   displayFormat="custom"
- *   customDisplayFn={(user) => `${user.userName} - ${user.placeName || 'Sem local'}`}
+ *   customDisplayFn={(user) => `${user.userName} - ${user.placeName || t('no_place_selected')}`}
  *   value={userId}
  *   onChange={setUserId}
  * />

package/dist/types.d.ts

@@ -405,6 +405,7 @@ export interface UserInfo {
     name: string;
     identifier: string;
     alias?: string;
+    isSysAdmin: boolean;
 }
 export interface Company {
     id: string;

package/docs/WORKSPACE_KNOWLEDGE.md

@@ -0,0 +1,254 @@
+# forlogic-core — Workspace Knowledge
+
+> **Documento de referência** para todos os projetos que consomem `forlogic-core`.
+> Cole este conteúdo como **Workspace Knowledge** no Lovable.
+
+---
+
+## 🔗 Cross-Project: Projeto Admin (DS + Lib)
+
+> **Para consultar componentes, props, tipos, exemplos e implementação**: use cross-project (`@Admin`) para ler arquivos do projeto **"Admin"** (`qualiex-admin`).
+
+### Caminhos úteis no projeto Admin
+
+| O que procurar | Caminho no Admin |
+|----------------|------------------|
+| Código-fonte dos componentes UI | `lib/components/ui/` |
+| Sistema CRUD | `lib/crud/` |
+| Barrel exports (lista completa) | `lib/exports/ui.ts`, `lib/exports/index.ts` |
+| Documentação MD do Design System | `docs/design-system/` |
+| Docs interativos (código-fonte) | `src/design-system/docs/` |
+| Hooks compartilhados | `lib/hooks/` |
+| Providers (CoreProviders) | `lib/providers/` |
+| Serviços (Base, Email, Error) | `lib/services/` |
+| Config Vite/Tailwind | `lib/vite/`, `lib/tailwind/` |
+| Constituição (regras canônicas) | `spec/constitution.md` |
+| Prompt template | `docs/PROMPT_TEMPLATE.md` |
+| Project Knowledge template | `docs/PROJECT_KNOWLEDGE_TEMPLATE.md` |
+| Starter template | `docs/STARTER_TEMPLATE.md` |
+| Golden snippets | `docs/design-system/examples.md` |
+
+---
+
+## 0. Schema do Projeto
+
+> ⚠️ **O schema é definido no `README.md` de cada projeto.** Consulte-o antes de qualquer query.
+
+```ts
+// ✅ CORRETO — substituir pelo schema do projeto (ex: 'common', 'docs', etc.)
+supabase.schema('SCHEMA_DO_PROJETO').from('tabela').select('*');
+
+// ❌ ERRADO (vai falhar em produção)
+supabase.from('tabela').select('*');
+```
+
+> Nunca usar o schema `public`. Cada projeto tem seu próprio schema documentado no `README.md`.
+
+---
+
+## 1. Constituição — Regras Canônicas
+
+> 📖 **Todas as regras, convenções e melhores práticas estão em `spec/constitution.md`** no projeto Admin.
+
+Antes de implementar qualquer funcionalidade, consulte a constituição via cross-project:
+```
+@Admin spec/constitution.md
+```
+
+### Resumo das regras invioláveis
+
+| Regra | Detalhe |
+|-------|---------|
+| Schema obrigatório | `.schema('...')` em toda query Supabase (schema do `README.md`) |
+| Sem DELETE físico | Soft delete com `deleted_at` + policy `FOR UPDATE` |
+| Sem índices automáticos | Apenas com aprovação explícita + `EXPLAIN ANALYZE` |
+| Sem modificar `.env` | Apenas com autorização do usuário |
+| Sem hardcoded admin | Nunca localStorage/sessionStorage para roles |
+| Lib-first | Usar `forlogic-core` antes de criar componente |
+| Import do Supabase | Sempre `getSupabaseClient()` de `forlogic-core` |
+| Import de i18n | Sempre `useTranslation` de `forlogic-core`, nunca de `react-i18next` |
+
+---
+
+## 2. Lib-First — forlogic-core
+
+> Antes de criar qualquer componente, **verificar se já existe em `forlogic-core`**.
+
+```ts
+// ✅ CORRETO
+import { Button, Dialog, Input, Combobox, ActionButton, useTranslation } from 'forlogic-core';
+
+// ❌ PROIBIDO — criar componente local que já existe na lib
+import { MyCustomButton } from '@/components/MyCustomButton';
+```
+
+### Checklist
+
+- [ ] Pesquisei se existe na forlogic-core?
+- [ ] Verifiquei o Design System (`@Admin docs/design-system/`)?
+- [ ] Pode ser alcançado com props/variantes existentes?
+
+### Exceções permitidas
+
+1. Componente específico de domínio de negócio (ex: `InvoiceCard`)
+2. Composição de componentes da lib (wrapper Dialog + Form)
+3. Protótipo temporário que será migrado para a lib
+
+---
+
+## 3. Design System — Categorias
+
+> Para ver props e exemplos: `@Admin docs/design-system/<arquivo>.md`
+
+| Categoria | Arquivo |
+|-----------|---------|
+| Fundação | `foundation.md` |
+| Botões & Ações | `buttons-actions.md` |
+| Inputs | `inputs.md` |
+| Seletores | `selectors.md` |
+| Data Display | `data-display.md` |
+| Data Grid | `tables-grids.md` |
+| Gráficos & Dashboards | `charts-dashboards.md` |
+| Navegação | `navigation.md` |
+| Dialogs | `dialogs.md` |
+| Notifications & Feedback | `notifications-feedback.md` |
+| Layout | `layout.md` |
+| CRUD | `crud.md` |
+| Plataforma | `platform.md` |
+| Business Components | `domain.md` |
+| Developer Tools | `infra-utils.md` |
+
+### Aliases disponíveis
+
+| Original | Alias(es) |
+|----------|-----------|
+| Combobox | SelectSearch, MultiSelect, EntitySelect, AutoComplete |
+| ComboTree | TreeSelect |
+| StepSelector | Stepper |
+| ActionButton | ActionMenu, RowActions |
+| TruncatedCell | EllipsisText |
+| CrudPrimitiveTable | DataTable |
+| CrudPrimitivePagination | DataPagination |
+| CrudPrimitiveFilterBar | DataFilterBar |
+
+---
+
+## 4. Instrução para IA — Leitura Obrigatória
+
+**QUANDO** criar ou modificar qualquer arquivo `.tsx` com JSX:
+
+- **SE** contém tabela, listagem ou CRUD → **LER** `@Admin docs/design-system/crud.md` e `@Admin docs/design-system/tables-grids.md` ANTES
+- **SE** contém formulário, input ou campo → **LER** `@Admin docs/design-system/inputs.md` e `@Admin docs/design-system/selectors.md` ANTES
+- **SE** contém modal ou confirmação → **LER** `@Admin docs/design-system/dialogs.md` ANTES
+- **SE** contém botões ou ações de linha → **LER** `@Admin docs/design-system/buttons-actions.md` ANTES
+- **SE** é estrutura de página/layout → **LER** `@Admin docs/design-system/layout.md` ANTES
+
+**SEMPRE** consultar `@Admin docs/design-system/examples.md` como referência de implementação.
+
+**VALIDAÇÃO pós-geração**: Todo import de componente visual DEVE vir de `forlogic-core`. Se criou componente local que existe na lib, refatore imediatamente.
+
+---
+
+## 5. Padrões CRUD
+
+### Toolbar — Layout obrigatório de 3 zonas
+
+| Zona | Posição | Conteúdo |
+|------|---------|----------|
+| Esquerda | `justify-start` | Botão "Novo" + Dropdown ações em lote |
+| Centro | `flex-1 max-w-md` | Campo de busca |
+| Direita | `justify-end` | Filtros + Toggle view |
+
+### Defaults obrigatórios
+
+- Paginação: `CrudPrimitivePagination variant="full"`, **10 itens/página** (menor opção)
+- Column resize: ativado por padrão
+- Column manager: ativado por padrão
+- Ordenação: ativada em todas as colunas por padrão
+- Busca: na action bar com `showSearch=true`
+- Ações de linha: sempre usar `ActionButton` da lib
+
+---
+
+## 6. Padrões Deprecated
+
+| ❌ Não usar | ✅ Usar |
+|------------|--------|
+| `BulkActionBar` separado | Dropdown no `CrudActionBar` |
+| `<MoreHorizontal>` genérico | `ActionButton` |
+| Paginação manual | `CrudPrimitivePagination` |
+| `StatusSelect` | `Combobox` |
+| `DeleteConfirmationDialog` | `Dialog` |
+| `Searchbar` | `Input` com ícone |
+| Schema `public` | `.schema('...')` com schema do projeto |
+
+---
+
+## 7. Feature Flags
+
+| 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 `🔑 chave` 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 |
+
+Todas precisam do prefixo `VITE_` para serem expostas ao cliente.
+
+---
+
+## 8. Configuração — Setup do Projeto
+
+### CoreProviders
+
+```tsx
+import { CoreProviders } from 'forlogic-core';
+import ptBR from './i18n/pt-BR.json';
+
+function App() {
+  return (
+    <CoreProviders moduleAlias="seu-modulo" appTranslations={{ 'pt-BR': ptBR, 'en-US': enUS }}>
+      <BrowserRouter><Routes /></BrowserRouter>
+    </CoreProviders>
+  );
+}
+```
+
+### Vite
+
+```ts
+import { createSecurityHeadersPlugin } from 'forlogic-core/vite';
+
+export default defineConfig(({ mode }) => ({
+  plugins: [
+    react(),
+    createSecurityHeadersPlugin(mode === 'development', {
+      supabaseUrls: ['https://SEU_PROJETO.supabase.co'],
+      additionalConnectSrc: ['https://*.qualiex.com'],
+    }),
+  ],
+  resolve: { alias: { '@': path.resolve(__dirname, './src') } },
+}));
+```
+
+### Tailwind
+
+```ts
+import { forlogicTailwindPreset, forlogicContentPaths } from 'forlogic-core/tailwind';
+
+export default {
+  presets: [forlogicTailwindPreset],
+  content: [...forlogicContentPaths],
+} satisfies Config;
+```
+
+---
+
+## 9. Estrutura de Documentação
+
+| Local | Responsabilidade |
+|-------|-----------------|
+| `README.md` (raiz de cada projeto) | **Schema do projeto** — única fonte canônica |
+| `spec/constitution.md` (projeto Admin) | **Regras e convenções** — fonte canônica para todos os projetos |
+| `docs/design-system/` (projeto Admin) | **Design System** — documentação de componentes |
+| Rota `/ds` no app Admin | **Design System visual** — documentação interativa |

package/docs/design-system/README.md

@@ -3,7 +3,7 @@
 
 # Design System — forlogic-core
 
-> Gerado automaticamente em 2026-04-06
+> Gerado automaticamente em 2026-04-08
 > Total: 92 componentes documentados em 15 categorias
 
 ## Categorias

package/docs/design-system/patterns/README.md

@@ -0,0 +1,53 @@
+# Design System — Padrões Universais
+
+> Padrões obrigatórios para todos os projetos que consomem `forlogic-core`.
+> Acessível via cross-project: `@Admin docs/design-system/patterns/`
+
+## Índice
+
+### Componentes
+
+| Arquivo | Descrição |
+|---------|-----------|
+| [action-button.md](action-button.md) | Uso obrigatório do ActionButton em tabelas |
+| [alertdialog-deletion.md](alertdialog-deletion.md) | AlertDialog para exclusões permanentes |
+| [baseform-usage.md](baseform-usage.md) | BaseForm — formulário dinâmico CRUD |
+| [baseform-custom-fields.md](baseform-custom-fields.md) | Campos customizados no BaseForm |
+| [combo-tree.md](combo-tree.md) | ComboTree — seleção hierárquica |
+| [delete-confirmation.md](delete-confirmation.md) | Dialog de confirmação de exclusão |
+| [dialog-structure.md](dialog-structure.md) | Tamanhos e estrutura obrigatória do Dialog |
+| [dialog-variants.md](dialog-variants.md) | Variantes semânticas do Dialog |
+| [pagination.md](pagination.md) | Paginação padronizada |
+
+### Padrões de Layout & Scroll
+
+| Arquivo | Descrição |
+|---------|-----------|
+| [dialog-body-scroll.md](dialog-body-scroll.md) | Scroll interno em Dialogs |
+| [body-content-scroll.md](body-content-scroll.md) | Scroll em páginas (BodyContent) |
+| [single-scroll.md](single-scroll.md) | Padrão de scroll único no viewport |
+
+### Padrões CRUD
+
+| Arquivo | Descrição |
+|---------|-----------|
+| [crud-toolbar.md](crud-toolbar.md) | Layout 3 zonas da toolbar |
+| [crud-bulk-actions.md](crud-bulk-actions.md) | Ações em lote via dropdown |
+| [crud-defaults.md](crud-defaults.md) | Defaults obrigatórios (resize, sort, etc.) |
+| [crud-config-props.md](crud-config-props.md) | Props padronizadas de configuração |
+
+### Setup & Configuração
+
+| Arquivo | Descrição |
+|---------|-----------|
+| [core-providers.md](core-providers.md) | Setup obrigatório do CoreProviders |
+| [vite-tailwind-setup.md](vite-tailwind-setup.md) | Configuração Vite + Tailwind |
+| [i18n-setup.md](i18n-setup.md) | Setup de internacionalização |
+| [feature-flags.md](feature-flags.md) | Feature flags disponíveis |
+| [header-metadata.md](header-metadata.md) | Padrão de título/subtítulo via header |
+
+### Referência
+
+| Arquivo | Descrição |
+|---------|-----------|
+| [components-registry.md](components-registry.md) | Registry de componentes consolidados |

package/{.note/memory/components/action-button-for-tables.md → docs/design-system/patterns/action-button.md}

@@ -1,5 +1,4 @@
-# Memory: components/action-button-for-tables
-Updated: now
+# Padrão: ActionButton para Tabelas
 
 Uso de `ActionButton` é **OBRIGATÓRIO** para menus de ação em linhas de tabela.
 

package/{.note/memory/components/alertdialog-permanent-deletion.md → docs/design-system/patterns/alertdialog-deletion.md}

@@ -1,5 +1,4 @@
-# Memory: components/alertdialog-permanent-deletion
-Updated: now
+# Padrão: AlertDialog para Exclusão Permanente
 
 AlertDialog é usado **apenas** para exclusões permanentes que requerem digitação de confirmação:
 

package/{.note/memory/components → docs/design-system/patterns}/baseform-custom-fields.md

@@ -1,5 +1,4 @@
-# Memory: components/baseform-custom-fields
-Updated: now
+# Padrão: BaseForm — Campos Customizados
 
 Campos customizados no BaseForm usam `type: 'custom'` com `component` ou `render`:
 
@@ -23,7 +22,7 @@ Campos customizados no BaseForm usam `type: 'custom'` com `component` ou `render
   type: 'custom',
   component: FileUpload,
   componentProps: (formData) => ({
-    required: !formData?.id, // Obrigatório só no cadastro
+    required: !formData?.id,
     accept: '.pdf,.doc',
   }),
 }

package/{.note/memory/components → docs/design-system/patterns}/baseform-usage.md

@@ -1,5 +1,4 @@
-# Memory: components/baseform-usage
-Updated: now
+# Padrão: BaseForm — Formulário Dinâmico
 
 BaseForm é o formulário dinâmico do sistema CRUD, configurado via `sections` e `fields`.
 

package/{.note/memory/patterns/body-content-scroll-usage.md → docs/design-system/patterns/body-content-scroll.md}

@@ -1,5 +1,4 @@
-# Memory: patterns/body-content-scroll-usage
-Updated: now
+# Padrão: Scroll em Páginas (BodyContent)
 
 ## Quando Usar Cada Abordagem
 
@@ -30,14 +29,12 @@ import { BodyContent } from 'forlogic-core';
   {/* Conteúdo original mantido sem alterações */}
   <div className="p-6">
     <h1>Título Original</h1>
-    {/* ... */}
   </div>
 </BodyContent>
 ```
 
 ### ✅ Container Mínimo (Sem BodyContent)
 ```tsx
-// Apenas scroll, sem dependência do forlogic-core
 <div className="h-full overflow-y-auto">
   {/* Conteúdo original */}
 </div>

package/{.note/memory/components → docs/design-system/patterns}/combo-tree.md

@@ -1,5 +1,4 @@
-# Memory: ui/components/combo-tree
-Updated: today
+# 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).
 

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

@@ -0,0 +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.

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

@@ -0,0 +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

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

@@ -0,0 +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.

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

@@ -0,0 +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`.

package/{.note/memory/patterns/crud-toolbar-layout.md → docs/design-system/patterns/crud-toolbar.md}

@@ -1,13 +1,12 @@
-# Memory: patterns/crud-toolbar-layout
-Updated: now
+# Padrão: CRUD Toolbar — Layout 3 Zonas
 
-Toolbar CRUD segue layout obrigatório de 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) |
+| 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` | Botões Filtro/Ações |
+| Direita | `justify-end` | Filtros customizados + Toggle de visualização |
 
 ```tsx
 // ✅ CORRETO
@@ -23,4 +22,7 @@ Toolbar CRUD segue layout obrigatório de 3 zonas:
 </div>
 ```
 
-**Regra**: Botão de criação NUNCA deve ficar isolado no cabeçalho do Card.
+**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/{.note/memory/components/delete-confirmation-dialog.md → docs/design-system/patterns/delete-confirmation.md}

@@ -1,5 +1,4 @@
-# Memory: components/delete-confirmation-dialog
-Updated: now
+# 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):
 
@@ -10,24 +9,17 @@ Dialog de exclusão segue padrão visual específico (NÃO usar AlertDialog para
       <DialogTitle className="sr-only">Confirmação</DialogTitle>
     </DialogHeader>
     
-    {/* Conteúdo centralizado */}
     <div className="flex flex-col items-center text-center space-y-3 py-4">
-      {/* Ícone de alerta */}
       <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>
-      
-      {/* Título */}
       <h3 className="text-lg font-semibold">Tem certeza?</h3>
-      
-      {/* Mensagem em duas linhas */}
       <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>
     
-    {/* Botões centralizados */}
     <DialogFooter className="justify-center gap-2 mt-6">
       <Button variant="outline" onClick={() => setOpen(false)}>
         Cancelar

package/{.note/memory/patterns/dialog-body-scroll-pattern.md → docs/design-system/patterns/dialog-body-scroll.md}

@@ -1,11 +1,10 @@
-# Memory: patterns/dialog-body-scroll-pattern
-Updated: now
+# 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-1 -mx-1">
+<div className="flex-1 min-h-0 overflow-auto py-4 px-2 -mx-2">
   {/* Conteúdo scrollável */}
 </div>
 
@@ -22,6 +21,6 @@ Conteúdo de Dialog/Sheet com scroll interno **DEVE** usar o padrão responsivo:
 | `min-h-0` | Permite shrink em flex container |
 | `overflow-auto` | Habilita scroll quando necessário |
 | `py-4` | Padding vertical padrão (16px) |
-| `px-1 -mx-1` | Previne corte de focus rings |
+| `px-2 -mx-2` | Previne corte de focus rings (8px de respiro) |
 
 **Aplica-se a:** Dialog, Sheet, Drawer, AlertDialog

package/{.note/memory/components/dialog-sizes-and-structure.md → docs/design-system/patterns/dialog-structure.md}

@@ -1,5 +1,4 @@
-# Memory: components/dialog-sizes-and-structure
-Updated: now
+# Padrão: Dialog — Tamanhos e Estrutura
 
 Dialog possui 3 tamanhos opcionais (sem default) e estrutura obrigatória:
 

package/{.note/memory/components → docs/design-system/patterns}/dialog-variants.md

@@ -1,11 +1,8 @@
-# Memory: components/dialog-variants
-Updated: 2026-02-26
-
-## Variantes Semânticas do Dialog
+# Padrão: Dialog — Variantes Semânticas
 
 O `DialogContent` possui uma prop `variant` que controla o comportamento de fechamento:
 
-### Variantes
+## Variantes
 
 | Variante | Clique externo | ESC | Botão X | Uso |
 |----------|---------------|-----|---------|-----|
@@ -15,7 +12,7 @@ O `DialogContent` possui uma prop `variant` que controla o comportamento de fech
 
 \* Com `isDirty={true}`, exibe `window.confirm` antes de fechar.
 
-### Props
+## Props
 
 ```typescript
 interface DialogContentProps {
@@ -24,7 +21,7 @@ interface DialogContentProps {
 }
 ```
 
-### Padrão de uso
+## Padrão de uso
 
 ```tsx
 // Formulários
@@ -37,7 +34,7 @@ interface DialogContentProps {
 <DialogContent variant="informative">
 ```
 
-### Regras
+## 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