@jjlmoya/utils-pets 1.5.0 → 1.7.0

package/src/category/i18n/ru.ts

@@ -0,0 +1,52 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'domashnie-zhivotnye',
+  title: 'Инструменты для Питомцев',
+  description: 'Бесплатные калькуляторы и утилиты для владельцев домашних животных. Узнайте реальный возраст вашей собаки или кошки и рассчитайте их дневной рацион с ветеринарной точностью.',
+  seo: [
+    { type: 'title', text: 'Питание и Благополучие Животных: Наука на Службе Вашего Питомца', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Забота о собаке, кошке или кролике — это гораздо больше, чем просто еда и ласка. Это требует понимания их биологии, ритма старения и специфических потребностей в энергии. В этом разделе мы предлагаем <strong>бесплатные ветеринарные калькуляторы</strong>, которые применяют проверенные научные формулы, чтобы помочь вам принимать более обоснованные решения в вопросах здоровья вашего спутника.',
+    },
+    {
+      type: 'paragraph',
+      html: 'От любопытства узнать, сколько человеческих лет на самом деле вашей собаке, до точного расчета дневного рациона на основе RER (Resting Energy Requirement) — наши инструменты превращают сложные ветеринарные концепции в четкие и практичные ответы для ответственного владельца домашнего животного.',
+    },
+    { type: 'title', text: 'Реальный Возраст Вашего Питомца: За Пределами Мифа об "Умножении на 7"', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Популярное убеждение, что один собачий год равен семи человеческим, десятилетиями опровергалось современной ветеринарной наукой. Реальность такова, что собаки взрослеют экспоненциально в первые два года жизни, достигая эквивалента 15 человеческих лет в 12 месяцев и 24 лет в возрасте 24 месяцев. После этого темп замедляется и во многом зависит от <strong>размера животного</strong>: гигантская собака весом более 45 кг может стареть на 60% быстрее, чем маленькая порода.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Кошки, с другой стороны, следуют более линейной кривой старения: после первых двух лет ускоренного развития каждый кошачий год примерно эквивалентен четырем человеческим годам. Знание этапа жизни вашего питомца — это не просто любопытство, это важная медицинская информация: она определяет, когда планировать гериатрические осмотры, когда корректировать диету и какие признаки здоровья следует контролировать.',
+    },
+    { type: 'title', text: 'Точное Питание: Рассчитайте Точный Дневной Рацион', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Ожирение затрагивает более 50% домашних животных в развитых странах и является прямой причиной проблем с суставами и сердечно-сосудистой системой, а также сокращения продолжительности жизни. Проблема не в отсутствии любви со стороны владельцев, а в <strong>отсутствии точных калорийных ориентиров</strong>. Наш калькулятор дневного рациона применяет стандартную ветеринарную формулу RER (70 × вес^0,75) и умножает ее на соответствующий коэффициент DER для вида вашего животного, этапа его жизни и уровня активности.',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Калькулятор Возраста Животных:</strong> Преобразует хронологические годы в человеческий эквивалент на основе вида и размера, с указанием этапа жизни и следующего ветеринарного рубежа.',
+        '<strong>Калькулятор Дневного Рациона:</strong> Рассчитывает граммы сухого и влажного корма на основе RER и DER для собак, кошек и кроликов.',
+      ],
+    },
+    {
+      type: 'tip',
+      title: 'Ветеринарный Совет',
+      html: 'Эти инструменты предоставляют научные ориентиры, но каждое животное уникально. Всегда консультируйтесь со своим ветеринаром, чтобы адаптировать диету и план здоровья к индивидуальным потребностям вашего питомца.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Инвестиции в знания о биологии вашего питомца — самая эффективная форма профилактической медицины. Здоровый вес и своевременная ветеринарная помощь могут добавить годы качественной жизни вашему верному спутнику. Научный подход к уходу гарантирует, что ваш питомец не просто выживет, но и преуспеет на каждом этапе своей жизни.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Важность индивидуального подхода невозможно переоценить. В мире, полном общих советов, наши калькуляторы обеспечивают прочную основу для персонализированного ухода за вашим питомцем. Используйте эти ресурсы, чтобы укрепить связь с вашим животным благодаря более глубокому пониманию его физических потребностей.',
+    },
+  ],
+};

package/src/category/i18n/sv.ts

