forlogic-core 2.0.3 → 2.0.4

package/dist/types/sidebar.d.ts

@@ -38,10 +38,11 @@ export interface SidebarActionsConfig {
 export interface SidebarNavigationItem {
     label: string;
     path: string;
-    icon: LucideIcon;
+    icon?: LucideIcon;
     complementaryText?: string;
     permissionCheck?: () => Promise<boolean>;
     children?: SidebarNavigationItem[];
+    type?: 'separator';
 }
 export interface SidebarConfig {
     appName?: string;

package/docs/AUDIT_PROMPT.md

@@ -0,0 +1,74 @@
+# Prompt de Auditoria — Design System
+
+> **Como usar**: Cole este prompt em uma conversa do Lovable no projeto consumidor para auditar e corrigir violações do Design System.
+
+---
+
+## Prompt para copiar
+
+```
+Audite TODOS os arquivos .tsx do projeto em busca de violações do Design System do forlogic-core.
+
+Antes de começar, leia obrigatoriamente via cross-project:
+@Admin docs/design-system/crud.md
+@Admin docs/design-system/inputs.md
+@Admin docs/design-system/selectors.md
+@Admin docs/design-system/layout.md
+@Admin docs/design-system/dialogs.md
+@Admin docs/design-system/buttons-actions.md
+
+Verifique CADA arquivo .tsx contra estas regras:
+
+### Imports inválidos
+- [ ] Import de componente UI que NÃO vem de `forlogic-core` (Button, Dialog, Input, Select, Table, etc.)
+- [ ] Import de `react-i18next` em vez de `useTranslation` de `forlogic-core`
+- [ ] Import de `@/integrations/supabase/client` em vez de `getSupabaseClient()` de `forlogic-core`
+
+### Componentes proibidos
+- [ ] `<Select>` ou `<StatusSelect>` → deve ser `<Combobox>`
+- [ ] `<MoreHorizontal>` genérico como menu de ações → deve ser `<ActionButton>`
+- [ ] `<DeleteConfirmationDialog>` → deve ser `<Dialog>`
+- [ ] `<Searchbar>` → deve ser `<Input>` com ícone de busca
+- [ ] `BulkActionBar` separado → deve ser dropdown no `CrudActionBar`
+- [ ] Paginação manual → deve ser `CrudPrimitivePagination`
+
+### Supabase
+- [ ] Query sem `.schema('SCHEMA_PADRAO')` (qualquer `supabase.from(` direto)
+- [ ] DELETE físico (deve ser soft delete com `deleted_at`)
+- [ ] `supabase` importado diretamente do client em vez de `getSupabaseClient()`
+
+### Layout
+- [ ] Página sem `usePageMetadata` (título/subtítulo)
+- [ ] Layout sem `AppLayout` + `AppSidebar`
+- [ ] Componente criado localmente quando existe equivalente na lib
+
+### Formulários
+- [ ] Formulário sem `BaseForm` ou `react-hook-form` + `zod`
+- [ ] Select nativo HTML em vez de `Combobox`
+
+Para cada violação encontrada, gere um relatório no formato:
+
+| Arquivo | Linha | Violação | Correção |
+|---------|-------|----------|----------|
+| src/pages/X.tsx | 15 | Import de Button local | Usar `import { Button } from 'forlogic-core'` |
+
+Depois do relatório, pergunte se devo corrigir automaticamente.
+```
+
+---
+
+## Variações
+
+### Auditoria rápida (apenas imports)
+
+```
+Busque em TODOS os arquivos .tsx do projeto por imports que NÃO vêm de 'forlogic-core'.
+Liste: arquivo, linha, import atual, e o import correto de forlogic-core.
+```
+
+### Auditoria de Supabase
+
+```
+Busque em TODOS os arquivos .ts/.tsx por chamadas a `supabase.from(` sem `.schema('SCHEMA_PADRAO')`.
+Liste: arquivo, linha, query atual, e a correção com .schema().
+```

package/docs/PROJECT_KNOWLEDGE_TEMPLATE.md

@@ -0,0 +1,117 @@
+# KNOWLEDGE — [Nome do Módulo]
+
+> Copie este template para o Project Knowledge do seu projeto Lovable.
+> Preencha os placeholders `[...]` e remova comentários `<!-- -->`.
+
+---
+
+## 0. Schema
+
+> ⚠️ **SCHEMA_PADRAO = `[seu_schema]`**
+
+```ts
+supabase.schema('[seu_schema]').from('tabela').select('*');
+```
+
+---
+
+## 1. Regras do Módulo
+
+<!-- Liste regras específicas deste módulo que a IA precisa saber -->
+
+- [Regra 1: ex: Processos só podem ser inativados, nunca deletados]
+- [Regra 2: ex: Todo documento precisa de aprovação antes de publicar]
+- [Regra 3: ex: Usuários só veem dados do próprio alias/empresa]
+
+---
+
+## 2. Mapa de Telas
+
+<!-- Para cada tela, descreva: nome, tipo, tabela e componentes do DS -->
+
+### [Nome da Tela 1: ex: Processos]
+
+- **Tipo**: CRUD listagem
+- **Tabela**: `[processes]`
+- **Componente DS**: `createCrudPage` ou `CrudTable`
+- **Colunas**: [title, status, responsible, updated_at]
+- **Ações de linha**: [Editar, Duplicar, Inativar]
+- **Filtros**: [status, responsible]
+
+### [Nome da Tela 2: ex: Formulário de Processo]
+
+- **Tipo**: Formulário (Dialog ou página)
+- **Tabela**: `[processes]`
+- **Campos**:
+  - `title` — text, obrigatório
+  - `description` — textarea
+  - `status` — Combobox (Ativo, Inativo, Rascunho)
+  - `id_responsible` — Combobox (busca em users)
+  - `due_date` — DatePicker
+
+<!-- Repita para cada tela do módulo -->
+
+---
+
+## 3. Tabelas e Relacionamentos
+
+<!-- Liste as tabelas do módulo com campos principais -->
+
+| Tabela | Campos principais | FKs |
+|--------|-------------------|-----|
+| `[processes]` | id, title, status, created_at, deleted_at | id_responsible → users |
+| `[documents]` | id, name, version, id_process | id_process → processes |
+
+---
+
+## 4. Enums e Status
+
+<!-- Liste valores possíveis para campos de status/tipo -->
+
+| Campo | Valores |
+|-------|---------|
+| `processes.status` | `active`, `inactive`, `draft` |
+| `documents.type` | `policy`, `procedure`, `instruction` |
+
+---
+
+## 5. Regras de Negócio por Tela
+
+<!-- Detalhe regras específicas que afetam a UI -->
+
+### [Processos]
+- Ao inativar: confirmar com Dialog, definir `deleted_at = now()`
+- Coluna status: exibir com Badge colorido (active=green, inactive=red)
+- Busca: pesquisar em `title` e `description`
+
+### [Formulário]
+- Campo `title`: mínimo 3 caracteres
+- Campo `id_responsible`: carregar de `users` filtrado por alias
+- Ao salvar: validar com Zod, exibir toast de sucesso
+
+---
+
+## 6. Imports Obrigatórios
+
+```ts
+import {
+  createCrudPage, CrudTable, CrudActionBar,
+  Button, Dialog, Input, Combobox, ActionButton,
+  BaseForm, EmptyState, LoadingState,
+  cn, useTranslation, getSupabaseClient
+} from 'forlogic-core';
+```
+
+---
+
+## 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
+
+Nunca crie componentes sem consultar esses arquivos primeiro.

package/docs/PROMPT_TEMPLATE.md

@@ -0,0 +1,77 @@
+# Prompt Template — Criação de Telas com Design System
+
+> **Como usar**: Copie o bloco abaixo e cole como **primeiro prompt** ao iniciar uma conversa no Lovable para criar/migrar telas em projetos consumidores. Preencha os placeholders `[...]`.
+
+---
+
+## Prompt para copiar
+
+```
+Antes de gerar qualquer código, leia OBRIGATORIAMENTE a documentação do Design System via cross-project:
+
+@Admin docs/design-system/crud.md        — para telas de listagem (CRUD)
+@Admin docs/design-system/inputs.md      — para campos de formulário
+@Admin docs/design-system/selectors.md   — para selects, combos, multiselect
+@Admin docs/design-system/layout.md      — para estrutura de página (AppSidebar, AppLayout)
+@Admin docs/design-system/dialogs.md     — para modais e confirmações
+@Admin docs/design-system/buttons-actions.md — para botões e ações
+@Admin docs/design-system/data-display.md    — para exibição de dados
+@Admin docs/design-system/tables-grids.md    — para tabelas e grids
+
+Regras obrigatórias:
+1. TODO import de componente visual DEVE vir de `forlogic-core` — nunca criar componente local se existir na lib
+2. Usar `createCrudPage` para telas de listagem simples, `CrudTable` para customizadas
+3. Usar `Combobox` para selects com busca (nunca Select nativo ou StatusSelect)
+4. Usar `ActionButton` para ações de linha (nunca ícone MoreHorizontal solto)
+5. Usar `Dialog` para confirmações (nunca DeleteConfirmationDialog)
+6. Usar `.schema('SCHEMA_PADRAO')` em toda query Supabase
+7. Usar `useTranslation` de `forlogic-core`, nunca de `react-i18next`
+
+---
+
+Agora crie a seguinte tela:
+
+**Nome da tela**: [ex: Gestão de Processos]
+**Tipo**: [CRUD listagem | Formulário | Dashboard | Detalhe]
+**Schema Supabase**: [ex: quality]
+**Tabela principal**: [ex: processes]
+
+**Campos da listagem** (se CRUD):
+- [campo1]: [tipo] — [descrição]
+- [campo2]: [tipo] — [descrição]
+
+**Campos do formulário** (se tiver criação/edição):
+- [campo1]: [tipo, obrigatório?] — [descrição]
+- [campo2]: [tipo, obrigatório?] — [descrição]
+
+**Regras de negócio**:
+- [regra 1]
+- [regra 2]
+
+**Ações disponíveis**:
+- [ação 1: ex: Editar, Duplicar, Inativar]
+```
+
+---
+
+## Mapeamento: Tipo de tela → Docs obrigatórios
+
+| Tipo de tela | Docs que a IA DEVE ler |
+|--------------|------------------------|
+| CRUD listagem | `crud.md`, `buttons-actions.md`, `tables-grids.md` |
+| Formulário | `inputs.md`, `selectors.md`, `dialogs.md` |
+| Dashboard | `charts-dashboards.md`, `data-display.md` |
+| Página com sidebar | `layout.md`, `navigation.md` |
+| Modal/Dialog | `dialogs.md`, `inputs.md` |
+
+---
+
+## Checklist de revisão pós-geração
+
+- [ ] Todos os imports vêm de `forlogic-core`?
+- [ ] Nenhum componente foi criado localmente quando existe na lib?
+- [ ] `Combobox` usado em vez de Select/StatusSelect?
+- [ ] `ActionButton` usado para ações de linha?
+- [ ] `CrudActionBar` com layout de 3 zonas?
+- [ ] `.schema('SCHEMA_PADRAO')` em toda query?
+- [ ] Soft delete em vez de DELETE físico?

package/docs/STARTER_TEMPLATE.md

@@ -0,0 +1,114 @@
+# Starter Template — Projeto Consumidor forlogic-core
+
+> **Como usar**: Ao criar um novo projeto no Lovable, cole este conteúdo como **primeiro prompt** para gerar a estrutura base completa.
+
+---
+
+## Prompt para criar projeto base
+
+```
+Crie a estrutura base do projeto seguindo EXATAMENTE este boilerplate.
+Leia @Admin docs/design-system/layout.md antes de começar.
+
+### 1. vite.config.ts
+
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react-swc';
+import path from 'path';
+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') } },
+  optimizeDeps: { force: true },
+}));
+
+### 2. tailwind.config.ts
+
+import type { Config } from 'tailwindcss';
+import { forlogicTailwindPreset, forlogicContentPaths } from 'forlogic-core/tailwind';
+
+export default {
+  presets: [forlogicTailwindPreset],
+  content: ['./src/**/*.{ts,tsx}', ...forlogicContentPaths],
+} satisfies Config;
+
+### 3. src/App.tsx
+
+import { BrowserRouter, Routes, Route, Navigate } from 'react-router-dom';
+import { CoreProviders, AppLayout } from 'forlogic-core';
+import { Home, FileText, Settings } from 'lucide-react';
+import ptBR from './i18n/pt-BR.json';
+import { HomePage } from './pages/HomePage';
+
+const sidebarConfig = {
+  navigation: [
+    { label: 'Início', path: '/', icon: Home },
+    { label: 'Registros', path: '/registros', icon: FileText },
+    { type: 'separator' as const, label: '', path: '' },
+    { label: 'Configurações', path: '/config', icon: Settings },
+  ],
+};
+
+function AppRoutes() {
+  return (
+    <AppLayout sidebarConfig={sidebarConfig}>
+      <Routes>
+        <Route path="/" element={<HomePage />} />
+        <Route path="*" element={<Navigate to="/" replace />} />
+      </Routes>
+    </AppLayout>
+  );
+}
+
+export default function App() {
+  return (
+    <CoreProviders moduleAlias="SEU_MODULO" appTranslations={{ 'pt-BR': ptBR }}>
+      <BrowserRouter>
+        <AppRoutes />
+      </BrowserRouter>
+    </CoreProviders>
+  );
+}
+
+### 4. src/pages/HomePage.tsx
+
+import { usePageMetadata } from 'forlogic-core';
+
+export function HomePage() {
+  usePageMetadata({ title: 'Início', subtitle: 'Bem-vindo ao módulo' });
+  return <div className="p-6">Conteúdo aqui</div>;
+}
+
+### 5. src/i18n/pt-BR.json
+
+{
+  "home": "Início",
+  "records": "Registros",
+  "settings": "Configurações"
+}
+
+Substitua:
+- SEU_PROJETO pelo ref do Supabase
+- SEU_MODULO pelo alias do módulo (ex: "performance", "suppliers")
+- Ajuste as rotas e sidebar conforme o módulo
+```
+
+---
+
+## Checklist pós-criação
+
+- [ ] `forlogic-core` instalado como dependência
+- [ ] `vite.config.ts` usando `createSecurityHeadersPlugin`
+- [ ] `tailwind.config.ts` usando `forlogicTailwindPreset` + `forlogicContentPaths`
+- [ ] `App.tsx` usando `CoreProviders` + `AppLayout`
+- [ ] Sidebar com itens e separadores definidos
+- [ ] `usePageMetadata` em cada página
+- [ ] `.schema('SCHEMA_PADRAO')` em toda query Supabase
+- [ ] Arquivo `pt-BR.json` com traduções do módulo

package/docs/design-system/README.md

@@ -0,0 +1,45 @@
+<!-- ⚠️ ARQUIVO GERADO AUTOMATICAMENTE — NÃO EDITAR MANUALMENTE -->
+<!-- Fonte: src/design-system/docs/ | Regenerar: npx tsx scripts/generate-ds-docs.ts -->
+
+# Design System — forlogic-core
+
+> Gerado automaticamente em 2026-04-05
+> Total: 91 componentes documentados em 15 categorias
+
+## Categorias
+
+- [Fundação](./foundation.md) (7 componentes)
+- [Botões & Ações](./buttons-actions.md) (6 componentes)
+- [Inputs](./inputs.md) (10 componentes)
+- [Seletores](./selectors.md) (7 componentes)
+- [Data Display](./data-display.md) (8 componentes)
+- [Data Grid](./tables-grids.md) (3 componentes)
+- [Gráficos & Dashboards](./charts-dashboards.md) (11 componentes)
+- [Navegação](./navigation.md) (8 componentes)
+- [Dialogs](./dialogs.md) (11 componentes)
+- [Notifications & Feedback](./notifications-feedback.md) (4 componentes)
+- [Layout](./layout.md) (6 componentes)
+- [CRUD](./crud.md) (8 componentes)
+- [Plataforma](./platform.md) (6 componentes)
+- [Business Components](./domain.md) (12 componentes)
+- [Developer Tools](./infra-utils.md) (5 componentes)
+
+## Imports
+
+Todos os componentes são importados de `forlogic-core`:
+```tsx
+import { Button, Dialog, Input, Combobox, createCrudPage } from "forlogic-core";
+```
+
+## Aliases Disponíveis
+
+| Nome Atual | Alias | Import |
+|------------|-------|--------|
+| ComboTree | TreeSelect | `import { TreeSelect } from "forlogic-core"` |
+| Combobox | AutoComplete | `import { AutoComplete } from "forlogic-core"` |
+| StepSelector | Stepper | `import { Stepper } from "forlogic-core"` |
+| ActionButton | RowActions | `import { RowActions } from "forlogic-core"` |
+| TruncatedCell | EllipsisText | `import { EllipsisText } from "forlogic-core"` |
+| CrudPrimitiveTable | DataTable | `import { DataTable } from "forlogic-core"` |
+| CrudPrimitivePagination | DataPagination | `import { DataPagination } from "forlogic-core"` |
+| CrudPrimitiveFilterBar | DataFilterBar | `import { DataFilterBar } from "forlogic-core"` |