@jjlmoya/utils-creative 1.22.0 → 1.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-creative",
-    "version": "1.22.0",
+    "version": "1.23.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",
@@ -28,7 +28,7 @@
         "check": "astro check",
         "type-check": "astro check",
         "test": "vitest run",
-        "preversion": "npm run lint && npm run test",
+        "preversion": "npm run lint && npm run test && npm run build",
         "postversion": "git push && git push --tags",
         "patch": "npm version patch",
         "minor": "npm version minor",

package/src/tests/seo_parity.test.ts

@@ -0,0 +1,60 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_ENTRIES } from '../entries';
+import type { KnownLocale } from '../types';
+
+interface ExpectedCounts {
+  seo: number;
+  faq: number;
+  howTo: number;
+}
+
+function countItems(arr: unknown[] | undefined): number {
+  return arr?.length ?? 0;
+}
+
+async function verifyLocaleParity(
+  entry: typeof ALL_ENTRIES[number],
+  loc: KnownLocale,
+  expected: ExpectedCounts,
+): Promise<void> {
+  const locContent = await entry.i18n[loc]?.();
+  expect(locContent, `Locale ${loc} missing content`).toBeDefined();
+
+  const locSeoCount = countItems(locContent?.seo);
+  const locFaqCount = countItems(locContent?.faq);
+  const locHowToCount = countItems(locContent?.howTo);
+
+  expect(
+    locSeoCount,
+    `Locale ${loc} SEO sections count (${locSeoCount}) must match EN (${expected.seo})`,
+  ).toBe(expected.seo);
+  expect(
+    locFaqCount,
+    `Locale ${loc} FAQ items count (${locFaqCount}) must match EN (${expected.faq})`,
+  ).toBe(expected.faq);
+  expect(
+    locHowToCount,
+    `Locale ${loc} HowTo steps count (${locHowToCount}) must match EN (${expected.howTo})`,
+  ).toBe(expected.howTo);
+}
+
+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 () => {
+        const enContent = await entry.i18n.en?.();
+        expect(enContent).toBeDefined();
+        const expected: ExpectedCounts = {
+          seo: countItems(enContent?.seo),
+          faq: countItems(enContent?.faq),
+          howTo: countItems(enContent?.howTo),
+        };
+
+        const locales = Object.keys(entry.i18n) as KnownLocale[];
+        for (const loc of locales) {
+          await verifyLocaleParity(entry, loc, expected);
+        }
+      });
+    });
+  });
+});

package/src/tests/translation_copy.test.ts

