forlogic-core 1.16.8 → 1.16.10

package/dist/providers/CoreProviders.d.ts

@@ -1,6 +1,18 @@
 import { ReactNode } from 'react';
 import { QueryClient } from '@tanstack/react-query';
 import { ModuleAccessGuardProps } from '../components/modules';
+/**
+ * Mapa de traduções por idioma para o namespace 'app' do projeto consumidor.
+ *
+ * @example
+ * ```ts
+ * const appTranslations = {
+ *   'pt-BR': { greeting: 'Olá' },
+ *   'en-US': { greeting: 'Hello' },
+ * };
+ * ```
+ */
+export type AppTranslationsMap = Record<string, Record<string, string>>;
 /**
  * Props for CoreProviders component
  */
@@ -29,54 +41,39 @@ export interface CoreProvidersProps {
      * Permite configurar módulos contratados, callbacks e URLs.
      */
     moduleAccessGuardProps?: Omit<ModuleAccessGuardProps, 'children'>;
+    /**
+     * Traduções do projeto consumidor, organizadas por idioma.
+     * Injetadas no namespace 'app' do i18next, sobrepondo o namespace 'core' da lib.
+     *
+     * @example
+     * ```tsx
+     * <CoreProviders appTranslations={{
+     *   'pt-BR': { my_key: 'Meu valor' },
+     *   'en-US': { my_key: 'My value' },
+     * }}>
+     * ```
+     */
+    appTranslations?: AppTranslationsMap;
 }
 /**
  * CoreProviders - Encapsulates all essential providers for forlogic-core applications
  *
- * This component wraps your application with all necessary providers:
- * - ErrorBoundary (error handling)
- * - I18nextProvider (internationalization)
- * - QueryClientProvider (data fetching)
- * - AuthProvider (authentication)
- * - LocaleProvider (locale management)
- * - ModuleProvider (module access configuration)
- *
  * @example
  * ```tsx
  * import { CoreProviders } from 'forlogic-core';
- * import { BrowserRouter } from 'react-router-dom';
  *
  * function App() {
  *   return (
- *     <CoreProviders moduleAlias="performance">
+ *     <CoreProviders
+ *       moduleAlias="performance"
+ *       appTranslations={{ 'pt-BR': { greeting: 'Olá' } }}
+ *     >
  *       <BrowserRouter>
- *         <Routes>
- *           {/* Your routes here *\/}
- *         </Routes>
+ *         <Routes />
  *       </BrowserRouter>
  *     </CoreProviders>
  *   );
  * }
  * ```
- *
- * @example With custom QueryClient
- * ```tsx
- * import { CoreProviders } from 'forlogic-core';
- * import { QueryClient } from '@tanstack/react-query';
- *
- * const queryClient = new QueryClient({
- *   defaultOptions: {
- *     queries: { staleTime: 10 * 60 * 1000 },
- *   },
- * });
- *
- * function App() {
- *   return (
- *     <CoreProviders queryClient={queryClient} moduleAlias="suppliers">
- *       {/* Your app *\/}
- *     </CoreProviders>
- *   );
- * }
- * ```
  */
-export declare function CoreProviders({ children, queryClient, moduleAlias, moduleAccessGuardProps }: CoreProvidersProps): import("react/jsx-runtime").JSX.Element;
+export declare function CoreProviders({ children, queryClient, moduleAlias, moduleAccessGuardProps, appTranslations }: CoreProvidersProps): import("react/jsx-runtime").JSX.Element;

package/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forlogic-core",
-  "version": "1.16.8",
+  "version": "1.16.10",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -27,8 +27,7 @@
   "files": [
     "dist",
     "docs",
-    ".note/memory",
-    "DESIGN_SYSTEM.md"
+    ".note/memory"
   ],
   "sideEffects": [
     "*.css"
@@ -43,7 +42,7 @@
     "preview": "vite preview"
   },
   "bin": {
-    "lib-update": "dist/bin/pull-docs.js"
+    "lib-update": "dist/bin/bootstrap.js"
   },
   "dependencies": {
     "@dnd-kit/core": "^6.3.1",