@jjlmoya/utils-finance 1.42.0 → 1.43.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-finance",
-    "version": "1.42.0",
+    "version": "1.43.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

package/src/category/index.ts

@@ -21,10 +21,11 @@ import { dividendYield } from '../tool/dividendYield/entry';
 import { inflationPurchasingPower } from '../tool/inflationPurchasingPower/entry';
 import { subscriptionCostAnnualizer } from '../tool/subscriptionCostAnnualizer/entry';
 import { loanToIncomeRatio } from '../tool/loanToIncomeRatio/entry';
+import { capitalGainsTaxScenarioCalculator } from '../tool/capitalGainsTaxScenarioCalculator/entry';
 
 export const financeCategory: FinanceCategoryEntry = {
   icon: 'mdi:finance',
-  tools: [compoundInterest, financialFreedom, savingsRate, profitability, mortgage, inflation, percentageCalculator, lateInterest, ibanBicSwift, rentIncrease, lotteryOptimizer, courtFeeCalculator, legalInterestRate, fireCalculator, debtSnowball, revolvingCardCalculator, pesetaValue, salaryEmployerCost, dividendYield, inflationPurchasingPower, subscriptionCostAnnualizer, loanToIncomeRatio],
+  tools: [compoundInterest, financialFreedom, savingsRate, profitability, mortgage, inflation, percentageCalculator, lateInterest, ibanBicSwift, rentIncrease, lotteryOptimizer, courtFeeCalculator, legalInterestRate, fireCalculator, debtSnowball, revolvingCardCalculator, pesetaValue, salaryEmployerCost, dividendYield, inflationPurchasingPower, subscriptionCostAnnualizer, loanToIncomeRatio, capitalGainsTaxScenarioCalculator],
   i18n: {
     en: () => import('./i18n/en').then((m) => m.content),
     es: () => import('./i18n/es').then((m) => m.content),

package/src/entries.ts

@@ -46,6 +46,8 @@ export { loanToIncomeRatio } from './tool/loanToIncomeRatio/entry';
 export type { LoanToIncomeRatioLocaleContent } from './tool/loanToIncomeRatio/entry';
 export { rentalDepositReturn } from './tool/rentalDepositReturn/entry';
 export type { RentalDepositReturnLocaleContent } from './tool/rentalDepositReturn/entry';
+export { capitalGainsTaxScenarioCalculator } from './tool/capitalGainsTaxScenarioCalculator/entry';
+export type { CapitalGainsTaxScenarioCalculatorLocaleContent } from './tool/capitalGainsTaxScenarioCalculator/entry';
 export { financeCategory } from './category';
 import { compoundInterest } from './tool/compoundInterest/entry';
 import { financialFreedom } from './tool/financialFreedom/entry';
@@ -70,4 +72,5 @@ import { inflationPurchasingPower } from './tool/inflationPurchasingPower/entry'
 import { subscriptionCostAnnualizer } from './tool/subscriptionCostAnnualizer/entry';
 import { loanToIncomeRatio } from './tool/loanToIncomeRatio/entry';
 import { rentalDepositReturn } from './tool/rentalDepositReturn/entry';
-export const ALL_ENTRIES = [compoundInterest, financialFreedom, savingsRate, profitability, courtFeeCalculator, debtSnowball, fireCalculator, ibanBicSwift, inflation, lateInterest, legalInterestRate, lotteryOptimizer, mortgage, percentageCalculator, rentIncrease, revolvingCardCalculator, pesetaValue, salaryEmployerCost, dividendYield, mortgageExtraPaymentPlanner, inflationPurchasingPower, subscriptionCostAnnualizer, loanToIncomeRatio, rentalDepositReturn];
+import { capitalGainsTaxScenarioCalculator } from './tool/capitalGainsTaxScenarioCalculator/entry';
+export const ALL_ENTRIES = [compoundInterest, financialFreedom, savingsRate, profitability, courtFeeCalculator, debtSnowball, fireCalculator, ibanBicSwift, inflation, lateInterest, legalInterestRate, lotteryOptimizer, mortgage, percentageCalculator, rentIncrease, revolvingCardCalculator, pesetaValue, salaryEmployerCost, dividendYield, mortgageExtraPaymentPlanner, inflationPurchasingPower, subscriptionCostAnnualizer, loanToIncomeRatio, rentalDepositReturn, capitalGainsTaxScenarioCalculator];

package/src/index.ts

@@ -36,3 +36,4 @@ export { SALARY_EMPLOYER_COST_TOOL } from './tool/salaryEmployerCost';
 export { DIVIDEND_YIELD_TOOL } from './tool/dividendYield';
 export { MORTGAGE_EXTRA_PAYMENT_PLANNER_TOOL } from './tool/mortgageExtraPaymentPlanner';
 export { LOAN_TO_INCOME_RATIO_TOOL } from './tool/loanToIncomeRatio';
+export { CAPITAL_GAINS_TAX_SCENARIO_CALCULATOR_TOOL } from './tool/capitalGainsTaxScenarioCalculator';

package/src/tests/locale_completeness.test.ts

@@ -25,7 +25,7 @@ describe('Locale Completeness Validation', () => {
     });
   });
 