@@ -0,0 +1,124 @@
+import { describe, expect, it } from 'vitest';
+import { ALL_ENTRIES } from '../entries';
+
+const COPY_THRESHOLD = 0.9;
+
+const STRUCTURAL_KEYS = new Set([
+  '@context',
+  '@type',
+  'applicationCategory',
+  'columns',
+  'highlight',
+  'icon',
+  'level',
+  'operatingSystem',
+  'position',
+  'positive',
+  'price',
+  'priceCurrency',
+  'slug',
+  'trend',
+  'type',
+  'url',
+  'value',
+  'variant',
+]);
+
+function normalizeText(value: string): string {
+  return value
+    .replace(/<[^>]*>/g, ' ')
+    .replace(/&(?:amp|lt|gt|quot|apos|nbsp);/gi, ' ')
+    .replace(/[\u2018\u2019]/g, "'")
+    .replace(/[\u201c\u201d]/g, '"')
+    .replace(/\s+/g, ' ')
+    .trim()
+    .toLocaleLowerCase();
+}
+
+function collectText(value: unknown, path: string, parts: string[]): void {
+  if (typeof value === 'string') {
+    const normalized = normalizeText(value);
+    if (normalized.length >= 2) parts.push(normalized);
+    return;
+  }
+
+  if (Array.isArray(value)) {
+    value.forEach((item, index) => collectText(item, `${path}[${index}]`, parts));
+    return;
+  }
+
+  if (!value || typeof value !== 'object') return;
+
+  Object.entries(value).forEach(([key, child]) => {
+    if (STRUCTURAL_KEYS.has(key)) return;
+    collectText(child, `${path}.${key}`, parts);
+  });
+}
+
+function localeCorpus(content: unknown): string {
+  if (!content || typeof content !== 'object') return '';
+
+  const record = content as Record<string, unknown>;
+  const parts: string[] = [];
+  collectText(record.title, 'title', parts);
+  collectText(record.description, 'description', parts);
+  collectText(record.faqTitle, 'faqTitle', parts);
+  collectText(record.faq, 'faq', parts);
+  collectText(record.seo, 'seo', parts);
+  collectText(record.schemas, 'schemas', parts);
+  return parts.join(' ');
+}
+
+function tokenCounts(text: string): Map<string, number> {
+  const counts = new Map<string, number>();
+  for (const token of text.match(/[\p{L}\p{N}]+/gu) ?? []) {
+    counts.set(token, (counts.get(token) ?? 0) + 1);
+  }
+  return counts;
+}
+
+function copySimilarity(left: string, right: string): number {
+  const leftCounts = tokenCounts(left);
+  const rightCounts = tokenCounts(right);
+  const leftTotal = [...leftCounts.values()].reduce((sum, count) => sum + count, 0);
+  const rightTotal = [...rightCounts.values()].reduce((sum, count) => sum + count, 0);
+  if (leftTotal === 0 || rightTotal === 0) return 0;
+
+  let shared = 0;
+  for (const [token, count] of leftCounts) {
+    shared += Math.min(count, rightCounts.get(token) ?? 0);
+  }
+  return (2 * shared) / (leftTotal + rightTotal);
+}
+
+describe('Locales must not copy another locale wholesale', () => {
+  ALL_ENTRIES.forEach((entry) => {
+    it(`${entry.id} is not at least ${COPY_THRESHOLD * 100}% identical to another locale`, async () => {
+      const corpora = new Map<string, string>();
+
+      for (const [locale, loader] of Object.entries(entry.i18n)) {
+        if (!loader) continue;
+        corpora.set(locale, localeCorpus(await loader()));
+      }
+
+      const locales = [...corpora.keys()];
+      const violations: string[] = [];
+
+      for (let leftIndex = 0; leftIndex < locales.length; leftIndex += 1) {
+        for (let rightIndex = leftIndex + 1; rightIndex < locales.length; rightIndex += 1) {
+          const left = locales[leftIndex];
+          const right = locales[rightIndex];
+          const similarity = copySimilarity(corpora.get(left) ?? '', corpora.get(right) ?? '');
+
+          if (similarity >= COPY_THRESHOLD) {
+            violations.push(`${left} ↔ ${right}: ${(similarity * 100).toFixed(1)}%`);
+          }
+        }
+      }
+
+      expect(violations, `Locale copy threshold exceeded in ${entry.id}`).toEqual([]);
+    });
+  });
+});
+
+

package/src/tool/bead-pattern-generator/i18n/es.ts

@@ -96,20 +96,13 @@ export const content: BeadPatternGeneratorLocaleContent = {
       '<strong>Mosaicos:</strong> Murales de gran escala usando teselas cerámicas simplificadas.',
       '<strong>Retro Gaming:</strong> Assets y sprites con estética 8-bit auténtica en segundos.',
     ]},
-    { type: 'paragraph', html: 'En una era de pantallas efímeras, crear algo físico es un acto revolucionario. Esta herramienta no busca automatizar el arte, sino <strong>empoderar al artesano</strong>. Te damos la precisión computacional para que tus manos puedan construir legados duraderos.' },
     { type: 'stats', items: [
       { value: '10-100', label: 'Ancho del patrón (cuentas)', icon: 'mdi:arrow-expand-horizontal' },
       { value: '2-32', label: 'Colores en la paleta', icon: 'mdi:palette-swatch' },
       { value: 'K-Means', label: 'Algoritmo de cuantización', icon: 'mdi:function-variant' },
       { value: 'ZIP', label: 'Exportación (patrón + guía)', icon: 'mdi:zip-box' },
     ], columns: 4 },
