@drowlink/aeo-linter-core 0.1.0

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

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Auditoría para validar la sintaxis e integridad de esquemas JSON-LD
+ */
+import { Audit } from '../audit.js';
+import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';
+export declare class JsonLdSyntaxValidityAudit extends Audit {
+    static meta: AuditMeta;
+    static audit(artifacts: Artifacts): Promise<AuditResult>;
+}
+//# sourceMappingURL=jsonld-syntax-validity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonld-syntax-validity.d.ts","sourceRoot":"","sources":["../../../src/audits/structured-data/jsonld-syntax-validity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE9E,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,OAAuB,IAAI,EAAE,SAAS,CAOpC;WAE2B,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAoC/E"}

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

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Auditoría para validar la sintaxis e integridad de esquemas JSON-LD
+ */
+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.',
+        requiredArtifacts: ['JSONLD'],
+    };
+    static async audit(artifacts) {
+        const jsonld = artifacts.JSONLD;
+        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">.',
+            });
+        }
+        const invalidItems = jsonld.items.filter((item) => !item.isValid);
+        const validCount = jsonld.items.length - invalidItems.length;
+        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',
+        }));
+        return this.generateAuditResult({
+            score,
+            displayValue: `${validCount} de ${jsonld.items.length} bloques JSON-LD válidos`,
+            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' },
+            ], tableItems),
+        });
+    }
+}
+//# sourceMappingURL=jsonld-syntax-validity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonld-syntax-validity.js","sourceRoot":"","sources":["../../../src/audits/structured-data/jsonld-syntax-validity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAC3C,MAAM,CAAU,IAAI,GAAc;QACvC,EAAE,EAAE,wBAAwB;QAC5B,KAAK,EAAE,gEAAgE;QACvE,YAAY,EAAE,sDAAsD;QACpE,WAAW,EACT,wHAAwH;QAC1H,iBAAiB,EAAE,CAAC,QAAQ,CAAC;KAC9B,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QAEhC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,gDAAgD;gBAC9D,WAAW,EAAE,yFAAyF;aACvG,CAAC,CAAC;QACL,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;QAC7D,MAAM,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QAE/C,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAClD,KAAK,EAAE,GAAG,GAAG,CAAC;YACd,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa;YAC/F,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAmB;YACrD,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SACpE,CAAC,CAAC,CAAC;QAEJ,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,GAAG,UAAU,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,0BAA0B;YAC/E,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAC5B;gBACE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE;gBAClD,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE;gBAClD,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE;gBACvD,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE;aACtD,EACD,UAAU,CACX;SACF,CAAC,CAAC;IACL,CAAC"}

package/dist/audits/structured-data/rag-schema-presence.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Auditoría para evaluar la presencia de esquemas de alto valor para RAG
+ */
+import { Audit } from '../audit.js';
+import type { Artifacts, AuditMeta, AuditResult } from '../../types/index.js';
+export declare class RagSchemaPresenceAudit extends Audit {
+    static meta: AuditMeta;
+    static audit(artifacts: Artifacts): Promise<AuditResult>;
+}
+//# sourceMappingURL=rag-schema-presence.d.ts.map

package/dist/audits/structured-data/rag-schema-presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-schema-presence.d.ts","sourceRoot":"","sources":["../../../src/audits/structured-data/rag-schema-presence.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE9E,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,OAAuB,IAAI,EAAE,SAAS,CAOpC;WAE2B,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAuC/E"}