-  it('all 24 tools registered', () => {
-    expect(ALL_TOOLS.length).toBe(24);
+  it('all 25 tools registered', () => {
+    expect(ALL_TOOLS.length).toBe(25);
   });
 });

package/src/tests/tool_validation.test.ts

@@ -4,8 +4,8 @@ import { financeCategory } from '../data';
 
 describe('Tool Validation Suite', () => {
   describe('Library Registration', () => {
-    it('should have 24 tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(24);
+    it('should have 25 tools in ALL_TOOLS', () => {
+      expect(ALL_TOOLS.length).toBe(25);
     });
 
     it('financeCategory should be defined', () => {

package/src/tool/capitalGainsTaxScenarioCalculator/bibliography.astro

@@ -0,0 +1,11 @@
+---
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
+import { capitalGainsTaxScenarioCalculator } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props { locale?: KnownLocale; }
+const { locale = 'en' } = Astro.props;
+const content = await capitalGainsTaxScenarioCalculator.i18n[locale]?.() ?? await capitalGainsTaxScenarioCalculator.i18n.en?.();
+---
+
+{content && <SharedBibliography links={content.bibliography} />}

package/src/tool/capitalGainsTaxScenarioCalculator/bibliography.ts

@@ -0,0 +1,12 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Agencia Tributaria: Reglas generales de cálculo',
+    url: 'https://sede.agenciatributaria.gob.es/Sede/ayuda/manuales-videos-folletos/manuales-practicos/irpf-2025/c11-ganancias-perdidas-patrimoniales/determinacion-importe-ganancias-perdidas-patrimon-generales/derivadas-transmisiones-onerosas-lucrativas/reglas-generales-calculo.html',
+  },
+  {
+    name: 'IRS Publication 551: Basis of Assets',
+    url: 'https://www.irs.gov/publications/p551',
+  },
+];

package/src/tool/capitalGainsTaxScenarioCalculator/capital-gains-tax-scenario-calculator.css

@@ -0,0 +1,469 @@
+.cgt-tool {
+  --cgt-ink: #27261f;
+  --cgt-muted: #716d61;
+  --cgt-paper: #fbf6e9;
+  --cgt-surface: #f1e8d5;
+  --cgt-edge: #d6c8a8;
+  --cgt-accent: #b35d39;
+  --cgt-accent-soft: #efd6c5;
+  --cgt-cool: #39747a;
+  --cgt-gold: #c18a2c;
+  --cgt-danger: #a23e46;
+  --cgt-shadow: #55463122;
+
+  color: var(--cgt-ink);
+  margin: 0 auto;
+  max-width: 74rem;
+  width: min(100%, calc(100vw - 2rem));
+}
+
+:global(.theme-dark) .cgt-tool,
+:global([data-theme='dark']) .cgt-tool {
+  --cgt-ink: #f7f0e4;
+  --cgt-muted: #c3b9a8;
+  --cgt-paper: #24251f;
+  --cgt-surface: #303128;
+  --cgt-edge: #555548;
+  --cgt-accent: #e28b63;
+  --cgt-accent-soft: #5d352a;
+  --cgt-cool: #87c8c7;
+  --cgt-gold: #e4b55b;
+  --cgt-danger: #ef8d8b;
+  --cgt-shadow: #0007;
+}
+
+.cgt-card {
+  background: var(--cgt-paper);
+  border: 1px solid var(--cgt-edge);
+  border-radius: 1.35rem;
+  box-shadow: 0 1rem 2.5rem var(--cgt-shadow);
+  overflow: hidden;
+}
+
+.cgt-glance {
+  align-items: center;
+  background: var(--cgt-accent);
+  color: var(--cgt-paper);
+  display: grid;
+  gap: 0.35rem 1rem;
+  grid-template-columns: 1.2fr 1fr 1fr;
+  padding: 0.85rem 1.35rem;
+}
+
+.cgt-glance span {
+  font-size: 0.72rem;
+  font-weight: 800;
+}
+
+.cgt-glance strong {
+  display: grid;
+  font-size: 1.05rem;
+  font-variant-numeric: tabular-nums;
+  gap: 0.12rem;
+  text-align: right;
+}
+
+.cgt-glance strong small {
+  font-size: 0.64rem;
+  font-weight: 700;
+  opacity: 0.82;
+}
+
+.cgt-inputs {
+  background: var(--cgt-surface);
+  border-bottom: 1px solid var(--cgt-edge);
+  display: grid;
+  gap: 0.9rem;
+  grid-template-columns: repeat(4, minmax(0, 1fr));
+  padding: 1.35rem;
+}
+
+.cgt-field {
+  display: grid;
+  gap: 0.35rem;
+  min-width: 0;
+}
+
+.cgt-select-wrap {
+  position: relative;
+}
+
+.cgt-select-arrow {
+  border-bottom: 2px solid var(--cgt-accent);
+  border-right: 2px solid var(--cgt-accent);
+  height: 0.55rem;
+  pointer-events: none;
+  position: absolute;
+  right: 1rem;
+  top: 50%;
+  transform: translateY(-70%) rotate(45deg);
+  transition: transform 0.2s ease, border-color 0.2s ease;
+  width: 0.55rem;
+}
+
+.cgt-select-wrap:focus-within .cgt-select-arrow {
+  border-color: var(--cgt-cool);
+  transform: translateY(-25%) rotate(225deg);
+}
+
+.cgt-currency-field select {
+  appearance: none;
+  background: var(--cgt-paper);
+  border: 1px solid var(--cgt-edge);
+  border-radius: 0.6rem;
+  cursor: pointer;
+  color: var(--cgt-ink);
+  font: inherit;
+  min-height: 2.8rem;
+  padding: 0.65rem 2.8rem 0.65rem 0.7rem;
+  transition: border-color 0.2s ease, box-shadow 0.2s ease;
+  width: 100%;
+  color-scheme: light;
+}
+
+.cgt-currency-field select:hover {
+  border-color: var(--cgt-accent);
+  box-shadow: 0 0 0 3px color-mix(in srgb, var(--cgt-accent) 12%, transparent);
+}
+
+.cgt-currency-field select option {
+  background: var(--cgt-paper);
+  color: var(--cgt-ink);
+}
+
+:global(.theme-dark) .cgt-currency-field select,
+:global([data-theme='dark']) .cgt-currency-field select {
+  color-scheme: dark;
+}
+
+.cgt-field label {
+  font-size: 0.78rem;
+  font-weight: 800;
+  line-height: 1.25;
+}
+
+.cgt-input-wrap {
+  align-items: center;
+  display: flex;
+  position: relative;
+}
+
+.cgt-input-wrap input {
+  background: var(--cgt-paper);
+  border: 1px solid var(--cgt-edge);
+  border-radius: 0.6rem;
+  box-sizing: border-box;
+  color: var(--cgt-ink);
+  font: inherit;
+  min-height: 2.8rem;
+  padding: 0.65rem 2rem 0.65rem 0.7rem;
+  width: 100%;
+}
+
+.cgt-input-wrap input:focus-visible,
+.cgt-currency-field select:focus-visible,
+.cgt-button:focus-visible,
+.cgt-method summary:focus-visible {
+  outline: 3px solid var(--cgt-accent);
+  outline-offset: 2px;
+}
+
+.cgt-input-wrap input[aria-invalid="true"] {
+  border-color: var(--cgt-danger);
+}
+
+.cgt-input-wrap span {
+  color: var(--cgt-muted);
+  font-size: 0.8rem;
+  font-weight: 800;
+  pointer-events: none;
+  position: absolute;
+  right: 0.7rem;
+}
+
+.cgt-field small {
+  color: var(--cgt-danger);
+  font-size: 0.68rem;
+  line-height: 1.3;
+}
+
+.cgt-actions {
+  align-items: center;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.7rem;
+  padding: 1rem 1.35rem 0;
+}
+
+.cgt-button {
+  border: 1px solid var(--cgt-accent);
+  border-radius: 99rem;
+  cursor: pointer;
+  font: inherit;
+  font-weight: 800;
+  min-height: 2.7rem;
+  padding: 0.55rem 1rem;
+}
+
+.cgt-button-primary {
+  background: var(--cgt-accent);
+  color: var(--cgt-paper);
+}
+
+.cgt-button-secondary {
+  background: transparent;
+  color: var(--cgt-accent);
+}
+
+.cgt-copy-status {
+  color: var(--cgt-cool);
+  font-size: 0.76rem;
+  font-weight: 750;
+}
+
+.cgt-output {
+  display: grid;
+  gap: 1.1rem;
+  padding: 1.35rem;
+}
+
+.cgt-status {
+  align-self: start;
+  background: var(--cgt-accent-soft);
+  border-radius: 99rem;
+  color: var(--cgt-accent);
+  display: inline-flex;
+  font-size: 0.75rem;
+  font-weight: 850;
+  justify-self: start;
+  padding: 0.42rem 0.75rem;
+}
+
+.cgt-tool[data-status="loss"] .cgt-status {
+  color: var(--cgt-danger);
+}
+
+.cgt-tool[data-status="breakEven"] .cgt-status {
+  color: var(--cgt-gold);
+}
+
+.cgt-visual {
+  background: linear-gradient(145deg, color-mix(in srgb, var(--cgt-accent-soft) 70%, transparent), transparent 62%), var(--cgt-paper);
+  border: 1px solid var(--cgt-edge);
+  border-radius: 1rem;
+  padding: 1.1rem;
+}
+
+.cgt-visual-heading,
+.cgt-visual-bars {
+  align-items: center;
+  display: grid;
+  gap: 1rem;
+  grid-template-columns: 1fr auto 1fr;
+}
+
+.cgt-visual-heading {
+  color: var(--cgt-muted);
+  font-size: 0.72rem;
+  font-weight: 800;
+  grid-template-columns: 1fr 1fr;
+  text-align: center;
+}
+
+.cgt-visual-bars {
+  margin-top: 0.8rem;
+}
+
+.cgt-bar-side {
+  display: grid;
+  gap: 0.45rem;
+  min-width: 0;
+}
+
+.cgt-bar-side strong {
+  font-size: 1.1rem;
+  font-variant-numeric: tabular-nums;
+  text-align: center;
+}
+
+.cgt-bar-track {
+  background: var(--cgt-surface);
+  border-radius: 99rem;
+  height: 0.8rem;
+  overflow: hidden;
+}
+
+.cgt-bar-track i {
+  background: var(--cgt-cool);
+  border-radius: inherit;
+  display: block;
+  height: 100%;
+  min-width: 0.35rem;
+  transition: width 0.25s ease;
+}
+
+.cgt-bar-side:last-child .cgt-bar-track i {
+  background: var(--cgt-gold);
+}
+
+.cgt-visual-rail {
+  color: var(--cgt-accent);
+  font-size: 1.5rem;
+  font-weight: 900;
+}
+
+.cgt-scenarios {
+  display: grid;
+  gap: 0.9rem;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+
+.cgt-scenario {
+  border: 1px solid var(--cgt-edge);
+  border-radius: 0.9rem;
+  padding: 1rem;
+}
+
+.cgt-scenario h2 {
+  font-size: 0.95rem;
+  margin: 0 0 0.8rem;
+}
+
+.cgt-scenario dl {
+  display: grid;
+  gap: 0.42rem;
+  margin: 0;
+}
+
+.cgt-scenario dl div {
+  align-items: baseline;
+  border-bottom: 1px solid color-mix(in srgb, var(--cgt-edge) 75%, transparent);
+  display: flex;
+  gap: 0.6rem;
+  justify-content: space-between;
+  padding-bottom: 0.4rem;
+}
+
+.cgt-scenario dt,
+.cgt-scenario dd {
+  font-size: 0.76rem;
+  margin: 0;
+}
+
+.cgt-scenario dt {
+  color: var(--cgt-muted);
+}
+
+.cgt-scenario dd {
+  font-variant-numeric: tabular-nums;
+  font-weight: 750;
+  text-align: right;
+}
+
+.cgt-scenario .cgt-emphasis {
+  border-bottom: 0;
+  color: var(--cgt-accent);
+  font-size: 1.05rem;
+  padding-top: 0.35rem;
+}
+
+.cgt-scenario .cgt-emphasis dt,
+.cgt-scenario .cgt-emphasis dd {
+  color: inherit;
+  font-size: 0.9rem;
+  font-weight: 850;
+}
+
+.cgt-note,
+.cgt-privacy,
+.cgt-method p {
+  color: var(--cgt-muted);
+  font-size: 0.74rem;
+  line-height: 1.5;
+}
+
+.cgt-note {
+  margin: 0.8rem 0 0;
+}
+
+.cgt-comparison {
+  align-items: center;
+  background: var(--cgt-surface);
+  border: 1px solid var(--cgt-edge);
+  border-radius: 0.9rem;
+  display: grid;
+  gap: 0.25rem 0.8rem;
+  grid-template-columns: auto 1fr;
+  padding: 0.9rem 1rem;
+}
+
+.cgt-comparison span,
+.cgt-comparison small {
+  color: var(--cgt-muted);
+  font-size: 0.72rem;
+}
+
+.cgt-comparison strong {
+  color: var(--cgt-accent);
+  font-size: 1rem;
+}
+
+.cgt-comparison small {
+  grid-column: 2;
+}
+
+.cgt-error-summary {
+  background: var(--cgt-accent-soft);
+  border-radius: 0.7rem;
+  color: var(--cgt-danger);
+  font-size: 0.78rem;
+  margin: 0;
+  padding: 0.7rem 0.85rem;
+}
+
+.cgt-privacy {
+  border-top: 1px solid var(--cgt-edge);
+  margin: 0;
+  padding: 0.9rem 1.35rem;
+}
+
+.cgt-method {
+  border-top: 1px solid var(--cgt-edge);
+  padding: 0.9rem 1.35rem 1.15rem;
+}
+
+.cgt-method summary {
+  cursor: pointer;
+  font-size: 0.8rem;
+  font-weight: 800;
+}
+
+.cgt-method p:last-child {
+  margin-bottom: 0;
+}
+
+@media (max-width: 900px) {
+  .cgt-inputs {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+}
+
+@media (max-width: 620px) {
+  .cgt-glance,
+  .cgt-inputs,
+  .cgt-scenarios {
+    grid-template-columns: 1fr;
+  }
+
+  .cgt-glance strong {
+    text-align: left;
+  }
+
+  .cgt-visual-bars {
+    gap: 0.55rem;
+  }
+
+  .cgt-visual-rail {
+    font-size: 1.1rem;
+  }
+}