@@ -0,0 +1,52 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'husdjur',
+  title: 'Husdjur Tools',
+  description: 'Gratis kalkylatorer och verktyg för djurägare. Ta reda på din hund eller katts verkliga ålder och beräkna deras dagliga ranson med veterinär precision.',
+  seo: [
+    { type: 'title', text: 'Djur Nutrition och Välbefinnande: Vetenskap i Tjänst för Ditt Husdjur', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Att ta hand om en hund, katt eller kanin är mycket mer än att bara ge dem mat och kärlek. Det innebär att förstå deras biologi, deras åldrande rytm och deras specifika energibehov. I det här avsnittet erbjuder vi <strong>gratis veterinära kalkylatorer</strong> som tillämpar validerade vetenskapliga formler för att hjälpa dig att fatta bättre beslut om din följeslagares hälsa.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Från nyfikenheten att veta hur många människoår din hund verkligen har, till den exakta beräkningen av den dagliga ransonen baserat på RER (Resting Energy Requirement), förvandlar våra verktyg komplexa veterinära koncept till tydliga, handlingskraftiga svar för den ansvarsfulla djurägaren.',
+    },
+    { type: 'title', text: 'Ditt Husdjurs Verkliga Ålder: Bortom Myten om "Gånger 7"', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Den populära tron att ett hundår är lika med sju människoår har motbevisats av modern veterinärvetenskap sedan decennier. Verkligheten är att hundar mognar exponentiellt under sina första två levnadsår och når motsvarande 15 människoår vid 12 månader och 24 år vid 24 månader. Därefter saktar tempot ner och beror enormt på <strong>djurets storlek</strong>: en jätte hund på över 45 kg kan åldras upp till 60 % snabbare än en liten hundras.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Katter å andra sidan följer en mer linjär ålderskurva: efter de första två åren av accelererad utveckling är varje kattår ungefär lika med fyra människoår. Att känna till ditt husdjurs livsstadie är inte bara nyfikenhet, det är relevant medicinsk information: det avgör när man ska planera geriatriska kontroller, när man ska justera kosten och vilka hälsotecken man ska övervaka.',
+    },
+    { type: 'title', text: 'Precision Nutrition: Beräkna den Exakta Dagliga Ransonen', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Fetma drabbar mer än 50 % av alla tamdjur i utvecklade länder och är den direkta orsaken till led- och kardiovaskulära problem och en minskad livslängd. Problemet är inte brist på kärlek från ägare, utan <strong>frånvaron av exakta kalorireferenser</strong>. Vår kalkylator för daglig ranson tillämpar standardveterinärens RER-formel (70 × vikt^0,75) och multiplicerar den med motsvarande DER-faktor för ditt djurs art, livsstadium och aktivitetsnivå.',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Husdjur Ålder Kalkylator:</strong> Konverterar kronologiska år till mänsklig motsvarighet baserat på art och storlek, med livsstadium och nästa veterinära milstolpe.',
+        '<strong>Daglig Ranson Kalkylator:</strong> Beräknar gram foder baserat på RER och DER för hundar, katter och kaniner.',
+      ],
+    },
+    {
+      type: 'tip',
+      title: 'Veterinärt Råd',
+      html: 'Dessa verktyg tillhandahåller vetenskapliga startreferenser, men varje djur är unikt. Konsultera alltid din veterinär för att anpassa kosten och hälsoplanen till ditt husdjurs individuella behov.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Att investera i kunskap om ditt husdjurs biologi är den mest effektiva formen av förebyggande medicin. En hälsosam vikt och veterinärvård i rätt tid kan lägga till år av kvalitetsliv för din trogna följeslagare. Det vetenskapliga förhållningssättet till vård säkerställer att ditt husdjur inte bara överlever utan blomstrar i alla stadier av livet.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Vikten av individuell vård kan inte överskattas. I en värld full av allmänna råd ger våra kalkylatorer en solid grund för den personliga vården av ditt husdjur. Använd dessa resurser för att stärka bandet med ditt djur genom en djupare förståelse för deras fysiska behov.',
+    },
+  ],
+};

package/src/category/i18n/tr.ts