package/dist/audits/structured-data/rag-schema-presence.js

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Auditoría para evaluar la presencia de esquemas de alto valor para RAG
+ */
+import { Audit } from '../audit.js';
+export class RagSchemaPresenceAudit extends Audit {
+    static meta = {
+        id: 'rag-schema-presence',
+        title: 'La página implementa esquemas JSON-LD optimizados para RAG (FAQ, HowTo, Article)',
+        failureTitle: 'Faltan esquemas estructurados de alto valor para RAG',
+        description: 'Los esquemas como FAQPage, HowTo, QAPage y Article permiten a los Answer Engines extraer pares pregunta-respuesta y contenido estructurado directamente en sus respuestas sintetizadas.',
+        requiredArtifacts: ['JSONLD'],
+    };
+    static async audit(artifacts) {
+        const jsonld = artifacts.JSONLD;
+        const ragSchemas = [
+            { name: 'FAQPage', present: jsonld.hasFAQPage, value: 'Pares Q&A directos' },
+            { name: 'HowTo / QAPage', present: jsonld.hasHowTo || jsonld.hasQAPage, value: 'Instrucciones paso a paso' },
+            { name: 'Article / TechArticle', present: jsonld.hasArticle, value: 'Metadatos de autoría y contenido' },
+            { name: 'Organization / Product', present: jsonld.hasOrganization || jsonld.hasProduct, value: 'Entidad de negocio / producto' },
+        ];
+        const presentCount = ragSchemas.filter((s) => s.present).length;
+        let score = 0;
+        if (presentCount >= 2) {
+            score = 1;
+        }
+        else if (presentCount === 1) {
+            score = 0.7;
+        }
+        else {
+            score = 0.2;
+        }
+        const tableItems = ragSchemas.map((s) => ({
+            schema: s.name,
+            status: s.present ? 'Implementado' : 'No encontrado',
+            benefit: s.value,
+        }));
+        return this.generateAuditResult({
+            score,
+            displayValue: `${presentCount} tipo(s) de esquema RAG detectados`,
+            details: this.makeTableDetails([
+                { key: 'schema', label: 'Tipo de Esquema', valueType: 'code' },
+                { key: 'status', label: 'Estado', valueType: 'status' },
+                { key: 'benefit', label: 'Impacto en RAG / AEO', valueType: 'text' },
+            ], tableItems),
+        });
+    }
+}
+//# sourceMappingURL=rag-schema-presence.js.map

package/dist/audits/structured-data/rag-schema-presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-schema-presence.js","sourceRoot":"","sources":["../../../src/audits/structured-data/rag-schema-presence.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,kFAAkF;QACzF,YAAY,EAAE,sDAAsD;QACpE,WAAW,EACT,yLAAyL;QAC3L,iBAAiB,EAAE,CAAC,QAAQ,CAAC;KAC9B,CAAC;IAEK,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,SAAoB;QACrD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QAEhC,MAAM,UAAU,GAAG;YACjB,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,oBAAoB,EAAE;YAC5E,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,2BAA2B,EAAE;YAC5G,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,kCAAkC,EAAE;YACxG,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,+BAA+B,EAAE;SACjI,CAAC;QAEF,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAChE,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YACtB,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;aAAM,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;YAC9B,KAAK,GAAG,GAAG,CAAC;QACd,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,GAAG,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxC,MAAM,EAAE,CAAC,CAAC,IAAI;YACd,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,eAAe;YACpD,OAAO,EAAE,CAAC,CAAC,KAAK;SACjB,CAAC,CAAC,CAAC;QAEJ,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,KAAK;YACL,YAAY,EAAE,GAAG,YAAY,oCAAoC;YACjE,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAC5B;gBACE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,EAAE;gBAC9D,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE;gBACvD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,EAAE;aACrE,EACD,UAAU,CACX;SACF,CAAC,CAAC;IACL,CAAC"}

package/dist/config/default-config.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Configuración por defecto de AEO Linter con ponderaciones de categorías y auditorías.
+ * Estructurado fielmente al modelo de configuración de Google Lighthouse (categories + auditRefs con weights).
+ */
+import type { LinterConfig } from '../types/config.js';
+export declare const defaultConfig: LinterConfig;
+//# sourceMappingURL=default-config.d.ts.map

package/dist/config/default-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-config.d.ts","sourceRoot":"","sources":["../../src/config/default-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,eAAO,MAAM,aAAa,EAAE,YAqE3B,CAAC"}

package/dist/config/default-config.js

