@jjlmoya/utils-converters 1.25.0 → 1.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-converters",
-    "version": "1.25.0",
+    "version": "1.26.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

@@ -3,7 +3,7 @@ import type { CategoryLocaleContent } from '../../types';
 export const content: CategoryLocaleContent = {
   slug: 'bild-konverter',
   title: 'Online Bild Konverter',
-  description: 'Kostenlose Tools zur Konvertierung von Bildern zwischen den Formaten PNG, JPG, WebP, SVG, AVIF, GIF, BMP und ICO. Die Verarbeitung erfolgt vollständig lokal in Ihrem Browser, ohne Upload ins Internet.',
+  description: 'Kostenlose Bildkonverter für PNG, JPG, WebP, SVG, AVIF, GIF, BMP und ICO. Die Verarbeitung läuft lokal im Browser, ohne Upload ins Internet.',
   seo: [
     {
       type: 'summary',

package/src/category/i18n/en.ts

@@ -3,7 +3,7 @@ import type { CategoryLocaleContent } from '../../types';
 export const content: CategoryLocaleContent = {
   slug: 'image-converters',
   title: 'Online Image Converters',
-  description: 'Free tools to convert images between PNG, JPG, WebP, SVG, AVIF, GIF, BMP and ICO formats. Everything is processed locally in your browser without uploading anything to the internet.',
+  description: 'Free image converters for PNG, JPG, WebP, SVG, AVIF, GIF, BMP and ICO. Processing runs locally in your browser without uploading files to the internet.',
   seo: [
     {
       type: 'summary',

package/src/category/i18n/fr.ts

@@ -3,7 +3,7 @@ import type { CategoryLocaleContent } from '../../types';
 export const content: CategoryLocaleContent = {
   slug: 'convertisseurs-image',
   title: 'Convertisseurs d\'Image en Ligne',
-  description: 'Outils gratuits pour convertir des images entre les formats PNG, JPG, WebP, SVG, AVIF, GIF, BMP et ICO. Tout est traité localement dans votre navigateur sans rien télécharger sur internet.',
+  description: "Convertisseurs d'images gratuits pour PNG, JPG, WebP, SVG, AVIF, GIF, BMP et ICO. Le traitement reste local dans votre navigateur, sans envoyer de fichiers sur Internet.",
   seo: [
     {
       type: 'summary',

package/src/category/i18n/id.ts

@@ -3,7 +3,7 @@ import type { CategoryLocaleContent } from '../../types';
 export const content: CategoryLocaleContent = {
   slug: 'pengonversi-gambar',
   title: 'Pengonversi Gambar Online',
-  description: 'Alat gratis untuk mengonversi gambar antara format PNG, JPG, WebP, SVG, AVIF, GIF, BMP, dan ICO. Semuanya diproses secara lokal di browser Anda tanpa mengunggah apa pun ke internet.',
+  description: 'Konverter gambar gratis untuk PNG, JPG, WebP, SVG, AVIF, GIF, BMP, dan ICO. Pemrosesan berjalan secara lokal di browser tanpa mengunggah file ke internet.',
   seo: [
     {
       type: 'summary',

package/src/category/i18n/it.ts

@@ -3,7 +3,7 @@ import type { CategoryLocaleContent } from '../../types';
 export const content: CategoryLocaleContent = {
   slug: 'convertitori-di-immagini',
   title: 'Convertitori di Immagini Online',
-  description: 'Strumenti gratuiti per convertire immagini tra i formati PNG, JPG, WebP, SVG, AVIF, GIF, BMP e ICO. Tutto viene elaborato localmente nel tuo browser senza caricare nulla su Internet.',
+  description: "Convertitori di immagini gratuiti per PNG, JPG, WebP, SVG, AVIF, GIF, BMP e ICO. L'elaborazione avviene localmente nel browser senza caricare file su Internet.",
   seo: [
     {
       type: 'summary',

package/src/category/i18n/nl.ts

@@ -3,7 +3,7 @@ import type { CategoryLocaleContent } from '../../types';
 export const content: CategoryLocaleContent = {
   slug: 'afbeelding-converters',
   title: 'Online Afbeelding Converters',
-  description: 'Gratis tools om afbeeldingen te converteren tussen PNG, JPG, WebP, SVG, AVIF, GIF, BMP en ICO formaten. Alles wordt lokaal in je browser verwerkt zonder iets naar het internet te uploaden.',
+  description: 'Gratis beeldconverters voor PNG, JPG, WebP, SVG, AVIF, GIF, BMP en ICO. De verwerking gebeurt lokaal in je browser zonder bestanden naar internet te uploaden.',
   seo: [
     {
       type: 'summary',

package/src/category/i18n/pl.ts

@@ -3,7 +3,7 @@ import type { CategoryLocaleContent } from '../../types';
 export const content: CategoryLocaleContent = {
   slug: 'konwertery-obrazow',
   title: 'Konwertery Obrazów Online',
-  description: 'Darmowe narzędzia do konwersji obrazów między formatami PNG, JPG, WebP, SVG, AVIF, GIF, BMP i ICO. Wszystko jest przetwarzane lokalnie w Twojej przeglądarce, bez przesyłania plików do Internetu.',
+  description: 'Darmowe konwertery obrazów PNG, JPG, WebP, SVG, AVIF, GIF, BMP i ICO. Przetwarzanie odbywa się lokalnie w przeglądarce, bez wysyłania plików do Internetu.',
   seo: [
     {
       type: 'summary',

package/src/category/i18n/pt.ts

@@ -3,7 +3,7 @@ import type { CategoryLocaleContent } from '../../types';
 export const content: CategoryLocaleContent = {
   slug: 'conversores-de-imagem',
   title: 'Conversores de Imagem Online',
-  description: 'Ferramentas gratuitas para converter imagens entre os formatos PNG, JPG, WebP, SVG, AVIF, GIF, BMP e ICO. Tudo é processado localmente no seu navegador, sem carregar nada para a internet.',
+  description: 'Conversores de imagem gratuitos para PNG, JPG, WebP, SVG, AVIF, GIF, BMP e ICO. O processamento ocorre localmente no navegador, sem enviar ficheiros para a Internet.',
   seo: [
     {
       type: 'summary',

package/src/category/i18n/sv.ts

@@ -3,7 +3,7 @@ import type { CategoryLocaleContent } from '../../types';
 export const content: CategoryLocaleContent = {
   slug: 'bildkonverterare',
   title: 'Bildkonverterare Online',
-  description: 'Gratis verktyg för att konvertera bilder mellan formaten PNG, JPG, WebP, SVG, AVIF, GIF, BMP och ICO. Allt bearbetas lokalt i din webbläsare utan att något laddas upp till internet.',
+  description: 'Gratis bildkonverterare för PNG, JPG, WebP, SVG, AVIF, GIF, BMP och ICO. Bearbetningen sker lokalt i webbläsaren utan att filer laddas upp till internet.',
   seo: [
     {
       type: 'summary',

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/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_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 { convertersCategory } from '../data';
-
-describe('Tool Validation Suite', () => {
-  describe('Library Registration', () => {
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import { convertersCategory } from '../data';
+
+describe('Tool Validation Suite', () => {
+  describe('Library Registration', () => {
     it('should have 24 tools in ALL_TOOLS', () => {
       expect(ALL_TOOLS.length).toBe(24);
-    });
-
-    it('convertersCategory should be defined', () => {
-      expect(convertersCategory).toBeDefined();
-      expect(convertersCategory.i18n).toBeDefined();
-    });
-  });
-});
-
+    });
+
+    it('convertersCategory should be defined', () => {
+      expect(convertersCategory).toBeDefined();
+      expect(convertersCategory.i18n).toBeDefined();
+    });
+  });
+});
+