-    { type: 'glossary', items: [
-      { term: 'Miyuki Delica', definition: 'Cuentas de cristal japonesas de alta precisión, cilíndricas y uniformes. Ideales para joyería y patrones geométricos complejos.' },
-      { term: 'Hama Beads', definition: 'Cuentas de plástico que se fusionan con calor (plancha). Perfectas para proyectos de pixel art de gran formato.' },
-      { term: 'Cuantización de color', definition: 'Proceso matemático para reducir los miles de colores de una imagen a una paleta limitada, manteniendo la fidelidad visual máxima posible.' },
-      { term: 'Visión de túnel', definition: 'Modo de trabajo fila a fila que oscurece el resto del patrón para ayudar a concentrarse en la fila activa sin errores.' },
-      { term: 'K-Means Clustering', definition: 'Algoritmo de aprendizaje no supervisado que agrupa píxeles por similitud cromática para encontrar los colores "centroide" de la imagen.' },
-    ]},
+    { type: 'paragraph', html: 'En una era de pantallas efímeras, crear algo físico es un acto revolucionario. Esta herramienta no busca automatizar el arte, sino <strong>empoderar al artesano</strong>. Te damos la precisión computacional para que tus manos puedan construir legados duraderos.' },
   ],
   faq,
   bibliography,

package/src/tool/dice-roller/i18n/es.ts

@@ -107,20 +107,18 @@ export const content: DiceRollerLocaleContent = {
       '<strong>d20 - Icosaedro:</strong> El rey del rol. Veinte caras triangulares. Protagonista del sistema d20 de D&D: determina éxito o fracaso de casi todas las acciones.',
       '<strong>d100 - Percentil:</strong> Dos d10 combinados (decenas + unidades). Define probabilidades finas en sistemas como Call of Cthulhu o Warhammer Fantasy.',
     ]},
-    { type: 'title', text: 'Probabilidades y curvas de distribución', level: 3 },
-    { type: 'paragraph', html: 'Cuando lanzas un único dado, obtienes una <strong>distribución uniforme discreta</strong>: cada resultado tiene exactamente la misma probabilidad (1/n). Pero en cuanto combinas múltiples dados, la magia matemática transforma esa curva plana en una <strong>distribución normal aproximada</strong>. Por eso 2d6 no es lo mismo que 1d12: con dos dados de seis la probabilidad de obtener 7 es 6/36 ≈ 16,7%, mientras que los extremos (2 y 12) solo ocurren el 2,8% del tiempo.' },
-    { type: 'tip', title: 'Ventaja y Desventaja (sistema D&D 5e)', html: 'El mecanismo de <strong>Ventaja</strong> consiste en lanzar 2d20 y quedarse con el mayor resultado. Matemáticamente, esto sube la media de 10,5 a aproximadamente 13,8. La <strong>Desventaja</strong> hace lo contrario: toma el menor, bajando la media a unos 7,2. Nuestro tirador te permite simular esto añadiendo dos d20 a la bolsa y comparando los resultados individualmente.' },
-    { type: 'title', text: 'Modificadores: el puente entre dados y personaje', level: 3 },
-    { type: 'paragraph', html: 'En la mayoría de sistemas de rol, el dado no actúa solo: se suma o resta un <strong>modificador</strong> que representa las habilidades del personaje. En D&D 5e, un modificador de Fuerza +5 significa que lanzas 1d20, sumas 5, y compruebas el resultado contra la Clase de Armadura del enemigo. Nuestro tirador incorpora un control de modificador para reflejar fielmente estas mecánicas.' },
-    { type: 'title', text: 'Integridad aleatoria: ¿son justos los dados digitales?', level: 3 },
-    { type: 'paragraph', html: 'El método <code>Math.random()</code> de JavaScript utiliza un algoritmo <strong>xorshift128+</strong> (en los motores V8 modernos), que produce valores pseudoaleatorios con un período de 2¹²⁸. Para los propósitos del juego de mesa y del rol, esta calidad estadística es completamente suficiente. De hecho, supera en uniformidad a un dado físico mal equilibrado. La crítica principal es que no es criptográficamente seguro (no deberías usar <code>Math.random()</code> para claves de seguridad), pero para determinar si tu Ladrón roba con éxito es más que adecuado.' },
-    { type: 'tip', title: 'Bolsa de dados y notación estándar', html: 'La notación <strong>XdY+Z</strong> es el estándar de facto en juegos de rol: X dados de Y caras con modificador Z. "3d6+2" significa lanzar tres dados de seis y sumar 2 al total. Nuestra herramienta utiliza esta notación en el historial para que puedas compartir o anotar tus tiradas fácilmente.' },
     { type: 'stats', items: [
       { value: '5000 a.C.', label: 'Primeros dados (astrágalos)', icon: 'mdi:history' },
       { value: '1974', label: 'D&D popularizó el set', icon: 'mdi:sword' },
       { value: '7 tipos', label: 'Dados estándar de rol', icon: 'mdi:dice-multiple' },
       { value: '2¹²⁸', label: 'Período del aleatorio JS', icon: 'mdi:function-variant' },
     ], columns: 4 },
