@jjlmoya/utils-developer 1.28.0 → 1.29.1

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-developer",
-    "version": "1.28.0",
+    "version": "1.29.1",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

package/src/entries.ts

@@ -54,6 +54,8 @@ export { visualCssGridFlexboxGenerator } from './tool/visualCssGridFlexboxGenera
 export type { VisualCssGridFlexboxGeneratorLocaleContent } from './tool/visualCssGridFlexboxGenerator/entry';
 export { cssBoxShadowGenerator } from './tool/cssBoxShadowGenerator/entry';
 export type { CssBoxShadowGeneratorLocaleContent } from './tool/cssBoxShadowGenerator/entry';
+export { promoteThisWebsite } from './tool/promoteThisWebsite/entry';
+export type { PromoteThisWebsiteLocaleContent } from './tool/promoteThisWebsite/entry';
 export { developerCategory } from './category';
 import { aspectRatio } from './tool/aspectRatio/entry';
 import { calculadoraTiempoDatos } from './tool/calculadoraTiempoDatos/entry';
@@ -83,4 +85,5 @@ import { serpPixelSimulator } from './tool/serpPixelSimulator/entry';
 import { jwtDecoder } from './tool/jwtDecoder/entry';
 import { visualCssGridFlexboxGenerator } from './tool/visualCssGridFlexboxGenerator/entry';
 import { cssBoxShadowGenerator } from './tool/cssBoxShadowGenerator/entry';
-export const ALL_ENTRIES = [aspectRatio, calculadoraTiempoDatos, colorConverter, conversorExcelCsvHtml, cronGenerator, cssSpecificityCalculator, cssToInlineConverter, duplicateCssRemover, generadorSecurityTxt, hashGenerator, inspectorCertificadosSsl, jsonFormatter, keycode, llmCostCalculator, mobileMockupGenerator, musicalTypography, placeholderGenerator, promptLibrary, readabilityCalculator, svgSanitizer, svgToCss, urlCleaner, urlEncoderDecoder, utmGenerator, serpPixelSimulator, jwtDecoder, visualCssGridFlexboxGenerator, cssBoxShadowGenerator];
+import { promoteThisWebsite } from './tool/promoteThisWebsite/entry';
+export const ALL_ENTRIES = [aspectRatio, calculadoraTiempoDatos, colorConverter, conversorExcelCsvHtml, cronGenerator, cssSpecificityCalculator, cssToInlineConverter, duplicateCssRemover, generadorSecurityTxt, hashGenerator, inspectorCertificadosSsl, jsonFormatter, keycode, llmCostCalculator, mobileMockupGenerator, musicalTypography, placeholderGenerator, promptLibrary, readabilityCalculator, svgSanitizer, svgToCss, urlCleaner, urlEncoderDecoder, utmGenerator, serpPixelSimulator, jwtDecoder, visualCssGridFlexboxGenerator, cssBoxShadowGenerator, promoteThisWebsite];

package/src/tests/entry_contract.test.ts

@@ -0,0 +1,10 @@
+import { describe, expect, it } from 'vitest';
+import { ALL_ENTRIES } from '../entries';
+
+describe('Tool entry consumer contract', () => {
+  it('every published tool exposes a Spanish locale loader', () => {
+    for (const entry of ALL_ENTRIES) {
+      expect(typeof entry.i18n.es, `${entry.id} must expose i18n.es`).toBe('function');
+    }
+  });
+});

package/src/tests/i18n_coverage.test.ts

@@ -4,6 +4,7 @@ import { ALL_TOOLS } from '../tools';
 const EXPECTED_LOCALES = [
   'de', 'en', 'es', 'fr', 'id', 'it', 'ja', 'ko', 'nl', 'pl', 'pt', 'ru', 'sv', 'tr', 'zh'
 ];