@@ -0,0 +1,52 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'evcil-hayvanlar',
+  title: 'Evcil Hayvan Araçları',
+  description: 'Evcil hayvan sahipleri için ücretsiz hesaplayıcılar ve yardımcı programlar. Köpeğinizin veya kedinizin gerçek yaşını öğrenin ve günlük mama miktarını veteriner hassasiyetiyle hesaplayın.',
+  seo: [
+    { type: 'title', text: 'Hayvan Beslenmesi ve Refahı: Evcil Hayvanınızın Hizmetinde Bilim', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Bir köpeğe, kediye veya tavşana bakmak onlara yiyecek ve sevgi vermekten çok daha fazlasıdır. Bu, biyolojilerini, yaşlanma ritimlerini ve özel enerji ihtiyaçlarını anlamayı içerir. Bu bölümde, arkadaşınızın sağlığı hakkında daha iyi kararlar vermenize yardımcı olmak için doğrulanmış bilimsel formülleri uygulayan <strong>ücretsiz veteriner hesaplayıcıları</strong> sunuyoruz.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Köpeğinizin gerçekte kaç insan yaşında olduğunu bilme merakından, RER\'e (Resting Energy Requirement) dayalı günlük rasyonun kesin hesaplanmasına kadar, araçlarımız karmaşık veteriner kavramlarını sorumlu evcil hayvan sahibi için net, uygulanabilir cevaplara dönüştürür.',
+    },
+    { type: 'title', text: 'Evcil Hayvanınızın Gerçek Yaşı: "7 ile Çarpma" Efsanesinin Ötesinde', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Bir köpek yılının yedi insan yılına eşit olduğu yönündeki popüler inanış, modern veteriner bilimi tarafından onlarca yıldır çürütülmüştür. Gerçek şu ki, köpekler yaşamlarının ilk iki yılında katlanarak olgunlaşır, 12 ayda 15 insan yılına ve 24 ayda 24 yıla eşdeğer hale gelirler. Daha sonra tempo yavaşlar ve büyük ölçüde <strong>hayvanın boyutuna</strong> bağlıdır: 45 kg\'ın üzerindeki dev bir köpek, küçük bir cinsten %60\'a kadar daha hızlı yaşlanabilir.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Kediler ise daha doğrusal bir yaşlanma eğrisi izler: ilk iki yıllık hızlandırılmış gelişimden sonra, her kedi yılı yaklaşık dört insan yılına eşdeğerdir. Evcil hayvanınızın yaşam evresini bilmek sadece merak değildir, aynı zamanda ilgili tıbbi bilgidir: ne zaman geriatrik kontroller planlanacağını, diyetin ne zaman ayarlanacağını ve hangi sağlık işaretlerini izlemeniz gerektiğini belirler.',
+    },
+    { type: 'title', text: 'Hassas Beslenme: Tam Günlük Rasyonu Hesaplayın', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Obezite, gelişmiş ülkelerdeki evcil hayvanların %50\'den fazlasını etkilemektedir ve eklem ve kardiyovasküler problemlerin ve kısalmış yaşam beklentisinin doğrudan nedenidir. Sorun sahiplerin sevgi eksikliği değil, <strong>kesin kalorik referansların yokluğudur</strong>. Günlük rasyon hesaplayıcımız standart veteriner RER formülünü (70 × ağırlık^0,75) uygular ve bunu hayvanınızın türü, yaşam evresi ve aktivite seviyesi için karşılık gelen DER faktörüyle çarpar.',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Evcil Hayvan Yaş Hesaplayıcı:</strong> Tür ve boyuta göre kronolojik yılları insan eşdeğerine dönüştürür, yaşam evresini ve bir sonraki veteriner dönüm noktasını gösterir.',
+        '<strong>Günlük Rasyon Hesaplayıcı:</strong> Köpekler, kediler ve tavşanlar için RER ve DER\'e göre gram cinsinden günlük mama miktarını hesaplar.',
+      ],
+    },
+    {
+      type: 'tip',
+      title: 'Veteriner Tavsiyesi',
+      html: 'Bu araçlar bilimsel başlangıç referansları sağlar, ancak her hayvan benzersizdir. Diyeti ve sağlık planını evcil hayvanınızın bireysel ihtiyaçlarına göre ayarlamak için her zaman veterinerinize danışın.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Evcil hayvanınızın biyolojisi hakkında bilgiye yatırım yapmak, koruyucu hekimliğin en etkili şeklidir. Sağlıklı bir ağırlık ve zamanında veteriner bakımı, sadık arkadaşınıza yıllarca kaliteli yaşam katabilir. Bilimsel bir yaklaşım, evcil hayvanınızın yaşamının her aşamasında sadece hayatta kalmasını değil, aynı zamanda gelişmesini sağlar.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Bireysel bakımın önemi küçümsenemez. Genel tavsiyelerle dolu bir dünyada, hesaplayıcılarımız evcil hayvanınızın kişiselleştirilmiş bakımı için sağlam bir temel sağlar. Fiziksel ihtiyaçlarını daha derinlemesine anlayarak hayvanınızla olan bağı güçlendirmek için bu kaynakları kullanın.',
+    },
+  ],
+};

