@mocoto/mahoraga 0.14.0 → 0.14.1

package/dist/analysts/svg/index.js

@@ -1,5 +1,10 @@
+// SPDX-License-Identifier: MIT
+/**
+ * [BUSCA] Analistas de SVG
+ *
+ * Heurísticas para SVG + sugestão de otimização (modo Mahoraga).
+ */
 export * from './analysts/analyst-svg.js';
 export * from './corrections/index.js';
 export * from './detectors/index.js';
 export * from './scorers/index.js';
-//# sourceMappingURL=index.js.map

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

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

package/dist/analysts/svg/scorers/scorer-svg.js

@@ -1,3 +1,13 @@
+// SPDX-License-Identifier: MIT
+/**
+ * [GRAFICO] Pontuador de qualidade SVG
+ *
+ * Avalia a qualidade do SVG baseado em:
+ * - Acessibilidade (30%)
+ * - Performance/Otimização (30%)
+ * - Segurança (25%)
+ * - Estrutura (15%)
+ */
 export function pontuarSvg(src, _relPath) {
     const maxScore = 100;
     const issues = [];
@@ -15,6 +25,8 @@ export function pontuarSvg(src, _relPath) {
             categories
         };
     }
+    // ── Acessibilidade (30 pontos) ──────────────────────────────
+    // role="img" (8 pts)
     if (/role\s*=\s*['"]img['"]/i.test(src)) {
         categories.accessibility.score += 8;
         strengths.push('role="img" definido');
@@ -22,6 +34,7 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('role="img" ausente');
     }
+    // aria-label (7 pts)
     if (/aria-label\s*=/i.test(src)) {
         categories.accessibility.score += 7;
         strengths.push('aria-label definido');
@@ -29,6 +42,7 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('aria-label ausente');
     }
+    // <title> (5 pts)
     if (/<title>/i.test(src)) {
         categories.accessibility.score += 5;
         strengths.push('<title> presente');
@@ -36,6 +50,7 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('<title> ausente');
     }
+    // <desc> (5 pts)
     if (/<desc>/i.test(src)) {
         categories.accessibility.score += 5;
         strengths.push('<desc> presente');
@@ -43,6 +58,7 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('<desc> ausente');
     }
+    // prefers-reduced-motion (5 pts) - se tiver animação
     if (/(<animate\b|<animateTransform\b|<animateMotion\b)/i.test(src)) {
         if (/prefers-reduced-motion/i.test(src)) {
             categories.accessibility.score += 5;
@@ -56,6 +72,8 @@ export function pontuarSvg(src, _relPath) {
         categories.accessibility.score += 5;
         strengths.push('Sem animações - acessível por padrão');
     }
+    // ── Performance/Otimização (30 pontos) ──────────────────────
+    // viewBox presente (5 pts)
     if (/\bviewBox\s*=\s*['"][^'"]+['"]/i.test(src)) {
         categories.performance.score += 5;
         strengths.push('viewBox definido');
@@ -63,6 +81,7 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('viewBox ausente');
     }
+    // Tamanho < 50KB (5 pts)
     if (src.length <= 51200) {
         categories.performance.score += 5;
         strengths.push('Tamanho adequado');
@@ -70,7 +89,8 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('SVG acima de 50KB');
     }
-    const elementCount = (src.match(/<[a-zA-Z]/g) || []).length;
+    // Menos de 500 elementos (5 pts)
+    const elementCount = (src.match(/<[a-zA-Z]/g) ?? []).length;
     if (elementCount <= 500) {
         categories.performance.score += 5;
         strengths.push('Número de elementos adequado');
@@ -78,6 +98,7 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('Mais de 500 elementos');
     }
+    // Sem base64 embutido (5 pts)
     if (!/data:image\/(svg\+xml|png|jpeg|gif|webp);base64/i.test(src)) {
         categories.performance.score += 5;
         strengths.push('Sem base64 embutido');
@@ -85,6 +106,7 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('Base64 embutido detectado');
     }
+    // Path data simplificado (5 pts)
     const pathData = src.match(/d\s*=\s*['"][^'"]+['"]/gi);
     const totalPathLength = pathData ? pathData.reduce((s, p) => s + p.length, 0) : 0;
     if (totalPathLength < 5000) {
@@ -94,6 +116,7 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('Path data muito complexo');
     }
+    // Dimensões definidas (5 pts)
     if (/\bwidth\s*=\s*['"]\d+['"]/i.test(src) && /\bheight\s*=\s*['"]\d+['"]/i.test(src)) {
         categories.performance.score += 5;
         strengths.push('Dimensões definidas');
@@ -101,6 +124,8 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('Dimensões ausentes');
     }
+    // ── Segurança (25 pontos) ────────────────────────────────────
+    // Sem scripts inline (6 pts)
     if (!/<script\b/i.test(src)) {
         categories.security.score += 6;
         strengths.push('Sem scripts inline');
@@ -108,7 +133,8 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('Script inline detectado');
     }
-    const handlers = (src.match(/\son\w+\s*=/gi) || []).length;
+    // Sem event handlers (6 pts)
+    const handlers = (src.match(/\son\w+\s*=/gi) ?? []).length;
     if (handlers === 0) {
         categories.security.score += 6;
         strengths.push('Sem event handlers inline');
@@ -116,6 +142,7 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push(`${handlers} event handler(s) inline`);
     }
+    // Sem javascript: URLs (5 pts)
     if (!/javascript\s*:/i.test(src)) {
         categories.security.score += 5;
         strengths.push('Sem URLs javascript:');
@@ -123,6 +150,7 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('URL javascript: detectado');
     }
+    // Sem entidades externas (4 pts)
     if (!/<!ENTITY\s/i.test(src) && !/<!DOCTYPE\s/i.test(src)) {
         categories.security.score += 4;
         strengths.push('Sem referências a entidades externas');
@@ -130,6 +158,7 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('Entidade externa detectada (XXE)');
     }
+    // Atributos seguros (4 pts)
     const hasDangerousAttr = /xlink:href\s*=\s*['"]\s*javascript\s*:/i.test(src) ||
         /href\s*=\s*['"]\s*javascript\s*:/i.test(src);
     if (!hasDangerousAttr) {
@@ -139,6 +168,8 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('Atributos perigosos detectados');
     }
+    // ── Estrutura (15 pontos) ────────────────────────────────────
+    // xmlns presente (4 pts)
     if (/xmlns\s*=/i.test(src)) {
         categories.structure.score += 4;
         strengths.push('xmlns definido');
@@ -146,13 +177,15 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('xmlns ausente');
     }
-    if ((src.match(/<svg\b/gi) || []).length <= 1) {
+    // Sem SVG aninhado (3 pts)
+    if ((src.match(/<svg\b/gi) ?? []).length <= 1) {
         categories.structure.score += 3;
         strengths.push('Sem SVG aninhado');
     }
     else {
         issues.push('SVG aninhado detectado');
     }
+    // Sem atributos obsoletos (3 pts)
     if (!/\bversion\s*=\s*['"]/.test(src) && !/\bbaseProfile\s*=\s*['"]/.test(src)) {
         categories.structure.score += 3;
         strengths.push('Sem atributos obsoletos');
@@ -160,6 +193,7 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('Atributos obsoletos detectados');
     }
+    // stroke-width em strokes (3 pts)
     const hasStroke = /\bstroke\s*=\s*['"]/i.test(src);
     const hasStrokeWidth = /\bstroke-width\s*=/i.test(src);
     if (hasStroke && hasStrokeWidth) {
@@ -173,6 +207,7 @@ export function pontuarSvg(src, _relPath) {
     else {
         issues.push('stroke-width ausente em elementos com stroke');
     }
+    // fill adequado (2 pts)
     if (!/\bfill\s*=\s*['"]none['"]/i.test(src) || /\bstroke\s*=/i.test(src)) {
         categories.structure.score += 2;
         strengths.push('fill adequado');
@@ -197,4 +232,3 @@ export const pontuadorSvg = {
     descricao: 'Pontua qualidade de SVG (acessibilidade, performance, segurança, estrutura)',
     pontuar: pontuarSvg
 };
-//# sourceMappingURL=scorer-svg.js.map

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

@@ -1,12 +1,16 @@
+// SPDX-License-Identifier: MIT
 import { messages } from '../../../core/messages/index.js';
 import { createLineLookup } from '../../../shared/helpers/index.js';
 import { criarAnalista, criarOcorrencia } from '../../../types/index.js';
-const disableEnv = process.env.MAHORAGA_DISABLE_PLUGIN_TAILWIND === '1';
+const disableEnv = process.env.SUKUNA_DISABLE_PLUGIN_TAILWIND === '1';
 function extractBalancedBraces(src, braceStartIndex, maxLen = 8000) {
-    if (braceStartIndex < 0 || braceStartIndex >= src.length)
+    // braceStartIndex deve apontar para '{'
+    if (braceStartIndex < 0 || braceStartIndex >= src.length) {
         return null;
-    if (src[braceStartIndex] !== '{')
+    }
+    if (src[braceStartIndex] !== '{') {
         return null;
+    }
     let currentIndex = braceStartIndex + 1;
     let depth = 1;
     let inSingle = false;
@@ -22,6 +26,7 @@ function extractBalancedBraces(src, braceStartIndex, maxLen = 8000) {
             continue;
         }
         if (ch === '\\') {
+            // escape dentro de strings
             if (inSingle || inDouble || inBacktick) {
                 escaped = true;
             }
@@ -29,20 +34,25 @@ function extractBalancedBraces(src, braceStartIndex, maxLen = 8000) {
             continue;
         }
         if (inSingle) {
-            if (ch === "'")
+            if (ch === "'") {
                 inSingle = false;
+            }
             currentIndex++;
             continue;
         }
         if (inDouble) {
-            if (ch === '"')
+            if (ch === '"') {
                 inDouble = false;
+            }
             currentIndex++;
             continue;
         }
         if (inBacktick) {
-            if (ch === '`')
+            // Nota: ignoramos completamente conteúdo de template literal
+            // para não quebrar em '}' de interpolações `${...}`.
+            if (ch === '`') {
                 inBacktick = false;
+            }
             currentIndex++;
             continue;
         }
@@ -61,10 +71,12 @@ function extractBalancedBraces(src, braceStartIndex, maxLen = 8000) {
             currentIndex++;
             continue;
         }
-        if (ch === '{')
+        if (ch === '{') {
             depth++;
-        else if (ch === '}')
+        }
+        else if (ch === '}') {
             depth--;
+        }
         if (depth === 0) {
             return src.slice(braceStartIndex + 1, currentIndex);
         }
@@ -73,12 +85,15 @@ function extractBalancedBraces(src, braceStartIndex, maxLen = 8000) {
     return null;
 }
 function sanitizeTemplateLiteralText(text) {
+    // Remove interpolações `${...}` para manter apenas a parte estática.
     return text.replace(/\$\{[\s\S]*?\}/g, ' ');
 }
 function normalizeClassText(text) {
-    return String(text || '').replace(/\s+/g, ' ').trim();
+    return (text || '').replace(/\s+/g, ' ').trim();
 }
 function isTernaryExpressionText(text) {
+    // Heurística: se há um '?' e ':' no trecho do atributo, trate como branches exclusivas.
+    // Isso reduz falsos positivos de conflito entre classes mutuamente exclusivas.
     return /\?/.test(text) && /:/.test(text);
 }
 function extractStringLiterals(text) {
@@ -90,7 +105,7 @@ function extractStringLiterals(text) {
         out.push((metrica[0] ?? '').slice(1, -1));
     }
     for (const metrica of text.matchAll(/`([^`]*)`/g)) {
-        out.push(sanitizeTemplateLiteralText((metrica[1] ?? '').toString()));
+        out.push(sanitizeTemplateLiteralText((metrica[1] ?? '')));
     }
     return out;
 }
@@ -100,78 +115,97 @@ function extractClassBlocks(src) {
     const seen = new Set();
     const pushBlock = (text, line) => {
         const normalized = normalizeClassText(text);
-        if (!normalized)
+        if (!normalized) {
             return;
+        }
         const key = `${line}|${normalized}`;
-        if (seen.has(key))
+        if (seen.has(key)) {
             return;
+        }
         seen.add(key);
         blocks.push({
             text: normalized,
             line
         });
     };
+    // HTML/JSX: class="..." / className="..." (string literal)
     for (const metrica of src.matchAll(/\bclass(Name)?\s*=\s*(["'])([^"']*)\2/gi)) {
         pushBlock(metrica[3] ?? '', lineOf(metrica.index));
     }
+    // JSX: className={"..."} / className={'...'}
     for (const metrica of src.matchAll(/\bclass(Name)?\s*=\s*\{\s*(["'])([^"']*)\2\s*\}/gi)) {
         pushBlock(metrica[3] ?? '', lineOf(metrica.index));
     }
+    // JSX: className={`...${...}...`} (template literal)
     for (const metrica of src.matchAll(/\bclass(Name)?\s*=\s*\{\s*`([^`]*)`\s*\}/gi)) {
         pushBlock(sanitizeTemplateLiteralText(metrica[2] ?? ''), lineOf(metrica.index));
     }
+    // JS: const x = `...` (casos raros, mas evita perder HTML em strings)
     for (const metrica of src.matchAll(/\bclass(Name)?\s*=\s*`([^`]*)`/gi)) {
         pushBlock(sanitizeTemplateLiteralText(metrica[2] ?? ''), lineOf(metrica.index));
     }
+    // JSX: className={...} (expressões comuns: ternário, arrays/join, concat, cn(...), etc)
+    // Mais robusto que regex simples: captura expressão com chaves balanceadas.
     for (const metrica of src.matchAll(/\bclass(Name)?\s*=\s*\{/gi)) {
         const idx = metrica.index ?? -1;
-        if (idx < 0)
+        if (idx < 0) {
             continue;
-        const braceIdx = idx + (metrica[0]?.length ?? 0) - 1;
+        }
+        const braceIdx = idx + (metrica[0].length ?? 0) - 1;
         const expr = extractBalancedBraces(src, braceIdx);
-        if (!expr)
+        if (!expr) {
             continue;
+        }
         const line = lineOf(idx);
         const literals = extractStringLiterals(expr).map(string => string.trim()).filter(Boolean);
-        if (!literals.length)
+        if (!literals.length) {
             continue;
+        }
         if (isTernaryExpressionText(expr)) {
-            literals.forEach(string => pushBlock(string, line));
+            literals.forEach(string => { pushBlock(string, line); });
             continue;
         }
         pushBlock(literals.join(' '), line);
     }
+    // Astro: class:list={...}
     for (const metrica of src.matchAll(/\bclass:list\s*=\s*\{/gi)) {
         const idx = metrica.index ?? -1;
-        if (idx < 0)
+        if (idx < 0) {
             continue;
-        const braceIdx = idx + (metrica[0]?.length ?? 0) - 1;
+        }
+        const braceIdx = idx + (metrica[0].length ?? 0) - 1;
         const expr = extractBalancedBraces(src, braceIdx);
-        if (!expr)
+        if (!expr) {
             continue;
+        }
         const line = lineOf(idx);
         const literals = extractStringLiterals(expr).map(string => string.trim()).filter(Boolean);
-        if (!literals.length)
+        if (!literals.length) {
             continue;
+        }
         if (isTernaryExpressionText(expr)) {
-            literals.forEach(string => pushBlock(string, line));
+            literals.forEach(string => { pushBlock(string, line); });
             continue;
         }
         pushBlock(literals.join(' '), line);
     }
+    // JSX/TS: helpers comuns (clsx/cn/twMerge/classNames/classnames)
+    // Heurística simples (sem parser): extrai literais de string dentro da chamada.
     for (const metrica of src.matchAll(/\b(?:clsx|cn|twMerge|classNames|classnames)\s*\(([^)]*)\)/g)) {
         const args = metrica[1] ?? '';
         const literals = extractStringLiterals(args).map(string => string.trim()).filter(Boolean);
-        if (!literals.length)
+        if (!literals.length) {
             continue;
+        }
         pushBlock(literals.join(' '), lineOf(metrica.index));
     }
     return blocks;
 }
 function hasTailwindTokens(src) {
     const blocks = extractClassBlocks(src);
-    if (!blocks.length)
+    if (!blocks.length) {
         return false;
+    }
     const tokenRe = /\b(?:bg-|text-|m[trblxy]?-|p[trblxy]?-|flex|grid|gap-|space-|rounded|shadow|justify-|items-|w-|h-|min-w-|max-w-|min-h-|max-h-|inset-|top-|left-|right-|bottom-|z-|overflow-|cursor-|select-|border|ring|opacity-|font-|leading-|tracking-|transition|duration-|ease-|animate-|underline|no-underline|sr-only|not-sr-only|container)\S*/i;
     return blocks.some(base => tokenRe.test(base.text));
 }
@@ -188,54 +222,82 @@ function extractClasses(src) {
 }
 function splitVariants(token) {
     const parts = token.split(':').filter(Boolean);
-    if (parts.length <= 1)
+    if (parts.length <= 1) {
         return {
             variants: '',
             base: token
         };
+    }
     return {
         variants: parts.slice(0, -1).join(':'),
         base: parts[parts.length - 1]
     };
 }
 function propertyKey(token) {
+    // Respeita variantes (sm:, md:, dark:, hover:, etc.): conflitos só contam
+    // dentro do mesmo "contexto" de variantes.
     const { variants, base } = splitVariants(token);
-    if (/^(fa-|icon-)/.test(base))
+    // ícones/fontawesome ou tokens livres não são tratados como conflito
+    if (/^(fa-|icon-)/.test(base)) {
         return null;
+    }
+    // padding/margin: não trate px + py como conflito (são eixos diferentes)
     const padMatch = /^(p[trblxy]?)(?:-|\[)/.exec(base);
-    if (padMatch)
+    if (padMatch) {
         return `${variants}|padding:${padMatch[1]}`;
+    }
     const marMatch = /^(m[trblxy]?)(?:-|\[)/.exec(base);
-    if (marMatch)
+    if (marMatch) {
         return `${variants}|margin:${marMatch[1]}`;
+    }
     const gapMatch = /^(gap(?:-[xy])?)(?:-|\[)/.exec(base);
-    if (gapMatch)
+    if (gapMatch) {
         return `${variants}|gap:${gapMatch[1]}`;
-    if (/^space-[xy]/.test(base))
+    }
+    if (/^space-[xy]/.test(base)) {
         return `${variants}|space`;
-    if (/^(block|inline-block|inline|flex|grid|hidden)$/.test(base))
+    }
+    // display
+    if (/^(block|inline-block|inline|flex|grid|hidden)$/.test(base)) {
         return `${variants}|display`;
-    if (/^flex-(row|col)(-reverse)?$/.test(base))
+    }
+    // flex direction
+    if (/^flex-(row|col)(-reverse)?$/.test(base)) {
         return `${variants}|flex-direction`;
-    if (/^justify-/.test(base))
+    }
+    // align/justify
+    if (/^justify-/.test(base)) {
         return `${variants}|justify`;
-    if (/^items-/.test(base))
+    }
+    if (/^items-/.test(base)) {
         return `${variants}|items`;
-    if (/^rounded(?:-|\b|\[)/.test(base))
+    }
+    // border radius
+    if (/^rounded(?:-|\b|\[)/.test(base)) {
         return `${variants}|rounded`;
+    }
+    // shadow: distinguir tamanho vs cor para permitir combinações legítimas
     if (/^shadow(?:-|\b|\[)/.test(base)) {
-        if (/^shadow(?:-sm|-md|-lg|-xl|-2xl|-inner|-none)?$/.test(base))
+        // shadow, shadow-sm, shadow-md, shadow-lg, shadow-xl, shadow-2xl, shadow-inner, shadow-none
+        if (/^shadow(?:-sm|-md|-lg|-xl|-2xl|-inner|-none)?$/.test(base)) {
             return `${variants}|shadow-size`;
+        }
+        // shadow-[custom] ou shadow-color-shade (ex: shadow-black/20, shadow-gray-500)
         return `${variants}|shadow-color`;
     }
-    if (/^bg-(?!opacity-)/.test(base))
+    // background + text (separa tamanho vs cor para reduzir ruído)
+    if (/^bg-(?!opacity-)/.test(base)) {
         return `${variants}|bg-color`;
-    if (/^text-(xs|sm|base|lg|xl|\d+xl)$/.test(base))
+    }
+    if (/^text-(xs|sm|base|lg|xl|\d+xl)$/.test(base)) {
         return `${variants}|text-size`;
-    if (/^text-(black|white|transparent|current)$/.test(base))
+    }
+    if (/^text-(black|white|transparent|current)$/.test(base)) {
         return `${variants}|text-color`;
-    if (/^text-[a-z]+-\d{2,3}$/.test(base))
+    }
+    if (/^text-[a-z]+-\d{2,3}$/.test(base)) {
         return `${variants}|text-color`;
+    }
     const groups = [{
             re: /^w(?:-|\[)/,
             key: 'width'
@@ -258,7 +320,7 @@ function propertyKey(token) {
             re: /^(top|left|right|bottom)(?:-|\[)/,
             key: 'position'
         }];
-    const found = groups?.find(grupo => grupo.re.test(base));
+    const found = groups.find(grupo => grupo.re.test(base));
     return found ? `${variants}|${found.key}` : null;
 }
 function warn(message, relPath, line, nivel = messages.SeverityNiveis.warning) {
@@ -273,51 +335,63 @@ function warn(message, relPath, line, nivel = messages.SeverityNiveis.warning) {
 }
 function collectTailwindIssues(src, relPath) {
     const ocorrencias = [];
+    // Importante: conflitos devem ser detectados por bloco de classes
+    // (cada atributo class/className) e não no arquivo inteiro.
     const blocks = extractClassBlocks(src);
     for (const block of blocks) {
         const tokens = (block.text || '').split(/\s+/).filter(Boolean);
-        if (!tokens.length)
+        if (!tokens.length) {
             continue;
+        }
         const line = block.line;
         const seen = {};
         for (const token of tokens) {
             const key = propertyKey(token);
-            if (!key)
+            if (!key) {
                 continue;
-            if (!seen[key])
+            }
+            if (!seen[key]) {
                 seen[key] = [];
+            }
             seen[key].push(token);
         }
         for (const [key, list] of Object.entries(seen)) {
             const uniqTokens = [...new Set(list)];
+            // Detect duplicated exact tokens within same block (redundant classes)
             const repeats = list.filter((textoTitulo, indice) => list.indexOf(textoTitulo) !== indice);
             for (const raiz of [...new Set(repeats)]) {
                 ocorrencias.push(warn(messages.TailwindMensagens.repeatedClass(raiz), relPath, line));
             }
             if (uniqTokens.length > 1) {
+                // Mensagem: mostra a chave sem o prefixo de variantes para não poluir,
+                // mas mantém as classes originais nos exemplos.
                 const normalizedChave = key.includes('|') ? key.split('|').slice(1).join('|') : key;
                 ocorrencias.push(warn(messages.TailwindMensagens.conflictingClasses(normalizedChave, uniqTokens.slice(0, 4)), relPath, line));
+                // Detect variant conflicts for same property across multiple variants
                 const propSuffix = normalizedChave;
                 const variantsSet = new Set();
                 for (const chave of Object.keys(seen)) {
                     const parts = chave.split('|');
                     const varPart = parts.length > 1 ? parts[0] : '';
                     const propPart = parts.length > 1 ? parts.slice(1).join('|') : chave;
-                    if (propPart === propSuffix)
+                    if (propPart === propSuffix) {
                         variantsSet.add(varPart || 'base');
+                    }
                 }
                 if (variantsSet.size > 1) {
                     ocorrencias.push(warn(messages.TailwindMensagens.variantConflict(propSuffix, Array.from(variantsSet)), relPath, line, messages.SeverityNiveis.suggestion));
                 }
             }
         }
+        // Detect variant conflicts across properties even when each variant has unique token
         const propVariants = {};
         for (const chave of Object.keys(seen)) {
             const parts = chave.split('|');
             const varPart = parts.length > 1 ? parts[0] : '';
             const propPart = parts.length > 1 ? parts.slice(1).join('|') : chave;
-            if (!propVariants[propPart])
+            if (!propVariants[propPart]) {
                 propVariants[propPart] = new Set();
+            }
             propVariants[propPart].add(varPart || 'base');
         }
         for (const [prop, vset] of Object.entries(propVariants)) {
@@ -326,6 +400,7 @@ function collectTailwindIssues(src, relPath) {
             }
         }
     }
+    // Arbitrary values: sinalizar para revisão
     const safeArbitrary = /(var\()|(rgb\()|(hsl\()|(calc\()|url\(|linear-gradient|conic-gradient|radial-gradient|\d+(px|rem|em|%|vh|vw|ms|s|deg|fr)?\]|\d+\/\d+|\[--|^\d+\/\d+|\d+px|\d+rem|\d+em|\d+%|\d+deg|\d+fr/i;
     const allTokens = extractClasses(src);
     allTokens.filter(({ token }) => /\[.*\]/.test(token)).forEach(({ token, line }) => {
@@ -334,10 +409,13 @@ function collectTailwindIssues(src, relPath) {
             ocorrencias.push(warn(messages.TailwindMensagens.dangerousArbitraryValue(token), relPath, line));
             return;
         }
-        if (safeArbitrary.test(token))
+        // Evita ruído: ignore vars, cores, gradientes, calc, unidades comuns, etc.
+        if (safeArbitrary.test(token)) {
             return;
+        }
         ocorrencias.push(warn(messages.TailwindMensagens.arbitraryValue(token), relPath, line));
     });
+    // Important usage detection (e.g., 'text-red-500!')
     allTokens.filter(({ token }) => /!$/.test(token) || /!\]/.test(token)).forEach(({ token, line }) => {
         ocorrencias.push(warn(messages.TailwindMensagens.importantUsage(token), relPath, line, messages.SeverityNiveis.suggestion));
     });
@@ -349,13 +427,14 @@ export const analistaTailwind = criarAnalista({
     descricao: 'Heurísticas leves de Tailwind.',
     global: false,
     test: (relPath) => /\.(jsx|tsx|js|ts|html|astro)$/i.test(relPath),
-    aplicar: async (src, relPath) => {
-        if (disableEnv)
+    aplicar: (src, relPath) => {
+        if (disableEnv) {
             return null;
-        if (!hasTailwindTokens(src))
+        }
+        if (!hasTailwindTokens(src)) {
             return null;
+        }
         const msgs = collectTailwindIssues(src, relPath);
         return msgs.length ? msgs : null;
     }
 });
-//# sourceMappingURL=analyst-tailwind.js.map

package/dist/analysts/tailwind/analysts/index.js

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

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

@@ -1,3 +1,12 @@
+// SPDX-License-Identifier: MIT
+/**
+ * [CHAVE-INGLESA] Correções automáticas para Tailwind CSS
+ *
+ * Fornece correções sugeridas para problemas comuns em Tailwind:
+ * - Remover classes duplicadas
+ * - Consolidar classes conflitantes
+ * - Sugerir config para arbitrary values
+ */
 import { messages } from '../../../core/messages/index.js';
 import { splitLines } from '../../../shared/helpers/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
@@ -29,8 +38,9 @@ export const correctionTailwind = {
     descricao: 'Correções automáticas para problemas Tailwind',
     test: (relPath) => /\.(jsx|tsx|js|ts|html|astro)$/i.test(relPath),
     aplicar: (src, relPath) => {
-        if (!src)
+        if (!src) {
             return [];
+        }
         const correcoes = detectarCorrecoesTailwind(src, relPath);
         return correcoes.map(elem => criarOcorrencia({
             tipo: `correction-${elem.tipo}`,
@@ -42,4 +52,3 @@ export const correctionTailwind = {
         }));
     }
 };
-//# sourceMappingURL=correction-tailwind.js.map

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

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