@jjlmoya/utils-home 1.35.0 → 1.36.0

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

@@ -0,0 +1,222 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { WaterSoftenerUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'su-yumusatici-hesaplayici';
+const title = 'Ev su yumuşatıcı ve tuz tüketimi optimizasyonu';
+const description =
+  'Su sertliği seviyenizi analiz edin, optimum yumuşatıcı ayarlarını hesaplayın ve yıllık tuz tüketimini tahmin edin. Kireç etkisi tahminlerini, tuz dolum zaman çizelgelerini ve cihaz ömür tahminlerini tek bir etkileşimli araçta görün.';
+
+const faqData = [
+  {
+    question: 'Su sertliği nedir?',
+    answer:
+      'Su sertliği, musluk suyunuzda çözünmüş kalsiyum ve magnezyum minerallerinin konsantrasyonudur. Gallon başına grain veya Fransız derecesi olarak ölçülür. Sert su borularda kireç birikimine neden olur, ısıtma verimliliğini düşürür ve cihaz ömrünü kısaltır.',
+  },
+  {
+    question: 'Su yumuşatıcı nasıl çalışır?',
+    answer:
+      'Bir su yumuşatıcı, iyon değişim reçinesi boncukları kullanarak kalsiyum ve magnezyum iyonlarını sodyum iyonlarıyla değiştirir. Reçine doygun hale geldiğinde, sistem bir tuzlu su çözeltisi ile tankı yıkayarak yenilenir; boncukları eski haline getirir ve sert mineralleri tahliye eder.',
+  },
+  {
+    question: 'Bir yumuşatıcı yılda ne kadar tuz kullanır?',
+    answer:
+      'Orta sertlikte suyu olan tipik dört kişilik bir hane yılda 80 ila 120 kilogram tuz kullanır. Çok sert su veya daha büyük haneler bu miktarı 200 kilogramın üzerine çıkarabilir. Modern yüksek verimli yumuşatıcılar eski modellere göre yaklaşık yüzde 30 daha az tuz kullanır.',
+  },
+  {
+    question: 'Tuz tankını ne sıklıkla doldurmalıyım?',
+    answer:
+      'Çoğu tuzlu su tankı 4 ila 8 haftada bir doldurulmalıdır. Tuz seviyesini aylık olarak kontrol edin. Tankın doluluk oranı üçte birin altına düşerse yeni bir 25 kilogramlık torba ekleyin. Tuzun tamamen bitmesine asla izin vermeyin; aksi takdirde reçine tekrar sertleşir ve etkinliğini kaybeder.',
+  },
+  {
+    question: 'Sert su gerçekten cihazlara zarar verir mi?',
+    answer:
+      'Evet. Isıtma elemanları üzerindeki kireç birikimleri onların daha çok çalışmasına neden olarak enerji faturalarını artırır ve erken arızalara yol açar. Çok sert su bulunan bir bölgedeki bir su ısıtıcısı beklenen ömrünün yüzde 45\'ine kadar kaybedebilir. Çamaşır makineleri ve bulaşık makineleri de tıkanmış valfler ve kireçlenmiş tamburlardan etkilenir.',
+  },
+  {
+    question: 'Yumuşatılmış su içilebilir mi?',
+    answer:
+      'Yumuşatılmış su çoğu insan için içmekte güvenlidir. Sodyum artışı küçüktür, kabaca günde bir dilim ekmekle eşdeğerdir. Ancak katı sodyum kısıtlı diyet uygulayan kişiler içme suyu için ayrı bir yumuşatılmamış musluk tercih edebilir veya potasyum bazlı bir yumuşatıcı tuzu seçebilir.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Su sertliğinizi girin',
+    text: 'Su kalitesi raporunuzdan veya test şeridinden sertlik değerini yazın. Birim seçiciden gallon başına grain veya Fransız derecesi seçin.',
+  },
+  {
+    name: 'Hane büyüklüğünü ayarlayın',
+    text: 'Evinizde yaşayan kişi sayısını seçin. Daha fazla kişi, daha yüksek su tüketimi ve daha hızlı tuz tüketimi anlamına gelir.',
+  },
+  {
+    name: 'Yumuşatıcı kapasitesini seçin',
+    text: 'Yumuşatıcı reçine tankının grain kapasitesini girin. Bu genellikle kontrol valfi veya kullanım kılavuzunda yazılıdır. Yaygın değerler 24.000 veya 32.000 graindir.',
+  },
+  {
+    name: 'Sertlik kategorisini inceleyin',
+    text: 'Suyunuzun yumuşak, orta sert veya aşırı sert olup olmadığını anlamak için etkileşimli sertlik ölçeğini okuyun.',
+  },
+  {
+    name: 'Tuz tahminini kontrol edin',
+    text: 'Yılda kaç adet 25 kilogramlık torbaya ihtiyacınız olacağını ve bir sonraki dolumun ne zaman yapılacağını görmek için torba yığını simülatörüne bakın.',
+  },
+  {
+    name: 'Cihaz etkisini inceleyin',
+    text: 'Çamaşır makinenizin, su ısıtıcınızın ve kahve makinenizin temel ömrünü, mevcut işlenmemiş suyunuzla tahmini ömürleriyle karşılaştırın.',
+  },
+];
+
+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) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'tr',
+};
+
+export const content: ToolLocaleContent<WaterSoftenerUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Sert Suyun Görünmeyen Maliyeti',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Sert su, bir evdeki en pahalı gizli sorunlardan biridir. Musluğu her açtığınızda çözünmüş mineraller borularınızdan ve cihazlarınızdan akar. Aylar ve yıllar boyunca bu mineraller kirece kristalleşir; borularda ısıtma elemanlarını tıkayan, akış hızını düşüren ve lastik contaları yok eden sert beyaz bir tabaka. Sonuç olarak daha yüksek enerji faturaları, kısalan cihaz ömrü ve sık bakım çağrılarıdır. Su yumuşatıcı bu hasarı kaynağında ortadan kaldırır.',
+    },
+    {
+      type: 'stats',
+      items: [
+        { value: '80kg', label: 'Yıllık Ortalama Tuz Kullanımı', icon: 'mdi:shaker-outline' },
+        { value: '11 yıl', label: 'Çamaşır Makinesi Temel Ömrü', icon: 'mdi:washing-machine' },
+        { value: '0,15', label: 'mm kireç/GPG/yıl', icon: 'mdi:water-check' },
+      ],
+      columns: 3,
+    },
+    {
+      type: 'title',
+      text: 'Kireç Neden Bu Kadar Zararlı',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Kireç, sadece çaydanlığınızdaki bir leke değildir. Bir su ısıtıcı içinde ısıtma elemanı üzerinde yalıtkan bir tabaka oluşturur. Her milimetre kireç için enerji transfer verimliliği yüzde 10\'a kadar düşer. Bu, 3 milimetrelik bir kaplamanın su ısıtma faturanızı yaklaşık yüzde 30 artırabileceği anlamına gelir. Çamaşır makinelerinde kireç deterjan aktivasyonunu engeller, böylece daha kötü sonuçlar için daha fazla toz kullanırsınız. Kahve makinelerinde termostata zarar verir ve acı, dengesiz ekstraksiyon üretir.',
+    },
+    {
+      type: 'comparative',
+      items: [
+        {
+          title: 'İşlenmemiş Sert Su',
+          description: 'Mineraller tesisat sisteminin tamamında ve her bağlı cihazda serbestçe birikir.',
+          icon: 'mdi:alert',
+          points: ['Isıtıcılarda ve kazanlarda hızlı kireç birikimi', 'Artan deterjan ve sabun tüketimi', 'Cihaz ömrünün yüzde 30 ila 45 oranında kısalması', 'Kirecin yalıtım etkisi nedeniyle daha yüksek enerji faturaları'],
+        },
+        {
+          title: 'Yumuşatılmış Su',
+          description: 'Kalsiyum ve magnezyum musluklara ve cihazlara ulaşmadan giriş noktasında çıkarılır.',
+          icon: 'mdi:check-circle',
+          points: ['Isıtma elemanları üzerinde sıfır kireç birikimi', 'Normal deterjan dozları daha iyi sonuç verir', 'Cihazlar tam tasarım ömürlerine ulaşır', 'Su ısıtma için daha düşük enerji tüketimi'],
+        },
+      ],
+      columns: 2,
+    },
+    {
+      type: 'diagnostic',
+      variant: 'info',
+      title: 'Hızlı Sert Su Kontrolü',
+      icon: 'mdi:clipboard-check',
+      badge: 'Eylem',
+      html: '<p style="margin:0">Şeffaf bir şişeyi musluk suyuyla doldurun ve birkaç damla sıvı sabun ekleyin. Şiddetle çalkalayın. Su bulanık kalıyor ve çok az köpük oluşturuyorsa suyunuz sert demektir. Kristal berraklığında su kalın ve sabit köpükle yumuşak suyu gösterir. Kesin bir ölçüm için toplam sertlik test şeridi kullanın veya su tedarikçinizden rapor talep edin.</p>',
+    },
+    {
+      type: 'title',
+      text: 'Tuz Tedariğinizi Doğru Boyutlandırma',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Tuzun bitmesi, bir yumuşatıcıyı mahvetmenin en hızlı yoludur. Tuzlu su tankı boşaldığında, reçine yatağı birkaç gün içinde tekrar sertleşir ve sistem evinizi korumayı bırakır. Yılda kaç adet 25 kilogramlık torba ihtiyacınız olduğunu tam olarak tahmin etmek için bu hesaplayıcıyı kullanın. Sonuç 10 torbadan fazlaysa, daha büyük kapasiteli bir reçine tankına veya rejenerasyon döngüsü başına daha az tuz kullanan yüksek verimli bir valfe geçmeyi düşünün.',
+    },
+    {
+      type: 'summary',
+      title: 'Evinizi Sert Suya Karşı Nasıl Korursunuz',
+      items: [
+        'Bu hesaplayıcıyı kullanarak tam su sertliği kategorinizi ve tuz ihtiyacınızı öğrenin.',
+        'Ana su hattı girişine doğru boyutta bir su yumuşatıcı kurun.',
+        'Tuzlu su tankı üçte birin altına düşmeden doldurun.',
+        'En iyi reçine performansı için yüksek saflıkta buharlaştırılmış tuz peletleri kullanın.',
+        'Valfi ve reçine yatağını her 3 ila 5 yılda bir servis ettirin.',
+        'Kireç birikimini işaret edebilecek ani artışlar için cihaz enerji faturalarını izleyin.',
+      ],
+    },
+  ],
+  ui: {
+    labelHardness: 'Su Sertliği',
+    unitGpg: 'GPG',
+    unitFH: 'fH',
+    labelOccupants: 'Hane Büyüklüğü',
+    unitPeople: 'kişi',
+    labelSoftenerCapacity: 'Yumuşatıcı Kapasitesi',
+    unitGrains: 'grain',
+    hardnessSoft: 'Yumuşak',
+    hardnessSlightly: 'Hafif Sert',
+    hardnessModerate: 'Orta Sert',
+    hardnessHard: 'Sert',
+    hardnessVery: 'Çok Sert',
+    hardnessExtreme: 'Aşırı Sert',
+    scaleTitle: 'Kireç Birikim Hızı',
+    scaleUnitMetric: 'mm/yıl',
+    scaleUnitImperial: 'in/yıl',
+    saltTitle: 'Yıllık Tuz Tahmini',
+    saltAnnual: 'Yıllık Tuz',
+    saltBags: 'Yıllık torba sayısı',
+    saltDaysPerBag: 'Torba başına gün',
+    saltWeeksPerBag: 'Torba başına hafta',
+    applianceTitle: 'Cihaz Ömrü',
+    applianceWasher: 'Çamaşır Makinesi',
+    applianceHeater: 'Su Isıtıcı',
+    applianceCoffee: 'Kahve Makinesi',
+    applianceBaseline: 'Yumuşatıcı ile',
+    applianceWithHardness: 'Sert su ile',
+    applianceSaved: 'yıl',
+    badgeSaved: 'Uzatma',
+    labelUnitSystem: 'Birimler',
+    btnMetric: 'Metrik',
+    btnImperial: 'İngiliz',
+  },
+};

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

