@jjlmoya/utils-finance 1.4.0 → 1.7.0

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

@@ -0,0 +1,160 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { DebtSnowballUI } from '../ui';
+
+const slug = 'snobollsmetoden-skuld-kalkylator';
+const title = 'Kalkylator Snöbollsmetoden: Plan för Skuldbetalning 2026';
+const description = 'Beräkna ditt datum för ekonomisk frihet med Dave Ramseys snöbollsmetod. Organisera dina skulder och visualisera din månatliga betalningsplan.';
+
+const faqData = [
+  {
+    question: 'Vad är snöbollsmetoden?',
+    answer: 'Det är en strategi för skuldbetalning som går ut på att betala av skulder i ordning efter minsta till största saldo, oavsett ränta. Den fokuserar på den psykologiska vinsten i att snabbt eliminera små konton.',
+  },
+  {
+    question: 'Varför inte sortera efter ränta (Lavinmetoden)?',
+    answer: 'Matematiskt sparar det mer pengar att betala av den högsta räntan först. Men många ger upp för att de inte ser omedelbara resultat. Snöbollen prioriterar motivation.',
+  },
+  {
+    question: 'Bör jag ha sparkapital innan jag startar planen?',
+    answer: 'Det rekommenderas att ha en "Initial nödfond" (ca 1 000 €) innan man attackerar skulderna. Detta förhindrar att man behöver använda kreditkortet igen vid oförutsedda händelser.',
+  },
+  {
+    question: 'Vilka skulder ska jag inkludera i kalkylatorn?',
+    answer: 'Alla konsumtionsskulder: kreditkort, privatlån, billån, förfallna räkningar. Bolånet brukar lämnas till en senare fas på grund av sin stora volym.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Lista dina skulder',
+    text: 'Skriv ner alla dina skulder med aktuellt kvarvarande saldo och den månatliga minimibetalningen.',
+  },
+  {
+    name: 'Definiera din extrabudget',
+    text: 'Beräkna hur mycket extra pengar du kan avsätta varje månad utöver minimibetalningarna.',
+  },
+  {
+    name: 'Sortera och prioritera',
+    text: 'Kalkylatorn sorterar automatiskt från minsta till största saldo. Betala minimum på alla utom den minsta.',
+  },
+  {
+    name: 'Utför kaskaden',
+    text: 'När du har betalat av den minsta skulden, ta alla pengar du använde till den och lägg till på nästa skuld i listan.',
+  },
+];
+
+const bibliographyData = [
+  {
+    name: 'Investopedia — Debt Snowball vs. Debt Avalanche',
+    url: 'https://www.investopedia.com/',
+  },
+  {
+    name: 'Harvard Business Review — Research on Debt Payoff Strategies',
+    url: 'https://hbr.org/',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'FinanceApplication',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+};
+
+export const content: ToolLocaleContent<DebtSnowballUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Vanliga frågor',
+  faq: faqData,
+  bibliographyTitle: 'Referenser och källor',
+  bibliography: bibliographyData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Kalkylator Skulder Snöbollsmetoden: Guide 2026',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Att leva med skulder är tungt. <strong>Snöbollsmetoden</strong> har visat sig vara en av de mest effektiva strategierna för att återfå ekonomisk frihet.',
+    },
+  ],
+  ui: {
+    labelTitle: 'Total frihet',
+    labelDescription: 'Börja din väg mot ekonomisk frihet med den psykologiskt mest effektiva metoden.',
+    labelExtraBudget: 'MÅNATLIG EXTRABUDGET',
+    labelExtraBudgetHelp: 'Extra pengar utöver minimibetalningarna.',
+    labelSnowballMethod: 'SNÖBOLL',
+    labelAvalancheMethod: 'LAVIN',
+    labelAddNewDebt: 'LÄGG TILL NY SKULD',
+    labelDebtName: 'Namn',
+    labelDebtNamePlaceholder: 'T.ex: Visa',
+    labelDebtBalance: 'HUR MYCKET DU ÄR SKYLDIG',
+    labelDebtBalancePlaceholder: '0',
+    labelMinPayment: 'MINIMIBETALNING',
+    labelInterestRate: 'RÄNTESATS',
+    labelInterestHelp: 'ÅRLIG',
+    labelAddButton: 'LÄGG TILL I PLANEN',
+    labelClearData: 'Rensa inställningar',
+    labelClearDataConfirm: 'Tömma planen?',
+    labelDeleteDebt: 'Ta bort',
+    labelDebtInventory: 'Skuldinventering',
+    labelFreedomDate: 'DATUM FÖR EKONOMISK FRIHET',
+    labelActiveMethod: 'METOD',
+    labelMonthsRemaining: 'ÅTERSTÅENDE MÅNADER',
+    labelTotalInterest: 'TOTAL RÄNTA',
+    labelTotalPaid: 'SLUTLIG TOTALBETALNING',
+    labelInterestSaved: 'SPARAD RÄNTA',
+    labelYourStrategy: 'Din strategi steg för steg',
+    labelStrategyHelp: 'Varje steg visar din totala betalning.',
+    labelPriority: 'HÖGSTA PRIORITET',
+    labelStep: 'STEG',
+    labelAfterPaying: 'EFTER ATT HA BETALAT FÖREGÅENDE',
+    labelMonthlyPayment: 'Månatlig betalning',
+    labelDetailedAmortization: 'Detaljerad Amortering',
+    labelExportCSV: 'Exportera .CSV',
+    labelDate: 'Datum',
+    labelStartingBalance: 'Ingående balans',
+    labelInterest: 'Ränta',
+    labelAmortization: 'Amorterat',
+    labelTotalMonth: 'Total månad',
+    labelRemaining: 'Återstående',
+    labelFree: 'FRI',
+    labelDebtInfinite: 'OÄNDLIG SKULD',
+    labelInvalidInput: 'Ange totalsaldo och minimibetalning',
+    labelEmptyStateTitle: 'Starta din plan',
+    labelEmptyStateDescription: 'Dina skulder är inte för evigt. Lägg till dina skulder.',
+    currencySymbol: '€',
+    currencyCode: 'EUR',
+    currencyLocale: 'sv-SE',
+  },
+};

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

