@jjlmoya/utils-nature 1.22.0 → 1.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-nature",
-    "version": "1.22.0",
+    "version": "1.23.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/compostBinVolumeRatioCalculator/bibliography.astro

@@ -1,18 +1,6 @@
 ---
-import type { BibliographyEntry } from '../../types';
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
 import { bibliography } from './bibliography';
-
-interface Props {
-  locale?: string;
-}
-
-const { locale = 'en' } = Astro.props as Props;
-const entries = bibliography;
 ---
 
-<section class="compost-references" aria-labelledby="compost-references-title" data-locale={locale}>
-  <h2 id="compost-references-title">References</h2>
-  <ul>
-    {entries.map((entry: BibliographyEntry) => <li><a href={entry.url} target="_blank" rel="noreferrer">{entry.name}</a></li>)}
-  </ul>
-</section>
+<SharedBibliography links={bibliography} />

package/src/tool/compostBinVolumeRatioCalculator/seo.astro

@@ -1,23 +1,15 @@
 ---
-import type { SEOSection } from '../../types';
+import { SEORenderer } from '@jjlmoya/utils-shared';
 import { compostBinVolumeRatioCalculator } from './entry';
+import type { KnownLocale } from '../../types';
 
 interface Props {
-  locale?: string;
+  locale?: KnownLocale;
 }
 
-const { locale = 'en' } = Astro.props as Props;
-const loader = compostBinVolumeRatioCalculator.i18n[locale as keyof typeof compostBinVolumeRatioCalculator.i18n] ?? compostBinVolumeRatioCalculator.i18n.en;
+const { locale = 'es' } = Astro.props;
+const loader = compostBinVolumeRatioCalculator.i18n[locale as KnownLocale] ?? compostBinVolumeRatioCalculator.i18n.es ?? compostBinVolumeRatioCalculator.i18n.en;
 const content = loader ? await loader() : null;
-const sections = (content?.seo ?? []) as SEOSection[];
 ---
 
-<div class="compost-seo" data-locale={locale}>
-  {sections.map((section) => {
-    if (section.type === 'title') return <h2>{section.text}</h2>;
-    if (section.type === 'paragraph') return <p set:html={section.html} />;
-    if (section.type === 'list') return <ul>{section.items.map((item) => <li set:html={item} />)}</ul>;
-    if (section.type === 'tip') return <aside><h3>{section.title}</h3><div set:html={section.html} /></aside>;
-    return null;
-  })}
-</div>
+{content?.seo && content.seo.length > 0 && <SEORenderer content={{ locale, sections: content.seo }} />}