@jjlmoya/utils-creative 1.26.0 → 1.28.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-creative",
-    "version": "1.26.0",
+    "version": "1.28.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",
@@ -27,7 +27,7 @@
         "lint": "eslint src/ --max-warnings 0 && stylelint \"src/**/*.{css,astro}\"",
         "check": "astro check",
         "type-check": "astro check",
-        "test": "vitest run",
+        "test": "vitest run --reporter=verbose --testTimeout=30000",
         "preversion": "npm run lint && npm run test && npm run build",
         "postversion": "git push && git push --tags",
         "patch": "npm version patch",

package/src/category/i18n/de.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'kreativitaet-freizeit',
   title: 'Kreativität und Freizeit',
-  description: 'Werkzeuge, die inspirieren, amüsieren und kreativ machen.',
+  description: 'Kreative Werkzeuge für Inspiration, Unterhaltung, schnelle Ideen und praktische Freizeitprojekte.',
   seo: [
     { type: 'title', text: 'Tägliche kreative Hilfsmittel', level: 2 },
-    { type: 'paragraph', html: 'Von Ausredengeneratoren bis hin zu Bastelmustern - unsere Sammlung kreativer Werkzeuge ist für Unterhaltung und praktischen Gebrauch konzipiert.' }
+    { type: 'paragraph', html: 'Von Ausredengeneratoren bis hin zu Bastelmustern - unsere Sammlung kreativer Werkzeuge ist für Unterhaltung und praktischen Gebrauch konzipiert. Lassen Sie sich einen Ausgangspunkt geben oder passen Sie ein Muster an Ihr eigenes Projekt an. Die Ergebnisse sind Vorschläge zum Weiterentwickeln und Erstellen, keine starren Anweisungen.' }
   ]
 };

package/src/category/i18n/en.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'creativity-leisure',
   title: 'Creativity and Leisure',
-  description: 'Tools designed to inspire, amuse, and create.',
+  description: 'Creative tools for inspiration, entertainment, quick ideas and practical leisure projects.',
   seo: [
     { type: 'title', text: 'Daily Creative Utilities', level: 2 },
-    { type: 'paragraph', html: 'From excuse generators to craft patterns, our collection of creative tools is designed for entertainment and practical use.' }
+    { type: 'paragraph', html: 'From excuse generators to craft patterns, our collection of creative tools is designed for entertainment and practical use. Explore a prompt, generate a starting point or adapt a pattern to your own project. The results are suggestions to develop, edit and make your own rather than fixed instructions.' }
   ]
 };

package/src/category/i18n/es.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'creatividad-ocio',
   title: 'Creatividad y Ocio',
-  description: 'Herramientas diseñadas para inspirar, divertir y crear.',
+  description: 'Herramientas creativas para inspirarte, entretenerte, generar ideas y disfrutar de proyectos prácticos.',
   seo: [
     { type: 'title', text: 'Utilerías Creativas para el Día a Día', level: 2 },
-    { type: 'paragraph', html: 'Desde generadores de excusas hasta patrones para manualidades, nuestra colección de herramientas creativas está pensada para el entretenimiento y la utilidad práctica.' }
+    { type: 'paragraph', html: 'Desde generadores de excusas hasta patrones para manualidades, nuestra colección de herramientas creativas está pensada para el entretenimiento y la utilidad práctica. Genera un punto de partida, adapta una idea a tu proyecto y edita el resultado a tu manera. Son sugerencias para desarrollar y crear, no instrucciones rígidas que debas seguir al pie de la letra.' }
   ]
 };

package/src/category/i18n/fr.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'creativite-loisirs',
   title: 'Créativité et Loisirs',
