@jjlmoya/utils-finance 1.23.0 → 1.25.0

package/src/tool/profitability/validation.ts

@@ -0,0 +1,16 @@
+export const validation = {
+  reviewedAt: '2026-08-17',
+  methodology: 'The calculator applies the documented profitability inputs and exposes assumptions in the user interface; it is not a substitute for accounting or tax advice.',
+  sources: [
+    'User-provided revenue, cost, margin, and period inputs.',
+    'Formula definitions maintained beside the profitability calculator.',
+  ],
+  referenceCases: [
+    'Zero revenue and zero cost return a zero result without division errors.',
+    'Positive revenue with positive cost preserves the expected margin relationship.',
+  ],
+  limitations: [
+    'The result depends on the accuracy and period of the supplied figures.',
+    'No official rate, accounting classification, or tax treatment is inferred.',
+  ],
+};

package/src/tool/rentIncreaseCalculator/i18n/de.ts

@@ -24,7 +24,8 @@ const faqData = [
     question: 'Was passiert, wenn der IPC höher als das gesetzliche Limit von 3 % ist?',
     answer: 'Auch wenn der reale IPC höher ist, darf der Eigentümer eines Hauptwohnsitzes in den Jahren 2024 und 2025 rechtlich keine Erhöhung über 3 % fordern.',
   },
