refactor(core): centraliza hooks, providers e base compartilhada

lib/types/actions.ts

@@ -0,0 +1,13 @@
+/**
+ * Standard action result type
+ */
+export type ActionResult<TData = void> =
+	| { success: true; message: string; data?: TData }
+	| { success: false; error: string };
+
+/**
+ * Error result helper
+ */
+export function errorResult(error: string): ActionResult {
+	return { success: false, error };
+}

lib/types/calendario.ts

@@ -0,0 +1,62 @@
+import type {
+	LancamentoItem,
+	SelectOption,
+} from "@/components/lancamentos/types";
+
+export type CalendarEvent =
+	| {
+			id: string;
+			type: "lancamento";
+			date: string;
+			lancamento: LancamentoItem;
+	  }
+	| {
+			id: string;
+			type: "boleto";
+			date: string;
+			lancamento: LancamentoItem;
+	  }
+	| {
+			id: string;
+			type: "cartao";
+			date: string;
+			card: {
+				id: string;
+				name: string;
+				dueDay: string;
+				closingDay: string;
+				brand: string | null;
+				status: string;
+				logo: string | null;
+				totalDue: number | null;
+			};
+	  };
+
+export type CalendarPeriod = {
+	period: string;
+	monthName: string;
+	year: number;
+};
+
+export type CalendarDay = {
+	date: string;
+	label: string;
+	isCurrentMonth: boolean;
+	isToday: boolean;
+	events: CalendarEvent[];
+};
+
+export type CalendarFormOptions = {
+	pagadorOptions: SelectOption[];
+	splitPagadorOptions: SelectOption[];
+	defaultPagadorId: string | null;
+	contaOptions: SelectOption[];
+	cartaoOptions: SelectOption[];
+	categoriaOptions: SelectOption[];
+	estabelecimentos: string[];
+};
+
+export type CalendarData = {
+	events: CalendarEvent[];
+	formOptions: CalendarFormOptions;
+};

lib/types/index.ts

@@ -0,0 +1,3 @@
+export * from "./actions";
+export * from "./calendario";
+export * from "./relatorios";

lib/types/relatorios.ts

@@ -0,0 +1,52 @@
+/**
+ * Types for Category Report feature
+ */
+
+/**
+ * Monthly data for a specific category in a specific period
+ */
+export type MonthlyData = {
+	period: string; // Format: "YYYY-MM"
+	amount: number; // Total amount for this category in this period
+	previousAmount: number; // Amount from previous period (for comparison)
+	percentageChange: number | null; // Percentage change from previous period
+};
+
+/**
+ * Single category item in the report
+ */
+export type CategoryReportItem = {
+	categoryId: string;
+	name: string;
+	icon: string | null;
+	type: "despesa" | "receita";
+	monthlyData: Map<string, MonthlyData>; // Key: period (YYYY-MM)
+	total: number; // Total across all periods
+};
+
+/**
+ * Complete category report data structure
+ */
+export type CategoryReportData = {
+	categories: CategoryReportItem[]; // All categories with their data
+	periods: string[]; // All periods in the report (sorted chronologically)
+	totals: Map<string, number>; // Total per period across all categories
+	grandTotal: number; // Total of all categories and all periods
+};
+
+/**
+ * Filters for category report query
+ */
+export type CategoryReportFilters = {
+	startPeriod: string; // Format: "YYYY-MM"
+	endPeriod: string; // Format: "YYYY-MM"
+	categoryIds?: string[]; // Optional: filter by specific categories
+};
+
+/**
+ * Validation result for date range
+ */
+export type DateRangeValidation = {
+	isValid: boolean;
+	error?: string;
+};