package/src/category/i18n/zh.ts

@@ -0,0 +1,52 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'pets',
+  title: '宠物 工具',
+  description: '为 宠物 主人 提供 的 免费 计算器 和 实用 程序 。 了解 您 的 爱犬 或 爱猫 的 真实 年龄 ， 并 以 兽医 般的 精度 计算 它们 的 每日 喂食量 。',
+  seo: [
+    { type: 'title', text: '动物 营养 与 福祉 ： 为 您 的 宠物 提供 科学 服务', level: 2 },
+    {
+      type: 'paragraph',
+      html: '照顾 狗 、 猫 或 兔子 不仅仅 是 给 它们 食物 和 关爱 。 它 涉及 了解 它们 的 生物学 、 它们 的 衰老 节奏 以及 它们 特定 的 能量 需求 。 在 本 章节 中 ， 我们 提供 <strong>免费 的 兽医 计算器</strong> ， 应用 经过 验证 的 科学 公式 ， 帮助 您 就 伴侣 的 健康 做出 更好 的 决定 。',
+    },
+    {
+      type: 'paragraph',
+      html: '从 好奇 想 知道 您 的 狗 实际上 有 多少 岁 的 人类 年龄 ， 到 基于 RER （ 静息 能量 需求 ） 的 每日 喂食量 的 精确 计算 ， 我们 的 工具 将 复杂 的 兽医学 概念 转化 为 对 负责任 的 宠物 主人 而言 清晰 、 可 操作 的 答案 。',
+    },
+    { type: 'title', text: '您 宠物 的 真实 年龄 ： 超越 “ 乘以 7 ” 的 误区', level: 2 },
+    {
+      type: 'paragraph',
+      html: '一个 狗 年 等于 七个 人类 年 的 流行 观念 几十年来 一直 被 现代 兽医学 所 否定 。 现实 情况 是 ， 狗 在 生命 的 前 两年 呈 指数 级 成熟 ， 在 12 个月 时 达到 相当于 人类 15 岁 的 水平 ， 在 24 个月 时 达到 24 岁 。 随后 ， 速度 会 变慢 ， 并 极大 地 取决于 <strong>动物 的 体型</strong> ： 体重 超过 45 公斤 的 巨型 犬 的 衰老 速度 比 小型 犬 快 多 达 60% 。',
+    },
+    {
+      type: 'paragraph',
+      html: '另一方面 ， 猫 遵循 更加 线性 的 衰老 曲线 ： 在 最初 两年 的 加速 发展 之后 ， 每个 猫 年 大约 相当于 四个 人类 年 。 了解 您 宠物 的 生命 阶段 不仅仅 是 好奇 ， 它 是 相关 的 医学 信息 ： 它 决定 了 何时 安排 老年 检查 、 何时 调整 饮食 以及 您 应该 监测 哪些 健康 迹象 。',
+    },
+    { type: 'title', text: '精准 营养 ： 计算 准确 的 每日 喂食量', level: 2 },
+    {
+      type: 'paragraph',
+      html: '肥胖 影响 着 发达国家 超过 50% 的 宠物 ， 并且 是 导致 关节 和 心血管 问题 以及 寿命 缩短 的 直接 原因 。 问题 不在于 主人 缺乏 爱心 ， 而在于 <strong>缺乏 精确 的 热量 参考</strong> 。 我们 的 每日 喂食量 计算器 应用 标准 的 兽医 RER 公式 （ 70 × 体重^0.75 ） ， 并 乘以 对应 于 您 动物 物种 、 生命 阶段 和 活动 水平 的 DER 系数 。',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>宠物 年龄 计算器 ：</strong> 根据 物种 和 体型 将 编年 年份 转换 为 人类 等效 年龄 ， 并 提供 生命周期 和 下 一个 兽医 里程碑 。',
+        '<strong>每日 喂食量 计算器 ：</strong> 基于 RER 和 DER 为 狗 、 猫 和 兔子 计算 干粮 和 湿粮 的 克数 。',
+      ],
+    },
+    {
+      type: 'tip',
+      title: '兽医 建议',
+      html: '这些 工具 提供 了 科学 的 起始 参考 ， 但 每 只 动物 都是 独特 的 。 请 始终 咨询 您 的 兽医 ， 以 将 饮食 和 健康 计划 调整 为 满足 您 宠物 的 个体 需求 。',
+    },
+    {
+      type: 'paragraph',
+      html: '投资 于 了解 您 宠物 的 生物学 知识 是 预防 医学 最 有效 的 形式 。 健康 的 体重 和 及时 的 兽医 护理 可以 为 您 忠实 的 伴侣 增加 优质 的 生活 年限 。 科学 的 护理 方法 确保 您 的 宠物 不仅 能 生存 ， 而且 能 在 生命 的 每个 阶段 茁壮 成长 。',
+    },
+    {
+      type: 'paragraph',
+      html: '个体 护理 的 重要性 不言而喻 。 在 一个 充满 笼统 建议 的 世界 里 ， 我们 的 计算器 为 您 宠物 的 个性化 护理 提供 了 坚实 的 基础 。 利用 这些 资源 ， 通过 深入 了解 它们 的 物理 需求 来 加强 与 它们 的 纽带 。',
+    },
+  ],
+};