+    { type: 'title', text: 'Probabilidades y curvas de distribución', level: 3 },
+    { type: 'paragraph', html: 'Cuando lanzas un único dado, obtienes una <strong>distribución uniforme discreta</strong>: cada resultado tiene exactamente la misma probabilidad (1/n). Pero en cuanto combinas múltiples dados, la magia matemática transforma esa curva plana en una <strong>distribución normal aproximada</strong>. Por eso 2d6 no es lo mismo que 1d12: con dos dados de seis la probabilidad de obtener 7 es 6/36 ≈ 16,7%, mientras que los extremos (2 y 12) solo ocurren el 2,8% del tiempo.' },
+    { type: 'tip', title: 'Ventaja y Desventaja (sistema D&D 5e)', html: 'El mecanismo de <strong>Ventaja</strong> consiste en lanzar 2d20 y quedarse con el mayor resultado. Matemáticamente, esto sube la media de 10,5 a aproximadamente 13,8. La <strong>Desventaja</strong> hace lo contrario: toma el menor, bajando la media a unos 7,2. Nuestro tirador te permite simular esto añadiendo dos d20 a la bolsa y comparando los resultados individualmente.' },
+    { type: 'title', text: 'Modificadores: el puente entre dados y personaje', level: 3 },
+    { type: 'paragraph', html: 'En la mayoría de sistemas de rol, el dado no actúa solo: se suma o resta un <strong>modificador</strong> que representa las habilidades del personaje. En D&D 5e, un modificador de Fuerza +5 significa que lanzas 1d20, sumas 5, y compruebas el resultado contra la Clase de Armadura del enemigo. Nuestro tirador incorpora un control de modificador para reflejar fielmente estas mecánicas.' },
+    { type: 'tip', title: 'Bolsa de dados y notación estándar', html: 'La notación <strong>XdY+Z</strong> es el estándar de facto en juegos de rol: X dados de Y caras con modificador Z. "3d6+2" significa lanzar tres dados de seis y sumar 2 al total. Nuestra herramienta utiliza esta notación en el historial para que puedas compartir o anotar tus tiradas fácilmente.' },
     { type: 'glossary', items: [
       { term: 'Crítico', definition: 'Obtener el valor máximo en un dado (ej. sacar 20 en un d20). Normalmente activa efectos especiales de bonificación en la mayoría de sistemas.' },
       { term: 'Pifia / Nat 1', definition: 'Sacar el valor mínimo (1) en un dado. A menudo resulta en un fallo dramático o consecuencia negativa.' },

package/src/tool/excuse-generator/i18n/es.ts

@@ -105,12 +105,6 @@ export const content: ExcuseGeneratorLocaleContent = {
       '<strong>Revolución Industrial:</strong> "La máquina de vapor se ha sobrecalentado".',
       '<strong>Era Digital:</strong> "Se me ha caído internet justo en medio de una actualización".'
     ]},
-    { type: 'stats', items: [
-      { value: '20', label: 'Sujetos posibles', icon: 'mdi:account-multiple' },
-      { value: '20', label: 'Acciones disponibles', icon: 'mdi:lightning-bolt' },
-      { value: '20', label: 'Desenlaces distintos', icon: 'mdi:door-open' },
-      { value: '8.000', label: 'Combinaciones posibles', icon: 'mdi:shuffle-variant' },
-    ], columns: 4 },
     { type: 'proscons', items: [
       { pro: 'Alivia la presión social al instante', con: 'El uso excesivo erosiona la confianza' },
       { pro: 'Protege tu energía y tus límites personales', con: 'Puede generar culpa si se usa sin cuidado' },

package/src/tool/fortune-cookie/i18n/es.ts

@@ -117,11 +117,6 @@ export const content: FortuneCookieLocaleContent = {
       { value: '25', label: 'Fortunas en este oráculo', icon: 'mdi:star-shooting' },
       { value: '1/día', label: 'Un destino diario', icon: 'mdi:calendar-today' },
     ], columns: 4 },
-    { type: 'proscons', items: [
-      { pro: 'Momento de pausa y reflexión diaria', con: 'Sin base científica predictiva real' },
-      { pro: 'Inspiración positiva con frases atemporales', con: 'El mensaje es el mismo sin importar el contexto' },
-      { pro: 'Completamente privado, sin datos enviados al servidor', con: 'Solo una fortuna al día (¡diseño intencionado!)' },
-    ]},
   ],
   faq,
   bibliography,

package/src/tool/synesthesia-painter/i18n/es.ts

@@ -101,17 +101,15 @@ export const content: SynesthesiaPainterLocaleContent = {
       '<strong>Constancia:</strong> A diferencia de las asociaciones aprendidas, los colores sinestésicos son extraordinariamente estables a lo largo del tiempo. Estudios de seguimiento a 10 años demuestran más del 90% de consistencia en las asociaciones grafema-color.',
       '<strong>Sinestésicos famosos:</strong> Vladimir Nabokov, Wassily Kandinsky, Nikola Tesla y Billy Joel han descrito públicamente experiencias sinestésicas que influyeron en sus obras.',
     ]},