+const ENGLISH_FIRST_TOOLS = new Set(['promote-this-website']);
 
 describe('I18n Coverage Validation', () => {
   it('all tools should be registered', () => {
@@ -14,7 +15,8 @@ describe('I18n Coverage Validation', () => {
     describe(`Tool: ${entry.id}`, () => {
       it('should have all 15 required locales', () => {
         const registeredLocales = Object.keys(entry.i18n);
-        EXPECTED_LOCALES.forEach((locale) => {
+        const requiredLocales = ENGLISH_FIRST_TOOLS.has(entry.id) ? ['en'] : EXPECTED_LOCALES;
+        requiredLocales.forEach((locale) => {
           expect(
             registeredLocales,
             `Tool "${entry.id}" is missing locale "${locale}"`,
@@ -23,7 +25,8 @@ describe('I18n Coverage Validation', () => {
       });
 
       it('all locale loaders should be functions', () => {
-        EXPECTED_LOCALES.forEach((locale) => {
+        const requiredLocales = ENGLISH_FIRST_TOOLS.has(entry.id) ? ['en'] : EXPECTED_LOCALES;
+        requiredLocales.forEach((locale) => {
           const loader = entry.i18n[locale as keyof typeof entry.i18n];
           expect(
             typeof loader,

package/src/tests/locale_completeness.test.ts

@@ -36,6 +36,6 @@ describe('Locale Completeness Validation', () => {
   });
 
   it('all 28 tools registered', () => {
-    expect(ALL_TOOLS.length).toBe(28);
+    expect(ALL_TOOLS.length).toBe(29);
   });
 });

package/src/tests/qa-test-helpers.ts

@@ -0,0 +1,32 @@
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+
+export const repositoryRoot = process.cwd();
+export const toolRoot = join(repositoryRoot, 'src', 'tool');
+
+export function listToolDirectories(): string[] {
+  return readdirSync(toolRoot)
+    .map((name) => join(toolRoot, name))
+    .filter((path) => statSync(path).isDirectory());
+}
+
+export function findFiles(directory: string, extensions: string[]): string[] {
+  const files: string[] = [];
+
+  for (const entry of readdirSync(directory, { withFileTypes: true })) {
+    const path = join(directory, entry.name);
+    if (entry.isDirectory()) files.push(...findFiles(path, extensions));
+    else if (extensions.some((extension) => entry.name.endsWith(extension))) files.push(path);
+  }
+
+  return files;
+}
+
+export function read(path: string): string {
+  return readFileSync(path, 'utf8');
+}
+
+export function displayPath(path: string): string {
+  return relative(repositoryRoot, path).replace(/\\/g, '/');
+}
+

package/src/tests/qa_bibliography_links.test.ts

@@ -0,0 +1,43 @@
+import { describe, expect, it } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import type { ToolLocaleContent } from '../types';
+
+interface LinkFailure {
+  tool: string;
+  message: string;
+}
+
+function inspectEntry(tool: string, entry: { url: string }, seen: Set<string>): LinkFailure[] {
+  let url: URL;
+  try {
+    url = new URL(entry.url);
+  } catch {
+    return [{ tool, message: `invalid URL: ${entry.url}` }];
+  }
+
+  const failures: LinkFailure[] = [];
+  if (url.protocol !== 'https:') failures.push({ tool, message: `non-HTTPS URL: ${entry.url}` });
+  if (url.pathname === '/' && !url.search && !url.hash) failures.push({ tool, message: `generic homepage, cite the exact document: ${entry.url}` });
+  if (seen.has(url.href)) failures.push({ tool, message: `duplicate source URL: ${entry.url}` });
+  seen.add(url.href);
+  return failures;
+}
+
+async function inspectTool(tool: typeof ALL_TOOLS[number]): Promise<LinkFailure[]> {
+  const loader = tool.entry.i18n.en;
+  if (!loader) return [{ tool: tool.entry.id, message: 'English locale loader is missing' }];
+  const content = (await loader()) as ToolLocaleContent;
+  const seen = new Set<string>();
+  return (content.bibliography ?? []).flatMap((entry) => inspectEntry(tool.entry.id, entry, seen));
+}
+
+describe('QA: bibliography links are specific and usable', () => {
+  it('uses unique HTTPS links to exact source pages instead of generic homepages', async () => {
+    const failures: LinkFailure[] = [];
+
+    for (const tool of ALL_TOOLS) failures.push(...await inspectTool(tool));
+
+    const messages = failures.map(({ tool, message }) => `${tool}: ${message}`);
+    expect(messages, `Bibliography hygiene failures:\n${messages.join('\n')}`).toEqual([]);
+  });
+});

package/src/tests/qa_claim_evidence.test.ts

@@ -0,0 +1,69 @@
+import { describe, expect, it } from 'vitest';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { displayPath, listToolDirectories, read } from './qa-test-helpers';
+
+const evidenceClaims = [
+  /\bofficial algorithm\b/i,
+  /\balgoritmo oficial\b/i,
+  /\b(?:records|data|rates|tables) updated(?:\s+(?:to|through)\s+20\d{2})?\b/i,
+  /\b(?:registros|datos|tasas|tablas) actualizad[oa]s?(?:\s+(?:a|hasta)\s+20\d{2})?\b/i,
+  /\b(?:validated|verified) (?:method|algorithm|calculation)\b/i,
+  /\b(?:método|algoritmo|cálculo) (?:validado|verificado)\b/i,
+  /\b(?:guarantees|ensures)\b/i,
+  /\bgarantiza\b/i,
+  /\bofficial (?:data|rate|calculation)\b/i,
+  /\b(?:datos|tasa|cálculo) oficial(?:es)?\b/i,
+];
+
+const requiredEvidenceFields = [
+  'reviewedAt',
+  'methodology',
+  'sources',
+  'referenceCases',
+  'limitations',
+];
+
+describe('QA: strong factual claims are traceable', () => {
+  it('requires machine-readable validation evidence beside tools making strong claims', () => {
+    const failures: string[] = [];
+
+    for (const directory of listToolDirectories()) {
+      const localePaths = ['en', 'es']
+        .map((locale) => join(directory, 'i18n', `${locale}.ts`))
+        .filter(existsSync);
+      const claims = localePaths.flatMap((path) => {
+        const source = read(path);
+        return evidenceClaims
+          .filter((pattern) => pattern.test(source))
+          .map((pattern) => `${displayPath(path)} matches ${pattern.source}`);
+      });
+      if (claims.length === 0) continue;
+
+      const evidencePath = join(directory, 'validation.ts');
+      if (!existsSync(evidencePath)) {
+        failures.push(`${displayPath(evidencePath)} missing; claims: ${claims.join(' | ')}`);
+        continue;
+      }
+
+      const evidence = read(evidencePath);
+      const missingFields = requiredEvidenceFields.filter(
+        (field) => !new RegExp(`\\b${field}\\s*:`).test(evidence),
+      );
+      if (missingFields.length > 0) {
+        failures.push(`${displayPath(evidencePath)} missing fields: ${missingFields.join(', ')}`);
+      }
+    }
+
+    expect(
+      failures,
+      [
+        'Claims such as official, validated, guaranteed or updated need inspectable evidence.',
+        'Add validation.ts with reviewedAt, methodology, sources, referenceCases and limitations,',
+        'or weaken/remove the unsupported claim.',
+        ...failures,
+      ].join('\n'),
+    ).toEqual([]);
+  });
+});
+

package/src/tests/qa_logic_reference_coverage.test.ts

@@ -0,0 +1,46 @@
+import { describe, expect, it } from 'vitest';
+import { basename, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import {
+  displayPath,
+  findFiles,
+  listToolDirectories,
+  read,
+  repositoryRoot,
+} from './qa-test-helpers';
+
+function hasDedicatedLogicTest(toolDirectory: string): boolean {
+  const localCandidates = [
+    join(toolDirectory, 'logic.test.ts'),
+    join(toolDirectory, 'logic.spec.ts'),
+    join(toolDirectory, '__tests__', 'logic.test.ts'),
+    join(toolDirectory, '__tests__', 'logic.spec.ts'),
+  ];
+  if (localCandidates.some(existsSync)) return true;
+
+  const toolName = basename(toolDirectory);
+  const centralTests = findFiles(join(repositoryRoot, 'src', 'tests'), ['.test.ts', '.spec.ts']);
+  return centralTests.some((testPath) => {
+    const source = read(testPath).replace(/\\/g, '/');
+    return source.includes(`/tool/${toolName}/logic`) || source.includes(`../tool/${toolName}/logic`);
+  });
+}
+
+describe('QA: calculation logic has reference tests', () => {
+  it('gives every public calculator logic module its own behavioral test suite', () => {
+    const failures = listToolDirectories()
+      .filter((directory) => existsSync(join(directory, 'logic.ts')))
+      .filter((directory) => !hasDedicatedLogicTest(directory))
+      .map((directory) => `${displayPath(join(directory, 'logic.ts'))} -> no test imports this module`);
+
+    expect(
+      failures,
+      [
+        'Add behavioral tests through each logic module public API.',
+        'At minimum cover a documented reference case, boundaries, invalid input and invariants.',
+        ...failures,
+      ].join('\n'),
+    ).toEqual([]);
+  });
+});
+

package/src/tests/qa_runtime_i18n.test.ts

@@ -0,0 +1,115 @@
+import { describe, expect, it } from 'vitest';
+import { basename, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import {
+  displayPath,
+  findFiles,
+  listToolDirectories,
+  read,
+  repositoryRoot,
+} from './qa-test-helpers';
+
+interface VisibleLiteral {
+  line: number;
+  value: string;
+}
+
+const domTextAssignment = /\.(?:innerText|textContent|innerHTML)\s*=/;
+const quotedLiteral = /(['"`])((?:\\.|(?!\1).)*)\1/g;
+
+function visibleWords(value: string): string {
+  return value
+    .replace(/\$\{[^}]*\}/g, ' ')
+    .replace(/<[^>]+>/g, ' ')
+    .replace(/&[a-z]+;/gi, ' ')
+    .replace(/[\d\p{P}\p{S}_]+/gu, ' ')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+const technicalLiteralPatterns = [
+  /^(?:\.|#|\[)/,
+  /^data-[a-z0-9-]+$/i,
+  /^(?:cc|ss)-copied$/i,
+  /^invalid-segments$/,
+  /^\(space\)$/,
+  /^(?:SHA-1|SHA-256|SHA-512|en-US)$/i,
+  /^(?:h|px|años)$/i,
+  /^\d+\s+[A-Z]$/,
+  /^(?:if \(|\{ key:)/,
+];
+
+function isTechnicalLiteral(value: string): boolean {
+  const trimmed = value.trim();
+  return value.includes('${t.')
+    || value.includes('${ui.')
+    || value.includes('${localized.')
+    || technicalLiteralPatterns.some((pattern) => pattern.test(value) || pattern.test(trimmed))
+    || (value.includes('${') && /(?:px|\bh\b|años)/i.test(value));
+}
+
+function hardcodedVisibleLiterals(source: string): VisibleLiteral[] {
+  const failures: VisibleLiteral[] = [];
+
+  source.split(/\r?\n/).forEach((line, index) => {
+    if (!domTextAssignment.test(line)) return;
+
+    const assignment = line.slice(line.search(domTextAssignment));
+    for (const match of assignment.matchAll(quotedLiteral)) {
+      if (isTechnicalLiteral(match[2])) continue;
+      const words = visibleWords(match[2]);
+      if (words && /\p{L}/u.test(words)) {
+        failures.push({ line: index + 1, value: match[2] });
+      }
+    }
+  });
+
+  return failures;
+}
+
+function runtimeSources(toolDirectory: string): string {
+  return findFiles(toolDirectory, ['.astro', '.ts', '.js'])
+    .filter((path) => !path.includes(`${join(toolDirectory, 'i18n')}`))
+    .filter((path) => basename(path) !== 'ui.ts')
+    .map(read)
+    .join('\n');
+}
+
+describe('QA: runtime copy is localized', () => {
+  const componentFiles = findFiles(join(repositoryRoot, 'src', 'tool'), ['.astro']);
+
+  it('does not write user-facing string literals directly into the DOM', () => {
+    const failures = componentFiles.flatMap((path) =>
+      hardcodedVisibleLiterals(read(path)).map(
+        ({ line, value }) => `${displayPath(path)}:${line} -> ${JSON.stringify(value)}`,
+      ),
+    );
+
+    expect(
+      failures,
+      `Move visible browser copy to the tool UI locale contract:\n${failures.join('\n')}`,
+    ).toEqual([]);
+  });
+
+  it('uses every string declared by each UI locale contract', () => {
+    const failures: string[] = [];
+
+    for (const directory of listToolDirectories()) {
+      const uiPath = join(directory, 'ui.ts');
+      if (!existsSync(uiPath)) continue;
+
+      const keys = Array.from(read(uiPath).matchAll(/^\s*(\w+)\??:\s*string\s*;/gm), (match) => match[1]);
+      const runtime = runtimeSources(directory);
+      const unused = keys.filter((key) => !new RegExp(`\\b${key}\\b`).test(runtime));
+
+      if (unused.length > 0) {
+        failures.push(`${displayPath(uiPath)} -> unused: ${unused.join(', ')}`);
+      }
+    }
+
+    expect(
+      failures,
+      `Unused locale keys are dead copy or may mean the browser bypasses translations:\n${failures.join('\n')}`,
+    ).toEqual([]);
+  });
+});

package/src/tests/tool_validation.test.ts

@@ -5,7 +5,7 @@ import { developerCategory } from '../data';
 describe('Tool Validation Suite', () => {
   describe('Library Registration', () => {
     it('should have 28 tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(28);
+      expect(ALL_TOOLS.length).toBe(29);
     });
 
     it('developerCategory should be defined', () => {

package/src/tool/aspectRatio/bibliography.astro

@@ -1,14 +1,6 @@
 ---
 import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
-import { aspectRatio } from './index';
-import type { KnownLocale } from '../../types';
-
-interface Props {
-  locale?: KnownLocale;
-}
-
-const { locale = 'es' } = Astro.props;
-const content = await aspectRatio.i18n[locale]?.();
+import { bibliography } from './bibliography';
 ---
 
-{content && <SharedBibliography links={content.bibliography} />}
+<SharedBibliography links={bibliography} />

package/src/tool/aspectRatio/bibliography.ts

@@ -0,0 +1,7 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  { name: 'MDN Web Docs: aspect-ratio (CSS)', url: 'https://developer.mozilla.org/en-US/docs/Web/CSS/aspect-ratio' },
+  { name: 'Wikipedia: Aspect ratio', url: 'https://en.wikipedia.org/wiki/Aspect_ratio' },
+  { name: 'W3C: CSS Box Sizing Level 4', url: 'https://www.w3.org/TR/css-sizing-4/#aspect-ratio' },
+];

package/src/tool/aspectRatio/i18n/de.ts

@@ -1,3 +1,4 @@
+import { bibliography } from '../bibliography';
 import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
 import type { ToolLocaleContent } from '../../../types';
 import type { AspectRatioUI } from '../ui';
@@ -109,20 +110,7 @@ export const content: ToolLocaleContent<AspectRatioUI> = {
   faqTitle: 'Häufig gestellte Fragen',
   faq: faqData,
   bibliographyTitle: 'Referenzen und Dokumentation',
-  bibliography: [
-    {
-      name: 'MDN Web Docs: aspect-ratio (CSS)',
-      url: 'https://developer.mozilla.org/en-US/docs/Web/CSS/aspect-ratio',
-    },
-    {
-      name: 'Wikipedia: Seitenverhältnis',
-      url: 'https://de.wikipedia.org/wiki/Seitenverhältnis',
-    },
-    {
-      name: 'W3C: CSS Box Sizing Level 4',
-      url: 'https://www.w3.org/TR/css-sizing-4/#aspect-ratio',
-    },
-  ],
+  bibliography,
   howTo: howToData,
   schemas: [faqSchema, howToSchema, appSchema],
   seo: [

package/src/tool/aspectRatio/i18n/en.ts

@@ -1,3 +1,4 @@
+import { bibliography } from '../bibliography';
 import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
 import type { ToolLocaleContent } from '../../../types';
 import type { AspectRatioUI } from '../ui';
@@ -109,20 +110,7 @@ export const content: ToolLocaleContent<AspectRatioUI> = {
   faqTitle: 'Frequently Asked Questions',
   faq: faqData,
   bibliographyTitle: 'References and Documentation',
-  bibliography: [
-    {
-      name: 'MDN Web Docs: aspect-ratio (CSS)',
-      url: 'https://developer.mozilla.org/en-US/docs/Web/CSS/aspect-ratio',
-    },
-    {
-      name: 'Wikipedia: Aspect ratio',
-      url: 'https://en.wikipedia.org/wiki/Aspect_ratio',
-    },
-    {
-      name: 'W3C: CSS Box Sizing Level 4',
-      url: 'https://www.w3.org/TR/css-sizing-4/#aspect-ratio',
-    },
-  ],
+  bibliography,
   howTo: howToData,
   schemas: [faqSchema, howToSchema, appSchema],
   seo: [

package/src/tool/aspectRatio/i18n/es.ts

@@ -1,3 +1,4 @@
+import { bibliography } from '../bibliography';
 import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
 import type { ToolLocaleContent } from '../../../types';
 import type { AspectRatioUI } from '../ui';
@@ -109,20 +110,7 @@ export const content: ToolLocaleContent<AspectRatioUI> = {
   faqTitle: 'Preguntas Frecuentes',
   faq: faqData,
   bibliographyTitle: 'Referencias y Documentación',
-  bibliography: [
-    {
-      name: 'MDN Web Docs: aspect-ratio (CSS)',
-      url: 'https://developer.mozilla.org/es/docs/Web/CSS/aspect-ratio',
-    },
-    {
-      name: 'Wikipedia: Relación de aspecto',
-      url: 'https://es.wikipedia.org/wiki/Relaci%C3%B3n_de_aspecto',
-    },
-    {
-      name: 'W3C: CSS Box Sizing Level 4',
-      url: 'https://www.w3.org/TR/css-sizing-4/#aspect-ratio',
-    },
-  ],
+  bibliography,
   howTo: howToData,
   schemas: [faqSchema, howToSchema, appSchema],
   seo: [

package/src/tool/aspectRatio/i18n/fr.ts

@@ -1,3 +1,4 @@
+import { bibliography } from '../bibliography';
 import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
 import type { ToolLocaleContent } from '../../../types';
 import type { AspectRatioUI } from '../ui';
@@ -109,20 +110,7 @@ export const content: ToolLocaleContent<AspectRatioUI> = {
   faqTitle: 'Questions Fréquentes',
   faq: faqData,
   bibliographyTitle: 'Références et Documentation',
-  bibliography: [
-    {
-      name: 'MDN Web Docs: aspect-ratio (CSS)',
-      url: 'https://developer.mozilla.org/fr/docs/Web/CSS/aspect-ratio',
-    },
-    {
-      name: 'Wikipedia: Format d\'image',
-      url: 'https://fr.wikipedia.org/wiki/Format_d%27image',
-    },
-    {
-      name: 'W3C: CSS Box Sizing Level 4',
-      url: 'https://www.w3.org/TR/css-sizing-4/#aspect-ratio',
-    },
-  ],
+  bibliography,
   howTo: howToData,
   schemas: [faqSchema, howToSchema, appSchema],
   seo: [

package/src/tool/aspectRatio/i18n/id.ts

@@ -1,3 +1,4 @@
+import { bibliography } from '../bibliography';
 import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
 import type { ToolLocaleContent } from '../../../types';
 import type { AspectRatioUI } from '../ui';
@@ -109,20 +110,7 @@ export const content: ToolLocaleContent<AspectRatioUI> = {
   faqTitle: 'Pertanyaan yang Sering Diajukan',
   faq: faqData,
   bibliographyTitle: 'Referensi dan Dokumentasi',
-  bibliography: [
-    {
-      name: 'MDN Web Docs: aspect-ratio (CSS)',
-      url: 'https://developer.mozilla.org/en-US/docs/Web/CSS/aspect-ratio',
-    },
-    {
-      name: 'Wikipedia: Aspect ratio',
-      url: 'https://en.wikipedia.org/wiki/Aspect_ratio',
-    },
-    {
-      name: 'W3C: CSS Box Sizing Level 4',
-      url: 'https://www.w3.org/TR/css-sizing-4/#aspect-ratio',
-    },
-  ],
+  bibliography,
   howTo: howToData,
   schemas: [faqSchema, howToSchema, appSchema],
   seo: [

package/src/tool/aspectRatio/i18n/it.ts

@@ -1,3 +1,4 @@
+import { bibliography } from '../bibliography';
 import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
 import type { ToolLocaleContent } from '../../../types';
 import type { AspectRatioUI } from '../ui';
@@ -109,20 +110,7 @@ export const content: ToolLocaleContent<AspectRatioUI> = {
   faqTitle: 'Domande frequenti',
   faq: faqData,
   bibliographyTitle: 'Riferimenti e documentazione',
-  bibliography: [
-    {
-      name: 'MDN Web Docs: aspect-ratio (CSS)',
-      url: 'https://developer.mozilla.org/en-US/docs/Web/CSS/aspect-ratio',
-    },
-    {
-      name: 'Wikipedia: Aspect ratio',
-      url: 'https://it.wikipedia.org/wiki/Rapporto_d\'aspetto',
-    },
-    {
-      name: 'W3C: CSS Box Sizing Level 4',
-      url: 'https://www.w3.org/TR/css-sizing-4/#aspect-ratio',
-    },
-  ],
+  bibliography,
   howTo: howToData,
   schemas: [faqSchema, howToSchema, appSchema],
   seo: [

package/src/tool/aspectRatio/i18n/ja.ts

@@ -1,3 +1,4 @@
+import { bibliography } from '../bibliography';
 import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
 import type { ToolLocaleContent } from '../../../types';
 import type { AspectRatioUI } from '../ui';
@@ -109,20 +110,7 @@ export const content: ToolLocaleContent<AspectRatioUI> = {
   faqTitle: 'よくある質問',
   faq: faqData,
   bibliographyTitle: '参考文献とドキュメント',
-  bibliography: [
-    {
-      name: 'MDN Web Docs: aspect-ratio (CSS)',
-      url: 'https://developer.mozilla.org/en-US/docs/Web/CSS/aspect-ratio',
-    },
-    {
-      name: 'Wikipedia: アスペクト比',
-      url: 'https://ja.wikipedia.org/wiki/アスペクト比',
-    },
-    {
-      name: 'W3C: CSS Box Sizing Level 4',
-      url: 'https://www.w3.org/TR/css-sizing-4/#aspect-ratio',
-    },
-  ],
+  bibliography,
   howTo: howToData,
   schemas: [faqSchema, howToSchema, appSchema],
   seo: [

package/src/tool/aspectRatio/i18n/ko.ts

@@ -1,3 +1,4 @@
+import { bibliography } from '../bibliography';
 import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
 import type { ToolLocaleContent } from '../../../types';
 import type { AspectRatioUI } from '../ui';
@@ -109,20 +110,7 @@ export const content: ToolLocaleContent<AspectRatioUI> = {
   faqTitle: '자주 묻는 질문',
   faq: faqData,
   bibliographyTitle: '참고 자료 및 문서',
-  bibliography: [
-    {
-      name: 'MDN Web Docs: aspect-ratio (CSS)',
-      url: 'https://developer.mozilla.org/en-US/docs/Web/CSS/aspect-ratio',
-    },
-    {
-      name: 'Wikipedia: Aspect ratio',
-      url: 'https://ko.wikipedia.org/wiki/가로세로비',
-    },
-    {
-      name: 'W3C: CSS Box Sizing Level 4',
-      url: 'https://www.w3.org/TR/css-sizing-4/#aspect-ratio',
-    },
-  ],
+  bibliography,
   howTo: howToData,
   schemas: [faqSchema, howToSchema, appSchema],
   seo: [