package/src/category/index.ts

@@ -6,8 +6,20 @@ export const petsCategory: PetCategoryEntry = {
   icon: 'mdi:paw',
   tools: [petAge, petRation],
   i18n: {
-    es: () => import('./i18n/es').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),
+    de: () => import('./i18n/de').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),
   },
 };

package/src/index.ts

@@ -17,4 +17,4 @@ export type {
   PetCategoryEntry,
 } from './types';
 
-export { ALL_TOOLS } from './tools';
+export { ALL_ENTRIES, ALL_TOOLS } from './tools';

package/src/tests/i18n_coverage.test.ts

@@ -0,0 +1,36 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+
+const EXPECTED_LOCALES = [
+  'de', 'en', 'es', 'fr', 'id', 'it', 'ja', 'ko', 'nl', 'pl', 'pt', 'ru', 'sv', 'tr', 'zh'
+];
+
+describe('I18n Coverage Validation', () => {
+  it('all tools should be registered', () => {
+    expect(ALL_TOOLS.length).toBeGreaterThan(0);
+  });
+
+  ALL_TOOLS.forEach(({ entry }: { entry: any }) => {
+    describe(`Tool: ${entry.id}`, () => {
+      it('should have all 15 required locales', () => {
+        const registeredLocales = Object.keys(entry.i18n);
+        EXPECTED_LOCALES.forEach((locale) => {
+          expect(
+            registeredLocales,
+            `Tool "${entry.id}" is missing locale "${locale}"`,
+          ).toContain(locale);
+        });
+      });
+
+      it('all locale loaders should be functions', () => {
+        EXPECTED_LOCALES.forEach((locale) => {
+          const loader = entry.i18n[locale as keyof typeof entry.i18n];
+          expect(
+            typeof loader,
+            `Tool "${entry.id}" locale "${locale}" loader is not a function`,
+          ).toBe('function');
+        });
+      });
+    });
+  });
+});

package/src/tests/locale_completeness.test.ts

@@ -0,0 +1,42 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import type { ToolLocaleContent } from '../types';
+
+describe('Locale Completeness Validation', () => {
+  ALL_TOOLS.forEach((tool) => {
+    describe(`Tool: ${tool.entry.id}`, () => {
+      Object.keys(tool.entry.i18n).forEach((locale) => {
+        describe(`Locale: ${locale}`, () => {
+          it('faqTitle should be defined when faq items exist', async () => {
+            const loader = tool.entry.i18n[locale as keyof typeof tool.entry.i18n];
+            const content = (await loader?.()) as ToolLocaleContent;
+
+            if (content.faq.length > 0) {
+              expect(
+                content.faqTitle,
+                `Tool "${tool.entry.id}" locale "${locale}" has ${content.faq.length} FAQ items but is missing faqTitle`,
+              ).toBeTruthy();
+            }
+          });
+
+          it('bibliographyTitle should be defined when bibliography items exist', async () => {
+            const loader = tool.entry.i18n[locale as keyof typeof tool.entry.i18n];
+            const content = (await loader?.()) as ToolLocaleContent;
+
+            if (content.bibliography.length > 0) {
+              expect(
+                content.bibliographyTitle,
+                `Tool "${tool.entry.id}" locale "${locale}" has ${content.bibliography.length} bibliography items but is missing bibliographyTitle`,
+              ).toBeTruthy();
+            }
+          });
+        });
+      });
+    });
+  });
+
+  it('all tools registered', () => {
+    expect(ALL_TOOLS.length).toBe(2);
+  });
+});
+