@@ -0,0 +1,71 @@
+/**
+ * @fileoverview Configuración por defecto de AEO Linter con ponderaciones de categorías y auditorías.
+ * Estructurado fielmente al modelo de configuración de Google Lighthouse (categories + auditRefs con weights).
+ */
+export const defaultConfig = {
+    settings: {
+        locale: 'en-US',
+        maxWaitForFulfill: 15000,
+    },
+    categories: {
+        'ai-accessibility': {
+            title: 'AI Accessibility & Crawling',
+            description: 'Verifica que los agentes y rastreadores de IA (GPTBot, PerplexityBot, ClaudeBot, Google-Extended, etc.) tengan acceso sin restricciones innecesarias vía robots.txt y cabeceras HTTP.',
+            weight: 25,
+            auditRefs: [
+                { id: 'ai-robots-txt', weight: 10, group: 'crawling' },
+                { id: 'ai-x-robots-tag', weight: 8, group: 'crawling' },
+                { id: 'ai-bot-sitemap', weight: 2, group: 'crawling' },
+            ],
+        },
+        'structured-data': {
+            title: 'Structured Data & RAG Schemas',
+            description: 'Audita esquemas JSON-LD optimizados para RAG (FAQPage, HowTo, Article, QAPage, sameAs) que enriquecen los grafos de conocimiento de los modelos de lenguaje.',
+            weight: 25,
+            auditRefs: [
+                { id: 'jsonld-syntax-validity', weight: 8, group: 'schema' },
+                { id: 'rag-schema-presence', weight: 8, group: 'schema' },
+                { id: 'entity-sameas-links', weight: 4, group: 'knowledge-graph' },
+            ],
+        },
+        'content-chunking': {
+            title: 'Content Chunking & Semantic Structure',
+            description: 'Evalúa la jerarquía H1-H3, la segmentación semántica (<article>, <section>, <main>) y la densidad de tokens por bloque para facilitar la tokenización y embeddings en RAG.',
+            weight: 25,
+            auditRefs: [
+                { id: 'heading-hierarchy', weight: 8, group: 'structure' },
+                { id: 'semantic-containers', weight: 6, group: 'structure' },
+                { id: 'chunk-token-density', weight: 6, group: 'embeddings' },
+            ],
+        },
+        'direct-answer-density': {
+            title: 'Direct Answer Density',
+            description: 'Detecta la concisión y presencia de respuestas directas e inmediatas a preguntas clave, optimizando la extracción para Answer Engines (Perplexity, SearchGPT, AI Overviews).',
+            weight: 25,
+            auditRefs: [
+                { id: 'direct-definition-answering', weight: 10, group: 'answers' },
+                { id: 'concise-answer-wordcount', weight: 6, group: 'answers' },
+                { id: 'question-heading-alignment', weight: 4, group: 'answers' },
+            ],
+        },
+    },
+    audits: [
+        // AI Accessibility
+        'ai-robots-txt',
+        'ai-x-robots-tag',
+        'ai-bot-sitemap',
+        // Structured Data
+        'jsonld-syntax-validity',
+        'rag-schema-presence',
+        'entity-sameas-links',
+        // Content Chunking
+        'heading-hierarchy',
+        'semantic-containers',
+        'chunk-token-density',
+        // Direct Answer Density
+        'direct-definition-answering',
+        'concise-answer-wordcount',
+        'question-heading-alignment',
+    ],
+};
+//# sourceMappingURL=default-config.js.map

