refactor: faxina arquitetural — código morto, identificadores em inglês e estrutura padronizada

Refatoração estrutural sem mudanças funcionais. Saldo líquido: −428 linhas.

Removido:
- 14 funções/constantes mortas verificadas via grep no repo todo: validateCategoriaOwnership,
  getInstallmentAnticipationsAction, getAnticipationDetailsAction, formatDecimalForDb,
  currencyFormatterNoCents, optionalDecimalSchema, formatMonthLabel,
  getGoalProgressStatusColorClass, MONTH_PERIOD_PARAM, calculateRemainingInstallments,
  e 5 funções fetch* não usadas em inbox/queries.ts.
- 1 tipo morto (ImportRow) + 2 órfãos consequentes (InstallmentAnticipationWithRelations,
  GoalProgressStatus convertido em interno).
- ~30 export keywords desnecessários (símbolos usados apenas no próprio arquivo).
- Re-exports mortos em barrels: EstablishmentLogoPicker, CategoryReportSkeleton,
  WidgetSkeleton, toNameKey.
- Arquivo features/reports/types.ts (barrel inteiro era órfão).

Padronizado (PT-BR→EN em identificadores expostos):
- 4 constantes globais (LANCAMENTOS_* → TRANSACTIONS_*).
- 12 tipos/interfaces (Lancamento*/Pagador*/Estabelecimento* → equivalentes EN).
- 13 funções/components exportados (fetchPagador*, EstabelecimentoInput, PagadorInfoCard, etc.).
- 5 props cross-file (preLancamentosCount → inboxPendingCount, pagadorAvatarUrl → payerAvatarUrl, etc.).
- Mantidas em PT-BR conforme exceção do CLAUDE.md: variáveis locais (pagador, categoria,
  lancamento), accessor key pagadorName (persistida em preferências), strings de UI.

Reorganizado:
- transactions/: 14 helpers soltos na raiz movidos para lib/; barrel actions.ts reduzido
  de 76 linhas de wrappers para 14 linhas de re-exports puros; anticipation-actions.ts
  movido para actions/anticipation.ts.
- dashboard/: 8 helpers soltos consolidados em dashboard/lib/.
- reports/: 5 query files na raiz consolidados em reports/lib/.
- payers/: detail-actions.ts (21KB) e detail-queries.ts movidos para payers/lib/.
- shared/components/: 9 dos 16 componentes soltos agrupados em brand/, widgets/, feedback/.
- shared/lib/fetch-json.ts movido para shared/utils/fetch-json.ts.

Validação: pnpm exec tsc --noEmit (0 erros), biome check (0 issues), knip (sem unused).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

src/features/transactions/lib/category-helpers.ts

@@ -0,0 +1,73 @@
+import type { SelectOption } from "@/features/transactions/components/types";
+import { capitalize } from "@/shared/utils/string";
+
+/**
+ * Group label for category options
+ */
+type CategoryGroup = {
+	label: string;
+	options: SelectOption[];
+};
+
+/**
+ * Normalizes category group labels (Despesa -> Despesas, Receita -> Receitas)
+ */
+function normalizeCategoryGroupLabel(value: string): string {
+	const lower = value.toLowerCase();
+	if (lower === "despesa") {
+		return "Despesas";
+	}
+	if (lower === "receita") {
+		return "Receitas";
+	}
+	return capitalize(value);
+}
+
+/**
+ * Groups and sorts category options by their group property
+ * @param categoryOptions - Array of category select options
+ * @returns Array of grouped and sorted category options
+ */
+export function groupAndSortCategories(
+	categoryOptions: SelectOption[],
+): CategoryGroup[] {
+	// Group category options by their group property
+	const groups = categoryOptions.reduce<Record<string, SelectOption[]>>(
+		(acc, option) => {
+			const key = option.group ?? "Outros";
+			if (!acc[key]) {
+				acc[key] = [];
+			}
+			acc[key].push(option);
+			return acc;
+		},
+		{},
+	);
+
+	// Define preferred order (Despesa first, then Receita, then others)
+	const preferredOrder = ["Despesa", "Receita"];
+	const orderedKeys = [
+		...preferredOrder.filter((key) => groups[key]?.length),
+		...Object.keys(groups).filter((key) => !preferredOrder.includes(key)),
+	];
+
+	// Map to final structure with normalized labels and sorted options
+	return orderedKeys.map((key) => ({
+		label: normalizeCategoryGroupLabel(key),
+		options: groups[key]
+			.slice()
+			.sort((a, b) =>
+				a.label.localeCompare(b.label, "pt-BR", { sensitivity: "base" }),
+			),
+	}));
+}
+
+/**
+ * Filters secondary payer options to exclude the primary payer
+ */
+export function filterSecondaryPayerOptions(
+	allOptions: SelectOption[],
+	primaryPayerId?: string,
+): SelectOption[] {
+	return allOptions.filter((option) => option.value !== primaryPayerId);
+}