forlogic-core 1.16.8 → 1.16.10

package/.note/memory/ui/design-system/documentation-standard.md

@@ -0,0 +1,17 @@
+# Design System Documentation Standard
+
+## Fonte de verdade
+
+Os arquivos `*Doc.tsx` em `src/design-system/docs/` são a fonte de verdade para documentação de componentes. Eles alimentam a rota `/ds` no app.
+
+## Regras para *Doc.tsx
+
+- Devem usar `ComponentDocTemplate` com a prop `usage` obrigatória (snippet de código)
+- Seções críticas como ModuleAccess e Audit Log devem incluir padrões SQL e configurações
+- Exemplos visuais interativos são obrigatórios para componentes complexos
+
+## Acesso à documentação
+
+- **Rota `/ds`**: Design system interativo no app
+- **Cross-project**: IA lê `*Doc.tsx` diretamente do código-fonte do projeto **Admin** (forlogic-core)
+- **Não há mais geração automática** de `DESIGN_SYSTEM.md` — foi removido em favor de leitura direta

package/README.md

@@ -27,12 +27,15 @@ npm install forlogic-core
 
 **Nota**: O npm/yarn irá alertar automaticamente se alguma peer dependency estiver faltando ou com versão incompatível.
 
-### Baixar documentação atualizada
+### Sincronizar regras e convenções
 
 ```bash
 npx lib-update
 ```
 
+> Copia apenas `docs/KNOWLEDGE.md` (regras + mapa de módulos) e `.note/memory/rules/`.
+> Documentação de componentes é acessada via rota `/ds` ou cross-project.
+
 ### ⚠️ IMPORTANTE: Imports de i18n
 
 **Sempre** importe hooks de internacionalização do `forlogic-core`, nunca diretamente de `react-i18next`:
@@ -114,7 +117,7 @@ src/components/SplitButton.tsx    // Existe na lib (a partir de v1.12.2)
 | `/design_system`                  | Design System com todos os componentes documentados |
 | `forlogic-core/lib/exports/ui.ts` | Lista de exports de UI                              |
 | `forlogic-core/lib/index.ts`      | Index principal com todos os exports                |
-| `npx lib-update`                  | Baixa documentação atualizada                       |
+| `npx lib-update`                  | Sincroniza regras e KNOWLEDGE.md                    |
 
 ### ⚠️ Exceções (quando PODE criar localmente)
 
@@ -675,17 +678,15 @@ VITE_IS_QUALIEX=true
 
 ## 🌐 Setup de Traduções para Projetos Consumidores
 
-O sistema de internacionalização (i18n) do `forlogic-core` carrega traduções dinamicamente do banco de dados Supabase. Para que funcione corretamente em projetos consumidores, siga os passos abaixo.
+O sistema de i18n usa **namespaces**: a lib fornece traduções base no namespace `core` e cada projeto injeta suas traduções no namespace `app`. A resolução é: `app` → `core` → fallback `pt-BR`.
 
 ### Requisitos
 
-| Requisito                       | Descrição                                                                  |
-| ------------------------------- | -------------------------------------------------------------------------- |
-| `VITE_SUPABASE_URL`             | URL do projeto Supabase (mesma instância que contém `common.translations`) |
-| `VITE_SUPABASE_PUBLISHABLE_KEY` | Chave pública (anon key) do Supabase                                       |
-| `i18next`                       | Peer dependency instalada                                                  |
-| `react-i18next`                 | Peer dependency instalada                                                  |
-| Tabela `common.translations`    | Deve existir no Supabase com RLS pública para SELECT                       |
+| Requisito          | Descrição                                 |
+| ------------------ | ----------------------------------------- |
+| `i18next`          | Peer dependency instalada                 |
+| `react-i18next`    | Peer dependency instalada                 |
+| `CoreProviders`    | Wrapper no App.tsx                        |
 
 ### Passo 1: Instalar Peer Dependencies
 
