@jjlmoya/utils-streaming 1.12.0 → 1.13.0

package/package.json

@@ -1,13 +1,15 @@
 {
     "name": "@jjlmoya/utils-streaming",
-    "version": "1.12.0",
+    "version": "1.13.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/de.ts

@@ -96,7 +96,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'paragraph',
-      html: 'Erfolgreiche Creator nutzen Verhaltenspsychologie: Belohnungen nach variablen Quoten, Community-Meilensteine, saisonale Events. Unsere Tools automatisieren die Zufallslogik, sodass Sie sich auf Ihr kreatives Talent konzentrieren können: Unterhalten, Bilden, Verbinden. Die technische „Infrastruktur“ ist gelöst.',
+      html: 'Erfolgreiche Creator nutzen Verhaltenspsychologie: Belohnungen nach variablen Quoten, Community-Meilensteine, saisonale Events. Unsere Tools automatisieren die Zufallslogik, sodass Sie sich auf Ihr kreatives Talent konzentrieren können: Unterhalten, Bilden, Verbinden. Die technische \"Infrastruktur\" ist gelöst.',
     },
     {
       type: 'title',

package/src/category/i18n/fr.ts

@@ -8,7 +8,7 @@ export const content: CategoryLocaleContent = {
   seo: [
     {
       type: 'title',
-      text: 'Écosystème de Streaming 2026 : Interaction et Souveraineté Réseau',
+      text: 'Écosystème de Streaming 2026: Interaction et Souveraineté Réseau',
       level: 2,
     },
     {
@@ -21,7 +21,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'title',
-      text: 'Gamification et Communauté : Tirages au Sort et Concours Transparents',
+      text: 'Gamification et Communauté: Tirages au Sort et Concours Transparents',
       level: 2,
     },
     {
@@ -34,7 +34,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'title',
-      text: 'Audit Réseau et Neutralité : Tebas-Check',
+      text: 'Audit Réseau et Neutralité: Tebas-Check',
       level: 2,
     },
     {
@@ -61,12 +61,12 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'title',
-      text: 'Gestion de Communauté : Modèles de Modération et de Sécurité',
+      text: 'Gestion de Communauté: Modèles de Modération et de Sécurité',
       level: 2,
     },
     {
       type: 'paragraph',
-      html: 'La communauté est l\'atout le plus précieux d\'un streamer. Cependant, croître sans structure est chaotique. Une communauté de 500 personnes est facile à gérer seul, mais à 5000, vous avez besoin de systèmes, de règles claires et d\'outils de modération. Nos utilitaires incluent des générateurs de tirages au sort qui fonctionnent également comme des systèmes de participation fair-play : chaque utilisateur inscrit a exactement la même probabilité de gagner, sans favoritisme.',
+      html: 'La communauté est l\'atout le plus précieux d\'un streamer. Cependant, croître sans structure est chaotique. Une communauté de 500 personnes est facile à gérer seul, mais à 5000, vous avez besoin de systèmes, de règles claires et d\'outils de modération. Nos utilitaires incluent des générateurs de tirages au sort qui fonctionnent également comme des systèmes de participation fair-play: chaque utilisateur inscrit a exactement la même probabilité de gagner, sans favoritisme.',
     },
     {
       type: 'paragraph',
@@ -74,7 +74,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'title',
-      text: 'Infrastructure et Résilience : Quand le FAI s\'interpose',
+      text: 'Infrastructure et Résilience: Quand le FAI s\'interpose',
       level: 2,
     },
     {
@@ -83,29 +83,29 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'paragraph',
-      html: 'Savoir si votre connexion est auditée ou bloquée vous donne du pouvoir : vous pouvez changer de FAI, utiliser des proxies légaux ou simplifier votre infrastructure en fonction de ce que vous découvrez. Un direct qui souffre de coupures inattendues ou de lag pourrait être dû à des blocages réseau, pas à votre équipement.',
+      html: 'Savoir si votre connexion est auditée ou bloquée vous donne du pouvoir: vous pouvez changer de FAI, utiliser des proxies légaux ou simplifier votre infrastructure en fonction de ce que vous découvrez. Un direct qui souffre de coupures inattendues ou de lag pourrait être dû à des blocages réseau, pas à votre équipement.',
     },
     {
       type: 'title',
-      text: 'Monétisation Durable : Du Direct aux Revenus Stables',
+      text: 'Monétisation Durable: Du Direct aux Revenus Stables',
       level: 2,
     },
     {
       type: 'paragraph',
-      html: 'Faire du streaming une carrière durable nécessite une diversification. Abonnements, dons, publicité, merchandising, cours : chaque source nécessite une audience engagée. Les outils de gamification comme les tirages au sort ne sont pas seulement du divertissement ; ce sont des mécanismes psychologiques qui augmentent la rétention.',
+      html: 'Faire du streaming une carrière durable nécessite une diversification. Abonnements, dons, publicité, merchandising, cours: chaque source nécessite une audience engagée. Les outils de gamification comme les tirages au sort ne sont pas seulement du divertissement ; ce sont des mécanismes psychologiques qui augmentent la rétention.',
     },
     {
       type: 'paragraph',
-      html: 'Les créateurs qui réussissent utilisent la psychologie comportementale : renforcement à ratio variable, étapes communautaires, événements saisonniers. Nos outils automatisent la logique aléatoire pour que vous puissiez vous concentrer sur votre talent créatif : divertir, éduquer, connecter. La "tuyauterie" technique est résolue.',
+      html: 'Les créateurs qui réussissent utilisent la psychologie comportementale: renforcement à ratio variable, étapes communautaires, événements saisonniers. Nos outils automatisent la logique aléatoire pour que vous puissiez vous concentrer sur votre talent créatif: divertir, éduquer, connecter. La "tuyauterie" technique est résolue.',
     },
     {
       type: 'title',
-      text: 'Omnicanalité : Le Streaming Fragmenté Nécessite des Outils Unifiés',
+      text: 'Omnicanalité: Le Streaming Fragmenté Nécessite des Outils Unifiés',
       level: 2,
     },
     {
       type: 'paragraph',
-      html: 'Un streamer moderne ne diffuse pas seulement sur Twitch. Il diffuse simultanément sur Twitch, YouTube, Kick, Twitter/X. Cela signifie que votre tirage au sort doit être équitable même si les participants proviennent de plusieurs plateformes. Nos outils sont agnostiques vis-à-vis de la plateforme : vous importez une liste d\'utilisateurs, vous lancez le sélecteur, vous obtenez un gagnant transparent.',
+      html: 'Un streamer moderne ne diffuse pas seulement sur Twitch. Il diffuse simultanément sur Twitch, YouTube, Kick, Twitter/X. Cela signifie que votre tirage au sort doit être équitable même si les participants proviennent de plusieurs plateformes. Nos outils sont agnostiques vis-à-vis de la plateforme: vous importez une liste d\'utilisateurs, vous lancez le sélecteur, vous obtenez un gagnant transparent.',
     },
     {
       type: 'paragraph',

package/src/category/i18n/pl.ts

@@ -17,7 +17,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'paragraph',
-      html: 'Od uczciwego i przejrzystego zarządzania losowaniami na żywo po audyt cenzury sieciowej i blokad stosowanych przez dostawców Internetu – nasze narzędzia dają Ci niezbędną kontrolę w konkurencyjnym świecie tworzenia treści na żywo.',
+      html: 'Od uczciwego i przejrzystego zarządzania losowaniami na żywo po audyt cenzury sieciowej i blokad stosowanych przez dostawców Internetu - nasze narzędzia dają Ci niezbędną kontrolę w konkurencyjnym świecie tworzenia treści na żywo.',
     },
     {
       type: 'title',
@@ -87,7 +87,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'title',
-      text: 'Zrównoważona monetyzacja: Od live’a do stabilnego dochodu',
+      text: 'Zrównoważona monetyzacja: Od live\'a do stabilnego dochodu',
       level: 2,
     },
     {

package/src/category/i18n/ru.ts

@@ -13,7 +13,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'paragraph',
-      html: 'Стриминг превратился из простой передачи видео в сложную интерактивную и социальную среду. В этом разделе мы предлагаем <strong>бесплатные онлайн-инструменты</strong>, разработанные для стримеров Twitch, YouTube и Kick, которые стремятся профессионализировать свой контент и защитить свою техническую инфраструктуру. Способность динамизировать ваше сообщество и обеспечивать доступность ваших ресурсов — основа успешного канала.',
+      html: 'Стриминг превратился из простой передачи видео в сложную интерактивную и социальную среду. В этом разделе мы предлагаем <strong>бесплатные онлайн-инструменты</strong>, разработанные для стримеров Twitch, YouTube и Kick, которые стремятся профессионализировать свой контент и защитить свою техническую инфраструктуру. Способность динамизировать ваше сообщество и обеспечивать доступность ваших ресурсов - основа успешного канала.',
     },
     {
       type: 'paragraph',
@@ -26,7 +26,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'paragraph',
-      html: 'Геймификация — ключ к удержанию аудитории. Наш <strong>инструмент для розыгрышей и конкурсов</strong> позволяет выбирать случайных победителей полностью прозрачным способом. Благодаря локальной обработке на вашем терминале вы гарантируете отсутствие внешних манипуляций, что способствует доверию подписчиков во время живых розыгрышей.',
+      html: 'Геймификация - ключ к удержанию аудитории. Наш <strong>инструмент для розыгрышей и конкурсов</strong> позволяет выбирать случайных победителей полностью прозрачным способом. Благодаря локальной обработке на вашем терминале вы гарантируете отсутствие внешних манипуляций, что способствует доверию подписчиков во время живых розыгрышей.',
     },
     {
       type: 'tool',
@@ -39,7 +39,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'paragraph',
-      html: 'В цифровой среде 2026 года судебные блокировки и ограничения провайдеров могут повлиять на стабильность вашего стрима или доступ вашего сообщества к вашим ресурсам. <strong>Tebas-Check</strong> — это инструмент технической диагностики, который определяет, применяет ли ваш оператор цензуру или превентивные блокировки на инфраструктурах, таких как Cloudflare или других контент-провайдерах, позволяя вам проводить аудит нейтральности вашей сети.',
+      html: 'В цифровой среде 2026 года судебные блокировки и ограничения провайдеров могут повлиять на стабильность вашего стрима или доступ вашего сообщества к вашим ресурсам. <strong>Tebas-Check</strong> - это инструмент технической диагностики, который определяет, применяет ли ваш оператор цензуру или превентивные блокировки на инфраструктурах, таких как Cloudflare или других контент-провайдерах, позволяя вам проводить аудит нейтральности вашей сети.',
     },
     {
       type: 'tool',
@@ -57,7 +57,7 @@ export const content: CategoryLocaleContent = {
     {
       type: 'tip',
       title: 'Профессиональный девиз прямого эфира',
-      html: '<p><strong>Прозрачность:</strong> при проведении розыгрыша не забудьте захватить экран, на котором запущен инструмент. Демонстрация вашему сообществу процесса случайного выбора в реальном времени — лучший способ построить доверительные отношения и долгосрочную лояльность.</p>',
+      html: '<p><strong>Прозрачность:</strong> при проведении розыгрыша не забудьте захватить экран, на котором запущен инструмент. Демонстрация вашему сообществу процесса случайного выбора в реальном времени - лучший способ построить доверительные отношения и долгосрочную лояльность.</p>',
     },
     {
       type: 'title',
@@ -66,7 +66,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'paragraph',
-      html: 'Сообщество — самый ценный актив стримера. Рост без структуры хаотичен. Сообществом из 500 человек можно управлять в одиночку, но при 5000 вам нужны системы, четкие правила и инструменты модерации. Наши утилиты включают генераторы розыгрышей, которые также работают как системы честного участия: каждый зарегистрированный пользователь имеет абсолютно равные шансы на победу.',
+      html: 'Сообщество - самый ценный актив стримера. Рост без структуры хаотичен. Сообществом из 500 человек можно управлять в одиночку, но при 5000 вам нужны системы, четкие правила и инструменты модерации. Наши утилиты включают генераторы розыгрышей, которые также работают как системы честного участия: каждый зарегистрированный пользователь имеет абсолютно равные шансы на победу.',
     },
     {
       type: 'paragraph',
@@ -92,7 +92,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'paragraph',
-      html: 'Превращение стриминга в устойчивую карьеру требует диверсификации. Подписки, донаты, реклама, мерч, курсы: каждый источник нуждается в вовлеченной аудитории. Инструменты геймификации, такие как розыгрыши, — это не просто развлечение; это психологические механизмы, повышающие удержание.',
+      html: 'Превращение стриминга в устойчивую карьеру требует диверсификации. Подписки, донаты, реклама, мерч, курсы: каждый источник нуждается в вовлеченной аудитории. Инструменты геймификации, такие как розыгрыши, - это не просто развлечение; это психологические механизмы, повышающие удержание.',
     },
     {
       type: 'paragraph',
@@ -109,7 +109,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'paragraph',
-      html: 'Этот омниканальный подход — будущее. Фрагментация платформ необратима, и процветают те авторы, которые быстро адаптируются. Наличие набора утилит, работающих на любой платформе, является конкурентным преимуществом.',
+      html: 'Этот омниканальный подход - будущее. Фрагментация платформ необратима, и процветают те авторы, которые быстро адаптируются. Наличие набора утилит, работающих на любой платформе, является конкурентным преимуществом.',
     },
     {
       type: 'title',

package/src/category/i18n/zh.ts

@@ -96,7 +96,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'paragraph',
-      html: '成功的创作者利用行为心理学：可变比例强化、社区里程碑、季节性活动。我们的工具自动化了随机逻辑，因此您可以专注于您的创意天赋：娱乐、教育、连接。技术“管道”问题已解决。',
+      html: '成功的创作者利用行为心理学：可变比例强化、社区里程碑、季节性活动。我们的工具自动化了随机逻辑，因此您可以专注于您的创意天赋：娱乐、教育、连接。技术\"管道\"问题已解决。',
     },
     {
       type: 'title',

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 {
@@ -114,4 +120,3 @@ const { title, currentLocale = "es", localeUrls = {}, hasSidebar = false } = Ast
     }
   }
 </style>
-

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/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('--');
+    });
+  });
+});