@jjlmoya/utils-finance 1.23.0 → 1.24.0

package/src/tool/revolvingCardCalculator/revolving-card-calculator.css

@@ -0,0 +1,564 @@
+:root {
+  --rc-bg-card: #fff;
+  --rc-border-card: #e5e7eb;
+  --rc-text-primary: #1f2937;
+  --rc-text-secondary: #6b7280;
+  --rc-bg-input: #fff;
+  --rc-border-input: #d1d5db;
+  --rc-text-input: #1f2937;
+  --rc-focus-border: #2563eb;
+  --rc-focus-ring: rgba(37, 99, 235, 0.15);
+  --rc-unit-color: #2563eb;
+  --rc-btn-primary: #2563eb;
+  --rc-btn-primary-hover: #1d4ed8;
+  --rc-btn-text: #fff;
+  --rc-btn-secondary: #f3f4f6;
+  --rc-btn-secondary-hover: #e5e7eb;
+  --rc-btn-secondary-text: #374151;
+  --rc-bg-success: #f0fdf4;
+  --rc-border-success: #bbf7d0;
+  --rc-text-success: #15803d;
+  --rc-bg-warning: #fffbeb;
+  --rc-border-warning: #fde68a;
+  --rc-text-warning: #b45309;
+  --rc-bg-error: #fef2f2;
+  --rc-border-error: #fca5a5;
+  --rc-text-error: #b91c1c;
+  --rc-bg-summary: #f9fafb;
+  --rc-border-summary: #e5e7eb;
+  --rc-gradient-start: #eff6ff;
+  --rc-gradient-end: #dbeafe;
+  --rc-gradient-text: #1e3a8a;
+  --rc-gradient-border: #bfdbfe;
+  --rc-chart-principal: #3b82f6;
+  --rc-chart-interest: #ef4444;
+}
+
+.theme-dark, [data-theme='dark'] {
+  --rc-bg-card: #1f2937;
+  --rc-border-card: #374151;
+  --rc-text-primary: #f3f4f6;
+  --rc-text-secondary: #9ca3af;
+  --rc-bg-input: #111827;
+  --rc-border-input: #4b5563;
+  --rc-text-input: #f3f4f6;
+  --rc-focus-border: #60a5fa;
+  --rc-focus-ring: rgba(96, 165, 250, 0.2);
+  --rc-unit-color: #60a5fa;
+  --rc-btn-primary: #3b82f6;
+  --rc-btn-primary-hover: #60a5fa;
+  --rc-btn-text: #111827;
+  --rc-btn-secondary: #374151;
+  --rc-btn-secondary-hover: #4b5563;
+  --rc-btn-secondary-text: #f3f4f6;
+  --rc-bg-success: #064e3b;
+  --rc-border-success: #047857;
+  --rc-text-success: #a7f3d0;
+  --rc-bg-warning: #78350f;
+  --rc-border-warning: #b45309;
+  --rc-text-warning: #fde68a;
+  --rc-bg-error: #7f1d1d;
+  --rc-border-error: #b91c1c;
+  --rc-text-error: #fca5a5;
+  --rc-bg-summary: #111827;
+  --rc-border-summary: #374151;
+  --rc-gradient-start: #1e3a8a;
+  --rc-gradient-end: #1e40af;
+  --rc-gradient-text: #93c5fd;
+  --rc-gradient-border: #3b82f6;
+  --rc-chart-principal: #3b82f6;
+  --rc-chart-interest: #ef4444;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --rc-bg-card: #1f2937;
+    --rc-border-card: #374151;
+    --rc-text-primary: #f3f4f6;
+    --rc-text-secondary: #9ca3af;
+    --rc-bg-input: #111827;
+    --rc-border-input: #4b5563;
+    --rc-text-input: #f3f4f6;
+    --rc-focus-border: #60a5fa;
+    --rc-focus-ring: rgba(96, 165, 250, 0.2);
+    --rc-unit-color: #60a5fa;
+    --rc-btn-primary: #3b82f6;
+    --rc-btn-primary-hover: #60a5fa;
+    --rc-btn-text: #111827;
+    --rc-btn-secondary: #374151;
+    --rc-btn-secondary-hover: #4b5563;
+    --rc-btn-secondary-text: #f3f4f6;
+    --rc-bg-success: #064e3b;
+    --rc-border-success: #047857;
+    --rc-text-success: #a7f3d0;
+    --rc-bg-warning: #78350f;
+    --rc-border-warning: #b45309;
+    --rc-text-warning: #fde68a;
+    --rc-bg-error: #7f1d1d;
+    --rc-border-error: #b91c1c;
+    --rc-text-error: #fca5a5;
+    --rc-bg-summary: #111827;
+    --rc-border-summary: #374151;
+    --rc-gradient-start: #1e3a8a;
+    --rc-gradient-end: #1e40af;
+    --rc-gradient-text: #93c5fd;
+    --rc-gradient-border: #3b82f6;
+    --rc-chart-principal: #3b82f6;
+    --rc-chart-interest: #ef4444;
+  }
+}
+
+.rev-container {
+  display: flex;
+  justify-content: center;
+  width: 100%;
+  padding: 1.5rem 1rem;
+}
+
+.rev-card {
+  background: var(--rc-bg-card);
+  border: 1px solid var(--rc-border-card);
+  border-radius: 16px;
+  padding: 2rem;
+  width: 100%;
+  max-width: 800px;
+  color: var(--rc-text-primary);
+  box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.05), 0 2px 4px -1px rgba(0, 0, 0, 0.03);
+}
+
+.rev-inputs-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+  gap: 1.25rem;
+  margin-bottom: 2rem;
+}
+
+.rev-input-group {
+  display: flex;
+  flex-direction: column;
+}
+
+.rev-input-group label {
+  font-weight: 600;
+  margin-bottom: 0.5rem;
+  font-size: 0.85rem;
+  color: var(--rc-text-primary);
+}
+
+.rev-input-wrapper,
+.rev-select-wrapper {
+  position: relative;
+  display: flex;
+  align-items: center;
+}
+
+.rev-input-wrapper input,
+.rev-select-wrapper select {
+  width: 100%;
+  padding: 0.75rem 1rem;
+  border: 1px solid var(--rc-border-input);
+  border-radius: 8px;
+  font-size: 0.95rem;
+  background: var(--rc-bg-input);
+  color: var(--rc-text-input);
+  outline: none;
+  transition: all 0.15s ease;
+}
+
+.theme-dark .rev-input-wrapper input,
+.theme-dark .rev-select-wrapper select,
+[data-theme='dark'] .rev-input-wrapper input,
+[data-theme='dark'] .rev-select-wrapper select {
+  color-scheme: dark;
+}
+
+.rev-input-wrapper input:focus,
+.rev-select-wrapper select:focus {
+  border-color: var(--rc-focus-border);
+  box-shadow: 0 0 0 3px var(--rc-focus-ring);
+}
+
+.rev-select-wrapper select {
+  padding-right: 2.5rem;
+  appearance: none;
+  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='8' viewBox='0 0 12 8'%3E%3Cpath fill='%236b7280' d='M1 1l5 5 5-5'/%3E%3C/svg%3E");
+  background-repeat: no-repeat;
+  background-position: right 0.75rem center;
+  background-size: 12px 8px;
+}
+
+.rev-input-unit {
+  position: absolute;
+  right: 1rem;
+  font-weight: 600;
+  color: var(--rc-unit-color);
+  font-size: 0.9rem;
+  pointer-events: none;
+}
+
+.rev-usury-card {
+  background: var(--rc-bg-summary);
+  border: 1px solid var(--rc-border-summary);
+  border-radius: 12px;
+  padding: 1.5rem;
+  margin-bottom: 2rem;
+}
+
+.rev-usury-title {
+  font-size: 1.1rem;
+  font-weight: 700;
+  margin-top: 0;
+  margin-bottom: 1rem;
+}
+
+.rev-usury-status-container {
+  display: flex;
+  align-items: flex-start;
+  gap: 1rem;
+  padding: 1rem;
+  border-radius: 8px;
+  border: 1px solid transparent;
+  margin-bottom: 1.25rem;
+  transition: all 0.2s ease;
+}
+
+.rev-usury-status-container.safe {
+  background: var(--rc-bg-success);
+  border-color: var(--rc-border-success);
+  color: var(--rc-text-success);
+}
+
+.rev-usury-status-container.warning {
+  background: var(--rc-bg-warning);
+  border-color: var(--rc-border-warning);
+  color: var(--rc-text-warning);
+}
+
+.rev-usury-status-container.usurious {
+  background: var(--rc-bg-error);
+  border-color: var(--rc-border-error);
+  color: var(--rc-text-error);
+}
+
+.rev-status-icon-box {
+  width: 24px;
+  height: 24px;
+  flex-shrink: 0;
+}
+
+.rev-status-text {
+  font-size: 1rem;
+  font-weight: 700;
+  margin: 0 0 0.25rem;
+}
+
+.rev-status-description {
+  font-size: 0.85rem;
+  margin: 0;
+  line-height: 1.4;
+  color: inherit;
+}
+
+.rev-usury-stats {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 1rem;
+}
+
+.rev-usury-stat-item {
+  display: flex;
+  flex-direction: column;
+  background: var(--rc-bg-card);
+  border: 1px solid var(--rc-border-card);
+  padding: 0.75rem 1rem;
+  border-radius: 8px;
+}
+
+.rev-usury-stat-label {
+  font-size: 0.75rem;
+  color: var(--rc-text-secondary);
+  margin-bottom: 0.25rem;
+  font-weight: 500;
+}
+
+.rev-usury-stat-value {
+  font-size: 1.2rem;
+  font-weight: 700;
+  color: var(--rc-text-primary);
+}
+
+.rev-summary-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
+  gap: 1rem;
+  margin-bottom: 1.5rem;
+}
+
+.rev-summary-card {
+  background: var(--rc-bg-summary);
+  border: 1px solid var(--rc-border-summary);
+  border-radius: 12px;
+  padding: 1.25rem;
+  text-align: center;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  min-height: 100px;
+}
+
+.rev-summary-card.primary-gradient {
+  background: linear-gradient(135deg, var(--rc-gradient-start), var(--rc-gradient-end));
+  border-color: var(--rc-gradient-border);
+  color: var(--rc-gradient-text);
+}
+
+.rev-summary-card.primary-gradient .rev-summary-label {
+  color: var(--rc-gradient-text);
+  opacity: 0.85;
+}
+
+.rev-summary-card.primary-gradient .rev-summary-value {
+  color: var(--rc-gradient-text);
+}
+
+.rev-summary-label {
+  font-size: 0.8rem;
+  font-weight: 600;
+  color: var(--rc-text-secondary);
+  margin-bottom: 0.5rem;
+}
+
+.rev-summary-value {
+  font-size: 1.75rem;
+  font-weight: 800;
+  color: var(--rc-text-primary);
+}
+
+.rev-summary-subvalue {
+  font-size: 0.85rem;
+  color: var(--rc-text-secondary);
+  margin-top: 0.25rem;
+}
+
+.rev-alert-box {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  padding: 1rem;
+  border-radius: 8px;
+  margin-bottom: 1.5rem;
+  border: 1px solid transparent;
+}
+
+.rev-alert-box.error {
+  background: var(--rc-bg-error);
+  border-color: var(--rc-border-error);
+  color: var(--rc-text-error);
+}
+
+.rev-alert-content {
+  font-size: 0.85rem;
+  font-weight: 600;
+  line-height: 1.4;
+}
+
+.rev-chart-container {
+  background: var(--rc-bg-summary);
+  border: 1px solid var(--rc-border-summary);
+  border-radius: 12px;
+  padding: 1.5rem;
+  margin-bottom: 2rem;
+}
+
+.rev-chart-header {
+  margin-bottom: 1.25rem;
+}
+
+.rev-chart-title {
+  font-size: 1rem;
+  font-weight: 700;
+  margin: 0;
+}
+
+.rev-breakdown-bar-wrapper {
+  margin-bottom: 1.5rem;
+}
+
+.rev-bar-labels {
+  display: flex;
+  justify-content: space-between;
+  font-size: 0.75rem;
+  font-weight: 600;
+  color: var(--rc-text-secondary);
+  margin-bottom: 0.5rem;
+}
+
+.rev-breakdown-bar {
+  display: flex;
+  height: 24px;
+  border-radius: 12px;
+  overflow: hidden;
+  background: var(--rc-border-card);
+}
+
+.rev-bar-segment {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 100%;
+  color: #fff;
+  font-weight: 700;
+  font-size: 0.75rem;
+  transition: width 0.4s ease;
+}
+
+.rev-bar-segment.principal {
+  background: var(--rc-chart-principal);
+}
+
+.rev-bar-segment.interest {
+  background: var(--rc-chart-interest);
+}
+
+.rev-timeline-visual {
+  position: relative;
+  height: 48px;
+  display: flex;
+  align-items: center;
+  background: var(--rc-bg-card);
+  border: 1px solid var(--rc-border-card);
+  border-radius: 8px;
+  overflow: hidden;
+  padding: 0 1rem;
+}
+
+.rev-timeline-track {
+  display: flex;
+  width: 100%;
+  height: 12px;
+  background: #e5e7eb;
+  border-radius: 6px;
+  overflow: hidden;
+  position: relative;
+}
+
+.rev-timeline-fill {
+  height: 100%;
+  background: var(--rc-chart-principal);
+  transition: width 0.4s ease;
+}
+
+.rev-table-actions {
+  display: flex;
+  justify-content: center;
+  margin-bottom: 1.5rem;
+}
+
+.rev-table-container {
+  overflow-x: auto;
+  border: 1px solid var(--rc-border-card);
+  border-radius: 8px;
+  max-height: 350px;
+  overflow-y: auto;
+}
+
+.rev-table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 0.85rem;
+  text-align: right;
+}
+
+.rev-table th {
+  position: sticky;
+  top: 0;
+  background: var(--rc-bg-summary);
+  color: var(--rc-text-primary);
+  font-weight: 700;
+  padding: 0.75rem 1rem;
+  border-bottom: 2px solid var(--rc-border-card);
+}
+
+.rev-table td {
+  padding: 0.75rem 1rem;
+  border-bottom: 1px solid var(--rc-border-card);
+  color: var(--rc-text-secondary);
+}
+
+.rev-table tbody tr:hover td {
+  background: var(--rc-bg-summary);
+  color: var(--rc-text-primary);
+}
+
+.rev-table th:first-child,
+.rev-table td:first-child {
+  text-align: center;
+}
+
+.action-row {
+  display: flex;
+  gap: 1rem;
+  margin-top: 1.5rem;
+}
+
+.rev-btn-primary {
+  flex: 1;
+  padding: 0.75rem 1.5rem;
+  background: var(--rc-btn-primary);
+  color: var(--rc-btn-text);
+  border: none;
+  border-radius: 8px;
+  font-weight: 600;
+  cursor: pointer;
+  transition: all 0.2s;
+}
+
+.rev-btn-primary:hover {
+  background: var(--rc-btn-primary-hover);
+  transform: translateY(-1px);
+}
+
+.rev-btn-secondary {
+  padding: 0.6rem 1.25rem;
+  background: var(--rc-btn-secondary);
+  color: var(--rc-btn-secondary-text);
+  border: 1px solid var(--rc-border-card);
+  border-radius: 8px;
+  font-weight: 600;
+  cursor: pointer;
+  transition: all 0.2s;
+}
+
+.rev-btn-secondary:hover {
+  background: var(--rc-btn-secondary-hover);
+}
+
+.fade-in {
+  animation: rev-fade-in 0.4s ease-out;
+}
+
+@keyframes rev-fade-in {
+  from {
+    opacity: 0;
+    transform: translateY(10px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+@media (max-width: 640px) {
+  .rev-inputs-grid {
+    grid-template-columns: 1fr;
+  }
+  .rev-summary-grid {
+    grid-template-columns: 1fr;
+  }
+  .rev-usury-stats {
+    grid-template-columns: 1fr;
+  }
+  .rev-card {
+    padding: 1.25rem;
+  }
+}

package/src/tool/revolvingCardCalculator/seo.astro

@@ -0,0 +1,15 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { revolvingCardCalculator } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await revolvingCardCalculator.i18n[locale]?.();
+if (!content) return null;
+---
+
+{content.seo?.length > 0 && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/revolvingCardCalculator/types.ts

@@ -0,0 +1,54 @@
+export type RevolvingMarket =
+  | 'es'
+  | 'us'
+  | 'uk'
+  | 'eu'
+  | 'jp'
+  | 'kr'
+  | 'cn'
+  | 'br'
+  | 'mx'
+  | 'pl'
+  | 'id'
+  | 'tr'
+  | 'ru'
+  | 'se'
+  | 'au'
+  | 'ca'
+  | 'custom';
+
+export interface RevolvingInputs {
+  balance: number;
+  creditLimit: number;
+  apr: number;
+  paymentType: 'fixed' | 'percentage';
+  paymentValue: number;
+  minPaymentValue: number;
+  market: RevolvingMarket;
+  customThreshold?: number;
+}
+
+export interface AmortizationRow {
+  month: number;
+  initialBalance: number;
+  interestPaid: number;
+  principalPaid: number;
+  payment: number;
+  finalBalance: number;
+}
+
+export interface AmortizationResult {
+  schedule: AmortizationRow[];
+  totalInterest: number;
+  totalPaid: number;
+  monthsToPay: number;
+  isInfinite: boolean;
+}
+
+export interface UsuryAnalysis {
+  status: 'safe' | 'warning' | 'usurious';
+  marketName: string;
+  referenceRate: number;
+  thresholdRate: number;
+  details: string;
+}

package/src/tool/revolvingCardCalculator/ui.ts

@@ -0,0 +1,58 @@
+export interface RevolvingCardCalculatorUI extends Record<string, unknown> {
+  title: string;
+  balanceLabel: string;
+  creditLimitLabel: string;
+  aprLabel: string;
+  paymentTypeLabel: string;
+  paymentTypeFixed: string;
+  paymentTypePercentage: string;
+  paymentValueLabel: string;
+  minPaymentValueLabel: string;
+  currencyLabel: string;
+  marketLabel: string;
+  marketES: string;
+  marketUS: string;
+  marketUK: string;
+  marketEU: string;
+  marketJP: string;
+  marketKR: string;
+  marketCN: string;
+  marketBR: string;
+  marketMX: string;
+  marketPL: string;
+  marketID: string;
+  marketTR: string;
+  marketRU: string;
+  marketSE: string;
+  marketAU: string;
+  marketCA: string;
+  marketCustom: string;
+  customThresholdLabel: string;
+
+  resultsTitle: string;
+  totalInterestLabel: string;
+  totalPaidLabel: string;
+  monthsToPayLabel: string;
+  infiniteDebtWarning: string;
+  payoffYearsLabel: string;
+
+  usuryTitle: string;
+  usurySafeStatus: string;
+  usuryWarningStatus: string;
+  usuryUsuriousStatus: string;
+  usuryReferenceLabel: string;
+  usuryThresholdLabel: string;
+
+  tableTitle: string;
+  tableHeaderMonth: string;
+  tableHeaderInitial: string;
+  tableHeaderInterest: string;
+  tableHeaderPrincipal: string;
+  tableHeaderPayment: string;
+  tableHeaderFinal: string;
+
+  copyTooltip: string;
+  copiedLabel: string;
+  currencySymbol: string;
+  percentSymbol: string;
+}

package/src/tools.ts

@@ -14,7 +14,8 @@ import { COURT_FEE_CALCULATOR_TOOL } from './tool/courtFeeCalculator';
 import { LEGAL_INTEREST_RATE_TOOL } from './tool/legalInterestRate';
 import { FIRE_CALCULATOR_TOOL } from './tool/fireCalculator';
 import { DEBT_SNOWBALL_TOOL } from './tool/debtSnowball';
+import { REVOLVING_CARD_CALCULATOR_TOOL } from './tool/revolvingCardCalculator';
 
-export const ALL_TOOLS: ToolDefinition[] = [COMPOUND_INTEREST_TOOL, FINANCIAL_FREEDOM_TOOL, PROFITABILITY_TOOL, MORTGAGE_TOOL, INFLATION_TOOL, PERCENTAGE_CALCULATOR_TOOL, LATE_INTEREST_TOOL, IBAN_BIC_SWIFT_TOOL, RENT_INCREASE_TOOL, LOTTERY_OPTIMIZER_TOOL, COURT_FEE_CALCULATOR_TOOL, LEGAL_INTEREST_RATE_TOOL, FIRE_CALCULATOR_TOOL, DEBT_SNOWBALL_TOOL];
+export const ALL_TOOLS: ToolDefinition[] = [COMPOUND_INTEREST_TOOL, FINANCIAL_FREEDOM_TOOL, PROFITABILITY_TOOL, MORTGAGE_TOOL, INFLATION_TOOL, PERCENTAGE_CALCULATOR_TOOL, LATE_INTEREST_TOOL, IBAN_BIC_SWIFT_TOOL, RENT_INCREASE_TOOL, LOTTERY_OPTIMIZER_TOOL, COURT_FEE_CALCULATOR_TOOL, LEGAL_INTEREST_RATE_TOOL, FIRE_CALCULATOR_TOOL, DEBT_SNOWBALL_TOOL, REVOLVING_CARD_CALCULATOR_TOOL];