@jjlmoya/utils-diy 1.27.0 → 1.28.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-diy",
-    "version": "1.27.0",
+    "version": "1.28.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/drywallCalculator/seo.astro

@@ -1,14 +1,15 @@
 ---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { drywallCalculatorEntry } from './entry';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const loader = drywallCalculatorEntry.i18n[locale as KnownLocale] ?? drywallCalculatorEntry.i18n.es ?? drywallCalculatorEntry.i18n.en;
+const content = loader ? await loader() : null;
 ---
 
-<div class="drywall-seo-content">
-  <p>
-    Planning a drywall partition wall or ceiling lining requires precise calculations of light gauge steel framing members, plasterboard sheets, and jointing materials. This calculator provides complete material takeoffs based on standard architectural specifications for dry construction systems.
-  </p>
-  <h3>Key Drywall Installation Principles</h3>
-  <ul>
-    <li><strong>Stud Spacing:</strong> Standard non-load-bearing interior partitions use 60 cm stud centers for speed and efficiency. Damp locations or tiled walls require 40 cm centers to prevent structural deflection.</li>
-    <li><strong>Joint Staggering:</strong> Plasterboard sheets must be staggered horizontally by at least 40 cm between courses to prevent continuous vertical stress seams.</li>
-    <li><strong>Fastener Density:</strong> Board perimeter screws are placed every 25 cm, while interior field screws are spaced every 30 cm along studs.</li>
-  </ul>
-</div>
+{content?.seo && content.seo.length > 0 && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/excavationVolumeCalculator/seo.astro

@@ -1,11 +1,15 @@
 ---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { excavationVolumeCalculator } from './entry';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const loader = excavationVolumeCalculator.i18n[locale as KnownLocale] ?? excavationVolumeCalculator.i18n.es ?? excavationVolumeCalculator.i18n.en;
+const content = loader ? await loader() : null;
 ---
 
-<div class="ev-seo-content">
-  <p>Excavation planning has two different questions. How much ground is removed from the cut, and how much room will that disturbed material occupy when it is loaded or stored? This calculator keeps those answers separate.</p>
-  <h2>Bank volume is the geometry of the cut</h2>
-  <p>Multiply length by width by depth to get the bank volume in undisturbed ground. Use this figure when describing the excavation, comparing it with a foundation layout, or checking the amount of material that must leave the cut.</p>
-  <h2>Loose volume is the handling allowance</h2>
-  <p>Digging breaks the original packing arrangement. The soil then occupies more space, so the tool applies a visible expansion band to the bank volume. Use the lower and upper loose figures when choosing skips, truck capacity, stockpile space, or a temporary staging area.</p>
-  <p>The band is a planning assumption, not a laboratory result. Moisture, density, clay mineralogy, groundwater, excavation method, and later compaction can move the real volume. A site measurement is still needed for a foundation, retaining structure, disposal record, contaminated ground, or expansive clay.</p>
-</div>
+{content?.seo && content.seo.length > 0 && <SEORenderer content={{ locale, sections: content.seo }} />}