@jjlmoya/utils-science 1.50.0 → 1.52.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-science",
-    "version": "1.50.0",
+    "version": "1.52.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",
         "preversion": "npm run lint && npm run test && npm run build",
         "postversion": "git push && git push --tags",
         "patch": "npm version patch",

package/src/category/i18n/es.ts

@@ -3,7 +3,7 @@ import type { CategoryLocaleContent } from '../../types';
 export const content: CategoryLocaleContent = {
   slug: 'ciencia',
   title: 'Herramientas y Simuladores Científicos Interactivos',
-  description: 'Explora la ciencia con herramientas gratuitas online. Simuladores de impacto de asteroides, conteo de colonias bacterianas, probabilidad de simulación y renovación celular.',
+  description: 'Explora la ciencia con herramientas online para simular impactos de asteroides, contar colonias bacterianas y estudiar la probabilidad de una simulación.',
   seo: [
     {
       type: 'title',
@@ -71,7 +71,7 @@ export const content: CategoryLocaleContent = {
         'Modelado Matemático: Simulaciones basadas en leyes físicas reales (gravitación, termodinámica, balística).',
         'Educación Interactiva: Herramientas diseñadas para que estudiantes y entusiastas experimenten con variables científicas.',
         'Rigor Técnico: Datos y fórmulas extraídos de publicaciones científicas y bases de datos académicas.',
-        'Privacidad de Datos Científicos: Todos los procesos de cálculo y simulación se ejecutan en local para garantizar la seguridad de tu investigación.',
+        'Privacidad de Datos Científicos: Los procesos de cálculo y simulación se ejecutan localmente para mantener tus datos en tu dispositivo.',
       ],
     },
     {
@@ -90,8 +90,7 @@ export const content: CategoryLocaleContent = {
     },
     {
       type: 'paragraph',
-      html: '<p>La Ciencia Ciudadana es más fuerte que nunca. Tener acceso a herramientas de simulación de nivel profesional permite que cualquier persona pueda validar teorías o realizar sus propios experimentos mentales. Estas utilidades rompen las paredes del laboratorio tradicional y llevan el método científico directamente a tu pantalla. La educación científica deja de ser pasiva (leer un libro) y se convierte en activa (experimentar digitalmente con las fuerzas del universo).</p>',
+      html: '<p>La Ciencia Ciudadana ofrece nuevas formas de explorar hipótesis y realizar experimentos mentales. Estas utilidades acercan el método científico a tu pantalla y convierten la educación científica en una experiencia activa, basada en observar variables y comparar resultados.</p>',
     },
   ],
 };
-

package/src/category/i18n/fr.ts

@@ -3,7 +3,7 @@ import type { CategoryLocaleContent } from '../../types';
 export const content: CategoryLocaleContent = {
   slug: 'science',
   title: 'Outils et Simulateurs Scientifiques Interactifs',
-  description: 'Explorez la science avec des outils gratuits en ligne. Simulateurs d\'impacts d\'astéroïdes, comptage de colonies bactériennes, probabilité de simulation et calculatrices de renouvellement cellulaire.',
+  description: 'Explorez la science avec des outils en ligne pour simuler des impacts d\'astéroïdes, compter des colonies bactériennes et étudier une simulation.',
   seo: [
     {
       type: 'title',
@@ -71,7 +71,7 @@ export const content: CategoryLocaleContent = {
         'Modélisation Mathématique: Simulations basées sur des lois physiques réelles (gravitation, thermodynamique, balistique).',
         'Éducation Interactif: Outils conçus pour que les étudiants et les passionnés expérimentent avec des variables scientifiques.',
         'Rigueur Technique: Données et formules extraites de publications scientifiques et de bases de données académiques.',
-        'Confidentialité des Données Scientifiques: Tous les processus de calcul et de simulation s\'exécutent localement pour garantir la sécurité de votre recherche.',
+        'Confidentialité des Données Scientifiques: Les calculs et simulations s\'exécutent localement afin de garder vos données sur votre appareil.',
       ],
     },
     {

package/src/category/i18n/it.ts

@@ -3,7 +3,7 @@ import type { CategoryLocaleContent } from '../../types';
 export const content: CategoryLocaleContent = {
   slug: 'scienza',
   title: 'Strumenti Scientifici Interattivi e Simulatori',
-  description: 'Esplora la scienza con strumenti online gratuiti. Simulatori di impatto di asteroidi, conteggio di colonie batteriche, probabilità di simulazione e calcolatori di rinnovamento cellulare.',
+  description: 'Esplora la scienza con strumenti online per simulare impatti di asteroidi, contare colonie batteriche e studiare una simulazione.',
   seo: [
     {
       type: 'title',
@@ -71,7 +71,7 @@ export const content: CategoryLocaleContent = {
         'Modellazione Matematica: Simulazioni basate su reali leggi fisiche (gravitazione, termodinamica, balistica).',
         'Educazione Interattiva: Strumenti progettati per studenti e appassionati per sperimentare con variabili scientifiche.',
         'Rigore Tecnico: Dati e formule estratti da pubblicazioni scientifiche e database accademici.',
-        'Privacy dei Dati Scientifici: Tutti i processi di calcolo e simulazione vengono eseguiti localmente per garantire la sicurezza della tua ricerca.',
+        'Privacy dei Dati Scientifici: I calcoli e le simulazioni vengono eseguiti localmente per conservare i dati sul tuo dispositivo.',
       ],
     },
     {

package/src/category/i18n/pt.ts

@@ -3,7 +3,7 @@ import type { CategoryLocaleContent } from '../../types';
 export const content: CategoryLocaleContent = {
   slug: 'ciencia',
   title: 'Ferramentas Científicas Interativas e Simuladores',
-  description: 'Explore a ciência com ferramentas online gratuitas. Simuladores de impacto de asteroides, contagem de colónias bacterianas, probabilidade de simulação e calculadoras de renovação celular.',
+  description: 'Explore a ciência com ferramentas online para simular impactos de asteroides, contar colónias bacterianas e estudar uma simulação.',
   seo: [
     {
       type: 'title',
@@ -71,7 +71,7 @@ export const content: CategoryLocaleContent = {
         'Modelação Matemática: Simulações baseadas em leis físicas reais (gravitação, termodinâmica, balística).',
         'Educação Interativa: Ferramentas desenhadas para estudantes e entusiastas experimentarem com variáveis científicas.',
         'Rigor Técnico: Dados e fórmulas extraídos de publicações científicas e bases de dados académicas.',
-        'Privacidade de Dados Científicos: Todos os processos de cálculo e simulação correm localmente para garantir a segurança da sua investigação.',
+        'Privacidade de Dados Científicos: Os cálculos e simulações correm localmente para manter os seus dados no dispositivo.',
       ],
     },
     {

package/src/category/index.ts

@@ -1,10 +1,10 @@
-import type { ScienceCategoryEntry } from '../types';
-import { colonyCounter } from '../tool/colony-counter/entry';
+import type { ScienceCategoryEntry } from '../types';
+import { colonyCounter } from '../tool/colony-counter/entry';
 import { asteroidImpact } from '../tool/asteroid-impact/entry';
 import { microwaveDetector } from '../tool/microwave-detector/entry';
 import { simulationProbability } from '../tool/simulation-probability/entry';
 import { cellularRenewal } from '../tool/cellular-renewal/entry';
-import { cosmicInflation } from '../tool/cosmic-inflation/entry';
+import { cosmicInflation } from '../tool/cosmic-inflation/entry';
 import { temperatureTimeline } from '../tool/temperature-timeline/entry';
 import { lorenzAttractor } from '../tool/lorenz-attractor/entry';
 import { stellarHabitabilityZone } from '../tool/stellar-habitability-zone/entry';
@@ -26,26 +26,26 @@ import { fermiParadoxFilterLab } from '../tool/fermi-paradox-filter-lab/entry';
 import { epidemicSirSimulator } from '../tool/epidemic-sir-simulator/entry';
 import { blackHoleEventHorizonSimulator } from '../tool/black-hole-event-horizon-simulator/entry';
 import { exoplanetBiosignatureDetector } from '../tool/exoplanet-biosignature-detector/entry';
-
-export const scienceCategory: ScienceCategoryEntry = {
-  icon: 'mdi:flask',
+
+export const scienceCategory: ScienceCategoryEntry = {
+  icon: 'mdi:flask',
   tools: [colonyCounter, asteroidImpact, microwaveDetector, simulationProbability, cellularRenewal, cosmicInflation, temperatureTimeline, lorenzAttractor, stellarHabitabilityZone, radioactiveDecay, naturalSelectionDrift, entropySecondLaw, doubleSlitDecoherence, phaseDiagramCriticalPoints, twinParadoxVisualizer, mandelbrotFractal, planetAtmosphereSurvival, threeBodyProblem, rocheLimitSatelliteDisruption, dysonSphereEnergyCapture, globalAlbedoSnowballSimulator, conwayLifeRuleLab, crystalLatticeStructureFinder, fermiParadoxFilterLab, epidemicSirSimulator, blackHoleEventHorizonSimulator, exoplanetBiosignatureDetector],
-  i18n: {
-    es: () => import('./i18n/es').then((m) => m.content),
-    en: () => import('./i18n/en').then((m) => m.content),
-    fr: () => import('./i18n/fr').then((m) => m.content),
-    de: () => import('./i18n/de').then((m) => m.content),
-    it: () => import('./i18n/it').then((m) => m.content),
-    pt: () => import('./i18n/pt').then((m) => m.content),
-    id: () => import('./i18n/id').then((m) => m.content),
-    ja: () => import('./i18n/ja').then((m) => m.content),
-    ko: () => import('./i18n/ko').then((m) => m.content),
-    nl: () => import('./i18n/nl').then((m) => m.content),
-    pl: () => import('./i18n/pl').then((m) => m.content),
-    ru: () => import('./i18n/ru').then((m) => m.content),
-    sv: () => import('./i18n/sv').then((m) => m.content),
-    tr: () => import('./i18n/tr').then((m) => m.content),
-    zh: () => import('./i18n/zh').then((m) => m.content),
-  },
-};
-
+  i18n: {
+    es: () => import('./i18n/es').then((m) => m.content),
+    en: () => import('./i18n/en').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+    de: () => import('./i18n/de').then((m) => m.content),
+    it: () => import('./i18n/it').then((m) => m.content),
+    pt: () => import('./i18n/pt').then((m) => m.content),
+    id: () => import('./i18n/id').then((m) => m.content),
+    ja: () => import('./i18n/ja').then((m) => m.content),
+    ko: () => import('./i18n/ko').then((m) => m.content),
+    nl: () => import('./i18n/nl').then((m) => m.content),
+    pl: () => import('./i18n/pl').then((m) => m.content),
+    ru: () => import('./i18n/ru').then((m) => m.content),
+    sv: () => import('./i18n/sv').then((m) => m.content),
+    tr: () => import('./i18n/tr').then((m) => m.content),
+    zh: () => import('./i18n/zh').then((m) => m.content),
+  },
+};
+

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/data.ts

@@ -8,4 +8,4 @@ export type {
   ScienceToolEntry,
   ScienceCategoryEntry,
 } from './types';
-
+

package/src/env.d.ts

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

package/src/layouts/PreviewLayout.astro

@@ -115,4 +115,4 @@ const { title, currentLocale = "es", localeUrls = {}, hasSidebar = false } = Ast
     }
   }
 </style>
-
+

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,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);
+});

package/src/tests/faq_count.test.ts

@@ -1,19 +1,19 @@
-import { describe, it, expect } from 'vitest';
-import type * as DATA from '../data';
-
-const TOOLS: typeof DATA.scienceCategory[] = [];
-
-describe('FAQ Content Validation', () => {
-  TOOLS.forEach((entry) => {
-    describe(`Tool: ${entry.icon}`, () => {
-      it('placeholder', () => {
-        expect(true).toBe(true);
-      });
-    });
-  });
-
-  it('no tools registered yet', () => {
-    expect(TOOLS.length).toBe(0);
-  });
-});
-
+import { describe, it, expect } from 'vitest';
+import type * as DATA from '../data';
+
+const TOOLS: typeof DATA.scienceCategory[] = [];
+
+describe('FAQ Content Validation', () => {
+  TOOLS.forEach((entry) => {
+    describe(`Tool: ${entry.icon}`, () => {
+      it('placeholder', () => {
+        expect(true).toBe(true);
+      });
+    });
+  });
+
+  it('no tools registered yet', () => {
+    expect(TOOLS.length).toBe(0);
+  });
+});
+

package/src/tests/i18n_coverage.test.ts

@@ -1,36 +1,36 @@
-import { describe, it, expect } from 'vitest';
-import { ALL_TOOLS } from '../tools';
-
-const EXPECTED_LOCALES = [
-  'de', 'en', 'es', 'fr', 'id', 'it', 'ja', 'ko', 'nl', 'pl', 'pt', 'ru', 'sv', 'tr', 'zh'
-];
-
-describe('I18n Coverage Validation', () => {
-  it('all tools should be registered', () => {
-    expect(ALL_TOOLS.length).toBeGreaterThan(0);
-  });
-
-  ALL_TOOLS.forEach(({ entry }: { entry: any }) => {
-    describe(`Tool: ${entry.id}`, () => {
-      it('should have all 15 required locales', () => {
-        const registeredLocales = Object.keys(entry.i18n);
-        EXPECTED_LOCALES.forEach((locale) => {
-          expect(
-            registeredLocales,
-            `Tool "${entry.id}" is missing locale "${locale}"`,
-          ).toContain(locale);
-        });
-      });
-
-      it('all locale loaders should be functions', () => {
-        EXPECTED_LOCALES.forEach((locale) => {
-          const loader = entry.i18n[locale as keyof typeof entry.i18n];
-          expect(
-            typeof loader,
-            `Tool "${entry.id}" locale "${locale}" loader is not a function`,
-          ).toBe('function');
-        });
-      });
-    });
-  });
-});
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+
+const EXPECTED_LOCALES = [
+  'de', 'en', 'es', 'fr', 'id', 'it', 'ja', 'ko', 'nl', 'pl', 'pt', 'ru', 'sv', 'tr', 'zh'
+];
+
+describe('I18n Coverage Validation', () => {
+  it('all tools should be registered', () => {
+    expect(ALL_TOOLS.length).toBeGreaterThan(0);
+  });
+
+  ALL_TOOLS.forEach(({ entry }: { entry: any }) => {
+    describe(`Tool: ${entry.id}`, () => {
+      it('should have all 15 required locales', () => {
+        const registeredLocales = Object.keys(entry.i18n);
+        EXPECTED_LOCALES.forEach((locale) => {
+          expect(
+            registeredLocales,
+            `Tool "${entry.id}" is missing locale "${locale}"`,
+          ).toContain(locale);
+        });
+      });
+
+      it('all locale loaders should be functions', () => {
+        EXPECTED_LOCALES.forEach((locale) => {
+          const loader = entry.i18n[locale as keyof typeof entry.i18n];
+          expect(
+            typeof loader,
+            `Tool "${entry.id}" locale "${locale}" loader is not a function`,
+          ).toBe('function');
+        });
+      });
+    });
+  });
+});

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', () => {
     });
   });
 });
-
+