forlogic-core 2.0.5 → 2.0.7

package/docs/KNOWLEDGE.md

@@ -1,7 +1,8 @@
 # KNOWLEDGE — Regras Críticas do Projeto
 
 > 🤖 **Para IA**: Detalhes de componentes, props e tipos → ler do projeto **Admin** via cross-project.
-> Consulte `.note/memory/` para padrões de layout e componentes.
+> Padrões universais (componentes, layout, CRUD, scroll) → `docs/design-system/patterns/`
+> Padrões internos do Admin → `.note/memory/`
 
 ---
 
@@ -100,10 +101,9 @@ supabase.from('tabela').select('*');
 
 | Fonte | Caminho | Conteúdo |
 |-------|---------|----------|
-| Memory components | `.note/memory/components/` | Props, variantes e exemplos de componentes |
-| Memory patterns | `.note/memory/patterns/` | Layouts, setup, convenções, regras do projeto |
-| Memory features | `.note/memory/features/` | Contexto de features específicas do projeto |
+| **Padrões universais** | `docs/design-system/patterns/` | Componentes, CRUD, layout, scroll, setup — acessível via cross-project |
+| Padrões internos Admin | `.note/memory/` | Lógicas específicas do Admin (alias, doc-sync, env detection) |
 | Código-fonte da lib | Cross-project → projeto **Admin** (forlogic-core) | Props, tipos, implementação |
 | Design System (visual) | Rota `/ds` no app do projeto **Admin** | Documentação interativa |
 
-> ℹ️ `.note/memory/` usa 3 pastas padronizadas: `components/`, `patterns/`, `features/`. `KNOWLEDGE.md` é a fonte única de verdade para regras e convenções.
+> ℹ️ Padrões universais foram migrados de `.note/memory/` para `docs/design-system/patterns/` para ficarem acessíveis a todos os projetos consumidores via `@Admin docs/design-system/patterns/`. `KNOWLEDGE.md` é a fonte única de verdade para regras e convenções.

package/docs/PROJECT_KNOWLEDGE_TEMPLATE.md