-];
+
+  { question: "Was sollte ich vor der Verwendung prüfen?", answer: "Prüfen Sie Eingaben, Einheiten, Annahmen und Grenzen; das Ergebnis ist eine Orientierung, keine offizielle Entscheidung." },];
 
 const howToData = [
   {
@@ -55,7 +56,11 @@ const seoData = [
     type: 'paragraph',
     html: 'In Spanien wird der <strong>Verbraucherpreisindex (IPC)</strong> traditionell zur Anpassung der Miete verwendet. Durch das neue Wohnungsgesetz wurden jedoch wichtige Limits eingeführt.',
   },
-];
+
+  { type: 'paragraph', html: "Nutzen Sie das Ergebnis zur Planung und zum Szenarienvergleich; es ersetzt keine offizielle Berechnung oder Fachberatung." },
+  { type: 'paragraph', html: "Deuten Sie das Ergebnis gemeinsam mit den angezeigten Annahmen, bevor Sie es verwenden." },
+  { type: 'paragraph', html: "Prüfen Sie Eingaben, Einheiten, Rundung, Datum und Recht, weil jedes Element die Schätzung verändern kann." },
+  { type: 'paragraph', html: "Nutzen Sie das Ergebnis zur Planung und zum Szenarienvergleich; es ersetzt keine offizielle Berechnung oder Fachberatung." },];
 
 const faqSchema: WithContext<FAQPage> = {
   '@context': 'https://schema.org',

package/src/tool/rentIncreaseCalculator/i18n/id.ts

@@ -24,7 +24,8 @@ const faqData = [
     question: 'Apa yang terjadi jika IPC lebih tinggi dari batas hukum 3%?',
     answer: 'Meskipun IPC riil lebih tinggi, pemilik tempat tinggal utama secara hukum tidak dapat menuntut kenaikan lebih dari 3% selama tahun 2024 dan 2025.',
   },
-];
+
+  { question: "Apa yang harus diperiksa sebelum memakai hasil?", answer: "Periksa input, satuan, asumsi, dan batasan; hasil ini adalah panduan, bukan keputusan resmi." },];
 
 const howToData = [
   {
@@ -55,7 +56,11 @@ const seoData = [
     type: 'paragraph',
     html: 'Di Spanyol, <strong>Indeks Harga Konsumen (IPC)</strong> secara tradisional digunakan sebagai tolok ukur untuk menyesuaikan harga sewa. Namun, Undang-Undang Perumahan baru telah memperkenalkan batasan penting.',
   },
-];
+
+  { type: 'paragraph', html: "Gunakan hasil untuk perencanaan dan perbandingan skenario; hasil ini bukan pengganti perhitungan resmi atau nasihat ahli." },
+  { type: 'paragraph', html: "Tafsirkan hasil bersama asumsi yang ditampilkan kalkulator sebelum menggunakannya." },
+  { type: 'paragraph', html: "Periksa input, satuan, pembulatan, tanggal, dan yurisdiksi karena semuanya dapat mengubah estimasi." },
+  { type: 'paragraph', html: "Gunakan hasil untuk perencanaan dan perbandingan skenario; hasil ini bukan pengganti perhitungan resmi atau nasihat ahli." },];
 
 const faqSchema: WithContext<FAQPage> = {
   '@context': 'https://schema.org',

package/src/tool/rentIncreaseCalculator/i18n/it.ts

@@ -24,7 +24,8 @@ const faqData = [
     question: 'Cosa succede se l\'IPC è superiore al limite legale del 3%?',
     answer: 'Anche se l\'IPC reale è superiore, il proprietario di un\'abitazione principale non può richiedere legalmente un aumento superiore al 3% durante il 2024 e il 2025.',
   },
-];
+
+  { question: "Cosa devo verificare prima di usare il risultato?", answer: "Controlla dati, unità, ipotesi e limiti; è un'indicazione, non una decisione ufficiale." },];
 
 const howToData = [
   {
@@ -55,7 +56,11 @@ const seoData = [
     type: 'paragraph',
     html: 'In Spagna, l\'<strong>Indice dei Prezzi al Consumo (IPC)</strong> è tradizionalmente lo strumento utilizzato per adeguare il prezzo dell\'affitto. Tuttavia, la nuova Legge sulla Casa ha introdotto limiti importanti.',
   },
-];
+
+  { type: 'paragraph', html: "Usa il risultato per pianificare e confrontare scenari; non sostituisce un calcolo ufficiale o una consulenza professionale." },
+  { type: 'paragraph', html: "Interpreta il risultato insieme alle ipotesi mostrate dal calcolatore prima di utilizzarlo." },
+  { type: 'paragraph', html: "Controlla dati, unità, arrotondamento, data e giurisdizione, perché ciascun elemento può cambiare la stima." },
+  { type: 'paragraph', html: "Usa il risultato per pianificare e confrontare scenari; non sostituisce un calcolo ufficiale o una consulenza professionale." },];
 
 const faqSchema: WithContext<FAQPage> = {
   '@context': 'https://schema.org',

package/src/tool/rentIncreaseCalculator/i18n/ja.ts

@@ -24,7 +24,8 @@ const faqData = [
     question: 'IPCが法定上限の3%を超えた場合はどうなりますか？',
     answer: '実際のIPCがどれほど高くても、居住用賃貸住宅の所有者は、2024年と2025年の間、3%を超える値上げを法的に要求することはできません。',
   },
-];
+
+  { question: "結果を使う前に何を確認すべきですか？", answer: "入力、単位、前提、制限事項を確認してください。結果は目安であり、公式な判断ではありません。" },];
 
 const howToData = [
   {
@@ -55,7 +56,11 @@ const seoData = [
     type: 'paragraph',
     html: 'スペインでは、伝統的に<strong>消費者物価指数 (IPC)</strong>が家賃価格の調整に使用されてきました。しかし、新しい住宅法により重要な制限が導入されています。',
   },
-];
+
+  { type: 'paragraph', html: "結果は計画や条件比較に使えますが、公式計算や専門家の助言の代わりにはなりません。" },
+  { type: 'paragraph', html: "利用する前に、計算機が示す前提条件と結果を一緒に確認してください。" },
+  { type: 'paragraph', html: "入力値、単位、丸め、日付、地域を確認してください。どれも推定結果を変える可能性があります。" },
+  { type: 'paragraph', html: "結果は計画や条件比較に使えますが、公式計算や専門家の助言の代わりにはなりません。" },];
 
 const faqSchema: WithContext<FAQPage> = {
   '@context': 'https://schema.org',

package/src/tool/rentIncreaseCalculator/i18n/ko.ts

@@ -24,7 +24,8 @@ const faqData = [
     question: '실제 IPC가 법적 상한선인 3%보다 높으면 어떻게 되나요?',
     answer: '실제 IPC가 더 높더라도 거주용 주택 소유자는 2024년과 2025년 기간 동안 법적으로 3% 이상의 인상을 요구할 수 없습니다.',
   },
-];
+
+  { question: "결과를 사용하기 전에 무엇을 확인해야 하나요?", answer: "입력, 단위, 가정과 제한사항을 확인하세요. 결과는 참고용이며 공식 판단이 아닙니다." },];
 
 const howToData = [
   {
@@ -55,7 +56,11 @@ const seoData = [
     type: 'paragraph',
     html: '스페인에서는 전통적으로 <strong>소비자물가지수(IPC)</strong>를 기준으로 임대료를 조정해 왔습니다. 하지만 새로운 주택법 도입으로 중요한 제한 사항이 생겼습니다.',
   },
-];
+
+  { type: 'paragraph', html: "결과는 계획과 시나리오 비교에 사용할 수 있지만 공식 계산이나 전문가 조언을 대신하지 않습니다." },
+  { type: 'paragraph', html: "사용하기 전에 계산기가 표시한 가정과 결과를 함께 확인하세요." },
+  { type: 'paragraph', html: "입력값, 단위, 반올림, 날짜와 관할을 확인하세요. 모두 추정값을 바꿀 수 있습니다." },
+  { type: 'paragraph', html: "결과는 계획과 시나리오 비교에 사용할 수 있지만 공식 계산이나 전문가 조언을 대신하지 않습니다." },];
 
 const faqSchema: WithContext<FAQPage> = {
   '@context': 'https://schema.org',

package/src/tool/rentIncreaseCalculator/i18n/nl.ts

@@ -24,7 +24,8 @@ const faqData = [
     question: 'Wat gebeurt er als de IPC hoger is dan de wettelijke limiet van 3%?',
     answer: 'Zelfs als de werkelijke IPC hoger is, mag de eigenaar van een hoofdverblijf in 2024 und 2025 wettelijk geen verhoging van meer dan 3% eisen.',
   },
-];
+
+  { question: "Wat moet ik controleren voordat ik het resultaat gebruik?", answer: "Controleer invoer, eenheden, aannames en beperkingen; het resultaat is een richtlijn, geen officiële beslissing." },];
 
 const howToData = [
   {
@@ -55,7 +56,11 @@ const seoData = [
     type: 'paragraph',
     html: 'In Spanje wordt de <strong>Consumentenprijsindex (IPC)</strong> traditioneel gebruikt om de huurprijs aan te passen. De nieuwe Woonwet heeft echter belangrijke limieten geïntroduceerd.',
   },
-];
+
+  { type: 'paragraph', html: "Gebruik het resultaat voor planning en scenariokeuze; het vervangt geen officiële berekening of professioneel advies." },
+  { type: 'paragraph', html: "Interpreteer het resultaat samen met de aannames van de calculator voordat u het gebruikt." },
+  { type: 'paragraph', html: "Controleer invoer, eenheden, afronding, datum en jurisdictie, want elk onderdeel kan de schatting wijzigen." },
+  { type: 'paragraph', html: "Gebruik het resultaat voor planning en scenariokeuze; het vervangt geen officiële berekening of professioneel advies." },];
 
 const faqSchema: WithContext<FAQPage> = {
   '@context': 'https://schema.org',

package/src/tool/rentIncreaseCalculator/i18n/pl.ts

@@ -24,7 +24,8 @@ const faqData = [
     question: 'Co się stanie, jeśli wskaźnik IPC będzie wyższy niż ustawowy limit 3%?',
     answer: 'Nawet jeśli rzeczywisty wskaźnik IPC będzie wyższy, właściciel lokalu mieszkalnego nie może prawnie żądać podwyżki większej niż 3% w latach 2024 i 2025.',
   },
-];
+
+  { question: "Co sprawdzić przed użyciem wyniku?", answer: "Sprawdź dane, jednostki, założenia i ograniczenia; wynik jest wskazówką, a nie decyzją urzędową." },];
 
 const howToData = [
   {
@@ -55,7 +56,11 @@ const seoData = [
     type: 'paragraph',
     html: 'W Hiszpanii <strong>Wskaźnik Cen Towarów i Usług Konsumpcyjnych (IPC)</strong> był tradycyjnie miarą używaną do dostosowywania cen wynajmu. Jednak nowa Ustawa o Mieszkalnictwie wprowadziła istotne ograniczenia.',
   },
-];
+
+  { type: 'paragraph', html: "Używaj wyniku do planowania i porównywania scenariuszy; nie zastępuje obliczeń urzędowych ani porady specjalisty." },
+  { type: 'paragraph', html: "Przed użyciem zinterpretuj wynik razem z założeniami pokazanymi przez kalkulator." },
+  { type: 'paragraph', html: "Sprawdź dane, jednostki, zaokrąglenie, datę i jurysdykcję, ponieważ każdy element może zmienić szacunek." },
+  { type: 'paragraph', html: "Używaj wyniku do planowania i porównywania scenariuszy; nie zastępuje obliczeń urzędowych ani porady specjalisty." },];
 
 const faqSchema: WithContext<FAQPage> = {
   '@context': 'https://schema.org',

package/src/tool/rentIncreaseCalculator/i18n/pt.ts

@@ -24,7 +24,8 @@ const faqData = [
     question: 'O que acontece se o IPC for superior ao limite legal de 3%?',
     answer: 'Mesmo que o IPC real seja superior, o proprietário de uma habitação habitual não pode exigir legalmente uma subida superior a 3% durante 2024 e 2025.',
   },
-];
+
+  { question: "O que devo verificar antes de usar o resultado?", answer: "Verifique dados, unidades, premissas e limitações; é uma orientação, não uma decisão oficial." },];
 
 const howToData = [
   {
@@ -55,7 +56,11 @@ const seoData = [
     type: 'paragraph',
     html: 'Em Espanha, o <strong>Índice de Preços no Consumidor (IPC)</strong> tem sido tradicionalmente o termómetro utilizado para ajustar o preço do aluguer. No entanto, a nova Lei de Habitação introduziu limites importantes.',
   },
-];
+
+  { type: 'paragraph', html: "Use o resultado para planear e comparar cenários; não substitui um cálculo oficial nem aconselhamento profissional." },
+  { type: 'paragraph', html: "Interprete o resultado juntamente com as premissas apresentadas pela calculadora antes de o utilizar." },
+  { type: 'paragraph', html: "Confirme dados, unidades, arredondamento, data e jurisdição, pois cada elemento pode alterar a estimativa." },
+  { type: 'paragraph', html: "Use o resultado para planear e comparar cenários; não substitui um cálculo oficial nem aconselhamento profissional." },];
 
 const faqSchema: WithContext<FAQPage> = {
   '@context': 'https://schema.org',

package/src/tool/rentIncreaseCalculator/i18n/ru.ts

@@ -24,7 +24,8 @@ const faqData = [
     question: 'Что произойдет, если IPC будет выше установленного законом лимита в 3%?',
     answer: 'Даже если реальный IPC выше, владелец основного жилья по закону не может требовать повышения более чем на 3% в течение 2024 и 2025 годов.',
   },
-];
+
+  { question: "Что проверить перед использованием результата?", answer: "Проверьте ввод, единицы, допущения и ограничения; это ориентир, а не официальное решение." },];
 
 const howToData = [
   {
@@ -55,7 +56,11 @@ const seoData = [
     type: 'paragraph',
     html: 'В Испании <strong>Индекс потребительских цен (IPC)</strong> традиционно использовался как ориентир для корректировки цен на аренду. Однако новый Закон о жилье ввел важные ограничения.',
   },
-];
+
+  { type: 'paragraph', html: "Используйте результат для планирования и сравнения сценариев; он не заменяет официальный расчёт или консультацию специалиста." },
+  { type: 'paragraph', html: "Перед использованием интерпретируйте результат вместе с допущениями, указанными калькулятором." },
+  { type: 'paragraph', html: "Проверьте ввод, единицы, округление, дату и юрисдикцию: каждый параметр может изменить оценку." },
+  { type: 'paragraph', html: "Используйте результат для планирования и сравнения сценариев; он не заменяет официальный расчёт или консультацию специалиста." },];
 
 const faqSchema: WithContext<FAQPage> = {
   '@context': 'https://schema.org',

package/src/tool/rentIncreaseCalculator/i18n/sv.ts

@@ -24,7 +24,8 @@ const faqData = [
     question: 'Vad händer om IPC är högre än den lagstadgade gränsen på 3 %?',
     answer: 'Även om den faktiska IPC-siffran är högre får ägaren till en permanentbostad enligt lag inte kräva en höjning på mer än 3 % under 2024 och 2025.',
   },
-];
+
+  { question: "Vad bör jag kontrollera innan resultatet används?", answer: "Kontrollera indata, enheter, antaganden och begränsningar; resultatet är vägledning, inte ett officiellt beslut." },];
 
 const howToData = [
   {
@@ -55,7 +56,11 @@ const seoData = [
     type: 'paragraph',
     html: 'I Spanien används <strong>konsumentprisindex (IPC)</strong> traditionellt för att justera hyrespriserna. Den nya bostadslagen har dock infört viktiga begränsningar.',
   },
-];
+
+  { type: 'paragraph', html: "Använd resultatet för planering och scenariejämförelser; det ersätter inte en officiell beräkning eller professionell rådgivning." },
+  { type: 'paragraph', html: "Tolka resultatet tillsammans med kalkylatorns antaganden innan du använder det." },
+  { type: 'paragraph', html: "Kontrollera indata, enheter, avrundning, datum och rättsområde eftersom varje del kan ändra uppskattningen." },
+  { type: 'paragraph', html: "Använd resultatet för planering och scenariejämförelser; det ersätter inte en officiell beräkning eller professionell rådgivning." },];
 
 const faqSchema: WithContext<FAQPage> = {
   '@context': 'https://schema.org',

package/src/tool/rentIncreaseCalculator/i18n/tr.ts

@@ -24,7 +24,8 @@ const faqData = [
     question: 'IPC yasal sınır olan %3\'ten yüksekse ne olur?',
     answer: 'Gerçek IPC daha yüksek olsa bile, bir daimi konutun sahibi 2024 ve 2025 yılları boyunca yasal olarak %3\'ten fazla bir artış talep edemez.',
   },
-];
+
+  { question: "Sonucu kullanmadan önce neyi kontrol etmeliyim?", answer: "Girdileri, birimleri, varsayımları ve sınırlamaları kontrol edin; bu bir rehber tahmindir, resmî karar değildir." },];
 
 const howToData = [
   {
@@ -55,7 +56,11 @@ const seoData = [
     type: 'paragraph',
     html: 'İspanya\'da <strong>Tüketici Fiyat Endeksi (IPC)</strong> geleneksel olarak kira fiyatlarını ayarlamak için kullanılan bir ölçüttür. Ancak yeni Konut Yasası ile önemli sınırlamalar getirilmiştir.',
   },
-];
+
+  { type: 'paragraph', html: "Sonucu planlama ve senaryo karşılaştırması için kullanın; resmî hesabın veya uzman görüşünün yerine geçmez." },
+  { type: 'paragraph', html: "Kullanmadan önce sonucu hesaplayıcının gösterdiği varsayımlarla birlikte yorumlayın." },
+  { type: 'paragraph', html: "Girdileri, birimleri, yuvarlamayı, tarihi ve yargı alanını kontrol edin; her biri tahmini değiştirebilir." },
+  { type: 'paragraph', html: "Sonucu planlama ve senaryo karşılaştırması için kullanın; resmî hesabın veya uzman görüşünün yerine geçmez." },];
 
 const faqSchema: WithContext<FAQPage> = {
   '@context': 'https://schema.org',

package/src/tool/rentIncreaseCalculator/i18n/zh.ts

@@ -24,7 +24,8 @@ const faqData = [
     question: '如果 IPC 高于 3% 的法定上限会怎样？',
     answer: '即使国家统计局公布的实际 IPC 为 5% 或 6%，在 2024 年和 2025 年期间，常住住房的房东依法也不得要求超过 3% 的涨幅。',
   },
-];
+
+  { question: "使用结果前应检查什么？", answer: "请检查输入、单位、假设和限制；结果仅供参考，不是正式决定。" },];
 
 const howToData = [
   {
@@ -55,7 +56,11 @@ const seoData = [
     type: 'paragraph',
     html: '在西班牙，<strong>消费者物价指数 (IPC)</strong> 传统上是用于调整房租价格的指标。然而，随着第 <strong>12/2023 号《住房权法》</strong>的实施，引入了每个租客和房东都必须了解的限制。',
   },
-];
+
+  { type: 'paragraph', html: "结果可用于规划和比较方案，但不能替代官方计算或专业建议。" },
+  { type: 'paragraph', html: "使用前请结合计算器显示的假设一起解读结果。" },
+  { type: 'paragraph', html: "请检查输入值、单位、四舍五入方式、日期和司法辖区，因为每项都可能改变估算。" },
+  { type: 'paragraph', html: "结果可用于规划和比较方案，但不能替代官方计算或专业建议。" },];
 
 const faqSchema: WithContext<FAQPage> = {
   '@context': 'https://schema.org',

package/src/tool/revolvingCardCalculator/bibliography.astro

@@ -0,0 +1,14 @@
+---
+import { Bibliography as SharedBibliography } 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]?.();
+---
+
+{content && <SharedBibliography links={content.bibliography} />}

package/src/tool/revolvingCardCalculator/bibliography.ts

@@ -0,0 +1,24 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Banco de España - Estadísticas de Tipos de Interés',
+    url: 'https://www.bde.es/webbde/es/estadis/infoest/tipos/tipos.html',
+  },
+  {
+    name: 'Sentencia del Tribunal Supremo de España 258/2023 sobre Usura',
+    url: 'https://www.poderjudicial.es/',
+  },
+  {
+    name: 'US Consumer Financial Protection Bureau (CFPB) - Credit Cards',
+    url: 'https://www.consumerfinance.gov/consumer-tools/credit-cards/',
+  },
+  {
+    name: 'UK Financial Conduct Authority (FCA) - Credit Cards Rules',
+    url: 'https://www.fca.org.uk/consumers/credit-cards',
+  },
+  {
+    name: 'Investopedia - Revolving Debt Explained',
+    url: 'https://www.investopedia.com/terms/r/revolvingdebt.asp',
+  },
+];