forlogic-core 1.10.0 → 1.10.2

package/README.md

@@ -187,84 +187,96 @@ CREATE INDEX idx_processes_title ON processes.processes(title);
 
 ---
 
+## 🚩 Feature Flags (Variáveis de Ambiente)
+
+A biblioteca suporta feature flags para habilitar/desabilitar funcionalidades opcionais.
+
+### Variáveis Disponíveis
+
+| Variável | Descrição | Valores | Padrão |
+|----------|-----------|---------|--------|
+| `VITE_SHOW_USER_PREFERENCES` | Exibe opção de "Preferências" no menu do usuário (idioma, timezone, formato de data) | `"true"` / `"false"` | Não exibe |
+| `VITE_I18N_DEBUG_MODE` | Modo debug de internacionalização (mostra chaves ao invés de traduções) | `"true"` / `"false"` | `"false"` |
+| `VITE_IS_QUALIEX` | Define se usa logos Qualiex ou Forlogic | `"true"` / `"false"` | `"false"` |
+
+### Configuração
+
+Adicione no seu arquivo `.env`:
+
+```env
+# Habilitar opção de preferências no perfil do usuário
+VITE_SHOW_USER_PREFERENCES=true
+
+# Modo debug de i18n (mostra chaves com ícones)
+VITE_I18N_DEBUG_MODE=false
+
+# Usar logos Qualiex
+VITE_IS_QUALIEX=true
+```
+
+> **Nota**: Variáveis de ambiente em Vite precisam ter o prefixo `VITE_` para serem expostas ao cliente.
+
+---
+
 <!-- AUTO_GENERATED_START -->
 
 ### 📚 Estatísticas da Documentação
 
-**68 Componentes UI** | **8 Tokens** | **2 Ferramentas CRUD**
+**49 Componentes UI** | **6 Tokens** | **2 Ferramentas CRUD**
 
 ---
 
 ### 🎨 Fundamentos (Tokens)
 
