@jjlmoya/utils-finance 1.38.0 → 1.39.0

package/package.json

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

package/src/category/index.ts

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

package/src/entries.ts

@@ -36,6 +36,8 @@ export { dividendYield } from './tool/dividendYield/entry';
 export type { DividendYieldLocaleContent } from './tool/dividendYield/entry';
 export { inflationPurchasingPower } from './tool/inflationPurchasingPower/entry';
 export type { InflationPurchasingPowerLocaleContent } from './tool/inflationPurchasingPower/entry';
+export { subscriptionCostAnnualizer } from './tool/subscriptionCostAnnualizer/entry';
+export type { SubscriptionCostAnnualizerLocaleContent } from './tool/subscriptionCostAnnualizer/entry';
 export { financeCategory } from './category';
 import { compoundInterest } from './tool/compoundInterest/entry';
 import { financialFreedom } from './tool/financialFreedom/entry';
@@ -57,4 +59,5 @@ import { salaryEmployerCost } from './tool/salaryEmployerCost/entry';
 import { dividendYield } from './tool/dividendYield/entry';
 import { mortgageExtraPaymentPlanner } from './tool/mortgageExtraPaymentPlanner/entry';
 import { inflationPurchasingPower } from './tool/inflationPurchasingPower/entry';
-export const ALL_ENTRIES = [compoundInterest, financialFreedom, profitability, courtFeeCalculator, debtSnowball, fireCalculator, ibanBicSwift, inflation, lateInterest, legalInterestRate, lotteryOptimizer, mortgage, percentageCalculator, rentIncrease, revolvingCardCalculator, pesetaValue, salaryEmployerCost, dividendYield, mortgageExtraPaymentPlanner, inflationPurchasingPower];
+import { subscriptionCostAnnualizer } from './tool/subscriptionCostAnnualizer/entry';
+export const ALL_ENTRIES = [compoundInterest, financialFreedom, profitability, courtFeeCalculator, debtSnowball, fireCalculator, ibanBicSwift, inflation, lateInterest, legalInterestRate, lotteryOptimizer, mortgage, percentageCalculator, rentIncrease, revolvingCardCalculator, pesetaValue, salaryEmployerCost, dividendYield, mortgageExtraPaymentPlanner, inflationPurchasingPower, subscriptionCostAnnualizer];

package/src/tests/locale_completeness.test.ts

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

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 20 tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(20);
+    it('should have 21 tools in ALL_TOOLS', () => {
+      expect(ALL_TOOLS.length).toBe(21);
     });
 
     it('financeCategory should be defined', () => {

package/src/tool/subscriptionCostAnnualizer/bibliography.astro

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

package/src/tool/subscriptionCostAnnualizer/bibliography.ts

@@ -0,0 +1,6 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  { name: 'Consumer Financial Protection Bureau, Managing your subscriptions', url: 'https://www.consumerfinance.gov/consumer-tools/bank-accounts/' },
+  { name: 'Banco de España, Financial education resources', url: 'https://clientebancario.bde.es/pcb/en/menu-horizontal/actualidadeduca/' },
+];

package/src/tool/subscriptionCostAnnualizer/component.astro

@@ -0,0 +1,58 @@
+---
+import type { SubscriptionCostAnnualizerUI } from './ui';
+import type { SubscriptionCalculatorInput } from './logic';
+import { calculateSubscriptionCosts } from './logic';
+import { renderSubscriptionResults, renderSubscriptionScene } from './dom-views';
+import './subscription-cost-annualizer.css';
+
+interface Props { ui: SubscriptionCostAnnualizerUI; locale?: string; }
+
+const { ui } = Astro.props;
+const initial: SubscriptionCalculatorInput = {
+  currency: 'USD',
+  subscriptions: [
+    { id: 'streaming', name: 'Streaming', amount: 12, frequency: 'monthly', renewalDate: '2026-10-12' },
+    { id: 'cloud', name: 'Cloud backup', amount: 4, frequency: 'monthly', renewalDate: '2026-10-20' },
+    { id: 'magazine', name: 'Magazine', amount: 24, frequency: 'quarterly', renewalDate: '2026-11-05' },
+  ],
+};
+const initialResult = calculateSubscriptionCosts(initial);
+const config = JSON.stringify({ ui, initial });
+---
+
+<div class="subscription-cost-annualizer-tool" data-sca-tool>
+  <form class="sca-controls" aria-label={ui.subscriptionLabel}>
+    <div class="sca-currency-field">
+      <label for="sca-currency">{ui.currencyLabel}</label>
+      <select id="sca-currency" data-sca-currency>
+        <option value="USD">USD — US dollar</option>
+        <option value="EUR">EUR — Euro</option>
+        <option value="GBP">GBP — Pound sterling</option>
+        <option value="CAD">CAD — Canadian dollar</option>
+        <option value="AUD">AUD — Australian dollar</option>
+        <option value="JPY">JPY — Japanese yen</option>
+      </select>
+      <small>{ui.currencyHelp}</small>
+    </div>
+    <div class="sca-list-heading"><h2>{ui.subscriptionLabel}</h2><span>{ui.reorderHint}</span></div>
+    <div class="sca-list" data-sca-list></div>
+    <div class="sca-actions"><button type="button" class="sca-primary-button" data-sca-add>{ui.addButton}</button><button type="button" class="sca-secondary-button" data-sca-reset>{ui.resetButton}</button></div>
+  </form>
+
+  <section class="sca-output" aria-live="polite">
+    <div class="sca-scene-wrap" data-sca-scene set:html={initialResult ? renderSubscriptionScene(initialResult, ui) : ''}></div>
+    <div class="sca-results-wrap" data-sca-results set:html={initialResult ? renderSubscriptionResults(initialResult, ui) : ''}></div>
+    <p class="sca-error" data-sca-error hidden>{ui.emptyMessage}</p>
+  </section>
+
+  <p class="sca-privacy">{ui.privacyNote}</p>
+  <details class="sca-method"><summary>{ui.methodTitle}</summary><p>{ui.methodText}</p><p>{ui.limitationText}</p></details>
+</div>
+
+<script is:inline type="application/json" data-sca-config set:html={config}></script>
+<script>
+  import { initSubscriptionCostAnnualizer } from './controller';
+  const root = document.querySelector<HTMLElement>('[data-sca-tool]');
+  const configElement = document.querySelector<HTMLScriptElement>('[data-sca-config]');
+  if (root && configElement?.textContent) initSubscriptionCostAnnualizer(root, JSON.parse(configElement.textContent));
+</script>