forlogic-core 2.2.8 → 2.3.1

package/dist/action-plans/utils/color.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Gera uma cor de fundo pastel a partir de uma cor hex semântica.
+ * Útil para StatusBadge e outros componentes que precisam de fundo suave.
+ *
+ * @param hex - Cor em formato hex (ex: '#2E7D5B')
+ * @param opacity - Opacidade do fundo (0-1, default 0.1)
+ * @returns String rgba (ex: 'rgba(46, 125, 91, 0.1)')
+ */
+export declare function generatePastelBg(hex: string, opacity?: number): string;
+/**
+ * Calcula a luminância relativa de uma cor hex (WCAG 2.0).
+ * Retorna um valor entre 0 (preto) e 1 (branco).
+ *
+ * @param hex - Cor em formato hex (ex: '#2E7D5B')
+ * @returns Luminância relativa (0-1)
+ */
+export declare function getLuminance(hex: string): number;
+/**
+ * Calcula a razão de contraste entre duas cores (WCAG 2.0).
+ * Razão >= 4.5 atende AA para texto normal; >= 7 atende AAA.
+ *
+ * @param hex1 - Primeira cor hex
+ * @param hex2 - Segunda cor hex
+ * @returns Razão de contraste (1-21)
+ */
+export declare function getContrastRatio(hex1: string, hex2: string): number;

package/dist/action-plans/utils/formatters/currencyFormatters.d.ts

@@ -0,0 +1 @@
+export declare const formatCurrency: (value: number | undefined | null, currency?: string, locale?: string) => string;

package/dist/action-plans/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/action-plans/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/action-plans/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/action-plans/utils/load-fonts.d.ts

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

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