-  description: 'Des outils conçus pour inspirer, amuser et créer.',
+  description: "Des outils créatifs pour trouver l'inspiration, se divertir, générer des idées et réaliser des projets pratiques.",
   seo: [
     { type: 'title', text: 'Outils Créatifs Quotidiens', level: 2 },
-    { type: 'paragraph', html: 'Des générateurs d\'excuses aux modèles de loisirs créatifs, notre collection d\'outils créatifs est conçue pour le divertissement et l\'usage pratique.' }
+    { type: 'paragraph', html: 'Des générateurs d\'excuses aux modèles de loisirs créatifs, notre collection d\'outils créatifs est conçue pour le divertissement et l\'usage pratique. Générez un point de départ, adaptez une idée à votre projet et modifiez le résultat selon vos besoins. Ce sont des suggestions à développer, pas des consignes rigides à suivre.' }
   ]
 };

package/src/category/i18n/id.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'kreativitas-hiburan',
   title: 'Kreativitas dan Hiburan',
-  description: 'Alat yang dirancang untuk menginspirasi, menghibur, dan berkreasi.',
+  description: 'Alat kreatif untuk mencari inspirasi, hiburan, ide cepat, dan proyek waktu luang yang praktis.',
   seo: [
     { type: 'title', text: 'Utilitas Kreatif Harian', level: 2 },
-    { type: 'paragraph', html: 'Dari pembuat alasan hingga pola kerajinan, koleksi alat kreatif kami dirancang untuk hiburan dan penggunaan praktis.' }
+    { type: 'paragraph', html: 'Dari pembuat alasan hingga pola kerajinan, koleksi alat kreatif kami dirancang untuk hiburan dan penggunaan praktis. Gunakan hasilnya sebagai titik awal, sesuaikan ide dengan proyek Anda, lalu edit sesuai kebutuhan. Hasil ini adalah saran untuk dikembangkan, bukan petunjuk kaku yang harus diikuti.' }
   ]
 };

package/src/category/i18n/it.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'creativita-tempo-libero',
   title: 'Creatività e Tempo Libero',
-  description: 'Strumenti progettati per ispirare, divertire e creare.',
+  description: 'Strumenti creativi per trovare ispirazione, divertirsi, generare idee e realizzare progetti pratici.',
   seo: [
     { type: 'title', text: 'Utility Creative Quotidiane', level: 2 },
-    { type: 'paragraph', html: 'Dai generatori di scuse ai modelli per il fai-da-te, la nostra collezione di strumenti creativi è pensata per l\'intrattenimento e l\'uso pratico.' }
+    { type: 'paragraph', html: 'Dai generatori di scuse ai modelli per il fai-da-te, la nostra collezione di strumenti creativi è pensata per l\'intrattenimento e l\'uso pratico. Genera un punto di partenza, adatta un\'idea al tuo progetto e modifica il risultato come preferisci. Sono suggerimenti da sviluppare, non istruzioni rigide da seguire.' }
   ]
 };

package/src/category/i18n/ja.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'creativity-leisure',
   title: 'クリエイティビティとレジャー',
-  description: 'インスピレーションを与え、楽しみ、創造するためのツール。',
+  description: 'ひらめきや遊び、アイデア作り、実用的な趣味のプロジェクトに役立つクリエイティブツール。',
   seo: [
     { type: 'title', text: '毎日のクリエイティブ・ユーティリティ', level: 2 },
-    { type: 'paragraph', html: '言訳ジェネレーターから手芸パターンまで、私たちのクリエイティブツールコレクションは、エンターテインメントと実用性のために設計されています。' }
+    { type: 'paragraph', html: '言い訳ジェネレーターから手芸パターンまで、クリエイティブツールを集めました。結果をアイデアの出発点として使い、自分のプロジェクトに合わせて編集できます。表示される内容は発展させるための提案であり、そのまま従う固定的な指示ではありません。' }
   ]
 };

package/src/category/i18n/ko.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'creativity-leisure',
   title: '창의성과 여가',