-- [Colors](./docs/DESIGN_SYSTEM.md#colors) - Sistema de cores semânticas que se adaptam aos temas claro e escuro.
 - [Colors Foundation](./docs/DESIGN_SYSTEM.md#colorsfoundation) - Sistema de cores completo com escalas neutras, de marca e funcionais.
 - [Radius](./docs/DESIGN_SYSTEM.md#radius) - Sistema de arredondamento de bordas para consistência visual.
 - [Shadows](./docs/DESIGN_SYSTEM.md#shadows) - Sistema de sombras e elevação para criar profundidade e hierarquia.
 - [Spacing](./docs/DESIGN_SYSTEM.md#spacing) - Escala de espaçamento consistente baseada em uma unidade base de 4px.
 - [Typography](./docs/DESIGN_SYSTEM.md#typographycomponent) - Componentes de tipografia para estilos de texto consistentes em toda a sua aplicação.
-- [Typography](./docs/DESIGN_SYSTEM.md#typography) - Escala tipográfica abrangente construída sobre princípios tipográficos comprovados.
 - [Typography Foundation](./docs/DESIGN_SYSTEM.md#typographyfoundation) - Sistema tipográfico completo com Display, Headings, Body e mais.
 
 ### 🧩 Componentes UI
 
 - [Accordion](./docs/DESIGN_SYSTEM.md#accordion) - Um conjunto de cabeçalhos interativos empilhados verticalmente, onde cada um revela uma seção de conteúdo.
 - [Action Button](./docs/DESIGN_SYSTEM.md#actionbutton) - Botão compacto otimizado para ações em linhas de tabela e menus dropdown.
-- [Alert](./docs/DESIGN_SYSTEM.md#alert) - Exibe um destaque para chamar a atenção do usuário.
-- [Alert Dialog](./docs/DESIGN_SYSTEM.md#alertdialog) - Um diálogo modal que interrompe o usuário com conteúdo importante e espera uma resposta.
+- [Alert](./docs/DESIGN_SYSTEM.md#alert) - Exibe uma mensagem de destaque para chamar a atenção do usuário.
 - [Aspect Ratio](./docs/DESIGN_SYSTEM.md#aspectratio) - Exibe conteúdo dentro de uma proporção desejada.
 - [Avatar](./docs/DESIGN_SYSTEM.md#avatar) - Um elemento de imagem com fallback para representar o usuário.
 - [Badge](./docs/DESIGN_SYSTEM.md#badge) - Exibe um badge ou um componente que se parece com um badge.
-- [Breadcrumb](./docs/DESIGN_SYSTEM.md#breadcrumb) - Exibe o caminho para o recurso atual usando uma hierarquia de links.
-- [Button](./docs/DESIGN_SYSTEM.md#button) - Exibe um botão ou um componente que se parece com um botão.
+- [Breadcrumb](./docs/DESIGN_SYSTEM.md#breadcrumb) - Exibe o caminho até o recurso atual usando uma hierarquia de links.
+- [Button](./docs/DESIGN_SYSTEM.md#button) - Componente de botão com variantes semânticas, tamanhos e estados. Use para ações primárias, secundárias e destrutivas.
 - [Button Group](./docs/DESIGN_SYSTEM.md#buttongroup) - Agrupa botões relacionados com espaçamento e bordas apropriados.
-- [Button Variants](./docs/DESIGN_SYSTEM.md#buttonvariants) - Variantes completas de botão com primary, secondary, tertiary, outline, ghost, subtle, destructive, link e icon.
-- [Calendar](./docs/DESIGN_SYSTEM.md#calendar) - Um componente de campo de data que permite aos usuários inserir e editar datas.
+- [Calendar & Date Picker](./docs/DESIGN_SYSTEM.md#calendar) - Componentes para seleção de datas. O Calendar exibe um calendário interativo, enquanto o Date Picker combina um campo de input com o calendário em um popover.
 - [Card](./docs/DESIGN_SYSTEM.md#card) - Exibe um card com cabeçalho, conteúdo e rodapé.
 - [Carousel](./docs/DESIGN_SYSTEM.md#carousel) - Um componente de carrossel para alternar entre elementos. Nota: Este componente requer a biblioteca Embla Carousel que não está incluída no forlogic-core por padrão.
 - [Checkbox](./docs/DESIGN_SYSTEM.md#checkbox) - Um controle que permite ao usuário alternar entre marcado e desmarcado.
 - [Collapsible](./docs/DESIGN_SYSTEM.md#collapsible) - Um componente interativo que expande/colapsa um painel.
 - [Color Picker](./docs/DESIGN_SYSTEM.md#colorpicker) - Seletor de cores com paleta predefinida e seletor customizado.
-- [Combobox](./docs/DESIGN_SYSTEM.md#combobox) - Componente versátil para seleção única ou múltipla com busca inteligente.
-- [Command](./docs/DESIGN_SYSTEM.md#command) - Menu de comandos rápido, composável e sem estilo para React.
-- [Context Menu](./docs/DESIGN_SYSTEM.md#contextmenu) - Exibe um menu ao usuário — como um conjunto de ações ou funções — acionado por um clique direito.
-- [Data List](./docs/DESIGN_SYSTEM.md#datalist) - Sistema de lista de dados com composição de componentes para exibir informações estruturadas.
-- [Date Picker](./docs/DESIGN_SYSTEM.md#datepicker) - Um componente de seletor de data com intervalo e predefinições.
-- [Delete Dialog](./docs/DESIGN_SYSTEM.md#deletedialog) - Dialog de confirmação de exclusão com design consistente e foco em experiência do usuário.
-- [Dialog](./docs/DESIGN_SYSTEM.md#dialog) - Uma janela sobreposta à janela principal ou a outra janela de diálogo, tornando o conteúdo abaixo inerte.
-- [Drawer](./docs/DESIGN_SYSTEM.md#drawer) - Um componente drawer para dispositivos móveis que desliza da borda da tela.
-- [Dropdown Menu](./docs/DESIGN_SYSTEM.md#dropdownmenu) - Exibe um menu ao usuário — como um conjunto de ações ou funções — acionado por um botão.
+- [Combobox](./docs/DESIGN_SYSTEM.md#combobox) - Componente versátil para seleção única ou múltipla com busca inteligente. Combina Popover e Command para autocomplete.
+- [Context Menu](./docs/DESIGN_SYSTEM.md#contextmenu) - Exibe um menu ao usuário — como um conjunto de ações ou funções — acionado por um clique com o botão direito do mouse.
+- [Dialog](./docs/DESIGN_SYSTEM.md#dialog) - Uma janela sobreposta à janela principal ou a outra janela de diálogo, tornando o conteúdo abaixo inerte. Inclui variações para seleção, tabelas e formulários.
+- [Dropdown Menu](./docs/DESIGN_SYSTEM.md#dropdownmenu) - Exibe um menu ao usuário — como um conjunto de ações ou funções — acionado por um botão ou elemento interativo.
 - [Empty State](./docs/DESIGN_SYSTEM.md#emptystate) - Componente para exibir estados vazios com ícone, mensagem e ação opcional.
 - [Form](./docs/DESIGN_SYSTEM.md#form) - Construindo formulários com React Hook Form e Zod.
 - [Grid](./docs/DESIGN_SYSTEM.md#grid) - Sistema de grid responsivo com configuração simplificada de colunas e espaçamento.
-- [Hover Card](./docs/DESIGN_SYSTEM.md#hovercard) - Para usuários com visão visualizarem conteúdo disponível por trás de um link.
 - [Icon Picker](./docs/DESIGN_SYSTEM.md#iconpicker) - Seletor de ícones da biblioteca Lucide React com busca integrada.
 - [Input](./docs/DESIGN_SYSTEM.md#input) - Exibe um campo de entrada de texto.
-- [Input Group](./docs/DESIGN_SYSTEM.md#inputgroup) - Agrupe um input com addons de prefixo ou sufixo.
+- [Input Group](./docs/DESIGN_SYSTEM.md#inputgroup) - Agrupe inputs com addons de prefixo, sufixo, ícones, botões, tooltips e dropdowns. Segue a API oficial do shadcn/ui.
 - [Input OTP](./docs/DESIGN_SYSTEM.md#inputotp) - Accessible one-time password component with customizable number of inputs. Available in the UI library but not exported from forlogic-core.
-- [Kbd](./docs/DESIGN_SYSTEM.md#kbd) - Displays keyboard shortcut commands.
 - [Label](./docs/DESIGN_SYSTEM.md#label) - Renderiza uma label acessível associada a controles.
-- [Loading State](./docs/DESIGN_SYSTEM.md#loadingstate) - Componente para gerenciar estados de loading de forma declarativa com três tipos: spinner, skeleton e overlay.
-- [Menubar](./docs/DESIGN_SYSTEM.md#menubar) - Um menu visualmente persistente comum em aplicações desktop. Este componente está disponível na biblioteca UI mas não é exportado do forlogic-core.
+- [Loading State](./docs/DESIGN_SYSTEM.md#loadingstate) - Componente para gerenciar estados de loading de forma declarativa com dois tipos: spinner e overlay.
 - [Native Select](./docs/DESIGN_SYSTEM.md#nativeselect) - Elemento select nativo do HTML com estilização.
-- [Navigation Menu](./docs/DESIGN_SYSTEM.md#navigationmenu) - Uma coleção de links para navegação em websites. Este componente está disponível na biblioteca UI mas não é exportado do forlogic-core.
-- [Page Breadcrumb](./docs/DESIGN_SYSTEM.md#pagebreadcrumb) - Componente de navegação breadcrumb com suporte a collapse automático e geração a partir de rotas.
-- [Pagination](./docs/DESIGN_SYSTEM.md#pagination) - Paginação com navegação de páginas, links anterior e próximo.
-- [Popover](./docs/DESIGN_SYSTEM.md#popover) - Exibe conteúdo rico em um portal, acionado por um botão.
+- [Pagination](./docs/DESIGN_SYSTEM.md#pagination) - Barra de paginação completa com seletor de itens por página e controles de navegação.
 - [Progress](./docs/DESIGN_SYSTEM.md#progress) - Exibe um indicador mostrando o progresso de conclusão de uma tarefa, tipicamente exibido como uma barra de progresso.
 - [Radio Group](./docs/DESIGN_SYSTEM.md#radiogroup) - Um conjunto de botões marcáveis—conhecidos como botões de rádio—onde apenas um pode ser marcado por vez.
-- [Resizable](./docs/DESIGN_SYSTEM.md#resizable) - Accessible resizable panel groups and layouts. This component is available in the UI library but not exported from forlogic-core.
-- [Resizable Rail](./docs/DESIGN_SYSTEM.md#resizablerail) - Componente de rail de redimensionamento para criar áreas redimensionáveis com cursor e feedback visual.
+- [Resizable](./docs/DESIGN_SYSTEM.md#resizable) - Grupos de painéis redimensionáveis e layouts acessíveis com suporte a teclado. Construído sobre react-resizable-panels.
 - [Scroll Area](./docs/DESIGN_SYSTEM.md#scrollarea) - Aprimora a funcionalidade de rolagem nativa para estilização personalizada e cross-browser.
 - [Searchbar](./docs/DESIGN_SYSTEM.md#searchbar) - Campo de busca com ícone de pesquisa integrado e botão de limpar opcional. Otimizado para experiências de busca em toda a aplicação.
 - [Select](./docs/DESIGN_SYSTEM.md#select) - Exibe uma lista de opções para o usuário escolher—acionada por um botão.
 - [Separator](./docs/DESIGN_SYSTEM.md#separator) - Separa visual ou semanticamente o conteúdo.
 - [Sheet](./docs/DESIGN_SYSTEM.md#sheet) - Estende o componente Dialog para exibir conteúdo que complementa o conteúdo principal da tela.
-- [Sidebar](./docs/DESIGN_SYSTEM.md#sidebar) - Componente de sidebar composável, tematizável e customizável.
-- [Skeleton](./docs/DESIGN_SYSTEM.md#skeleton) - Use para mostrar um placeholder enquanto o conteúdo está carregando.
-- [Skeleton Variants](./docs/DESIGN_SYSTEM.md#skeletonvariants) - Variantes de skeleton pré-configuradas para tabelas, cards, formulários, headers e sidebars.
+- [Skeleton](./docs/DESIGN_SYSTEM.md#skeleton) - Componente de placeholder para estados de carregamento. Inclui variantes pré-configuradas para tabelas, cards, formulários e mais.
 - [Slider](./docs/DESIGN_SYSTEM.md#slider) - Um input onde o usuário seleciona um valor dentro de um intervalo determinado.
-- [Sonner (Toast)](./docs/DESIGN_SYSTEM.md#sonner) - Um componente de notificação toast alimentado por Sonner.
 - [Spinner](./docs/DESIGN_SYSTEM.md#spinner) - Um componente de spinner de carregamento para indicar estado de carregamento.
 - [Stack](./docs/DESIGN_SYSTEM.md#stack) - Layout de pilha flexível com controle de direção, espaçamento, alinhamento e justificação.
 - [Switch](./docs/DESIGN_SYSTEM.md#switch) - Um controle que permite ao usuário alternar entre marcado e desmarcado.
@@ -272,10 +284,8 @@ CREATE INDEX idx_processes_title ON processes.processes(title);
 - [Table](./docs/DESIGN_SYSTEM.md#table) - Uma tabela semântica para exibir dados tabulares.
 - [Tabs](./docs/DESIGN_SYSTEM.md#tabs) - Um conjunto de seções de conteúdo em camadas—conhecidas como painéis de abas—que são exibidas uma de cada vez.
 - [Textarea](./docs/DESIGN_SYSTEM.md#textarea) - Exibe um textarea de formulário ou um componente que se parece com um textarea.
-- [Toast](./docs/DESIGN_SYSTEM.md#toast) - Uma mensagem sucinta exibida temporariamente (Radix UI Toast). Use o hook useToast de @/hooks/use-toast.
-- [Toggle](./docs/DESIGN_SYSTEM.md#toggle) - Um botão de dois estados que pode estar ligado ou desligado.
-- [Toggle Group](./docs/DESIGN_SYSTEM.md#togglegroup) - Um conjunto de botões de dois estados que podem ser alternados ligados ou desligados.
-- [Tooltip](./docs/DESIGN_SYSTEM.md#tooltip) - Um popup que exibe informações relacionadas a um elemento quando o elemento recebe foco do teclado ou o mouse passa sobre ele.
+- [Toast](./docs/DESIGN_SYSTEM.md#toast) - Componente de notificação toast usando Sonner. Exibe mensagens temporárias para feedback de ações do usuário.
+- [Toggle](./docs/DESIGN_SYSTEM.md#toggle) - Botões de dois estados que podem estar ligados ou desligados, individualmente ou em grupo.
 
 ### 🚀 Sistema CRUD
 

package/dist/README.md

@@ -187,84 +187,96 @@ CREATE INDEX idx_processes_title ON processes.processes(title);
 
 ---
 
+## 🚩 Feature Flags (Variáveis de Ambiente)
+
+A biblioteca suporta feature flags para habilitar/desabilitar funcionalidades opcionais.
+
+### Variáveis Disponíveis
+
+| Variável | Descrição | Valores | Padrão |
+|----------|-----------|---------|--------|
+| `VITE_SHOW_USER_PREFERENCES` | Exibe opção de "Preferências" no menu do usuário (idioma, timezone, formato de data) | `"true"` / `"false"` | Não exibe |
+| `VITE_I18N_DEBUG_MODE` | Modo debug de internacionalização (mostra chaves ao invés de traduções) | `"true"` / `"false"` | `"false"` |
+| `VITE_IS_QUALIEX` | Define se usa logos Qualiex ou Forlogic | `"true"` / `"false"` | `"false"` |
+
+### Configuração
+
+Adicione no seu arquivo `.env`:
+
+```env
+# Habilitar opção de preferências no perfil do usuário
+VITE_SHOW_USER_PREFERENCES=true
+
+# Modo debug de i18n (mostra chaves com ícones)
+VITE_I18N_DEBUG_MODE=false
+
+# Usar logos Qualiex
+VITE_IS_QUALIEX=true
+```
+
+> **Nota**: Variáveis de ambiente em Vite precisam ter o prefixo `VITE_` para serem expostas ao cliente.
+
+---
+
 <!-- AUTO_GENERATED_START -->
 
 ### 📚 Estatísticas da Documentação
 
-**68 Componentes UI** | **8 Tokens** | **2 Ferramentas CRUD**
+**49 Componentes UI** | **6 Tokens** | **2 Ferramentas CRUD**
 
 ---
 
 ### 🎨 Fundamentos (Tokens)
 
-- [Colors](./docs/DESIGN_SYSTEM.md#colors) - Sistema de cores semânticas que se adaptam aos temas claro e escuro.
 - [Colors Foundation](./docs/DESIGN_SYSTEM.md#colorsfoundation) - Sistema de cores completo com escalas neutras, de marca e funcionais.
 - [Radius](./docs/DESIGN_SYSTEM.md#radius) - Sistema de arredondamento de bordas para consistência visual.
 - [Shadows](./docs/DESIGN_SYSTEM.md#shadows) - Sistema de sombras e elevação para criar profundidade e hierarquia.
 - [Spacing](./docs/DESIGN_SYSTEM.md#spacing) - Escala de espaçamento consistente baseada em uma unidade base de 4px.
 - [Typography](./docs/DESIGN_SYSTEM.md#typographycomponent) - Componentes de tipografia para estilos de texto consistentes em toda a sua aplicação.
-- [Typography](./docs/DESIGN_SYSTEM.md#typography) - Escala tipográfica abrangente construída sobre princípios tipográficos comprovados.
 - [Typography Foundation](./docs/DESIGN_SYSTEM.md#typographyfoundation) - Sistema tipográfico completo com Display, Headings, Body e mais.
 
 ### 🧩 Componentes UI
 
 - [Accordion](./docs/DESIGN_SYSTEM.md#accordion) - Um conjunto de cabeçalhos interativos empilhados verticalmente, onde cada um revela uma seção de conteúdo.
 - [Action Button](./docs/DESIGN_SYSTEM.md#actionbutton) - Botão compacto otimizado para ações em linhas de tabela e menus dropdown.
-- [Alert](./docs/DESIGN_SYSTEM.md#alert) - Exibe um destaque para chamar a atenção do usuário.
-- [Alert Dialog](./docs/DESIGN_SYSTEM.md#alertdialog) - Um diálogo modal que interrompe o usuário com conteúdo importante e espera uma resposta.
+- [Alert](./docs/DESIGN_SYSTEM.md#alert) - Exibe uma mensagem de destaque para chamar a atenção do usuário.
 - [Aspect Ratio](./docs/DESIGN_SYSTEM.md#aspectratio) - Exibe conteúdo dentro de uma proporção desejada.
 - [Avatar](./docs/DESIGN_SYSTEM.md#avatar) - Um elemento de imagem com fallback para representar o usuário.
 - [Badge](./docs/DESIGN_SYSTEM.md#badge) - Exibe um badge ou um componente que se parece com um badge.
-- [Breadcrumb](./docs/DESIGN_SYSTEM.md#breadcrumb) - Exibe o caminho para o recurso atual usando uma hierarquia de links.
-- [Button](./docs/DESIGN_SYSTEM.md#button) - Exibe um botão ou um componente que se parece com um botão.
+- [Breadcrumb](./docs/DESIGN_SYSTEM.md#breadcrumb) - Exibe o caminho até o recurso atual usando uma hierarquia de links.
+- [Button](./docs/DESIGN_SYSTEM.md#button) - Componente de botão com variantes semânticas, tamanhos e estados. Use para ações primárias, secundárias e destrutivas.
 - [Button Group](./docs/DESIGN_SYSTEM.md#buttongroup) - Agrupa botões relacionados com espaçamento e bordas apropriados.
-- [Button Variants](./docs/DESIGN_SYSTEM.md#buttonvariants) - Variantes completas de botão com primary, secondary, tertiary, outline, ghost, subtle, destructive, link e icon.
-- [Calendar](./docs/DESIGN_SYSTEM.md#calendar) - Um componente de campo de data que permite aos usuários inserir e editar datas.
+- [Calendar & Date Picker](./docs/DESIGN_SYSTEM.md#calendar) - Componentes para seleção de datas. O Calendar exibe um calendário interativo, enquanto o Date Picker combina um campo de input com o calendário em um popover.
 - [Card](./docs/DESIGN_SYSTEM.md#card) - Exibe um card com cabeçalho, conteúdo e rodapé.
 - [Carousel](./docs/DESIGN_SYSTEM.md#carousel) - Um componente de carrossel para alternar entre elementos. Nota: Este componente requer a biblioteca Embla Carousel que não está incluída no forlogic-core por padrão.
 - [Checkbox](./docs/DESIGN_SYSTEM.md#checkbox) - Um controle que permite ao usuário alternar entre marcado e desmarcado.
 - [Collapsible](./docs/DESIGN_SYSTEM.md#collapsible) - Um componente interativo que expande/colapsa um painel.
 - [Color Picker](./docs/DESIGN_SYSTEM.md#colorpicker) - Seletor de cores com paleta predefinida e seletor customizado.
-- [Combobox](./docs/DESIGN_SYSTEM.md#combobox) - Componente versátil para seleção única ou múltipla com busca inteligente.
-- [Command](./docs/DESIGN_SYSTEM.md#command) - Menu de comandos rápido, composável e sem estilo para React.
-- [Context Menu](./docs/DESIGN_SYSTEM.md#contextmenu) - Exibe um menu ao usuário — como um conjunto de ações ou funções — acionado por um clique direito.
-- [Data List](./docs/DESIGN_SYSTEM.md#datalist) - Sistema de lista de dados com composição de componentes para exibir informações estruturadas.
-- [Date Picker](./docs/DESIGN_SYSTEM.md#datepicker) - Um componente de seletor de data com intervalo e predefinições.
-- [Delete Dialog](./docs/DESIGN_SYSTEM.md#deletedialog) - Dialog de confirmação de exclusão com design consistente e foco em experiência do usuário.
-- [Dialog](./docs/DESIGN_SYSTEM.md#dialog) - Uma janela sobreposta à janela principal ou a outra janela de diálogo, tornando o conteúdo abaixo inerte.
-- [Drawer](./docs/DESIGN_SYSTEM.md#drawer) - Um componente drawer para dispositivos móveis que desliza da borda da tela.
-- [Dropdown Menu](./docs/DESIGN_SYSTEM.md#dropdownmenu) - Exibe um menu ao usuário — como um conjunto de ações ou funções — acionado por um botão.
+- [Combobox](./docs/DESIGN_SYSTEM.md#combobox) - Componente versátil para seleção única ou múltipla com busca inteligente. Combina Popover e Command para autocomplete.
+- [Context Menu](./docs/DESIGN_SYSTEM.md#contextmenu) - Exibe um menu ao usuário — como um conjunto de ações ou funções — acionado por um clique com o botão direito do mouse.
+- [Dialog](./docs/DESIGN_SYSTEM.md#dialog) - Uma janela sobreposta à janela principal ou a outra janela de diálogo, tornando o conteúdo abaixo inerte. Inclui variações para seleção, tabelas e formulários.
+- [Dropdown Menu](./docs/DESIGN_SYSTEM.md#dropdownmenu) - Exibe um menu ao usuário — como um conjunto de ações ou funções — acionado por um botão ou elemento interativo.
 - [Empty State](./docs/DESIGN_SYSTEM.md#emptystate) - Componente para exibir estados vazios com ícone, mensagem e ação opcional.
 - [Form](./docs/DESIGN_SYSTEM.md#form) - Construindo formulários com React Hook Form e Zod.
 - [Grid](./docs/DESIGN_SYSTEM.md#grid) - Sistema de grid responsivo com configuração simplificada de colunas e espaçamento.
-- [Hover Card](./docs/DESIGN_SYSTEM.md#hovercard) - Para usuários com visão visualizarem conteúdo disponível por trás de um link.
 - [Icon Picker](./docs/DESIGN_SYSTEM.md#iconpicker) - Seletor de ícones da biblioteca Lucide React com busca integrada.
 - [Input](./docs/DESIGN_SYSTEM.md#input) - Exibe um campo de entrada de texto.
-- [Input Group](./docs/DESIGN_SYSTEM.md#inputgroup) - Agrupe um input com addons de prefixo ou sufixo.
+- [Input Group](./docs/DESIGN_SYSTEM.md#inputgroup) - Agrupe inputs com addons de prefixo, sufixo, ícones, botões, tooltips e dropdowns. Segue a API oficial do shadcn/ui.
 - [Input OTP](./docs/DESIGN_SYSTEM.md#inputotp) - Accessible one-time password component with customizable number of inputs. Available in the UI library but not exported from forlogic-core.
-- [Kbd](./docs/DESIGN_SYSTEM.md#kbd) - Displays keyboard shortcut commands.
 - [Label](./docs/DESIGN_SYSTEM.md#label) - Renderiza uma label acessível associada a controles.
-- [Loading State](./docs/DESIGN_SYSTEM.md#loadingstate) - Componente para gerenciar estados de loading de forma declarativa com três tipos: spinner, skeleton e overlay.
-- [Menubar](./docs/DESIGN_SYSTEM.md#menubar) - Um menu visualmente persistente comum em aplicações desktop. Este componente está disponível na biblioteca UI mas não é exportado do forlogic-core.
+- [Loading State](./docs/DESIGN_SYSTEM.md#loadingstate) - Componente para gerenciar estados de loading de forma declarativa com dois tipos: spinner e overlay.
 - [Native Select](./docs/DESIGN_SYSTEM.md#nativeselect) - Elemento select nativo do HTML com estilização.
-- [Navigation Menu](./docs/DESIGN_SYSTEM.md#navigationmenu) - Uma coleção de links para navegação em websites. Este componente está disponível na biblioteca UI mas não é exportado do forlogic-core.
-- [Page Breadcrumb](./docs/DESIGN_SYSTEM.md#pagebreadcrumb) - Componente de navegação breadcrumb com suporte a collapse automático e geração a partir de rotas.
-- [Pagination](./docs/DESIGN_SYSTEM.md#pagination) - Paginação com navegação de páginas, links anterior e próximo.
-- [Popover](./docs/DESIGN_SYSTEM.md#popover) - Exibe conteúdo rico em um portal, acionado por um botão.
+- [Pagination](./docs/DESIGN_SYSTEM.md#pagination) - Barra de paginação completa com seletor de itens por página e controles de navegação.
 - [Progress](./docs/DESIGN_SYSTEM.md#progress) - Exibe um indicador mostrando o progresso de conclusão de uma tarefa, tipicamente exibido como uma barra de progresso.
 - [Radio Group](./docs/DESIGN_SYSTEM.md#radiogroup) - Um conjunto de botões marcáveis—conhecidos como botões de rádio—onde apenas um pode ser marcado por vez.
-- [Resizable](./docs/DESIGN_SYSTEM.md#resizable) - Accessible resizable panel groups and layouts. This component is available in the UI library but not exported from forlogic-core.
-- [Resizable Rail](./docs/DESIGN_SYSTEM.md#resizablerail) - Componente de rail de redimensionamento para criar áreas redimensionáveis com cursor e feedback visual.
+- [Resizable](./docs/DESIGN_SYSTEM.md#resizable) - Grupos de painéis redimensionáveis e layouts acessíveis com suporte a teclado. Construído sobre react-resizable-panels.
 - [Scroll Area](./docs/DESIGN_SYSTEM.md#scrollarea) - Aprimora a funcionalidade de rolagem nativa para estilização personalizada e cross-browser.
 - [Searchbar](./docs/DESIGN_SYSTEM.md#searchbar) - Campo de busca com ícone de pesquisa integrado e botão de limpar opcional. Otimizado para experiências de busca em toda a aplicação.
 - [Select](./docs/DESIGN_SYSTEM.md#select) - Exibe uma lista de opções para o usuário escolher—acionada por um botão.
 - [Separator](./docs/DESIGN_SYSTEM.md#separator) - Separa visual ou semanticamente o conteúdo.
 - [Sheet](./docs/DESIGN_SYSTEM.md#sheet) - Estende o componente Dialog para exibir conteúdo que complementa o conteúdo principal da tela.
-- [Sidebar](./docs/DESIGN_SYSTEM.md#sidebar) - Componente de sidebar composável, tematizável e customizável.
-- [Skeleton](./docs/DESIGN_SYSTEM.md#skeleton) - Use para mostrar um placeholder enquanto o conteúdo está carregando.
-- [Skeleton Variants](./docs/DESIGN_SYSTEM.md#skeletonvariants) - Variantes de skeleton pré-configuradas para tabelas, cards, formulários, headers e sidebars.
+- [Skeleton](./docs/DESIGN_SYSTEM.md#skeleton) - Componente de placeholder para estados de carregamento. Inclui variantes pré-configuradas para tabelas, cards, formulários e mais.
 - [Slider](./docs/DESIGN_SYSTEM.md#slider) - Um input onde o usuário seleciona um valor dentro de um intervalo determinado.
-- [Sonner (Toast)](./docs/DESIGN_SYSTEM.md#sonner) - Um componente de notificação toast alimentado por Sonner.
 - [Spinner](./docs/DESIGN_SYSTEM.md#spinner) - Um componente de spinner de carregamento para indicar estado de carregamento.
 - [Stack](./docs/DESIGN_SYSTEM.md#stack) - Layout de pilha flexível com controle de direção, espaçamento, alinhamento e justificação.
 - [Switch](./docs/DESIGN_SYSTEM.md#switch) - Um controle que permite ao usuário alternar entre marcado e desmarcado.
@@ -272,10 +284,8 @@ CREATE INDEX idx_processes_title ON processes.processes(title);
 - [Table](./docs/DESIGN_SYSTEM.md#table) - Uma tabela semântica para exibir dados tabulares.
 - [Tabs](./docs/DESIGN_SYSTEM.md#tabs) - Um conjunto de seções de conteúdo em camadas—conhecidas como painéis de abas—que são exibidas uma de cada vez.
 - [Textarea](./docs/DESIGN_SYSTEM.md#textarea) - Exibe um textarea de formulário ou um componente que se parece com um textarea.
-- [Toast](./docs/DESIGN_SYSTEM.md#toast) - Uma mensagem sucinta exibida temporariamente (Radix UI Toast). Use o hook useToast de @/hooks/use-toast.
-- [Toggle](./docs/DESIGN_SYSTEM.md#toggle) - Um botão de dois estados que pode estar ligado ou desligado.
-- [Toggle Group](./docs/DESIGN_SYSTEM.md#togglegroup) - Um conjunto de botões de dois estados que podem ser alternados ligados ou desligados.
-- [Tooltip](./docs/DESIGN_SYSTEM.md#tooltip) - Um popup que exibe informações relacionadas a um elemento quando o elemento recebe foco do teclado ou o mouse passa sobre ele.
+- [Toast](./docs/DESIGN_SYSTEM.md#toast) - Componente de notificação toast usando Sonner. Exibe mensagens temporárias para feedback de ações do usuário.
+- [Toggle](./docs/DESIGN_SYSTEM.md#toggle) - Botões de dois estados que podem estar ligados ou desligados, individualmente ou em grupo.
 
 ### 🚀 Sistema CRUD