@jjlmoya/utils-motor 1.13.0 → 1.14.0

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

@@ -0,0 +1,30 @@
+import type { FAQItem, HowToStep } from '../../../types';
+import { createVehicleCostContent, createVehicleCostSeo } from './factory';
+import type { VehicleTotalCostPerKilometreCalculatorUI } from '../ui';
+
+const ui: VehicleTotalCostPerKilometreCalculatorUI = {
+  presetLabel: 'Börja med ett realistiskt mönster', presetCity: 'Mest stad', presetBalanced: 'Blandad körning', presetLongDistance: 'Lång körning', resetLabel: 'Återställ värden',
+  primaryScenarioLabel: 'Ditt fordon', comparisonScenarioLabel: 'Andra scenariot', distanceLabel: 'Sträcka per år', distanceHint: 'Använd den sträcka du tror att du kör på ett år', fuelUseLabel: 'Bränsleförbrukning', fuelUseHint: 'Fordonets genomsnitt i liter per 100 km', fuelPriceLabel: 'Bränslepris', fuelPriceHint: 'Pris per liter', insuranceLabel: 'Försäkring per år', insuranceHint: 'Din faktiska årspremie', maintenanceLabel: 'Underhåll per år', maintenanceHint: 'Service, reparationer, däck och kontroller', taxLabel: 'Skatt och avgifter per år', taxHint: 'Fordonsskatt, registrering och återkommande avgifter', depreciationLabel: 'Värdeminskning per år', depreciationHint: 'Din uppskattning av värdet som försvinner under ett år', currencyLabel: 'Valuta', compareLabel: 'Jämför ett annat scenario', compareOnLabel: 'Jämförelse på', compareOffLabel: 'Lägg till jämförelse', removeComparisonLabel: 'Dölj jämförelse', resultLabel: 'Kostnadsvägen', resultTitle: 'Vad varje kilometer verkligen kostar', resultSceneLabel: 'En väg visar fasta ägandekostnader och bränsle fram till kostnaden per kilometer', costPerKmLabel: 'Kostnad per kilometer', monthlyCostLabel: 'Genomsnittlig månad', annualCostLabel: 'Helt år', fuelCostLabel: 'Bränsle per år', fixedCostLabel: 'Fasta kostnader och ägande', statusBalanced: 'Kostnaderna fördelas över vägen', statusFixedHeavy: 'Ägandekostnaderna väger tyngst', statusRunningHeavy: 'Bränslet väger tyngst', validationError: 'Ange en positiv årlig sträcka och icke-negativa kostnader.', comparisonTitle: 'Jämförelse av scenarier', comparisonPrimaryCheaper: 'Ditt fordon är billigare med', comparisonSecondaryCheaper: 'Det andra scenariot är billigare med', comparisonSame: 'Scenarierna kostar ungefär lika mycket', fixedLaneLabel: 'Fast', fuelLaneLabel: 'Bränsle', totalLaneLabel: 'Totalt', formulaLabel: 'Beräkning', formulaText: 'Årskostnad = årlig sträcka × förbrukning ÷ 100 × bränslepris + försäkring + underhåll + skatt + värdeminskning. Kostnad per kilometer = årskostnad ÷ årlig sträcka.', inputUnitDistance: 'km', inputUnitFuelUse: 'L / 100 km', inputUnitFuelPrice: '/ L', inputUnitAnnualCost: '/ år', outputUnitDistance: 'km',
+};
+
+const faq: FAQItem[] = [
+  { question: 'Vad ingår i kalkylatorn för kostnad per kilometer?', answer: 'Den kombinerar bränsle, försäkring, underhåll, skatter och avgifter samt den uppskattade årliga värdeminskningen. Du anger dina egna värden.' },
+  { question: 'Varför blir resultatet högre än i en bränslekalkylator?', answer: 'Bränsle är bara den rörliga delen. Försäkring, reparationer, årsavgifter och värdeminskning ska också fördelas på varje kilometer.' },
+  { question: 'Hur uppskattar jag värdeminskningen?', answer: 'Dra det förväntade värdet vid årets slut från startvärdet. Testa ett lågt och ett högt scenario om andrahandsvärdet är osäkert.' },
+  { question: 'Kan jag jämföra två fordon?', answer: 'Ja. Aktivera jämförelsen och använd samma årliga sträcka, period och valuta.' },
+  { question: 'Förutsäger resultatet den exakta kostnaden för en resa?', answer: 'Nej. Det är en planeringsuppskattning. Priser, reparationer, sträcka och andrahandsvärde kan förändras.' },
+];
+
+const howTo: HowToStep[] = [
+  { name: 'Ange årlig sträcka', text: 'Skriv in hur många kilometer du tror att du kör på ett år.' },
+  { name: 'Lägg till bränsle', text: 'Ange förbrukning per 100 kilometer och pris per liter.' },
+  { name: 'Lägg till ägandekostnader', text: 'Ange försäkring, underhåll, skatt, avgifter och värdeminskning.' },
+  { name: 'Läs eller jämför', text: 'Använd kostnaden per kilometer och kontrollera fasta kostnader mot bränsle.' },
+];
+
+export const content = createVehicleCostContent({
+  locale: 'sv', slug: 'kalkylator-total-fordonkostnad-per-kilometer', title: 'Kalkylator för total fordonskostnad per kilometer', description: 'Beräkna den verkliga kostnaden per kilometer med bränsle, ägandekostnader och årlig körsträcka.', faqTitle: 'Vanliga frågor', bibliographyTitle: 'Bibliografiska källor', ui, faq, howTo,
+  seo: createVehicleCostSeo({
+    introTitle: 'Se kostnaden som döljer sig bakom varje kilometer', introA: 'Ett bränslepris räcker inte för att visa vad ett fordon faktiskt kostar. Försäkring, service, däck, skatt och värdeminskning påverkar också beslutet. Kalkylatorn fördelar de årliga kostnaderna över den sträcka du väntar dig att köra och visar dem bredvid bränslekostnaden.', introB: 'Ange dina egna siffror i stället för ett allmänt genomsnitt. Huvudresultatet är kostnaden per kilometer, med månadssumma, årssumma och en visuell uppdelning mellan fasta kostnader och bränsle.', costsTitle: 'Vilka kostnader ska tas med', costsText: 'Bränslet förändras med sträckan. Försäkring, underhåll, avgifter och värdeminskning anges som årskostnader. En kort årlig sträcka gör fasta kostnader större per kilometer.', costsHeaders: ['Indata', 'Så används den', 'Kontrollera'], costsRows: [['Årlig sträcka', 'Delar årssumman på kilometer', 'Använd en realistisk sträcka'], ['Förbrukning och pris', 'Skapar den rörliga bränslekostnaden', 'Använd samma grund i båda scenarierna'], ['Försäkring, underhåll och skatt', 'Lägger till återkommande kostnader', 'Glöm inte däck och kontroller'], ['Värdeminskning', 'Lägger till årlig avskrivning', 'Testa flera andrahandsvärden']], readTitle: 'Läs kostnadsvägen', readText: 'Den fasta delen visar kostnader som inte ökar direkt för varje kilometer. Bränsledelen visar det distansberoende bidraget. Slutpunkten är den totala kostnaden per kilometer.', list: ['Testa en försiktig och en optimistisk värdeminskning.', 'Jämför fordon med samma årliga sträcka och valuta.', 'Byt efter några månader ut uppskattningar mot egna uppgifter.', 'Kontrollera månads- och årssumman mot din verkliga budget.'], decisionTitle: 'Jämför antaganden för att fatta beslut', decisionText: 'En jämförelse fungerar bara när scenarierna använder samma period och regler. Ändra en sak i taget när du undersöker ett köp eller en vanlig rutt.', tipTitle: 'Det är en planeringsmodell, inte en offert', tipText: 'Kalkylatorn hämtar inte marknadspriser, intygar inte ersättningar och känner inte till framtida andrahandsvärden. Den gör dina antaganden tydliga.'
+  }),
+});

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