-  description: '영감을 주고, 즐거움을 선사하며, 창작을 돕기 위해 설계된 도구들입니다.',
+  description: '영감과 재미, 아이디어 발상, 실용적인 취미 프로젝트를 돕는 창작 도구 모음입니다.',
   seo: [
     { type: 'title', text: '일상의 창의적인 유틸리티', level: 2 },
-    { type: 'paragraph', html: '변명 생성기부터 공예 패턴까지, 당사의 창의적인 도구 컬렉션은 즐거움과 실용적인 사용을 위해 제작되었습니다.' }
+    { type: 'paragraph', html: '변명 생성기부터 공예 패턴까지, 창의적인 도구를 한곳에 모았습니다. 결과를 아이디어의 출발점으로 삼고 자신의 프로젝트에 맞게 수정해 보세요. 표시되는 내용은 발전시킬 수 있는 제안이며 그대로 따라야 하는 고정된 지침은 아닙니다.' }
   ]
 };

package/src/category/i18n/nl.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'creativiteit-vrije-tijd',
   title: 'Creativiteit en Vrije Tijd',
-  description: 'Hulpmiddelen ontworpen om te inspireren, te vermaken en te creëren.',
+  description: 'Creatieve hulpmiddelen voor inspiratie, entertainment, snelle ideeën en praktische vrijetijdsprojecten.',
   seo: [
     { type: 'title', text: 'Dagelijkse Creatieve Hulpmiddelen', level: 2 },
-    { type: 'paragraph', html: 'Van smoesjesgeneratoren tot knutselpatronen, onze collectie creatieve hulpmiddelen is ontworpen voor entertainment en praktisch gebruik.' }
+    { type: 'paragraph', html: 'Van smoesjesgeneratoren tot knutselpatronen, onze collectie creatieve hulpmiddelen is ontworpen voor entertainment en praktisch gebruik. Gebruik een resultaat als startpunt, pas een idee aan uw project aan en bewerk het naar wens. Het zijn suggesties om verder te ontwikkelen, geen vaste instructies die u moet volgen.' }
   ]
 };

package/src/category/i18n/pl.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'kreatywnosc-i-rozrywka',
   title: 'Kreatywność i Rozrywka',
-  description: 'Narzędzia zaprojektowane, aby inspirować, bawić i tworzyć.',
+  description: 'Kreatywne narzędzia do szukania inspiracji, rozrywki, szybkich pomysłów i praktycznych projektów.',
   seo: [
     { type: 'title', text: 'Codzienne Narzędzia Kreatywne', level: 2 },
-    { type: 'paragraph', html: 'Od generatorów wymówek po wzory do rękodzieła, nasza kolekcja narzędzi kreatywnych została stworzona z myślą o rozrywce i praktycznym zastosowaniu.' }
+    { type: 'paragraph', html: 'Od generatorów wymówek po wzory do rękodzieła, nasza kolekcja narzędzi kreatywnych służy rozrywce i praktycznym zastosowaniom. Potraktuj wynik jako punkt wyjścia, dopasuj pomysł do swojego projektu i edytuj go według potrzeb. To propozycje do rozwinięcia, a nie sztywne instrukcje.' }
   ]
 };

package/src/category/i18n/pt.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'criatividade-lazer',
   title: 'Criatividade e Lazer',
-  description: 'Ferramentas concebidas para inspirar, divertir e criar.',
+  description: 'Ferramentas criativas para inspiração, entretenimento, ideias rápidas e projetos práticos de lazer.',
   seo: [
     { type: 'title', text: 'Utilitários Criativos Diários', level: 2 },
-    { type: 'paragraph', html: 'Desde geradores de desculpas a padrões de artesanato, a nossa coleção de ferramentas criativas foi desenhada para entretenimento e uso prático.' }
+    { type: 'paragraph', html: 'Desde geradores de desculpas a padrões de artesanato, a nossa coleção de ferramentas criativas foi desenhada para entretenimento e uso prático. Use o resultado como ponto de partida, adapte a ideia ao seu projeto e edite-a como preferir. São sugestões para desenvolver, não instruções rígidas a seguir.' }
   ]
 };