package/dist/config/default-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-config.js","sourceRoot":"","sources":["../../src/config/default-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,aAAa,GAAiB;IACzC,QAAQ,EAAE;QACR,MAAM,EAAE,OAAO;QACf,iBAAiB,EAAE,KAAK;KACzB;IACD,UAAU,EAAE;QACV,kBAAkB,EAAE;YAClB,KAAK,EAAE,6BAA6B;YACpC,WAAW,EACT,uLAAuL;YACzL,MAAM,EAAE,EAAE;YACV,SAAS,EAAE;gBACT,EAAE,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;gBACtD,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE;gBACvD,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE;aACvD;SACF;QACD,iBAAiB,EAAE;YACjB,KAAK,EAAE,+BAA+B;YACtC,WAAW,EACT,8JAA8J;YAChK,MAAM,EAAE,EAAE;YACV,SAAS,EAAE;gBACT,EAAE,EAAE,EAAE,wBAAwB,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE;gBAC5D,EAAE,EAAE,EAAE,qBAAqB,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACzD,EAAE,EAAE,EAAE,qBAAqB,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE;aACnE;SACF;QACD,kBAAkB,EAAE;YAClB,KAAK,EAAE,uCAAuC;YAC9C,WAAW,EACT,4KAA4K;YAC9K,MAAM,EAAE,EAAE;YACV,SAAS,EAAE;gBACT,EAAE,EAAE,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE;gBAC1D,EAAE,EAAE,EAAE,qBAAqB,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE;gBAC5D,EAAE,EAAE,EAAE,qBAAqB,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE;aAC9D;SACF;QACD,uBAAuB,EAAE;YACvB,KAAK,EAAE,uBAAuB;YAC9B,WAAW,EACT,8KAA8K;YAChL,MAAM,EAAE,EAAE;YACV,SAAS,EAAE;gBACT,EAAE,EAAE,EAAE,6BAA6B,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;gBACnE,EAAE,EAAE,EAAE,0BAA0B,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE;gBAC/D,EAAE,EAAE,EAAE,4BAA4B,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE;aAClE;SACF;KACF;IACD,MAAM,EAAE;QACN,mBAAmB;QACnB,eAAe;QACf,iBAAiB;QACjB,gBAAgB;QAChB,kBAAkB;QAClB,wBAAwB;QACxB,qBAAqB;QACrB,qBAAqB;QACrB,mBAAmB;QACnB,mBAAmB;QACnB,qBAAqB;QACrB,qBAAqB;QACrB,wBAAwB;QACxB,6BAA6B;QAC7B,0BAA0B;QAC1B,4BAA4B;KAC7B;CACF,CAAC"}

package/dist/gather/driver/cheerio-driver.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Implementación de Driver basada en Fetch + Cheerio para entornos Node.js / CLI.
+ */
+import * as cheerio from 'cheerio';
+import type { Driver } from '../../types/index.js';
+export declare class CheerioDriver implements Driver {
+    private url;
+    private html;
+    private headers;
+    private $;
+    constructor(options: {
+        url: string;
+        html: string;
+        headers?: Record<string, string | string[]>;
+    });
+    static createFromUrl(targetUrl: string, fetchFn?: typeof fetch, options?: {
+        userAgent?: string;
+        headers?: Record<string, string>;
+    }): Promise<CheerioDriver>;
+    evaluate<T>(script: string | (() => T)): Promise<T>;
+    fetch(url: string, init?: RequestInit): Promise<Response>;
+    getUrl(): Promise<string>;
+    getHtml(): Promise<string>;
+    getHttpHeaders(): Promise<Record<string, string | string[]>>;
+    get$(): cheerio.CheerioAPI;
+}
+//# sourceMappingURL=cheerio-driver.d.ts.map

package/dist/gather/driver/cheerio-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cheerio-driver.d.ts","sourceRoot":"","sources":["../../../src/gather/driver/cheerio-driver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,CAAC,CAAqB;gBAElB,OAAO,EAAE;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;KAC7C;WAOmB,aAAa,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAO,KAAa,EAC7B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GACjE,OAAO,CAAC,aAAa,CAAC;IAiCZ,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAOnD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIzD,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAIzB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAI1B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAIlE,IAAI,IAAI,OAAO,CAAC,UAAU;CAGlC"}

package/dist/gather/driver/cheerio-driver.js

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview Implementación de Driver basada en Fetch + Cheerio para entornos Node.js / CLI.
+ */
+import * as cheerio from 'cheerio';
+export class CheerioDriver {
+    url;
+    html;
+    headers;
+    $;
+    constructor(options) {
+        this.url = options.url;
+        this.html = options.html;
+        this.headers = options.headers || {};
+        this.$ = cheerio.load(options.html);
+    }
+    static async createFromUrl(targetUrl, fetchFn = fetch, options) {
+        const defaultHeaders = {
+            'User-Agent': options?.userAgent ||
+                'Mozilla/5.0 (compatible; AEOLinter/1.0; +https://github.com/aeo-linter)',
+            Accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+            ...options?.headers,
+        };
+        const res = await fetchFn(targetUrl, {
+            headers: defaultHeaders,
+            redirect: 'follow',
+        });
+        if (!res.ok) {
+            throw new Error(`Error HTTP ${res.status} al cargar ${targetUrl}: ${res.statusText}`);
+        }
+        const html = await res.text();
+        const finalUrl = res.url || targetUrl;
+        const headersRecord = {};
+        res.headers.forEach((val, key) => {
+            headersRecord[key.toLowerCase()] = val;
+        });
+        return new CheerioDriver({
+            url: finalUrl,
+            html,
+            headers: headersRecord,
+        });
+    }
+    async evaluate(script) {
+        if (typeof script === 'function') {
+            return script();
+        }
+        throw new Error('evaluate() con string no soportado en CheerioDriver');
+    }
+    async fetch(url, init) {
+        return fetch(url, init);
+    }
+    async getUrl() {
+        return this.url;
+    }
+    async getHtml() {
+        return this.html;
+    }
+    async getHttpHeaders() {
+        return this.headers;
+    }
+    get$() {
+        return this.$;
+    }
+}
+//# sourceMappingURL=cheerio-driver.js.map