@@ -0,0 +1,21 @@
+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.
+ *
+ * @example
+ * ActionPlanAttachmentsTab();
+ */
+export declare function ActionPlanAttachmentsTab({ attachments, onUpload, onDelete, onRename, onDownload, onView, disabled, }: ActionPlanAttachmentsTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,21 @@
+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.
+ *
+ * @example
+ * ActionPlanCommentsTab();
+ */
+export declare function ActionPlanCommentsTab({ comments, currentUserId, onAdd, onEdit, onDelete, disabled, maxLength, }: ActionPlanCommentsTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,15 @@
+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;
+}
+/**
+ * Função utilitária `ActionPlanCostTab`.
+ * @example
+ * ActionPlanCostTab();
+ */
+export declare function ActionPlanCostTab({ costs, onAdd, onEdit, onDelete, disabled, }: ActionPlanCostTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,21 @@
+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
+ *
+ * @example
+ * ActionPlanGeneralTab();
+ */
+export declare function ActionPlanGeneralTab({ formData, updateField, disabled, users, places, actionTypes, causes, parentActions, config, }: ActionPlanGeneralTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,16 @@
+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.
+ *
+ * @example
+ * ActionPlanHistoryTab();
+ */
+export declare function ActionPlanHistoryTab({ history, isLoading, }: ActionPlanHistoryTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/audit-trail/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/audit-trail/action-plans/components/ActionPlanPredecessorsTab.d.ts

@@ -0,0 +1,15 @@
+import type { ActionPlanPredecessor, ActionPlanOption } from '../types';
+interface ActionPlanPredecessorsTabProps {
+    predecessors?: ActionPlanPredecessor[];
+    availablePredecessors?: ActionPlanOption[];
+    onAdd?: (predecessorId: string) => void;
+    onRemove?: (predecessorId: string) => void;
+    disabled?: boolean;
+}
+/**
+ * Função utilitária `ActionPlanPredecessorsTab`.
+ * @example
+ * ActionPlanPredecessorsTab();
+ */
+export declare function ActionPlanPredecessorsTab({ predecessors, availablePredecessors, onAdd, onRemove, disabled, }: ActionPlanPredecessorsTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,16 @@
+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
+ *
+ * @example
+ * ActionPlanProgressDialog();
+ */
+export declare function ActionPlanProgressDialog({ open, onOpenChange, report, onSave, isSubmitting, }: ActionPlanProgressDialogProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,10 @@
+import type { ActionPlanPageProps } from '../types';
+interface ActionPlanProgressTabProps extends ActionPlanPageProps {
+}
+/**
+ * Função utilitária `ActionPlanProgressTab`.
+ * @example
+ * ActionPlanProgressTab();
+ */
+export declare function ActionPlanProgressTab(props: ActionPlanProgressTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,18 @@
+import { ETaskPlanStatus } from '../types';
+interface ActionPlanStatusBadgeProps {
+    status: ETaskPlanStatus;
+    labels?: Record<ETaskPlanStatus, string>;
+    className?: string;
+    size?: 'sm' | 'md' | 'lg';
+    showIcon?: boolean;
+    variant?: 'filled' | 'outline' | 'ghost';
+}
+/**
+ * Badge de status do plano de ação com cores dinâmicas.
+ * Wrapper do StatusBadge genérico com mapeamento de ETaskPlanStatus.
+ *
+ * @example
+ * ActionPlanStatusBadge();
+ */
+export declare function ActionPlanStatusBadge({ status, labels, className, size, showIcon, variant, }: ActionPlanStatusBadgeProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,86 @@
+import { ETaskPlanStatus, ETaskPlanPriority } from './types';
+/**
+ * Cores de background por status
+ * Portado de FlcActionPlansService.getStatusColorById
+ *
+ * @example
+ * <STATUS_COLORS />
+ */
+export declare const STATUS_COLORS: Record<ETaskPlanStatus, string>;
+/**
+ * Cores de texto por status
+ *
+ * @example
+ * <STATUS_TEXT_COLORS />
+ */
+export declare const STATUS_TEXT_COLORS: Record<ETaskPlanStatus, string>;
+/**
+ * Mapa de status para chave i18n / identificador
+ * Portado de FlcActionPlansService.getTaskPlanStatusMap
+ *
+ * @example
+ * <STATUS_MAP />
+ */
+export declare const STATUS_MAP: Record<ETaskPlanStatus, string>;
+/**
+ * Labels para status (i18n)
+ * Retorna um objeto traduzido — deve ser chamado em tempo de renderização.
+ */
+export declare function getStatusLabels(): Record<ETaskPlanStatus, string>;
+/**
+ * @deprecated Use getStatusLabels() instead
+ *
+ * @example
+ * <STATUS_LABELS />
+ */
+export declare const STATUS_LABELS: Record<ETaskPlanStatus, string>;
+/**
+ * Tipos de ação (i18n)
+ */
+export declare function getActionTypes(): {
+    id: string;
+    label: string;
+}[];
+/**
+ * @deprecated Use getActionTypes() instead
+ *
+ * @example
+ * <DEFAULT_ACTION_TYPES />
+ */
+export declare const DEFAULT_ACTION_TYPES: {
+    id: string;
+    label: string;
+}[];
+/**
+ * Prioridades (i18n)
+ */
+export declare function getPriorities(): {
+    id: ETaskPlanPriority;
+    label: string;
+    color: string;
+}[];
+/**
+ * @deprecated Use getPriorities() instead
+ *
+ * @example
+ * <PRIORITIES />
+ */
+export declare const PRIORITIES: {
+    id: ETaskPlanPriority;
+    label: string;
+    color: string;
+}[];
+/**
+ * Status considerados "fechados" (não editáveis)
+ *
+ * @example
+ * <CLOSED_STATUSES />
+ */
+export declare const CLOSED_STATUSES: ETaskPlanStatus[];
+/**
+ * Status que permitem reporte de progresso
+ *
+ * @example
+ * <PROGRESS_ALLOWED_STATUSES />
+ */
+export declare const PROGRESS_ALLOWED_STATUSES: ETaskPlanStatus[];

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

@@ -0,0 +1,19 @@
+import type { ActionPlan, ActionPlanPageProps, ETaskPlanStatus } from '../types';
+/**
+ * Função utilitária `useActionPlan`.
+ * @example
+ * useActionPlan();
+ */
+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/audit-trail/action-plans/hooks/useActionPlanProgress.d.ts

@@ -0,0 +1,20 @@
+import type { ActionPlanReport, ActionPlanPageProps } from '../types';
+/**
+ * Função utilitária `useActionPlanProgress`.
+ * @example
+ * useActionPlanProgress();
+ */
+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/audit-trail/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';