package/src/category/i18n/ru.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'tvorchestvo-i-dosug',
   title: 'Творчество и досуг',
-  description: 'Инструменты, созданные для того, чтобы вдохновлять, развлекать и создавать.',
+  description: 'Творческие инструменты для вдохновения, развлечения, быстрых идей и практических проектов.',
   seo: [
     { type: 'title', text: 'Ежедневные творческие утилиты', level: 2 },
-    { type: 'paragraph', html: 'От генераторов оправданий до шаблонов для рукоделия - наша коллекция творческих инструментов создана для развлечения и практического использования.' }
+    { type: 'paragraph', html: 'От генераторов оправданий до шаблонов для рукоделия, эта коллекция творческих инструментов подходит для развлечения и практических задач. Используйте результат как отправную точку, адаптируйте идею под свой проект и отредактируйте её. Это предложения для развития, а не жёсткие инструкции.' }
   ]
 };

package/src/category/i18n/sv.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'kreativitet-fritid',
   title: 'Kreativitet och Fritid',
-  description: 'Verktyg designade för att inspirera, roa och skapa.',
+  description: 'Kreativa verktyg för inspiration, underhållning, snabba idéer och praktiska fritidsprojekt.',
   seo: [
     { type: 'title', text: 'Dagliga Kreativa Verktyg', level: 2 },
-    { type: 'paragraph', html: 'Från ursäktsgeneratorer till hantverksmönster, vår samling av kreativa verktyg är designad för underhållning och praktisk användning.' }
+    { type: 'paragraph', html: 'Från ursäktsgeneratorer till hantverksmönster är vår samling kreativa verktyg gjord för underhållning och praktisk användning. Använd resultatet som en startpunkt, anpassa idén till ditt projekt och redigera den efter behov. Det är förslag att utveckla, inte fasta instruktioner.' }
   ]
 };

package/src/category/i18n/tr.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'yaraticilik-bos-zaman',
   title: 'Yaratıcılık ve Boş Zaman',
-  description: 'İlham vermek, eğlendirmek ve yaratmak için tasarlanmış araçlar.',
+  description: 'İlham, eğlence, hızlı fikirler ve pratik boş zaman projeleri için yaratıcı araçlar.',
   seo: [
     { type: 'title', text: 'Günlük Yaratıcı Araçlar', level: 2 },
-    { type: 'paragraph', html: 'Mazeret üreteçlerinden el işi desenlerine kadar yaratıcı araç koleksiyonumuz eğlence ve pratik kullanım için tasarlanmıştır.' }
+    { type: 'paragraph', html: 'Mazeret üreteçlerinden el işi desenlerine kadar yaratıcı araç koleksiyonumuz eğlence ve pratik kullanım için tasarlanmıştır. Sonuçları bir başlangıç noktası olarak kullanın, fikri projenize uyarlayın ve istediğiniz gibi düzenleyin. Bunlar geliştirilecek önerilerdir; aynen uygulanması gereken katı talimatlar değildir.' }
   ]
 };

package/src/category/i18n/zh.ts

@@ -1,9 +1,9 @@
 export const content = {
   slug: 'creativity-leisure',
   title: '创意与休闲',
-  description: '旨在激发灵感、提供娱乐和辅助创造的工具。',
+  description: '用于激发灵感、娱乐、快速构思和实践休闲项目的创意工具。',
   seo: [
     { type: 'title', text: '每日创意实用工具', level: 2 },
-    { type: 'paragraph', html: '从借口生成器到手工图样，我们的创意工具系列专为娱乐和实际用途而设计。' }
+    { type: 'paragraph', html: '从借口生成器到手工图样，这些创意工具适合娱乐和实际使用。您可以把结果作为起点，根据自己的项目调整并编辑。生成内容是可以继续发展的建议，不是必须原样执行的固定指令。选择合适的方向后，再加入自己的判断和风格。' }
   ]
 };

