@jjlmoya/utils-pets 1.12.0 → 1.14.0

package/package.json

@@ -1,13 +1,15 @@
 {
     "name": "@jjlmoya/utils-pets",
-    "version": "1.12.0",
+    "version": "1.14.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",
     "exports": {
         ".": "./src/index.ts",
         "./data": "./src/data.ts",
-        "./entries": "./src/entries.ts"
+        "./entries": "./src/entries.ts",
+        "./runtime/*": "./src/tool/*/index.ts",
+        "./category-seo": "./src/category/seo.astro"
     },
     "files": [
         "src",

package/src/category/i18n/fr.ts

@@ -5,7 +5,7 @@ export const content: CategoryLocaleContent = {
   title: 'Outils pour Animaux de Compagnie',
   description: 'Calculatrices et utilitaires gratuits pour les propriétaires d\'animaux. Découvrez l\'âge réel de votre chien ou chat et calculez leur ration quotidienne avec précision vétérinaire.',
   seo: [
-    { type: 'title', text: 'Nutrition et Bien-être Animal : La Science au Service de votre Animal', level: 2 },
+    { type: 'title', text: 'Nutrition et Bien-être Animal: La Science au Service de votre Animal', level: 2 },
     {
       type: 'paragraph',
       html: 'Prendre soin d\'un chien, d\'un chat ou d\'un lapin va bien au-delà de leur donner de la nourriture et de l\'affection. Cela implique de comprendre leur biologie, leur rythme de vieillissement et leurs besoins énergétiques spécifiques. Dans cette section, nous proposons des <strong>calculatrices vétérinaires gratuites</strong> qui appliquent des formules scientifiques validées pour vous aider à prendre de meilleures décisions concernant la santé de votre compagnon.',
@@ -14,16 +14,16 @@ export const content: CategoryLocaleContent = {
       type: 'paragraph',
       html: 'De la curiosité de savoir combien d\'années humaines a réellement votre chien, jusqu\'au calcul précis de la ration quotidienne basé sur le RER (Resting Energy Requirement), nos outils transforment des concepts vétérinaires complexes en réponses claires et exploitables pour le propriétaire responsable.',
     },
-    { type: 'title', text: 'L\'Âge Réel de votre Animal : Au-delà du Mythe du "Fois 7"', level: 2 },
+    { type: 'title', text: 'L\'Âge Réel de votre Animal: Au-delà du Mythe du "Fois 7"', level: 2 },
     {
       type: 'paragraph',
       html: 'La croyance populaire qu\'une année de chien équivaut à sept années humaines est démystifiée depuis des décennies par la médecine vétérinaire moderne. La réalité est que les chiens mûrissent de façon exponentielle au cours de leurs deux premières années de vie, atteignant l\'équivalent de 15 ans humains à 12 mois et de 24 ans à 24 mois. Ensuite, le rythme ralentit et dépend énormément de la <strong>taille de l\'animal</strong>.',
     },
     {
       type: 'paragraph',
-      html: 'Les chats, quant à eux, suivent une courbe de vieillissement plus linéaire : après les deux premières années de développement accéléré, chaque année féline équivaut approximativement à quatre années humaines. Connaître le stade de vie de votre animal n\'est pas seulement une curiosité, c\'est une information médicale pertinente qui détermine le moment des bilans gériatriques et l\'ajustement du régime alimentaire.',
+      html: 'Les chats, quant à eux, suivent une courbe de vieillissement plus linéaire: après les deux premières années de développement accéléré, chaque année féline équivaut approximativement à quatre années humaines. Connaître le stade de vie de votre animal n\'est pas seulement une curiosité, c\'est une information médicale pertinente qui détermine le moment des bilans gériatriques et l\'ajustement du régime alimentaire.',
     },
-    { type: 'title', text: 'Nutrition de Précision : Calculez la Ration Quotidienne Exacte', level: 2 },
+    { type: 'title', text: 'Nutrition de Précision: Calculez la Ration Quotidienne Exacte', level: 2 },
     {
       type: 'paragraph',
       html: 'L\'obésité touche plus de 50 % des animaux de compagnie dans les pays développés et est la cause directe de problèmes articulaires, cardiovasculaires et d\'une espérance de vie réduite. Notre calculatrice de ration quotidienne applique la formule vétérinaire standard RER (70 × poids^0.75) multipliée par le facteur DER correspondant à l\'espèce, au stade de vie et au niveau d\'activité de votre animal.',

package/src/category/i18n/ru.ts

@@ -8,11 +8,11 @@ export const content: CategoryLocaleContent = {
     { type: 'title', text: 'Питание и Благополучие Животных: Наука на Службе Вашего Питомца', level: 2 },
     {
       type: 'paragraph',
-      html: 'Забота о собаке, кошке или кролике — это гораздо больше, чем просто еда и ласка. Это требует понимания их биологии, ритма старения и специфических потребностей в энергии. В этом разделе мы предлагаем <strong>бесплатные ветеринарные калькуляторы</strong>, которые применяют проверенные научные формулы, чтобы помочь вам принимать более обоснованные решения в вопросах здоровья вашего спутника.',
+      html: 'Забота о собаке, кошке или кролике - это гораздо больше, чем просто еда и ласка. Это требует понимания их биологии, ритма старения и специфических потребностей в энергии. В этом разделе мы предлагаем <strong>бесплатные ветеринарные калькуляторы</strong>, которые применяют проверенные научные формулы, чтобы помочь вам принимать более обоснованные решения в вопросах здоровья вашего спутника.',
     },
     {
       type: 'paragraph',
-      html: 'От любопытства узнать, сколько человеческих лет на самом деле вашей собаке, до точного расчета дневного рациона на основе RER (Resting Energy Requirement) — наши инструменты превращают сложные ветеринарные концепции в четкие и практичные ответы для ответственного владельца домашнего животного.',
+      html: 'От любопытства узнать, сколько человеческих лет на самом деле вашей собаке, до точного расчета дневного рациона на основе RER (Resting Energy Requirement) - наши инструменты превращают сложные ветеринарные концепции в четкие и практичные ответы для ответственного владельца домашнего животного.',
     },
     { type: 'title', text: 'Реальный Возраст Вашего Питомца: За Пределами Мифа об "Умножении на 7"', level: 2 },
     {
@@ -21,7 +21,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'paragraph',
-      html: 'Кошки, с другой стороны, следуют более линейной кривой старения: после первых двух лет ускоренного развития каждый кошачий год примерно эквивалентен четырем человеческим годам. Знание этапа жизни вашего питомца — это не просто любопытство, это важная медицинская информация: она определяет, когда планировать гериатрические осмотры, когда корректировать диету и какие признаки здоровья следует контролировать.',
+      html: 'Кошки, с другой стороны, следуют более линейной кривой старения: после первых двух лет ускоренного развития каждый кошачий год примерно эквивалентен четырем человеческим годам. Знание этапа жизни вашего питомца - это не просто любопытство, это важная медицинская информация: она определяет, когда планировать гериатрические осмотры, когда корректировать диету и какие признаки здоровья следует контролировать.',
     },
     { type: 'title', text: 'Точное Питание: Рассчитайте Точный Дневной Рацион', level: 2 },
     {
@@ -42,7 +42,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'paragraph',
-      html: 'Инвестиции в знания о биологии вашего питомца — самая эффективная форма профилактической медицины. Здоровый вес и своевременная ветеринарная помощь могут добавить годы качественной жизни вашему верному спутнику. Научный подход к уходу гарантирует, что ваш питомец не просто выживет, но и преуспеет на каждом этапе своей жизни.',
+      html: 'Инвестиции в знания о биологии вашего питомца - самая эффективная форма профилактической медицины. Здоровый вес и своевременная ветеринарная помощь могут добавить годы качественной жизни вашему верному спутнику. Научный подход к уходу гарантирует, что ваш питомец не просто выживет, но и преуспеет на каждом этапе своей жизни.',
     },
     {
       type: 'paragraph',

package/src/category/i18n/zh.ts

@@ -14,7 +14,7 @@ export const content: CategoryLocaleContent = {
       type: 'paragraph',
       html: '从 好奇 想 知道 您 的 狗 实际上 有 多少 岁 的 人类 年龄 ， 到 基于 RER （ 静息 能量 需求 ） 的 每日 喂食量 的 精确 计算 ， 我们 的 工具 将 复杂 的 兽医学 概念 转化 为 对 负责任 的 宠物 主人 而言 清晰 、 可 操作 的 答案 。',
     },
-    { type: 'title', text: '您 宠物 的 真实 年龄 ： 超越 “ 乘以 7 ” 的 误区', level: 2 },
+    { type: 'title', text: '您 宠物 的 真实 年龄 ： 超越 \" 乘以 7 \" 的 误区', level: 2 },
     {
       type: 'paragraph',
       html: '一个 狗 年 等于 七个 人类 年 的 流行 观念 几十年来 一直 被 现代 兽医学 所 否定 。 现实 情况 是 ， 狗 在 生命 的 前 两年 呈 指数 级 成熟 ， 在 12 个月 时 达到 相当于 人类 15 岁 的 水平 ， 在 24 个月 时 达到 24 岁 。 随后 ， 速度 会 变慢 ， 并 极大 地 取决于 <strong>动物 的 体型</strong> ： 体重 超过 45 公斤 的 巨型 犬 的 衰老 速度 比 小型 犬 快 多 达 60% 。',

package/src/data.ts

@@ -1,6 +1,6 @@
+export { petsCategory } from './category';
 export { petAge } from './tool/petAge';
 export { petRation } from './tool/petRation';
-export { petsCategory } from './category';
 
 export type { PetAgeUI, PetAgeLocaleContent } from './tool/petAge';
 export type { PetRationUI, PetRationLocaleContent } from './tool/petRation';

package/src/layouts/PreviewLayout.astro

@@ -10,7 +10,12 @@ interface Props {
   hasSidebar?: boolean;
 }
 
-const { title, currentLocale = "es", localeUrls = {}, hasSidebar = false } = Astro.props;
+const {
+  title,
+  currentLocale = "es",
+  localeUrls = {},
+  hasSidebar = false,
+} = Astro.props;
 ---
 
 <!doctype html>
@@ -78,6 +83,7 @@ const { title, currentLocale = "es", localeUrls = {}, hasSidebar = false } = Ast
     transition:
       background-color 0.3s ease,
       color 0.3s ease;
+    font-family: Inter, sans-serif;
   }
 
   main {

package/src/pages/[locale]/[slug].astro

@@ -34,18 +34,28 @@ export async function getStaticPaths() {
       ]),
     ) as Partial<Record<KnownLocale, string>>;
 
+    const firstLoader = entry.i18n.en ?? Object.values(entry.i18n)[0];
+    const englishSlug = firstLoader ? (await firstLoader()).slug : entry.id;
+
     for (const { locale, content } of localeContents) {
-      const allToolsNav = await Promise.all(
-        ALL_TOOLS.map(async ({ entry: navEntry }) => ({
-          id: navEntry.id,
-          title: (await navEntry.i18n[locale]!()).title,
-          href: `/${locale}/${(await navEntry.i18n[locale]!()).slug}`,
-          isActive: navEntry.id === entry.id,
-        })),
-      );
+      const allToolsNav = (
+        await Promise.all(
+          ALL_TOOLS.map(async ({ entry: navEntry }) => {
+            const loader = navEntry.i18n[locale] ?? navEntry.i18n.en;
+            if (!loader) return null;
+            const navContent = await loader();
+            return {
+              id: navEntry.id,
+              title: navContent.title,
+              href: `/${locale}/${navContent.slug}`,
+              isActive: navEntry.id === entry.id,
+            };
+          }),
+        )
+      ).filter(Boolean) as NavItem[];
       paths.push({
         params: { locale, slug: content.slug },
-        props: { Component, locale, content, localeUrls, allToolsNav },
+        props: { Component, locale, content, localeUrls, allToolsNav, englishSlug },
       });
     }
   }
@@ -66,11 +76,16 @@ interface Props {
   content: ToolLocaleContent;
   localeUrls: Partial<Record<KnownLocale, string>>;
   allToolsNav: NavItem[];
+  englishSlug: string;
 }
 
-const { Component, locale, content, localeUrls, allToolsNav } = Astro.props;
+const { Component, locale, content, localeUrls, allToolsNav, englishSlug } = Astro.props;
+
+const cssFiles = import.meta.glob("../../tool/*/*.css", { query: "?raw", import: "default" });
+const cssKey = Object.keys(cssFiles).find((k) => k.endsWith(`/${englishSlug}.css`));
+const toolCss = cssKey ? await cssFiles[cssKey]() as string : "";
 
-const seoContent: UtilitySEOContent = { locale, sections: content.seo };
+const seoContent: UtilitySEOContent = { locale, sections: content.seo ?? [] };
 
 const words = content.title.split(" ");
 const titleHighlight = words[0] || "";
@@ -89,8 +104,9 @@ const titleBase = words.slice(1).join(" ") || "";
     tools={allToolsNav}
   />
   <Fragment slot="head">
+    {toolCss ? <Fragment set:html={`<style is:inline>${toolCss}</style>`} /> : null}
     {
-      content.schemas.map((schema) => (
+      ( content.schemas ?? []).map((schema) => (
         <script
           is:inline
           type="application/ld+json"
@@ -120,7 +136,7 @@ const titleBase = words.slice(1).join(" ") || "";
     </section>
 
     <section class="section-bibliography">
-      <Bibliography links={content.bibliography} title={content.bibliographyTitle} />
+      <Bibliography links={content.bibliography}  />
     </section>
   </div>
 </PreviewLayout>

package/src/tests/diacritics_density.test.ts

@@ -0,0 +1,118 @@
+import { describe, expect, it } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+
+type LocaleWithDiacritics = keyof typeof DIACRITIC_RULES;
+
+const DIACRITIC_RULES = {
+  de: {
+    language: 'German',
+    expectedCharacters: 'ä ö ü ß',
+    characters: /[äöüÄÖÜß]/g,
+    minPerThousandLetters: 0.1,
+  },
+  es: {
+    language: 'Spanish',
+    expectedCharacters: 'á é í ó ú ü ñ',
+    characters: /[áéíóúüñÁÉÍÓÚÜÑ]/g,
+    minPerThousandLetters: 0.1,
+  },
+  fr: {
+    language: 'French',
+    expectedCharacters: 'à â æ ç é è ê ë î ï ô œ ù û ü ÿ',
+    characters: /[àâæçéèêëîïôœùûüÿÀÂÆÇÉÈÊËÎÏÔŒÙÛÜŸ]/g,
+    minPerThousandLetters: 0.1,
+  },
+  it: {
+    language: 'Italian',
+    expectedCharacters: 'à è é ì í î ò ó ù ú',
+    characters: /[àèéìíîòóùúÀÈÉÌÍÎÒÓÙÚ]/g,
+    minPerThousandLetters: 0.1,
+  },
+  pl: {
+    language: 'Polish',
+    expectedCharacters: 'ą ć ę ł ń ó ś ź ż',
+    characters: /[ąćęłńóśźżĄĆĘŁŃÓŚŹŻ]/g,
+    minPerThousandLetters: 0.1,
+  },
+  pt: {
+    language: 'Portuguese',
+    expectedCharacters: 'á â ã à ç é ê í ó ô õ ú ü',
+    characters: /[áâãàçéêíóôõúüÁÂÃÀÇÉÊÍÓÔÕÚÜ]/g,
+    minPerThousandLetters: 0.1,
+  },
+  sv: {
+    language: 'Swedish',
+    expectedCharacters: 'å ä ö',
+    characters: /[åäöÅÄÖ]/g,
+    minPerThousandLetters: 0.1,
+  },
+  tr: {
+    language: 'Turkish',
+    expectedCharacters: 'ç ğ ı İ ö ş ü',
+    characters: /[çğıöşüÇĞİÖŞÜ]/g,
+    minPerThousandLetters: 0.1,
+  },
+} as const;
+
+const LETTERS = /\p{L}/gu;
+const TRANSLATABLE_KEYS = ['title', 'description', 'ui', 'seo', 'faq', 'howTo'] as const;
+
+function collectStrings(value: unknown): string[] {
+  if (typeof value === 'string') return [value];
+  if (!value || typeof value !== 'object') return [];
+  if (Array.isArray(value)) return value.flatMap(collectStrings);
+  return Object.values(value).flatMap(collectStrings);
+}
+
+function normalizeText(value: unknown): string {
+  return collectStrings(value).join(' ').normalize('NFC');
+}
+
+function translatableContent(content: Record<string, unknown>) {
+  return TRANSLATABLE_KEYS.map((key) => content[key]);
+}
+
+function letterCount(text: string): number {
+  return text.match(LETTERS)?.length ?? 0;
+}
+
+function diacriticCount(text: string, locale: LocaleWithDiacritics): number {
+  return text.match(DIACRITIC_RULES[locale].characters)?.length ?? 0;
+}
+
+function diacriticsPerThousandLetters(text: string, locale: LocaleWithDiacritics): number {
+  const letters = letterCount(text);
+  if (letters === 0) return 0;
+  return diacriticCount(text, locale) / letters * 1000;
+}
+
+describe('Diacritics density validation', () => {
+  ALL_TOOLS.forEach((tool) => {
+    describe(`Tool: ${tool.entry.id}`, () => {
+      Object.keys(DIACRITIC_RULES).forEach((locale) => {
+        it(`${locale} keeps the expected accent and special-letter set`, async () => {
+          const typedLocale = locale as LocaleWithDiacritics;
+          const loader = tool.entry.i18n[typedLocale];
+          if (!loader) return;
+
+          const content = await loader();
+          const text = normalizeText(translatableContent(content as Record<string, unknown>));
+          const rule = DIACRITIC_RULES[typedLocale];
+          const letters = letterCount(text);
+          const matches = diacriticCount(text, typedLocale);
+          const density = diacriticsPerThousandLetters(text, typedLocale);
+
+          expect(
+            density,
+            [
+              `Possible spelling or encoding issue detected in ${tool.entry.id}/${typedLocale} (${rule.language}).`,
+              `The text has ${matches} special characters (${density.toFixed(2)} per 1000 letters, ${letters} letters analyzed).`,
+              `This locale should include some of these characters: ${rule.expectedCharacters}.`,
+              'If the count is 0 or near 0, accents, tildes, or special letters were probably stripped by encoding or normalization.',
+            ].join(' '),
+          ).toBeGreaterThanOrEqual(rule.minPerThousandLetters);
+        });
+      });
+    });
+  });
+});

package/src/tests/inverted_punctuation.test.ts

@@ -0,0 +1,84 @@
+import { describe, expect, it } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+
+const INVERTED_PUNCTUATION_LOCALES = {
+  es: {
+    language: 'Spanish',
+    questionStart: '¿',
+    questionEnd: '?',
+    exclamationStart: '¡',
+    exclamationEnd: '!',
+  },
+} as const;
+
+type InvertedPunctuationLocale = keyof typeof INVERTED_PUNCTUATION_LOCALES;
+
+const TRANSLATABLE_KEYS = ['title', 'description', 'ui', 'seo', 'faq', 'howTo'] as const;
+
+function collectStrings(value: unknown): string[] {
+  if (typeof value === 'string') return [value];
+  if (!value || typeof value !== 'object') return [];
+  if (Array.isArray(value)) return value.flatMap(collectStrings);
+  return Object.values(value).flatMap(collectStrings);
+}
+
+function translatableStrings(content: Record<string, unknown>): string[] {
+  return TRANSLATABLE_KEYS.flatMap((key) => collectStrings(content[key]));
+}
+
+function sentenceStart(text: string, endIndex: number): string {
+  const beforeMark = text.slice(0, endIndex).trimEnd();
+  const boundary = Math.max(
+    beforeMark.lastIndexOf('.'),
+    beforeMark.lastIndexOf(':'),
+    beforeMark.lastIndexOf(';'),
+    beforeMark.lastIndexOf('\n'),
+  );
+
+  return beforeMark.slice(boundary + 1).trimStart();
+}
+
+function findMissingInvertedMarks(
+  text: string,
+  startMark: string,
+  endMark: string,
+): string[] {
+  return [...text.matchAll(new RegExp(`\\${endMark}`, 'g'))]
+    .map((match) => sentenceStart(text, match.index ?? 0))
+    .filter((segment) => segment.length > 0 && !segment.includes(startMark))
+    .map((segment) => `${segment}${endMark}`);
+}
+
+describe('Inverted punctuation validation', () => {
+  ALL_TOOLS.forEach((tool) => {
+    describe(`Tool: ${tool.entry.id}`, () => {
+      Object.keys(INVERTED_PUNCTUATION_LOCALES).forEach((locale) => {
+        it(`${locale} uses opening punctuation marks for questions and exclamations`, async () => {
+          const typedLocale = locale as InvertedPunctuationLocale;
+          const loader = tool.entry.i18n[typedLocale];
+          if (!loader) return;
+
+          const rule = INVERTED_PUNCTUATION_LOCALES[typedLocale];
+          const content = await loader();
+          const strings = translatableStrings(content as Record<string, unknown>);
+          const missingQuestions = strings.flatMap((text) =>
+            findMissingInvertedMarks(text, rule.questionStart, rule.questionEnd)
+          );
+          const missingExclamations = strings.flatMap((text) =>
+            findMissingInvertedMarks(text, rule.exclamationStart, rule.exclamationEnd)
+          );
+          const failures = [...missingQuestions, ...missingExclamations];
+
+          expect(
+            failures,
+            [
+              `Missing opening punctuation marks in ${tool.entry.id}/${typedLocale} (${rule.language}).`,
+              `Questions must use ${rule.questionStart}...${rule.questionEnd} and exclamations must use ${rule.exclamationStart}...${rule.exclamationEnd}.`,
+              `Examples: ${failures.slice(0, 5).join(' | ')}`,
+            ].join(' '),
+          ).toHaveLength(0);
+        });
+      });
+    });
+  });
+});

package/src/tests/locale_completeness.test.ts

@@ -7,28 +7,18 @@ describe('Locale Completeness Validation', () => {
     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 () => {
+          it('faq should be defined', 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();
-            }
+            expect(Array.isArray(content.faq)).toBe(true);
           });
 
-          it('bibliographyTitle should be defined when bibliography items exist', async () => {
+          it('bibliography should be defined', 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();
-            }
+            expect(Array.isArray(content.bibliography)).toBe(true);
           });
         });
       });

package/src/tests/no_en_dash.test.ts

@@ -0,0 +1,70 @@
+import { describe, it, expect } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+
+function getFiles(dir: 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()) {
+      if (file !== 'tests' && file !== 'node_modules' && file !== '.astro') {
+        results.push(...getFiles(fullPath));
+      }
+    } else {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
+function isContentFile(filePath: string): boolean {
+  return /\\i18n\\/.test(filePath) || filePath.endsWith('bibliography.ts');
+}
+
+const srcDir = path.join(process.cwd(), 'src');
+const scriptsDir = path.join(process.cwd(), 'scripts');
+const filesToTest = [
+  ...getFiles(srcDir).filter(isContentFile),
+  ...getFiles(scriptsDir).filter(isContentFile),
+];
+
+const aiTypographyGarbage = [
+  '\u2013',
+  '\u2014',
+  '\u2026',
+  '\u201C',
+  '\u201D',
+  '\u2018',
+  '\u2019',
+  '\u00AB',
+  '\u00BB',
+  '\u200B',
+  '\u201E',
+];
+
+describe('Typography Garbage Character Validation', () => {
+  filesToTest.forEach((filePath) => {
+    const relativePath = path.relative(process.cwd(), filePath);
+    it(`should not contain typography garbage characters in ${relativePath}`, () => {
+      const content = fs.readFileSync(filePath, 'utf-8');
+      const hasAiPatterns = aiTypographyGarbage.some(char => content.includes(char));
+      expect(hasAiPatterns).toBe(false);
+    });
+
+    it(`should not contain space before colon in ${relativePath}`, () => {
+      const content = fs.readFileSync(filePath, 'utf-8');
+      const spaceBeforeColon = / : /.test(content);
+      expect(spaceBeforeColon).toBe(false);
+    });
+
+    it(`should not contain double hyphen in ${relativePath}`, () => {
+      const content = fs.readFileSync(filePath, 'utf-8');
+      expect(content).not.toContain('--');
+    });
+  });
+});