@jjlmoya/utils-finance 1.42.0 → 1.43.0

package/src/tool/capitalGainsTaxScenarioCalculator/seo.astro

@@ -0,0 +1,11 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { capitalGainsTaxScenarioCalculator } from './entry';
+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?.seo && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/capitalGainsTaxScenarioCalculator/ui.ts

@@ -0,0 +1,40 @@
+export interface CapitalGainsTaxScenarioCalculatorUI extends Record<string, string> {
+  labelPurchasePrice: string;
+  labelAcquisitionCosts: string;
+  labelImprovements: string;
+  labelSalePrice: string;
+  labelSellingCosts: string;
+  labelTaxRate: string;
+  labelAlternativeSalePrice: string;
+  labelAlternativeSellingCosts: string;
+  labelCurrency: string;
+  labelCurrentScenario: string;
+  labelAlternativeScenario: string;
+  labelAcquisitionBasis: string;
+  labelNetSaleValue: string;
+  labelGainOrLoss: string;
+  labelEstimatedTax: string;
+  labelNetGainAfterTax: string;
+  labelNetProceeds: string;
+  labelBetterScenario: string;
+  labelCurrentIsBetter: string;
+  labelAlternativeIsBetter: string;
+  labelSameOutcome: string;
+  labelGainStatus: string;
+  labelLossStatus: string;
+  labelBreakEvenStatus: string;
+  labelTaxableGainNote: string;
+  labelLossNote: string;
+  labelVisual: string;
+  labelComparison: string;
+  labelDifference: string;
+  labelCopy: string;
+  labelCopied: string;
+  labelReset: string;
+  labelInvalidInput: string;
+  labelMethodTitle: string;
+  labelMethodText: string;
+  labelPrivacyNote: string;
+  labelAmountPlaceholder: string;
+  labelPercentPlaceholder: string;
+}

package/src/tool/capitalGainsTaxScenarioCalculator/validation.ts

@@ -0,0 +1,34 @@
+export const validationEvidence = {
+  reviewedAt: '2026-09-06',
+  methodology:
+    'The tool estimates a user-defined scenario as net sale value minus an entered acquisition basis, then applies the entered percentage only to a positive gain. It is a planning model, not a tax return or a jurisdiction-specific assessment.',
+  sources: [
+    {
+      title: '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',
+      role: 'Primary Spanish reference for acquisition and transmission value components.',
+    },
+    {
+      title: 'IRS Publication 551: Basis of Assets',
+      url: 'https://www.irs.gov/publications/p551',
+      role: 'Primary reference for basis and sale gain/loss concepts.',
+    },
+  ],
+  referenceCases: [
+    {
+      name: 'Gain scenario',
+      input: { purchasePrice: 100000, acquisitionCosts: 5000, improvements: 10000, salePrice: 180000, sellingCosts: 6000, taxRate: 20 },
+      expected: { acquisitionBasis: 115000, gainOrLoss: 59000, estimatedTax: 11800, netGainAfterTax: 47200 },
+    },
+    {
+      name: 'Loss scenario',
+      input: { purchasePrice: 100000, acquisitionCosts: 5000, improvements: 10000, salePrice: 90000, sellingCosts: 6000, taxRate: 20 },
+      expected: { taxableGain: 0, estimatedTax: 0 },
+    },
+  ],
+  limitations: [
+    'The entered percentage is not looked up or validated against any country, year, asset type or taxpayer situation.',
+    'The model does not include allowances, losses carried forward, depreciation, exemptions, inflation adjustments, separate improvements, or special regimes.',
+    'Use the result to compare private scenarios and prepare questions; consult the relevant tax authority or a qualified adviser for a filing.',
+  ],
+} as const;

package/src/tools.ts

@@ -24,5 +24,6 @@ import { INFLATION_PURCHASING_POWER_TOOL } from './tool/inflationPurchasingPower
 import { SUBSCRIPTION_COST_ANNUALIZER_TOOL } from './tool/subscriptionCostAnnualizer';
 import { LOAN_TO_INCOME_RATIO_TOOL } from './tool/loanToIncomeRatio';
 import { RENTAL_DEPOSIT_RETURN_TOOL } from './tool/rentalDepositReturn';
+import { CAPITAL_GAINS_TAX_SCENARIO_CALCULATOR_TOOL } from './tool/capitalGainsTaxScenarioCalculator';
 
-export const ALL_TOOLS: ToolDefinition[] = [COMPOUND_INTEREST_TOOL, FINANCIAL_FREEDOM_TOOL, SAVINGS_RATE_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, PESETA_VALUE_TOOL, SALARY_EMPLOYER_COST_TOOL, DIVIDEND_YIELD_TOOL, MORTGAGE_EXTRA_PAYMENT_PLANNER_TOOL, INFLATION_PURCHASING_POWER_TOOL, SUBSCRIPTION_COST_ANNUALIZER_TOOL, LOAN_TO_INCOME_RATIO_TOOL, RENTAL_DEPOSIT_RETURN_TOOL];
+export const ALL_TOOLS: ToolDefinition[] = [COMPOUND_INTEREST_TOOL, FINANCIAL_FREEDOM_TOOL, SAVINGS_RATE_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, PESETA_VALUE_TOOL, SALARY_EMPLOYER_COST_TOOL, DIVIDEND_YIELD_TOOL, MORTGAGE_EXTRA_PAYMENT_PLANNER_TOOL, INFLATION_PURCHASING_POWER_TOOL, SUBSCRIPTION_COST_ANNUALIZER_TOOL, LOAN_TO_INCOME_RATIO_TOOL, RENTAL_DEPOSIT_RETURN_TOOL, CAPITAL_GAINS_TAX_SCENARIO_CALCULATOR_TOOL];