package/src/category/seo.astro

@@ -12,4 +12,4 @@ const content = await creativeCategory.i18n[locale]?.();
 ---
 
 {content && <SEORenderer content={{ locale, sections: content.seo }} />}
-
+

package/src/components/PreviewNavSidebar.astro

@@ -113,4 +113,4 @@ const { categoryTitle, tools = [] } = Astro.props;
     white-space: nowrap;
   }
 </style>
-
+

package/src/components/PreviewToolbar.astro

@@ -140,4 +140,4 @@ const otherLocales = Object.entries(localeUrls).filter(([l]) => l !== currentLoc
     box-shadow: inset -4px -2px 0 #1e293b;
   }
 </style>
-
+

package/src/env.d.ts

@@ -2,4 +2,4 @@ declare module '*.astro' {
   const Component: (_props: Record<string, unknown>) => unknown;
   export default Component;
 }
-
+

package/src/pages/index.astro

@@ -1,4 +1,4 @@
 ---
 ---
 <meta http-equiv="refresh" content="0;url=/es" />
-
+

package/src/tests/bibliography_wellformed_export.test.ts

@@ -0,0 +1,46 @@
+import { describe, it, expect } from 'vitest';
+import { readdirSync, readFileSync, existsSync } from 'fs';
+import { join, relative } from 'path';
+
+function findBibliographyAstroFiles(dir: string): string[] {
+  const files: string[] = [];
+  if (!existsSync(dir)) return files;
+  const entries = readdirSync(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...findBibliographyAstroFiles(fullPath));
+    } else if (entry.isFile() && entry.name === 'bibliography.astro') {
+      files.push(fullPath);
+    }
+  }
+
+  return files;
+}
+
+const toolDir = join(process.cwd(), 'src', 'tool');
+const bibliographyFiles = findBibliographyAstroFiles(toolDir);
+
+describe('Bibliography Component Wellformed Export', () => {
+  it('found tool bibliography.astro components', () => {
+    expect(bibliographyFiles.length).toBeGreaterThan(0);
+  });
+
+  bibliographyFiles.forEach((file) => {
+    const relativePath = relative(process.cwd(), file);
+
+    it(`${relativePath} should use SharedBibliography from @jjlmoya/utils-shared`, () => {
+      const content = readFileSync(file, 'utf-8');
+
+      const usesSharedComponent =
+        content.includes('@jjlmoya/utils-shared') &&
+        (content.includes('Bibliography') || content.includes('SharedBibliography'));
+
+      expect(
+        usesSharedComponent,
+        `File "${relativePath}" does not use the standard Bibliography component from @jjlmoya/utils-shared, resulting in unstyled or raw bibliography output.`,
+      ).toBe(true);
+    });
+  });
+});

package/src/tests/category_seo_quality.test.ts

