forlogic-core 2.2.8 → 2.3.1

package/dist/sign/utils/formatters/dateFormatters.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Formata uma string ISO 8601 para o formato de data/hora especificado,
+ * convertendo para o timezone do usuário
+ *
+ * @param dateString - String de data no formato ISO 8601 (ex: "2024-03-15T14:30:00Z")
+ * @param datetimeFormat - Máscara de formato date-fns (ex: "dd/MM/yyyy HH:mm")
+ * @param timezone - Identificador IANA do fuso horário (ex: "America/Sao_Paulo")
+ * @param locale - Código do locale para formatação de nomes de mês/dia
+ * @returns String formatada no timezone especificado ou mensagem de erro
+ *
+ * @example
+ * ```ts
+ * // Data UTC sendo exibida em Brasília (UTC-3)
+ * formatDatetime("2024-03-15T17:30:00Z", "dd/MM/yyyy HH:mm", "America/Sao_Paulo");
+ * // "15/03/2024 14:30"
+ *
+ * // Mesma data em Tokyo (UTC+9)
+ * formatDatetime("2024-03-15T17:30:00Z", "dd/MM/yyyy HH:mm", "Asia/Tokyo");
+ * // "16/03/2024 02:30"
+ *
+ * // Com formato americano
+ * formatDatetime("2024-03-15T17:30:00Z", "MM/dd/yyyy hh:mm a", "America/New_York", "en-US");
+ * // "03/15/2024 01:30 PM"
+ * ```
+ */
+export declare const formatDatetime: (dateString: string, datetimeFormat?: string, timezone?: string, locale?: string) => string;
+/**
+ * Formata uma string ISO 8601 para formato de data localizado (sem hora),
+ * convertendo para o timezone do usuário
+ *
+ * Usa o formato 'PP' do date-fns que se adapta automaticamente ao locale:
+ * - pt-BR: "15 de mar. de 2024"
+ * - en-US: "Mar 15, 2024"
+ * - es-ES: "15 mar 2024"
+ *
+ * @param dateString - String de data no formato ISO 8601
+ * @param locale - Código do locale para formatação
+ * @param timezone - Identificador IANA do fuso horário (para determinar a data correta)
+ * @returns String formatada ou mensagem de erro
+ *
+ * @example
+ * ```ts
+ * // Data UTC às 23:00 em Brasília ainda é dia 15
+ * formatDate("2024-03-15T23:00:00Z", "pt-BR", "America/Sao_Paulo");
+ * // "15 de mar. de 2024"
+ *
+ * // Mas em Tokyo (UTC+9) já é dia 16
+ * formatDate("2024-03-15T23:00:00Z", "en-US", "Asia/Tokyo");
+ * // "Mar 16, 2024"
+ * ```
+ */
+export declare const formatDate: (dateString: string, locale?: string, timezone?: string) => string;

package/dist/sign/utils/index.d.ts

@@ -0,0 +1,9 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;
+export declare const trimTextFields: (data: any) => any;
+export { formatDatetime, formatDate } from './formatters/dateFormatters';
+export { formatCurrency } from './formatters/currencyFormatters';
+export declare const debounce: <T extends (...args: any[]) => any>(func: T, wait: number) => ((...args: Parameters<T>) => void);
+export declare const slugify: (text: string) => string;
+export { generatePastelBg, getLuminance, getContrastRatio } from './color';
+export { handleExternalLink, buildModuleUrl } from './linkHelpers';

package/dist/sign/utils/linkHelpers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Abre link externo em nova aba ou copia para clipboard se bloqueado pelo navegador
+ */
+export declare function handleExternalLink(url: string, e?: React.MouseEvent): void;
+/**
+ * Substitui placeholders `{alias}` em uma URL de módulo pelo alias ativo.
+ * Se alias não fornecido, retorna a URL original.
+ */
+export declare function buildModuleUrl(urlTemplate: string, alias?: string): string;

package/dist/sign/utils/load-fonts.d.ts

@@ -0,0 +1 @@
+export declare function loadForlogicFonts(): void;

package/dist/supabase/SupabaseSingleton.d.ts

