forlogic-core 1.15.8 → 1.16.1

package/docs/KNOWLEDGE.md

@@ -0,0 +1,206 @@
+# KNOWLEDGE — Regras Críticas do Projeto
+
+> 📖 **Fonte oficial completa**: `README.md` | 🎨 **Design System**: `docs/DESIGN_SYSTEM.md`
+> 🤖 **Para IA**: Consulte `.note/memory/` para padrões de componentes e layout
+
+---
+
+## 0. Variável de Schema
+
+> ⚠️ **SCHEMA_PADRAO = `common`**
+>
+> Todos os exemplos abaixo usam `SCHEMA_PADRAO`. Em cada projeto, substitua pelo schema correto.
+> **Neste projeto o schema é `common`.**
+
+---
+
+## 1. Schema Padrão
+
+Toda query Supabase **DEVE** usar `.schema('SCHEMA_PADRAO')`. O projeto **NÃO** usa o schema `public`.
+
+```ts
+// ✅ CORRETO
+const { data } = await supabase.schema('SCHEMA_PADRAO').from('tabela').select('*');
+
+// ❌ ERRADO (vai falhar em produção)
+const { data } = await supabase.from('tabela').select('*');
+```
+
+---
+
+## 2. RLS Policies
+
+### Regras obrigatórias
+- **NUNCA** criar policy `FOR DELETE` — usar soft delete (`deleted_at` + policy `FOR UPDATE`)
+- **SEMPRE** usar `(SELECT auth.uid())` ou `(SELECT auth.jwt())` com parênteses — evita re-execução por linha
+- Sintaxe: `SELECT` → `USING` | `INSERT` → `WITH CHECK` | `UPDATE` → `USING` + `WITH CHECK`
+
+### Padrão JWT alias (multi-tenancy por alias)
+
+```sql
+-- SELECT
+CREATE POLICY "table_select" ON SCHEMA_PADRAO.tabela
+FOR SELECT USING (
+  ((SELECT auth.jwt()) ->> 'alias'::text) = alias
+);
+
+-- INSERT
+CREATE POLICY "table_insert" ON SCHEMA_PADRAO.tabela
+FOR INSERT WITH CHECK (
+  ((SELECT auth.jwt()) ->> 'alias'::text) = alias
+);
+
+-- UPDATE
+CREATE POLICY "table_update" ON SCHEMA_PADRAO.tabela
+FOR UPDATE
+USING (((SELECT auth.jwt()) ->> 'alias'::text) = alias)
+WITH CHECK (((SELECT auth.jwt()) ->> 'alias'::text) = alias);
+```
+
+### Alternativa: auth.uid() (quando tabela tem `id_user`)
+
+```sql
+CREATE POLICY "table_select" ON SCHEMA_PADRAO.tabela
+FOR SELECT USING (auth.uid() = id_user);
+
+CREATE POLICY "table_insert" ON SCHEMA_PADRAO.tabela
+FOR INSERT WITH CHECK (auth.uid() = id_user);
+
+CREATE POLICY "table_update" ON SCHEMA_PADRAO.tabela
+FOR UPDATE
+USING (auth.uid() = id_user)
+WITH CHECK (auth.uid() = id_user);
+```
+
+### Padrão company_id (multi-tenancy por empresa)
+
+```sql
+CREATE POLICY "table_select" ON SCHEMA_PADRAO.tabela
+FOR SELECT TO authenticated
+USING (
+  company_id = (
+    SELECT (auth.jwt() -> 'user_metadata' ->> 'company_id')::uuid
+  )
+);
+```
+
+### ❌ Erros comuns de RLS
+
+```sql
+-- ❌ WITH CHECK em SELECT (deve ser USING)
+CREATE POLICY "x" ON SCHEMA_PADRAO.t FOR SELECT WITH CHECK (...);
+
+-- ❌ USING em INSERT (deve ser WITH CHECK)
+CREATE POLICY "x" ON SCHEMA_PADRAO.t FOR INSERT USING (...);
+
+-- ❌ Parênteses extra no JWT
+CREATE POLICY "x" ON SCHEMA_PADRAO.t FOR SELECT USING (
+  ((SELECT (auth.jwt()) ->> 'alias'::text)) = alias
+);
+
+-- ❌ Política DELETE (usar soft delete)
+CREATE POLICY "x" ON SCHEMA_PADRAO.t FOR DELETE USING (...);
+```
+
+### Soft delete (padrão obrigatório)
+
+```sql
+ALTER TABLE SCHEMA_PADRAO.tabela ADD COLUMN deleted_at TIMESTAMP WITH TIME ZONE;
+
+-- Filtrar registros ativos
+CREATE POLICY "table_select" ON SCHEMA_PADRAO.tabela
+FOR SELECT USING (
+  deleted_at IS NULL
+  AND ((SELECT auth.jwt()) ->> 'alias'::text) = alias
+);
+```
+
+### Tabela de roles (quando necessário)
+
+Usar função `SECURITY DEFINER` para checar roles e evitar recursão RLS:
+
+```sql
+CREATE FUNCTION public.has_role(_user_id uuid, _role app_role)
+RETURNS boolean LANGUAGE sql STABLE SECURITY DEFINER
+SET search_path = public AS $$
+  SELECT EXISTS (SELECT 1 FROM public.user_roles WHERE user_id = _user_id AND role = _role)
+$$;
+```
+
+---
+
+## 3. Convenções de Nomenclatura (SQL)
+
+| Tipo | Padrão | Exemplo |
+|------|--------|---------|
+| FK | `id_<tabela_singular>` | `id_process`, `id_user` |
+| Boolean | `is_` ou `has_` | `is_active`, `has_access` |
+| Timestamps | `created_at`, `updated_at`, `deleted_at` | — |
+| Tabelas | plural, snake_case | `processes`, `user_roles` |
+
+---
+
+## 4. Proibições
+
+| Regra | Detalhe |
+|-------|---------|
+| ❌ Índices automáticos | Nunca criar índices em migrations sem aprovação explícita |
+| ❌ Modificar `.env` | Nunca sem autorização explícita do usuário |
+| ❌ Policy DELETE | Usar soft delete com `deleted_at` |
+| ❌ Duplicar componentes da lib | Sempre usar `forlogic-core` primeiro |
+| ❌ Hardcoded admin checks | Nunca usar localStorage/sessionStorage para verificar roles |
+| ❌ Import direto do client auto-gerado | Nunca importar de `@/integrations/supabase/client`. Usar `getSupabaseClient()` de `forlogic-core`. ESLint `no-restricted-imports` bloqueia automaticamente. O arquivo existe apenas como fonte de dados para o `vite.config.ts`. |
+
+---
+
+## 5. Lib-First (forlogic-core)
+
+Antes de criar qualquer componente, verificar se já existe em `forlogic-core`:
+
+- **UI**: Button, Dialog, Input, Select, Combobox, SplitButton, RichTextEditor, ColorPicker, IconPicker, etc.
+- **Layout**: AppLayout, AppHeader, AppSidebar, BodyContent
+- **CRUD**: createCrudPage, CrudTable, CrudGrid, CrudActionBar, BaseForm
+- **Utilitários**: ActionButton, Pagination, FilterBar, EmptyState, LoadingState, StepSelector
+- **Módulos**: Sign, Places, Leadership, Media, ModulesDialog
+
+```ts
+import { Button, Dialog, createCrudPage, cn, formatDatetime } from 'forlogic-core';
+```
+
+---
+
+## 6. Padrões CRUD
+
+- **Toolbar**: Layout 3 zonas — Esquerda (Botão Novo + Ações em lote), Centro (Busca), Direita (Filtros + Toggle view)
+- **Paginação**: Sempre usar `CrudPrimitivePagination` com `variant="full"`
+- **Ações em lote**: Dropdown "Ações em lote" no CrudActionBar (não criar BulkActionBar separado)
+- **Ações de linha**: Sempre usar `ActionButton` da lib (nunca botão genérico com ícone MoreHorizontal)
+
+---
+
+## 7. Componentes/Padrões Deprecated
+
+| Não usar | Usar em vez disso |
+|----------|-------------------|
+| `BulkActionBar` separado | Dropdown integrado no `CrudActionBar` |
+| Botão genérico `<MoreHorizontal>` | `ActionButton` da lib |
+| Paginação manual | `CrudPrimitivePagination` |
+| `public` schema | `.schema('SCHEMA_PADRAO')` |
+| `StatusSelect` | `Combobox` |
+| `DeleteConfirmationDialog` | `Dialog` |
+| `Searchbar` | `Input` com ícone |
+
+---
+
+## 8. Fontes Complementares
+
+| Fonte | Caminho | Conteúdo |
+|-------|---------|----------|
+| **Memory rules** | `.note/memory/rules/` | Regras de schema, RLS, índices, .env |
+| **Memory patterns** | `.note/memory/patterns/` | Layouts CRUD, toolbar, scroll, navegação SPA |
+| **Memory components** | `.note/memory/components/` | ActionButton, BaseForm, Dialog, Pagination |
+| **README.md** | `README.md` | Documentação completa e genérica da lib |
+| **Design System** | Rota `/ds` no app | Documentação visual de todos os componentes |
+| **DESIGN_SYSTEM.md** | `docs/DESIGN_SYSTEM.md` | Documentação técnica do Design System |
+
+> 📌 Ao implementar qualquer funcionalidade, consulte as fontes acima antes de criar código novo.

