forlogic-core 1.15.8 → 1.16.1

package/dist/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/dist/exports/ui.d.ts

@@ -71,3 +71,4 @@ export * from '../components/ui/rich-text-editor';
 export * from '../components/ui/onboarding-dialog';
 export * from '../components/ui/split-button';
 export * from '../components/ui/step-selector';
+export { ComboTree, type ComboTreeProps, type ComboTreeOption } from '../components/ui/combo-tree';

package/dist/hooks/useMediaQuery.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Hook reativo para media queries CSS via `matchMedia`.
+ *
+ * @example
+ * ```ts
+ * const isMobile = useMediaQuery('(max-width: 767px)');
+ * const prefersDark = useMediaQuery('(prefers-color-scheme: dark)');
+ * ```
+ */
+export declare function useMediaQuery(query: string): boolean;
+/**
+ * Atalho para detectar telas mobile (< 768px por padrão).
+ */
+export declare function useIsMobile(breakpoint?: number): boolean;

package/dist/hooks/useModuleAccess.d.ts

@@ -0,0 +1,60 @@
+import type { ModuleAccessResult } from '../types';
+/**
+ * Hook para verificar se o usuário logado tem acesso a um módulo específico.
+ *
+ * Busca a lista de softwares e as associações do usuário via API Qualiex,
+ * cruza os dados e retorna se o usuário tem acesso ao módulo configurado.
+ *
+ * **Pré-requisitos:**
+ * - O projeto deve configurar `moduleAlias` no `CoreProviders`
+ * - O usuário deve estar autenticado (via `useAuth`)
+ *
+ * **Cache:**
+ * - Softwares: cache de 30 minutos (raramente muda)
+ * - Associações: cache de 10 minutos (pode mudar com permissões)
+ * - Ambos são limpos automaticamente no `switchUnit`
+ *
+ * @param moduleAliasOverride - Alias opcional para verificar acesso a outro módulo
+ *                               (ignora o alias configurado no CoreProviders)
+ *
+ * @example
+ * ```tsx
+ * // Uso básico — verifica o módulo configurado no CoreProviders
+ * function Dashboard() {
+ *   const { hasAccess, isLoading, role } = useModuleAccess();
+ *
+ *   if (isLoading) return <LoadingState />;
+ *   if (!hasAccess) return <AccessDenied />;
+ *
+ *   return <DashboardContent />;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Verificar acesso a outro módulo
+ * function SupplierLink() {
+ *   const { hasAccessTo } = useModuleAccess();
+ *
+ *   if (!hasAccessTo('suppliers')) return null;
+ *   return <Link to="/suppliers">Fornecedores</Link>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Verificar acesso a múltiplos módulos
+ * function Navigation() {
+ *   const { hasAccessTo } = useModuleAccess();
+ *
+ *   return (
+ *     <nav>
+ *       {hasAccessTo('occurrences') && <Link to="/occurrences">Ocorrências</Link>}
+ *       {hasAccessTo('audit') && <Link to="/audit">Auditorias</Link>}
+ *       {hasAccessTo(['suppliers', 'suppliers-portal']) && <Link to="/suppliers">Fornecedores</Link>}
+ *     </nav>
+ *   );
+ * }
+ * ```
+ */
+export declare function useModuleAccess(moduleAliasOverride?: string): ModuleAccessResult;

package/dist/hooks/usePageTitle.d.ts

@@ -1,4 +1,10 @@
 /**
- * Hook para obter o título da página atual baseado na rota
+ * @deprecated Use a lógica de route matching diretamente no AppHeader.
+ * Mantido apenas para compatibilidade — não adicionar novos consumidores.
  */
 export declare function usePageTitle(): string;
+/** Função pura para resolver título — usada internamente pelo AppHeader */
+export declare function resolvePageTitle(navigation: Array<{
+    path: string;
+    label: string;
+}> | undefined, pathname: string): string;