@drowlink/aeo-linter-core 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (95) hide show
  1. package/dist/__tests__/audit-contract.test.js +12 -13
  2. package/dist/__tests__/audit-contract.test.js.map +1 -1
  3. package/dist/__tests__/gatherers.test.js +11 -12
  4. package/dist/__tests__/gatherers.test.js.map +1 -1
  5. package/dist/__tests__/runner.test.js +12 -12
  6. package/dist/__tests__/runner.test.js.map +1 -1
  7. package/dist/audits/ai-accessibility/ai-bot-sitemap.d.ts +1 -1
  8. package/dist/audits/ai-accessibility/ai-bot-sitemap.js +6 -6
  9. package/dist/audits/ai-accessibility/ai-bot-sitemap.js.map +1 -1
  10. package/dist/audits/ai-accessibility/ai-robots-txt.d.ts +1 -1
  11. package/dist/audits/ai-accessibility/ai-robots-txt.d.ts.map +1 -1
  12. package/dist/audits/ai-accessibility/ai-robots-txt.js +11 -12
  13. package/dist/audits/ai-accessibility/ai-robots-txt.js.map +1 -1
  14. package/dist/audits/ai-accessibility/ai-x-robots-tag.d.ts +1 -1
  15. package/dist/audits/ai-accessibility/ai-x-robots-tag.js +8 -8
  16. package/dist/audits/ai-accessibility/ai-x-robots-tag.js.map +1 -1
  17. package/dist/audits/audit.d.ts +13 -13
  18. package/dist/audits/audit.js +14 -14
  19. package/dist/audits/audit.js.map +1 -1
  20. package/dist/audits/content-chunking/chunk-token-density.d.ts +1 -1
  21. package/dist/audits/content-chunking/chunk-token-density.js +12 -12
  22. package/dist/audits/content-chunking/chunk-token-density.js.map +1 -1
  23. package/dist/audits/content-chunking/heading-hierarchy.d.ts +1 -1
  24. package/dist/audits/content-chunking/heading-hierarchy.js +13 -13
  25. package/dist/audits/content-chunking/heading-hierarchy.js.map +1 -1
  26. package/dist/audits/content-chunking/semantic-containers.d.ts +1 -1
  27. package/dist/audits/content-chunking/semantic-containers.js +7 -7
  28. package/dist/audits/content-chunking/semantic-containers.js.map +1 -1
  29. package/dist/audits/direct-answer-density/concise-answer-wordcount.d.ts +1 -1
  30. package/dist/audits/direct-answer-density/concise-answer-wordcount.js +11 -11
  31. package/dist/audits/direct-answer-density/concise-answer-wordcount.js.map +1 -1
  32. package/dist/audits/direct-answer-density/direct-definition-answering.d.ts +1 -1
  33. package/dist/audits/direct-answer-density/direct-definition-answering.js +12 -12
  34. package/dist/audits/direct-answer-density/direct-definition-answering.js.map +1 -1
  35. package/dist/audits/direct-answer-density/question-heading-alignment.d.ts +1 -1
  36. package/dist/audits/direct-answer-density/question-heading-alignment.js +7 -7
  37. package/dist/audits/direct-answer-density/question-heading-alignment.js.map +1 -1
  38. package/dist/audits/index.d.ts +1 -1
  39. package/dist/audits/index.js +1 -1
  40. package/dist/audits/structured-data/entity-sameas-links.d.ts +1 -1
  41. package/dist/audits/structured-data/entity-sameas-links.js +11 -11
  42. package/dist/audits/structured-data/entity-sameas-links.js.map +1 -1
  43. package/dist/audits/structured-data/jsonld-syntax-validity.d.ts +1 -1
  44. package/dist/audits/structured-data/jsonld-syntax-validity.js +12 -12
  45. package/dist/audits/structured-data/jsonld-syntax-validity.js.map +1 -1
  46. package/dist/audits/structured-data/rag-schema-presence.d.ts +1 -1
  47. package/dist/audits/structured-data/rag-schema-presence.js +13 -13
  48. package/dist/audits/structured-data/rag-schema-presence.js.map +1 -1
  49. package/dist/config/default-config.d.ts +2 -2
  50. package/dist/config/default-config.js +6 -6
  51. package/dist/config/default-config.js.map +1 -1
  52. package/dist/gather/driver/cheerio-driver.d.ts +1 -1
  53. package/dist/gather/driver/cheerio-driver.js +4 -4
  54. package/dist/gather/driver/cheerio-driver.js.map +1 -1
  55. package/dist/gather/gatherers/content-chunks-gatherer.d.ts +1 -1
  56. package/dist/gather/gatherers/content-chunks-gatherer.d.ts.map +1 -1
  57. package/dist/gather/gatherers/content-chunks-gatherer.js +4 -6
  58. package/dist/gather/gatherers/content-chunks-gatherer.js.map +1 -1
  59. package/dist/gather/gatherers/direct-answers-gatherer.d.ts +1 -1
  60. package/dist/gather/gatherers/direct-answers-gatherer.d.ts.map +1 -1
  61. package/dist/gather/gatherers/direct-answers-gatherer.js +4 -5
  62. package/dist/gather/gatherers/direct-answers-gatherer.js.map +1 -1
  63. package/dist/gather/gatherers/headings-hierarchy-gatherer.d.ts +1 -1
  64. package/dist/gather/gatherers/headings-hierarchy-gatherer.js +2 -2
  65. package/dist/gather/gatherers/headings-hierarchy-gatherer.js.map +1 -1
  66. package/dist/gather/gatherers/robots-txt-gatherer.d.ts +1 -1
  67. package/dist/gather/gatherers/robots-txt-gatherer.d.ts.map +1 -1
  68. package/dist/gather/gatherers/robots-txt-gatherer.js +2 -4
  69. package/dist/gather/gatherers/robots-txt-gatherer.js.map +1 -1
  70. package/dist/report/html-reporter.d.ts +2 -2
  71. package/dist/report/html-reporter.js +9 -9
  72. package/dist/report/html-reporter.js.map +1 -1
  73. package/dist/report/terminal-reporter.d.ts +1 -1
  74. package/dist/report/terminal-reporter.js +3 -3
  75. package/dist/report/terminal-reporter.js.map +1 -1
  76. package/dist/runner/aggregator.d.ts +3 -3
  77. package/dist/runner/aggregator.js +5 -5
  78. package/dist/runner/aggregator.js.map +1 -1
  79. package/dist/runner/runner.d.ts +7 -7
  80. package/dist/runner/runner.d.ts.map +1 -1
  81. package/dist/runner/runner.js +17 -18
  82. package/dist/runner/runner.js.map +1 -1
  83. package/dist/types/artifacts.d.ts +19 -21
  84. package/dist/types/artifacts.d.ts.map +1 -1
  85. package/dist/types/artifacts.js +3 -3
  86. package/dist/types/audit.d.ts +29 -29
  87. package/dist/types/audit.d.ts.map +1 -1
  88. package/dist/types/audit.js +2 -2
  89. package/dist/types/config.d.ts +21 -21
  90. package/dist/types/config.d.ts.map +1 -1
  91. package/dist/types/config.js +1 -1
  92. package/dist/types/gatherer.d.ts +6 -6
  93. package/dist/types/gatherer.d.ts.map +1 -1
  94. package/dist/types/gatherer.js +1 -1
  95. package/package.json +1 -1