package/dist/gather/driver/cheerio-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cheerio-driver.js","sourceRoot":"","sources":["../../../src/gather/driver/cheerio-driver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAGnC,MAAM,OAAO,aAAa;IAChB,GAAG,CAAS;IACZ,IAAI,CAAS;IACb,OAAO,CAAoC;IAC3C,CAAC,CAAqB;IAE9B,YAAY,OAIX;QACC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,aAAa,CAC/B,SAAiB,EACjB,UAAwB,KAAK,EAC7B,OAAkE;QAElE,MAAM,cAAc,GAAG;YACrB,YAAY,EACV,OAAO,EAAE,SAAS;gBAClB,yEAAyE;YAC3E,MAAM,EAAE,iEAAiE;YACzE,GAAG,OAAO,EAAE,OAAO;SACpB,CAAC;QAEF,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE;YACnC,OAAO,EAAE,cAAc;YACvB,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,cAAc,GAAG,CAAC,MAAM,cAAc,SAAS,KAAK,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,IAAI,SAAS,CAAC;QAEtC,MAAM,aAAa,GAAsC,EAAE,CAAC;QAC5D,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YAC/B,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,GAAG,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,aAAa,CAAC;YACvB,GAAG,EAAE,QAAQ;YACb,IAAI;YACJ,OAAO,EAAE,aAAa;SACvB,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAI,MAA0B;QACjD,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO,MAAM,EAAE,CAAC;QAClB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,IAAkB;QAChD,OAAO,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,MAAM;QACjB,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAEM,KAAK,CAAC,cAAc;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAEM,IAAI;QACT,OAAO,IAAI,CAAC,CAAC,CAAC;IAChB,CAAC;CACF"}

package/dist/gather/gatherer.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Clase base abstracta para Gatherers en el pipeline de AEO Linter.
+ */
+import type { Artifacts, IGatherer, GathererContext } from '../types/index.js';
+export declare abstract class Gatherer<K extends keyof Artifacts = keyof Artifacts> implements IGatherer<K> {
+    abstract readonly name: K;
+    /**
+     * Extrae el artefacto crudo usando el driver/CDP del contexto
+     */
+    abstract getArtifact(context: GathererContext): Promise<Artifacts[K]>;
+}
+//# sourceMappingURL=gatherer.d.ts.map

package/dist/gather/gatherer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatherer.d.ts","sourceRoot":"","sources":["../../src/gather/gatherer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE/E,8BAAsB,QAAQ,CAAC,CAAC,SAAS,MAAM,SAAS,GAAG,MAAM,SAAS,CAAE,YAAW,SAAS,CAAC,CAAC,CAAC;IACjG,kBAAyB,IAAI,EAAE,CAAC,CAAC;IAEjC;;OAEG;aACa,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;CAC7E"}

package/dist/gather/gatherer.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Clase base abstracta para Gatherers en el pipeline de AEO Linter.
+ */
+export class Gatherer {
+}
+//# sourceMappingURL=gatherer.js.map

package/dist/gather/gatherer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatherer.js","sourceRoot":"","sources":["../../src/gather/gatherer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,OAAgB,QAAQ;CAO7B"}

