forlogic-core 1.16.7 → 1.16.9

package/dist/docs/KNOWLEDGE.md

@@ -1,206 +1,107 @@
 # 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
+> 🤖 **Para IA**: Detalhes de componentes, props e tipos → ler do projeto **Admin** via cross-project.
+> Consulte `.note/memory/` para padrões de layout e componentes.
 
 ---
 
-## 0. Variável de Schema
+## 0. Schema do Projeto
 
-> ⚠️ **SCHEMA_PADRAO = `common`**
->
-> Todos os exemplos abaixo usam `SCHEMA_PADRAO`. Em cada projeto, substitua pelo schema correto.
-> **Neste projeto o schema é `common`.**
+**SCHEMA = `common`**
 
----
-
-## 1. Schema Padrão
-
-Toda query Supabase **DEVE** usar `.schema('SCHEMA_PADRAO')`. O projeto **NÃO** usa o schema `public`.
+☝️ Este é o **único local** onde o schema é definido. Toda query Supabase
+**DEVE** usar `.schema('<valor acima>')`. Altere **apenas aqui** ao configurar
+um novo projeto.
 
 ```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('*');
+// ✅ usar o schema definido acima
+supabase.schema('common').from('tabela').select('*');
+// ❌ vai falhar (sem schema)
+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)
+## 1. Regras Invioláveis
 
-```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
-);
-```
+| Regra | Detalhe |
+|-------|---------|
+| Schema obrigatório | `.schema()` com o schema do projeto (seção 0) em toda query |
+| Sem DELETE físico | Soft delete com `deleted_at` + policy `FOR UPDATE` |
+| Sem índices automáticos | Apenas com aprovação explícita |
+| 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`, nunca `@/integrations/supabase/client` |
 
-### Tabela de roles (quando necessário)
+---
 
-Usar função `SECURITY DEFINER` para checar roles e evitar recursão RLS:
+## 2. RLS — Resumo de Sintaxe
 
-```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)
-$$;
-```
+- `SELECT` → `USING` | `INSERT` → `WITH CHECK` | `UPDATE` → `USING` + `WITH CHECK`
+- **Nunca** `FOR DELETE`
+- **Sempre** `(SELECT auth.jwt())` com parênteses (evita re-execução por linha)
+- Padrão multi-tenant: `((SELECT auth.jwt()) ->> 'alias'::text) = alias`
 
 ---
 
-## 3. Convenções de Nomenclatura (SQL)
+## 3. Convenções SQL
 
 | Tipo | Padrão | Exemplo |
 |------|--------|---------|
-| FK | `id_<tabela_singular>` | `id_process`, `id_user` |
-| Boolean | `is_` ou `has_` | `is_active`, `has_access` |
+| FK | `id_<singular>` | `id_process` |
+| Boolean | `is_` / `has_` | `is_active` |
 | Timestamps | `created_at`, `updated_at`, `deleted_at` | — |
-| Tabelas | plural, snake_case | `processes`, `user_roles` |
+| Tabelas | plural, snake_case | `processes` |
 
 ---
 
-## 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`. |
+## 4. Mapa de Módulos (forlogic-core)
+
+> Para props, tipos e implementação: ler do projeto **Admin** (forlogic-core) via cross-project.
+
+| Módulo | Caminho | O que contém |
+|--------|---------|--------------|
+| **UI Components** | `lib/components/ui/` | Button, Dialog, Input, Select, Combobox, Badge, Tabs, etc. |
+| **Layout** | `lib/components/layout/` | AppLayout, AppHeader, AppSidebar, BodyContent |
+| **CRUD** | `lib/crud/` | createCrudPage, CrudTable, CrudGrid, BaseForm, ActionBar |
+| **CRUD Primitives** | `lib/crud/primitives/` | Table, FilterBar, Pagination, ActionMenu, TreeTable |
+| **Auth** | `lib/auth/` | AuthContext, ProtectedRoute, LoginPage, TokenManager |
+| **Módulos** | `lib/components/modules/` | ModulesDialog, ModuleGrid, ModuleAccessGuard |
+| **Places** | `lib/places/` | PlacesList, PlaceCard, ManageAccessModal |
+| **Leadership** | `lib/leadership/` | LeadershipPage, LeadershipDialog |
+| **Media** | `lib/media/` | ImageEditor, VideoEditor, useMediaUpload |
+| **Sign** | `lib/sign/` | SignWidget, D4SignWidget, SignConfigForm |
+| **Qualiex** | `lib/qualiex/` | QualiexUserField, useQualiexUsers |
+| **i18n** | `lib/i18n/` | Namespaces core/app, JSONs por idioma, addAppTranslations, formatadores |
+| **Config** | `lib/config/` | Environments, CRUD defaults, mensagens |
+| **Services** | `lib/services/` | BaseService, EmailService, ErrorService |
+| **Hooks** | `lib/hooks/` | useDebounce, useWizard, useModuleAccess, useColumnResize |
+| **Providers** | `lib/providers/` | CoreProviders (setup simplificado) |
+| **Vite** | `lib/vite/` | create-config, CSP, security headers |
+| **Tailwind** | `lib/tailwind/` | Preset compartilhado |
 
 ---
 
