@mocoto/mahoraga 0.14.0 → 0.14.2

package/dist/analysts/html/analysts/analyst-html.js

@@ -1,40 +1,44 @@
+// SPDX-License-Identifier: MIT
+import { ElementType } from 'domelementtype';
+import { parseDocument } from 'htmlparser2';
 import { messages } from '../../../core/messages/index.js';
 import { createLineLookup, maskHtmlComments, maskTagBlocks } from '../../../shared/helpers/index.js';
-import { parseDocument } from 'htmlparser2';
 import { criarAnalista, criarOcorrencia } from '../../../types/index.js';
-const disableEnv = process.env.MAHORAGA_DISABLE_PLUGIN_HTML === '1';
+const disableEnv = process.env.SUKUNA_DISABLE_PLUGIN_HTML === '1';
 function warn(message, relPath, line) {
     return criarOcorrencia({ relPath, mensagem: message, linha: line, nivel: messages.SeverityNiveis.warning, origem: messages.AnalystOrigens.html, tipo: messages.AnalystTipos.html });
 }
-function isElement(node) { return node.type === 'tag'; }
+function isElement(node) { return node.type === ElementType.Tag; }
 function getAttr(el, name) {
-    const attrs = el.attribs || {};
-    const valor = attrs[name] ?? attrs[name.toLowerCase()] ?? '';
+    const attrs = el.attribs;
+    const valor = attrs[name] || attrs[name.toLowerCase()] || '';
     return typeof valor === 'string' ? valor : '';
 }
 function walk(node, visit) {
     visit(node);
     const children = node.children;
     if (Array.isArray(children)) {
-        for (const elem of children)
+        for (const elem of children) {
             walk(elem, visit);
+        }
     }
 }
 const INLINE_EVENTS = new Set(['onclick', 'onchange', 'onsubmit', 'onload', 'onerror', 'onmouseover', 'onmouseout', 'onkeyup', 'onkeydown', 'onfocus', 'onblur', 'oninput']);
 function checkDoctype(node) {
-    if (node.type !== 'directive')
+    if (node.type !== ElementType.Directive) {
         return null;
-    const data = String(node.data || '');
+    }
+    const data = (node.data ?? '');
     return /^!doctype\s+html\b/i.test(data);
 }
 function validarButton(node, line, relPath, ocorrencias) {
-    const text = node.children?.some(elem => elem.type === 'text' && String(elem.data || '').trim().length > 0);
+    const text = node.children.some(elem => elem.type === ElementType.Text && (elem).data.trim().length > 0);
     if (!text && !getAttr(node, 'aria-label') && !getAttr(node, 'title')) {
         ocorrencias.push(warn(messages.HtmlMensagens.buttonWithoutText, relPath, line));
     }
 }
 function validarTable(node, line, relPath, ocorrencias) {
-    const hasCaption = node.children?.some(elem => elem.type === 'tag' && String(elem.name).toLowerCase() === 'caption');
+    const hasCaption = node.children.some(elem => elem.type === ElementType.Tag && (elem).name.toLowerCase() === 'caption');
     if (!hasCaption && !getAttr(node, 'aria-label')) {
         ocorrencias.push(warn(messages.HtmlMensagens.tableWithoutCaption, relPath, line));
     }
@@ -49,11 +53,12 @@ function validarLink(node, line, relPath, ocorrencias) {
     if (target === '_blank' && !/(noopener|noreferrer)/i.test(getAttr(node, 'rel'))) {
         ocorrencias.push(warn(messages.HtmlMensagens.linkTargetBlank, relPath, line));
     }
-    const attrs = node.attribs || {};
+    const attrs = node.attribs;
     const hasHref = Object.prototype.hasOwnProperty.call(attrs, 'href');
     const href = getAttr(node, 'href');
-    if (hasHref && href !== '' && href !== '#')
+    if (hasHref && href !== '' && href !== '#') {
         return;
+    }
     const hasOnClick = Object.keys(attrs).some(chave => chave.toLowerCase() === 'onclick');
     const isRoleButton = getAttr(node, 'role').toLowerCase() === 'button';
     if (!hasOnClick && !isRoleButton && !getAttr(node, 'tabindex')) {
@@ -66,7 +71,7 @@ function validarImg(node, line, relPath, ocorrencias, isTemplate) {
     const ariaHidden = getAttr(node, 'aria-hidden').toLowerCase() === 'true';
     const role = getAttr(node, 'role').toLowerCase();
     const decorative = ariaHidden || ariaLabel || role === 'presentation' || role === 'none';
-    const attrs = node.attribs || {};
+    const attrs = node.attribs;
     const dataAttr = Object.keys(attrs).some(chave => /^(data-)?(decorative|icon|symbol)$/i.test(chave));
     if (!alt && !decorative && !dataAttr && !/\.svg(\?|#|$)/i.test(getAttr(node, 'src'))) {
         ocorrencias.push(warn(messages.HtmlMensagens.imgWithoutAlt, relPath, line));
@@ -79,9 +84,10 @@ function validarImg(node, line, relPath, ocorrencias, isTemplate) {
     }
 }
 function validarForm(node, line, relPath, ocorrencias) {
-    if (!getAttr(node, 'method'))
+    if (!getAttr(node, 'method')) {
         ocorrencias.push(warn(messages.HtmlMensagens.formWithoutMethod, relPath, line));
-    const attrs = node.attribs || {};
+    }
+    const attrs = node.attribs;
     if (!getAttr(node, 'action') && !Object.keys(attrs).some(chave => chave.toLowerCase().startsWith('data-'))) {
         ocorrencias.push(warn(messages.HtmlMensagens.formWithoutAction, relPath, line));
     }
@@ -93,28 +99,30 @@ function validarInput(node, line, relPath, ocorrencias) {
     if (!isHidden && !isButton && !getAttr(node, 'aria-label') && !getAttr(node, 'name')) {
         ocorrencias.push(warn(messages.HtmlMensagens.inputWithoutLabel, relPath, line));
     }
-    if (!type)
+    if (!type) {
         ocorrencias.push(warn(messages.HtmlMensagens.inputWithoutType, relPath, line));
+    }
     if (type === 'password' && !getAttr(node, 'autocomplete')) {
         ocorrencias.push(warn(messages.HtmlMensagens.passwordWithoutAutocomplete, relPath, line));
     }
 }
 function validarScript(node, line, relPath, ocorrencias, isTemplate) {
     const srcAttr = getAttr(node, 'src');
-    const children = node.children || [];
-    const text = children.filter((elem) => elem.type === 'text').map(elem => String(elem.data || '')).join('');
+    const children = node.children;
+    const text = children.filter((elem) => elem.type === ElementType.Text).map(elem => ((elem).data || '')).join('');
     if (!srcAttr && text.trim().length > 0) {
         ocorrencias.push(warn(messages.HtmlMensagens.inlineScript, relPath, line));
-        if (text.length > 1000)
+        if (text.length > 1000) {
             ocorrencias.push(warn(messages.HtmlMensagens.largeInlineScript, relPath, line));
+        }
     }
     if (srcAttr && !isTemplate && !getAttr(node, 'defer') && !getAttr(node, 'async')) {
         ocorrencias.push(warn(messages.HtmlMensagens.scriptWithoutDefer, relPath, line));
     }
 }
 function validarStyle(node, line, relPath, ocorrencias) {
-    const children = node.children || [];
-    const text = children.filter((elem) => elem.type === 'text').map(elem => String(elem.data || '')).join('');
+    const children = node.children;
+    const text = children.filter((elem) => elem.type === ElementType.Text).map(elem => ((elem).data || '')).join('');
     if (text.trim().length > 0) {
         ocorrencias.push(warn(messages.HtmlMensagens.inlineStyle, relPath, line));
     }
@@ -132,28 +140,34 @@ const validadores = {
 };
 function validateNode(node, tag, line, relPath, ocorrencias, isTemplate) {
     const validador = validadores[tag];
-    if (validador)
-        validador(node, line, relPath, ocorrencias, isTemplate);
-    const attrs = node?.attribs || {};
+    validador(node, line, relPath, ocorrencias, isTemplate);
+    const attrs = node.attribs;
     if (Object.keys(attrs).some(attr => INLINE_EVENTS.has(attr.toLowerCase()))) {
         ocorrencias.push(warn(messages.HtmlMensagens.inlineHandler, relPath, line));
     }
 }
 function verificarDocumento(ocorrencias, relPath, hasDoctype, htmlLangOk, hasCharset, hasViewport, hasTitle, h1Contagem, isTemplate) {
-    if (isTemplate)
+    if (isTemplate) {
         return;
-    if (!hasDoctype)
+    }
+    if (!hasDoctype) {
         ocorrencias.push(warn(messages.HtmlMensagens.doctype, relPath, 1));
-    if (!htmlLangOk)
+    }
+    if (!htmlLangOk) {
         ocorrencias.push(warn(messages.HtmlMensagens.htmlLang, relPath, 1));
-    if (!hasCharset)
+    }
+    if (!hasCharset) {
         ocorrencias.push(warn(messages.HtmlMensagens.metaCharset, relPath, 1));
-    if (!hasViewport)
+    }
+    if (!hasViewport) {
         ocorrencias.push(warn(messages.HtmlMensagens.viewport, relPath, 1));
-    if (!hasTitle)
+    }
+    if (!hasTitle) {
         ocorrencias.push(warn(messages.HtmlMensagens.title, relPath, 1));
-    if (h1Contagem > 1)
+    }
+    if (h1Contagem > 1) {
         ocorrencias.push(warn(messages.HtmlMensagens.multipleH1, relPath, 1));
+    }
 }
 function collectHtmlIssuesAst(src, relPath) {
     const ocorrencias = [];
@@ -179,24 +193,30 @@ function collectHtmlIssuesAst(src, relPath) {
             hasDoctype = doctype;
             return;
         }
-        if (!isElement(node))
+        if (!isElement(node)) {
             return;
-        const tag = String(node.name || '').toLowerCase();
+        }
+        const tag = (node.name || '').toLowerCase();
         const line = startLineOf(node);
-        if (tag === 'title' && !isTemplate)
+        if (tag === 'title' && !isTemplate) {
             hasTitle = true;
-        if (tag === 'html' && !isTemplate && getAttr(node, 'lang'))
+        }
+        if (tag === 'html' && !isTemplate && getAttr(node, 'lang')) {
             htmlLangOk = true;
+        }
         if (tag === 'meta' && !isTemplate) {
-            if (getAttr(node, 'charset') || (getAttr(node, 'http-equiv').toLowerCase() === 'content-type' && /charset\s*=\s*utf-8/i.test(getAttr(node, 'content'))))
+            if (getAttr(node, 'charset') || (getAttr(node, 'http-equiv').toLowerCase() === 'content-type' && /charset\s*=\s*utf-8/i.test(getAttr(node, 'content')))) {
                 hasCharset = true;
-            if (getAttr(node, 'name').toLowerCase() === 'viewport')
+            }
+            if (getAttr(node, 'name').toLowerCase() === 'viewport') {
                 hasViewport = true;
+            }
         }
         if (/^h[1-6]$/.test(tag) && !isTemplate) {
             const level = parseInt(tag.charAt(1), 10);
-            if (level === 1)
+            if (level === 1) {
                 h1Contagem++;
+            }
             if (level > lastHeadingNivel + 1 && lastHeadingNivel > 0) {
                 ocorrencias.push(warn(messages.HtmlMensagens.headingSkipped(level, lastHeadingNivel + 1), relPath, line));
             }
@@ -308,8 +328,9 @@ function checkInlineScriptRegex(src, scanNoScriptStyle, relPath, ocorrencias, li
     for (const metrica of src.matchAll(/<script[^>]*>[\s\S]*?<\/\s*script\b[^>]*\s*>/gi)) {
         if (typeof metrica.index === 'number') {
             const idx = metrica.index;
-            if ((scanNoScriptStyle[idx] ?? ' ') !== '<')
+            if ((scanNoScriptStyle[idx] ?? ' ') !== '<') {
                 continue;
+            }
         }
         const isExternal = /\ssrc=/.test(metrica[0]);
         const innerScriptContent = metrica[0].replace(/^[\s\S]*?<script\b[^>]*>/i, '').replace(/<\/\s*script\b[^>]*\s*>[\s\S]*$/i, '');
@@ -323,8 +344,9 @@ function checkInlineStyleRegex(src, scanNoScriptStyle, relPath, ocorrencias, lin
     for (const metrica of src.matchAll(/<style[^>]*>[\s\S]*?<\/\s*style\b[^>]*\s*>/gi)) {
         if (typeof metrica.index === 'number') {
             const idx = metrica.index;
-            if ((scanNoScriptStyle[idx] ?? ' ') !== '<')
+            if ((scanNoScriptStyle[idx] ?? ' ') !== '<') {
                 continue;
+            }
         }
         const isEmpty = /<style\b[^>]*>\s*<\/\s*style[^>]*>/i.test(metrica[0]);
         if (!isEmpty) {
@@ -368,11 +390,11 @@ export const analistaHtml = criarAnalista({
     descricao: 'Heurísticas leves para HTML com convenções padrão.',
     global: false,
     test: (relPath) => /\.(html|htm)$/i.test(relPath),
-    aplicar: async (src, relPath) => {
-        if (disableEnv)
+    aplicar: (src, relPath) => {
+        if (disableEnv) {
             return null;
+        }
         const msgs = collectHtmlIssues(src, relPath);
         return msgs.length ? msgs : null;
     }
 });
-//# sourceMappingURL=analyst-html.js.map

package/dist/analysts/html/analysts/index.js

@@ -1,2 +1 @@
 export * from './analyst-html.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/html/corrections/correction-html.js

@@ -1,3 +1,12 @@
+// SPDX-License-Identifier: MIT
+/**
+ * [CHAVE-INGLESA] Correções automáticas para HTML
+ *
+ * Fornece correções sugeridas para problemas comuns em HTML:
+ * - Adicionar alt em imagens
+ * - Adicionar labels em inputs
+ * - Adicionar lang no html
+ */
 import { messages } from '../../../core/messages/index.js';
 import { splitLines } from '../../../shared/helpers/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
@@ -45,8 +54,9 @@ export const correctionHtml = {
     descricao: 'Correções automáticas para problemas HTML',
     test: (relPath) => /\.(html|htm)$/i.test(relPath),
     aplicar: (src, relPath) => {
-        if (!src)
+        if (!src) {
             return [];
+        }
         const correcoes = detectarCorrecoesHtml(src, relPath);
         return correcoes.map(elem => criarOcorrencia({
             tipo: `correction-${elem.tipo}`,
@@ -58,4 +68,3 @@ export const correctionHtml = {
         }));
     }
 };
-//# sourceMappingURL=correction-html.js.map

package/dist/analysts/html/corrections/index.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export * from './correction-html.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/html/detectors/detector-html-accessibility.js

@@ -1,3 +1,15 @@
+// SPDX-License-Identifier: MIT
+/**
+ * [BUSCA] Detector de acessibilidade HTML
+ *
+ * Detecta problemas de acessibilidade em HTML:
+ * - Missing alt attributes
+ * - Missing labels for inputs
+ * - Inline event handlers
+ * - Missing lang attribute
+ * - Missing doctype
+ * - Heading hierarchy
+ */
 import { splitLines } from '../../../shared/helpers/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
 export const detectorHtmlAccessibility = {
@@ -6,8 +18,9 @@ export const detectorHtmlAccessibility = {
     descricao: 'Detecta problemas de acessibilidade em HTML',
     test: (relPath) => /\.(html|htm)$/i.test(relPath),
     aplicar: (src, relPath) => {
-        if (!src)
+        if (!src) {
             return [];
+        }
         const ocorrencias = [];
         const linhas = splitLines(src);
         const srcCompleto = src;
@@ -102,4 +115,3 @@ export const detectorHtmlAccessibility = {
         return ocorrencias;
     }
 };
-//# sourceMappingURL=detector-html-accessibility.js.map

package/dist/analysts/html/detectors/detector-html.js

@@ -1,9 +1,21 @@
+// SPDX-License-Identifier: MIT
+/**
+ * [BUSCA] Detector de HTML (acessibilidade, SEO, performance, seguranca, semantica)
+ *
+ * Detecta problemas em HTML abrangendo:
+ * - Acessibilidade: alt, labels, headings, roles
+ * - SEO: meta tags, canonical, og, twitter
+ * - Performance: defer/async, inline CSS, page size
+ * - Seguranca: meta refresh, noscript, rel, event handlers
+ * - Semantica: landmarks, deprecated tags, form/button attributes
+ */
 import { messages } from '../../../core/messages/index.js';
 import { splitLines } from '../../../shared/helpers/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
 function detect(src, relPath, check) {
-    if (!src)
+    if (!src) {
         return [];
+    }
     return check(src, relPath).map(d => criarOcorrencia({
         tipo: d.type,
         nivel: 'aviso',
@@ -33,42 +45,53 @@ function detectAccessibility(src, relPath) {
     for (let i = 0; i < linhas.length; i++) {
         const l = i + 1;
         const linha = linhas[i];
+        // Image without alt
         if (/<img(?![^>]*alt=)[^>]*>/i.test(linha) && !/aria-hidden=['"]true['"]/i.test(linha)) {
             results.push({ type: 'html-img-without-alt', message: M.imgWithoutAlt, line: l, suggestion: M.imgWithoutAltSugestao });
         }
+        // Input without label
         if (/<input(?![^>]*(aria-label|aria-labelledby|id=))/i.test(linha) && !/type=['"]?(hidden|button|submit|reset)['"]?/i.test(linha)) {
             results.push({ type: 'html-input-without-label', message: M.inputWithoutLabel, line: l, suggestion: M.inputWithoutLabelSugestao });
         }
+        // Empty button
         if (/<button[^>]*>[\s]*<\/button>/i.test(linha) && !/\saria-label=/i.test(linha)) {
             results.push({ type: 'html-empty-button', message: M.emptyButton, line: l });
         }
+        // Empty heading
         if (/<h[1-6][^>]*>[\s]*<\/h[1-6]>/i.test(linha)) {
             results.push({ type: 'html-empty-heading', message: M.emptyHeading, line: l });
         }
+        // Button without type
         if (/<button[^>]*>/i.test(linha) && !/\stype=/i.test(linha)) {
             results.push({ type: 'html-button-without-type', message: M.buttonWithoutType, line: l });
         }
+        // Form without action
         if (/<form[^>]*>/i.test(linha) && !/\saction=/i.test(linha) && !/<form[^>]*data-/i.test(linha)) {
             results.push({ type: 'html-form-without-action', message: M.formWithoutAction, line: l });
         }
+        // Form without method
         if (/<form[^>]*>/i.test(linha) && !/\smethod=/i.test(linha)) {
             results.push({ type: 'html-form-without-method', message: M.formWithoutMethod, line: l, suggestion: M.formWithoutMethodSugestao });
         }
+        // Table without caption
         if (/<table[^>]*>/i.test(linha) && !/aria-label=/i.test(linha)) {
             const hasCaption = linhas.slice(i, i + 20).some(l2 => /<caption[^>]*>/i.test(l2));
             if (!hasCaption) {
                 results.push({ type: 'html-table-without-caption', message: M.tableWithoutCaption, line: l });
             }
         }
+        // Th without scope
         if (/<th[^>]*>/i.test(linha) && !/\sscope=/i.test(linha)) {
             results.push({ type: 'html-th-without-scope', message: M.tableWithoutScope, line: l });
         }
+        // Fieldset without legend
         if (/<fieldset[^>]*>/i.test(linha)) {
             const hasLegend = linhas.slice(i, i + 5).some(l2 => /<legend[^>]*>/i.test(l2));
             if (!hasLegend) {
                 results.push({ type: 'html-fieldset-without-legend', message: M.missingFormLegend, line: l });
             }
         }
+        // Input group without fieldset
         if (/<input[^>]*>/i.test(linha) && !isTemplate) {
             const fieldsetBefore = linhas.slice(Math.max(0, i - 10), i).some(l2 => /<fieldset[^>]*>/i.test(l2));
             const fieldsetAfter = linhas.slice(i, i + 5).some(l2 => /<\/fieldset>/i.test(l2));
@@ -79,14 +102,16 @@ function detectAccessibility(src, relPath) {
                 }
             }
         }
+        // Duplicate ID
         const idMatch = linha.match(/\sid=['"]([^'"]+)['"]/i);
         if (idMatch) {
             const idValue = idMatch[1];
-            const count = (srcCompleto.match(new RegExp(`\\sid=['"]${idValue}['"]`, 'gi')) || []).length;
+            const count = (srcCompleto.match(new RegExp(`\\sid=['"]${idValue}['"]`, 'gi')) ?? []).length;
             if (count > 1) {
                 results.push({ type: 'html-duplicate-id', message: M.duplicateId, line: l });
             }
         }
+        // Ambiguous link text
         if (/<a[^>]*>[\s]*(click here|leia mais|saiba mais|read more|learn more|aqui|here|more|link)[\s]*<\/a>/i.test(linha)) {
             results.push({ type: 'html-ambiguous-link-text', message: M.ambiguousLinkText, line: l });
         }
@@ -96,56 +121,68 @@ function detectAccessibility(src, relPath) {
 function detectSeo(src, relPath) {
     const results = [];
     const isTemplate = /\.(template\.html|\.component\.html)$/i.test(relPath);
-    if (isTemplate)
+    if (isTemplate) {
         return results;
+    }
+    // Meta charset
     if (!/<meta[^>]*\bcharset\s*=\s*['"]?[^'">\s]+/i.test(src) && !/<meta[^>]*http-equiv=['"]content-type['"][^>]*>/i.test(src)) {
         results.push({ type: 'html-missing-charset', message: M.missingMetaCharset, line: 1 });
     }
+    // Meta viewport
     if (!/<meta[^>]*name=['"]viewport['"]/i.test(src)) {
         results.push({ type: 'html-missing-viewport', message: M.missingMetaViewport, line: 1 });
     }
+    // Meta description
     if (!/<meta[^>]*name=['"]description['"]/i.test(src)) {
         results.push({ type: 'html-missing-description', message: M.missingMetaDescription, line: 1 });
     }
+    // Favicon
     if (!/<link[^>]*\brel=['"]?(icon|shortcut icon)['"]?/i.test(src)) {
         results.push({ type: 'html-missing-favicon', message: M.missingFavicon, line: 1 });
     }
+    // Canonical
     if (!/<link[^>]*\brel=['"]?canonical['"]?/i.test(src)) {
         results.push({ type: 'html-missing-canonical', message: M.missingCanonical, line: 1 });
     }
+    // OG tags
     const hasOgTitle = /<meta[^>]*property=['"]og:title['"]/i.test(src);
     const hasOgDesc = /<meta[^>]*property=['"]og:description['"]/i.test(src);
     const hasOgImage = /<meta[^>]*property=['"]og:image['"]/i.test(src);
     if (!hasOgTitle || !hasOgDesc || !hasOgImage) {
         results.push({ type: 'html-missing-og-tags', message: M.missingOgTags, line: 1 });
     }
+    // Twitter Card
     if (!/<meta[^>]*name=['"]twitter:card['"]/i.test(src)) {
         results.push({ type: 'html-missing-twitter-card', message: M.missingTwitterCard, line: 1 });
     }
-    const titleTags = src.match(/<title[^>]*>/gi) || [];
+    // Duplicate title
+    const titleTags = src.match(/<title[^>]*>/gi) ?? [];
     if (titleTags.length > 1) {
         results.push({ type: 'html-duplicate-title', message: M.duplicateTitle, line: 1 });
     }
+    // Broken internal anchors
     const ids = new Set();
     const idMatches = src.matchAll(/\sid=['"]([^'"]+)['"]/gi);
-    for (const m of idMatches)
+    for (const m of idMatches) {
         ids.add(m[1]);
+    }
     const hashLinks = src.matchAll(/<a[^>]*href=['"](#[^'"]+)['"][^>]*>/gi);
     for (const m of hashLinks) {
         const targetId = m[1].slice(1);
         if (!ids.has(targetId)) {
             const _lineLookup = splitLines(src);
-            const idx = m.index ?? 0;
+            const idx = m.index;
             const lineNum = src.slice(0, idx).split('\n').length;
             results.push({ type: 'html-broken-anchor', message: M.brokenAnchor, line: lineNum });
         }
     }
+    // Heading hierarchy skip
     let lastLevel = 0;
     const headingMatches = src.matchAll(/<h([1-6])[^>]*>/gi);
     for (const m of headingMatches) {
         const level = parseInt(m[1], 10);
         if (level > lastLevel + 1 && lastLevel > 0) {
-            const lineNum = src.slice(0, m.index ?? 0).split('\n').length;
+            const lineNum = src.slice(0, m.index).split('\n').length;
             results.push({ type: 'html-heading-hierarchy-skip', message: M.headingHierarchySkip, line: lineNum });
         }
         lastLevel = level;
@@ -155,6 +192,7 @@ function detectSeo(src, relPath) {
 function detectPerformance(src, _relPath) {
     const results = [];
     const linhas = splitLines(src);
+    // Scripts without defer/async (external)
     for (let i = 0; i < linhas.length; i++) {
         const linha = linhas[i];
         const l = i + 1;
@@ -162,17 +200,21 @@ function detectPerformance(src, _relPath) {
             results.push({ type: 'html-script-without-defer', message: M.scriptWithoutDeferAsync, line: l });
         }
     }
+    // Too much inline CSS in body
     let _inHead = false;
     let inBody = false;
     let inlineStyleCount = 0;
     for (let i = 0; i < linhas.length; i++) {
         const linha = linhas[i];
-        if (/<\/head>/i.test(linha))
+        if (/<\/head>/i.test(linha)) {
             _inHead = false;
-        if (/<body[^>]*>/i.test(linha))
+        }
+        if (/<body[^>]*>/i.test(linha)) {
             inBody = true;
-        if (/<head[^>]*>/i.test(linha))
+        }
+        if (/<head[^>]*>/i.test(linha)) {
             _inHead = true;
+        }
         if (inBody && /\sstyle=/i.test(linha)) {
             inlineStyleCount++;
         }
@@ -180,17 +222,21 @@ function detectPerformance(src, _relPath) {
     if (inlineStyleCount > 5) {
         results.push({ type: 'html-too-much-inline-css', message: M.cssTooMuchInline, line: 1 });
     }
+    // Large page heuristic (> 100KB raw)
     if (src.length > 102400) {
         results.push({ type: 'html-large-page', message: M.largePage, line: 1 });
     }
+    // Render-blocking resources (scripts in head without defer/async)
     let inHeadBlock = false;
     for (let i = 0; i < linhas.length; i++) {
         const linha = linhas[i];
         const l = i + 1;
-        if (/<head[^>]*>/i.test(linha))
+        if (/<head[^>]*>/i.test(linha)) {
             inHeadBlock = true;
-        if (/<\/head>/i.test(linha))
+        }
+        if (/<\/head>/i.test(linha)) {
             inHeadBlock = false;
+        }
         if (inHeadBlock && /<script[^>]*src=/i.test(linha) && !/\b(defer|async)\b/i.test(linha)) {
             results.push({ type: 'html-render-blocking', message: M.performanceRenderBlocking, line: l });
         }
@@ -201,6 +247,7 @@ function detectSecurity(src, relPath) {
     const results = [];
     const isTemplate = /\.(template\.html|\.component\.html)$/i.test(relPath);
     const linhas = splitLines(src);
+    // Meta refresh with URL
     for (let i = 0; i < linhas.length; i++) {
         const linha = linhas[i];
         const l = i + 1;
@@ -208,9 +255,11 @@ function detectSecurity(src, relPath) {
             results.push({ type: 'html-meta-refresh-unsafe', message: M.metaRefreshUnsafe, line: l });
         }
     }
+    // Missing noscript
     if (!isTemplate && !/<noscript[^>]*>/i.test(src)) {
         results.push({ type: 'html-missing-noscript', message: M.missingNoScript, line: 1 });
     }
+    // Links with target=_blank without rel=noopener noreferrer
     for (let i = 0; i < linhas.length; i++) {
         const linha = linhas[i];
         const l = i + 1;
@@ -220,6 +269,7 @@ function detectSecurity(src, relPath) {
             }
         }
     }
+    // Inline event handlers
     for (let i = 0; i < linhas.length; i++) {
         const linha = linhas[i];
         const l = i + 1;
@@ -232,8 +282,10 @@ function detectSecurity(src, relPath) {
 function detectSemanticHtml(src, relPath) {
     const results = [];
     const isTemplate = /\.(template\.html|\.component\.html)$/i.test(relPath);
-    if (isTemplate)
+    if (isTemplate) {
         return results;
+    }
+    // Missing semantic landmarks
     const hasNav = /<nav[^>]*>/i.test(src);
     const hasMain = /<main[^>]*>/i.test(src);
     const hasArticle = /<article[^>]*>/i.test(src);
@@ -241,6 +293,7 @@ function detectSemanticHtml(src, relPath) {
     if (!hasNav || !hasMain || !hasArticle || !hasAside) {
         results.push({ type: 'html-missing-semantic-landmark', message: M.missingSemanticLandmark, line: 1 });
     }
+    // Deprecated tags
     const linhas = splitLines(src);
     for (let i = 0; i < linhas.length; i++) {
         const l = i + 1;
@@ -249,6 +302,7 @@ function detectSemanticHtml(src, relPath) {
             results.push({ type: 'html-deprecated-tags', message: M.deprecatedTags, line: l });
         }
     }
+    // Duplicate id (semantic)
     const ids = new Map();
     const idMatches = src.matchAll(/\sid=['"]([^'"]+)['"]/gi);
     for (const m of idMatches) {
@@ -256,15 +310,16 @@ function detectSemanticHtml(src, relPath) {
         const prev = ids.get(idValue) ?? 0;
         ids.set(idValue, prev + 1);
         if (prev > 0) {
-            const lineNum = src.slice(0, m.index ?? 0).split('\n').length;
+            const lineNum = src.slice(0, m.index).split('\n').length;
             results.push({ type: 'html-duplicate-id-semantic', message: M.duplicateId, line: lineNum });
         }
     }
     return results;
 }
 export function detectHtmlIssues(src, relPath) {
-    if (!src)
+    if (!src) {
         return [];
+    }
     const results = [
         ...detect(src, relPath, detectAccessibility),
         ...detect(src, relPath, detectSeo),
@@ -281,4 +336,3 @@ export const detectorHtml = {
     test: (relPath) => /\.(html|htm)$/i.test(relPath),
     aplicar: (src, relPath) => detectHtmlIssues(src, relPath)
 };
-//# sourceMappingURL=detector-html.js.map

package/dist/analysts/html/detectors/index.js

@@ -1,2 +1,3 @@
+// SPDX-License-Identifier: MIT
+export * from './detector-html.js';
 export * from './detector-html-accessibility.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/html/index.js

@@ -1,5 +1,10 @@
+// SPDX-License-Identifier: MIT
+/**
+ * [BUSCA] Analistas de HTML
+ *
+ * Heurísticas leves para HTML com convenções padrão.
+ */
 export * from './analysts/analyst-html.js';
 export * from './corrections/index.js';
 export * from './detectors/index.js';
 export * from './scorers/index.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/html/scorers/index.js

@@ -1,2 +1,2 @@
+// SPDX-License-Identifier: MIT
 export * from './scorer-html.js';
-//# sourceMappingURL=index.js.map