package/dist/gather/gatherers/content-chunks-gatherer.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview ContentChunksGatherer para segmentación semántica de contenido y estimación de tokens para RAG.
+ */
+import { Gatherer } from '../gatherer.js';
+import type { ContentChunksArtifact, GathererContext } from '../../types/index.js';
+export declare class ContentChunksGatherer extends Gatherer<'ContentChunks'> {
+    readonly name: "ContentChunks";
+    getArtifact(context: GathererContext): Promise<ContentChunksArtifact>;
+}
+//# sourceMappingURL=content-chunks-gatherer.d.ts.map

package/dist/gather/gatherers/content-chunks-gatherer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-chunks-gatherer.d.ts","sourceRoot":"","sources":["../../../src/gather/gatherers/content-chunks-gatherer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,qBAAqB,EAAgB,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEjG,qBAAa,qBAAsB,SAAQ,QAAQ,CAAC,eAAe,CAAC;IAClE,SAAyB,IAAI,EAAG,eAAe,CAAU;IAEnC,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAmG5F"}

package/dist/gather/gatherers/content-chunks-gatherer.js

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview ContentChunksGatherer para segmentación semántica de contenido y estimación de tokens para RAG.
+ */
+import * as cheerio from 'cheerio';
+import { Gatherer } from '../gatherer.js';
+export class ContentChunksGatherer extends Gatherer {
+    name = 'ContentChunks';
+    async getArtifact(context) {
+        const html = await context.driver.getHtml();
+        const $ = cheerio.load(html);
+        // Remover scripts, styles, navs redundantes para el análisis de contenido textual
+        $('script, style, noscript, svg, nav, footer, header').remove();
+        const semanticTagsUsed = [];
+        if ($('main').length > 0)
+            semanticTagsUsed.push('main');
+        if ($('article').length > 0)
+            semanticTagsUsed.push('article');
+        if ($('section').length > 0)
+            semanticTagsUsed.push('section');
+        const chunks = [];
+        let chunkCounter = 0;
+        // Buscar secciones o elementos principales
+        const contentContainers = $('article, section, main');
+        const targetElements = contentContainers.length > 0 ? contentContainers : $('body');
+        targetElements.each((_, container) => {
+            const containerTag = container.tagName.toLowerCase();
+            const isSemantic = ['article', 'section', 'main'].includes(containerTag);
+            // Dividir el contenedor por encabezados internos o párrafos
+            const subNodes = $(container).children('h1, h2, h3, h4, p, ul, ol, table, pre');
+            let currentHeading = undefined;
+            let bufferText = '';
+            let hasList = false;
+            let hasTable = false;
+            let hasCode = false;
+            const flushChunk = () => {
+                const text = bufferText.trim().replace(/\s+/g, ' ');
+                if (!text)
+                    return;
+                const words = text.split(/\s+/).filter(Boolean);
+                const wordCount = words.length;
+                if (wordCount < 10)
+                    return; // Ignorar fragmentos irrelevantes
+                const estimatedTokens = Math.round(wordCount * 1.3);
+                chunks.push({
+                    id: `chunk-${++chunkCounter}`,
+                    headingText: currentHeading?.text,
+                    headingLevel: currentHeading?.level,
+                    text,
+                    wordCount,
+                    estimatedTokens,
+                    parentTag: containerTag,
+                    hasList,
+                    hasTable,
+                    hasCode,
+                    isSemanticContainer: isSemantic,
+                });
+                bufferText = '';
+                hasList = false;
+                hasTable = false;
+                hasCode = false;
+            };
+            subNodes.each((_, el) => {
+                const tag = el.tagName.toLowerCase();
+                if (tag.startsWith('h')) {
+                    flushChunk();
+                    const level = parseInt(tag.charAt(1), 10);
+                    currentHeading = { text: $(el).text().trim(), level };
+                }
+                else {
+                    if (['ul', 'ol'].includes(tag))
+                        hasList = true;
+                    if (tag === 'table')
+                        hasTable = true;
+                    if (tag === 'pre' || $(el).find('code').length > 0)
+                        hasCode = true;
+                    bufferText += ' ' + $(el).text().trim();
+                    // Si el chunk supera ~350 palabras, creamos un sub-chunk para embeddings
+                    if (bufferText.split(/\s+/).length > 350) {
+                        flushChunk();
+                    }
+                }
+            });
+            flushChunk();
+        });
+        const totalWordCount = chunks.reduce((sum, c) => sum + c.wordCount, 0);
+        const totalEstimatedTokens = chunks.reduce((sum, c) => sum + c.estimatedTokens, 0);
+        const averageChunkTokenCount = chunks.length > 0 ? Math.round(totalEstimatedTokens / chunks.length) : 0;
+        return {
+            chunks,
+            totalWordCount,
+            totalEstimatedTokens,
+            averageChunkTokenCount,
+            semanticTagsUsed,
+            hasSemanticMain: $('main').length > 0,
+            hasSemanticArticle: $('article').length > 0,
+            hasSemanticSections: $('section').length > 0,
+        };
+    }
+}
+//# sourceMappingURL=content-chunks-gatherer.js.map