@@ -1,37 +1,34 @@
 import { SupabaseClient } from '@supabase/supabase-js';
 import type { Database } from './types';
+/**
+ * Retorna `true` se as variáveis de ambiente do Supabase estão configuradas.
+ * Útil para módulos que precisam habilitar features Supabase-only condicionalmente.
+ *
+ * @example
+ * ```ts
+ * import { isSupabaseConfigured, getSupabaseClient } from 'forlogic-core';
+ *
+ * if (isSupabaseConfigured()) {
+ *   const supabase = getSupabaseClient();
+ *   // ...
+ * }
+ * ```
+ */
+export declare function isSupabaseConfigured(): boolean;
 /**
  * Retorna a instância singleton do client Supabase já configurada (URL, anon key e schema padrão).
  *
  * **Sempre** use esta função — nunca invoque `createClient` manualmente. Toda query exige
  * `.schema('<schema>')` explícito (multi-tenant). Ver `mem://patterns/supabase-client-guards`.
  *
+ * **Lazy:** instancia o client apenas no primeiro uso. Lança erro se as env vars do
+ * Supabase não estiverem configuradas — use `isSupabaseConfigured()` para checar.
+ *
  * @example
- * // Query em schema específico (obrigatório)
  * const supabase = getSupabaseClient();
  * const { data, error } = await supabase
  *   .schema('central')
  *   .from('action_plans')
- *   .select('id, title, status')
- *   .eq('alias', currentAlias)
- *   .is('deleted_at', null)
- *   .order('created_at', { ascending: false });
- *
- * @example
- * // Insert com retorno
- * const { data } = await supabase
- *   .schema('central')
- *   .from('matrices')
- *   .insert({ alias, title: 'Nova Matriz', id_user: userId })
- *   .select()
- *   .single();
- *
- * @example
- * // Soft delete (nunca DELETE físico)
- * await supabase
- *   .schema('central')
- *   .from('requirements')
- *   .update({ deleted_at: new Date().toISOString() })
- *   .eq('id', requirementId);
+ *   .select('id, title, status');
  */
 export declare function getSupabaseClient(): SupabaseClient<Database>;

package/dist/vite/index.esm.js

