forlogic-core 2.0.8 → 2.1.0

package/dist/tailwind/index.esm.js

@@ -9,6 +9,10 @@ const forlogicTailwindPreset = {
       }
     },
     extend: {
+      fontFamily: {
+        sans: ["Inter", "Roboto", "-apple-system", "BlinkMacSystemFont", '"Segoe UI"', '"Helvetica Neue"', "Arial", "sans-serif"],
+        mono: ['"Roboto Mono"', "Menlo", "Monaco", '"Courier New"', "monospace"]
+      },
       colors: {
         border: "hsl(var(--border))",
         input: "hsl(var(--input))",

package/dist/tailwind/index.js

@@ -11,6 +11,10 @@ const forlogicTailwindPreset = {
       }
     },
     extend: {
+      fontFamily: {
+        sans: ["Inter", "Roboto", "-apple-system", "BlinkMacSystemFont", '"Segoe UI"', '"Helvetica Neue"', "Arial", "sans-serif"],
+        mono: ['"Roboto Mono"', "Menlo", "Monaco", '"Courier New"', "monospace"]
+      },
       colors: {
         border: "hsl(var(--border))",
         input: "hsl(var(--input))",

package/docs/WORKSPACE_KNOWLEDGE.md

@@ -1,254 +1,119 @@
-# 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 |
+# forlogic-core — Workspace Knowledge
+
+> **Documento para colar no Lovable Workspace Knowledge** de projetos consumidores.
+> Funciona como mapa de referências cruzadas entre os projetos.
+
+---
+
+## Projetos do Ecossistema
+
+| Projeto | Alias | Responsabilidade |
+|---------|-------|-----------------|
+| **forlogic-docs** | `@forlogic-docs` | Fonte canônica de regras, padrões, templates e documentação |
+| **qualiex-admin** | `@Admin` | Código-fonte da lib `forlogic-core`, Design System e docs gerados |
+
+---
+
+## Onde buscar cada informação
+
+### Regras e Padrões → `@forlogic-docs`
+
+| O que | Caminho |
+|-------|---------|
+| Constituição (regras canônicas) | `docs/engenharia/padroes/constitution.md` |
+| Guia de migração de ícones | `docs/engenharia/padroes/icon-migration.md` |
+| Guia de publicação da lib | `docs/engenharia/devops/publish.md` |
+| Prompt: auditoria | `docs/templates/prompts/audit.md` |
+| Prompt: criação de tela | `docs/templates/prompts/new-screen.md` |
+| Prompt: starter template | `docs/templates/prompts/starter.md` |
+| ADRs (decisões de arquitetura) | `docs/adrs/` |
+| Specs de API | `docs/apis/` |
+
+### Código-fonte e Design System → `@Admin`
+
+| O que | Caminho |
+|-------|---------|
+| Código 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/` |
+| Golden snippets (exemplos) | `docs/design-system/examples.md` |
+| 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/` |
+| Spec do módulo Queries | `spec/queries.md` |
+
+---
+
+## Schema do Projeto
+
+> ⚠️ **O schema é definido no `README.md` de cada projeto consumidor.** Consulte-o antes de qualquer query.
+
+```ts
+// ✅ CORRETO — substituir pelo schema do projeto
+supabase.schema('SCHEMA_DO_PROJETO').from('tabela').select('*');
+
+// ❌ ERRADO
+supabase.from('tabela').select('*');
+```
+
+---
+
+## Regras Invioláveis (resumo)
+
+> Fonte canônica: `@forlogic-docs docs/engenharia/padroes/constitution.md`
+
+| Regra | Detalhe |
+|-------|---------|
+| Schema obrigatório | `.schema('...')` em toda query Supabase |
+| Sem DELETE físico | Soft delete com `deleted_at` |
+| Lib-first | Usar `forlogic-core` antes de criar componente |
+| Import do Supabase | `getSupabaseClient()` de `forlogic-core` |
+| Import de i18n | `useTranslation` de `forlogic-core`, nunca de `react-i18next` |
+| Sem hardcoded admin | Nunca localStorage/sessionStorage para roles |
+
+---
+
+## 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` |
+| Navegação | `navigation.md` |
+| Dialogs | `dialogs.md` |
+| Layout | `layout.md` |
+| CRUD | `crud.md` |
+
+### Aliases
+
+| Original | Alias(es) |
+|----------|-----------|
+| Combobox | SelectSearch, MultiSelect, EntitySelect |
+| ComboTree | TreeSelect |
+| ActionButton | ActionMenu, RowActions |
+| CrudPrimitiveTable | DataTable |
+
+---
+
+## Instrução para IA — Leitura Obrigatória
+
+**QUANDO** criar ou modificar qualquer arquivo `.tsx`:
+
+- **SE** contém tabela/CRUD → **LER** `@Admin docs/design-system/crud.md` ANTES
+- **SE** contém formulário → **LER** `@Admin docs/design-system/inputs.md` ANTES
+- **SE** contém modal → **LER** `@Admin docs/design-system/dialogs.md` ANTES
+- **SE** contém botões/ações → **LER** `@Admin docs/design-system/buttons-actions.md` ANTES
+- **SE** é layout → **LER** `@Admin docs/design-system/layout.md` ANTES
+
+**SEMPRE** consultar `@Admin docs/design-system/examples.md` como referência.
+
+**VALIDAÇÃO**: Todo import de componente visual DEVE vir de `forlogic-core`.

package/docs/design-system/README.md

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

package/package.json

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

package/docs/ICON_MIGRATION_GUIDE.md

@@ -1,177 +0,0 @@
-# Guia de Migração de Ícones: Angular Material → Lucide React
-
-> Referência para substituir ícones do Material Symbols/Icons pelos equivalentes do [Lucide React](https://lucide.dev/icons/).
-
----
-
-## 1. Material Icons → Lucide React
-
-| Material Icon | Lucide React | Import |
-|:---|:---|:---|
-| `add` | `Plus` | `import { Plus } from 'lucide-react'` |
-| `alarm` | `AlarmClock` | `import { AlarmClock } from 'lucide-react'` |
-| `arrow_back` | `ArrowLeft` | `import { ArrowLeft } from 'lucide-react'` |
-| `arrow_downward` | `ArrowDown` | `import { ArrowDown } from 'lucide-react'` |
-| `arrow_drop_down` | `ChevronDown` | `import { ChevronDown } from 'lucide-react'` |
-| `arrow_drop_up` | `ChevronUp` | `import { ChevronUp } from 'lucide-react'` |
-| `arrow_outward` | `ExternalLink` | `import { ExternalLink } from 'lucide-react'` |
-| `arrow_right_alt` | `ArrowRight` | `import { ArrowRight } from 'lucide-react'` |
-| `arrow_upward` | `ArrowUp` | `import { ArrowUp } from 'lucide-react'` |
-| `article` | `FileText` | `import { FileText } from 'lucide-react'` |
-| `attach_file` | `Paperclip` | `import { Paperclip } from 'lucide-react'` |
-| `auto_stories` | `BookOpen` | `import { BookOpen } from 'lucide-react'` |
-| `cancel` | `XCircle` | `import { XCircle } from 'lucide-react'` |
-| `chat` | `MessageCircle` | `import { MessageCircle } from 'lucide-react'` |
-| `check` | `Check` | `import { Check } from 'lucide-react'` |
-| `check_circle` | `CheckCircle` | `import { CheckCircle } from 'lucide-react'` |
-| `circle` | `Circle` | `import { Circle } from 'lucide-react'` |
-| `clear` | `X` | `import { X } from 'lucide-react'` |
-| `close` | `X` | `import { X } from 'lucide-react'` |
-| `cloud_upload` | `CloudUpload` | `import { CloudUpload } from 'lucide-react'` |
-| `comment` | `MessageSquare` | `import { MessageSquare } from 'lucide-react'` |
-| `delete` | `Trash2` | `import { Trash2 } from 'lucide-react'` |
-| `done` | `Check` | `import { Check } from 'lucide-react'` |
-| `drag_indicator` | `GripVertical` | `import { GripVertical } from 'lucide-react'` |
-| `edit` | `Pencil` | `import { Pencil } from 'lucide-react'` |
-| `error` | `CircleAlert` | `import { CircleAlert } from 'lucide-react'` |
-| `exit_to_app` | `LogOut` | `import { LogOut } from 'lucide-react'` |
-| `expand_more` | `ChevronDown` | `import { ChevronDown } from 'lucide-react'` |
-| `favorite` | `Heart` | `import { Heart } from 'lucide-react'` |
-| `favorite_border` | `Heart` (sem fill) | `import { Heart } from 'lucide-react'` |
-| `group` | `Users` | `import { Users } from 'lucide-react'` |
-| `help` | `HelpCircle` | `import { HelpCircle } from 'lucide-react'` |
-| `hourglass_bottom` | `Hourglass` | `import { Hourglass } from 'lucide-react'` |
-| `info` | `Info` | `import { Info } from 'lucide-react'` |
-| `keyboard_arrow_down` | `ChevronDown` | `import { ChevronDown } from 'lucide-react'` |
-| `keyboard_tab` | `ArrowRightToLine` | `import { ArrowRightToLine } from 'lucide-react'` |
-| `label` | `Tag` | `import { Tag } from 'lucide-react'` |
-| `link` | `Link` | `import { Link } from 'lucide-react'` |
-| `menu` | `Menu` | `import { Menu } from 'lucide-react'` |
-| `more_vert` | `MoreVertical` | `import { MoreVertical } from 'lucide-react'` |
-| `person` | `User` | `import { User } from 'lucide-react'` |
-| `person_outline` | `User` | `import { User } from 'lucide-react'` |
-| `place` | `MapPin` | `import { MapPin } from 'lucide-react'` |
-| `refresh` | `RefreshCw` | `import { RefreshCw } from 'lucide-react'` |
-| `repeat` | `Repeat` | `import { Repeat } from 'lucide-react'` |
-| `schedule` | `Clock` | `import { Clock } from 'lucide-react'` |
-| `search` | `Search` | `import { Search } from 'lucide-react'` |
-| `star` | `Star` | `import { Star } from 'lucide-react'` |
-| `star_border` | `Star` (sem fill) | `import { Star } from 'lucide-react'` |
-| `supervisor_account` | `UserCheck` | `import { UserCheck } from 'lucide-react'` |
-| `swap_horiz` | `ArrowLeftRight` | `import { ArrowLeftRight } from 'lucide-react'` |
-| `verified` | `BadgeCheck` | `import { BadgeCheck } from 'lucide-react'` |
-| `visibility` | `Eye` | `import { Eye } from 'lucide-react'` |
-| `warning` | `TriangleAlert` | `import { TriangleAlert } from 'lucide-react'` |
-
----
-
-## 2. Ícones de gráficos (Material → Lucide/Recharts)
-
-| Material Icon | Lucide React | Nota |
-|:---|:---|:---|
-| `area_chart_black_24dp` | `AreaChart` | `import { AreaChart } from 'lucide-react'` |
-| `bar_chart_black_24dp` | `BarChart3` | `import { BarChart3 } from 'lucide-react'` |
-| `legend_toggle` | `ListFilter` | Alternativa mais próxima |
-| `multiline_chart_black_24dp` | `LineChart` | `import { LineChart } from 'lucide-react'` |
-| `pie_chart_black_24dp` | `PieChart` | `import { PieChart } from 'lucide-react'` |
-| `pin_black_24dp` | `Pin` | `import { Pin } from 'lucide-react'` |
-| `poll` | `BarChart` | `import { BarChart } from 'lucide-react'` |
-| `show_chart_black_24dp` | `TrendingUp` | `import { TrendingUp } from 'lucide-react'` |
-| `stacked_bar_chart_black_24dp` | `BarChart3` | Mesmo ícone, sem variante "stacked" |
-| `stacked_line_chart` | `LineChart` | Mesmo ícone |
-| `trending_up` | `TrendingUp` | `import { TrendingUp } from 'lucide-react'` |
-| `view_list_black_24dp` | `List` | `import { List } from 'lucide-react'` |
-| `view_module` | `LayoutGrid` | `import { LayoutGrid } from 'lucide-react'` |
-
----
-
-## 3. SVGs customizados do flc-icon (sem equivalente Lucide)
-
-Estes ícones são SVGs específicos do projeto e **não têm equivalente no Lucide**. Devem ser mantidos como assets SVG importados diretamente:
-
-### Ícones de extensão de arquivo
-| SVG | Uso | Ação |
-|:----|:----|:-----|
-| `asp.svg`, `csv.svg`, `doc.svg`, `docx.svg`, `gif.svg`, `htm.svg`, `html.svg`, `jpg.svg`, `jpeg.svg`, `mp3.svg`, `mp4.svg`, `ods.svg`, `odt.svg`, `pdf.svg`, `png.svg`, `ppt.svg`, `pptx.svg`, `rar.svg`, `txt.svg`, `xls.svg`, `xlsx.svg`, `zip.svg` | Ícones de tipo de arquivo | Manter como SVG — representam extensões com cores e tipografia específicas |
-| `gdocs.svg`, `gsheets.svg` | Google Docs/Sheets | Manter como SVG |
-
-### Ícones customizados do domínio
-| SVG | Lucide alternativo | Ação |
-|:----|:----|:-----|
-| `calendar.svg` | `Calendar` | Substituir por Lucide |
-| `clock-exclamation.svg` | `ClockAlert` ¹ | Verificar se existe no Lucide |
-| `distance.svg`, `distance-control.svg`, `distance-flow.svg` | — | Manter como SVG (domínio específico) |
-| `document.svg`, `document-configuration.svg`, `document-configuration-active.svg` | `FileText` / `FileCog` | Avaliar substituição |
-| `double-check.svg` | `CheckCheck` | Substituir por Lucide |
-| `double-square.svg` | `CopyPlus` | Avaliar substituição |
-| `drag-pan.svg` | `Move` | Substituir por Lucide |
-| `empty-state.svg`, `empty-state-control.svg`, `empty-state-flow.svg` | — | Manter (ilustrações) |
-| `eye.svg` | `Eye` | Substituir por Lucide |
-| `family-star.svg` | — | Manter como SVG |
-| `file-key.svg` | `FileKey` | Substituir por Lucide |
-| `file-lock.svg`, `file-locker.svg` | `FileLock` | Substituir por Lucide |
-| `file-plus.svg` | `FilePlus` | Substituir por Lucide |
-| `file-remove.svg` | `FileX` | Substituir por Lucide |
-| `flag-check.svg` | `FlagTriangleRight` | Avaliar substituição |
-| `folder.svg` | `Folder` | Substituir por Lucide |
-| `folder-key.svg` | `FolderKey` | Substituir por Lucide |
-| `groups.svg`, `groups-filled.svg` | `Users` | Substituir por Lucide |
-| `history.svg` | `History` | Substituir por Lucide |
-| `hourglass.svg`, `hourglass_empty.svg` | `Hourglass` | Substituir por Lucide |
-| `ia.svg` | `Sparkles` | Substituir por Lucide |
-| `info.svg` | `Info` | Substituir por Lucide |
-| `key.svg` | `Key` | Substituir por Lucide |
-| `notification.svg` | `Bell` | Substituir por Lucide |
-| `print.svg` | `Printer` | Substituir por Lucide |
-| `recycle-bin.svg` | `Trash2` | Substituir por Lucide |
-| `refresh.svg` | `RefreshCw` | Substituir por Lucide |
-| `star.svg` | `Star` | Substituir por Lucide |
-| `stop.svg` | `CircleStop` | Substituir por Lucide |
-| `trash.svg`, `trash-bin.svg` | `Trash2` | Substituir por Lucide |
-| `triangle-alert.svg` | `TriangleAlert` | Substituir por Lucide |
-| `upload.svg` | `Upload` | Substituir por Lucide |
-| `user-group.svg` | `Users` | Substituir por Lucide |
-| `user-key.svg` | `UserCog` | Avaliar substituição |
-| `user-team.svg`, `user-team-control.svg`, `user-team-flow.svg` | `Users` | Manter se visual único |
-
----
-
-## 4. Como migrar na prática
-
-### Antes (Angular)
-```html
-<mat-icon>edit</mat-icon>
-<mat-icon>delete</mat-icon>
-<flc-icon iconSize="24px">pdf</flc-icon>
-```
-
-### Depois (React)
-```tsx
-import { Pencil, Trash2 } from 'lucide-react';
-import pdfIcon from '@/assets/icons/pdf.svg';
-
-<Pencil size={24} />
-<Trash2 size={24} />
-<img src={pdfIcon} alt="PDF" width={24} height={24} />
-```
-
-### Dica: Tamanhos padrão
-
-| Contexto | Tamanho |
-|:---------|:--------|
-| Inline (texto, botões) | `size={16}` |
-| Padrão (toolbar, menu) | `size={20}` |
-| Destaque (cards, empty states) | `size={24}` |
-| Ilustração | `size={48}` ou maior |
-
----
-
-## 5. Resumo
-
-| Categoria | Total | Substituir por Lucide | Manter como SVG |
-|:----------|:------|:---------------------|:----------------|
-| Material Icons | ~50 | **50** (100%) | 0 |
-| SVGs de extensão | ~24 | 0 | **24** (100%) |
-| SVGs customizados | ~40 | **~25** (62%) | **~15** (38%) |
-
-> ¹ `ClockAlert` não existe no Lucide atualmente. Usar `Clock` + badge ou manter SVG customizado.