package/dist/gather/gatherers/content-chunks-gatherer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-chunks-gatherer.js","sourceRoot":"","sources":["../../../src/gather/gatherers/content-chunks-gatherer.ts"],"names":[],"mappings":"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"}

package/dist/gather/gatherers/direct-answers-gatherer.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview DirectAnswersGatherer para detectar patrones de preguntas clave y respuestas concisas inmediatas.
+ */
+import { Gatherer } from '../gatherer.js';
+import type { DirectAnswersArtifact, GathererContext } from '../../types/index.js';
+export declare class DirectAnswersGatherer extends Gatherer<'DirectAnswers'> {
+    readonly name: "DirectAnswers";
+    getArtifact(context: GathererContext): Promise<DirectAnswersArtifact>;
+}
+//# sourceMappingURL=direct-answers-gatherer.d.ts.map

package/dist/gather/gatherers/direct-answers-gatherer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-answers-gatherer.d.ts","sourceRoot":"","sources":["../../../src/gather/gatherers/direct-answers-gatherer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,qBAAqB,EAAoB,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAErG,qBAAa,qBAAsB,SAAQ,QAAQ,CAAC,eAAe,CAAC;IAClE,SAAyB,IAAI,EAAG,eAAe,CAAU;IAEnC,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAyD5F"}

package/dist/gather/gatherers/direct-answers-gatherer.js

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview DirectAnswersGatherer para detectar patrones de preguntas clave y respuestas concisas inmediatas.
+ */
+import * as cheerio from 'cheerio';
+import { Gatherer } from '../gatherer.js';
+export class DirectAnswersGatherer extends Gatherer {
+    name = 'DirectAnswers';
+    async getArtifact(context) {
+        const html = await context.driver.getHtml();
+        const $ = cheerio.load(html);
+        const pairs = [];
+        let definitionPatternsFound = 0;
+        const questionWordsRegex = /^(¿|\?|qué|que|cómo|como|por qué|porque|cuál|cual|cuándo|cuando|dónde|donde|quién|quien|what|how|why|when|where|who|which|is|are|can|do|does)\b/i;
+        const definitionRegex = /\b(es un|es una|es el|es la|son los|son las|se refiere a|se define como|consiste en|hace referencia a|is a|is an|is the|are the|refers to|is defined as|means)\b/i;
+        $('h1, h2, h3, h4').each((_, el) => {
+            const headingText = $(el).text().trim();
+            const isQuestion = headingText.includes('?') || questionWordsRegex.test(headingText);
+            if (isQuestion) {
+                // Encontrar el siguiente párrafo o lista
+                const nextElem = $(el).nextAll('p, ul, ol').first();
+                if (nextElem.length > 0) {
+                    const answerText = nextElem.text().trim().replace(/\s+/g, ' ');
+                    const words = answerText.split(/\s+/).filter(Boolean);
+                    const answerWordCount = words.length;
+                    // Conciso para Answer Engines: típicamente entre 20 y 75 palabras (ideal 30-60)
+                    const isConcise = answerWordCount >= 20 && answerWordCount <= 75;
+                    const hasDirectDefinition = definitionRegex.test(answerText.slice(0, 150));
+                    if (hasDirectDefinition) {
+                        definitionPatternsFound++;
+                    }
+                    let confidence = 0.5;
+                    if (isConcise)
+                        confidence += 0.3;
+                    if (hasDirectDefinition)
+                        confidence += 0.2;
+                    pairs.push({
+                        question: headingText,
+                        questionSource: 'heading',
+                        answerText,
+                        answerWordCount,
+                        isConcise,
+                        hasDirectDefinition,
+                        confidenceScore: Math.min(confidence, 1.0),
+                    });
+                }
+            }
+        });
+        const conciseAnswersCount = pairs.filter((p) => p.isConcise).length;
+        const directAnswerRatio = pairs.length > 0 ? conciseAnswersCount / pairs.length : 0;
+        return {
+            pairs,
+            directAnswerRatio,
+            conciseAnswersCount,
+            definitionPatternsFound,
+        };
+    }
+}
+//# sourceMappingURL=direct-answers-gatherer.js.map