@@ -1,40 +1,40 @@
1
1
  /**
2
- * @fileoverview Tipos para la configuración, categorías y cálculo ponderado de scores.
2
+ * @fileoverview Configuration, category, and weighted score types.
3
3
  */
4
4
  import type { AuditMeta } from './audit.js';
5
5
  /**
6
- * Referencia a una auditoría dentro de una categoría, con su peso específico
6
+ * Reference to an audit inside a category with its specific weight
7
7
  */
8
8
  export interface AuditRef {
9
- /** Identificador de la auditoría */
9
+ /** Audit unique ID */
10
10
  id: string;
11
- /** Peso relativo de la auditoría en la categoría (e.g. 1 a 10) */
11
+ /** Relative weight of the audit in category */
12
12
  weight: number;
13
- /** Grupo visual opcional para organizar en la UI / reporte */
13
+ /** Optional visual group */
14
14
  group?: string;
15
15
  }
16
16
  /**
17
- * Categoría que agrupa auditorías temáticas
17
+ * Category grouping thematic audits
18
18
  */
19
19
  export interface CategoryConfig {
20
- /** Título de la categoría */
20
+ /** Category title */
21
21
  title: string;
22
- /** Descripción del propósito y su relevancia en AEO */
22
+ /** Category description */
23
23
  description: string;
24
- /** Lista de auditorías ponderadas que pertenecen a esta categoría */
24
+ /** Weighted audits belonging to this category */
25
25
  auditRefs: AuditRef[];
26
- /** Peso global de la categoría respecto al score total (opcional) */
26
+ /** Global weight of the category */
27
27
  weight?: number;
28
28
  }
29
29
  /**
30
- * Configuración completa del linter
30
+ * Complete linter configuration
31
31
  */
