@jjlmoya/utils-language 1.1.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-language",
-    "version": "1.1.0",
+    "version": "1.3.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

package/src/category/i18n/de.ts

@@ -1,6 +1,7 @@
-import { createLanguageCategory } from './shared';
+import type { CategoryLocaleContent } from '../../types';
 
-export const content = createLanguageCategory({
+export const content: CategoryLocaleContent = {
+  slug: 'sprachen',
   title: 'Werkzeuge zum Sprachenlernen',
   description: 'Private Browser Werkzeuge, die Sprachlernziele in praktische Lernplaene, Wochenroutinen und messbare Meilensteine verwandeln.',
   seo: [
@@ -12,4 +13,4 @@ export const content = createLanguageCategory({
     { type: 'paragraph', html: 'Auswahl, Niveau, Frist und Zeitplan bleiben im Browser. Es ist kein Konto erforderlich und die Eingaben werden nicht an einen Server gesendet.' },
     { type: 'stats', items: [{ label: 'Werkzeug', value: '1', icon: 'mdi:tools' }, { label: 'Niveaus', value: 'A0 bis C2', icon: 'mdi:stairs-up' }, { label: 'Sprachen', value: '10', icon: 'mdi:translate' }, { label: 'Privatsphaere', value: 'Lokal', icon: 'mdi:shield-check' }] },
   ],
-});
+};

package/src/category/i18n/es.ts

@@ -1,6 +1,7 @@
-import { createLanguageCategory } from './shared';
+import type { CategoryLocaleContent } from '../../types';
 
-export const content = createLanguageCategory({
+export const content: CategoryLocaleContent = {
+  slug: 'idiomas',
   title: 'Herramientas para aprender idiomas',
   description: 'Herramientas privadas en el navegador para convertir objetivos lingüísticos en planes de estudio, sesiones semanales e hitos medibles.',
   seo: [
@@ -12,4 +13,4 @@ export const content = createLanguageCategory({
     { type: 'paragraph', html: 'Tus idiomas, nivel, fecha y horario se quedan en el navegador. No necesitas una cuenta y tus datos no se envían a un servidor.' },
     { type: 'stats', items: [{ label: 'Herramienta', value: '1', icon: 'mdi:tools' }, { label: 'Niveles', value: 'A0 a C2', icon: 'mdi:stairs-up' }, { label: 'Idiomas', value: '10', icon: 'mdi:translate' }, { label: 'Privacidad', value: 'Local', icon: 'mdi:shield-check' }] },
   ],
-});
+};

package/src/category/i18n/fr.ts

@@ -1,6 +1,7 @@
-import { createLanguageCategory } from './shared';
+import type { CategoryLocaleContent } from '../../types';
 
-export const content = createLanguageCategory({
+export const content: CategoryLocaleContent = {
+  slug: 'langues',
   title: 'Outils pour apprendre les langues',
   description: 'Des outils privés dans le navigateur pour transformer des objectifs linguistiques en plans pratiques, séances hebdomadaires et jalons mesurables.',
   seo: [
@@ -12,4 +13,4 @@ export const content = createLanguageCategory({
     { type: 'paragraph', html: 'Vos choix de langue, votre niveau, votre date et votre rythme restent dans le navigateur. Aucun compte n est nécessaire et vos données ne sont pas envoyées à un serveur.' },
     { type: 'stats', items: [{ label: 'Outil', value: '1', icon: 'mdi:tools' }, { label: 'Niveaux', value: 'A0 à C2', icon: 'mdi:stairs-up' }, { label: 'Langues', value: '10', icon: 'mdi:translate' }, { label: 'Confidentialité', value: 'Locale', icon: 'mdi:shield-check' }] },
   ],
-});
+};

package/src/category/i18n/id.ts

@@ -1,6 +1,7 @@
-import { createLanguageCategory } from './shared';
+import type { CategoryLocaleContent } from '../../types';
 
-export const content = createLanguageCategory({
+export const content: CategoryLocaleContent = {
+  slug: 'bahasa',
   title: 'Alat Belajar Bahasa',
   description: 'Alat privat berbasis browser untuk mengubah tujuan belajar bahasa menjadi rencana praktis, sesi mingguan, dan pencapaian yang terukur.',
   seo: [
@@ -12,4 +13,4 @@ export const content = createLanguageCategory({
     { type: 'paragraph', html: 'Pilihan bahasa, level, tanggal, dan jadwal tetap berada di browser. Tidak perlu akun dan masukan Anda tidak dikirim ke server.' },
     { type: 'stats', items: [{ label: 'Alat', value: '1', icon: 'mdi:tools' }, { label: 'Level', value: 'A0 sampai C2', icon: 'mdi:stairs-up' }, { label: 'Bahasa', value: '10', icon: 'mdi:translate' }, { label: 'Privasi', value: 'Lokal', icon: 'mdi:shield-check' }] },
   ],
-});
+};

package/src/category/i18n/it.ts

@@ -1,6 +1,7 @@
-import { createLanguageCategory } from './shared';
+import type { CategoryLocaleContent } from '../../types';
 
-export const content = createLanguageCategory({
+export const content: CategoryLocaleContent = {
+  slug: 'lingue',
   title: 'Strumenti per imparare le lingue',
   description: 'Strumenti privati nel browser per trasformare gli obiettivi linguistici in piani pratici, sessioni settimanali e traguardi misurabili.',
   seo: [
@@ -12,4 +13,4 @@ export const content = createLanguageCategory({
     { type: 'paragraph', html: 'Le tue lingue, il livello, la data e il programma restano nel browser. Non serve un account e i dati non vengono inviati a un server.' },
     { type: 'stats', items: [{ label: 'Strumento', value: '1', icon: 'mdi:tools' }, { label: 'Livelli', value: 'A0 a C2', icon: 'mdi:stairs-up' }, { label: 'Lingue', value: '10', icon: 'mdi:translate' }, { label: 'Privacy', value: 'Locale', icon: 'mdi:shield-check' }] },
   ],
-});
+};

package/src/category/i18n/ja.ts

@@ -1,6 +1,7 @@
-import { createLanguageCategory } from './shared';
+import type { CategoryLocaleContent } from '../../types';
 
-export const content = createLanguageCategory({
+export const content: CategoryLocaleContent = {
+  slug: 'gengo',
   title: '語学学習ツール',
   description: '語学の目標を実用的な学習計画、毎週の学習時間、確認できる到達目安に変える、ブラウザーで使えるプライベートなツールです。',
   seo: [
@@ -12,4 +13,4 @@ export const content = createLanguageCategory({
     { type: 'paragraph', html: '言語、レベル、日付、予定はブラウザー内にとどまります。アカウントは不要で、入力内容をサーバーへ送信しません。' },
     { type: 'stats', items: [{ label: 'ツール', value: '1', icon: 'mdi:tools' }, { label: 'レベル', value: 'A0からC2', icon: 'mdi:stairs-up' }, { label: '言語', value: '10', icon: 'mdi:translate' }, { label: 'プライバシー', value: 'ローカル', icon: 'mdi:shield-check' }] },
   ],
-});
+};

package/src/category/i18n/ko.ts

@@ -1,6 +1,7 @@
-import { createLanguageCategory } from './shared';
+import type { CategoryLocaleContent } from '../../types';
 
-export const content = createLanguageCategory({
+export const content: CategoryLocaleContent = {
+  slug: 'eoneo',
   title: '언어 학습 도구',
   description: '언어 학습 목표를 실용적인 계획과 주간 학습 세션, 확인 가능한 중간 목표로 바꾸는 브라우저 기반 비공개 도구입니다.',
   seo: [
@@ -12,4 +13,4 @@ export const content = createLanguageCategory({
     { type: 'paragraph', html: '언어 선택, 수준, 날짜와 일정은 브라우저에 남습니다. 계정이 필요하지 않으며 입력값을 서버로 보내지 않습니다.' },
     { type: 'stats', items: [{ label: '도구', value: '1', icon: 'mdi:tools' }, { label: '수준', value: 'A0부터 C2', icon: 'mdi:stairs-up' }, { label: '언어', value: '10', icon: 'mdi:translate' }, { label: '개인정보', value: '로컬', icon: 'mdi:shield-check' }] },
   ],
-});
+};

package/src/category/i18n/nl.ts

@@ -1,6 +1,7 @@
-import { createLanguageCategory } from './shared';
+import type { CategoryLocaleContent } from '../../types';
 
-export const content = createLanguageCategory({
+export const content: CategoryLocaleContent = {
+  slug: 'talen',
   title: 'Hulpmiddelen voor taal leren',
   description: 'Private browsertools om taaldoelen om te zetten in praktische studieplannen, wekelijkse sessies en meetbare mijlpalen.',
   seo: [
@@ -12,4 +13,4 @@ export const content = createLanguageCategory({
     { type: 'paragraph', html: 'Je taalkeuzes, niveau, datum en schema blijven in de browser. Een account is niet nodig en je invoer wordt niet naar een server gestuurd.' },
     { type: 'stats', items: [{ label: 'Tool', value: '1', icon: 'mdi:tools' }, { label: 'Niveaus', value: 'A0 tot C2', icon: 'mdi:stairs-up' }, { label: 'Talen', value: '10', icon: 'mdi:translate' }, { label: 'Privacy', value: 'Lokaal', icon: 'mdi:shield-check' }] },
   ],
-});
+};

package/src/category/i18n/pl.ts

@@ -1,6 +1,7 @@
-import { createLanguageCategory } from './shared';
+import type { CategoryLocaleContent } from '../../types';
 
-export const content = createLanguageCategory({
+export const content: CategoryLocaleContent = {
+  slug: 'jezyki',
   title: 'Narzędzia do nauki języków',
   description: 'Prywatne narzędzia w przeglądarce, które zamieniają cele językowe w praktyczne plany, tygodniowe sesje i mierzalne kamienie milowe.',
   seo: [
@@ -12,4 +13,4 @@ export const content = createLanguageCategory({
     { type: 'paragraph', html: 'Wybrane języki, poziom, data i harmonogram pozostają w przeglądarce. Konto nie jest potrzebne, a dane nie są wysyłane na serwer.' },
     { type: 'stats', items: [{ label: 'Narzędzie', value: '1', icon: 'mdi:tools' }, { label: 'Poziomy', value: 'A0 do C2', icon: 'mdi:stairs-up' }, { label: 'Języki', value: '10', icon: 'mdi:translate' }, { label: 'Prywatność', value: 'Lokalnie', icon: 'mdi:shield-check' }] },
   ],
-});
+};

package/src/category/i18n/pt.ts

@@ -1,6 +1,7 @@
-import { createLanguageCategory } from './shared';
+import type { CategoryLocaleContent } from '../../types';
 
-export const content = createLanguageCategory({
+export const content: CategoryLocaleContent = {
+  slug: 'idiomas',
   title: 'Ferramentas para aprender idiomas',
   description: 'Ferramentas privadas no navegador para transformar metas linguísticas em planos práticos, sessões semanais e marcos mensuráveis.',
   seo: [
@@ -12,4 +13,4 @@ export const content = createLanguageCategory({
     { type: 'paragraph', html: 'Seus idiomas, nível, data e cronograma ficam no navegador. Não é preciso ter conta e suas entradas não são enviadas para um servidor.' },
     { type: 'stats', items: [{ label: 'Ferramenta', value: '1', icon: 'mdi:tools' }, { label: 'Níveis', value: 'A0 a C2', icon: 'mdi:stairs-up' }, { label: 'Idiomas', value: '10', icon: 'mdi:translate' }, { label: 'Privacidade', value: 'Local', icon: 'mdi:shield-check' }] },
   ],
-});
+};

package/src/category/i18n/ru.ts

@@ -1,6 +1,7 @@
-import { createLanguageCategory } from './shared';
+import type { CategoryLocaleContent } from '../../types';
 
-export const content = createLanguageCategory({
+export const content: CategoryLocaleContent = {
+  slug: 'yazyki',
   title: 'Инструменты для изучения языков',
   description: 'Приватные браузерные инструменты, которые превращают языковые цели в практичные планы, недельные занятия и измеримые промежуточные цели.',
   seo: [
@@ -12,4 +13,4 @@ export const content = createLanguageCategory({
     { type: 'paragraph', html: 'Выбранные языки, уровень, дата и расписание остаются в браузере. Учётная запись не нужна, а данные не отправляются на сервер.' },
     { type: 'stats', items: [{ label: 'Инструмент', value: '1', icon: 'mdi:tools' }, { label: 'Уровни', value: 'A0 до C2', icon: 'mdi:stairs-up' }, { label: 'Языки', value: '10', icon: 'mdi:translate' }, { label: 'Приватность', value: 'Локально', icon: 'mdi:shield-check' }] },
   ],
-});
+};

package/src/category/i18n/sv.ts

@@ -1,6 +1,7 @@
-import { createLanguageCategory } from './shared';
+import type { CategoryLocaleContent } from '../../types';
 
-export const content = createLanguageCategory({
+export const content: CategoryLocaleContent = {
+  slug: 'sprak',
   title: 'Verktyg för språkinlärning',
   description: 'Privata webbläsarverktyg som gör språkmål till praktiska studieplaner, veckopass och mätbara milstolpar.',
   seo: [
@@ -12,4 +13,4 @@ export const content = createLanguageCategory({
     { type: 'paragraph', html: 'Dina språkval, din nivå, ditt datum och ditt schema stannar i webbläsaren. Inget konto krävs och uppgifterna skickas inte till en server.' },
     { type: 'stats', items: [{ label: 'Verktyg', value: '1', icon: 'mdi:tools' }, { label: 'Nivåer', value: 'A0 till C2', icon: 'mdi:stairs-up' }, { label: 'Språk', value: '10', icon: 'mdi:translate' }, { label: 'Integritet', value: 'Lokalt', icon: 'mdi:shield-check' }] },
   ],
-});
+};

package/src/category/i18n/tr.ts

@@ -1,6 +1,7 @@
-import { createLanguageCategory } from './shared';
+import type { CategoryLocaleContent } from '../../types';
 
-export const content = createLanguageCategory({
+export const content: CategoryLocaleContent = {
+  slug: 'diller',
   title: 'Dil öğrenme araçları',
   description: 'Dil hedeflerini pratik planlara, haftalık çalışma oturumlarına ve ölçülebilir kilometre taşlarına dönüştüren özel tarayıcı araçları.',
   seo: [
@@ -12,4 +13,4 @@ export const content = createLanguageCategory({
     { type: 'paragraph', html: 'Dil seçimlerin, seviyen, tarihin ve programın tarayıcıda kalır. Hesap gerekmez ve girdilerin sunucuya gönderilmez.' },
     { type: 'stats', items: [{ label: 'Araç', value: '1', icon: 'mdi:tools' }, { label: 'Seviyeler', value: 'A0 ile C2', icon: 'mdi:stairs-up' }, { label: 'Diller', value: '10', icon: 'mdi:translate' }, { label: 'Gizlilik', value: 'Yerel', icon: 'mdi:shield-check' }] },
   ],
-});
+};

package/src/category/i18n/zh.ts

@@ -1,6 +1,7 @@
-import { createLanguageCategory } from './shared';
+import type { CategoryLocaleContent } from '../../types';
 
-export const content = createLanguageCategory({
+export const content: CategoryLocaleContent = {
+  slug: 'yuyan',
   title: '语言学习工具',
   description: '在浏览器中使用的隐私工具，将语言目标转化为实用的学习计划、每周练习和可衡量的阶段目标。',
   seo: [
@@ -12,4 +13,4 @@ export const content = createLanguageCategory({
     { type: 'paragraph', html: '你选择的语言、等级、日期和安排都保留在浏览器中。不需要账号，输入内容也不会发送到服务器。' },
     { type: 'stats', items: [{ label: '工具', value: '1', icon: 'mdi:tools' }, { label: '等级', value: 'A0 到 C2', icon: 'mdi:stairs-up' }, { label: '语言', value: '10', icon: 'mdi:translate' }, { label: '隐私', value: '本地', icon: 'mdi:shield-check' }] },
   ],
-});
+};

package/src/tests/category_quality.test.ts

@@ -0,0 +1,94 @@
+import { describe, expect, it } from 'vitest';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { languageCategory } from '../data';
+
+const EXPECTED_LOCALES = ['de', 'en', 'es', 'fr', 'id', 'it', 'ja', 'ko', 'nl', 'pl', 'pt', 'ru', 'sv', 'tr', 'zh'] as const;
+const EXPECTED_SLUGS = {
+  de: 'sprachen', en: 'language', es: 'idiomas', fr: 'langues', id: 'bahasa',
+  it: 'lingue', ja: 'gengo', ko: 'eoneo', nl: 'talen', pl: 'jezyki', pt: 'idiomas',
+  ru: 'yazyki', sv: 'sprak', tr: 'diller', zh: 'yuyan',
+} as const;
+const CATEGORY_DIR = join(process.cwd(), 'src', 'category', 'i18n');
+const SEO_TYPES = new Set(['title', 'paragraph', 'list', 'stats']);
+
+type CategoryContent = {
+  slug: string;
+  title: string;
+  description: string;
+  seo: Array<Record<string, unknown>>;
+};
+
+function sectionText(section: Record<string, unknown>): string {
+  const value = section.text ?? section.html ?? '';
+  return typeof value === 'string' ? value.replace(/<[^>]*>/g, '').trim() : '';
+}
+
+describe('Language category quality', () => {
+  it('has one registered category with a usable icon and unique tools', () => {
+    expect(languageCategory.icon.trim()).not.toBe('');
+    expect(languageCategory.tools.length).toBeGreaterThan(0);
+    const ids = languageCategory.tools.map((tool) => tool.id);
+    expect(new Set(ids).size).toBe(ids.length);
+  });
+
+  it('declares every locale in the category registry', () => {
+    expect(Object.keys(languageCategory.i18n).sort()).toEqual([...EXPECTED_LOCALES].sort());
+    for (const locale of EXPECTED_LOCALES) {
+      expect(typeof languageCategory.i18n[locale]).toBe('function');
+    }
+  });
+
+  it('keeps each locale source independent and explicit about its slug', () => {
+    expect(existsSync(join(CATEGORY_DIR, 'shared.ts'))).toBe(false);
+    for (const locale of EXPECTED_LOCALES) {
+      const source = readFileSync(join(CATEGORY_DIR, `${locale}.ts`), 'utf8');
+      expect(source, `${locale}.ts must declare its own slug`).toMatch(/(?:const\s+slug\s*=|\bslug\s*:)/);
+      expect(source, `${locale}.ts must not import a shared category translation`).not.toContain("from './shared'");
+    }
+  });
+
+  it('uses valid localized slugs and complete metadata in every locale', async () => {
+    for (const locale of EXPECTED_LOCALES) {
+      const content = await languageCategory.i18n[locale]!() as CategoryContent;
+      expect(content.slug).toBe(EXPECTED_SLUGS[locale]);
+      expect(content.slug).toMatch(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
+      expect(content.title.length).toBeGreaterThanOrEqual(5);
+      expect(content.title.length).toBeLessThanOrEqual(70);
+      expect(content.description.length).toBeGreaterThanOrEqual(20);
+      expect(content.description.length).toBeLessThanOrEqual(220);
+      expect(content.title).not.toMatch(/[|]/);
+      expect(content.description).not.toContain('\uFFFD');
+      expect(content.seo.length).toBeGreaterThan(0);
+    }
+  });
+
+  it('keeps SEO structure and useful text in parity with English', async () => {
+    const english = await languageCategory.i18n.en!() as CategoryContent;
+    const englishTypes = english.seo.map((section) => section.type);
+
+    for (const locale of EXPECTED_LOCALES) {
+      const content = await languageCategory.i18n[locale]!() as CategoryContent;
+      expect(content.seo.map((section) => section.type), locale).toEqual(englishTypes);
+      if (locale !== 'en') {
+        expect(content.title).not.toBe(english.title);
+      }
+
+      for (const section of content.seo) {
+        expect(SEO_TYPES.has(String(section.type)), `${locale} has an unsupported SEO section type`).toBe(true);
+        const text = sectionText(section);
+        if (section.type === 'title') {
+          expect(text.length, `${locale} SEO title is empty`).toBeGreaterThanOrEqual(8);
+        }
+        if (section.type === 'paragraph') {
+          expect(text.length, `${locale} SEO paragraph is too short`).toBeGreaterThanOrEqual(20);
+        }
+        if (section.type === 'stats') {
+          expect(Array.isArray(section.items), `${locale} SEO stats need items`).toBe(true);
+          expect((section.items as unknown[]).length).toBeGreaterThan(0);
+        }
+        expect(JSON.stringify(section)).not.toContain('\uFFFD');
+      }
+    }
+  });
+});

package/src/tests/category_slug_localization.test.ts

@@ -0,0 +1,29 @@
+import { describe, expect, it } from 'vitest';
+import { languageCategory } from '../data';
+
+const EXPECTED_SLUGS = {
+  de: 'sprachen',
+  en: 'language',
+  es: 'idiomas',
+  fr: 'langues',
+  id: 'bahasa',
+  it: 'lingue',
+  ja: 'gengo',
+  ko: 'eoneo',
+  nl: 'talen',
+  pl: 'jezyki',
+  pt: 'idiomas',
+  ru: 'yazyki',
+  sv: 'sprak',
+  tr: 'diller',
+  zh: 'yuyan',
+} as const;
+
+describe('Category slug localization', () => {
+  it('declares a localized slug in every category locale file', async () => {
+    for (const [locale, expectedSlug] of Object.entries(EXPECTED_SLUGS)) {
+      const content = await languageCategory.i18n[locale as keyof typeof languageCategory.i18n]!();
+      expect(content.slug, `Unexpected category slug for locale "${locale}"`).toBe(expectedSlug);
+    }
+  });
+});

package/src/tests/qa-test-helpers.ts

@@ -0,0 +1,31 @@
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+
+export const repositoryRoot = process.cwd();
+export const toolRoot = join(repositoryRoot, 'src', 'tool');
+
+export function listToolDirectories(): string[] {
+  return readdirSync(toolRoot)
+    .map((name) => join(toolRoot, name))
+    .filter((path) => statSync(path).isDirectory());
+}
+
+export function findFiles(directory: string, extensions: string[]): string[] {
+  const files: string[] = [];
+
+  for (const entry of readdirSync(directory, { withFileTypes: true })) {
+    const path = join(directory, entry.name);
+    if (entry.isDirectory()) files.push(...findFiles(path, extensions));
+    else if (extensions.some((extension) => entry.name.endsWith(extension))) files.push(path);
+  }
+
+  return files;
+}
+
+export function read(path: string): string {
+  return readFileSync(path, 'utf8');
+}
+
+export function displayPath(path: string): string {
+  return relative(repositoryRoot, path).replace(/\\/g, '/');
+}

package/src/tests/qa_bibliography_links.test.ts

@@ -0,0 +1,50 @@
+import { describe, expect, it } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import type { ToolLocaleContent } from '../types';
+
+interface LinkFailure {
+  tool: string;
+  message: string;
+}
+
+function validateLink(tool: string, entry: { url: string }, seen: Set<string>): LinkFailure[] {
+  const failures: LinkFailure[] = [];
+  let url: URL;
+  try {
+    url = new URL(entry.url);
+  } catch {
+    return [{ tool, message: `invalid URL: ${entry.url}` }];
+  }
+
+  if (url.protocol !== 'https:') {
+    failures.push({ tool, message: `non-HTTPS URL: ${entry.url}` });
+  }
+  if (url.pathname === '/' && !url.search && !url.hash) {
+    failures.push({ tool, message: `generic homepage, cite the exact document: ${entry.url}` });
+  }
+  if (seen.has(url.href)) {
+    failures.push({ tool, message: `duplicate source URL: ${entry.url}` });
+  }
+  seen.add(url.href);
+  return failures;
+}
+
+async function validateTool(tool: typeof ALL_TOOLS[number]): Promise<LinkFailure[]> {
+  const loader = tool.entry.i18n.en;
+  if (!loader) {
+    return [{ tool: tool.entry.id, message: 'English locale loader is missing' }];
+  }
+
+  const content = (await loader()) as ToolLocaleContent;
+  const seen = new Set<string>();
+  return (content.bibliography ?? []).flatMap((entry) => validateLink(tool.entry.id, entry, seen));
+}
+
+describe('QA: bibliography links are specific and usable', () => {
+  it('uses unique HTTPS links to exact source pages instead of generic homepages', async () => {
+    const failures = (await Promise.all(ALL_TOOLS.map(validateTool))).flat();
+
+    const messages = failures.map(({ tool, message }) => `${tool}: ${message}`);
+    expect(messages, `Bibliography hygiene failures:\n${messages.join('\n')}`).toEqual([]);
+  });
+});

package/src/tests/qa_claim_evidence.test.ts

@@ -0,0 +1,68 @@
+import { describe, expect, it } from 'vitest';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { displayPath, listToolDirectories, read } from './qa-test-helpers';
+
+const evidenceClaims = [
+  /\bofficial algorithm\b/i,
+  /\balgoritmo oficial\b/i,
+  /\b(?:records|data|rates|tables) updated(?:\s+(?:to|through)\s+20\d{2})?\b/i,
+  /\b(?:registros|datos|tasas|tablas) actualizad[oa]s?(?:\s+(?:a|hasta)\s+20\d{2})?\b/i,
+  /\b(?:validated|verified) (?:method|algorithm|calculation)\b/i,
+  /\b(?:método|algoritmo|cálculo) (?:validado|verificado)\b/i,
+  /\b(?:guarantees|ensures)\b/i,
+  /\bgarantiza\b/i,
+  /\bofficial (?:data|rate|calculation)\b/i,
+  /\b(?:datos|tasa|cálculo) oficial(?:es)?\b/i,
+];
+
+const requiredEvidenceFields = [
+  'reviewedAt',
+  'methodology',
+  'sources',
+  'referenceCases',
+  'limitations',
+];
+
+describe('QA: strong factual claims are traceable', () => {
+  it('requires machine-readable validation evidence beside tools making strong claims', () => {
+    const failures: string[] = [];
+
+    for (const directory of listToolDirectories()) {
+      const localePaths = ['en', 'es']
+        .map((locale) => join(directory, 'i18n', `${locale}.ts`))
+        .filter(existsSync);
+      const claims = localePaths.flatMap((path) => {
+        const source = read(path);
+        return evidenceClaims
+          .filter((pattern) => pattern.test(source))
+          .map((pattern) => `${displayPath(path)} matches ${pattern.source}`);
+      });
+      if (claims.length === 0) continue;
+
+      const evidencePath = join(directory, 'validation.ts');
+      if (!existsSync(evidencePath)) {
+        failures.push(`${displayPath(evidencePath)} missing; claims: ${claims.join(' | ')}`);
+        continue;
+      }
+
+      const evidence = read(evidencePath);
+      const missingFields = requiredEvidenceFields.filter(
+        (field) => !new RegExp(`\\b${field}\\s*:`).test(evidence),
+      );
+      if (missingFields.length > 0) {
+        failures.push(`${displayPath(evidencePath)} missing fields: ${missingFields.join(', ')}`);
+      }
+    }
+
+    expect(
+      failures,
+      [
+        'Claims such as official, validated, guaranteed or updated need inspectable evidence.',
+        'Add validation.ts with reviewedAt, methodology, sources, referenceCases and limitations,',
+        'or weaken/remove the unsupported claim.',
+        ...failures,
+      ].join('\n'),
+    ).toEqual([]);
+  });
+});

package/src/tests/qa_logic_reference_coverage.test.ts

@@ -0,0 +1,45 @@
+import { describe, expect, it } from 'vitest';
+import { basename, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import {
+  displayPath,
+  findFiles,
+  listToolDirectories,
+  read,
+  repositoryRoot,
+} from './qa-test-helpers';
+
+function hasDedicatedLogicTest(toolDirectory: string): boolean {
+  const localCandidates = [
+    join(toolDirectory, 'logic.test.ts'),
+    join(toolDirectory, 'logic.spec.ts'),
+    join(toolDirectory, '__tests__', 'logic.test.ts'),
+    join(toolDirectory, '__tests__', 'logic.spec.ts'),
+  ];
+  if (localCandidates.some(existsSync)) return true;
+
+  const toolName = basename(toolDirectory);
+  const centralTests = findFiles(join(repositoryRoot, 'src', 'tests'), ['.test.ts', '.spec.ts']);
+  return centralTests.some((testPath) => {
+    const source = read(testPath).replace(/\\/g, '/');
+    return source.includes(`/tool/${toolName}/logic`) || source.includes(`../tool/${toolName}/logic`);
+  });
+}
+
+describe('QA: calculation logic has reference tests', () => {
+  it('gives every public calculator logic module its own behavioral test suite', () => {
+    const failures = listToolDirectories()
+      .filter((directory) => existsSync(join(directory, 'logic.ts')))
+      .filter((directory) => !hasDedicatedLogicTest(directory))
+      .map((directory) => `${displayPath(join(directory, 'logic.ts'))} -> no test imports this module`);
+
+    expect(
+      failures,
+      [
+        'Add behavioral tests through each logic module public API.',
+        'At minimum cover a documented reference case, boundaries, invalid input and invariants.',
+        ...failures,
+      ].join('\n'),
+    ).toEqual([]);
+  });
+});

package/src/tests/qa_runtime_i18n.test.ts

@@ -0,0 +1,99 @@
+import { describe, expect, it } from 'vitest';
+import { basename, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import {
+  displayPath,
+  findFiles,
+  listToolDirectories,
+  read,
+  repositoryRoot,
+} from './qa-test-helpers';
+
+interface VisibleLiteral {
+  line: number;
+  value: string;
+}
+
+const domTextAssignment = /\.(?:innerText|textContent|innerHTML)\s*=/;
+const quotedLiteral = /(['"`])((?:\\.|(?!\1).)*)\1/g;
+
+function visibleWords(value: string): string {
+  return value
+    .replace(/\$\{[^}]*\}/g, ' ')
+    .replace(/<[^>]+>/g, ' ')
+    .replace(/&[a-z]+;/gi, ' ')
+    .replace(/[\d\p{P}\p{S}_]+/gu, ' ')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+function isTechnicalLiteral(value: string): boolean {
+  return ['.', '#', '['].some((prefix) => value.startsWith(prefix))
+    || /^data-[a-z0-9-]+$/i.test(value);
+}
+
+function hardcodedVisibleLiterals(source: string): VisibleLiteral[] {
+  const failures: VisibleLiteral[] = [];
+
+  source.split(/\r?\n/).forEach((line, index) => {
+    if (!domTextAssignment.test(line)) return;
+
+    const assignment = line.slice(line.search(domTextAssignment));
+    for (const match of assignment.matchAll(quotedLiteral)) {
+      if (isTechnicalLiteral(match[2])) continue;
+      const words = visibleWords(match[2]);
+      if (words && /\p{L}/u.test(words)) {
+        failures.push({ line: index + 1, value: match[2] });
+      }
+    }
+  });
+
+  return failures;
+}
+
+function runtimeSources(toolDirectory: string): string {
+  return findFiles(toolDirectory, ['.astro', '.ts', '.js'])
+    .filter((path) => !path.includes(`${join(toolDirectory, 'i18n')}`))
+    .filter((path) => basename(path) !== 'ui.ts')
+    .map(read)
+    .join('\n');
+}
+
+describe('QA: runtime copy is localized', () => {
+  const componentFiles = findFiles(join(repositoryRoot, 'src', 'tool'), ['.astro']);
+
+  it('does not write user-facing string literals directly into the DOM', () => {
+    const failures = componentFiles.flatMap((path) =>
+      hardcodedVisibleLiterals(read(path)).map(
+        ({ line, value }) => `${displayPath(path)}:${line} -> ${JSON.stringify(value)}`,
+      ),
+    );
+
+    expect(
+      failures,
+      `Move visible browser copy to the tool UI locale contract:\n${failures.join('\n')}`,
+    ).toEqual([]);
+  });
+
+  it('uses every string declared by each UI locale contract', () => {
+    const failures: string[] = [];
+
+    for (const directory of listToolDirectories()) {
+      const uiPath = join(directory, 'ui.ts');
+      if (!existsSync(uiPath)) continue;
+
+      const keys = Array.from(read(uiPath).matchAll(/^\s*(\w+)\??:\s*string\s*;/gm), (match) => match[1]);
+      const runtime = runtimeSources(directory);
+      const unused = keys.filter((key) => !new RegExp(`\\b${key}\\b`).test(runtime));
+
+      if (unused.length > 0) {
+        failures.push(`${displayPath(uiPath)} -> unused: ${unused.join(', ')}`);
+      }
+    }
+
+    expect(
+      failures,
+      `Unused locale keys are dead copy or may mean the browser bypasses translations:\n${failures.join('\n')}`,
+    ).toEqual([]);
+  });
+});

package/src/tool/language-learning-study-plan-planner/validation.ts

@@ -0,0 +1,15 @@
+export const validation = {
+  reviewedAt: '2026-08-29',
+  methodology: 'The planner uses broad guided-learning hour ranges as a planning estimate, subtracts the current level range from the target level range, and compares the result with weeks available at the selected weekly pace.',
+  sources: [
+    'https://www.coe.int/en/web/common-european-framework-reference-languages',
+    'https://www.cambridge.org/elt/blog/2020/08/19/how-long-learn-language/',
+  ],
+  referenceCases: [
+    { currentLevel: 'A1', targetLevel: 'B1', expectedHoursRange: '260-300' },
+  ],
+  limitations: [
+    'The ranges are planning estimates, not a placement test or a guarantee of fluency.',
+    'Language distance, previous exposure, study quality, and real-world practice can materially change the time required.',
+  ],
+};

package/src/category/i18n/shared.ts

@@ -1,11 +0,0 @@
-import type { CategoryLocaleContent } from '../../types';
-
-interface CategoryInput {
-  title: string;
-  description: string;
-  seo: CategoryLocaleContent['seo'];
-}
-
-export function createLanguageCategory(input: CategoryInput): CategoryLocaleContent {
-  return { slug: 'language', ...input };
-}