package/dist/gather/gatherers/direct-answers-gatherer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-answers-gatherer.js","sourceRoot":"","sources":["../../../src/gather/gatherers/direct-answers-gatherer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,MAAM,OAAO,qBAAsB,SAAQ,QAAyB;IACzC,IAAI,GAAG,eAAwB,CAAC;IAEzC,KAAK,CAAC,WAAW,CAAC,OAAwB;QACxD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE7B,MAAM,KAAK,GAAuB,EAAE,CAAC;QACrC,IAAI,uBAAuB,GAAG,CAAC,CAAC;QAEhC,MAAM,kBAAkB,GAAG,kJAAkJ,CAAC;QAC9K,MAAM,eAAe,GAAG,mKAAmK,CAAC;QAE5L,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;YACjC,MAAM,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAErF,IAAI,UAAU,EAAE,CAAC;gBACf,yCAAyC;gBACzC,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC;gBACpD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;oBAC/D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;oBACtD,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC;oBAErC,gFAAgF;oBAChF,MAAM,SAAS,GAAG,eAAe,IAAI,EAAE,IAAI,eAAe,IAAI,EAAE,CAAC;oBACjE,MAAM,mBAAmB,GAAG,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;oBAE3E,IAAI,mBAAmB,EAAE,CAAC;wBACxB,uBAAuB,EAAE,CAAC;oBAC5B,CAAC;oBAED,IAAI,UAAU,GAAG,GAAG,CAAC;oBACrB,IAAI,SAAS;wBAAE,UAAU,IAAI,GAAG,CAAC;oBACjC,IAAI,mBAAmB;wBAAE,UAAU,IAAI,GAAG,CAAC;oBAE3C,KAAK,CAAC,IAAI,CAAC;wBACT,QAAQ,EAAE,WAAW;wBACrB,cAAc,EAAE,SAAS;wBACzB,UAAU;wBACV,eAAe;wBACf,SAAS;wBACT,mBAAmB;wBACnB,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC;qBAC3C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,mBAAmB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;QACpE,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAEpF,OAAO;YACL,KAAK;YACL,iBAAiB;YACjB,mBAAmB;YACnB,uBAAuB;SACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/gather/gatherers/headings-hierarchy-gatherer.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview HeadingsHierarchyGatherer para evaluar la jerarquía y secuencia H1-H6.
+ */
+import { Gatherer } from '../gatherer.js';
+import type { HeadingsHierarchyArtifact, GathererContext } from '../../types/index.js';
+export declare class HeadingsHierarchyGatherer extends Gatherer<'HeadingsHierarchy'> {
+    readonly name: "HeadingsHierarchy";
+    getArtifact(context: GathererContext): Promise<HeadingsHierarchyArtifact>;
+}
+//# sourceMappingURL=headings-hierarchy-gatherer.d.ts.map

package/dist/gather/gatherers/headings-hierarchy-gatherer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headings-hierarchy-gatherer.d.ts","sourceRoot":"","sources":["../../../src/gather/gatherers/headings-hierarchy-gatherer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,yBAAyB,EAAe,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEpG,qBAAa,yBAA0B,SAAQ,QAAQ,CAAC,mBAAmB,CAAC;IAC1E,SAAyB,IAAI,EAAG,mBAAmB,CAAU;IAEvC,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAwDhG"}