@@ -0,0 +1,222 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { WaterSoftenerUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'water-softener';
+const title = '家用软水机与盐耗优化计算器';
+const description =
+  '分析您的水质硬度水平，计算最佳软水机设置并估算年度盐耗量。在这个交互式工具中查看水垢影响预测、盐补充时间表和电器寿命预测。';
+
+const faqData = [
+  {
+    question: '什么是水的硬度？',
+    answer:
+      '水的硬度是指自来水中的溶解钙和镁矿物质浓度。它以每加仑格令或法国度来测量。硬水会导致管道中形成水垢，降低加热效率并缩短电器寿命。',
+  },
+  {
+    question: '软水机是如何工作的？',
+    answer:
+      '软水机使用离子交换树脂珠将钙和镁离子替换为钠离子。当树脂饱和时，系统通过向水箱中冲洗盐水溶液来进行再生，恢复树脂珠并将硬矿物质排入下水道。',
+  },
+  {
+    question: '软水机每年使用多少盐？',
+    answer:
+      '一个典型的四口之家在中等硬度水质条件下每年使用80至120公斤盐。水质非常硬或家庭人数更多时，这一数值可能超过200公斤。现代高效软水机比旧型号少用约30%的盐。',
+  },
+  {
+    question: '我应该多久补充一次盐箱？',
+    answer:
+      '大多数盐水箱需要每4到8周补充一次。每月检查盐量。如果盐箱少于三分之一满，请添加一袋新的25公斤盐。切勿让盐完全耗尽，否则树脂会重新硬化并失去效力。',
+  },
+  {
+    question: '硬水真的会损坏电器吗？',
+    answer:
+      '是的。水垢沉积在加热元件上会迫使它们更努力地工作，从而增加能源费用并导致过早故障。在硬水非常严重的地区，热水器的预期寿命可能缩短多达45%。洗衣机和洗碗机也会因阀门堵塞和滚筒结垢而受损。',
+  },
+  {
+    question: '软化后的水可以饮用吗？',
+    answer:
+      '软化水对大多数人来说是安全可饮用的。钠含量的增加很小，大约相当于每天一片面包。然而，严格限制低钠饮食的人可能更倾向于使用单独的未软化水龙头作为饮用水，或选择基于钾的软水盐。',
+  },
+];
+
+const howToData = [
+  {
+    name: '输入您的水质硬度',
+    text: '从您的水质报告或测试条中输入硬度数值。在单位选择器中选择每加仑格令或法国度。',
+  },
+  {
+    name: '设置家庭人数',
+    text: '选择您家中居住的人数。居住人数越多，用水量越大，盐消耗也越快。',
+  },
+  {
+    name: '选择软水机容量',
+    text: '输入软水机树脂罐的格令容量。这通常印在控制阀或用户手册上。常见数值为24,000或32,000格令。',
+  },
+  {
+    name: '查看硬度类别',
+    text: '阅读交互式硬度标尺，了解您的水质属于软水、中等硬水还是极硬水。',
+  },
+  {
+    name: '查看盐消耗预测',
+    text: '查看盐袋堆叠模拟器，了解您每年需要多少袋25公斤盐以及下次补充的时间。',
+  },
+  {
+    name: '检查电器影响',
+    text: '将您的洗衣机、热水器和咖啡机的基准寿命与当前未处理硬水下的预估寿命进行比较。',
+  },
+];
+
+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) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'zh',
+};
+
+export const content: ToolLocaleContent<WaterSoftenerUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: '硬水的隐形成本',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '硬水是家庭中最昂贵的隐性烦恼之一。每次您打开水龙头，溶解的矿物质就会流经管道和电器。经过数月甚至数年，这些矿物质会结晶成水垢，一种坚硬的白色沉积物，堵塞加热元件、降低流量并破坏橡胶密封圈。结果是更高的能源费用、更短的电器寿命和频繁的维修电话。软水机可以从源头上消除这种损害。',
+    },
+    {
+      type: 'stats',
+      items: [
+        { value: '80kg', label: '年均盐耗量', icon: 'mdi:shaker-outline' },
+        { value: '11yr', label: '洗衣机基准寿命', icon: 'mdi:washing-machine' },
+        { value: '0.15', label: '每GPG每年水垢毫米数', icon: 'mdi:water-check' },
+      ],
+      columns: 3,
+    },
+    {
+      type: 'title',
+      text: '水垢为何具有如此大的破坏力',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '水垢不仅仅是水壶上的美观污渍。在热水器内部，它会在加热元件上形成隔热层。每增加一毫米水垢，热传递效率就会下降多达10%。这意味着三毫米的水垢涂层可能使您的热水费用增加近30%。在洗衣机中，水垢会阻碍洗涤剂活化，因此您需要使用更多洗衣粉却得到更差的效果。在咖啡机中，它会损坏温控器并产生苦涩、不均匀的萃取。',
+    },
+    {
+      type: 'comparative',
+      items: [
+        {
+          title: '未处理的硬水',
+          description: '矿物质在整个管道系统和每个连接的电器中自由沉积。',
+          icon: 'mdi:alert',
+          points: ['加热器和锅炉中快速形成水垢', '洗涤剂和肥皂用量增加', '电器寿命缩短30%至45%', '水垢的隔热效应导致能源费用更高'],
+        },
+        {
+          title: '软化后的水',
+          description: '钙和镁在进入点就被去除，不会到达水龙头和电器。',
+          icon: 'mdi:check-circle',
+          points: ['加热元件上无水垢沉积', '正常剂量的洗涤剂即可产生更好的效果', '电器达到其设计的完整使用寿命', '降低热水加热的能耗'],
+        },
+      ],
+      columns: 2,
+    },
+    {
+      type: 'diagnostic',
+      variant: 'info',
+      title: '快速硬水检测',
+      icon: 'mdi:clipboard-check',
+      badge: '操作',
+      html: '<p style="margin:0">用一个透明瓶子装满自来水，加入几滴液体肥皂。用力摇晃。如果水保持浑浊且产生的泡沫很少，说明您的水是硬水。清澈透明且有厚实稳定泡沫的水表示软水。要获得精确测量，请使用总硬度测试条或向您的水务供应商索取报告。</p>',
+    },
+    {
+      type: 'title',
+      text: '正确确定盐供应量',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '盐耗尽是毁坏软水机最快的方式。当盐水箱空了，树脂床会在几天内重新硬化，系统将停止保护您的家庭。使用此计算器精确预测您每年需要多少袋25公斤盐。如果结果超过10袋，请考虑升级到更大容量的树脂罐，或使用每个再生周期耗盐量更少的高效阀门。',
+    },
+    {
+      type: 'summary',
+      title: '如何保护您的家庭免受硬水侵害',
+      items: [
+        '使用此计算器查找您确切的水质硬度类别和盐需求量。',
+        '在主供水入口处安装尺寸合适的软水机。',
+        '在盐水箱降至三分之一以下之前进行补充。',
+        '使用高纯度蒸发盐颗粒以获得最佳的树脂性能。',
+        '每3至5年对阀门和树脂床进行维护。',
+        '监控电器能源费用是否突然增加，这可能预示着水垢堆积。',
+      ],
+    },
+  ],
+  ui: {
+    labelHardness: '水质硬度',
+    unitGpg: 'GPG',
+    unitFH: 'fH',
+    labelOccupants: '家庭人数',
+    unitPeople: '人',
+    labelSoftenerCapacity: '软水机容量',
+    unitGrains: '格令',
+    hardnessSoft: '软水',
+    hardnessSlightly: '微硬',
+    hardnessModerate: '中等硬度',
+    hardnessHard: '硬水',
+    hardnessVery: '很硬',
+    hardnessExtreme: '极硬',
+    scaleTitle: '水垢堆积速率',
+    scaleUnitMetric: '毫米/年',
+    scaleUnitImperial: '英寸/年',
+    saltTitle: '年度盐耗预测',
+    saltAnnual: '年度盐耗',
+    saltBags: '每年袋数',
+    saltDaysPerBag: '每袋天数',
+    saltWeeksPerBag: '每袋周数',
+    applianceTitle: '电器使用寿命',
+    applianceWasher: '洗衣机',
+    applianceHeater: '热水器',
+    applianceCoffee: '咖啡机',
+    applianceBaseline: '使用软水时',
+    applianceWithHardness: '使用硬水时',
+    applianceSaved: '年',
+    badgeSaved: '延长了',
+    labelUnitSystem: '单位制',
+    btnMetric: '公制',
+    btnImperial: '英制',
+  },
+};