@@ -0,0 +1,30 @@
+import type { FAQItem, HowToStep } from '../../../types';
+import { createVehicleCostContent, createVehicleCostSeo } from './factory';
+import type { VehicleTotalCostPerKilometreCalculatorUI } from '../ui';
+
+const ui: VehicleTotalCostPerKilometreCalculatorUI = {
+  presetLabel: 'Gerçekçi bir profille başlayın', presetCity: 'Çoğunlukla şehir', presetBalanced: 'Karma sürüş', presetLongDistance: 'Uzun mesafe', resetLabel: 'Değerleri sıfırla',
+  primaryScenarioLabel: 'Aracınız', comparisonScenarioLabel: 'İkinci senaryo', distanceLabel: 'Yıllık mesafe', distanceHint: 'Bir yılda gitmeyi beklediğiniz mesafeyi kullanın', fuelUseLabel: 'Yakıt tüketimi', fuelUseHint: 'Aracınızın 100 km başına litre cinsinden ortalaması', fuelPriceLabel: 'Yakıt fiyatı', fuelPriceHint: 'Litre başına ödenen fiyat', insuranceLabel: 'Yıllık sigorta', insuranceHint: 'Gerçek yıllık priminiz', maintenanceLabel: 'Yıllık bakım', maintenanceHint: 'Servis, onarım, lastik ve kontroller', taxLabel: 'Yıllık vergi ve ücretler', taxHint: 'Motorlu taşıt vergisi, tescil ve düzenli ücretler', depreciationLabel: 'Yıllık değer kaybı', depreciationHint: 'Aracın bir yılda kaybettiği tahmini değer', currencyLabel: 'Para birimi', compareLabel: 'Başka senaryoyla karşılaştır', compareOnLabel: 'Karşılaştırma açık', compareOffLabel: 'Karşılaştırma ekle', removeComparisonLabel: 'Karşılaştırmayı gizle', resultLabel: 'Maliyet yolu', resultTitle: 'Her kilometrenin gerçek maliyeti', resultSceneLabel: 'Bir yol, sabit sahiplik maliyetlerini ve yakıt maliyetlerini kilometre başı maliyete bağlar', costPerKmLabel: 'Kilometre başı maliyet', monthlyCostLabel: 'Aylık ortalama', annualCostLabel: 'Tam yıl', fuelCostLabel: 'Yıllık yakıt', fixedCostLabel: 'Sabit ve sahiplik maliyetleri', statusBalanced: 'Maliyetler yola dengeli dağılıyor', statusFixedHeavy: 'Sahiplik maliyetleri daha büyük paya sahip', statusRunningHeavy: 'Yakıt maliyetleri daha büyük paya sahip', validationError: 'Pozitif bir yıllık mesafe ve negatif olmayan maliyetler girin.', comparisonTitle: 'Senaryo karşılaştırması', comparisonPrimaryCheaper: 'Aracınız şu kadar daha ucuz', comparisonSecondaryCheaper: 'İkinci senaryo şu kadar daha ucuz', comparisonSame: 'İki senaryonun maliyeti yaklaşık aynı', fixedLaneLabel: 'Sabit', fuelLaneLabel: 'Yakıt', totalLaneLabel: 'Toplam', formulaLabel: 'Hesaplama', formulaText: 'Yıllık maliyet = yıllık mesafe × tüketim ÷ 100 × yakıt fiyatı + sigorta + bakım + vergiler + değer kaybı. Kilometre başı maliyet = yıllık maliyet ÷ yıllık mesafe.', inputUnitDistance: 'km', inputUnitFuelUse: 'L / 100 km', inputUnitFuelPrice: '/ L', inputUnitAnnualCost: '/ yıl', outputUnitDistance: 'km',
+};
+
+const faq: FAQItem[] = [
+  { question: 'Bu kilometre başı maliyet hesaplayıcısı neleri içerir?', answer: 'Yakıtı; sigorta, bakım, vergi ve ücretler ile aracın yıl içinde kaybetmesini beklediğiniz değeri birleştirir. Kendi verilerinizi girersiniz.' },
+  { question: 'Sonuç neden yakıt hesaplayıcısından daha yüksek?', answer: 'Yakıt yalnızca değişken bölümdür. Sigorta, onarım, yıllık ücretler ve amortisman da her kilometreye paylaştırılır.' },
+  { question: 'Değer kaybını nasıl tahmin etmeliyim?', answer: 'Yıl sonunda beklenen değeri başlangıç değerinden çıkarın. İkinci el değeri belirsizse düşük ve yüksek bir senaryo deneyin.' },
+  { question: 'İki aracı karşılaştırabilir miyim?', answer: 'Evet. Karşılaştırmayı açın ve iki senaryoda aynı yıllık mesafeyi, dönemi ve para birimini kullanın.' },
+  { question: 'Sonuç gelecekteki yolculuğun kesin maliyetini tahmin eder mi?', answer: 'Hayır. Bu bir planlama tahminidir. Fiyatlar, onarımlar, mesafe ve yeniden satış değeri değişebilir.' },
+];
+
+const howTo: HowToStep[] = [
+  { name: 'Yıllık mesafeyi belirleyin', text: 'Bir yılda gitmeyi beklediğiniz kilometreyi girin.' },
+  { name: 'Yakıt varsayımlarını ekleyin', text: '100 kilometrede tüketimi ve litre fiyatını yazın.' },
+  { name: 'Sahiplik maliyetlerini ekleyin', text: 'Sigorta, bakım, vergi, ücretler ve değer kaybını ekleyin.' },
+  { name: 'Sonucu okuyun veya karşılaştırın', text: 'Kilometre başı maliyeti kullanın ve sabit maliyet ile yakıt payını inceleyin.' },
+];
+
+export const content = createVehicleCostContent({
+  locale: 'tr', slug: 'arac-kilometre-basina-toplam-maliyet-hesaplayici', title: 'Araç Kilometre Başına Toplam Maliyet Hesaplayıcısı', description: 'Yakıt, sahiplik maliyetleri ve yıllık mesafeyi birleştirerek aracın gerçek kilometre başı maliyetini hesaplayın.', faqTitle: 'Sık sorulan sorular', bibliographyTitle: 'Bibliyografik kaynaklar', ui, faq, howTo,
+  seo: createVehicleCostSeo({
+    introTitle: 'Her kilometrenin arkasındaki gizli maliyeti görün', introA: 'Tek başına yakıt fiyatı bir aracı kullanmanın gerçek maliyetini göstermez. Sigorta, bakım, lastikler, vergiler ve aracın kaybettiği değer de karara dahildir. Bu hesaplayıcı yıllık maliyetleri beklenen mesafeye dağıtır ve yakıt faturasıyla birlikte gösterir.', introB: 'Genel bir ortalamaya güvenmek yerine kendi değerlerinizi girin. Ana sonuç kilometre başı maliyettir; aylık ve yıllık toplamlar ile sabit maliyet ve yakıtın görsel dağılımı da verilir.', costsTitle: 'Tahmine hangi maliyetleri eklemeli', costsText: 'Yakıt mesafeyle değişir. Sigorta, bakım, ücretler ve değer kaybı yıllık tutarlar olarak girilir. Yıllık mesafe düşükse sabit maliyet kilometre başına daha ağır olur.', costsHeaders: ['Girdi', 'Hesaplayıcıdaki kullanımı', 'Kontrol edilecek'], costsRows: [['Yıllık mesafe', 'Yıllık toplamı kilometrelere böler', 'Gerçekçi bir mesafe kullanın'], ['Tüketim ve fiyat', 'Değişken yakıt maliyetini oluşturur', 'İki senaryoda aynı temeli kullanın'], ['Sigorta, bakım ve vergiler', 'Düzenli yıllık maliyetleri ekler', 'Lastikleri ve kontrolleri unutmayın'], ['Değer kaybı', 'Yıllık amortisman ekler', 'Birden fazla yeniden satış değeri deneyin']], readTitle: 'Maliyet yolunu okuyun', readText: 'Sabit bölüm her kilometreyle doğrudan artmayan maliyetleri gösterir. Yakıt bölümü mesafeye duyarlı kısmı gösterir. Son nokta karşılaştırılacak tüm kilometre başı maliyettir.', list: ['Belirsiz yeniden satış değeri için temkinli ve iyimser iki tahmin deneyin.', 'Araçları aynı yıllık mesafe ve para birimiyle karşılaştırın.', 'Birkaç ay sonra tahminleri kendi kayıtlarınızla değiştirin.', 'Aylık ve yıllık toplamların gerçek bütçenize uyup uymadığını kontrol edin.'], decisionTitle: 'Karar vermek için varsayımları karşılaştırın', decisionText: 'Karşılaştırma, iki senaryo aynı sahiplik dönemini ve kuralları kullandığında anlamlıdır. Bir satın alma veya düzenli rota incelerken her seferinde tek bir varsayımı değiştirin.', tipTitle: 'Bu bir planlama modelidir, teklif değildir', tipText: 'Hesaplayıcı piyasa fiyatlarına bakmaz, yasal giderleri onaylamaz ve gelecekteki yeniden satış değerini bilemez. Kendi varsayımlarınızı şeffaflaştırır.'
+  }),
+});

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

