forlogic-core 2.1.2 → 2.1.4

package/dist/bin/bootstrap.js

@@ -0,0 +1,40 @@
+#!/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

@@ -0,0 +1,186 @@
+#!/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/components/ui/icon-picker.d.ts

@@ -1,11 +1,7 @@
 import React from 'react';
-export interface IconPickerIcon {
-    name: string;
-    filled: boolean;
-}
 interface IconPickerProps {
-    value?: IconPickerIcon | null;
-    onChange?: (icon: IconPickerIcon | null) => void;
+    value?: string | null;
+    onChange?: (icon: string | null) => void;
     label?: string;
     /** i18n: No icon label (default: "SEM ÍCONE") */
     noIconLabel?: string;

package/dist/docs/KNOWLEDGE.md

@@ -0,0 +1,109 @@
+# 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.