@@ -0,0 +1,160 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { DebtSnowballUI } from '../ui';
+
+const slug = 'borc-kartopu-metodu-hesaplayici';
+const title = 'Borç Kartopu Hesaplayıcı: Borç Ödeme Planı 2026';
+const description = 'Dave Ramsey’in kartopu metodu ile finansal özgürlük tarihinizi hesaplayın. Borçlarınızı düzenleyin ve aylık ödeme planınızı görselleştirin.';
+
+const faqData = [
+  {
+    question: 'Borç kartopu metodu nedir?',
+    answer: 'Faiz oranına bakılmaksızın borçların en küçük bakiyeden en büyüğe doğru ödenmesini içeren bir stratejidir. Küçük hesapları hızla kapatmanın getirdiği psikolojik başarıya odaklanır.',
+  },
+  {
+    question: 'Neden faiz oranına (Çığ Metodu) göre sıralanmıyor?',
+    answer: 'Matematiksel olarak en yüksek faizi önce ödemek daha fazla para kazandırır. Ancak birçok kişi hemen sonuç görmediği için pes eder. Kartopu motivasyona öncelik verir.',
+  },
+  {
+    question: 'Plana başlamadan önce birikimim olmalı mı?',
+    answer: 'Borçlara saldırmadan önce küçük bir "Acil Durum Fonu" (yaklaşık 1.000€) oluşturulması önerilir. Bu, beklenmedik durumlarda tekrar kredi kartına sarılmanızı önler.',
+  },
+  {
+    question: 'Hesaplayıcıya hangi borçları dahil etmeliyim?',
+    answer: 'Tüm tüketici borçları: kredi kartları, kişisel krediler, araç kredileri, gecikmiş faturalar. Konut kredisi genellikle hacmi nedeniyle sonraki aşamaya bırakılır.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Borçlarınızı listeleyin',
+    text: 'Tüm borçlarınızı, kalan bakiyeleri ve aylık minimum ödeme tutarlarını belirterek not edin.',
+  },
+  {
+    name: 'Ek bütçenizi belirleyin',
+    text: 'Minimum ödemelerin üzerine her ay ne kadar ek para ayırabileceğinizi hesaplayın.',
+  },
+  {
+    name: 'Sıralayın ve önceliklendirin',
+    text: 'Hesaplayıcı otomatik olarak en küçük bakiyeden en büyüğe doğru sıralayacaktır. En küçüğü hariç hepsinde minimumu ödeyin.',
+  },
+  {
+    name: 'Basamağı uygulayın',
+    text: 'En küçük borcu kapattığınızda, ona ayırdığınız tüm parayı alın ve listedeki bir sonraki borcun ödemesine ekleyin.',
+  },
+];
+
+const bibliographyData = [
+  {
+    name: 'Investopedia — Debt Snowball vs. Debt Avalanche',
+    url: 'https://www.investopedia.com/',
+  },
+  {
+    name: 'Harvard Business Review — Research on Debt Payoff Strategies',
+    url: 'https://hbr.org/',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'FinanceApplication',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+};
+
+export const content: ToolLocaleContent<DebtSnowballUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Sıkça Sorulan Sorular',
+  faq: faqData,
+  bibliographyTitle: 'Kaynaklar ve Referanslar',
+  bibliography: bibliographyData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Borç Kartopu Metodu Hesaplayıcı: Kılavuz 2026',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Borçla yaşamak zordur. <strong>Kartopu metodu</strong>, finansal özgürlüğü geri kazanmak için en etkili stratejilerden biri olduğunu kanıtlamıştır.',
+    },
+  ],
+  ui: {
+    labelTitle: 'Tam özgürlük',
+    labelDescription: 'Finansal özgürlüğe giden yolunuza psikolojik olarak en etkili yöntemle başlayın.',
+    labelExtraBudget: 'AYLIK EK BÜTÇE',
+    labelExtraBudgetHelp: 'Minimum ödemelerin üzerindeki ek para.',
+    labelSnowballMethod: 'KARTOPU',
+    labelAvalancheMethod: 'ÇIĞ',
+    labelAddNewDebt: 'YENİ BORÇ EKLE',
+    labelDebtName: 'İsim',
+    labelDebtNamePlaceholder: 'Örn: Visa',
+    labelDebtBalance: 'BORCUNUZ NE KADAR',
+    labelDebtBalancePlaceholder: '0',
+    labelMinPayment: 'MİNİMUM ÖDEME',
+    labelInterestRate: 'FAİZ ORANI',
+    labelInterestHelp: 'YILLIK',
+    labelAddButton: 'PLANA EKLE',
+    labelClearData: 'Ayarları temizle',
+    labelClearDataConfirm: 'Plan boşaltılsın mı?',
+    labelDeleteDebt: 'Sil',
+    labelDebtInventory: 'Borç Envanteri',
+    labelFreedomDate: 'FİNANSAL ÖZGÜRLÜK TARİHİ',
+    labelActiveMethod: 'METOT',
+    labelMonthsRemaining: 'KALAN AY SAYISI',
+    labelTotalInterest: 'TOPLAM FAİZ',
+    labelTotalPaid: 'TOPLAM FİNAL ÖDEMESİ',
+    labelInterestSaved: 'FAİZ TASARRUFU',
+    labelYourStrategy: 'Adım Adım Stratejiniz',
+    labelStrategyHelp: 'Her adım toplam ödemenizi gösterir.',
+    labelPriority: 'EN YÜKSEK ÖNCELİK',
+    labelStep: 'ADIM',
+    labelAfterPaying: 'ÖNCEKİNİ KAPATTIKTAN SONRA',
+    labelMonthlyPayment: 'Aylık ödeme',
+    labelDetailedAmortization: 'Detaylı Amortisman',
+    labelExportCSV: '.CSV Olarak Dışa Aktar',
+    labelDate: 'Tarih',
+    labelStartingBalance: 'Başlangıç Bakiyesi',
+    labelInterest: 'Faiz',
+    labelAmortization: 'Amortisman',
+    labelTotalMonth: 'Aylık Toplam',
+    labelRemaining: 'Kalan',
+    labelFree: 'ÖZGÜR',
+    labelDebtInfinite: 'SONSUZ BORÇ',
+    labelInvalidInput: 'Toplam bakiye ve minimum ödemeyi belirtin',
+    labelEmptyStateTitle: 'Planınıza başlayın',
+    labelEmptyStateDescription: 'Borçlarınız sonsuza kadar sürmeyecek. Borçlarınızı ekleyin.',
+    currencySymbol: '€',
+    currencyCode: 'EUR',
+    currencyLocale: 'tr-TR',
+  },
+};

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