@@ -1,3 +1,5 @@
+import { loadEnv } from 'vite';
+
 const DEFAULT_SCRIPT_SRC = [
   "'self'",
   "https://cdn.gpteng.co",
@@ -207,4 +209,25 @@ function createForlogicViteConfig(options = {}) {
 }
 const defaultForlogicViteConfig = createForlogicViteConfig();
 
-export { createForlogicViteConfig, createSecurityHeadersPlugin, defaultForlogicViteConfig, generateCSPPolicy };
+function resolveSupabaseEnv(mode, cwd = process.cwd()) {
+  const env = loadEnv(mode, cwd, "");
+  const url = env.VITE_SUPABASE_URL || env.SUPABASE_URL || "";
+  const publishableKey = env.VITE_SUPABASE_PUBLISHABLE_KEY || env.SUPABASE_PUBLISHABLE_KEY || "";
+  const pkOverride = env.VITE_SUPABASE_PK_OVERRIDE || "";
+  let projectId = env.VITE_SUPABASE_PROJECT_ID || env.SUPABASE_PROJECT_ID || "";
+  if (!projectId && url) {
+    try {
+      projectId = new URL(url).hostname.split(".")[0];
+    } catch {
+    }
+  }
+  const define = {
+    "import.meta.env.VITE_SUPABASE_URL": JSON.stringify(url),
+    "import.meta.env.VITE_SUPABASE_PUBLISHABLE_KEY": JSON.stringify(publishableKey),
+    "import.meta.env.VITE_SUPABASE_PROJECT_ID": JSON.stringify(projectId),
+    "import.meta.env.VITE_SUPABASE_PK_OVERRIDE": JSON.stringify(pkOverride)
+  };
+  return { url, publishableKey, projectId, pkOverride, define };
+}
+
+export { createForlogicViteConfig, createSecurityHeadersPlugin, defaultForlogicViteConfig, generateCSPPolicy, resolveSupabaseEnv };

package/dist/vite/index.js

@@ -1,5 +1,7 @@
 'use strict';
 
+var vite = require('vite');
+
 const DEFAULT_SCRIPT_SRC = [
   "'self'",
   "https://cdn.gpteng.co",
@@ -209,7 +211,29 @@ function createForlogicViteConfig(options = {}) {
 }
 const defaultForlogicViteConfig = createForlogicViteConfig();
 
+function resolveSupabaseEnv(mode, cwd = process.cwd()) {
+  const env = vite.loadEnv(mode, cwd, "");
+  const url = env.VITE_SUPABASE_URL || env.SUPABASE_URL || "";
+  const publishableKey = env.VITE_SUPABASE_PUBLISHABLE_KEY || env.SUPABASE_PUBLISHABLE_KEY || "";
+  const pkOverride = env.VITE_SUPABASE_PK_OVERRIDE || "";
+  let projectId = env.VITE_SUPABASE_PROJECT_ID || env.SUPABASE_PROJECT_ID || "";
+  if (!projectId && url) {
+    try {
+      projectId = new URL(url).hostname.split(".")[0];
+    } catch {
+    }
+  }
+  const define = {
+    "import.meta.env.VITE_SUPABASE_URL": JSON.stringify(url),
+    "import.meta.env.VITE_SUPABASE_PUBLISHABLE_KEY": JSON.stringify(publishableKey),
+    "import.meta.env.VITE_SUPABASE_PROJECT_ID": JSON.stringify(projectId),
+    "import.meta.env.VITE_SUPABASE_PK_OVERRIDE": JSON.stringify(pkOverride)
+  };
+  return { url, publishableKey, projectId, pkOverride, define };
+}
+
 exports.createForlogicViteConfig = createForlogicViteConfig;
 exports.createSecurityHeadersPlugin = createSecurityHeadersPlugin;
 exports.defaultForlogicViteConfig = defaultForlogicViteConfig;
 exports.generateCSPPolicy = generateCSPPolicy;
+exports.resolveSupabaseEnv = resolveSupabaseEnv;

package/docs/PUBLISH.md

@@ -75,16 +75,28 @@ Os scripts `scripts/publish/release.js` e `scripts/publish/release.sh` executam
 
 ## Estrutura da Publicação
 
+A lib gera **múltiplos entry points** (configurados em `rollup.config.js` e expostos em `package.json#exports`):
+
 ```
 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
+├── index.js / index.esm.js / index.d.ts   # Barrel principal (sem Supabase obrigatório)
+├── index.css                              # CSS da biblioteca
+├── vite/                                  # forlogic-core/vite
+├── tailwind/                              # forlogic-core/tailwind
+├── tokens/                                # forlogic-core/tokens
+├── sign/                                  # forlogic-core/sign          (requer Supabase)
+├── audit-trail/                           # forlogic-core/audit-trail   (requer Supabase)
+├── action-plans/                          # forlogic-core/action-plans  (requer Supabase)
+├── leadership/                            # forlogic-core/leadership    (requer Supabase)
+├── places/                                # forlogic-core/places        (requer Supabase)
+├── package.json
+└── README.md
 ```
 
+> ⚠️ **Breaking change**: os módulos `sign`, `audit-trail`, `action-plans`, `leadership` e `places` foram **removidos do barrel principal**. Consumidores precisam migrar para os subpaths (`forlogic-core/<modulo>`). Isso permite que projetos sem Supabase usem `CoreProviders backend="dotnet"` sem puxar dependências indesejadas.
+
+Ao alterar `rollup.config.js` (novos entry points), **lembre-se de atualizar `package.json#exports` em conjunto** — caso contrário o consumidor recebe `ERR_PACKAGE_PATH_NOT_EXPORTED`.
+
 ## Documentação para Usuários
 
 A documentação completa está **consolidada no README.md** e disponível publicamente no repositório GitHub:

package/docs/WORKSPACE_KNOWLEDGE.md

@@ -75,7 +75,40 @@ supabase.from('tabela').select('*');
 | Import do Supabase | `getSupabaseClient()` de `forlogic-core` |
 | Import de i18n | `useTranslation` de `forlogic-core`, nunca de `react-i18next` |
 | Sem hardcoded admin | Nunca localStorage/sessionStorage para roles |
-| **PK Override** | `VITE_SUPABASE_PK_OVERRIDE` **obrigatória** no `.env` — nunca remover. Ver `@Admin docs/design-system/patterns/feature-flags.md` |
+| **PK Override** | `VITE_SUPABASE_PK_OVERRIDE` **obrigatória** no `.env` quando `backend="supabase"` — nunca remover. Ver `@Admin docs/design-system/patterns/feature-flags.md` |
+
+---
+
+## Backend opcional (Supabase)
+
+> Detalhes: `@Admin docs/design-system/patterns/core-providers.md` (seção "Backend (Supabase opcional)").
+
+`CoreProviders` aceita a prop `backend`:
+
+| Modo | Quando usar | Envs exigidas |
+|------|-------------|---------------|
+| `'supabase'` (default) | App usa tabelas/edge functions do Supabase | `SUPABASE_URL` + `SUPABASE_PUBLISHABLE_KEY` (ou `VITE_SUPABASE_*` legadas — consolidadas pelo `resolveSupabaseEnv()` no `vite.config.ts`) + `VITE_SUPABASE_PK_OVERRIDE` |
+| `'dotnet'` | App consome apenas a API .NET do Qualiex (ex.: Documentos) | nenhuma do Supabase |
+
+```tsx
+<CoreProviders backend="dotnet" appTranslations={{ 'pt-BR': pt }}>
+  <BrowserRouter>...</BrowserRouter>
+</CoreProviders>
+```
+
+### Subpaths obrigatórios (breaking change)
+
+Os módulos abaixo **foram removidos do barrel principal** e só podem ser importados via subpath. Eles continuam exigindo Supabase em runtime:
+
+| Módulo | Import |
+|--------|--------|
+| Assinatura digital | `import { DocumentSigner } from 'forlogic-core/sign'` |
+| Trilha de auditoria | `import { AuditTrailPage } from 'forlogic-core/audit-trail'` |
+| Planos de ação | `import { ... } from 'forlogic-core/action-plans'` |
+| Liderança | `import { ... } from 'forlogic-core/leadership'` |
+| UO / Places | `import { ... } from 'forlogic-core/places'` |
+
+Use `isSupabaseConfigured()` para checar disponibilidade antes de instanciar o cliente Supabase em código condicional.
 
 ### Política de acesso `anon` no Supabase
 

package/docs/design-system/patterns/core-providers.md

@@ -31,8 +31,45 @@
 | moduleAlias | string | Não | Alias do módulo para verificação de acesso |
 | moduleAccessGuardProps | object | Não | Props para o ModuleAccessGuard |
 | appTranslations | Record<string, Record<string, string>> | Não | Traduções por idioma no namespace 'app' |
-| clarityProjectId | string | Não | Project ID do Microsoft Clarity. Sem ele, integração desativada. Ver `/ds/clarity-tracking`. |
+| clarityProjectId | string | Não | Project ID do Microsoft Clarity. Sem ele, integração desativada. |
 | clarityMode | 'auto' \| 'disabled' | Não | Opt-out do tracking Clarity. Default `'auto'`. |
+| backend | 'supabase' \| 'dotnet' | Não | Backend ativo. Default `'supabase'`. Ver seção abaixo. |
+
+## Backend (Supabase opcional)
+
+A prop `backend` controla se a lib usa o stack Supabase ou apenas a API .NET do Qualiex.
+
+- `'supabase'` (default, retrocompat): inicializa o cliente Supabase, valida tokens via Edge Function `validate-token` e exige `SUPABASE_URL` + `SUPABASE_PUBLISHABLE_KEY` (ou as versões `VITE_SUPABASE_*` legadas) no `.env`. O `vite.config.ts` consolida ambos os formatos via `resolveSupabaseEnv()` — ver `docs/design-system/patterns/feature-flags.md`.
+- `'dotnet'`: a lib **não** chama Supabase em nenhum momento da inicialização. O `AuthProvider` autentica apenas com os tokens OAuth do Qualiex (`access_token` + `id_token`). Não exige envs do Supabase. **Importante:** defina `VITE_APP_ENV="DEV"` no `.env` quando o app rodar contra o ambiente dev do Qualiex — sem essa variável, o failsafe assume `PROD`.
+
+```tsx
+// Módulo sem Supabase (ex.: Documentos)
+<CoreProviders backend="dotnet" appTranslations={{ 'pt-BR': pt }}>
+  <BrowserRouter>…</BrowserRouter>
+</CoreProviders>
+```
+
+### O que funciona sem Supabase em `backend="dotnet"`
+
+A lib mantém os seguintes recursos funcionando 100% sem nenhuma env var Supabase:
+
+- **Logos e favicon** (`assets`, `logoSrc`, `smallLogoSrc`): servidos a partir de bucket público fixo embutido na lib.
+- **Login automático em dev/preview**: `shouldUseDevTokens()` agora exige modo Supabase, então em modo dotnet o `ProtectedRoute` sempre vai para `loginProd()` (OAuth real), mesmo em `localhost`/Lovable preview.
+- **Logoff manual**: `TokenManager.clearAll()` preserva o flag `manual_logout`, garantindo que `logout()` realmente deslogue (sem auto-login no próximo render).
+- **`LegacyKeyBanner`**: oculto automaticamente em modo dotnet.
+
+### Features que continuam exigindo Supabase
+
+Mesmo com `backend="dotnet"`, se você importar qualquer um dos módulos abaixo eles vão falhar em runtime sem Supabase configurado:
+
+- `forlogic-core/sign`
+- `forlogic-core/audit-trail`
+- `forlogic-core/action-plans`
+- `forlogic-core/leadership`
+- `forlogic-core/places`
+- `EmailService` (do barrel principal)
+
+Esses módulos **foram removidos do barrel principal** (breaking change) — importe-os via subpath quando precisar. Use `isSupabaseConfigured()` para checar disponibilidade antes de chamar `getSupabaseClient()`.
 
 ## QueryClient default
 

package/docs/design-system/patterns/feature-flags.md

@@ -4,13 +4,14 @@
 
 | Variável | Descrição | Padrão |
 |----------|-----------|--------|
+| `VITE_APP_ENV` | Define o ambiente alvo da API/OAuth Qualiex. Valores aceitos: `"PROD"` ou `"DEV"`. Ausente ou qualquer outro valor = `PROD` (failsafe). Ver [seção abaixo](#vite_app_env). | `"PROD"` |
 | `VITE_SHOW_USER_PREFERENCES` | Exibe "Preferências" no menu do usuário (idioma, timezone, formato de data) | Não exibe |
 | `VITE_I18N_DEBUG_MODE` | Modo debug de i18n (mostra chaves ao invés de traduções) | `"false"` |
 | `VITE_IS_QUALIEX` | Usa logos Qualiex ao invés de Forlogic | `"false"` |
 | `VITE_SHOW_EDIT_PROFILE` | Exibe "Editar Perfil" no menu do usuário (foto e idioma) | Não exibe |
 | `VITE_WIKI_URL` | Exibe botão "Wiki" no header da aplicação. O valor é a URL que será aberta ao clicar | Não exibe |
 | `VITE_SHOW_ADMIN_REPORTS` | Exibe relatórios administrativos | `"false"` |
-| `VITE_SUPABASE_PK_OVERRIDE` | **Obrigatória.** Publishable key correta do Supabase. Ver [seção abaixo](#vite_supabase_pk_override). | — |
+| `VITE_SUPABASE_PK_OVERRIDE` | **Obrigatória (modo Supabase).** Publishable key correta do Supabase. Ver [seção abaixo](#vite_supabase_pk_override). | — |
 
 ## Uso
 
@@ -27,54 +28,85 @@ Variáveis Vite precisam do prefixo `VITE_` para serem expostas ao cliente.
 
 ---
 
+## Resolução unificada das envs Supabase (sem duplicação)
+
+A partir do `vite.config.ts`, o helper `resolveSupabaseEnv(mode)` (de `forlogic-core/vite`) lê **ambos os formatos** de variáveis e injeta um valor único via `define`:
+
+- Aceita `VITE_SUPABASE_*` (legado) **ou** `SUPABASE_*` (formato novo Lovable Cloud).
+- Prioridade: `VITE_SUPABASE_*` → `SUPABASE_*` → fallback derivado (`projectId` extraído da URL).
+- Injeta `import.meta.env.VITE_SUPABASE_URL` / `VITE_SUPABASE_PUBLISHABLE_KEY` / `VITE_SUPABASE_PROJECT_ID` / `VITE_SUPABASE_PK_OVERRIDE` no bundle.
+- O código do app/lib continua usando os nomes `VITE_*` — nada muda no consumo.
+
+**Resultado:** o `.env` precisa apenas de **uma** versão de cada variável. Recomendado o formato sem prefixo (Lovable Cloud auto-injeta):
+
+```env
+SUPABASE_URL="https://ccjfvpnndclajkleyqkc.supabase.co"
+SUPABASE_PUBLISHABLE_KEY="sb_publishable_w-TKU0hE4bjM_uOgt3fK1g_ewrXKJ8J"
+VITE_SUPABASE_PK_OVERRIDE="sb_publishable_w-TKU0hE4bjM_uOgt3fK1g_ewrXKJ8J"
+```
+
+Ver `mem://patterns/dynamic-supabase-config`.
+
+---
+
+## `VITE_APP_ENV`
+
+Define **explicitamente** o ambiente alvo da API Qualiex e do OAuth, sem depender de pistas indiretas (project ID do Supabase, hostname, etc).
+
+| Valor                          | Resultado                                                        |
+|--------------------------------|------------------------------------------------------------------|
+| `"PROD"`                       | API `common-v4-api.qualiex.com`, OAuth `login.qualiex.com`       |
+| `"DEV"`                        | API `common-v4-api-dev.qualiex.com`, OAuth `login-dev.qualiex.com` |
+| ausente / qualquer outro valor | **PROD (failsafe)** — esquecer a variável nunca aponta para dev |
+
+Apps em produção podem omitir a variável; apps que rodam contra dev **precisam** declarar `VITE_APP_ENV="DEV"` no `.env`. Não existe fallback derivado do Supabase.
+
+Helpers disponíveis em `forlogic-core`:
+
+- `getAppEnv(): 'PROD' | 'DEV'`
+- `isDevEnv(): boolean`
+- `getEnvironmentConfig(): EnvironmentConfig`
+
+---
+
 ## `VITE_SUPABASE_PK_OVERRIDE`
 
 ### Problema
 
-O Supabase desativou as legacy API keys (formato JWT `eyJhbGci...`). A integração Supabase do Lovable **sobrescreve automaticamente** `VITE_SUPABASE_PUBLISHABLE_KEY` no `.env` com a legacy anon key a cada prompt, causando `401 Unauthorized` em todas as requests.
+O Supabase desativou as legacy API keys (formato JWT `eyJhbGci...`). A integração Supabase do Lovable **sobrescreve automaticamente** `SUPABASE_PUBLISHABLE_KEY` (e a versão `VITE_*` quando presente) no `.env` com a legacy anon key a cada prompt, causando `401 Unauthorized` em todas as requests.
 
 ### Solução
 
 A lib `forlogic-core` implementa um mecanismo de override:
 
-1. Se `VITE_SUPABASE_PK_OVERRIDE` existir no `.env` → a lib usa essa key (ignora `VITE_SUPABASE_PUBLISHABLE_KEY`)
-2. Se não existir → usa `VITE_SUPABASE_PUBLISHABLE_KEY` normalmente
-3. Se a key ativa for uma JWT legada → exibe banner vermelho no preview (DEV) + erro no console
+1. Se `VITE_SUPABASE_PK_OVERRIDE` existir no `.env` → a lib usa essa key (ignora a publishable key resolvida)
+2. Se não existir → usa a key resolvida por `resolveSupabaseEnv()`
+3. Se a key ativa for uma JWT legada → exibe banner vermelho no preview (DEV, apenas `backend="supabase"`) + erro no console
 
-O Lovable **nunca toca** em `VITE_SUPABASE_PK_OVERRIDE` porque só auto-popula estas 3 variáveis:
-- `VITE_SUPABASE_URL`
-- `VITE_SUPABASE_PUBLISHABLE_KEY`
-- `VITE_SUPABASE_PROJECT_ID`
-
-### Configuração obrigatória
-
-**Todo projeto consumidor** que aponta para o Supabase `ccjfvpnndclajkleyqkc` deve adicionar no `.env`:
-
-```env
-VITE_SUPABASE_PK_OVERRIDE="sb_publishable_w-TKU0hE4bjM_uOgt3fK1g_ewrXKJ8J"
-```
+O Lovable **nunca toca** em `VITE_SUPABASE_PK_OVERRIDE` porque só auto-popula as envs Supabase padrão.
 
 ### Como funciona internamente
 
 ```text
 VITE_SUPABASE_PK_OVERRIDE existe?
-  ├─ SIM → usar ela (ignora VITE_SUPABASE_PUBLISHABLE_KEY)
+  ├─ SIM → usar ela
   │        console.info: "✅ Usando VITE_SUPABASE_PK_OVERRIDE..."
-  └─ NÃO → usar VITE_SUPABASE_PUBLISHABLE_KEY
+  └─ NÃO → usar a key resolvida por resolveSupabaseEnv()
        ├─ Formato sb_publishable_* → OK
        └─ Formato eyJ* (JWT legada) → ⛔ Erro
             ├─ console.error com diagnóstico completo
-            └─ Banner vermelho fixo no topo (apenas DEV)
+            └─ Banner vermelho fixo no topo (apenas DEV, modo supabase)
 ```
 
 ### Arquivos relevantes na lib
 
 | Arquivo | Responsabilidade |
 |---------|-----------------|
+| `lib/vite/resolve-supabase-env.ts` | `resolveSupabaseEnv()` — consolida envs Supabase no `define` do Vite |
 | `lib/supabase/legacyKeyGuard.ts` | `resolvePublishableKey()`, `isLegacyAnonKey()`, `warnIfLegacyKey()` |
 | `lib/supabase/SupabaseSingleton.ts` | Usa `resolvePublishableKey()` para a key do client |
 | `lib/supabase/publicClient.ts` | Idem para o client público |
-| `lib/providers/CoreProviders.tsx` | Renderiza `LegacyKeyBanner` em DEV |
+| `lib/providers/CoreProviders.tsx` | Renderiza `LegacyKeyBanner` em DEV (apenas `backend="supabase"`) |
 
 ### ⚠️ Nunca remova esta variável do `.env`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forlogic-core",
-  "version": "2.2.8",
+  "version": "2.3.1",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -22,6 +22,31 @@
       "types": "./dist/tailwind/index.d.ts",
       "import": "./dist/tailwind/index.esm.js",
       "require": "./dist/tailwind/index.js"
+    },
+    "./sign": {
+      "types": "./dist/sign/index.d.ts",
+      "import": "./dist/sign/index.esm.js",
+      "require": "./dist/sign/index.js"
+    },
+    "./audit-trail": {
+      "types": "./dist/audit-trail/index.d.ts",
+      "import": "./dist/audit-trail/index.esm.js",
+      "require": "./dist/audit-trail/index.js"
+    },
+    "./action-plans": {
+      "types": "./dist/action-plans/index.d.ts",
+      "import": "./dist/action-plans/index.esm.js",
+      "require": "./dist/action-plans/index.js"
+    },
+    "./leadership": {
+      "types": "./dist/leadership/index.d.ts",
+      "import": "./dist/leadership/index.esm.js",
+      "require": "./dist/leadership/index.js"
+    },
+    "./places": {
+      "types": "./dist/places/index.d.ts",
+      "import": "./dist/places/index.esm.js",
+      "require": "./dist/places/index.js"
     }
   },
   "files": [