forlogic-core 2.0.0 → 2.0.2

package/dist/bin/bootstrap.js

@@ -1,40 +0,0 @@
-#!/usr/bin/env node
-import { execSync } from 'child_process';
-import * as path from 'path';
-import * as fs from 'fs';
-
-const skipUpdate = process.argv.includes("--skip-update");
-if (!skipUpdate) {
-  try {
-    console.log("\u{1F504} Verificando atualiza\xE7\xF5es do forlogic-core...");
-    execSync("npm install forlogic-core@latest", { stdio: "inherit" });
-    console.log("\u2705 forlogic-core atualizado com sucesso!\n");
-  } catch {
-    console.warn("\u26A0\uFE0F N\xE3o foi poss\xEDvel atualizar o forlogic-core automaticamente.");
-    console.warn("   Continuando com a vers\xE3o instalada...\n");
-  }
-} else {
-  console.log("\u23ED\uFE0F  --skip-update: pulando atualiza\xE7\xE3o do pacote.\n");
-}
-const syncScript = path.join(
-  process.cwd(),
-  "node_modules",
-  "forlogic-core",
-  "dist",
-  "bin",
-  "pull-docs.js"
-);
-if (!fs.existsSync(syncScript)) {
-  console.error(`\u274C Script de sync n\xE3o encontrado: ${syncScript}`);
-  console.error("   Verifique se forlogic-core est\xE1 instalado: npm install forlogic-core");
-  process.exit(1);
-}
-try {
-  execSync(`node "${syncScript}"`, {
-    stdio: "inherit",
-    cwd: process.cwd()
-  });
-} catch {
-  console.error("\u274C Falha ao executar o sync. Verifique os logs acima.");
-  process.exit(1);
-}

package/dist/bin/pull-docs.js