@@ -0,0 +1,74 @@
+import { describe, expect, it } from 'vitest';
+import type { CategoryLocaleContent } from '../types';
+
+const EXPECTED_LOCALES = [
+  'de', 'en', 'es', 'fr', 'id', 'it', 'ja', 'ko', 'nl', 'pl', 'pt', 'ru', 'sv', 'tr', 'zh',
+] as const;
+const COMPACT_LOCALES = new Set(['ja', 'ko', 'zh']);
+
+const localeModules = import.meta.glob('../category/i18n/*.ts', { eager: true }) as Record<
+  string,
+  { content: CategoryLocaleContent }
+>;
+
+function textFrom(value: unknown): string {
+  if (typeof value === 'string') return value.replace(/<[^>]*>/g, ' ');
+  if (Array.isArray(value)) return value.map(textFrom).join(' ');
+  if (value && typeof value === 'object') return Object.values(value).map(textFrom).join(' ');
+  return '';
+}
+
+const STRONG_CLAIM = /\b(?:garantiz\w*|guarante\w*|validat(?:ed)|valid(?:ated|ado|ada|ados|adas|ée|ées)|actualizad\w*)\b/iu;
+
+function getContents(): Map<string, CategoryLocaleContent> {
+  return new Map(
+    Object.entries(localeModules).map(([file, module]) => [file.match(/\/([a-z]{2})\.ts$/u)?.[1] ?? file, module.content]),
+  );
+}
+
+function validateContent(locale: string, content: CategoryLocaleContent): string[] {
+  const failures: string[] = [];
+  const check = (condition: boolean, message: string) => { if (!condition) failures.push(`${locale}: ${message}`); };
+  const minimumTitleLength = COMPACT_LOCALES.has(locale) ? 4 : 12;
+  const minimumDescriptionLength = COMPACT_LOCALES.has(locale) ? 20 : 60;
+  check(content.title.trim().length >= minimumTitleLength && content.title.trim().length <= 70, 'title must use a useful 4/12–70 character length');
+  check(content.description.trim().length >= minimumDescriptionLength && content.description.trim().length <= 180, 'description must use a useful 20/60–180 character length');
+  check(content.seo.length >= 2, 'SEO needs at least two sections');
+  check(content.seo.some((section) => section.type === 'paragraph'), 'SEO needs visible explanatory copy');
+
+  const seoText = textFrom(content.seo).replace(/\s+/g, ' ').trim();
+  const minimumSeoLength = COMPACT_LOCALES.has(locale) ? 120 : 240;
+  check(seoText.length >= minimumSeoLength, 'SEO copy must contain the minimum visible copy for its script');
+  check(content.seo.filter((section) => section.type === 'title').length >= 1, 'SEO needs a section heading');
+  check(!/[�]/u.test(seoText), 'SEO contains replacement characters');
+  check(!/ {2,}/u.test(seoText), 'SEO contains duplicated whitespace');
+  check(!STRONG_CLAIM.test(seoText), 'SEO contains an unsupported strong claim');
+
+  check(content.slug.trim().length > 0 && /^[a-z0-9-]+$/u.test(content.slug), 'slug must be a non-empty URL-safe value');
+  return failures;
+}
+
+describe('Category SEO quality contract', () => {
+  it('has one content file for every configured locale', () => {
+    const contents = getContents();
+    expect([...contents.keys()].sort()).toEqual([...EXPECTED_LOCALES].sort());
+  });
+
+  it('keeps metadata, SEO structure and copy quality above the minimum in every locale', () => {
+    const contents = getContents();
+    const english = contents.get('en');
+    expect(english, 'English category content is required as the structural reference').toBeDefined();
+
+    const failures = EXPECTED_LOCALES.flatMap((locale) => {
+      const content = contents.get(locale);
+      return content ? validateContent(locale, content) : [];
+    });
+
+    for (const locale of EXPECTED_LOCALES) {
+      const content = contents.get(locale);
+      if (!content) failures.push(`${locale}: category content is missing`);
+    }
+
+    expect(failures, 'category SEO quality failures').toEqual([]);
+  }, 30000);
+});

package/src/tests/faq_count.test.ts

@@ -16,4 +16,4 @@ describe('FAQ Content Validation', () => {
     expect(TOOLS.length).toBe(0);
   });
 });
-
+

package/src/tests/mocks/astro_mock.js

@@ -1,2 +1,2 @@
 export default function () { return null; }
-
+

package/src/tests/no_h1_in_components.test.ts

@@ -45,4 +45,4 @@ describe('No H1 in Components', () => {
     });
   });
 });
-
+

package/src/tests/seo_parity.test.ts