@@ -104,14 +104,17 @@ import {
 
 ---
 
-## 7. Instrução para IA
-
-Antes de criar qualquer componente, leia via cross-project:
-
-- `@Admin docs/design-system/crud.md` — listagens
-- `@Admin docs/design-system/inputs.md` — formulários
-- `@Admin docs/design-system/selectors.md` — selects/combos
-- `@Admin docs/design-system/layout.md` — estrutura de página
-- `@Admin docs/design-system/dialogs.md` — modais
+## 7. Fontes de Contexto (Cross-Project)
+
+Antes de criar qualquer componente, leia via cross-project (`@Admin`):
+
+| O que | Onde buscar |
+|-------|------------|
+| Padrões universais (componentes, CRUD, layout, scroll, setup) | `@Admin docs/design-system/patterns/` |
+| Índice dos padrões | `@Admin docs/design-system/patterns/README.md` |
+| Documentação MD do Design System | `@Admin docs/design-system/*.md` |
+| Código-fonte dos componentes | `@Admin lib/components/ui/` |
+| Implementação CRUD | `@Admin lib/crud/` |
+| Design System visual | Rota `/ds` no app Admin |
 
 Nunca crie componentes sem consultar esses arquivos primeiro.

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

package/{.note/memory/patterns/header-metadata-pattern.md → docs/design-system/patterns/header-metadata.md}

@@ -5,7 +5,7 @@
 **O padrão da aplicação é exibir título, subtítulo e breadcrumbs no header** usando `usePageMetadata()`.
 
 - **NÃO** usar `BodyContent` ou `ContentContainer` com título/subtítulo internos por padrão.
-- Breadcrumbs, títulos e subtítulos internos ao conteúdo são **exceções** e devem ser usados **somente quando explicitamente solicitados** pelo usuário.
+- Breadcrumbs, títulos e subtítulos internos ao conteúdo são **exceções** e devem ser usados **somente quando explicitamente solicitados**.
 
 ## Uso Padrão
 
@@ -55,8 +55,3 @@ usePageMetadata({
   </ContentContainer>
 </BodyContent>
 ```
-
-## Quando usar breadcrumbs/título interno
-
-- Apenas quando o usuário **pedir explicitamente** breadcrumbs ou título dentro do conteúdo.
-- Páginas com navegação hierárquica profunda podem justificar breadcrumbs, mas sempre confirmar antes.

package/{.note/memory → docs/design-system}/patterns/i18n-setup.md

@@ -30,7 +30,6 @@ t('save') com override no app → app: "Gravar" (sobrescreve core)
 ```ts
 import { i18n } from 'forlogic-core';
 console.log('Resources:', i18n.store.data);
-// { 'pt-BR': { core: {...}, app: {...} } }
 ```
 
 ## Troubleshooting

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

@@ -1,5 +1,4 @@
-# Memory: components/pagination-usage
-Updated: now
+# Padrão: Paginação
 
 **SEMPRE** usar `Pagination` ou `CrudPrimitivePagination` da lib. NUNCA implementar manualmente.
 

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

@@ -1,5 +1,4 @@
-# Memory: patterns/single-scroll-pattern
-Updated: now
+# Padrão: Scroll Único no Viewport
 
 O padrão de Scroll Único evita barras de rolagem duplicadas na aplicação.
 

package/{.note/memory → docs/design-system}/patterns/vite-tailwind-setup.md

@@ -14,9 +14,8 @@ export default defineConfig(({ mode }) => ({
     }),
   ],
   resolve: {
-    alias: { '@': path.resolve(__dirname, './src') }, // DEVE ser absoluto
+    alias: { '@': path.resolve(__dirname, './src') },
   },
-  // optimizeDeps.force: true já vem por padrão via createForlogicViteConfig()
   publicDir: false,
   esbuild: { sourcemap: true, target: 'es2020' },
   build: { chunkSizeWarningLimit: 4000 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forlogic-core",
-  "version": "2.0.5",
+  "version": "2.0.7",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",

package/.note/memory/features/crud-defaults-batteries-included.md

@@ -1,14 +0,0 @@
-# Memory: features/crud-defaults-batteries-included
-
-Todos os CRUDs (CrudTable, createCrudPage) agora incluem por padrão:
-- **Column resize** (`enableColumnResize=true`) — já era default
-- **Column manager** (`enableColumnManager=true`) — botão ⋮ no header da coluna "Ações"
-- **Sort** — **todas as colunas são ordenáveis por padrão** (`sortable` default `true`). Use `sortable: false` para desabilitar.
-- **Busca** — por padrão usa a busca global do header (não a action bar). Para busca na action bar, usar `showSearch=true`
-- **Storage keys** — `createCrudPage` gera automaticamente `columnManagerStorageKey` e `resizeStorageKey` a partir do `entityName`
-
-**NÃO vem por padrão:**
-- **Agrupamento** (`enableGrouping=false`) — precisa ser habilitado explicitamente com `enableGrouping={true}`
-- **Busca na action bar** (`showSearch=false`) — padrão é busca no header
-
-**Paginação:** padrão de 25 itens por página.

package/.note/memory/features/crud-standardized-config-props.md

@@ -1,3 +0,0 @@
-# Memory: features/crud-standardized-config-props
-
-A interface CrudPageConfig foi estendida para padronizar a experiência do usuário (UX) em todos os CRUDs (createCrudPage, CrudTable, CrudGrid). As novas propriedades incluem: showNewButton (default: true), showSearch (default: true), showBulkActions (alias para enableBulkActions), showActionBar (default: true, substituindo hideActionBar), newButtonLabel (para customizar o texto do botão de criação) e searchPlaceholder. 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/.note/memory/patterns/components-registry.md

@@ -1,18 +0,0 @@
-# Memory: documentation/consolidated-components-registry
-Updated: now
-
-Design System maintains a Consolidated Components Registry tracking components documented together under single documentation entries for reusability reference:
-
-- **Breadcrumb** (documents Breadcrumb and PageBreadcrumb)
-- **Calendar & Date Picker** (documents Calendar and DatePicker)
-- **Combobox** (documents Combobox with Command used internally)
-- **Toggle & Group** (documents Toggle and ToggleGroup)
-- **Skeleton** (documents base Skeleton and all skeleton variants)
-- **AppSidebar** (documents AppSidebar, Sidebar base component, SidebarProvider, SidebarMenu*, Collapsible integration)
-- **Accordion** (documents Accordion and Collapsible)
-- **Input** (documents Input, InputGroup, InputGroupAddon, InputGroupButton)
-- **Grid & Stack** (documents Grid and Stack layout components)
-- **Dialog** (documents Dialog, AlertDialog, Sheet positional variants, Drawer)
-- **Tabs** (documents Tabs and TabPageLayout)
-
-This registry must be checked before creating new documentation to avoid duplicates. The Sidebar base component from Shadcn is documented as a subsection within AppSidebarDoc for users who need to create custom sidebars outside the AppLayout context.

package/.note/memory/patterns/crud-action-bar-3-zone-layout.md

@@ -1,3 +0,0 @@
-# Memory: patterns/crud-action-bar-3-zone-layout
-
-O CrudActionBar (lib/crud/components/CrudActionBar.tsx) é o componente compartilhado que unifica a barra de ações de todos os CRUDs do sistema. Ele implementa um layout rígido de 3 zonas: ESQUERDA (Botão Novo + Dropdown de Ações em Lote), CENTRO (Barra de busca centralizada) e DIREITA (Filtros customizados + Toggle de visualização). Este componente substitui as implementações locais de barra de ferramentas no CrudTable, CrudGrid e createCrudPage, garantindo que a barra superior tenha sempre o mesmo visual (bg-muted/50), comportamento e espaçamento, independentemente do componente de visualização de dados utilizado.

package/.note/memory/patterns/crud-bulk-actions-dropdown-standard.md

@@ -1,3 +0,0 @@
-# Memory: patterns/crud-bulk-actions-dropdown-standard
-
-As ações em lote foram unificadas em um dropdown 'Ações em lote' no CrudActionBar. Este menu permanece visível se habilitado, exibindo um badge com a contagem de itens selecionados. As opções internas são desabilitadas se a seleção for zero. 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.