@@ -693,56 +694,37 @@ O sistema de internacionalização (i18n) do `forlogic-core` carrega traduções
 npm install i18next@^25.0.0 react-i18next@^16.0.0
 ```
 
-### Passo 2: Configurar Variáveis de Ambiente
-
-No arquivo `.env` do projeto consumidor:
-
-```env
-# Deve apontar para a mesma instância Supabase que contém common.translations
-VITE_SUPABASE_URL=https://seu-projeto.supabase.co
-VITE_SUPABASE_PUBLISHABLE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
-```
-
-### Passo 3: Aguardar i18n Inicializar no main.tsx
-
-**⚠️ CRÍTICO**: O `main.tsx` deve aguardar o i18n carregar as traduções antes de renderizar a aplicação.
-
-```tsx
-// src/main.tsx
-import { createRoot } from 'react-dom/client';
-import { i18n } from 'forlogic-core';
-import App from './App';
-import './index.css';
+### Passo 2: Criar JSONs de Tradução do Projeto
 
-const renderApp = () => {
-  createRoot(document.getElementById("root")!).render(<App />);
-};
+Crie arquivos JSON flat (um por idioma) com as traduções específicas do seu projeto:
 
-// ✅ Aguardar i18n inicializar antes de renderizar
-if (i18n.isInitialized) {
-  renderApp();
-} else {
-  i18n.on('initialized', renderApp);
+```json
+// src/i18n/pt-BR.json
+{
+  "objective": "Objetivo",
+  "key_result": "Resultado-chave",
+  "cycle": "Ciclo"
 }
 ```
 
-**❌ ERRADO** - Renderizar sem aguardar (mostrará apenas chaves):
-
-```tsx
-// ❌ NÃO FAÇA ISSO - traduções não estarão prontas
-createRoot(document.getElementById("root")!).render(<App />);
-```
-
-### Passo 4: Usar CoreProviders no App.tsx
+### Passo 3: Passar para CoreProviders via `appTranslations`
 
 ```tsx
 // src/App.tsx
 import { CoreProviders } from 'forlogic-core';
 import { BrowserRouter, Routes, Route } from 'react-router-dom';
+import ptBR from './i18n/pt-BR.json';
+// import enUS from './i18n/en-US.json'; // quando tiver
 
 function App() {
   return (
-    <CoreProviders>
+    <CoreProviders
+      moduleAlias="performance"
+      appTranslations={{
+        'pt-BR': ptBR,
+        // 'en-US': enUS,
+      }}
+    >
       <BrowserRouter>
         <Routes>
           {/* Suas rotas */}
@@ -755,10 +737,10 @@ function App() {
 export default App;
 ```
 
-### Passo 5: Usar useTranslation do forlogic-core
+### Passo 4: Usar useTranslation do forlogic-core
 
 ```tsx
-// ❌ ERRADO - Cria instância separada
+// ❌ ERRADO - Cria instância separada (erro NO_I18NEXT_INSTANCE)
 import { useTranslation } from 'react-i18next';
 
 // ✅ CORRETO - Usa mesma instância configurada
@@ -766,53 +748,59 @@ import { useTranslation } from 'forlogic-core';
 
 function MeuComponente() {
   const { t } = useTranslation();
-  return <h1>{t('minha.chave')}</h1>;
+  return (
+    <div>
+      <h1>{t('objective')}</h1>     {/* namespace app → "Objetivo" */}
+      <Button>{t('save')}</Button>   {/* app → não encontra → core → "Salvar" */}
+    </div>
+  );
 }
 ```
 
+### Como funciona a resolução de namespaces
+
+```
+t('save')
+  1. Busca em namespace 'app' (projeto) → não encontrou
+  2. Busca em namespace 'core' (lib) → "Salvar" ✅
+
+t('objective')
+  1. Busca em namespace 'app' (projeto) → "Objetivo" ✅
+
+t('save') com override no app
+  1. Busca em namespace 'app' → "Gravar" ✅ (sobrescreve o core)
+```
+
 ### Troubleshooting
 
-#### Traduções mostram apenas as chaves (ex: `common.save` ao invés de "Salvar")
+#### Traduções mostram apenas as chaves
 
-| Causa                            | Solução                                                              |
-| -------------------------------- | -------------------------------------------------------------------- |
-| `main.tsx` não aguarda i18n      | Adicionar verificação `i18n.isInitialized` conforme Passo 3          |
-| Peer dependencies faltando       | Instalar `i18next` e `react-i18next`                                 |
-| Variáveis de ambiente incorretas | Verificar `VITE_SUPABASE_URL` e `VITE_SUPABASE_PUBLISHABLE_KEY`      |
-| Supabase diferente               | Verificar se aponta para a mesma instância com `common.translations` |
-| Import de `react-i18next` direto | Usar import de `forlogic-core`                                       |
+| Causa                                | Solução                                                |
+| ------------------------------------ | ------------------------------------------------------ |
+| Peer dependencies faltando           | Instalar `i18next` e `react-i18next`                   |
+| Import de `react-i18next` direto     | Usar import de `forlogic-core`                         |
+| `appTranslations` não passado        | Adicionar prop no `CoreProviders`                      |
+| JSON com formato errado              | Deve ser flat: `{ "key": "value" }`, sem nesting       |
 
 #### Debug: Verificar se traduções foram carregadas
 
 ```tsx
 import { i18n } from 'forlogic-core';
 
-// No console
 console.log('i18n initialized:', i18n.isInitialized);
 console.log('Current language:', i18n.language);
 console.log('Loaded resources:', i18n.store.data);
+// Deve mostrar: { 'pt-BR': { core: {...}, app: {...} } }
 ```
 
-#### Habilitar modo debug
-
-Adicione no `.env`:
-
-```env
-VITE_I18N_DEBUG_MODE=true
-```
-
-Com debug ativo, chaves traduzidas aparecem como `[chave ✅]` e chaves não encontradas como `[⚠️ chave]`.
-
 ### Checklist de Configuração
 
 ```markdown
 - [ ] Instalou `i18next@^25.0.0` e `react-i18next@^16.0.0`?
-- [ ] Configurou `VITE_SUPABASE_URL` apontando para a instância correta?
-- [ ] Configurou `VITE_SUPABASE_PUBLISHABLE_KEY`?
-- [ ] O `main.tsx` aguarda `i18n.isInitialized` antes de renderizar?
+- [ ] Criou JSONs de tradução em `src/i18n/pt-BR.json`?
+- [ ] Passou `appTranslations` para o `CoreProviders`?
+- [ ] Todos os imports de `useTranslation` são de `forlogic-core` (nunca de `react-i18next`)?
 - [ ] O `App.tsx` usa `CoreProviders`?
-- [ ] Todos os imports de `useTranslation` são de `forlogic-core`?
-- [ ] A tabela `common.translations` existe e tem RLS pública para SELECT?
 ```
 
 ---
@@ -1052,162 +1040,40 @@ function MeuDialog({ open, onOpenChange }) {
 - "Adicione navegação para criar" (ação ≠ navegação)
 - "Crie um link para nova entidade" (link = navegação, não ação)
 
-## 🛠️ CLI: Sincronização de Documentação
+## 🛠️ CLI: Sincronizar Regras e Convenções
 
-O `forlogic-core` disponibiliza um comando CLI para sincronizar a documentação centralizada do banco de dados para projetos consumidores.
+O `forlogic-core` disponibiliza um comando CLI para sincronizar regras e convenções arquiteturais para projetos consumidores.
 
 ### Uso
 
 ```bash
 # Via npx (recomendado)
-npx forlogic-core-pull-docs
+npx lib-update
 
 # Ou adicione ao package.json do seu projeto:
 {
   "scripts": {
-    "pull-docs": "forlogic-core-pull-docs"
+    "lib-update": "lib-update"
   }
 }
 
 # E execute:
-npm run pull-docs
+npm run lib-update
 ```
 
 ### O que é sincronizado
 
-| Arquivo                        | Descrição                      |
-| ------------------------------ | ------------------------------ |
-| `docs/FORLOGIC_CORE_README.md` | README completo da biblioteca  |
-| `docs/DESIGN_SYSTEM.md`        | Documentação do Design System  |
-| `docs/KNOWLEDGE.md`            | Knowledge base para IA/Lovable |
-
-### Benefícios
+| Arquivo/Diretório       | Descrição                                        |
+| ----------------------- | ------------------------------------------------ |
+| `docs/KNOWLEDGE.md`     | Regras críticas + mapa de módulos para IA/Lovable |
+| `.note/memory/rules/`   | Regras de schema, RLS, índices, .env             |
 
-- ✅ **Centralizado**: Documentação mantida em um único lugar (banco de dados)
-- ✅ **Sempre atualizado**: Execute o comando para obter a versão mais recente
-- ✅ **Sem cópia manual**: Não precisa copiar arquivos entre projetos
-- ✅ **Ideal para Custom Knowledge**: Use os arquivos gerados no Lovable
+### O que NÃO é sincronizado (leitura via cross-project → projeto **Admin**)
 
-### Requisitos
-
-O comando usa credenciais públicas do Supabase do forlogic-core e não requer configuração adicional.
-
----
+| Recurso                     | Como acessar                                              |
+| --------------------------- | --------------------------------------------------------- |
+| Documentação de componentes | Rota `/ds` no projeto **Admin** ou cross-project          |
+| Props, exemplos, tipos      | Ler dos `*Doc.tsx` via cross-project → projeto **Admin**  |
+| Padrões de layout/CRUD      | `.note/memory/patterns/` via cross-project → **Admin**    |
 
-<!-- AUTO_GENERATED_START -->
-
-### 📚 Estatísticas da Documentação
-
-**61 Componentes UI** | **6 Tokens** | **9 Ferramentas CRUD** | **10 Core/Utilitários**
-
----
-
-### 🎨 Fundamentos (Tokens)
-
-- [Ícones](./docs/DESIGN_SYSTEM.md#iconsfoundation) - Biblioteca completa de ícones usando Lucide React - uma biblioteca de ícones
-          open-source com mais de 1400 ícones em SVG.
-- [Sistema de Cores](./docs/DESIGN_SYSTEM.md#colorsfoundation) - Sistema de cores profissional completo com escala neutra (0-1000), escala de marca (50-900),
-          e cores funcionais (sucesso, aviso, perigo, sharp). Todas as cores garantem conformidade de contraste WCAG AA.
-- [Sistema de Espaçamento](./docs/DESIGN_SYSTEM.md#spacing) - Escala de espaçamento consistente baseada em uma unidade base de 4px (0.25rem),
-          garantindo ritmo visual e alinhamento em todos os componentes.
-- [Sistema de Raio de Borda](./docs/DESIGN_SYSTEM.md#radius) - Arredondamento de cantos consistente que cria harmonia visual e
-          define a personalidade da interface.
-- [Sistema de Sombras e Elevação](./docs/DESIGN_SYSTEM.md#shadows) - Sombras criam profundidade e hierarquia, ajudando usuários a entender as relações
-          espaciais entre elementos e seus estados interativos.
-- [Sistema Tipográfico](./docs/DESIGN_SYSTEM.md#typographyfoundation) - Sistema tipográfico profissional com Display (2 níveis), Headings (6 níveis), Subtitle (2 níveis),
-          Body (2 níveis), Label (2 níveis) e Monospace (Code). Todos os níveis incluem escalamento responsivo e conformidade de acessibilidade.
-
-### 🧩 Componentes UI
-
-- [Accordion & Collapsible](./docs/DESIGN_SYSTEM.md#accordion) - Componentes de expansão/colapso para revelar conteúdo. Accordion para múltiplos itens, Collapsible para item único.
-- [Action Button](./docs/DESIGN_SYSTEM.md#actionbutton) - Botão compacto otimizado para ações em linhas de tabela e menus dropdown. OBRIGATÓRIO para todas as ações em tabelas CRUD.
-- [Alert](./docs/DESIGN_SYSTEM.md#alert) - Exibe uma mensagem de destaque para chamar a atenção do usuário. O componente inclui ícone automático baseado na variante.
-- [AppHeader](./docs/DESIGN_SYSTEM.md#appheader) - Header principal da aplicação com título dinâmico, busca global integrada ao CRUD, ações customizáveis e informações do usuário. Altura fixa de 56px (h-14).
-- [AppSidebar](./docs/DESIGN_SYSTEM.md#appsidebar) - Sidebar de navegação principal da aplicação com suporte a pin/unpin, permissões assíncronas, ações de módulo (SidebarActionTrigger), redimensionamento e navegação hierárquica.
-- [Assinatura Digital (Sign)](./docs/DESIGN_SYSTEM.md#sign) - Componente único multi-provider de assinatura digital com fluxo em 3 fases: Upload → Assinatura → Download. Suporta Clicksign (widget JavaScript embedded v2.1.0, API v3) e D4Sign (iframe embedded, API v1). O provedor é resolvido automaticamente pela configuração da unidade na tabela sign_configs.
-- [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.
-- [BodyContent](./docs/DESIGN_SYSTEM.md#bodycontent) - Container principal de página com breadcrumb, background neutro e suporte a múltiplos containers de conteúdo.
-- [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.
-- [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é.
-- [Chart](./docs/DESIGN_SYSTEM.md#chart) - Sistema de gráficos baseado em Recharts com suporte a temas e tooltips customizados. Inclui barras, linhas, áreas, pizza, radar e mais.
-- [Checkbox](./docs/DESIGN_SYSTEM.md#checkbox) - Um controle que permite ao usuário alternar entre marcado e desmarcado.
-- [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. Combina Popover e Command para autocomplete. O componente Command é usado internamente para fornecer funcionalidades de busca e navegação por teclado.
-- [ComboTree](./docs/DESIGN_SYSTEM.md#combotree) - Componente de seleção hierárquica (tree view) com busca recursiva, expansão por chevron e seleção por label.
-- [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.
-- [DataList](./docs/DESIGN_SYSTEM.md#datalist) - Sistema de lista de dados com composição de componentes. Ideal para exibir informações estruturadas em formato de cards.
-- [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 & Stack](./docs/DESIGN_SYSTEM.md#grid) - Sistema de layout com Grid responsivo e Stack flexível para organização de conteúdo.
-- [Hover Card](./docs/DESIGN_SYSTEM.md#hovercard) - Para usuários com visão visualizarem conteúdo disponível por trás de um link. Exibe informações adicionais ao passar o mouse.
-- [Icon Picker](./docs/DESIGN_SYSTEM.md#iconpicker) - Seletor de ícones da biblioteca Lucide React com busca integrada.
-- [Input](./docs/DESIGN_SYSTEM.md#input) - Campo de entrada de texto com suporte a todos os tipos HTML. Inclui Label para rótulos acessíveis e InputGroup para agrupar inputs com addons de prefixo, sufixo, ícones e botões.
-- [Label](./docs/DESIGN_SYSTEM.md#label) - Renderiza uma label acessível associada a controles de formulário.
-- [Leadership](./docs/DESIGN_SYSTEM.md#leadership) - Módulo hierárquico de liderança para gerenciar relações de liderança entre usuários do Qualiex. Inclui componentes visuais, hooks de API e utilitários para construção de árvores hierárquicas.
-- [Loading](./docs/DESIGN_SYSTEM.md#skeleton) - Componentes para estados de carregamento: Skeleton (placeholders), Spinner (indicador de loading), e LoadingState (gerenciamento declarativo).
-- [Media](./docs/DESIGN_SYSTEM.md#media) - Módulo completo para upload, edição e renderização de imagens e vídeos. Inclui editores interativos, renderizadores otimizados e hook genérico de upload.
-- [Menubar](./docs/DESIGN_SYSTEM.md#menubar) - Barra de menu horizontal com submenus, checkboxes e radio items. Ideal para barras de navegação de aplicações desktop-like, seguindo padrões de aplicações nativas.
-- [ModulesDialog](./docs/DESIGN_SYSTEM.md#modulesdialog) - Dialog para navegação entre módulos do sistema.
-- [Navigation Menu](./docs/DESIGN_SYSTEM.md#navigationmenu) - Uma coleção de links para navegação em websites.
-- [Onboarding Dialog](./docs/DESIGN_SYSTEM.md#onboardingdialog) - Componente para fluxos de onboarding em múltiplos passos. Suporta imagens estáticas, GIFs, navegação entre steps e indicador de progresso com dropdown.
-- [Pagination](./docs/DESIGN_SYSTEM.md#pagination) - Componente de paginação padronizado com layout de 3 colunas, seletor de itens por página e navegação completa.
-- [Pagination](./docs/DESIGN_SYSTEM.md#pagination) - Barra de paginação completa com seletor de itens por página e controles de navegação.
-- [Places](./docs/DESIGN_SYSTEM.md#places) - Módulo para gerenciar estruturas hierárquicas de locais integrado com a API Qualiex. Inclui visualização em árvore, gestão de acessos e componentes reutilizáveis.
-- [Popover](./docs/DESIGN_SYSTEM.md#popover) - Exibe conteúdo rico em um portal, acionado por um botã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.
-- [QualiexUserField](./docs/DESIGN_SYSTEM.md#qualiexuserfield) - Campo de seleção de usuários integrado com a API Qualiex. Suporta seleção única ou múltipla, display customizado, filtros e funciona perfeitamente dentro de Dialogs.
-- [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.
-- [RequiredFieldsCounter](./docs/DESIGN_SYSTEM.md#requiredfieldscounter) - Indica o progresso de preenchimento de campos obrigatórios em formulários com feedback visual e tooltips informativos.
-- [Resizable](./docs/DESIGN_SYSTEM.md#resizable) - Painéis redimensionáveis para criar layouts flexíveis e adaptáveis. Baseado em react-resizable-panels.
-- [Rich Text Editor](./docs/DESIGN_SYSTEM.md#richtexteditor) - Editor de texto rico construído com Tiptap, suportando formatação visual, edição de código HTML e preview. Ideal para formulários que precisam de conteúdo formatado.
-- [ScrollArea](./docs/DESIGN_SYSTEM.md#scrollarea) - Área de rolagem customizada com scrollbars estilizadas, baseada no Radix UI ScrollArea.
-- [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.
-- [Slider](./docs/DESIGN_SYSTEM.md#slider) - Um input onde o usuário seleciona um valor dentro de um intervalo determinado.
-- [Split Button](./docs/DESIGN_SYSTEM.md#splitbutton) - Combina uma ação principal com ações secundárias em um menu dropdown. Ideal para destacar a ação prioritária enquanto mantém alternativas acessíveis.
-- [Step Selector](./docs/DESIGN_SYSTEM.md#stepselector) - Componente de navegação para Wizards multi-etapas. Combina um DropdownMenu para seleção de etapas com uma barra de Progress para indicação visual do progresso.
-- [Switch](./docs/DESIGN_SYSTEM.md#switch) - Um controle que permite ao usuário alternar entre marcado e desmarcado.
-- [Table](./docs/DESIGN_SYSTEM.md#table) - Uma tabela semântica para exibir dados tabulares. Inclui TableResizeHandle para redimensionamento de colunas e TruncatedCell para texto truncado com tooltip automático.
-- [Tabs & TabPageLayout](./docs/DESIGN_SYSTEM.md#tabs) - Componentes de navegação em abas. Tabs para conteúdo simples e TabPageLayout para páginas completas com header fixo e scroll.
-- [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) - Componente de notificação toast usando Sonner. Feedback temporário e não bloqueante que informa rapidamente o usuário sem competir visualmente com outros Toasts.
-- [Toggle](./docs/DESIGN_SYSTEM.md#toggle) - Botões de dois estados que podem estar ligados ou desligados, individualmente ou em grupo.
-- [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.
-- [Truncated Cell](./docs/DESIGN_SYSTEM.md#truncatedcell) - Componente utilitário que trunca texto longo e exibe tooltip automático quando o conteúdo está cortado.
-
-### 🚀 Sistema CRUD
-
-- [BaseForm](./docs/DESIGN_SYSTEM.md#baseform) - Formulário dinâmico baseado em configuração de seções e campos, suportando múltiplos tipos de campo, validação e layouts flexíveis.
-- [createCrudPage](./docs/DESIGN_SYSTEM.md#createcrudpage) - Factory de alto nível que gera uma página CRUD completa com ~15 linhas de configuração declarativa.
-- [CRUD de Fornecedores](./docs/DESIGN_SYSTEM.md#crudusers) - Padrão completo de CRUD para gestão de fornecedores com 16 campos, incluindo ordenação, filtros avançados, exportação/importação e ações em massa.
-- [CRUD Primitives](./docs/DESIGN_SYSTEM.md#crudprimitives) - Componentes de baixo nível para interfaces CRUD totalmente customizadas com controle total sobre layout e comportamento.
-- [CRUD System](./docs/DESIGN_SYSTEM.md#crudsystem) - Sistema completo para criação rápida de interfaces CRUD com validação, busca, paginação e muito mais.
-- [CrudActionBar](./docs/DESIGN_SYSTEM.md#crudactionbar) - Barra de ações unificada usada por todos os componentes CRUD (CrudTable, CrudGrid, createCrudPage) para garantir UX consistente.
-- [CrudGrid](./docs/DESIGN_SYSTEM.md#crudgrid) - Componente para exibir dados em formato de grade (cards) com todas as funcionalidades CRUD. Alternativa visual ao CrudTable para listagens com layout mais visual.
-- [CrudTable](./docs/DESIGN_SYSTEM.md#crudtable) - Componente de tabela CRUD completo com ordenação, seleção, resize de colunas, ações em massa e paginação integrada com useCrud.
-- [Sistema CRUD](./docs/DESIGN_SYSTEM.md#crudoverview) - Componentes padronizados para operações Create, Read, Update e Delete com arquitetura em 3 níveis de abstração.
-
-### 🔧 Core & Utilitários
-
-- [Autenticação (Auth)](./docs/DESIGN_SYSTEM.md#auth) - Sistema completo de autenticação OAuth integrado com Qualiex. Inclui gerenciamento de tokens, rotas protegidas, suporte multi-tenant e troca de unidades.
-- [Contexts](./docs/DESIGN_SYSTEM.md#contexts) - Contexts globais da biblioteca forlogic-core para gerenciamento de estado da aplicação. Incluem LocaleContext para i18n, NavigationContext para navegação, PageMetadataContext para metadados de página e ModalStateContext para rastreamento de modais.
-- [Environments (Configuração por Project ID)](./docs/DESIGN_SYSTEM.md#environments) - Configurações de ambiente são extraídas automaticamente do arquivo auto-gerado pelo Lovable (src/integrations/supabase/client.ts) e injetadas pelo vite.config.ts. Não é necessário configurar variáveis Supabase no .env.
-- [ErrorBoundary](./docs/DESIGN_SYSTEM.md#errorboundary) - Componente de classe React que captura erros de renderização em componentes filhos, evitando que a aplicação inteira quebre.
-- [Hooks](./docs/DESIGN_SYSTEM.md#hooks) - Hooks utilitários da biblioteca forlogic-core para otimização, dados, formatação e UI. Todos os hooks seguem padrões React e são compatíveis com React Query quando aplicável.
-- [Internacionalização (i18n)](./docs/DESIGN_SYSTEM.md#i18n) - Sistema de internacionalização usando react-i18next com traduções carregadas de um arquivo JSON estático local (lib/i18n/translations.json). Suporta pt-BR, en-US e es-ES com gerenciamento de preferências do usuário.
-- [Acesso Módulo (ModuleAccess)](./docs/DESIGN_SYSTEM.md#moduleaccess) - Sistema de autorização para verificar e bloquear acesso a módulos da plataforma Qualiex. Proteção automática de rotas via CoreProviders e hook para verificações programáticas.
-- [Segurança (Vite Config)](./docs/DESIGN_SYSTEM.md#security) - Plugin de segurança para Vite que aplica headers OWASP, CSP configurável, CORS seguro e proteções contra ataques comuns. Configuração centralizada para todos os projetos Forlogic.
-- [Services](./docs/DESIGN_SYSTEM.md#services) - Serviços utilitários da biblioteca forlogic-core para operações CRUD, envio de emails, tratamento de erros e gerenciamento de traduções. Todos os serviços são singletons prontos para uso.
-- [Utilities](./docs/DESIGN_SYSTEM.md#utilities) - Funções utilitárias essenciais exportadas pela biblioteca para manipulação de classes CSS, formatação de datas e valores monetários.
-
----
-
-> 📘 **Documentação Completa**: Para ver detalhes de props, exemplos de uso e acessibilidade de cada componente, consulte o [Design System Completo](./docs/DESIGN_SYSTEM.md).
-
-<!-- AUTO_GENERATED_END -->
+> 💡 A IA consegue ler o código-fonte do forlogic-core no projeto **Admin** via cross-project visibility.