package/docs/PUBLISH.md

@@ -0,0 +1,168 @@
+# 📦 Como Publicar a Biblioteca forlogic-core
+
+> **Nota:** Para documentação de uso e instalação da biblioteca, consulte [README.md](../README.md)
+
+## Configuração Inicial
+
+A biblioteca está configurada para ser publicada no NPM como `forlogic-core`.
+
+### Arquivos de Configuração
+
+- `package.json` - Configuração principal com campos de biblioteca
+- `rollup.config.js` - Configuração de build
+- `tsconfig.json` - Configuração TypeScript unificada
+- `.npmignore` - Arquivos excluídos da publicação (inclui `docs/` - não publicada no NPM)
+- `README.md` - Documentação principal (copiada para dist/)
+
+## Comandos Disponíveis
+
+### 1. Build da Biblioteca
+
+```bash
+npm run build:lib
+```
+
+### 2. Teste de Publicação (Dry Run)
+
+```bash
+npm publish --dry-run
+```
+
+### 3. Release Automatizado (Recomendado)
+
+**Script JavaScript**
+
+```bash
+# Release patch (1.0.0 → 1.0.1)
+node scripts/publish/release.js patch
+
+# Release minor (1.0.0 → 1.1.0)
+node scripts/publish/release.js minor
+
+# Release major (1.0.0 → 2.0.0)
+node scripts/publish/release.js major
+```
+
+### 4. Publicação Manual (Legado)
+
+```bash
+# Incrementar versão e publicar manualmente
+npm version patch   # 1.0.0 → 1.0.1
+npm version minor   # 1.0.0 → 1.1.0
+npm version major   # 1.0.0 → 2.0.0
+
+# Publicar versão atual
+npm publish
+```
+
+## Processo de Release Automatizado
+
+### Scripts Automatizados
+
+Os scripts `scripts/publish/release.js` e `scripts/publish/release.sh` executam automaticamente:
+
+1. **Verificação**: Confere se não há mudanças pendentes no Git
+2. **Build**: Executa `npm run build:lib` com Rollup
+3. **Versão**: Incrementa versão no `package.json`
+4. **Publicação**: Publica no NPM
+5. **Tags**: Envia tags para o GitHub
+
+### Processo Manual (Legado)
+
+1. **Build**: Executa `npm run build:lib` com Rollup
+2. **Geração**: Cria arquivos CJS, ESM e declarações TypeScript
+3. **Publicação**: Usa `npm publish` diretamente
+
+## Estrutura da Publicação
+
+```
+dist/
+├── index.js           # CommonJS
+├── index.esm.js       # ES Modules
+├── index.d.ts         # TypeScript declarations
+├── index.css          # CSS da biblioteca
+├── package.json       # Configuração da lib
+└── README.md          # Documentação
+```
+
+## Documentação para Usuários
+
+A documentação completa está **consolidada no README.md** e disponível publicamente no repositório GitHub:
+
+- **[📖 README.md](../README.md)** - Guia completo (~350 linhas)
+  - ✅ Regras críticas e checklist
+  - ✅ Quick start CRUD
+  - ✅ Migrations e RLS
+  - ✅ Troubleshooting
+  - ✅ Referência rápida
+
+### ⚙️ Documentação no Pacote NPM
+
+O `README.md` é incluído no pacote NPM publicado (`dist/README.md`) e contém toda a documentação necessária em um único arquivo otimizado para leitura por IA e desenvolvedores.
+
+#### Documentações Modulares
+
+Algumas features possuem documentação detalhada em arquivos específicos para desenvolvimento local:
+
+- `lib/crud/components/CUSTOM_FIELDS.md` - Campos customizados do BaseForm
+- `lib/qualiex/places/README.md` - Sistema de gestores de locais
+
+**Importante:** Essas documentações **não são publicadas no NPM**. O conteúdo consolidado está no `README.md` principal que é copiado para `dist/README.md`.
+
+## Verificação antes da Publicação
+
+1. ✅ Build bem-sucedido (`npm run build:lib`)
+2. ✅ Dry-run sem erros (`npm publish --dry-run`)
+3. ✅ Versão correta no `package.json`
+4. ✅ README atualizado
+5. ✅ Changelog documentado (se aplicável)
+
+## Troubleshooting
+
+### Erro de Permissão NPM
+
+```bash
+npm login
+```
+
+### Build Falha
+
+Verifique se todas as dependências estão instaladas:
+
+```bash
+npm install
+```
+
+### Rollup Errors
+
+Confirme que o `rollup.config.js` está correto e que o `lib/index.ts` existe e exporta tudo necessário.
+
+### CSS Import Issues
+
+Se houver erro ao importar CSS, use:
+
+```tsx
+import 'forlogic-core/index.css';
+```
+
+O CSS é extraído para `index.css` durante o build da biblioteca.
+
+# Comandos Disponíveis
+
+## Instalar a última versão do forlogic-core
+
+```bash
+npm i forlogic-core@latest
+```
+
+## Build do projeto
+
+```bash
+npm run build
+```
+
+## Limpar cache do NPM
+
+```bash
+npm cache clean --force
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forlogic-core",
-  "version": "1.15.8",
+  "version": "1.16.1",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -26,6 +26,8 @@
   },
   "files": [
     "dist",
+    "docs",
+    ".note/memory",
     "DESIGN_SYSTEM.md"
   ],
   "sideEffects": [
@@ -44,13 +46,9 @@
     "lib-update": "dist/bin/pull-docs.js"
   },
   "dependencies": {
-    "@babel/parser": "^7.28.5",
-    "@babel/traverse": "^7.28.5",
-    "@babel/types": "^7.28.5",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@hookform/resolvers": "^3.10.0",
-    "@playwright/test": "^1.57.0",
     "@radix-ui/react-accordion": "^1.2.11",
     "@radix-ui/react-alert-dialog": "^1.1.14",
     "@radix-ui/react-avatar": "^1.1.10",
@@ -77,12 +75,7 @@
     "@radix-ui/react-toggle": "^1.1.9",
     "@radix-ui/react-toggle-group": "^1.1.10",
     "@radix-ui/react-tooltip": "^1.2.7",
-    "@rollup/plugin-commonjs": "^28.0.6",
-    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^16.0.1",
-    "@rollup/plugin-terser": "^0.4.4",
-    "@supabase/supabase-js": "^2.98.0",
-    "@svgr/rollup": "^8.1.0",
+    "@supabase/supabase-js": "^2.99.0",
     "@tanstack/react-query": "^5.83.0",
     "@tiptap/extension-color": "^3.14.0",
     "@tiptap/extension-highlight": "^3.14.0",
@@ -97,22 +90,16 @@
     "date-fns-tz": "^3.2.0",
     "exceljs": "^4.4.0",
     "i18next-browser-languagedetector": "^8.2.0",
+    "jszip": "^3.10.1",
     "lucide-react": "^0.553.0",
     "next-themes": "^0.3.0",
     "react": "^18.3.1",
     "react-day-picker": "^9.13.0",
     "react-dom": "^18.3.1",
     "react-hook-form": "^7.61.1",
-    "react-is": "^19.2.3",
-    "react-markdown": "^10.1.0",
-    "react-refresh": "^0.18.0",
     "react-resizable-panels": "^3.0.6",
     "react-router-dom": "^6.30.1",
     "recharts": "^3.6.0",
-    "remark-gfm": "^4.0.1",
-    "rollup": "^4.50.1",
-    "rollup-plugin-copy": "^3.5.0",
-    "rollup-plugin-postcss": "^4.0.2",
     "sonner": "^1.7.4",
     "tailwind-merge": "^3.3.1",
     "tailwindcss-animate": "^1.0.7",
@@ -124,9 +111,17 @@
     "react-i18next": "^16.0.0"
   },
   "devDependencies": {
+    "@babel/parser": "^7.28.5",
+    "@babel/traverse": "^7.28.5",
+    "@babel/types": "^7.28.5",
     "@eslint/js": "^9.32.0",
+    "@rollup/plugin-commonjs": "^28.0.6",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-terser": "1.0.0",
     "@rollup/plugin-typescript": "^12.1.4",
     "@rollup/plugin-url": "^8.0.2",
+    "@svgr/rollup": "^8.1.0",
     "@tailwindcss/typography": "^0.5.16",
     "@types/file-saver": "^2.0.7",
     "@types/node": "^22.16.5",
@@ -141,7 +136,10 @@
     "globals": "^15.15.0",
     "lovable-tagger": "^1.1.9",
     "postcss": "^8.5.6",
+    "rollup": "^4.50.1",
+    "rollup-plugin-copy": "^3.5.0",
     "rollup-plugin-esbuild": "^6.2.1",
+    "rollup-plugin-postcss": "^4.0.2",
     "tailwindcss": "^3.4.17",
     "tsx": "^4.20.6",
     "typescript": "^5.8.3",