package/src/tests/no_h1_in_components.test.ts

@@ -0,0 +1,48 @@
+import { describe, it, expect } from 'vitest';
+import { readdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+
+const EXCLUDED_DIRS = ['node_modules', 'pages', 'layouts'];
+
+function findAstroFiles(dir: string): string[] {
+  const files: string[] = [];
+  const entries = readdirSync(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory() && !EXCLUDED_DIRS.includes(entry.name)) {
+      files.push(...findAstroFiles(fullPath));
+    } else if (entry.isFile() && entry.name.endsWith('.astro')) {
+      files.push(fullPath);
+    }
+  }
+
+  return files;
+}
+
+function hasH1(content: string): boolean {
+  return /<h1[\s>]/i.test(content);
+}
+
+const srcDir = join(process.cwd(), 'src');
+const astroFiles = findAstroFiles(srcDir);
+
+describe('No H1 in Components', () => {
+  if (astroFiles.length === 0) {
+    it('no astro components found', () => {
+      expect(true).toBe(true);
+    });
+  }
+
+  astroFiles.forEach((file) => {
+    const relativePath = file.replace(process.cwd(), '');
+    it(`${relativePath} should not contain <h1>`, () => {
+      const content = readFileSync(file, 'utf-8');
+      expect(
+        hasH1(content),
+        `File "${relativePath}" contains a <h1> element. Use <h2> or lower inside components — h1 belongs to the page layout.`,
+      ).toBe(false);
+    });
+  });
+});
+

package/src/tests/schemas_fulfillment.test.ts

@@ -0,0 +1,23 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import type { ToolLocaleContent } from '../types';
+
+describe('Schemas Fulfillment Validation', () => {
+  ALL_TOOLS.forEach((tool) => {
+    describe(`Tool: ${tool.entry.id}`, () => {
+      Object.keys(tool.entry.i18n).forEach((locale) => {
+        it(`Locale: ${locale} should have faqSchema, appSchema and howToSchema`, async () => {
+          const loader = tool.entry.i18n[locale as keyof typeof tool.entry.i18n];
+          if (!loader) return;
+          const content = (await loader()) as ToolLocaleContent;
+
+          const schemaTypes = content.schemas.map((s: any) => s['@type']);
+
+          expect(schemaTypes, `Tool "${tool.entry.id}" locale "${locale}" is missing FAQPage schema`).toContain('FAQPage');
+          expect(schemaTypes, `Tool "${tool.entry.id}" locale "${locale}" is missing SoftwareApplication schema`).toContain('SoftwareApplication');
+          expect(schemaTypes, `Tool "${tool.entry.id}" locale "${locale}" is missing HowTo schema`).toContain('HowTo');
+        });
+      });
+    });
+  });
+});

package/src/tests/slug_language_code_format.test.ts

@@ -0,0 +1,23 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import type { ToolLocaleContent } from '../types';
+
+describe('Slug Language Code Format Validation', () => {
+  ALL_TOOLS.forEach((tool) => {
+    describe(`Tool: ${tool.entry.id}`, () => {
+      it('slug should not end with 2-letter language codes like -ja, -ru, -ko', async () => {
+        const locales = Object.keys(tool.entry.i18n);
+
+        for (const locale of locales) {
+          const loader = tool.entry.i18n[locale as keyof typeof tool.entry.i18n];
+          const content = (await loader?.()) as ToolLocaleContent;
+
+          expect(
+            content.slug,
+            `Tool "${tool.entry.id}" locale "${locale}" slug ("${content.slug}") cannot end with a 2-letter language code (e.g., -ja, -ru, -ko).`,
+          ).not.toMatch(/-[a-z]{2}$/);
+        }
+      });
+    });
+  });
+});

package/src/tests/slug_uniqueness.test.ts