-## 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
+## 5. Padrões Deprecated
 
-```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 |
+| ❌ Não usar | ✅ Usar |
+|------------|--------|
+| `BulkActionBar` separado | Dropdown no `CrudActionBar` |
+| `<MoreHorizontal>` genérico | `ActionButton` |
 | Paginação manual | `CrudPrimitivePagination` |
-| `public` schema | `.schema('SCHEMA_PADRAO')` |
 | `StatusSelect` | `Combobox` |
 | `DeleteConfirmationDialog` | `Dialog` |
 | `Searchbar` | `Input` com ícone |
 
 ---
 
-## 8. Fontes Complementares
+## 6. Fontes de Contexto
 
-| 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.
+| Fonte | Caminho |
+|-------|---------|
+| Memory rules | `.note/memory/rules/` |
+| Memory patterns | `.note/memory/patterns/` |
+| Memory components | `.note/memory/components/` |
+| Código-fonte da lib | Cross-project → projeto **Admin** (forlogic-core) |
+| Design System (visual) | Rota `/ds` no app do projeto **Admin** |

package/dist/exports/crud.d.ts

@@ -17,5 +17,6 @@ export { Table as CrudPrimitiveTable } from '../crud/primitives/Table';
 export { ActionMenu } from '../crud/primitives/ActionMenu';
 export { Pagination as CrudPrimitivePagination } from '../crud/primitives/Pagination';
 export { FilterBar as CrudPrimitiveFilterBar } from '../crud/primitives/FilterBar';
-export type { TableProps as CrudPrimitiveTableProps, TableColumn, ActionMenuProps, ActionItem, PaginationProps as CrudPrimitivePaginationProps, FilterBarProps as CrudPrimitiveFilterBarProps, } from '../crud/primitives/types';
+export { TreeTable } from '../crud/primitives/TreeTable';
+export type { TableProps as CrudPrimitiveTableProps, TableColumn, ActionMenuProps, ActionItem, PaginationProps as CrudPrimitivePaginationProps, FilterBarProps as CrudPrimitiveFilterBarProps, TreeNode, TreeTableColumn, TreeTableProps, } from '../crud/primitives/types';
 export * from '../crud/utils/routingHelpers';

package/dist/hooks/useDerivedContractedModules.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hook que deriva a lista de módulos contratados a partir das associações do usuário.
+ * Cruza `association.softwares` com `SOFTWARES_MAP` e `MODULES_DATA`.
+ *
+ * @param override - Se fornecido, retorna diretamente (bypass da derivação)
+ * @returns Lista de nomes de módulos contratados, ou `undefined` se dados indisponíveis
+ */
+export declare function useDerivedContractedModules(override?: string[]): string[] | undefined;

package/dist/i18n/config.d.ts

@@ -1,2 +1,13 @@
 import i18n from 'i18next';
+/**
+ * Injeta traduções do projeto consumidor no namespace 'app'.
+ * Chamado pelo CoreProviders ou manualmente no setup do projeto.
+ *
+ * @example
+ * ```ts
+ * import ptBR from './locales/pt-BR.json';
+ * addAppTranslations('pt-BR', ptBR);
+ * ```
+ */
+export declare function addAppTranslations(lang: string, translations: Record<string, string>): void;
 export default i18n;

package/dist/i18n/index.d.ts

@@ -14,7 +14,7 @@
  * }
  * ```
  */
-export { default as i18n } from './config';
+export { default as i18n, addAppTranslations } from './config';
 export { useTranslation } from 'react-i18next';
 export { I18nextProvider } from 'react-i18next';
 export * from './constants';