package/src/tool/waterSoftener/index.ts

@@ -0,0 +1,9 @@
+import type { ToolDefinition } from '../../types';
+import { waterSoftener } from './entry';
+export * from './entry';
+export const WATER_SOFTENER_TOOL: ToolDefinition = {
+  entry: waterSoftener,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/waterSoftener/logic.ts

@@ -0,0 +1,103 @@
+export interface WaterSoftenerInput {
+  hardnessValue: number;
+  hardnessUnit: 'gpg' | 'fH';
+  occupants: number;
+  softenerGrains: number;
+}
+
+export interface HardnessCategory {
+  key: string;
+  label: string;
+  color: string;
+}
+
+export interface SaltResult {
+  annualSaltKg: number;
+  bagsPerYear: number;
+  daysPerBag: number;
+  weeksPerBag: number;
+}
+
+export interface ApplianceResult {
+  baseline: number;
+  withHardness: number;
+  saved: number;
+}
+
+export interface ScaleResult {
+  rateMmPerYear: number;
+}
+
+const CATEGORIES: HardnessCategory[] = [
+  { key: 'soft', label: 'Soft', color: '#60a5fa' },
+  { key: 'slightly', label: 'Slightly Hard', color: '#818cf8' },
+  { key: 'moderate', label: 'Moderately Hard', color: '#c084fc' },
+  { key: 'hard', label: 'Hard', color: '#f472b6' },
+  { key: 'very', label: 'Very Hard', color: '#fb923c' },
+  { key: 'extreme', label: 'Extremely Hard', color: '#9ca3af' },
+];
+
+export function toGpg(value: number, unit: 'gpg' | 'fH'): number {
+  return unit === 'fH' ? value * 0.584 : value;
+}
+
+export function getHardnessCategory(gpg: number): HardnessCategory {
+  if (gpg < 3.5) return CATEGORIES[0];
+  if (gpg < 7.0) return CATEGORIES[1];
+  if (gpg < 10.5) return CATEGORIES[2];
+  if (gpg < 14.0) return CATEGORIES[3];
+  if (gpg < 21.0) return CATEGORIES[4];
+  return CATEGORIES[5];
+}
+
+export function calculateScale(gpg: number): ScaleResult {
+  return { rateMmPerYear: Math.round(gpg * 0.15 * 10) / 10 };
+}
+
+export function calculateSalt(input: WaterSoftenerInput): SaltResult {
+  const gpg = toGpg(input.hardnessValue, input.hardnessUnit);
+  const dailyGallons = input.occupants * 80;
+  const dailyGrains = gpg * dailyGallons;
+  const annualGrains = dailyGrains * 365;
+  const regensPerYear = annualGrains / input.softenerGrains;
+  const saltLbPerRegen = input.softenerGrains / 3333;
+  const annualSaltLb = regensPerYear * saltLbPerRegen;
+  const annualSaltKg = Math.round(annualSaltLb * 0.4536 * 10) / 10;
+  const bagsPerYear = annualSaltKg / 25;
+  const daysPerBag = bagsPerYear > 0 ? 365 / bagsPerYear : 0;
+  return {
+    annualSaltKg,
+    bagsPerYear: Math.round(bagsPerYear * 10) / 10,
+    daysPerBag: Math.round(daysPerBag),
+    weeksPerBag: Math.round(daysPerBag / 7 * 10) / 10,
+  };
+}
+
+export function calculateApplianceLifespan(gpg: number): Record<string, ApplianceResult> {
+  const factor = Math.max(0, (gpg - 3.5) / 21);
+  const f = (base: number, loss: number) => {
+    const withH = Math.round(base * (1 - loss * factor) * 10) / 10;
+    return { baseline: base, withHardness: withH, saved: Math.round((base - withH) * 10) / 10 };
+  };
+  return {
+    washer: f(11, 0.35),
+    heater: f(12, 0.45),
+    coffee: f(6, 0.25),
+  };
+}
+
+export function mmToInches(mm: number): number {
+  return Math.round((mm / 25.4) * 100) / 100;
+}
+
+export function kgToLbs(kg: number): number {
+  return Math.round(kg * 2.20462 * 10) / 10;
+}
+
+export function fmt1(n: number): string {
+  return n.toFixed(1);
+}
+
+export function fmt2(n: number): string {
+  return n.toFixed(2);
+}

package/src/tool/waterSoftener/seo.astro

@@ -0,0 +1,15 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { waterSoftener } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await waterSoftener.i18n[locale]?.();
+if (!content) return null;
+---
+
+{content.seo?.length > 0 && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/waterSoftener/ui.ts

@@ -0,0 +1,34 @@
+export interface WaterSoftenerUI extends Record<string, string> {
+  labelHardness: string;
+  unitGpg: string;
+  unitFH: string;
+  labelOccupants: string;
+  unitPeople: string;
+  labelSoftenerCapacity: string;
+  unitGrains: string;
+  hardnessSoft: string;
+  hardnessSlightly: string;
+  hardnessModerate: string;
+  hardnessHard: string;
+  hardnessVery: string;
+  hardnessExtreme: string;
+  scaleTitle: string;
+  scaleUnitMetric: string;
+  scaleUnitImperial: string;
+  saltTitle: string;
+  saltAnnual: string;
+  saltBags: string;
+  saltDaysPerBag: string;
+  saltWeeksPerBag: string;
+  applianceTitle: string;
+  applianceWasher: string;
+  applianceHeater: string;
+  applianceCoffee: string;
+  applianceBaseline: string;
+  applianceWithHardness: string;
+  applianceSaved: string;
+  badgeSaved: string;
+  labelUnitSystem: string;
+  btnMetric: string;
+  btnImperial: string;
+}