@drowlink/aeo-linter-core 0.1.1 → 0.1.3

package/dist/audits/content-chunking/chunk-token-density.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Auditoría para evaluar el tamaño y densidad de tokens de los bloques de contenido (para RAG)
+ * @fileoverview Audit evaluating text passage length and token density for RAG embeddings
  */
 import { Audit } from '../audit.js';
 import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';

package/dist/audits/content-chunking/chunk-token-density.js

@@ -1,13 +1,13 @@
 /**
- * @fileoverview Auditoría para evaluar el tamaño y densidad de tokens de los bloques de contenido (para RAG)
+ * @fileoverview Audit evaluating text passage length and token density for RAG embeddings
  */
 import { Audit } from '../audit.js';
 export class ChunkTokenDensityAudit extends Audit {
     static meta = {
         id: 'chunk-token-density',
-        title: 'Los bloques de contenido mantienen una densidad óptima de tokens para RAG (150 - 500 tokens)',
-        failureTitle: 'Los bloques de contenido son excesivamente largos o fragmentados',
-        description: 'La mayoría de modelos de embeddings de RAG (OpenAI text-embedding-3, Cohere Embed, Voyage) rinden con mayor precisión cuando los pasajes tienen entre 150 y 500 tokens estructurados bajo un encabezado temático.',
+        title: 'Content chunks maintain optimal token density for RAG (150 - 500 tokens)',
+        failureTitle: 'Content chunks are excessively long or fragmented',
+        description: 'Most RAG embedding models (OpenAI text-embedding-3, Cohere Embed, Voyage) achieve highest retrieval precision when passages contain 150–500 tokens grouped under a topical heading.',
         requiredArtifacts: ['ContentChunks'],
     };
     static async audit(artifacts) {
@@ -16,27 +16,27 @@ export class ChunkTokenDensityAudit extends Audit {
         if (chunks.length === 0) {
             return this.generateAuditResult({
                 score: 0.5,
-                displayValue: 'No se encontraron bloques sustanciales de texto',
+                displayValue: 'No substantial text chunks found',
             });
         }
         const optimalChunks = chunks.filter((c) => c.estimatedTokens >= 100 && c.estimatedTokens <= 600);
         const ratio = optimalChunks.length / chunks.length;
         const tableItems = chunks.slice(0, 10).map((c) => ({
             id: c.id,
-            heading: c.headingText || '(Sin encabezado)',
+            heading: c.headingText || '(No heading)',
             words: c.wordCount,
             tokens: `~${c.estimatedTokens}`,
-            status: c.estimatedTokens >= 100 && c.estimatedTokens <= 600 ? 'Óptimo' : c.estimatedTokens < 100 ? 'Muy corto' : 'Muy extenso',
+            status: c.estimatedTokens >= 100 && c.estimatedTokens <= 600 ? 'Optimal' : c.estimatedTokens < 100 ? 'Too short' : 'Too long',
         }));
         return this.generateAuditResult({
             score: ratio >= 0.7 ? 1 : Math.max(0.4, ratio),
-            displayValue: `${optimalChunks.length} de ${chunks.length} bloques con tamaño óptimo (Promedio: ~${contentChunks.averageChunkTokenCount} tokens)`,
+            displayValue: `${optimalChunks.length} of ${chunks.length} chunks have optimal size (Average: ~${contentChunks.averageChunkTokenCount} tokens)`,
             details: this.makeTableDetails([
                 { key: 'id', label: 'ID', valueType: 'code' },
-                { key: 'heading', label: 'Encabezado Asociado', valueType: 'text' },
-                { key: 'words', label: 'Palabras', valueType: 'numeric' },
-                { key: 'tokens', label: 'Tokens Estimados', valueType: 'numeric' },
-                { key: 'status', label: 'Diagnóstico', valueType: 'status' },
+                { key: 'heading', label: 'Associated Heading', valueType: 'text' },
+                { key: 'words', label: 'Words', valueType: 'numeric' },
+                { key: 'tokens', label: 'Estimated Tokens', valueType: 'numeric' },
+                { key: 'status', label: 'Diagnostic', valueType: 'status' },
             ], tableItems),
         });
     }

package/dist/audits/content-chunking/chunk-token-density.js.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-token-density.js","sourceRoot":"","sources":["../../../src/audits/content-chunking/chunk-token-density.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACxC,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,8FAA8F;QACrG,YAAY,EAAE,kEAAkE;QAChF,WAAW,EACT,mNAAmN;QACrN,iBAAiB,EAAE,CAAC,eAAe,CAAC;KACrC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QAC9C,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;QAEpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,iDAAiD;aAChE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,IAAI,GAAG,IAAI,CAAC,CAAC,eAAe,IAAI,GAAG,CAAC,CAAC;QACjG,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAEnD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjD,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,OAAO,EAAE,CAAC,CAAC,WAAW,IAAI,kBAAkB;YAC5C,KAAK,EAAE,CAAC,CAAC,SAAS;YAClB,MAAM,EAAE,IAAI,CAAC,CAAC,eAAe,EAAE;YAC/B,MAAM,EAAE,CAAC,CAAC,eAAe,IAAI,GAAG,IAAI,CAAC,CAAC,eAAe,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa;SAChI,CAAC,CAAC,CAAC;QAEJ,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK,EAAE,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC;YAC9C,YAAY,EAAE,GAAG,aAAa,CAAC,MAAM,OAAO,MAAM,CAAC,MAAM,0CAA0C,aAAa,CAAC,sBAAsB,UAAU;YACjJ,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAC5B;gBACE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE;gBAC7C,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,EAAE;gBACnE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE;gBACzD,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE;gBAClE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE;aAC7D,EACD,UAAU,CACX;SACF,CAAC,CAAC;IACL,CAAC"}
+{"version":3,"file":"chunk-token-density.js","sourceRoot":"","sources":["../../../src/audits/content-chunking/chunk-token-density.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACxC,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,0EAA0E;QACjF,YAAY,EAAE,mDAAmD;QACjE,WAAW,EACT,qLAAqL;QACvL,iBAAiB,EAAE,CAAC,eAAe,CAAC;KACrC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QAC9C,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;QAEpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,kCAAkC;aACjD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,IAAI,GAAG,IAAI,CAAC,CAAC,eAAe,IAAI,GAAG,CAAC,CAAC;QACjG,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAEnD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjD,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,OAAO,EAAE,CAAC,CAAC,WAAW,IAAI,cAAc;YACxC,KAAK,EAAE,CAAC,CAAC,SAAS;YAClB,MAAM,EAAE,IAAI,CAAC,CAAC,eAAe,EAAE;YAC/B,MAAM,EAAE,CAAC,CAAC,eAAe,IAAI,GAAG,IAAI,CAAC,CAAC,eAAe,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU;SAC9H,CAAC,CAAC,CAAC;QAEJ,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK,EAAE,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC;YAC9C,YAAY,EAAE,GAAG,aAAa,CAAC,MAAM,OAAO,MAAM,CAAC,MAAM,wCAAwC,aAAa,CAAC,sBAAsB,UAAU;YAC/I,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAC5B;gBACE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE;gBAC7C,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,EAAE;gBAClE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE;gBACtD,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE;gBAClE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE;aAC5D,EACD,UAAU,CACX;SACF,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/content-chunking/heading-hierarchy.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Auditoría para validar la jerarquía secuencial de encabezados H1-H6
+ * @fileoverview Audit validating sequential heading hierarchy (H1-H6) and single H1 tag
  */
 import { Audit } from '../audit.js';
 import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';

package/dist/audits/content-chunking/heading-hierarchy.js

@@ -1,13 +1,13 @@
 /**
- * @fileoverview Auditoría para validar la jerarquía secuencial de encabezados H1-H6
+ * @fileoverview Audit validating sequential heading hierarchy (H1-H6) and single H1 tag
  */
 import { Audit } from '../audit.js';
 export class HeadingHierarchyAudit extends Audit {
     static meta = {
         id: 'heading-hierarchy',
-        title: 'La estructura de encabezados H1-H6 es secuencial y cuenta con un único H1',
-        failureTitle: 'La jerarquía de encabezados contiene saltos de nivel o múltiples H1',
-        description: 'Una jerarquía clara y secuencial (H1 -> H2 -> H3) permite a los algoritmos de segmentación de RAG indexar el documento en fragmentos con contexto semántico preciso.',
+        title: 'Heading structure (H1-H6) is sequential and contains a single H1',
+        failureTitle: 'Heading hierarchy contains level jumps or multiple H1 tags',
+        description: 'A clear, sequential hierarchy (H1 -> H2 -> H3) allows RAG chunking algorithms to partition documents with accurate semantic context.',
         requiredArtifacts: ['HeadingsHierarchy'],
     };
     static async audit(artifacts) {
@@ -15,33 +15,33 @@ export class HeadingHierarchyAudit extends Audit {
         if (hierarchy.headings.length === 0) {
             return this.generateAuditResult({
                 score: 0,
-                displayValue: 'No se encontraron encabezados (H1-H6)',
-                explanation: 'El documento carece de encabezados semánticos para estructurar el contenido.',
+                displayValue: 'No headings found (H1-H6)',
+                explanation: 'Document lacks semantic headings to structure the content.',
             });
         }
         let deductions = 0;
         const issues = [];
         if (hierarchy.h1Count === 0) {
             deductions += 0.4;
-            issues.push('Falta el encabezado principal H1');
+            issues.push('Missing main H1 heading');
         }
         else if (hierarchy.h1Count > 1) {
             deductions += 0.2;
-            issues.push(`Se detectaron ${hierarchy.h1Count} etiquetas H1 (se recomienda exactamente una)`);
+            issues.push(`Found ${hierarchy.h1Count} H1 tags (exactly one is recommended)`);
         }
         if (!hierarchy.isHierarchySequential) {
             deductions += 0.3;
-            issues.push(`Se encontraron ${hierarchy.skippedLevels.length} saltos bruscos de nivel (e.g. H1 a H3)`);
+            issues.push(`Found ${hierarchy.skippedLevels.length} skipped heading levels (e.g. H1 to H3)`);
         }
         const score = this.clampScore(1 - deductions);
         return this.generateAuditResult({
             score,
-            displayValue: issues.length === 0 ? 'Jerarquía óptima y secuencial' : issues.join(', '),
+            displayValue: issues.length === 0 ? 'Optimal sequential heading hierarchy' : issues.join(', '),
             details: hierarchy.skippedLevels.length > 0
                 ? this.makeTableDetails([
-                    { key: 'from', label: 'Desde Nivel', valueType: 'code' },
-                    { key: 'to', label: 'Hacia Nivel', valueType: 'code' },
-                    { key: 'text', label: 'Texto del Encabezado', valueType: 'text' },
+                    { key: 'from', label: 'From Level', valueType: 'code' },
+                    { key: 'to', label: 'To Level', valueType: 'code' },
+                    { key: 'text', label: 'Heading Text', valueType: 'text' },
                 ], hierarchy.skippedLevels.map((s) => ({
                     from: `H${s.from}`,
                     to: `H${s.to}`,

package/dist/audits/content-chunking/heading-hierarchy.js.map

@@ -1 +1 @@
-{"version":3,"file":"heading-hierarchy.js","sourceRoot":"","sources":["../../../src/audits/content-chunking/heading-hierarchy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACvC,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,mBAAmB;QACvB,KAAK,EAAE,2EAA2E;QAClF,YAAY,EAAE,qEAAqE;QACnF,WAAW,EACT,sKAAsK;QACxK,iBAAiB,EAAE,CAAC,mBAAmB,CAAC;KACzC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,SAAS,GAAG,SAAS,CAAC,iBAAiB,CAAC;QAE9C,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,CAAC;gBACR,YAAY,EAAE,uCAAuC;gBACrD,WAAW,EAAE,8EAA8E;aAC5F,CAAC,CAAC;QACL,CAAC;QAED,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,SAAS,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YAC5B,UAAU,IAAI,GAAG,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,SAAS,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACjC,UAAU,IAAI,GAAG,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,iBAAiB,SAAS,CAAC,OAAO,+CAA+C,CAAC,CAAC;QACjG,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,qBAAqB,EAAE,CAAC;YACrC,UAAU,IAAI,GAAG,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,kBAAkB,SAAS,CAAC,aAAa,CAAC,MAAM,yCAAyC,CAAC,CAAC;QACzG,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;QAE9C,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YACvF,OAAO,EAAE,SAAS,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;gBACzC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CACnB;oBACE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE;oBACxD,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE;oBACtD,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,EAAE;iBAClE,EACD,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAClC,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE;oBAClB,EAAE,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE;oBACd,IAAI,EAAE,CAAC,CAAC,IAAI;iBACb,CAAC,CAAC,CACJ;gBACH,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC"}
+{"version":3,"file":"heading-hierarchy.js","sourceRoot":"","sources":["../../../src/audits/content-chunking/heading-hierarchy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACvC,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,mBAAmB;QACvB,KAAK,EAAE,kEAAkE;QACzE,YAAY,EAAE,4DAA4D;QAC1E,WAAW,EACT,sIAAsI;QACxI,iBAAiB,EAAE,CAAC,mBAAmB,CAAC;KACzC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,SAAS,GAAG,SAAS,CAAC,iBAAiB,CAAC;QAE9C,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,CAAC;gBACR,YAAY,EAAE,2BAA2B;gBACzC,WAAW,EAAE,4DAA4D;aAC1E,CAAC,CAAC;QACL,CAAC;QAED,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,SAAS,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YAC5B,UAAU,IAAI,GAAG,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,SAAS,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACjC,UAAU,IAAI,GAAG,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,OAAO,uCAAuC,CAAC,CAAC;QACjF,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,qBAAqB,EAAE,CAAC;YACrC,UAAU,IAAI,GAAG,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,aAAa,CAAC,MAAM,yCAAyC,CAAC,CAAC;QAChG,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;QAE9C,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9F,OAAO,EAAE,SAAS,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;gBACzC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CACnB;oBACE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE;oBACvD,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE;oBACnD,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE;iBAC1D,EACD,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAClC,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE;oBAClB,EAAE,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE;oBACd,IAAI,EAAE,CAAC,CAAC,IAAI;iBACb,CAAC,CAAC,CACJ;gBACH,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/content-chunking/semantic-containers.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Auditoría para evaluar el uso de etiquetas HTML5 semánticas (<article>, <section>, <main>)
+ * @fileoverview Audit evaluating semantic HTML5 container elements (<main>, <article>, <section>)
  */
 import { Audit } from '../audit.js';
 import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';

package/dist/audits/content-chunking/semantic-containers.js

@@ -1,13 +1,13 @@
 /**
- * @fileoverview Auditoría para evaluar el uso de etiquetas HTML5 semánticas (<article>, <section>, <main>)
+ * @fileoverview Audit evaluating semantic HTML5 container elements (<main>, <article>, <section>)
  */
 import { Audit } from '../audit.js';
 export class SemanticContainersAudit extends Audit {
     static meta = {
         id: 'semantic-containers',
-        title: 'El contenido utiliza contenedores semánticos (<main>, <article>, <section>)',
-        failureTitle: 'El contenido depende de <div> genéricos sin estructura semántica HTML5',
-        description: 'Las etiquetas semánticas como <main>, <article> y <section> delimitan el contenido principal respecto al boilerplate (nav, sidebar, footer), facilitando el chunking limpio en parsers de IA.',
+        title: 'Content uses semantic HTML5 containers (<main>, <article>, <section>)',
+        failureTitle: 'Content relies on generic <div> wrappers without semantic HTML5 markup',
+        description: 'Semantic tags like <main>, <article>, and <section> isolate primary content from boilerplate (nav, sidebar, footer), improving chunk clean extraction for AI parsers.',
         requiredArtifacts: ['ContentChunks'],
     };
     static async audit(artifacts) {
@@ -21,12 +21,12 @@ export class SemanticContainersAudit extends Audit {
         else if (hasMain || hasArticleOrSection) {
             score = 0.7;
         }
-        const tags = chunks.semanticTagsUsed.length > 0 ? chunks.semanticTagsUsed.join(', ') : 'Ninguna (<div/body>)';
+        const tags = chunks.semanticTagsUsed.length > 0 ? chunks.semanticTagsUsed.join(', ') : 'None (<div/body>)';
         return this.generateAuditResult({
             score,
-            displayValue: `Etiquetas semánticas detectadas: ${tags}`,
+            displayValue: `Semantic tags detected: ${tags}`,
             explanation: score < 1
-                ? 'Recomendamos encapsular el contenido clave dentro de <main> y subdividirlo en <article> o <section>.'
+                ? 'We recommend wrapping primary content within <main> and partitioning with <article> or <section>.'
                 : undefined,
         });
     }

package/dist/audits/content-chunking/semantic-containers.js.map

@@ -1 +1 @@
-{"version":3,"file":"semantic-containers.js","sourceRoot":"","sources":["../../../src/audits/content-chunking/semantic-containers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACzC,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,6EAA6E;QACpF,YAAY,EAAE,wEAAwE;QACtF,WAAW,EACT,+LAA+L;QACjM,iBAAiB,EAAE,CAAC,eAAe,CAAC;KACrC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC;QAEvC,MAAM,OAAO,GAAG,MAAM,CAAC,eAAe,CAAC;QACvC,MAAM,mBAAmB,GAAG,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC,mBAAmB,CAAC;QAEpF,IAAI,KAAK,GAAG,GAAG,CAAC;QAChB,IAAI,OAAO,IAAI,mBAAmB,EAAE,CAAC;YACnC,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;aAAM,IAAI,OAAO,IAAI,mBAAmB,EAAE,CAAC;YAC1C,KAAK,GAAG,GAAG,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC;QAE9G,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,oCAAoC,IAAI,EAAE;YACxD,WAAW,EAAE,KAAK,GAAG,CAAC;gBACpB,CAAC,CAAC,sGAAsG;gBACxG,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC"}
+{"version":3,"file":"semantic-containers.js","sourceRoot":"","sources":["../../../src/audits/content-chunking/semantic-containers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACzC,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,uEAAuE;QAC9E,YAAY,EAAE,wEAAwE;QACtF,WAAW,EACT,uKAAuK;QACzK,iBAAiB,EAAE,CAAC,eAAe,CAAC;KACrC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC;QAEvC,MAAM,OAAO,GAAG,MAAM,CAAC,eAAe,CAAC;QACvC,MAAM,mBAAmB,GAAG,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC,mBAAmB,CAAC;QAEpF,IAAI,KAAK,GAAG,GAAG,CAAC;QAChB,IAAI,OAAO,IAAI,mBAAmB,EAAE,CAAC;YACnC,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;aAAM,IAAI,OAAO,IAAI,mBAAmB,EAAE,CAAC;YAC1C,KAAK,GAAG,GAAG,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;QAE3G,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,2BAA2B,IAAI,EAAE;YAC/C,WAAW,EAAE,KAAK,GAAG,CAAC;gBACpB,CAAC,CAAC,mGAAmG;gBACrG,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/direct-answer-density/concise-answer-wordcount.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Auditoría para evaluar la concisión de respuestas (ideal 30 a 60 palabras)
+ * @fileoverview Audit evaluating direct answer conciseness (ideal 30 to 60 words)
  */
 import { Audit } from '../audit.js';
 import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';

package/dist/audits/direct-answer-density/concise-answer-wordcount.js

@@ -1,13 +1,13 @@
 /**
- * @fileoverview Auditoría para evaluar la concisión de respuestas (ideal 30 a 60 palabras)
+ * @fileoverview Audit evaluating direct answer conciseness (ideal 30 to 60 words)
  */
 import { Audit } from '../audit.js';
 export class ConciseAnswerWordCountAudit extends Audit {
     static meta = {
         id: 'concise-answer-wordcount',
-        title: 'Las respuestas directas tienen una extensión concisa óptima (30 - 60 palabras)',
-        failureTitle: 'Las respuestas directas son excesivamente extensas o demasiado escuetas',
-        description: 'Los modelos de lenguaje prefieren respuestas de 30 a 60 palabras como respuesta inicial o fragmento destacado para sintetizar en sus resúmenes.',
+        title: 'Direct answers maintain concise length (30 - 60 words)',
+        failureTitle: 'Direct answers are overly verbose or too brief',
+        description: 'Language models prefer answers between 30 and 60 words as initial featured snippets for synthesis.',
         requiredArtifacts: ['DirectAnswers'],
     };
     static async audit(artifacts) {
@@ -16,7 +16,7 @@ export class ConciseAnswerWordCountAudit extends Audit {
         if (pairs.length === 0) {
             return this.generateAuditResult({
                 score: 0.5,
-                displayValue: 'Sin preguntas detectadas',
+                displayValue: 'No questions detected',
             });
         }
         const conciseCount = directAnswers.conciseAnswersCount;
@@ -24,17 +24,17 @@ export class ConciseAnswerWordCountAudit extends Audit {
         const score = ratio >= 0.6 ? 1 : Math.max(0.3, ratio);
         return this.generateAuditResult({
             score,
-            displayValue: `${conciseCount} de ${pairs.length} respuestas con longitud concisa óptima`,
+            displayValue: `${conciseCount} of ${pairs.length} answers have concise length (30-60 words)`,
             numericValue: conciseCount,
-            numericUnit: 'respuestas',
+            numericUnit: 'answers',
             details: this.makeTableDetails([
-                { key: 'question', label: 'Pregunta', valueType: 'text' },
-                { key: 'words', label: 'Conteo de Palabras', valueType: 'numeric' },
-                { key: 'status', label: 'Evaluación', valueType: 'status' },
+                { key: 'question', label: 'Question', valueType: 'text' },
+                { key: 'words', label: 'Word Count', valueType: 'numeric' },
+                { key: 'status', label: 'Evaluation', valueType: 'status' },
             ], pairs.map((p) => ({
                 question: p.question,
                 words: p.answerWordCount,
-                status: p.isConcise ? 'Conciso (30-60 palabras)' : p.answerWordCount < 20 ? 'Demasiado breve' : 'Extenso (>75 palabras)',
+                status: p.isConcise ? 'Concise (30-60 words)' : p.answerWordCount < 20 ? 'Too brief' : 'Verbose (>75 words)',
             }))),
         });
     }

package/dist/audits/direct-answer-density/concise-answer-wordcount.js.map

@@ -1 +1 @@
-{"version":3,"file":"concise-answer-wordcount.js","sourceRoot":"","sources":["../../../src/audits/direct-answer-density/concise-answer-wordcount.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC7C,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,0BAA0B;QAC9B,KAAK,EAAE,gFAAgF;QACvF,YAAY,EAAE,yEAAyE;QACvF,WAAW,EACT,iJAAiJ;QACnJ,iBAAiB,EAAE,CAAC,eAAe,CAAC;KACrC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QAC9C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;QAElC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,0BAA0B;aACzC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,YAAY,GAAG,aAAa,CAAC,mBAAmB,CAAC;QACvD,MAAM,KAAK,GAAG,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1C,MAAM,KAAK,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAEtD,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,GAAG,YAAY,OAAO,KAAK,CAAC,MAAM,yCAAyC;YACzF,YAAY,EAAE,YAAY;YAC1B,WAAW,EAAE,YAAY;YACzB,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAC5B;gBACE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE;gBACzD,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,SAAS,EAAE;gBACnE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE;aAC5D,EACD,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,KAAK,EAAE,CAAC,CAAC,eAAe;gBACxB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,wBAAwB;aACzH,CAAC,CAAC,CACJ;SACF,CAAC,CAAC;IACL,CAAC"}
+{"version":3,"file":"concise-answer-wordcount.js","sourceRoot":"","sources":["../../../src/audits/direct-answer-density/concise-answer-wordcount.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC7C,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,0BAA0B;QAC9B,KAAK,EAAE,wDAAwD;QAC/D,YAAY,EAAE,gDAAgD;QAC9D,WAAW,EACT,oGAAoG;QACtG,iBAAiB,EAAE,CAAC,eAAe,CAAC;KACrC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QAC9C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;QAElC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,uBAAuB;aACtC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,YAAY,GAAG,aAAa,CAAC,mBAAmB,CAAC;QACvD,MAAM,KAAK,GAAG,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1C,MAAM,KAAK,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAEtD,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,GAAG,YAAY,OAAO,KAAK,CAAC,MAAM,4CAA4C;YAC5F,YAAY,EAAE,YAAY;YAC1B,WAAW,EAAE,SAAS;YACtB,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAC5B;gBACE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE;gBACzD,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE;gBAC3D,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE;aAC5D,EACD,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,KAAK,EAAE,CAAC,CAAC,eAAe;gBACxB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,qBAAqB;aAC7G,CAAC,CAAC,CACJ;SACF,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/direct-answer-density/direct-definition-answering.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Auditoría para evaluar la presencia de definiciones directas a preguntas clave
+ * @fileoverview Audit evaluating presence of direct definitions answering key questions
  */
 import { Audit } from '../audit.js';
 import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';

package/dist/audits/direct-answer-density/direct-definition-answering.js

@@ -1,13 +1,13 @@
 /**
- * @fileoverview Auditoría para evaluar la presencia de definiciones directas a preguntas clave
+ * @fileoverview Audit evaluating presence of direct definitions answering key questions
  */
 import { Audit } from '../audit.js';
 export class DirectDefinitionAnsweringAudit extends Audit {
     static meta = {
         id: 'direct-definition-answering',
-        title: 'Las preguntas clave se responden de forma directa con definiciones claras en el primer párrafo',
-        failureTitle: 'Faltan respuestas directas o definiciones claras tras las preguntas clave',
-        description: 'Los Answer Engines (Perplexity, SearchGPT, Google AI Overviews) seleccionan pasajes que entregan una respuesta directa en las primeras líneas (e.g. "X es un...", "El proceso consiste en..."), en lugar de rodeos introductorios.',
+        title: 'Key questions are answered directly with clear definitions in the opening paragraph',
+        failureTitle: 'Missing direct answers or clear definitions following key questions',
+        description: 'Answer Engines (Perplexity, SearchGPT, Google AI Overviews) prioritize passages that deliver a direct answer in the opening lines (e.g. "X is a...", "The process involves..."), rather than introductory filler.',
         requiredArtifacts: ['DirectAnswers'],
     };
     static async audit(artifacts) {
@@ -16,8 +16,8 @@ export class DirectDefinitionAnsweringAudit extends Audit {
         if (pairs.length === 0) {
             return this.generateAuditResult({
                 score: 0.5,
-                displayValue: 'No se detectaron preguntas en encabezados para evaluar respuestas directas',
-                explanation: 'Incorporar encabezados con formato de pregunta (e.g. "¿Qué es X?") favorece la captura de snippets en Answer Engines.',
+                displayValue: 'No questions detected in headings to evaluate direct answers',
+                explanation: 'Structuring headings as questions (e.g. "What is X?") improves snippet extraction in Answer Engines.',
             });
         }
         const definitionPairs = pairs.filter((p) => p.hasDirectDefinition);
@@ -25,17 +25,17 @@ export class DirectDefinitionAnsweringAudit extends Audit {
         const tableItems = pairs.map((p) => ({
             question: p.question,
             words: p.answerWordCount,
-            hasDef: p.hasDirectDefinition ? 'Sí (Definición clara)' : 'No (Indirecto o descriptivo)',
+            hasDef: p.hasDirectDefinition ? 'Yes (Clear definition)' : 'No (Indirect / descriptive)',
             preview: p.answerText.length > 80 ? p.answerText.slice(0, 80) + '...' : p.answerText,
         }));
         return this.generateAuditResult({
             score: definitionPairs.length > 0 ? (score >= 0.5 ? 1 : 0.7) : 0.4,
-            displayValue: `${definitionPairs.length} de ${pairs.length} preguntas responden con definición directa inmediata`,
+            displayValue: `${definitionPairs.length} of ${pairs.length} questions provide immediate direct definitions`,
             details: this.makeTableDetails([
-                { key: 'question', label: 'Pregunta Detectada', valueType: 'text' },
-                { key: 'hasDef', label: 'Patrón de Respuesta', valueType: 'status' },
-                { key: 'words', label: 'Palabras', valueType: 'numeric' },
-                { key: 'preview', label: 'Extracto de Respuesta', valueType: 'text' },
+                { key: 'question', label: 'Detected Question', valueType: 'text' },
+                { key: 'hasDef', label: 'Answer Pattern', valueType: 'status' },
+                { key: 'words', label: 'Words', valueType: 'numeric' },
+                { key: 'preview', label: 'Answer Extract', valueType: 'text' },
             ], tableItems),
         });
     }

package/dist/audits/direct-answer-density/direct-definition-answering.js.map

@@ -1 +1 @@
-{"version":3,"file":"direct-definition-answering.js","sourceRoot":"","sources":["../../../src/audits/direct-answer-density/direct-definition-answering.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IAChD,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,6BAA6B;QACjC,KAAK,EAAE,gGAAgG;QACvG,YAAY,EAAE,2EAA2E;QACzF,WAAW,EACT,oOAAoO;QACtO,iBAAiB,EAAE,CAAC,eAAe,CAAC;KACrC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QAC9C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;QAElC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,4EAA4E;gBAC1F,WAAW,EAAE,uHAAuH;aACrI,CAAC,CAAC;QACL,CAAC;QAED,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAEnE,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,KAAK,EAAE,CAAC,CAAC,eAAe;YACxB,MAAM,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,8BAA8B;YACxF,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU;SACrF,CAAC,CAAC,CAAC;QAEJ,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK,EAAE,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG;YAClE,YAAY,EAAE,GAAG,eAAe,CAAC,MAAM,OAAO,KAAK,CAAC,MAAM,uDAAuD;YACjH,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAC5B;gBACE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,EAAE;gBACnE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,QAAQ,EAAE;gBACpE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE;gBACzD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,EAAE;aACtE,EACD,UAAU,CACX;SACF,CAAC,CAAC;IACL,CAAC"}
+{"version":3,"file":"direct-definition-answering.js","sourceRoot":"","sources":["../../../src/audits/direct-answer-density/direct-definition-answering.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IAChD,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,6BAA6B;QACjC,KAAK,EAAE,qFAAqF;QAC5F,YAAY,EAAE,qEAAqE;QACnF,WAAW,EACT,mNAAmN;QACrN,iBAAiB,EAAE,CAAC,eAAe,CAAC;KACrC,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QAC9C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;QAElC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,8DAA8D;gBAC5E,WAAW,EAAE,sGAAsG;aACpH,CAAC,CAAC;QACL,CAAC;QAED,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAEnE,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,KAAK,EAAE,CAAC,CAAC,eAAe;YACxB,MAAM,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,6BAA6B;YACxF,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU;SACrF,CAAC,CAAC,CAAC;QAEJ,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK,EAAE,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG;YAClE,YAAY,EAAE,GAAG,eAAe,CAAC,MAAM,OAAO,KAAK,CAAC,MAAM,iDAAiD;YAC3G,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAC5B;gBACE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,EAAE;gBAClE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,EAAE;gBAC/D,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE;gBACtD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE;aAC/D,EACD,UAAU,CACX;SACF,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/direct-answer-density/question-heading-alignment.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Auditoría para evaluar la formulación de preguntas orientadas a intención de búsqueda en encabezados
+ * @fileoverview Audit evaluating question-formulated search intent subheadings
  */
 import { Audit } from '../audit.js';
 import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';

package/dist/audits/direct-answer-density/question-heading-alignment.js

@@ -1,13 +1,13 @@
 /**
- * @fileoverview Auditoría para evaluar la formulación de preguntas orientadas a intención de búsqueda en encabezados
+ * @fileoverview Audit evaluating question-formulated search intent subheadings
  */
 import { Audit } from '../audit.js';
 export class QuestionHeadingAlignmentAudit extends Audit {
     static meta = {
         id: 'question-heading-alignment',
-        title: 'Se estructuran encabezados explícitos en formato de pregunta o consulta de usuario',
-        failureTitle: 'Faltan encabezados orientados a consultas de búsqueda o preguntas frecuentes',
-        description: 'Formular encabezados (H2/H3) como preguntas naturales (e.g. "¿Cómo funciona X?", "¿Por qué elegir Y?") incrementa sustancialmente el match semántico en búsquedas vectoriales y RAG.',
+        title: 'Headings are structured as explicit questions or search queries',
+        failureTitle: 'Lacks subheadings phrased as search queries or FAQs',
+        description: 'Formulating subheadings (H2/H3) as natural questions (e.g. "How does X work?", "Why choose Y?") significantly boosts semantic match in vector search and RAG.',
         requiredArtifacts: ['HeadingsHierarchy', 'DirectAnswers'],
     };
     static async audit(artifacts) {
@@ -18,16 +18,16 @@ export class QuestionHeadingAlignmentAudit extends Audit {
         if (totalSubheadings === 0) {
             return this.generateAuditResult({
                 score: 0.5,
-                displayValue: 'No se encontraron subtítulos H2 o H3',
+                displayValue: 'No H2 or H3 subheadings found',
             });
         }
         const ratio = questionHeadings / Math.max(1, totalSubheadings);
         const score = questionHeadings >= 1 ? (ratio >= 0.25 ? 1 : 0.8) : 0.4;
         return this.generateAuditResult({
             score,
-            displayValue: `${questionHeadings} de ${totalSubheadings} subtítulos estructurados como pregunta`,
+            displayValue: `${questionHeadings} of ${totalSubheadings} subheadings phrased as questions`,
             explanation: questionHeadings === 0
-                ? 'Recomendamos redactar al menos 1 o 2 subtítulos H2/H3 como preguntas directas que los usuarios suelen consultar.'
+                ? 'We recommend phrasing at least 1 or 2 H2/H3 subheadings as direct user questions.'
                 : undefined,
         });
     }

package/dist/audits/direct-answer-density/question-heading-alignment.js.map

@@ -1 +1 @@
-{"version":3,"file":"question-heading-alignment.js","sourceRoot":"","sources":["../../../src/audits/direct-answer-density/question-heading-alignment.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAC/C,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,4BAA4B;QAChC,KAAK,EAAE,oFAAoF;QAC3F,YAAY,EAAE,8EAA8E;QAC5F,WAAW,EACT,sLAAsL;QACxL,iBAAiB,EAAE,CAAC,mBAAmB,EAAE,eAAe,CAAC;KAC1D,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,QAAQ,GAAG,SAAS,CAAC,iBAAiB,CAAC,QAAQ,CAAC;QACtD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QAE9C,MAAM,gBAAgB,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;QACpD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAEvF,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,sCAAsC;aACrD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,gBAAgB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAEtE,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,GAAG,gBAAgB,OAAO,gBAAgB,yCAAyC;YACjG,WAAW,EAAE,gBAAgB,KAAK,CAAC;gBACjC,CAAC,CAAC,kHAAkH;gBACpH,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC"}
+{"version":3,"file":"question-heading-alignment.js","sourceRoot":"","sources":["../../../src/audits/direct-answer-density/question-heading-alignment.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAC/C,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,4BAA4B;QAChC,KAAK,EAAE,iEAAiE;QACxE,YAAY,EAAE,qDAAqD;QACnE,WAAW,EACT,+JAA+J;QACjK,iBAAiB,EAAE,CAAC,mBAAmB,EAAE,eAAe,CAAC;KAC1D,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,QAAQ,GAAG,SAAS,CAAC,iBAAiB,CAAC,QAAQ,CAAC;QACtD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QAE9C,MAAM,gBAAgB,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;QACpD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAEvF,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,+BAA+B;aAC9C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,gBAAgB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAEtE,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,GAAG,gBAAgB,OAAO,gBAAgB,mCAAmC;YAC3F,WAAW,EAAE,gBAAgB,KAAK,CAAC;gBACjC,CAAC,CAAC,mFAAmF;gBACrF,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Exportación y registro central de todas las auditorías disponibles
+ * @fileoverview Central registry and exports of all available AEO audits
  */
 import { Audit } from './audit.js';
 import { AiRobotsTxtAudit } from './ai-accessibility/ai-robots-txt.js';

package/dist/audits/index.js

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Exportación y registro central de todas las auditorías disponibles
+ * @fileoverview Central registry and exports of all available AEO audits
  */
 import { Audit } from './audit.js';
 // AI Accessibility

package/dist/audits/structured-data/entity-sameas-links.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Auditoría para evaluar la presencia de enlaces de desambiguación de entidades sameAs
+ * @fileoverview Audit evaluating entity disambiguation sameAs links for Knowledge Graphs
  */
 import { Audit } from '../audit.js';
 import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';

package/dist/audits/structured-data/entity-sameas-links.js

@@ -1,13 +1,13 @@
 /**
- * @fileoverview Auditoría para evaluar la presencia de enlaces de desambiguación de entidades sameAs
+ * @fileoverview Audit evaluating entity disambiguation sameAs links for Knowledge Graphs
  */
 import { Audit } from '../audit.js';
 export class EntitySameAsLinksAudit extends Audit {
     static meta = {
         id: 'entity-sameas-links',
-        title: 'Se definen propiedades sameAs para desambiguación en Grafos de Conocimiento',
-        failureTitle: 'No se encontraron enlaces sameAs en los datos estructurados',
-        description: 'La propiedad `sameAs` (con enlaces a Wikidata, Wikipedia, Crunchbase o perfiles oficiales) conecta la marca o tema con entidades verificadas en el Knowledge Graph de los LLMs.',
+        title: 'Defines sameAs properties for Knowledge Graph entity disambiguation',
+        failureTitle: 'No sameAs links found in structured data',
+        description: 'The `sameAs` property (linking to Wikidata, Wikipedia, Crunchbase, or official profiles) connects your brand and topics to verified entities in LLM Knowledge Graphs.',
         requiredArtifacts: ['JSONLD'],
     };
     static async audit(artifacts) {
@@ -16,13 +16,13 @@ export class EntitySameAsLinksAudit extends Audit {
         const hasSameAs = sameAsUrls.length > 0;
         const score = hasSameAs ? 1 : 0.4;
         const tableItems = sameAsUrls.map((url) => {
-            let authority = 'Enlace de Autoridad Externa';
+            let authority = 'External Authority Link';
             if (url.includes('wikidata.org'))
-                authority = 'Wikidata (Alta Confianza)';
+                authority = 'Wikidata (High Confidence)';
             else if (url.includes('wikipedia.org'))
-                authority = 'Wikipedia (Alta Confianza)';
+                authority = 'Wikipedia (High Confidence)';
             else if (url.includes('linkedin.com') || url.includes('twitter.com') || url.includes('x.com'))
-                authority = 'Red Social Oficial';
+                authority = 'Official Social Profile';
             return {
                 url,
                 type: authority,
@@ -30,11 +30,11 @@ export class EntitySameAsLinksAudit extends Audit {
         });
         return this.generateAuditResult({
             score,
-            displayValue: hasSameAs ? `${sameAsUrls.length} enlace(s) sameAs encontrados` : 'Sin enlaces sameAs',
+            displayValue: hasSameAs ? `${sameAsUrls.length} sameAs link(s) found` : 'No sameAs links found',
             details: hasSameAs
                 ? this.makeTableDetails([
-                    { key: 'url', label: 'URL sameAs', valueType: 'url' },
-                    { key: 'type', label: 'Tipo de Entidad', valueType: 'text' },
+                    { key: 'url', label: 'sameAs URL', valueType: 'url' },
+                    { key: 'type', label: 'Entity Type', valueType: 'text' },
                 ], tableItems)
                 : undefined,
         });

package/dist/audits/structured-data/entity-sameas-links.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-sameas-links.js","sourceRoot":"","sources":["../../../src/audits/structured-data/entity-sameas-links.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACxC,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,6EAA6E;QACpF,YAAY,EAAE,6DAA6D;QAC3E,WAAW,EACT,iLAAiL;QACnL,iBAAiB,EAAE,CAAC,QAAQ,CAAC;KAC9B,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QAChC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QAErC,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAElC,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACxC,IAAI,SAAS,GAAG,6BAA6B,CAAC;YAC9C,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,SAAS,GAAG,2BAA2B,CAAC;iBACrE,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC;gBAAE,SAAS,GAAG,4BAA4B,CAAC;iBAC5E,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS,GAAG,oBAAoB,CAAC;YAEhI,OAAO;gBACL,GAAG;gBACH,IAAI,EAAE,SAAS;aAChB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,+BAA+B,CAAC,CAAC,CAAC,oBAAoB;YACpG,OAAO,EAAE,SAAS;gBAChB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CACnB;oBACE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE;oBACrD,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,EAAE;iBAC7D,EACD,UAAU,CACX;gBACH,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC"}
+{"version":3,"file":"entity-sameas-links.js","sourceRoot":"","sources":["../../../src/audits/structured-data/entity-sameas-links.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACxC,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,qEAAqE;QAC5E,YAAY,EAAE,0CAA0C;QACxD,WAAW,EACT,uKAAuK;QACzK,iBAAiB,EAAE,CAAC,QAAQ,CAAC;KAC9B,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QAChC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QAErC,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAElC,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACxC,IAAI,SAAS,GAAG,yBAAyB,CAAC;YAC1C,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,SAAS,GAAG,4BAA4B,CAAC;iBACtE,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC;gBAAE,SAAS,GAAG,6BAA6B,CAAC;iBAC7E,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS,GAAG,yBAAyB,CAAC;YAErI,OAAO;gBACL,GAAG;gBACH,IAAI,EAAE,SAAS;aAChB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,uBAAuB,CAAC,CAAC,CAAC,uBAAuB;YAC/F,OAAO,EAAE,SAAS;gBAChB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CACnB;oBACE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE;oBACrD,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE;iBACzD,EACD,UAAU,CACX;gBACH,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/structured-data/jsonld-syntax-validity.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Auditoría para validar la sintaxis e integridad de esquemas JSON-LD
+ * @fileoverview Audit validating the syntax and integrity of JSON-LD schema blocks
  */
 import { Audit } from '../audit.js';
 import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';

package/dist/audits/structured-data/jsonld-syntax-validity.js

@@ -1,13 +1,13 @@
 /**
- * @fileoverview Auditoría para validar la sintaxis e integridad de esquemas JSON-LD
+ * @fileoverview Audit validating the syntax and integrity of JSON-LD schema blocks
  */
 import { Audit } from '../audit.js';
 export class JsonLdSyntaxValidityAudit extends Audit {
     static meta = {
         id: 'jsonld-syntax-validity',
-        title: 'Todos los bloques JSON-LD tienen sintaxis válida y sin errores',
-        failureTitle: 'Se detectaron errores de sintaxis en bloques JSON-LD',
-        description: 'Un JSON malformado impide que los parsers de Answer Engines y RAG extraigan la información estructurada de la entidad.',
+        title: 'All JSON-LD blocks have valid, error-free syntax',
+        failureTitle: 'Syntax errors detected in JSON-LD structured data blocks',
+        description: 'Malformed JSON prevents Answer Engine parsers and RAG pipelines from extracting structured entity information.',
         requiredArtifacts: ['JSONLD'],
     };
     static async audit(artifacts) {
@@ -15,8 +15,8 @@ export class JsonLdSyntaxValidityAudit extends Audit {
         if (jsonld.items.length === 0) {
             return this.generateAuditResult({
                 score: 0.5,
-                displayValue: 'No se encontraron bloques JSON-LD en la página',
-                explanation: 'Se recomienda agregar esquemas Schema.org mediante <script type="application/ld+json">.',
+                displayValue: 'No JSON-LD structured data blocks found on page',
+                explanation: 'Adding Schema.org structured data via <script type="application/ld+json"> is recommended.',
             });
         }
         const invalidItems = jsonld.items.filter((item) => !item.isValid);
@@ -24,18 +24,18 @@ export class JsonLdSyntaxValidityAudit extends Audit {
         const score = validCount / jsonld.items.length;
         const tableItems = jsonld.items.map((item, idx) => ({
             index: idx + 1,
-            type: item.type ? (Array.isArray(item.type) ? item.type.join(', ') : item.type) : 'Desconocido',
-            status: item.isValid ? 'Válido' : 'Error de Sintaxis',
-            error: item.syntaxErrors ? item.syntaxErrors.join('; ') : 'Ninguno',
+            type: item.type ? (Array.isArray(item.type) ? item.type.join(', ') : item.type) : 'Unknown',
+            status: item.isValid ? 'Valid' : 'Syntax Error',
+            error: item.syntaxErrors ? item.syntaxErrors.join('; ') : 'None',
         }));
         return this.generateAuditResult({
             score,
-            displayValue: `${validCount} de ${jsonld.items.length} bloques JSON-LD válidos`,
+            displayValue: `${validCount} of ${jsonld.items.length} JSON-LD blocks are valid`,
             details: this.makeTableDetails([
                 { key: 'index', label: '#', valueType: 'numeric' },
                 { key: 'type', label: '@type', valueType: 'code' },
-                { key: 'status', label: 'Estado', valueType: 'status' },
-                { key: 'error', label: 'Detalle', valueType: 'text' },
+                { key: 'status', label: 'Status', valueType: 'status' },
+                { key: 'error', label: 'Detail', valueType: 'text' },
             ], tableItems),
         });
     }