-    { type: 'title', text: 'Arte y sinestesia: cuando los sentidos se fusionan', level: 3 },
-    { type: 'paragraph', html: 'La sinestesia ha tenido una influencia profunda en el arte del siglo XX. <strong>Wassily Kandinsky</strong>, fundador del expresionismo abstracto, experimentaba tanto sinestesia grafema-color como música-color: escuchaba los instrumentos en colores (el amarillo era un trompetín, el azul profundo un chelo) y usó estas percepciones para crear su teoría del arte abstracto. Su obra <em>Composición IV</em> es inseparable de esta experiencia sensorial. En música, <strong>Alexander Scriabin</strong> compuso el <em>Prometheus: El Poema del Fuego</em> con una parte para "tastiera per luce" (teclado de luz), diseñada para proyectar los colores correspondientes a cada nota.' },
-    { type: 'tip', title: 'Paleta cromática de esta herramienta', html: 'La asignación de colores está inspirada en los datos estadísticos más comunes de la literatura científica y en la tradición artística de la sinestesia. <strong>A → rojo</strong>, <strong>E → verde</strong>, <strong>I → blanco/negro según el fondo</strong>, <strong>O → negro/blanco</strong>, <strong>U → ámbar</strong>. Las consonantes siguen patrones menos uniformes, pero siempre se prioriza el contraste con el fondo para garantizar legibilidad.' },
-    { type: 'title', text: 'Aplicaciones prácticas: diseño, música y terapia', level: 3 },
-    { type: 'paragraph', html: 'Más allá de la curiosidad científica, la sinestesia grafema-color tiene aplicaciones concretas. En <strong>diseño tipográfico</strong>, entender estas asociaciones ayuda a elegir paletas de color para logotipos que "resuenen" con el nombre de la marca. En <strong>educación</strong>, se han desarrollado sistemas de aprendizaje del abecedario que usan los colores estadísticamente reportados para facilitar la memorización en niños pequeños. En <strong>musicoterapia</strong>, las visualizaciones sinestésicas se usan para ayudar a pacientes con afasia a reconectar con el lenguaje a través del canal visual-cromático.' },
     { type: 'stats', items: [
       { value: '4-8%', label: 'Población con sinestesia', icon: 'mdi:brain' },
       { value: '+90%', label: 'Consistencia de color a 10 años', icon: 'mdi:check-circle' },
       { value: '3-6×', label: 'Más frecuente en mujeres', icon: 'mdi:gender-female' },
       { value: '26+10', label: 'Letras y dígitos coloreados', icon: 'mdi:alphabetical' },
     ], columns: 4 },