@@ -0,0 +1,81 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import type { ToolLocaleContent } from '../types';
+
+const sharingLocales = ['ja', 'ko', 'zh'];
+
+interface ValidateParams {
+  toolId: string;
+  locale: string;
+  content: ToolLocaleContent;
+  enSlug: string;
+  slugs: Map<string, string>;
+}
+
+const validateLocaleSlug = ({
+  toolId,
+  locale,
+  content,
+  enSlug,
+  slugs,
+}: ValidateParams) => {
+  expect(
+    content.slug,
+    `Tool "${toolId}" locale "${locale}" has an invalid slug ("${content.slug}"). Slugs must be transliterated (only a-z, 0-9, and -).`,
+  ).toMatch(/^[a-z0-9-]+$/);
+
+  if (locale === 'en') {
+    return;
+  }
+
+  if (sharingLocales.includes(locale)) {
+    expect(
+      content.slug,
+      `Tool "${toolId}" locale "${locale}" must use the same slug as "en" ("${enSlug}").`,
+    ).toBe(enSlug);
+  } else {
+    expect(
+      content.slug,
+      `Tool "${toolId}" locale "${locale}" has the same slug as "en" ("${enSlug}"). Cada slug tiene que estar en su propia idioma`,
+    ).not.toBe(enSlug);
+
+    if (slugs.has(content.slug)) {
+      const previousLocale = slugs.get(content.slug);
+      expect(
+        false,
+        `Tool "${toolId}" locales "${locale}" and "${previousLocale}" share the same slug ("${content.slug}"). Cada slug tiene que estar en su propia idioma`,
+      ).toBe(true);
+    }
+    slugs.set(content.slug, locale);
+  }
+};
+
+describe('Slug Localization and Uniqueness Validation', () => {
+  ALL_TOOLS.forEach((tool) => {
+    describe(`Tool: ${tool.entry.id}`, () => {
+      it('every locale should have a unique, translated slug', async () => {
+        const slugs = new Map<string, string>();
+        const locales = Object.keys(tool.entry.i18n);
+
+        let enSlug = '';
+        if (locales.includes('en')) {
+          const enLoader = tool.entry.i18n['en' as keyof typeof tool.entry.i18n];
+          const enContent = (await enLoader?.()) as ToolLocaleContent;
+          enSlug = enContent.slug;
+        }
+
+        for (const locale of locales) {
+          const loader = tool.entry.i18n[locale as keyof typeof tool.entry.i18n];
+          const content = (await loader?.()) as ToolLocaleContent;
+          validateLocaleSlug({
+            toolId: tool.entry.id,
+            locale,
+            content,
+            enSlug,
+            slugs,
+          });
+        }
+      });
+    });
+  });
+});

package/src/tests/title_quality.test.ts

@@ -0,0 +1,55 @@
+import { describe, it } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+
+function getFiles(dir: string, ext: string[]): string[] {
+  const results: string[] = [];
+  if (!fs.existsSync(dir)) return results;
+  const list = fs.readdirSync(dir);
+  for (const file of list) {
+    const fullPath = path.join(dir, file);
+    const stat = fs.statSync(fullPath);
+    if (stat && stat.isDirectory()) {
+      results.push(...getFiles(fullPath, ext));
+    } else if (ext.some((e) => file.endsWith(e))) {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
+const SRC_DIR = path.join(process.cwd(), 'src');
+
+describe('Project Titles - Separator Validation', () => {
+  const files = [
+    ...getFiles(path.join(SRC_DIR, 'tool'), ['.ts']),
+    ...getFiles(path.join(SRC_DIR, 'category'), ['.ts']),
+  ].filter(f => f.includes('i18n'));
+
+  it.each(files)('Verify that titles in %s do not contain | or -', (filePath) => {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const relativePath = path.relative(process.cwd(), filePath);
+
+    const titlePatterns = [
+      /const\s+title\s*=\s*['"]([^'"]+)['"]/g,
+      /title\s*:\s*['"]([^'"]+)['"]/g,
+    ];
+
+    const findings: string[] = [];
+
+    for (const pattern of titlePatterns) {
+      let match;
+      while ((match = pattern.exec(content)) !== null) {
+        const title = match[1];
+        if (title.includes('|') || title.includes('-')) {
+          findings.push(title);
+        }
+      }
+    }
+
+    if (findings.length > 0) {
+      const list = findings.map((f) => `  - "${f}"`).join('\n');
+      throw new Error(`Forbidden separators (| or -) found in titles in ${relativePath}:\n${list}`);
+    }
+  });
+});