@@ -0,0 +1,160 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { DebtSnowballUI } from '../ui';
+
+const slug = 'debt-snowball-calculator';
+const title = '债务雪球法计算器：2026 年还款计划';
+const description = '使用 Dave Ramsey 的雪球法计算您的财务自由日期。整理您的债务并查看详细的每月还款计划。';
+
+const faqData = [
+  {
+    question: '什么是债务雪球法？',
+    answer: '这是一种债务偿还策略，要求按照债务余额从小到大的顺序偿还债务，而不考虑利率。它的核心在于通过快速消除小额账户来获得心理上的成就感和动力。',
+  },
+  {
+    question: '为什么不按照利率排序（雪崩法）？',
+    answer: '从数学上讲，先偿还高利率债务可以节省更多利息。然而，许多人因为看不到即时结果而中途放弃。雪球法优先考虑动机：看到债务迅速消失能给您应对大额债务的能量。',
+  },
+  {
+    question: '在开始计划之前我需要有储蓄吗？',
+    answer: '建议在攻击债务之前先建立一个“初始紧急基金”（约 1,000 欧元）。这可以防止在遇到突发情况时不得不再次使用信用卡而破坏您的进度。',
+  },
+  {
+    question: '我应该在计算器中包含哪些债务？',
+    answer: '所有的消费债务：信用卡、个人贷款、汽车贷款、逾期账单。房贷通常因为金额巨大而被留到后期。',
+  },
+];
+
+const howToData = [
+  {
+    name: '列出您的债务',
+    text: '写下您所有的债务，注明当前的剩余余额和您每月支付的最低还款额。',
+  },
+  {
+    name: '确定额外预算',
+    text: '计算您每个月在最低还款额之外还能投入多少额外资金用于还债。',
+  },
+  {
+    name: '排序并确定优先级',
+    text: '计算器将自动按余额从小到大排序。对除最小债务外的所有债务支付最低额，将所有额外资金投入最小的债务。',
+  },
+  {
+    name: '执行级联还款',
+    text: '当清完最小的一笔债务后，将原来用于该债务的所有资金（最低还款额 + 额外资金）全部转入下一笔债务。',
+  },
+];
+
+const bibliographyData = [
+  {
+    name: 'Investopedia — Debt Snowball vs. Debt Avalanche',
+    url: 'https://www.investopedia.com/',
+  },
+  {
+    name: 'Harvard Business Review — Research on Debt Payoff Strategies',
+    url: 'https://hbr.org/',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'FinanceApplication',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+};
+
+export const content: ToolLocaleContent<DebtSnowballUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: '常见问题',
+  faq: faqData,
+  bibliographyTitle: '来源与参考资料',
+  bibliography: bibliographyData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: '债务雪球法计算器：2026 年完整指南',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '带着债务生活就像背着重负跑马拉松。<strong>债务雪球法</strong>已被证明是重获财务自由最有效的策略之一。',
+    },
+  ],
+  ui: {
+    labelTitle: '彻底自由',
+    labelDescription: '用心理上最有效的方法开始您的财务自由之路。',
+    labelExtraBudget: '每月额外预算',
+    labelExtraBudgetHelp: '在最低还款额之外的资金。',
+    labelSnowballMethod: '雪球法',
+    labelAvalancheMethod: '雪崩法',
+    labelAddNewDebt: '添加新债务',
+    labelDebtName: '名称',
+    labelDebtNamePlaceholder: '例如：Visa 卡',
+    labelDebtBalance: '欠款金额',
+    labelDebtBalancePlaceholder: '0',
+    labelMinPayment: '最低还款额',
+    labelInterestRate: '年利率',
+    labelInterestHelp: '年化',
+    labelAddButton: '添加到计划',
+    labelClearData: '清除设置',
+    labelClearDataConfirm: '清空计划？',
+    labelDeleteDebt: '删除',
+    labelDebtInventory: '债务清单',
+    labelFreedomDate: '财务自由日期',
+    labelActiveMethod: '方法',
+    labelMonthsRemaining: '剩余月数',
+    labelTotalInterest: '总利息',
+    labelTotalPaid: '最终总还款',
+    labelInterestSaved: '节省的利息',
+    labelYourStrategy: '您的分步策略',
+    labelStrategyHelp: '每一步都显示您的总还款额。',
+    labelPriority: '最高优先级',
+    labelStep: '步骤',
+    labelAfterPaying: '在结清上一笔后',
+    labelMonthlyPayment: '每月还款',
+    labelDetailedAmortization: '详细摊销计划',
+    labelExportCSV: '导出 .CSV',
+    labelDate: '日期',
+    labelStartingBalance: '起始余额',
+    labelInterest: '利息',
+    labelAmortization: '已偿还本金',
+    labelTotalMonth: '月计',
+    labelRemaining: '剩余',
+    labelFree: '自由',
+    labelDebtInfinite: '债务无限',
+    labelInvalidInput: '请输入总余额和最低还款额',
+    labelEmptyStateTitle: '开始您的计划',
+    labelEmptyStateDescription: '债务不是永久的。添加您的债务以查看自由之路。',
+    currencySymbol: '€',
+    currencyCode: 'EUR',
+    currencyLocale: 'zh-CN',
+  },
+};

