forlogic-core 1.20.1 → 2.0.1

package/.note/memory/patterns/single-scroll-pattern.md

@@ -3,20 +3,38 @@ Updated: now
 
 O padrão de Scroll Único evita barras de rolagem duplicadas na aplicação.
 
-| Componente | Responsabilidade |
-|------------|------------------|
-| `AppLayout` | `overflow-hidden` - delega scroll para filhos |
-| `BodyContent` | `h-full overflow-y-auto` - gerencia scroll da página |
-| Custom | `h-full` + `ScrollArea` interno quando necessário |
+## Cadeia de layout do AppLayout
 
-**Regra**: Apenas UM nível da hierarquia deve ter scroll ativo.
+```text
+div.h-screen.overflow-hidden          ← preso ao viewport, sem scroll
+  ├─ header (sticky top-0)            ← cabeçalho fixo
+  └─ div.sidebar-container.flex-1.overflow-hidden
+      ├─ AppSidebar                   ← sidebar com scroll próprio
+      └─ main.flex-1.overflow-hidden
+          └─ div.flex-1.min-h-0.overflow-y-auto  ← SCROLL ATIVO aqui
+              └─ BodyContent (h-full)
+                  └─ ContentContainer (overflow-visible)  ← delega scroll para cima
+```
+
+| Componente | Classes | Responsabilidade |
+|------------|---------|------------------|
+| `AppLayout` raiz | `h-screen overflow-hidden` | Prende layout ao viewport |
+| Container de conteúdo | `flex-1 min-h-0 overflow-y-auto` | Gerencia scroll da página |
+| `BodyContent` | `h-full` | Container flexível |
+| `ContentContainer` | `overflow-visible` | Delega scroll para o pai |
+
+**Regra**: Apenas UM nível da hierarquia deve ter scroll ativo — o `div.overflow-y-auto` dentro do `<main>`.
 
 ```tsx
-// ❌ ERRADO - h-screen causa scroll duplicado
-<div className="h-screen overflow-auto">
+// ❌ ERRADO - min-h-screen permite crescer além do viewport
+<div className="min-h-screen overflow-auto">
 
-// ✅ CORRETO - h-full respeita container pai
-<BodyContent>
-  <ContentContainer>...</ContentContainer>
-</BodyContent>
+// ✅ CORRETO - h-screen trava no viewport
+<div className="h-screen overflow-hidden">
+  ...
+    <div className="flex-1 min-h-0 overflow-y-auto">
+      <BodyContent>...</BodyContent>
+    </div>
 ```
+
+**`min-h-0`** é essencial no container com `overflow-y-auto` — sem ele, flex items não encolhem abaixo do tamanho do conteúdo.

package/README.md

@@ -27,15 +27,6 @@ npm install forlogic-core
 
 **Nota**: O npm/yarn irá alertar automaticamente se alguma peer dependency estiver faltando ou com versão incompatível.
 
-### Sincronizar regras e convenções
-
-```bash
-npx lib-update
-```
-
-> Copia apenas `docs/KNOWLEDGE.md` (regras + mapa de módulos) e `.note/memory/rules/`.
-> Documentação de componentes é acessada via rota `/ds` ou cross-project.
-
 ### ⚠️ IMPORTANTE: Imports de i18n
 
 **Sempre** importe hooks de internacionalização do `forlogic-core`, nunca diretamente de `react-i18next`:
@@ -117,7 +108,6 @@ src/components/SplitButton.tsx    // Existe na lib (a partir de v1.12.2)
 | `/design_system`                  | Design System com todos os componentes documentados |
 | `forlogic-core/lib/exports/ui.ts` | Lista de exports de UI                              |
 | `forlogic-core/lib/index.ts`      | Index principal com todos os exports                |
-| `npx lib-update`                  | Sincroniza regras e KNOWLEDGE.md                    |
 
 ### ⚠️ Exceções (quando PODE criar localmente)
 