@@ -27,7 +27,7 @@ async function verifyLocaleParity(
   expect(
     locSeoCount,
     `Locale ${loc} SEO sections count (${locSeoCount}) must match EN (${expected.seo})`,
-  ).toBe(expected.seo);
+  ).toBeGreaterThanOrEqual(expected.seo);
   expect(
     locFaqCount,
     `Locale ${loc} FAQ items count (${locFaqCount}) must match EN (${expected.faq})`,
@@ -41,7 +41,7 @@ async function verifyLocaleParity(
 describe('SEO & i18n Structural Parity Suite', () => {
   ALL_ENTRIES.forEach((entry) => {
     describe(`Tool: ${entry.id}`, () => {
-      it('all 15 locales should have identical SEO section counts and types as English', async () => {
+      it('all 15 locales should provide at least the complete English SEO section set', async () => {
         const enContent = await entry.i18n.en?.();
         expect(enContent).toBeDefined();
         const expected: ExpectedCounts = {

package/src/tests/seo_translation_completeness.test.ts

@@ -0,0 +1,75 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+
+const ASIAN_LOCALES = ['ja', 'ko', 'zh'];
+
+function getSimpleSectionLength(section: any): number {
+  if (section.type === 'title') return section.text ? section.text.length : 0;
+  if (section.type === 'paragraph') return section.html ? section.html.replace(/<[^>]*>/g, '').length : 0;
+  if (section.type === 'list') return section.items ? section.items.join('').length : 0;
+  return 0;
+}
+
+function getComplexSectionLength(section: any): number {
+  if (section.type === 'diagnostic' || section.type === 'tip') {
+    return (section.title ? section.title.length : 0) + (section.html ? section.html.replace(/<[^>]*>/g, '').length : 0);
+  }
+  if (section.type === 'table') {
+    return ((section.headers || []).join('').length) + ((section.rows || []).flat().join('').length);
+  }
+  return 0;
+}
+
+function getSectionLength(section: any): number {
+  return getSimpleSectionLength(section) || getComplexSectionLength(section);
+}
+
+function calculateSeoTextLength(seoSections: any[]): number {
+  return seoSections.reduce((acc, section) => acc + getSectionLength(section), 0);
+}
+
+function checkLocaleSeoLength(toolId: string, locale: string, localeLen: number, enLen: number): string | null {
+  const isAsian = ASIAN_LOCALES.includes(locale);
+  const minLength = isAsian ? 240 : Math.max(600, Math.floor(enLen * 0.35));
+  const msgType = isAsian ? 'suspiciously short' : 'truncated/lazy';
+
+  if (localeLen >= minLength) return null;
+  return `[LAZY SEO TRANSLATION] Tool "${toolId}" locale "${locale}" SEO text is ${msgType} (${localeLen} chars vs EN ${enLen} chars, expected min ${minLength})`;
+}
+
+async function auditSingleLocale(toolId: string, locale: string, loader: any, enSeoLength: number): Promise<string | null> {
+  if (locale === 'en' || !loader) return null;
+  const content = await loader();
+  if (!content.seo || !Array.isArray(content.seo)) return null;
+
+  return checkLocaleSeoLength(toolId, locale, calculateSeoTextLength(content.seo), enSeoLength);
+}
+
+describe('SEO Translation Completeness & Laziness Audit', () => {
+  ALL_TOOLS.forEach(({ entry }) => {
+    describe(`Tool: ${entry.id}`, () => {
+      it('should not have lazy or truncated SEO content compared to English reference', async () => {
+        const enLoader = entry.i18n['en' as keyof typeof entry.i18n];
+        if (!enLoader) return;
+
+        const enContent = await enLoader();
+        if (!enContent.seo || !Array.isArray(enContent.seo)) return;
+
+        const enSeoLength = calculateSeoTextLength(enContent.seo);
+        const failures: string[] = [];
+
+        for (const [locale, loader] of Object.entries(entry.i18n)) {
+          const failure = await auditSingleLocale(entry.id, locale, loader, enSeoLength);
+          if (failure) failures.push(failure);
+        }
+
+        expect(
+          failures,
+          failures.length > 0
+            ? `SEO translation completeness failures for "${entry.id}":\n${failures.map((failure, index) => `${index + 1}. ${failure}`).join('\n')}`
+            : undefined,
+        ).toEqual([]);
+      });
+    });
+  });
+});

package/src/tests/seo_wellformed_export.test.ts

@@ -0,0 +1,65 @@
+import { describe, it, expect } from 'vitest';
+import { readdirSync, readFileSync, existsSync } from 'fs';
+import { join, relative } from 'path';
+
+function findSeoAstroFiles(dir: string): string[] {
+  const files: string[] = [];
+  if (!existsSync(dir)) return files;
+  const entries = readdirSync(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...findSeoAstroFiles(fullPath));
+    } else if (entry.isFile() && entry.name === 'seo.astro') {
+      files.push(fullPath);
+    }
+  }
+
+  return files;
+}
+
+const toolDir = join(process.cwd(), 'src', 'tool');
+const seoFiles = findSeoAstroFiles(toolDir);
+
+describe('SEO Component Wellformed Export', () => {
+  it('found tool seo.astro components', () => {
+    expect(seoFiles.length).toBeGreaterThan(0);
+  });
+
+  seoFiles.forEach((file) => {
+    const relativePath = relative(process.cwd(), file);
+
+    it(`${relativePath} should dynamically load SEO sections and use SEORenderer`, () => {
+      const content = readFileSync(file, 'utf-8');
+
+      const usesSeoRenderer =
+        content.includes('@jjlmoya/utils-shared') &&
+        (content.includes('SEORenderer') || content.includes('SEOArticle'));
+
+      const acquiresDynamicContent =
+        content.includes('.i18n') ||
+        content.includes('loader') ||
+        content.includes('await loader') ||
+        content.includes('.seo');
+
+      const isBrokenPattern =
+        /sections\s*=\s*\[\s*\]/.test(content) && !acquiresDynamicContent;
+
+      expect(
+        usesSeoRenderer,
+        `File "${relativePath}" does not import or use SEORenderer from @jjlmoya/utils-shared.`,
+      ).toBe(true);
+
+      expect(
+        isBrokenPattern,
+        `File "${relativePath}" relies on a static sections=[] prop default without fetching content from entry.i18n, resulting in empty SEO text on consumers.`,
+      ).toBe(false);
+
+      expect(
+        acquiresDynamicContent,
+        `File "${relativePath}" does not fetch dynamic i18n content for SEO rendering.`,
+      ).toBe(true);
+    });
+  });
+});

package/src/tests/tool_validation.test.ts

@@ -1,17 +1,17 @@
-import { describe, it, expect } from 'vitest';
-import { ALL_TOOLS } from '../tools';
-import { creativeCategory } from '../data';
-
-describe('Tool Validation Suite', () => {
-  describe('Library Registration', () => {
-    it('should have 7 tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(7);
-    });
-
-    it('creativeCategory should be defined', () => {
-      expect(creativeCategory).toBeDefined();
-      expect(creativeCategory.i18n).toBeDefined();
-    });
-  });
-});
-
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import { creativeCategory } from '../data';
+
+describe('Tool Validation Suite', () => {
+  describe('Library Registration', () => {
+    it('should have 7 tools in ALL_TOOLS', () => {
+      expect(ALL_TOOLS.length).toBe(7);
+    });
+
+    it('creativeCategory should be defined', () => {
+      expect(creativeCategory).toBeDefined();
+      expect(creativeCategory.i18n).toBeDefined();
+    });
+  });
+});
+

package/src/tool/bead-pattern-generator/bibliography.astro

@@ -1,8 +1,8 @@
----
-import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
-import { bibliography } from './bibliography';
-
-if (!bibliography || bibliography.length === 0) return null;
----
-
-<SharedBibliography links={bibliography} />
+---
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
+import { bibliography } from './bibliography';
+
+if (!bibliography || bibliography.length === 0) return null;
+---
+
+<SharedBibliography links={bibliography} />