@@ -0,0 +1,30 @@
+import type { FAQItem, HowToStep } from '../../../types';
+import { createVehicleCostContent, createVehicleCostSeo } from './factory';
+import type { VehicleTotalCostPerKilometreCalculatorUI } from '../ui';
+
+const ui: VehicleTotalCostPerKilometreCalculatorUI = {
+  presetLabel: '从真实模式开始', presetCity: '主要城市道路', presetBalanced: '混合驾驶', presetLongDistance: '长途驾驶', resetLabel: '重置数值',
+  primaryScenarioLabel: '你的车辆', comparisonScenarioLabel: '第二个方案', distanceLabel: '每年行驶距离', distanceHint: '输入预计一年行驶的距离', fuelUseLabel: '燃油消耗', fuelUseHint: '车辆平均每100公里的升数', fuelPriceLabel: '燃油价格', fuelPriceHint: '每升支付的价格', insuranceLabel: '每年保险', insuranceHint: '实际年度保费', maintenanceLabel: '每年维护', maintenanceHint: '保养、维修、轮胎和检查', taxLabel: '每年税费', taxHint: '道路税、登记费和固定费用', depreciationLabel: '每年价值损失', depreciationHint: '估计车辆一年中损失的价值', currencyLabel: '货币', compareLabel: '比较另一个方案', compareOnLabel: '比较已开启', compareOffLabel: '添加比较', removeComparisonLabel: '隐藏比较', resultLabel: '成本之路', resultTitle: '每一公里真正的成本', resultSceneLabel: '道路展示固定拥有成本和燃油成本如何汇合为每公里成本', costPerKmLabel: '每公里成本', monthlyCostLabel: '月平均', annualCostLabel: '全年合计', fuelCostLabel: '每年燃油', fixedCostLabel: '固定和拥有成本', statusBalanced: '成本均匀分布在道路上', statusFixedHeavy: '拥有成本占主要部分', statusRunningHeavy: '燃油成本占主要部分', validationError: '请输入正数的年度距离，并且成本不能为负数。', comparisonTitle: '方案比较', comparisonPrimaryCheaper: '你的车辆便宜', comparisonSecondaryCheaper: '第二个方案便宜', comparisonSame: '两个方案的成本大致相同', fixedLaneLabel: '固定', fuelLaneLabel: '燃油', totalLaneLabel: '合计', formulaLabel: '计算方式', formulaText: '年度成本 = 年度距离 × 燃油消耗 ÷ 100 × 燃油价格 + 保险 + 维护 + 税费 + 价值损失。每公里成本 = 年度成本 ÷ 年度距离。', inputUnitDistance: 'km', inputUnitFuelUse: 'L / 100 km', inputUnitFuelPrice: '/ L', inputUnitAnnualCost: '/ 年', outputUnitDistance: 'km',
+};
+
+const faq: FAQItem[] = [
+  { question: '这款每公里成本计算器包含哪些费用？', answer: '它将燃油、保险、维护、税费以及车辆一年中的预计价值损失合并计算。你可以输入自己的车辆数据。' },
+  { question: '为什么结果高于燃油成本计算器？', answer: '燃油只是随距离变化的部分。保险、维修、年度费用和折旧也需要分摊到每公里。' },
+  { question: '应该如何估计折旧？', answer: '用起始价值减去一年后的预计价值。如果转售价值不确定，可以分别测试低值和高值方案。' },
+  { question: '可以比较两辆车吗？', answer: '可以。开启比较，并为两个方案使用相同的年度距离、周期和货币。' },
+  { question: '结果会预测未来旅程的准确费用吗？', answer: '不会。这是规划估算。价格、维修、距离和转售价值都可能变化。' },
+];
+
+const howTo: HowToStep[] = [
+  { name: '设定年度距离', text: '输入预计一年行驶的公里数。' },
+  { name: '添加燃油假设', text: '输入每100公里的消耗量和每升价格。' },
+  { name: '添加拥有成本', text: '输入保险、维护、税费和年度价值损失。' },
+  { name: '阅读或比较结果', text: '使用每公里成本作为主要比较值，并检查固定成本与燃油成本的比例。' },
+];
+
+export const content = createVehicleCostContent({
+  locale: 'zh', slug: 'vehicle-total-cost-per-kilometre-calculator', title: '车辆每公里总成本计算器', description: '结合燃油、拥有成本和年度距离，计算车辆每公里的真实使用成本。', faqTitle: '常见问题', bibliographyTitle: '参考资料', ui, faq, howTo,
+  seo: createVehicleCostSeo({
+    introTitle: '看见每一公里背后的隐藏成本', introA: '燃油价格本身无法说明使用车辆的真实成本。保险、保养、轮胎、税费以及车辆拥有期间损失的价值也会影响决策。本计算器把年度成本按预计行驶距离分摊，并和燃油账单放在一起。', introB: '输入自己的车辆数据，而不是依赖通用平均值。主要结果是每公里成本，同时提供月度和年度合计，以及固定拥有成本和燃油成本的可视化拆分。', costsTitle: '估算中应包括哪些成本', costsText: '燃油会随着距离变化，而保险、维护、费用和折旧以年度金额输入。年度距离较短时，固定成本会让每公里价格更高。', costsHeaders: ['输入', '计算方式', '需要检查'], costsRows: [['年度距离', '把年度总额分摊到每公里', '使用合理的距离'], ['消耗量和价格', '生成可变燃油成本', '两个方案使用相同基础'], ['保险、维护和税费', '加入固定年度成本', '不要忘记轮胎和检查'], ['价值损失', '加入年度折旧估算', '测试多个转售价值']], readTitle: '如何阅读成本之路', readText: '固定部分展示不会随每公里直接增加的费用。燃油部分展示对距离敏感的费用。终点数值就是用于比较的完整每公里成本。', list: ['当转售价值不确定时，测试保守和乐观两种折旧。', '使用相同年度距离和货币比较车辆。', '几个月后用真实记录替换估算值。', '检查月度和年度合计是否符合真实预算。'], decisionTitle: '比较假设，帮助做决定', decisionText: '只有当两个方案使用相同的拥有周期和规则时，比较才有意义。研究购车或固定路线时，一次只改变一个假设。', tipTitle: '这是规划模型，不是报价', tipText: '计算器不会查询市场价格，不会证明法律费用，也不知道未来转售价值。它的作用是让你的假设透明可比。'
+  }),
+});