package/src/tool/debtSnowball/index.ts

@@ -8,20 +8,28 @@ import { DebtSnowballLogic, type Debt, type SimulationResult, type ProjectionMon
 export type DebtSnowballLocaleContent = ToolLocaleContent<DebtSnowballUI>;
 export type { Debt, SimulationResult, ProjectionMonth };
 
-import { content as es } from './i18n/es';
-import { content as en } from './i18n/en';
-import { content as fr } from './i18n/fr';
-
 export const debtSnowball: FinanceToolEntry<DebtSnowballUI> = {
   id: 'bola-nieve-deuda',
   icons: {
-    bg: 'mdi:chart-line',
-    fg: 'mdi:trending-up',
+    bg: 'mdi:snowflake',
+    fg: 'mdi:trending-down',
   },
   i18n: {
-    es: async () => es,
-    en: async () => en,
-    fr: async () => fr,
+    de: () => import('./i18n/de').then((m) => m.content),
+    en: () => import('./i18n/en').then((m) => m.content),
+    es: () => import('./i18n/es').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+    id: () => import('./i18n/id').then((m) => m.content),
+    it: () => import('./i18n/it').then((m) => m.content),
+    ja: () => import('./i18n/ja').then((m) => m.content),
+    ko: () => import('./i18n/ko').then((m) => m.content),
+    nl: () => import('./i18n/nl').then((m) => m.content),
+    pl: () => import('./i18n/pl').then((m) => m.content),
+    pt: () => import('./i18n/pt').then((m) => m.content),
+    ru: () => import('./i18n/ru').then((m) => m.content),
+    sv: () => import('./i18n/sv').then((m) => m.content),
+    tr: () => import('./i18n/tr').then((m) => m.content),
+    zh: () => import('./i18n/zh').then((m) => m.content),
   },
 };