@jjlmoya/utils-finance 1.31.0 → 1.32.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-finance",
-    "version": "1.31.0",
+    "version": "1.32.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

package/src/category/i18n/en.ts

@@ -71,7 +71,7 @@ export const content: CategoryLocaleContent = {
     {
       type: 'tip',
       title: 'Strategic Savings Advice',
-      html: '<p><strong>2026 Strategy:</strong> In a persistent inflation environment, keeping cash idle is a guaranteed loss. Use the compound interest simulator to evaluate how small increases in return rate dramatically impact your retirement.</p>',
+      html: '<p><strong>2026 Strategy:</strong> In a persistent inflation environment, keeping cash idle can reduce its purchasing power. Use the compound interest simulator to evaluate how small changes in return rate may affect your retirement.</p>',
     },
     {
       type: 'title',

package/src/category/i18n/es.ts

@@ -4,7 +4,7 @@ export const content: CategoryLocaleContent = {
   slug: 'finanzas',
   title: 'Herramientas y Calculadoras Financieras de Precisión',
   description:
-    'Optimiza tus finanzas con herramientas gratuitas online. Simuladores de hipotecas, cálculo de interés compuesto, actualización de alquileres e intereses de demora actualizados a 2026.',
+    'Optimiza tus finanzas con herramientas gratuitas online: hipotecas, interés compuesto, alquileres e intereses de demora para 2026.',
   seo: [
     {
       type: 'title',
@@ -48,7 +48,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'paragraph',
-      html: 'En el ámbito legal y tributario, los plazos y porcentajes son críticos. Proporcionamos herramientas actualizadas para calcular el <strong>interés legal del dinero (3,25% en 2026)</strong> y los intereses de demora para deudas civiles o con Hacienda, evitando que pagues recargos innecesarios por falta de información.',
+      html: 'En el ámbito legal y tributario, los plazos y porcentajes son críticos. Proporcionamos herramientas de referencia para calcular el <strong>interés legal del dinero (3,25% en 2026)</strong> y los intereses de demora para deudas civiles o con Hacienda. Comprueba siempre la norma vigente antes de tomar una decisión.',
     },
     {
       type: 'title',
@@ -62,7 +62,7 @@ export const content: CategoryLocaleContent = {
     {
       type: 'list',
       items: [
-        '<strong>Datos Actualizados:</strong> Tasas de interés, límites de IPC y variables fiscales revisadas para el ejercicio 2026.',
+        '<strong>Datos de referencia:</strong> Tasas de interés, límites de IPC y variables fiscales indicadas para el ejercicio 2026.',
         '<strong>Privacidad Total:</strong> Tus datos financieros personales se procesan estrictamente en el navegador sin almacenamiento en servidores.',
         '<strong>Rigor Matemático:</strong> Algoritmos de amortización y cálculo de interés real siguiendo estándares bancarios europeos.',
         '<strong>Transparencia Legal:</strong> Herramientas adaptadas a la legislación española vigente (Ley de Vivienda, Modelos Tributarios).',
@@ -71,7 +71,7 @@ export const content: CategoryLocaleContent = {
     {
       type: 'tip',
       title: 'Consejo Estratégico de Ahorro',
-      html: '<p><strong>Estrategia 2026:</strong> En un entorno de inflación persistente, mantener el efectivo inactivo es una pérdida garantizada. Usa el simulador de interés compuesto para evaluar cómo pequeños aumentos en la tasa de retorno impactan drásticamente en tu jubilación.</p>',
+      html: '<p><strong>Estrategia 2026:</strong> En un entorno de inflación persistente, mantener el efectivo inactivo puede reducir su poder adquisitivo. Usa el simulador de interés compuesto para valorar cómo pequeños cambios en la rentabilidad pueden afectar a tu jubilación.</p>',
     },
     {
       type: 'title',

package/src/category/i18n/pl.ts

@@ -3,7 +3,7 @@ import type { CategoryLocaleContent } from '../../types';
 export const content: CategoryLocaleContent = {
   slug: 'finanse',
   title: 'Precyzyjne Narzędzia i Kalkulatory Finansowe',
-  description: 'Zoptymalizuj swoje finanse dzięki bezpłatnym narzędziom online. Symulatory kredytów hipotecznych, kalkulator odsetek składanych, aktualizacje czynszu i odsetki za zwłokę zaktualizowane na 2026.',
+  description: 'Zoptymalizuj finanse dzięki darmowym narzędziom online: kredyty hipoteczne, odsetki składane, czynsz i odsetki za zwłokę w 2026 roku.',
   seo: [
     {
       type: 'title',

package/src/tests/category_seo_quality.test.ts

@@ -0,0 +1,76 @@
+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');
+
+  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) : [];
+    });
+
+    const englishShape = english?.seo.map((section) => section.type);
+    for (const locale of EXPECTED_LOCALES) {
+      const content = contents.get(locale);
+      if (content && JSON.stringify(content.seo.map((section) => section.type)) !== JSON.stringify(englishShape)) {
+        failures.push(`${locale}: SEO section types must match English`);
+      }
+    }
+
+    expect(failures, 'category SEO quality failures').toEqual([]);
+  }, 30000);
+});