package/src/tool/vehicleTotalCostPerKilometreCalculator/index.ts

@@ -0,0 +1,10 @@
+import { vehicleTotalCostPerKilometreCalculator } from './entry';
+
+export * from './entry';
+
+export const VEHICLE_TOTAL_COST_PER_KILOMETRE_CALCULATOR_TOOL = {
+  entry: vehicleTotalCostPerKilometreCalculator,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/vehicleTotalCostPerKilometreCalculator/logic.test.ts

@@ -0,0 +1,63 @@
+import { describe, expect, it } from 'vitest';
+import { calculateVehicleCost, compareVehicleCosts, convertCurrencyAmount, convertVehicleCostInput, validateVehicleCostInput, type VehicleCostInput } from './logic';
+
+const example: VehicleCostInput = {
+  annualKm: 15000,
+  fuelUsePer100Km: 6,
+  fuelPrice: 1.8,
+  insurance: 600,
+  maintenance: 500,
+  tax: 200,
+  depreciation: 2400,
+};
+
+describe('vehicle total cost per kilometre logic', () => {
+  it('calculates fuel, fixed and total costs', () => {
+    const result = calculateVehicleCost(example);
+    expect(result).not.toBeNull();
+    expect(result?.annualFuelLitres).toBe(900);
+    expect(result?.annualFuelCost).toBe(1620);
+    expect(result?.fixedCost).toBe(3700);
+    expect(result?.annualCost).toBe(5320);
+    expect(result?.monthlyCost).toBeCloseTo(443.3333);
+    expect(result?.costPerKm).toBeCloseTo(0.3546667);
+  });
+
+  it('rejects zero distance and negative costs', () => {
+    expect(validateVehicleCostInput({ ...example, annualKm: 0 }).valid).toBe(false);
+    expect(validateVehicleCostInput({ ...example, tax: -1 }).valid).toBe(false);
+    expect(calculateVehicleCost({ ...example, fuelPrice: Number.NaN })).toBeNull();
+  });
+
+  it('handles a zero cost scenario without dividing by zero', () => {
+    const result = calculateVehicleCost({ annualKm: 1000, fuelUsePer100Km: 0, fuelPrice: 0, insurance: 0, maintenance: 0, tax: 0, depreciation: 0 });
+    expect(result?.annualCost).toBe(0);
+    expect(result?.costPerKm).toBe(0);
+    expect(result?.fixedShare).toBe(0);
+  });
+
+  it('identifies the cheaper scenario by cost per kilometre', () => {
+    const cheaper = compareVehicleCosts(example, { ...example, annualKm: 20000 });
+    expect(cheaper?.cheaper).toBe('secondary');
+    expect(cheaper?.differencePerKm).toBeLessThan(0);
+  });
+
+  it('returns same when the costs are effectively equal', () => {
+    const same = compareVehicleCosts(example, { ...example });
+    expect(same?.cheaper).toBe('same');
+    expect(same?.differencePerKm).toBe(0);
+  });
+
+  it('converts monetary inputs while keeping distance and consumption unchanged', () => {
+    const converted = convertVehicleCostInput(example, 'EUR', 'JPY');
+    expect(converted.annualKm).toBe(example.annualKm);
+    expect(converted.fuelUsePer100Km).toBe(example.fuelUsePer100Km);
+    expect(converted.fuelPrice).toBeCloseTo(convertCurrencyAmount(example.fuelPrice, 'EUR', 'JPY'));
+    expect(converted.insurance).toBeCloseTo(111552);
+  });
+
+  it('uses the shared currency ratios for rubles and yuan', () => {
+    expect(convertCurrencyAmount(100, 'EUR', 'RUB')).toBeCloseTo(9673);
+    expect(convertCurrencyAmount(100, 'EUR', 'CNY')).toBeCloseTo(782.51);
+  });
+});

package/src/tool/vehicleTotalCostPerKilometreCalculator/logic.ts

@@ -0,0 +1,132 @@
+export interface VehicleCostInput {
+  annualKm: number;
+  fuelUsePer100Km: number;
+  fuelPrice: number;
+  insurance: number;
+  maintenance: number;
+  tax: number;
+  depreciation: number;
+}
+
+export interface CurrencyOption {
+  code: string;
+  symbol: string;
+  name: string;
+  unitsPerEur: number;
+}
+
+export const CURRENCY_OPTIONS = [
+  { code: 'EUR', symbol: '€', name: 'Euro', unitsPerEur: 1 },
+  { code: 'USD', symbol: '$', name: 'US dollar', unitsPerEur: 1.1643 },
+  { code: 'GBP', symbol: '£', name: 'Pound sterling', unitsPerEur: 0.8572 },
+  { code: 'JPY', symbol: '¥', name: 'Japanese yen', unitsPerEur: 185.92 },
+  { code: 'CNY', symbol: 'CN¥', name: 'Chinese yuan', unitsPerEur: 7.8251 },
+  { code: 'RUB', symbol: '₽', name: 'Russian ruble', unitsPerEur: 96.73 },
+  { code: 'INR', symbol: '₹', name: 'Indian rupee', unitsPerEur: 111.0585 },
+  { code: 'BRL', symbol: 'R$', name: 'Brazilian real', unitsPerEur: 6.0126 },
+  { code: 'MXN', symbol: 'MX$', name: 'Mexican peso', unitsPerEur: 19.7327 },
+  { code: 'CAD', symbol: 'CA$', name: 'Canadian dollar', unitsPerEur: 1.613 },
+  { code: 'AUD', symbol: 'A$', name: 'Australian dollar', unitsPerEur: 1.6183 },
+  { code: 'CHF', symbol: 'CHF', name: 'Swiss franc', unitsPerEur: 0.9364 },
+  { code: 'SEK', symbol: 'kr', name: 'Swedish krona', unitsPerEur: 11.0885 },
+  { code: 'PLN', symbol: 'zł', name: 'Polish zloty', unitsPerEur: 4.3365 },
+  { code: 'TRY', symbol: '₺', name: 'Turkish lira', unitsPerEur: 56.1718 },
+  { code: 'KRW', symbol: '₩', name: 'South Korean won', unitsPerEur: 1600.39 },
+  { code: 'IDR', symbol: 'Rp', name: 'Indonesian rupiah', unitsPerEur: 20628.08 },
+] as const;
+
+export type CurrencyCode = typeof CURRENCY_OPTIONS[number]['code'];
+
+export const DEFAULT_CURRENCY: CurrencyCode = 'EUR';
+
+export function isCurrencyCode(value: unknown): value is CurrencyCode {
+  return typeof value === 'string' && CURRENCY_OPTIONS.some((option) => option.code === value);
+}
+
+export function getCurrencyOption(code: CurrencyCode): CurrencyOption {
+  return CURRENCY_OPTIONS.find((option) => option.code === code) ?? CURRENCY_OPTIONS[0]!;
+}
+
+export function convertCurrencyAmount(amount: number, from: CurrencyCode, to: CurrencyCode): number {
+  const fromFactor = getCurrencyOption(from).unitsPerEur;
+  const toFactor = getCurrencyOption(to).unitsPerEur;
+  return (amount / fromFactor) * toFactor;
+}
+
+export function convertVehicleCostInput(input: VehicleCostInput, from: CurrencyCode, to: CurrencyCode): VehicleCostInput {
+  if (from === to) return { ...input };
+  return {
+    ...input,
+    fuelPrice: convertCurrencyAmount(input.fuelPrice, from, to),
+    insurance: convertCurrencyAmount(input.insurance, from, to),
+    maintenance: convertCurrencyAmount(input.maintenance, from, to),
+    tax: convertCurrencyAmount(input.tax, from, to),
+    depreciation: convertCurrencyAmount(input.depreciation, from, to),
+  };
+}
+
+export interface VehicleCostResult {
+  annualFuelLitres: number;
+  annualFuelCost: number;
+  fixedCost: number;
+  annualCost: number;
+  monthlyCost: number;
+  costPerKm: number;
+  fixedShare: number;
+  runningShare: number;
+}
+
+export interface VehicleCostComparison {
+  primary: VehicleCostResult;
+  secondary: VehicleCostResult;
+  differencePerKm: number;
+  cheaper: 'primary' | 'secondary' | 'same';
+}
+
+export interface VehicleCostValidation {
+  valid: boolean;
+  errors: string[];
+}
+
+const nonNegativeFields: Array<keyof VehicleCostInput> = ['fuelUsePer100Km', 'fuelPrice', 'insurance', 'maintenance', 'tax', 'depreciation'];
+
+export function validateVehicleCostInput(input: VehicleCostInput): VehicleCostValidation {
+  const errors: string[] = [];
+  if (!Number.isFinite(input.annualKm) || input.annualKm <= 0) errors.push('annualKm');
+  nonNegativeFields.forEach((field) => {
+    if (!Number.isFinite(input[field]) || input[field] < 0) errors.push(field);
+  });
+  return { valid: errors.length === 0, errors };
+}
+
+export function calculateVehicleCost(input: VehicleCostInput): VehicleCostResult | null {
+  if (!validateVehicleCostInput(input).valid) return null;
+  const annualFuelLitres = input.annualKm * input.fuelUsePer100Km / 100;
+  const annualFuelCost = annualFuelLitres * input.fuelPrice;
+  const fixedCost = input.insurance + input.maintenance + input.tax + input.depreciation;
+  const annualCost = fixedCost + annualFuelCost;
+  return {
+    annualFuelLitres,
+    annualFuelCost,
+    fixedCost,
+    annualCost,
+    monthlyCost: annualCost / 12,
+    costPerKm: annualCost / input.annualKm,
+    fixedShare: annualCost === 0 ? 0 : fixedCost / annualCost,
+    runningShare: annualCost === 0 ? 0 : annualFuelCost / annualCost,
+  };
+}
+
+export function compareVehicleCosts(primaryInput: VehicleCostInput, secondaryInput: VehicleCostInput): VehicleCostComparison | null {
+  const primary = calculateVehicleCost(primaryInput);
+  const secondary = calculateVehicleCost(secondaryInput);
+  if (!primary || !secondary) return null;
+  const differencePerKm = secondary.costPerKm - primary.costPerKm;
+  const cheaper = getCheaperScenario(differencePerKm);
+  return { primary, secondary, differencePerKm, cheaper };
+}
+
+function getCheaperScenario(differencePerKm: number): 'primary' | 'secondary' | 'same' {
+  if (Math.abs(differencePerKm) < 0.0001) return 'same';
+  return differencePerKm > 0 ? 'primary' : 'secondary';
+}

package/src/tool/vehicleTotalCostPerKilometreCalculator/seo.astro

@@ -0,0 +1,15 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { vehicleTotalCostPerKilometreCalculator } from './entry';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'en' } = Astro.props;
+const loader = vehicleTotalCostPerKilometreCalculator.i18n[locale] ?? vehicleTotalCostPerKilometreCalculator.i18n.en;
+const content = await loader?.();
+---
+
+{content && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/vehicleTotalCostPerKilometreCalculator/storage.ts

@@ -0,0 +1,38 @@
+import { DEFAULT_CURRENCY, isCurrencyCode, type CurrencyCode, type VehicleCostInput } from './logic';
+
+export interface VehicleCostStorageState {
+  primary: VehicleCostInput;
+  secondary: VehicleCostInput;
+  comparisonEnabled: boolean;
+  currency: CurrencyCode;
+}
+
+function normalizeCurrency(value: unknown, fallback: CurrencyCode): CurrencyCode {
+  if (isCurrencyCode(value)) return value;
+  const legacySymbols: Record<string, CurrencyCode> = { '€': 'EUR', '$': 'EUR', '£': 'EUR' };
+  return typeof value === 'string' && legacySymbols[value] ? legacySymbols[value] : fallback;
+}
+
+export function loadVehicleCostState(key: string, fallback: VehicleCostStorageState): VehicleCostStorageState {
+  if (typeof window === 'undefined') return fallback;
+  try {
+    const raw = window.localStorage.getItem(key);
+    if (!raw) return fallback;
+    const parsed = JSON.parse(raw) as Partial<VehicleCostStorageState>;
+    if (!parsed.primary || !parsed.secondary) return fallback;
+    return {
+      ...fallback,
+      ...parsed,
+      currency: normalizeCurrency(parsed.currency, fallback.currency ?? DEFAULT_CURRENCY),
+    };
+  } catch {
+    return fallback;
+  }
+}
+
+export function saveVehicleCostState(key: string, state: VehicleCostStorageState): void {
+  if (typeof window === 'undefined') return;
+  try {
+    window.localStorage.setItem(key, JSON.stringify(state));
+  } catch {}
+}

package/src/tool/vehicleTotalCostPerKilometreCalculator/ui.ts

@@ -0,0 +1,54 @@
+export interface VehicleTotalCostPerKilometreCalculatorUI extends Record<string, string> {
+  presetLabel: string;
+  presetCity: string;
+  presetBalanced: string;
+  presetLongDistance: string;
+  resetLabel: string;
+  primaryScenarioLabel: string;
+  comparisonScenarioLabel: string;
+  distanceLabel: string;
+  distanceHint: string;
+  fuelUseLabel: string;
+  fuelUseHint: string;
+  fuelPriceLabel: string;
+  fuelPriceHint: string;
+  insuranceLabel: string;
+  insuranceHint: string;
+  maintenanceLabel: string;
+  maintenanceHint: string;
+  taxLabel: string;
+  taxHint: string;
+  depreciationLabel: string;
+  depreciationHint: string;
+  currencyLabel: string;
+  compareLabel: string;
+  compareOnLabel: string;
+  compareOffLabel: string;
+  removeComparisonLabel: string;
+  resultLabel: string;
+  resultTitle: string;
+  resultSceneLabel: string;
+  costPerKmLabel: string;
+  monthlyCostLabel: string;
+  annualCostLabel: string;
+  fuelCostLabel: string;
+  fixedCostLabel: string;
+  statusBalanced: string;
+  statusFixedHeavy: string;
+  statusRunningHeavy: string;
+  validationError: string;
+  comparisonTitle: string;
+  comparisonPrimaryCheaper: string;
+  comparisonSecondaryCheaper: string;
+  comparisonSame: string;
+  fixedLaneLabel: string;
+  fuelLaneLabel: string;
+  totalLaneLabel: string;
+  formulaLabel: string;
+  formulaText: string;
+  inputUnitDistance: string;
+  inputUnitFuelUse: string;
+  inputUnitFuelPrice: string;
+  inputUnitAnnualCost: string;
+  outputUnitDistance: string;
+}