+    { type: 'title', text: 'Arte y sinestesia: cuando los sentidos se fusionan', level: 3 },
+    { type: 'paragraph', html: 'La sinestesia ha tenido una influencia profunda en el arte del siglo XX. <strong>Wassily Kandinsky</strong>, fundador del expresionismo abstracto, experimentaba tanto sinestesia grafema-color como música-color: escuchaba los instrumentos en colores (el amarillo era un trompetín, el azul profundo un chelo) y usó estas percepciones para crear su teoría del arte abstracto. Su obra <em>Composición IV</em> es inseparable de esta experiencia sensorial. En música, <strong>Alexander Scriabin</strong> compuso el <em>Prometheus: El Poema del Fuego</em> con una parte para "tastiera per luce" (teclado de luz), diseñada para proyectar los colores correspondientes a cada nota.' },
+    { type: 'tip', title: 'Paleta cromática de esta herramienta', html: 'La asignación de colores está inspirada en los datos estadísticos más comunes de la literatura científica y en la tradición artística de la sinestesia. <strong>A → rojo</strong>, <strong>E → verde</strong>, <strong>I → blanco/negro según el fondo</strong>, <strong>O → negro/blanco</strong>, <strong>U → ámbar</strong>. Las consonantes siguen patrones menos uniformes, pero siempre se prioriza el contraste con el fondo para garantizar legibilidad.' },
   ],
   faq,
   bibliography,

package/src/tool/zalgo-generator/i18n/es.ts

@@ -95,13 +95,6 @@ export const content: ZalgoGeneratorLocaleContent = {
     ]},
     { type: 'title', text: 'El Origen: De Something Awful al Glitch Art', level: 3 },
     { type: 'paragraph', html: 'Zalgo no nació como un generador, sino como una intervención en tiras cómicas clásicas. El usuario Shmorky, a mediados de los 2000, empezó a deformar personajes como Nancy o Archie, añadiendo manchas y distorsiones. La frase <strong>"He comes"</strong> sellaba el destino de estas obras, anunciando la llegada de una entidad que devoraba la realidad.' },
-    { type: 'paragraph', html: 'La transición al texto puro fue un descubrimiento técnico fascinante. Al identificar los caracteres combinados destinados a lenguas con diacríticos complejos, los usuarios de foros aprendieron que podían "apuñalar" las palabras originales, creando esa sensación de sangrado tipográfico tan icónica.' },
-    { type: 'stats', items: [
-      { value: '50', label: 'Diacríticos superiores disponibles', icon: 'mdi:arrow-up-bold' },
-      { value: '23', label: 'Modificadores centrales', icon: 'mdi:minus' },
-      { value: '40', label: 'Diacríticos inferiores disponibles', icon: 'mdi:arrow-down-bold' },
-      { value: '×30', label: 'Multiplicador de intensidad máxima', icon: 'mdi:lightning-bolt' },
-    ], columns: 4 },
     { type: 'glossary', items: [
       { term: 'Carácter combinado', definition: 'Punto de código Unicode diseñado para colocarse encima, debajo o a través de un carácter base. Se usa legítimamente en árabe, vietnamita e hindi.' },
       { term: 'Diacrítico', definition: 'Marca añadida a una letra base para modificar su pronunciación o significado. Zalgo abusa de ellos para crear desbordamiento visual.' },