32
32
  export interface LinterConfig {
33
- /** Categorías configuradas */
33
+ /** Categories mapping */
34
34
  categories: Record<string, CategoryConfig>;
35
- /** Auditorías registradas en esta configuración (IDs o Metas) */
35
+ /** Registered audit IDs or Metas */
36
36
  audits?: Array<string | AuditMeta>;
37
- /** Configuración global y banderas */
37
+ /** Global settings */
38
38
  settings?: {
39
39
  locale?: string;
40
40
  maxWaitForFulfill?: number;
@@ -43,32 +43,32 @@ export interface LinterConfig {
43
43
  };
44
44
  }
45
45
  /**
46
- * Resultado evaluado de una categoría con su puntaje ponderado
46
+ * Evaluated category result with weighted score
47
47
  */
48
48
  export interface CategoryResult {
49
49
  id: string;
50
50
  title: string;
51
51
  description: string;
52
- /** Score ponderado de la categoría (0 - 1) */
52
+ /** Category weighted score (0 - 1) */
53
53
  score: number | null;
54
- /** Auditorías ejecutadas asociadas a esta categoría con sus resultados */
54
+ /** Audits evaluated in this category */
55
55
  auditRefs: Array<AuditRef & {
56
56
  result: import('./audit.js').AuditResult;
57
57
  }>;
58
58
  }
59
59
  /**
60
- * Resultado completo del análisis AEO
60
+ * Complete AEO audit report result
61
61
  */
62
62
  export interface AeoReportResult {
63
63
  url: string;
64
64
  fetchTime: string;
65
65
  aeoVersion: string;
66
66
  userAgent: string;
67
- /** Puntuación general agregada (0 - 100) */
67
+ /** Aggregated overall score (0 - 100) */
68
68
  overallScore: number;
69
- /** Resultados por categoría */
69
+ /** Category results map */
70
70
  categories: Record<string, CategoryResult>;
71
- /** Mapa directo de auditorías por id */
71
+ /** Direct audit results map */
72
72
  audits: Record<string, import('./audit.js').AuditResult>;
73
73
  }
74
74
  //# sourceMappingURL=config.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,iEAAiE;IACjE,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACnC,sCAAsC;IACtC,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,0EAA0E;IAC1E,SAAS,EAAE,KAAK,CAAC,QAAQ,GAAG;QAAE,MAAM,EAAE,OAAO,YAAY,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,YAAY,EAAE,WAAW,CAAC,CAAC;CAC1D"}
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,oCAAoC;IACpC,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACnC,sBAAsB;IACtB,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wCAAwC;IACxC,SAAS,EAAE,KAAK,CAAC,QAAQ,GAAG;QAAE,MAAM,EAAE,OAAO,YAAY,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,YAAY,EAAE,WAAW,CAAC,CAAC;CAC1D"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @fileoverview Tipos para la configuración, categorías y cálculo ponderado de scores.
2
+ * @fileoverview Configuration, category, and weighted score types.
3
3
  */
4
4
  export {};
5
5
  //# sourceMappingURL=config.js.map
@@ -1,9 +1,9 @@
1
1
  /**
2
- * @fileoverview Tipos y contratos para la fase de Gatherers (recolección).
2
+ * @fileoverview Types and contracts for Gatherers phase.
3
3
  */
4
4
  import type { Artifacts } from './artifacts.js';
5
5
  /**
6
- * Driver abstracto o adaptador de protocolo para extraer información de la página/DOM
6
+ * Abstract driver or protocol adapter to extract DOM/network information
7
7
  */
8
8
  export interface Driver {
9
9
  evaluate<T>(script: string | (() => T)): Promise<T>;
@@ -13,7 +13,7 @@ export interface Driver {
13
13
  getHttpHeaders(): Promise<Record<string, string | string[]>>;
14
14
  }
15
15
  /**
16
- * Contexto de recolección entregado a cada Gatherer
16
+ * Context passed to each Gatherer
17
17
  */
18
18
  export interface GathererContext {
19
19
  url: string;
@@ -21,12 +21,12 @@ export interface GathererContext {
21
21
  settings?: Record<string, unknown>;
22
22
  }
23
23
  /**
24
- * Interfaz base para un Gatherer
24
+ * Gatherer base interface
25
25
  */
26
26
  export interface IGatherer<K extends keyof Artifacts = keyof Artifacts> {
27
- /** Nombre del artefacto que produce */
27
+ /** Name of the artifact produced */
28
28
  name: K;
29
- /** Método de recolección */
29
+ /** Extraction method */
30
30
  getArtifact(context: GathererContext): Promise<Artifacts[K]>;
31
31
  }
32
32
  //# sourceMappingURL=gatherer.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"gatherer.d.ts","sourceRoot":"","sources":["../../src/types/gatherer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,MAAM,SAAS,GAAG,MAAM,SAAS;IACpE,uCAAuC;IACvC,IAAI,EAAE,CAAC,CAAC;IACR,4BAA4B;IAC5B,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9D"}
1
+ {"version":3,"file":"gatherer.d.ts","sourceRoot":"","sources":["../../src/types/gatherer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,MAAM,SAAS,GAAG,MAAM,SAAS;IACpE,oCAAoC;IACpC,IAAI,EAAE,CAAC,CAAC;IACR,wBAAwB;IACxB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9D"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @fileoverview Tipos y contratos para la fase de Gatherers (recolección).
2
+ * @fileoverview Types and contracts for Gatherers phase.
3
3
  */
4
4
  export {};
5
5
  //# sourceMappingURL=gatherer.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@drowlink/aeo-linter-core",
3
- "version": "0.1.1",
3
+ "version": "0.1.3",
4
4
  "description": "Core engine and audit pipeline for AEO/GEO linter (Lighthouse architecture)",
5
5
  "main": "./dist/index.js",
6
6
  "types": "./dist/index.d.ts",