@@ -1040,40 +1030,4 @@ function MeuDialog({ open, onOpenChange }) {
 - "Adicione navegação para criar" (ação ≠ navegação)
 - "Crie um link para nova entidade" (link = navegação, não ação)
 
-## 🛠️ CLI: Sincronizar Regras e Convenções
-
-O `forlogic-core` disponibiliza um comando CLI para sincronizar regras e convenções arquiteturais para projetos consumidores.
-
-### Uso
-
-```bash
-# Via npx (recomendado)
-npx lib-update
-
-# Ou adicione ao package.json do seu projeto:
-{
-  "scripts": {
-    "lib-update": "lib-update"
-  }
-}
-
-# E execute:
-npm run lib-update
-```
-
-### O que é sincronizado
-
-| Arquivo/Diretório       | Descrição                                        |
-| ----------------------- | ------------------------------------------------ |
-| `docs/KNOWLEDGE.md`     | Regras críticas + mapa de módulos para IA/Lovable |
-| `.note/memory/rules/`   | Regras de schema, RLS, índices, .env             |
-
-### O que NÃO é sincronizado (leitura via cross-project → projeto **Admin**)
-
-| Recurso                     | Como acessar                                              |
-| --------------------------- | --------------------------------------------------------- |
-| Documentação de componentes | Rota `/ds` no projeto **Admin** ou cross-project          |
-| Props, exemplos, tipos      | Ler dos `*Doc.tsx` via cross-project → projeto **Admin**  |
-| Padrões de layout/CRUD      | `.note/memory/patterns/` via cross-project → **Admin**    |
-
 > 💡 A IA consegue ler o código-fonte do forlogic-core no projeto **Admin** via cross-project visibility.

package/dist/action-plans/components/ActionPlanAttachmentsTab.d.ts

@@ -0,0 +1,18 @@
+import type { ActionPlanAttachment } from '../types';
+interface ActionPlanAttachmentsTabProps {
+    attachments?: ActionPlanAttachment[];
+    onUpload?: (file: File) => Promise<any> | void;
+    onDelete?: (attachmentId: string) => Promise<any> | void;
+    onRename?: (attachmentId: string, newName: string) => Promise<any> | void;
+    onDownload?: (attachmentId: string) => Promise<any> | void;
+    onView?: (attachmentId: string) => Promise<any> | void;
+    disabled?: boolean;
+}
+/**
+ * Aba de Anexos do Plano de Ação
+ *
+ * Portado de FlcAttachmentsComponent (flc-attachments).
+ * Suporta upload, visualização, download, renomear e exclusão de arquivos.
+ */
+export declare function ActionPlanAttachmentsTab({ attachments, onUpload, onDelete, onRename, onDownload, onView, disabled, }: ActionPlanAttachmentsTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/components/ActionPlanCommentsTab.d.ts

@@ -0,0 +1,18 @@
+import type { ActionPlanComment } from '../types';
+interface ActionPlanCommentsTabProps {
+    comments?: ActionPlanComment[];
+    currentUserId?: string;
+    onAdd?: (text: string) => Promise<any> | void;
+    onEdit?: (comment: ActionPlanComment) => Promise<any> | void;
+    onDelete?: (commentId: string) => Promise<any> | void;
+    disabled?: boolean;
+    maxLength?: number;
+}
+/**
+ * Aba de Comentários do Plano de Ação
+ *
+ * Portado de FlcCommentsComponent (flc-comments).
+ * Suporta criação, edição e exclusão de comentários com avatar e timestamp.
+ */
+export declare function ActionPlanCommentsTab({ comments, currentUserId, onAdd, onEdit, onDelete, disabled, maxLength, }: ActionPlanCommentsTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/components/ActionPlanCostTab.d.ts

@@ -0,0 +1,10 @@
+import type { ActionPlanCost } from '../types';
+interface ActionPlanCostTabProps {
+    costs?: ActionPlanCost[];
+    onAdd?: (cost: Omit<ActionPlanCost, 'id'>) => void;
+    onEdit?: (cost: ActionPlanCost) => void;
+    onDelete?: (costId: string) => void;
+    disabled?: boolean;
+}
+export declare function ActionPlanCostTab({ costs, onAdd, onEdit, onDelete, disabled, }: ActionPlanCostTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/components/ActionPlanGeneralTab.d.ts

@@ -0,0 +1,18 @@
+import type { ActionPlan, ActionPlanPageProps } from '../types';
+interface ActionPlanGeneralTabProps {
+    formData: Partial<ActionPlan>;
+    updateField: (field: keyof ActionPlan, value: any) => void;
+    disabled?: boolean;
+    users?: ActionPlanPageProps['users'];
+    places?: ActionPlanPageProps['places'];
+    actionTypes?: ActionPlanPageProps['actionTypes'];
+    causes?: ActionPlanPageProps['causes'];
+    parentActions?: ActionPlanPageProps['parentActions'];
+    config?: ActionPlanPageProps['config'];
+}
+/**
+ * Aba Geral do formulário de Plano de Ação
+ * Contém todos os campos principais configuráveis
+ */
+export declare function ActionPlanGeneralTab({ formData, updateField, disabled, users, places, actionTypes, causes, parentActions, config, }: ActionPlanGeneralTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/components/ActionPlanHistoryTab.d.ts

@@ -0,0 +1,13 @@
+import type { ActionPlanHistoryItem } from '../types';
+interface ActionPlanHistoryTabProps {
+    history?: ActionPlanHistoryItem[];
+    isLoading?: boolean;
+}
+/**
+ * Aba de Histórico do Plano de Ação
+ *
+ * Portado de FlcHistoryComponent (flc-history).
+ * Exibe uma timeline de eventos do plano de ação.
+ */
+export declare function ActionPlanHistoryTab({ history, isLoading, }: ActionPlanHistoryTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/components/ActionPlanPage.d.ts

@@ -0,0 +1,25 @@
+import type { ActionPlanPageProps } from '../types';
+/**
+ * ActionPlanPage — Componente orquestrador de página full para planos de ação
+ *
+ * Renderiza o formulário completo com tabs: Geral, Progresso, Predecessores, Custos,
+ * Anexos, Comentários e Histórico.
+ *
+ * O componente é agnóstico de backend — recebe todos os dados e callbacks via props.
+ *
+ * @example
+ * ```tsx
+ * <ActionPlanPage
+ *   actionPlan={actionPlan}
+ *   config={{ enablePredecessors: true, enableCosts: true }}
+ *   users={users}
+ *   places={places}
+ *   progress={progress}
+ *   onSave={handleSave}
+ *   onCancel={() => navigate(-1)}
+ *   onChangeStatus={handleChangeStatus}
+ *   onReportProgress={handleReportProgress}
+ * />
+ * ```
+ */
+export declare function ActionPlanPage(props: ActionPlanPageProps): import("react/jsx-runtime").JSX.Element;

package/dist/action-plans/components/ActionPlanPredecessorsTab.d.ts

@@ -0,0 +1,10 @@
+import type { ActionPlanPredecessor, ActionPlanOption } from '../types';
+interface ActionPlanPredecessorsTabProps {
+    predecessors?: ActionPlanPredecessor[];
+    availablePredecessors?: ActionPlanOption[];
+    onAdd?: (predecessorId: string) => void;
+    onRemove?: (predecessorId: string) => void;
+    disabled?: boolean;
+}
+export declare function ActionPlanPredecessorsTab({ predecessors, availablePredecessors, onAdd, onRemove, disabled, }: ActionPlanPredecessorsTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/components/ActionPlanProgressDialog.d.ts

@@ -0,0 +1,13 @@
+import type { ActionPlanReport } from '../types';
+interface ActionPlanProgressDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    report: ActionPlanReport | null;
+    onSave: (report: ActionPlanReport) => void;
+    isSubmitting?: boolean;
+}
+/**
+ * Dialog para editar um relatório de progresso existente
+ */
+export declare function ActionPlanProgressDialog({ open, onOpenChange, report, onSave, isSubmitting, }: ActionPlanProgressDialogProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/components/ActionPlanProgressTab.d.ts

@@ -0,0 +1,5 @@
+import type { ActionPlanPageProps } from '../types';
+interface ActionPlanProgressTabProps extends ActionPlanPageProps {
+}
+export declare function ActionPlanProgressTab(props: ActionPlanProgressTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/components/ActionPlanStatusBadge.d.ts

@@ -0,0 +1,11 @@
+import { ETaskPlanStatus } from '../types';
+interface ActionPlanStatusBadgeProps {
+    status: ETaskPlanStatus;
+    labels?: Record<ETaskPlanStatus, string>;
+    className?: string;
+}
+/**
+ * Badge de status do plano de ação com cores dinâmicas
+ */
+export declare function ActionPlanStatusBadge({ status, labels, className }: ActionPlanStatusBadgeProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/constants.d.ts

@@ -0,0 +1,42 @@
+import { ETaskPlanStatus, ETaskPlanPriority } from './types';
+/**
+ * Cores de background por status
+ * Portado de FlcActionPlansService.getStatusColorById
+ */
+export declare const STATUS_COLORS: Record<ETaskPlanStatus, string>;
+/**
+ * Cores de texto por status
+ */
+export declare const STATUS_TEXT_COLORS: Record<ETaskPlanStatus, string>;
+/**
+ * Mapa de status para chave i18n / identificador
+ * Portado de FlcActionPlansService.getTaskPlanStatusMap
+ */
+export declare const STATUS_MAP: Record<ETaskPlanStatus, string>;
+/**
+ * Labels padrão para status (pt-BR)
+ */
+export declare const STATUS_LABELS: Record<ETaskPlanStatus, string>;
+/**
+ * Tipos de ação padrão
+ */
+export declare const DEFAULT_ACTION_TYPES: {
+    id: string;
+    label: string;
+}[];
+/**
+ * Prioridades padrão
+ */
+export declare const PRIORITIES: {
+    id: ETaskPlanPriority;
+    label: string;
+    color: string;
+}[];
+/**
+ * Status considerados "fechados" (não editáveis)
+ */
+export declare const CLOSED_STATUSES: ETaskPlanStatus[];
+/**
+ * Status que permitem reporte de progresso
+ */
+export declare const PROGRESS_ALLOWED_STATUSES: ETaskPlanStatus[];

package/dist/action-plans/hooks/useActionPlan.d.ts

@@ -0,0 +1,14 @@
+import type { ActionPlan, ActionPlanPageProps, ETaskPlanStatus } from '../types';
+export declare function useActionPlan(props: ActionPlanPageProps): {
+    formData: Partial<ActionPlan>;
+    isLoading: boolean;
+    isSaving: boolean;
+    activeTab: string;
+    isFormDisabled: boolean;
+    updateField: (field: keyof ActionPlan, value: any) => void;
+    setActiveTab: (tab: string) => void;
+    save: () => Promise<void>;
+    changeStatus: (newStatus: ETaskPlanStatus) => Promise<void>;
+    remove: () => Promise<void>;
+    cancel: () => void;
+};

package/dist/action-plans/hooks/useActionPlanProgress.d.ts

@@ -0,0 +1,15 @@
+import type { ActionPlanReport, ActionPlanPageProps } from '../types';
+export declare function useActionPlanProgress(props: ActionPlanPageProps): {
+    progress: import("..").ActionPlanProgress;
+    canReportProgress: boolean;
+    isSubmitting: boolean;
+    editingReport: ActionPlanReport;
+    setEditingReport: import("react").Dispatch<import("react").SetStateAction<ActionPlanReport>>;
+    reportProgress: (data: {
+        percentProgress: number;
+        timeProgress: string;
+        comments?: string;
+    }) => Promise<void>;
+    editProgress: (report: ActionPlanReport) => Promise<void>;
+    deleteProgress: (reportId: string) => Promise<void>;
+};

package/dist/action-plans/index.d.ts

@@ -0,0 +1,15 @@
+export { ActionPlanPage } from './components/ActionPlanPage';
+export { ActionPlanGeneralTab } from './components/ActionPlanGeneralTab';
+export { ActionPlanProgressTab } from './components/ActionPlanProgressTab';
+export { ActionPlanPredecessorsTab } from './components/ActionPlanPredecessorsTab';
+export { ActionPlanCostTab } from './components/ActionPlanCostTab';
+export { ActionPlanCommentsTab } from './components/ActionPlanCommentsTab';
+export { ActionPlanHistoryTab } from './components/ActionPlanHistoryTab';
+export { ActionPlanAttachmentsTab } from './components/ActionPlanAttachmentsTab';
+export { ActionPlanStatusBadge } from './components/ActionPlanStatusBadge';
+export { ActionPlanProgressDialog } from './components/ActionPlanProgressDialog';
+export { useActionPlan } from './hooks/useActionPlan';
+export { useActionPlanProgress } from './hooks/useActionPlanProgress';
+export * from './types';
+export * from './constants';
+export { formatTime, formatTimeProgress, getProgressColor } from './utils/formatTime';