@jjlmoya/utils-games-development 1.65.0 → 1.66.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-games-development",
-    "version": "1.65.0",
+    "version": "1.66.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

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/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/tool/damageFormulaLab/bibliography.astro

@@ -1,24 +1,6 @@
 ---
-import type { BibliographyEntry } from '../../types';
-
-interface Props {
-  title?: string;
-  entries?: BibliographyEntry[];
-}
-
-const { title = 'References', entries = [] } = Astro.props;
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
+import { bibliographyEntries } from './bibliography';
 ---
 
-{entries.length > 0 && (
-  <section class="damage-lab-references" aria-labelledby="damage-lab-reference-title">
-    <h2 id="damage-lab-reference-title">{title}</h2>
-    <ul>
-      {entries.map((entry) => <li><a href={entry.url} rel="noopener noreferrer" target="_blank">{entry.name}</a></li>)}
-    </ul>
-  </section>
-)}
-
-<style>
-  .damage-lab-references { margin-block: 2rem; }
-  .damage-lab-references a { color: var(--n-primary); }
-</style>
+<SharedBibliography links={bibliographyEntries} />

package/src/tool/damageFormulaLab/seo.astro

@@ -1,13 +1,15 @@
 ---
 import { SEORenderer } from '@jjlmoya/utils-shared';
-import type { SEOSection } from '../../types';
+import { damageFormulaLab } from './entry';
+import type { KnownLocale } from '../../types';
 
 interface Props {
-  locale?: string;
-  sections?: SEOSection[];
+  locale?: KnownLocale;
 }
 
-const { locale = 'en', sections = [] } = Astro.props;
+const { locale = 'es' } = Astro.props;
+const loader = damageFormulaLab.i18n[locale as KnownLocale] ?? damageFormulaLab.i18n.es ?? damageFormulaLab.i18n.en;
+const content = loader ? await loader() : null;
 ---
 
-<SEORenderer content={{ locale, sections }} />
+{content?.seo && content.seo.length > 0 && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/gameDeltaTimeFixedTimestepLab/bibliography.astro

@@ -1,22 +1,6 @@
 ---
-import type { BibliographyEntry } from '../../types';
-
-interface Props {
-  title?: string;
-  entries?: BibliographyEntry[];
-}
-
-const { title = 'References', entries = [] } = Astro.props;
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
+import { bibliographyEntries } from './bibliography';
 ---
 
-{entries.length > 0 && <section class="gll-references" aria-labelledby="gll-reference-title"><h2 id="gll-reference-title">{title}</h2><ul>{entries.map((entry) => <li><a href={entry.url} rel="noopener noreferrer" target="_blank">{entry.name}</a></li>)}</ul></section>}
-
-<style>
-  .gll-references {
-    margin-block: 2rem;
-  }
-
-  .gll-references a {
-    color: var(--n-primary);
-  }
-</style>
+<SharedBibliography links={bibliographyEntries} />

package/src/tool/hitboxHurtboxAnimator/seo.astro

@@ -1,13 +1,15 @@
 ---
 import { SEORenderer } from '@jjlmoya/utils-shared';
-import type { SEOSection } from '../../types';
+import { hitboxHurtboxAnimator } from './entry';
+import type { KnownLocale } from '../../types';
 
 interface Props {
-  locale?: string;
-  sections?: SEOSection[];
+  locale?: KnownLocale;
 }
 
-const { locale = 'en', sections = [] } = Astro.props;
+const { locale = 'es' } = Astro.props;
+const loader = hitboxHurtboxAnimator.i18n[locale as KnownLocale] ?? hitboxHurtboxAnimator.i18n.es ?? hitboxHurtboxAnimator.i18n.en;
+const content = loader ? await loader() : null;
 ---
 
-<SEORenderer content={{ locale, sections }} />
+{content?.seo && content.seo.length > 0 && <SEORenderer content={{ locale, sections: content.seo }} />}