@@ -1,186 +0,0 @@
-#!/usr/bin/env node
-import * as fs from 'fs';
-import * as path from 'path';
-
-function resolvePackagePath() {
-  const directPath = path.join(process.cwd(), "node_modules", "forlogic-core");
-  if (fs.existsSync(path.join(directPath, "package.json"))) {
-    return directPath;
-  }
-  try {
-    const pkgJsonPath = require.resolve("forlogic-core/package.json", {
-      paths: [process.cwd()]
-    });
-    return path.dirname(pkgJsonPath);
-  } catch {
-    throw new Error(
-      "Pacote forlogic-core n\xE3o encontrado.\nExecute: npm install forlogic-core"
-    );
-  }
-}
-function copyFile(src, dest) {
-  if (!fs.existsSync(src)) {
-    return false;
-  }
-  const destDir = path.dirname(dest);
-  if (!fs.existsSync(destDir)) {
-    fs.mkdirSync(destDir, { recursive: true });
-  }
-  fs.copyFileSync(src, dest);
-  return true;
-}
-const README_MARKER = "<!-- managed by lib-update -->";
-function generateProjectReadme(readmePath, projectName, coreVersion) {
-  const template = `${README_MARKER}
-# ${projectName}
-
-> Projeto baseado em [forlogic-core](https://www.npmjs.com/package/forlogic-core) v${coreVersion}
-
-## Setup
-
-\`\`\`bash
-# Instalar depend\xEAncias
-npm install
-
-# Rodar em desenvolvimento
-npm run dev
-
-# Build de produ\xE7\xE3o
-npm run build
-\`\`\`
-
-## Scripts Dispon\xEDveis
-
-| Comando | Descri\xE7\xE3o |
-|---------|-----------|
-| \`npm run dev\` | Servidor de desenvolvimento (Vite) |
-| \`npm run build\` | Build de produ\xE7\xE3o |
-| \`npm run preview\` | Preview do build |
-| \`npx lib-update\` | Sincronizar regras e docs do forlogic-core |
-
-## Documenta\xE7\xE3o
-
-- \u{1F4D6} **Regras do projeto**: \`docs/KNOWLEDGE.md\`
-- \u{1F916} **Mem\xF3rias da IA**: \`.note/memory/\`
-- \u{1F3A8} **Design System**: Rota \`/ds\` no app (projeto Admin)
-- \u{1F4E6} **forlogic-core**: [README no npm](https://www.npmjs.com/package/forlogic-core)
-
-## Conven\xE7\xF5es
-
-- Schema Supabase: \`common\` (nunca \`public\`)
-- Soft delete obrigat\xF3rio (coluna \`deleted_at\`)
-- Sempre usar componentes do \`forlogic-core\` antes de criar novos
-- RLS policies: nunca \`FOR DELETE\`
-
----
-*Gerado automaticamente por \`lib-update\`. \xDAltima sync: forlogic-core v${coreVersion}*
-${README_MARKER}`;
-  if (fs.existsSync(readmePath)) {
-    const existing = fs.readFileSync(readmePath, "utf-8");
-    if (existing.includes(README_MARKER)) {
-      const markerRegex = new RegExp(
-        `${README_MARKER.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s\\S]*?${README_MARKER.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`,
-        "m"
-      );
-      const updated2 = existing.replace(markerRegex, template);
-      fs.writeFileSync(readmePath, updated2, "utf-8");
-      return true;
-    }
-    const updated = template + "\n\n" + existing;
-    fs.writeFileSync(readmePath, updated, "utf-8");
-    return true;
-  }
-  const destDir = path.dirname(readmePath);
-  if (!fs.existsSync(destDir)) {
-    fs.mkdirSync(destDir, { recursive: true });
-  }
-  fs.writeFileSync(readmePath, template, "utf-8");
-  return true;
-}
-async function syncDocs() {
-  console.log("\u{1F4E5} Sincronizando regras e conven\xE7\xF5es do forlogic-core...\n");
-  console.log("\u2139\uFE0F  Detalhes de componentes, props e tipos s\xE3o lidos via cross-project.\n");
-  let pkgPath;
-  try {
-    pkgPath = resolvePackagePath();
-  } catch (err) {
-    console.error(`\u274C ${err.message}`);
-    process.exit(1);
-  }
-  const pkgJson = JSON.parse(fs.readFileSync(path.join(pkgPath, "package.json"), "utf-8"));
-  console.log(`\u{1F4E6} forlogic-core v${pkgJson.version}
-`);
-  const projectRoot = process.cwd();
-  let successCount = 0;
-  let errorCount = 0;
-  const filesToCopy = [
-    { src: path.join(pkgPath, "docs", "KNOWLEDGE.md"), dest: path.join(projectRoot, "docs", "KNOWLEDGE.md"), label: "docs/KNOWLEDGE.md" }
-  ];
-  for (const file of filesToCopy) {
-    if (copyFile(file.src, file.dest)) {
-      const size = fs.statSync(file.dest).size;
-      console.log(`\u2705 ${file.label} (${(size / 1024).toFixed(2)} KB)`);
-      successCount++;
-    } else {
-      console.warn(`\u26A0\uFE0F ${file.label} \u2014 n\xE3o encontrado no pacote`);
-      errorCount++;
-    }
-  }
-  const obsoleteFiles = [
-    "docs/DESIGN_SYSTEM.md",
-    "docs/COMPONENTS.md",
-    "docs/PATTERNS.md",
-    ".note/memory/rules/supabase-schema-rule.md",
-    ".note/memory/rules/supabase-import-rule.md",
-    ".note/memory/rules/lib-first-rule.md",
-    ".note/memory/rules/no-auto-index-rule.md",
-    ".note/memory/rules/no-delete-policy-rule.md",
-    ".note/memory/rules/no-env-modification-rule.md",
-    ".note/memory/rules/rls-syntax-rule.md",
-    ".note/memory/rules/sql-naming-rule.md",
-    ".note/memory/rules/i18n-import-rule.md",
-    ".note/memory/patterns/deprecated-patterns.md",
-    ".note/memory/patterns/spa-navigation-pattern.md",
-    ".note/memory/architecture/documentation-strategy.md",
-    // Pastas reestruturadas (v2 — padronização 3 pastas)
-    ".note/memory/rules/doc-sync-rule.md",
-    ".note/memory/ui/components/combo-tree.md",
-    ".note/memory/ui/design-system/documentation-standard.md",
-    ".note/memory/documentation/consolidated-components-registry.md"
-  ];
-  let cleanedCount = 0;
-  for (const relPath of obsoleteFiles) {
-    const fullPath = path.join(projectRoot, relPath);
-    if (fs.existsSync(fullPath)) {
-      fs.unlinkSync(fullPath);
-      console.log(`\u{1F5D1}\uFE0F  ${relPath} (removido \u2014 obsoleto)`);
-      cleanedCount++;
-    }
-  }
-  if (cleanedCount > 0) {
-    successCount++;
-  }
-  const projectReadmePath = path.join(projectRoot, "README.md");
-  const projectName = path.basename(projectRoot);
-  const readmeGenerated = generateProjectReadme(projectReadmePath, projectName, pkgJson.version);
-  if (readmeGenerated) {
-    console.log(`\u2705 README.md (gerado/atualizado)`);
-    successCount++;
-  }
-  console.log("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
-  console.log(`\u{1F389} Sincroniza\xE7\xE3o conclu\xEDda!`);
-  console.log(`   \u2705 Sucesso: ${successCount}`);
-  if (errorCount > 0) {
-    console.log(`   \u26A0\uFE0F Avisos: ${errorCount}`);
-  }
-  console.log("");
-  if (successCount > 0) {
-    console.log("\u{1F4A1} Arquivos sincronizados:");
-    console.log("   docs/KNOWLEDGE.md \u2014 Regras cr\xEDticas + mapa de m\xF3dulos (fonte \xFAnica de verdade)");
-    console.log("   README.md \u2014 Template com setup, scripts e links");
-    console.log("");
-    console.log("\u{1F4D6} Documenta\xE7\xE3o de componentes, props e padr\xF5es s\xE3o lidos");
-    console.log("   diretamente do forlogic-core via cross-project.\n");
-  }
-}
-syncDocs();

package/dist/docs/KNOWLEDGE.md

@@ -1,109 +0,0 @@
-# KNOWLEDGE — Regras Críticas do Projeto
-
-> 🤖 **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. Schema do Projeto
-
-**SCHEMA = `common`**
-
-☝️ 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
-// ✅ usar o schema definido acima
-supabase.schema('common').from('tabela').select('*');
-// ❌ vai falhar (sem schema)
-supabase.from('tabela').select('*');
-```
-
----
-
-## 1. Regras Invioláveis
-
-| 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` |
-
----
-
-## 2. RLS — Resumo de Sintaxe
-
-- `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 SQL
-
-| Tipo | Padrão | Exemplo |
-|------|--------|---------|
-| FK | `id_<singular>` | `id_process` |
-| Boolean | `is_` / `has_` | `is_active` |
-| Timestamps | `created_at`, `updated_at`, `deleted_at` | — |
-| Tabelas | plural, snake_case | `processes` |
-
----
-
-## 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. Padrões Deprecated
-
-| ❌ Não usar | ✅ Usar |
-|------------|--------|
-| `BulkActionBar` separado | Dropdown no `CrudActionBar` |
-| `<MoreHorizontal>` genérico | `ActionButton` |
-| Paginação manual | `CrudPrimitivePagination` |
-| `StatusSelect` | `Combobox` |
-| `DeleteConfirmationDialog` | `Dialog` |
-| `Searchbar` | `Input` com ícone |
-
----
-
-## 6. Fontes de Contexto
-
-| Fonte | Caminho | Conteúdo |
-|-------|---------|----------|
-| Memory components | `.note/memory/components/` | Props, variantes e exemplos de componentes |
-| Memory patterns | `.note/memory/patterns/` | Layouts, setup, convenções, regras do projeto |
-| Memory features | `.note/memory/features/` | Contexto de features específicas do projeto |
-| Código-fonte da lib | Cross-project → projeto **Admin** (forlogic-core) | Props, tipos, implementação |
-| Design System (visual) | Rota `/ds` no app do projeto **Admin** | Documentação interativa |
-
-> ℹ️ `.note/memory/` usa 3 pastas padronizadas: `components/`, `patterns/`, `features/`. `KNOWLEDGE.md` é a fonte única de verdade para regras e convenções.