@mocoto/mahoraga 0.14.0 → 0.14.1

package/dist/analysts/strategists/archetypes-defs.js

@@ -2,12 +2,14 @@ export const ARQUETIPOS = [{
         nome: 'cli-modular',
         descricao: 'CLI modular em TypeScript/JavaScript com comandos organizados e entrada via bin/',
         requiredDirs: ['bin'],
+        // bin/ é OBRIGATÓRIO para CLIs publicáveis
         optionalDirs: ['src/cli', 'src/cli/commands', 'src/commands', 'cli', 'cli/commands', 'src/utils', 'src/lib'],
         filePresencePatterns: ['bin/index.js', 'bin/index.ts', 'bin/cli.js', 'bin/cli.ts', 'cli.ts'],
         dependencyHints: ['commander', 'yargs', 'chalk', 'inquirer', 'ora', 'prompts'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', '.gitignore', '.prettierrc', 'eslint.config.js', '.lintstagedrc.cjs', '.lintstagedrc.mjs', 'LICENSE', 'CHANGELOG.md'],
+        // Evita colisão com bots e web apps
         forbiddenDirs: ['pages', 'prisma', 'public', 'events', 'scenes'],
-        pesoBase: 1.5
+        pesoBase: 1.5 // AUMENTADO: CLIs com bin/ são muito específicas
     }, {
         nome: 'landing-page',
         descricao: 'Aplicação web simples (frontend) com pages/ e components/',
@@ -15,7 +17,7 @@ export const ARQUETIPOS = [{
         optionalDirs: ['public', 'styles', 'utils'],
         forbiddenDirs: ['prisma', 'api', 'server'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', 'next.config.js', 'tailwind.config.js'],
-        pesoBase: 1.0
+        pesoBase: 1.0 // Mantido neutro
     }, {
         nome: 'api-rest-express',
         descricao: 'API REST em Express com controllers/ e estrutura backend',
@@ -24,26 +26,30 @@ export const ARQUETIPOS = [{
         dependencyHints: ['express', 'cors', 'helmet', 'joi', 'joi-to-swagger'],
         forbiddenDirs: ['pages', 'components', 'public'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', '.env.example', 'README.md', 'server.js'],
-        pesoBase: 1.3
+        pesoBase: 1.3 // Aumentado pois é um padrão muito específico e maduro
     }, {
         nome: 'fullstack',
         descricao: 'Aplicação fullstack (Next.js) com pages/, api/ e prisma/',
         requiredDirs: ['pages', 'api', 'prisma'],
         optionalDirs: ['components', 'lib', 'styles', 'utils', 'types'],
+        // Em projetos fullstack, normalmente não coexistem workspaces/packages na raiz
+        // pois indicam estrutura de monorepo; penalizamos quando presente.
         forbiddenDirs: ['packages', 'apps', 'server'],
         dependencyHints: ['next', 'react', 'prisma'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'next.config.js', 'tailwind.config.js'],
-        pesoBase: 1.4
+        pesoBase: 1.4 // Aumentado pois combina frontend + backend + banco
     }, {
         nome: 'bot',
         descricao: 'Bot (Discord/Telegram) com handlers de eventos e comandos específicos',
         requiredDirs: ['src/bot'],
+        // OBRIGATÓRIO ter pasta bot/
         optionalDirs: ['src/commands', 'src/events', 'src/utils', 'src/handlers'],
         filePresencePatterns: ['bot.ts', 'bot.js', 'index.ts'],
         dependencyHints: ['telegraf', 'discord.js', 'grammy', '@discordjs/builders'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', '.env.example'],
+        // Estruturas típicas de frontend/monorepo/CLI não são esperadas em bots
         forbiddenDirs: ['pages', 'prisma', 'packages', 'electron-app', 'public', 'bin', 'cli'],
-        pesoBase: 0.8
+        pesoBase: 0.8 // REDUZIDO: bots são mais simples e podem gerar false positives
     }, {
         nome: 'electron',
         descricao: 'Aplicação Electron com main process e renderer',
@@ -52,8 +58,9 @@ export const ARQUETIPOS = [{
         filePresencePatterns: ['electron.js', 'electron.ts', 'main.js'],
         dependencyHints: ['electron', 'electron-builder'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', 'electron-builder.json'],
+        // Electron não deve coexistir com pastas típicas de web fullstack/monorepo
         forbiddenDirs: ['pages', 'prisma', 'packages', 'api'],
-        pesoBase: 1.2
+        pesoBase: 1.2 // Aumentado pois tem estrutura específica
     }, {
         nome: 'lib-tsc',
         descricao: 'Biblioteca TypeScript compilada com estrutura organizada',
@@ -61,9 +68,10 @@ export const ARQUETIPOS = [{
         optionalDirs: ['src/lib', 'src/utils', 'src/types', 'examples'],
         filePresencePatterns: ['index.ts', 'lib/index.ts'],
         dependencyHints: [],
+        // Bibliotecas geralmente têm poucas deps de runtime
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', 'LICENSE', 'rollup.config.js', 'webpack.config.js'],
         forbiddenDirs: ['pages', 'api', 'prisma', 'public', 'server'],
-        pesoBase: 1.0
+        pesoBase: 1.0 // Mantido neutro
     }, {
         nome: 'monorepo-packages',
         descricao: 'Monorepo com packages/ e workspaces (pnpm/npm/yarn)',
@@ -71,8 +79,9 @@ export const ARQUETIPOS = [{
         optionalDirs: ['apps', 'tools', 'packages/shared', 'packages/core'],
         dependencyHints: [],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'turbo.json', 'pnpm-workspace.yaml', 'yarn.lock', 'pnpm-lock.yaml'],
+        // Penaliza estrutura de código na raiz em monorepos (esperado ficar em apps/ ou packages/)
         forbiddenDirs: ['src', 'pages', 'api', 'prisma', 'lib'],
-        pesoBase: 1.5
+        pesoBase: 1.5 // Aumentado pois é uma arquitetura mais complexa
     }, {
         nome: 'vue-spa',
         descricao: 'SPA Vue.js com components/, views/ e estrutura moderna',
@@ -81,7 +90,7 @@ export const ARQUETIPOS = [{
         dependencyHints: ['vue', 'vue-router', 'vuex', 'pinia', '@vue/cli-service'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', 'vue.config.js', 'vue.config.ts', 'babel.config.js', 'tailwind.config.js'],
         forbiddenDirs: ['pages', 'api', 'prisma', 'server', 'packages'],
-        pesoBase: 1.2
+        pesoBase: 1.2 // Estrutura específica mas comum
     }, {
         nome: 'clean-arch',
         descricao: 'Clean Architecture (Arquitetura Limpa) com domínio, aplicação, infraestrutura e apresentação',
@@ -91,7 +100,7 @@ export const ARQUETIPOS = [{
         dependencyHints: ['zod', 'tsyringe', 'inversify', 'awilix', 'typeorm', 'prisma', 'mongoose'],
         forbiddenDirs: ['pages', 'components', 'prisma'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', '.env.example', 'Dockerfile', 'docker-compose.yml'],
-        pesoBase: 1.5
+        pesoBase: 1.5 // Estrutura sofisticada e específica
     }, {
         nome: 'microservices',
         descricao: 'Arquitetura Distribuída em Microsserviços com boundaries e comunicação assíncrona',
@@ -101,9 +110,8 @@ export const ARQUETIPOS = [{
         dependencyHints: ['kafkajs', 'amqplib', 'ioredis', 'bull', 'bullmq', 'nats', 'grpc', '@grpc/grpc-js', 'express', 'fastify'],
         forbiddenDirs: ['pages', 'components', 'prisma'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', '.env.example', 'Dockerfile', 'docker-compose.yml', 'docker-compose.yaml', 'kubernetes', 'k8s'],
-        pesoBase: 1.6
+        pesoBase: 1.6 // Arquitetura mais complexa e distribuída
     }];
 export function normalizarCaminho(caminho) {
     return caminho.replace(/\\/g, '/');
 }
-//# sourceMappingURL=archetypes-defs.js.map

package/dist/analysts/strategists/index.js

@@ -1,4 +1,7 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Estrategistas de análise
+ */
 export * from './archetypes-defs.js';
 export * from './operator-structure.js';
 export * from './suggestions-contextuais.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/strategists/operator-structure.js

@@ -1,10 +1,16 @@
-import { detectarArquetipos, extrairSinaisAvancados, gerarPlanoEstrategico } from '../architects/index.js';
+// SPDX-License-Identifier: MIT
+// @mahoraga-disable tipo-literal-inline-complexo
+// Justificativa: tipos locais para operações de estrutura
 import { config } from '../../core/config/index.js';
 import { getMessages } from '../../core/messages/index.js';
+import { detectarArquetipos, extrairSinaisAvancados, gerarPlanoEstrategico } from '../architects/index.js';
 import { corrigirEstrutura } from '../corrections/corrector-structure.js';
 const { log, MENSAGENS_ARQUETIPOS_HANDLER } = getMessages();
 export const OperarioEstrutura = {
     async planejar(baseDir, fileEntriesComAst, opcoes) {
+        // 1) Tenta arquétipos, a menos que forçado estrategista.
+        //    Quando preset='mahoraga', evitamos arquétipos em runtime normal,
+        //    mas permitimos em testes (VITEST) para compatibilidade das suítes.
         const emTeste = !!process.env.VITEST;
         const podeUsarArquetipos = !!opcoes.preset && !opcoes.preferEstrategista && (opcoes.preset !== 'mahoraga' || emTeste);
         if (podeUsarArquetipos) {
@@ -26,13 +32,18 @@ export const OperarioEstrutura = {
             }
             catch (erro) {
                 log.aviso(MENSAGENS_ARQUETIPOS_HANDLER.falha);
-                if (config.DEV_MODE)
+                if (config.DEV_MODE) {
                     console.error(erro);
+                }
             }
         }
+        // 2) Fallback (ou preferido): estrategista
         try {
             try {
-                const sinaisAvancados = extrairSinaisAvancados(fileEntriesComAst, undefined, undefined, baseDir, fileEntriesComAst.map(arquivo => arquivo.relPath));
+                // Extrair sinais avançados para inteligência contextual
+                const sinaisAvancados = extrairSinaisAvancados(fileEntriesComAst, undefined, 
+                // packageJson - será carregado internamente se necessário
+                undefined, baseDir, fileEntriesComAst.map(arquivo => arquivo.relPath));
                 const planoAlt = await gerarPlanoEstrategico({
                     arquivos: fileEntriesComAst,
                     baseDir
@@ -42,7 +53,8 @@ export const OperarioEstrutura = {
                     ...(opcoes.preset ? {
                         preset: opcoes.preset
                     } : {})
-                }, sinaisAvancados);
+                }, sinaisAvancados // Passar sinais avançados para inteligência contextual
+                );
                 if (planoAlt && Array.isArray(planoAlt.mover)) {
                     return {
                         plano: planoAlt,
@@ -52,8 +64,9 @@ export const OperarioEstrutura = {
             }
             catch (erro) {
                 log.aviso(MENSAGENS_ARQUETIPOS_HANDLER.falhaEstrategista);
-                if (config.DEV_MODE)
+                if (config.DEV_MODE) {
                     console.error(erro);
+                }
             }
             return {
                 plano: undefined,
@@ -62,8 +75,9 @@ export const OperarioEstrutura = {
         }
         catch (erro) {
             log.aviso(MENSAGENS_ARQUETIPOS_HANDLER.falhaGeral);
-            if (config.DEV_MODE)
+            if (config.DEV_MODE) {
                 console.error(erro);
+            }
             return {
                 plano: undefined,
                 origem: 'nenhum'
@@ -71,10 +85,11 @@ export const OperarioEstrutura = {
         }
     },
     toMapaMoves(plano) {
-        if (!plano || !Array.isArray(plano.mover))
+        if (!plano || !Array.isArray(plano.mover)) {
             return [];
+        }
         return plano.mover.map((metrica) => {
-            const para = String(metrica.para || '');
+            const para = (metrica.para || '');
             const idx = para.lastIndexOf('/');
             const ideal = idx > 0 ? para.substring(0, idx) : null;
             return {
@@ -87,10 +102,12 @@ export const OperarioEstrutura = {
     async aplicar(mapaMoves, fileEntriesComAst, baseDir) {
         await corrigirEstrutura(mapaMoves, fileEntriesComAst, baseDir);
     },
+    // Auxiliar: converter ocorrências para mapa de correções (fallback)
     ocorrenciasParaMapa(ocorrencias) {
         const mapa = [];
-        if (!ocorrencias || !ocorrencias.length)
+        if (!ocorrencias?.length) {
             return mapa;
+        }
         for (const occ of ocorrencias) {
             const rel = occ.relPath ?? occ.arquivo ?? 'arquivo desconhecido';
             mapa.push({
@@ -102,4 +119,3 @@ export const OperarioEstrutura = {
         return mapa;
     }
 };
-//# sourceMappingURL=operator-structure.js.map

package/dist/analysts/strategists/suggestions-contextuais.js

@@ -1,27 +1,45 @@
-import { detectarContextoInteligente } from '../js-ts/detectors/index.js';
+// SPDX-License-Identifier: MIT
+/**
+ * Analista de Sugestões Contextuais Inteligentes
+ *
+ * Utiliza o sistema de detecção contextual para gerar sugestões específicas
+ * baseadas no tipo real de projeto detectado, considerando:
+ * - Dependências e configurações
+ * - Padrões de código específicos
+ * - Estrutura e nomenclatura
+ * - Melhores práticas por tecnologia
+ */
 import { messages } from '../../core/messages/index.js';
+import { detectarContextoInteligente } from '../js-ts/detectors/index.js';
 const log = messages.log;
 export const analistaSugestoesContextuais = {
     nome: 'sugestoes-contextuais',
     categoria: 'estrategia',
     descricao: 'Gera sugestões específicas baseadas no contexto real do projeto detectado',
     global: true,
-    async aplicar(_src, _relPath, _ast, _fullPath, contexto) {
+    // Analisa contexto global do projeto
+    aplicar(_src, _relPath, _ast, 
+    // AST node path
+    _fullPath, contexto) {
         const ocorrencias = [];
         if (!contexto) {
             return ocorrencias;
         }
         try {
+            // Obter package.json se disponível
             let packageJson;
             try {
-                const pkgArquivo = contexto.arquivos?.find(arquivo => arquivo.relPath === 'package.json');
+                const pkgArquivo = contexto.arquivos.find(arquivo => arquivo.relPath === 'package.json');
                 if (pkgArquivo?.content) {
                     packageJson = JSON.parse(pkgArquivo.content);
                 }
             }
             catch {
+                // Ignorar erros de parsing do package.json
             }
+            // Extrair estrutura de diretórios dos arquivos
             const estruturaDetectada = Array.from(new Set(contexto.arquivos.map(arquivo => arquivo.relPath.includes('/') ? arquivo.relPath.split('/')[0] : '').filter(dir => dir && dir !== '.')));
+            // Executar detecção contextual inteligente
             const resultados = detectarContextoInteligente(estruturaDetectada, contexto.arquivos, packageJson);
             if (resultados.length === 0) {
                 ocorrencias.push({
@@ -35,6 +53,7 @@ export const analistaSugestoesContextuais = {
             }
             const melhorResultado = resultados[0];
             const confiancaPercent = Math.round(melhorResultado.confiancaTotal * 100);
+            // Gerar ocorrência principal com identificação
             ocorrencias.push({
                 tipo: 'identificacao_projeto',
                 nivel: 'info',
@@ -47,7 +66,8 @@ export const analistaSugestoesContextuais = {
                     evidencias: melhorResultado.evidencias.length
                 }
             });
-            for (const sugestao of melhorResultado.sugestoesMelhoria || []) {
+            // Gerar sugestões de melhorias
+            for (const sugestao of melhorResultado.sugestoesMelhoria ?? []) {
                 ocorrencias.push({
                     tipo: 'sugestao_melhoria',
                     nivel: 'info',
@@ -60,7 +80,8 @@ export const analistaSugestoesContextuais = {
                     }
                 });
             }
-            for (const problema of melhorResultado.problemasDetectados || []) {
+            // Gerar alertas de problemas
+            for (const problema of melhorResultado.problemasDetectados ?? []) {
                 ocorrencias.push({
                     tipo: 'problema_seguranca',
                     nivel: 'aviso',
@@ -73,7 +94,8 @@ export const analistaSugestoesContextuais = {
                     }
                 });
             }
-            const evidenciasTop = melhorResultado.evidencias.filter(erro => erro.confianca > 0.8).slice(0, 5);
+            // Gerar ocorrências para evidências mais relevantes
+            const evidenciasTop = melhorResultado.evidencias.filter(erro => erro.confianca > 0.8).slice(0, 5); // Top 5 evidências
             for (const evidencia of evidenciasTop) {
                 let mensagem = '';
                 const nivel = 'info';
@@ -92,12 +114,13 @@ export const analistaSugestoesContextuais = {
                         break;
                     default:
                         continue;
+                    // Pular outros tipos menos relevantes
                 }
                 ocorrencias.push({
                     tipo: 'evidencia_contextual',
                     nivel,
                     mensagem,
-                    relPath: evidencia.localizacao || '',
+                    relPath: evidencia.localizacao ?? '',
                     linha: 0,
                     detalhes: {
                         tecnologia: melhorResultado.tecnologia,
@@ -106,6 +129,7 @@ export const analistaSugestoesContextuais = {
                     }
                 });
             }
+            // Se houver múltiplas tecnologias detectadas, mostrar alternativas
             if (resultados.length > 1) {
                 const alternativas = resultados.slice(1, 3).map(raiz => `${raiz.tecnologia} (${Math.round(raiz.confiancaTotal * 100)}%)`).join(', ');
                 ocorrencias.push({
@@ -133,4 +157,3 @@ export const analistaSugestoesContextuais = {
         return ocorrencias;
     }
 };
-//# sourceMappingURL=suggestions-contextuais.js.map

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

@@ -8,20 +8,22 @@ export function registrarDetectorSvg(detector) {
 export function obterDetectoresSvg() {
     return [...detectoresRegistrados];
 }
-const disableEnv = process.env.MAHORAGA_DISABLE_PLUGIN_SVG === '1';
+const disableEnv = process.env.SUKUNA_DISABLE_PLUGIN_SVG === '1';
 function findLine(src, index = 0) {
     const safeIndex = Math.max(0, index);
     let line = 1;
     for (let indice = 0; indice < safeIndex && indice < src.length; indice++) {
-        if (src.charCodeAt(indice) === 10)
+        if (src.charCodeAt(indice) === 10) {
             line++;
+        }
     }
     return line;
 }
 function findFirstMatchLine(src, re, fallbackLine = 1) {
     const idx = src.search(re);
-    if (idx < 0)
+    if (idx < 0) {
         return fallbackLine;
+    }
     return findLine(src, idx);
 }
 function msg(message, relPath, nivel = messages.SeverityNiveis.warning, line = 1) {
@@ -41,8 +43,9 @@ export const analistaSvg = criarAnalista({
     global: false,
     test: (relPath) => /\.svg$/i.test(relPath),
     aplicar: async (src, relPath) => {
-        if (disableEnv)
+        if (disableEnv) {
             return null;
+        }
         const ocorrencias = [];
         if (!/<svg\b/i.test(src)) {
             ocorrencias.push(msg(messages.SvgMensagens.naoPareceSvg, relPath, messages.SeverityNiveis.warning, 1));
@@ -53,6 +56,7 @@ export const analistaSvg = criarAnalista({
         const opt = otimizarSvgLikeSvgo({
             svg: src
         });
+        // Segurança
         for (const dimensaoLargura of opt.warnings) {
             if (dimensaoLargura === 'script-inline') {
                 const line = findFirstMatchLine(src, /<script\b/i, linhaSvg);
@@ -67,21 +71,24 @@ export const analistaSvg = criarAnalista({
                 ocorrencias.push(msg(messages.SvgMensagens.javascriptUrl, relPath, messages.SeverityNiveis.error, line));
             }
         }
+        // Boas práticas
         if (!/\bviewBox\s*=\s*['"][^'"]+['"]/i.test(src)) {
             ocorrencias.push(msg(messages.SvgMensagens.semViewBox, relPath, messages.SeverityNiveis.info, linhaSvg));
         }
+        // Otimização (diferença de bytes)
         if (opt.changed && opt.originalBytes > opt.optimizedBytes && shouldSugerirOtimizacaoSvg(opt.originalBytes, opt.optimizedBytes)) {
             ocorrencias.push(msg(messages.SvgMensagens.podeOtimizar(opt.originalBytes, opt.optimizedBytes, opt.mudancas), relPath, messages.SeverityNiveis.info, linhaSvg));
         }
+        // Plugins registrados
         for (const detector of detectoresRegistrados) {
             try {
                 const result = await Promise.resolve(detector.testar(src, relPath));
                 ocorrencias.push(...result);
             }
             catch {
+                // Ignora erros de plugins
             }
         }
         return ocorrencias.length ? ocorrencias : null;
     }
 });
-//# sourceMappingURL=analyst-svg.js.map

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

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

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

@@ -1,3 +1,12 @@
+// SPDX-License-Identifier: MIT
+/**
+* [CHAVE-INGLESA] Correções automáticas para SVG
+*
+* Fornece correções sugeridas para problemas comuns em SVG:
+* - Add viewBox
+* - Remove scripts
+* - Remove event handlers
+*/
 import { messages } from '../../../core/messages/index.js';
 import { splitLines } from '../../../shared/helpers/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
@@ -58,8 +67,9 @@ export const correctionSvg = {
     descricao: 'Correções automáticas para SVG',
     test: (relPath) => /\.svg$/i.test(relPath),
     aplicar: (src, relPath) => {
-        if (!src)
+        if (!src) {
             return [];
+        }
         const correcoes = detectarCorrecoesSvg(src, relPath);
         return correcoes.map(elem => criarOcorrencia({
             tipo: `correction-${elem.tipo}`,
@@ -71,4 +81,3 @@ export const correctionSvg = {
         }));
     }
 };
-//# sourceMappingURL=correction-svg.js.map

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

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

package/dist/analysts/svg/detectors/detector-svg-security.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { messages } from '../../../core/messages/index.js';
 import { splitLines } from '../../../shared/helpers/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
@@ -5,11 +6,12 @@ function makeMsg(tipo, nivel, mensagem, relPath, linha, sugestao) {
     return criarOcorrencia({ tipo, nivel, mensagem, relPath, linha, sugestao });
 }
 function tagCount(src, tag) {
-    return (src.match(tag) || []).length;
+    return (src.match(tag) ?? []).length;
 }
 export function detectarSegurancaSvg(src, relPath) {
-    if (!src)
+    if (!src) {
         return [];
+    }
     const ocorrencias = [];
     const linhas = splitLines(src);
     if (!/<svg\b/i.test(src)) {
@@ -19,21 +21,26 @@ export function detectarSegurancaSvg(src, relPath) {
     const svgOpenTagMatch = src.match(/<svg\b([^>]*)>/i);
     const svgOpenTagLine = svgOpenTagMatch
         ? (() => { let l = 1; for (let i = 0; i < src.indexOf(svgOpenTagMatch[0]); i++) {
-            if (src[i] === '\n')
+            if (src[i] === '\n') {
                 l++;
+            }
         } return l; })()
         : 1;
+    // Detecta xmlns
     if (!/xmlns\s*=/i.test(src)) {
         ocorrencias.push(makeMsg('svg-missing-xmlns', 'aviso', messages.DetectorSvgMensagens.missingXmlNs, relPath, svgOpenTagLine, messages.DetectorSvgMensagens.missingXmlNsSugestao));
     }
+    // Detecta viewBox
     const hasViewBox = /\bviewBox\s*=\s*['"][^'"]+['"]/i.test(src);
     if (!hasViewBox) {
         ocorrencias.push(makeMsg('svg-missing-viewbox', 'info', messages.DetectorSvgMensagens.missingViewBox, relPath, svgOpenTagLine, messages.DetectorSvgMensagens.missingViewBoxSugestao));
         ocorrencias.push(makeMsg('svg-missing-responsive-viewbox', 'info', messages.DetectorSvgMensagens.missingResponsiveViewBox, relPath, svgOpenTagLine, messages.DetectorSvgMensagens.missingResponsiveViewBoxSugestao));
     }
+    // Detecta width/height
     if (!/\bwidth\s*=\s*['"]\d+['"]/i.test(src) || !/\bheight\s*=\s*['"]\d+['"]/i.test(src)) {
         ocorrencias.push(makeMsg('svg-missing-dimensions', 'info', messages.DetectorSvgMensagens.missingDimensions, relPath, svgOpenTagLine, messages.DetectorSvgMensagens.missingDimensionsSugestao));
     }
+    // Verifica viewBox oversized
     const vbMatch = src.match(/viewBox\s*=\s*['"]\s*([^'"]+)['"]/i);
     if (vbMatch) {
         const parts = vbMatch[1].trim().split(/\s+/).map(Number);
@@ -41,13 +48,16 @@ export function detectarSegurancaSvg(src, relPath) {
             ocorrencias.push(makeMsg('svg-oversized-viewbox', 'info', messages.DetectorSvgMensagens.oversizedViewBox, relPath, svgOpenTagLine, messages.DetectorSvgMensagens.oversizedViewBoxSugestao));
         }
     }
+    // Performance: oversized (>50KB heuristic)
     if (src.length > 51200) {
         ocorrencias.push(makeMsg('svg-oversized', 'info', messages.DetectorSvgMensagens.oversizedSvg, relPath, 1, messages.DetectorSvgMensagens.oversizedSvgSugestao));
     }
+    // Performance: too many elements
     const elementCount = tagCount(src, /<[a-zA-Z]/g);
     if (elementCount > 500) {
         ocorrencias.push(makeMsg('svg-too-many-elements', 'info', messages.DetectorSvgMensagens.tooManyElements, relPath, 1, messages.DetectorSvgMensagens.tooManyElementsSugestao));
     }
+    // Performance: complex path data
     const pathData = src.match(/d\s*=\s*['"]([^'"]+)['"]/gi);
     if (pathData) {
         const totalPathLength = pathData.reduce((sum, p) => sum + p.length, 0);
@@ -55,18 +65,23 @@ export function detectarSegurancaSvg(src, relPath) {
             ocorrencias.push(makeMsg('svg-complex-path-data', 'info', messages.DetectorSvgMensagens.complexPathData, relPath, 1, messages.DetectorSvgMensagens.complexPathDataSugestao));
         }
     }
+    // Performance: embedded base64 images
     if (/data:image\/(svg\+xml|png|jpeg|gif|webp);base64/i.test(src)) {
         ocorrencias.push(makeMsg('svg-embedded-base64', 'aviso', messages.DetectorSvgMensagens.embeddedBase64, relPath, 1, messages.DetectorSvgMensagens.embeddedBase64Sugestao));
     }
+    // Accessibility: missing role="img"
     if (!/role\s*=\s*['"]img['"]/i.test(src)) {
         ocorrencias.push(makeMsg('svg-missing-role-img', 'aviso', messages.DetectorSvgMensagens.missingRoleImg, relPath, svgOpenTagLine, messages.DetectorSvgMensagens.missingRoleImgSugestao));
     }
+    // Accessibility: missing aria-label
     if (!/aria-label\s*=/i.test(src) && !/<title>/i.test(src) && !/<desc>/i.test(src)) {
         ocorrencias.push(makeMsg('svg-missing-aria-label', 'aviso', messages.DetectorSvgMensagens.missingAriaLabel, relPath, svgOpenTagLine, messages.DetectorSvgMensagens.missingAriaLabelSugestao));
     }
+    // Accessibility: missing title/desc
     if (!/<title>/i.test(src) || !/<desc>/i.test(src)) {
         ocorrencias.push(makeMsg('svg-missing-title-desc', 'info', messages.DetectorSvgMensagens.missingTitleDesc, relPath, svgOpenTagLine, messages.DetectorSvgMensagens.missingTitleDescSugestao));
     }
+    // Security: inline scripts
     linhas.forEach((linha, index) => {
         const nLinha = index + 1;
         if (/<script\b/i.test(linha)) {
@@ -74,6 +89,7 @@ export function detectarSegurancaSvg(src, relPath) {
             ocorrencias.push(makeMsg('svg-script-tag', 'erro', messages.DetectorSvgMensagens.scriptTagInSvg, relPath, nLinha, messages.DetectorSvgMensagens.scriptTagInSvgSugestao));
         }
     });
+    // Security: inline event handlers
     linhas.forEach((linha, index) => {
         const nLinha = index + 1;
         if (/\son\w+\s*=\s*['"]/i.test(linha)) {
@@ -81,15 +97,18 @@ export function detectarSegurancaSvg(src, relPath) {
             ocorrencias.push(makeMsg('svg-inline-event-handlers', 'aviso', messages.DetectorSvgMensagens.inlineEventHandlers, relPath, nLinha, messages.DetectorSvgMensagens.inlineEventHandlersSugestao));
         }
     });
+    // Security: javascript: URLs
     linhas.forEach((linha, index) => {
         const nLinha = index + 1;
         if (/javascript\s*:/i.test(linha)) {
             ocorrencias.push(makeMsg('svg-javascript-url', 'erro', messages.DetectorSvgMensagens.javascriptUrl, relPath, nLinha, messages.DetectorSvgMensagens.javascriptUrlSugestao));
         }
     });
+    // Security: external entity references (XXE)
     if (/<!ENTITY\s/i.test(src) || /<!DOCTYPE\s/i.test(src)) {
         ocorrencias.push(makeMsg('svg-external-entity-ref', 'erro', messages.DetectorSvgMensagens.externalEntityRef, relPath, 1, messages.DetectorSvgMensagens.externalEntityRefSugestao));
     }
+    // Security: dangerous attributes (xlink:href with javascript, etc.)
     linhas.forEach((linha, index) => {
         const nLinha = index + 1;
         if (/xlink:href\s*=\s*['"]\s*javascript\s*:/i.test(linha) ||
@@ -98,6 +117,7 @@ export function detectarSegurancaSvg(src, relPath) {
             ocorrencias.push(makeMsg('svg-dangerous-attributes', 'erro', messages.DetectorSvgMensagens.dangerousAttributes, relPath, nLinha, messages.DetectorSvgMensagens.dangerousAttributesSugestao));
         }
     });
+    // Security: CSS injection via <style> with external URLs
     const styleBlocks = src.match(/<style[^>]*>([\s\S]*?)<\/style>/gi);
     if (styleBlocks) {
         for (const block of styleBlocks) {
@@ -107,46 +127,55 @@ export function detectarSegurancaSvg(src, relPath) {
             }
         }
     }
+    // Security: use[href] without proper validation
     linhas.forEach((linha, index) => {
         const nLinha = index + 1;
         if (/<use\b[^>]*>/i.test(linha) && !/href\s*=\s*['"]/i.test(linha)) {
             ocorrencias.push(makeMsg('svg-use-without-href', 'aviso', messages.DetectorSvgMensagens.useWithoutHref, relPath, nLinha, messages.DetectorSvgMensagens.useWithoutHrefSugestao));
         }
     });
+    // Security: href without rel
     linhas.forEach((linha, index) => {
         const nLinha = index + 1;
         if (/<a\b/i.test(linha) && /href\s*=\s*['"]https?:\/\//i.test(linha) && !/rel\s*=/i.test(linha)) {
             ocorrencias.push(makeMsg('svg-href-without-rel', 'info', messages.DetectorSvgMensagens.hrefWithoutRel, relPath, nLinha, messages.DetectorSvgMensagens.hrefWithoutRelSugestao));
         }
     });
+    // Structure: nested <svg>
     if (tagCount(src, /<svg\b/gi) > 1) {
         ocorrencias.push(makeMsg('svg-nested-svg', 'aviso', messages.DetectorSvgMensagens.nestedSvg, relPath, svgOpenTagLine, messages.DetectorSvgMensagens.nestedSvgSugestao));
     }
+    // Structure: deprecated SVG attributes
     linhas.forEach((linha, index) => {
         const nLinha = index + 1;
         if (/\bversion\s*=\s*['"]/.test(linha) || /\bbaseProfile\s*=\s*['"]/.test(linha)) {
             ocorrencias.push(makeMsg('svg-deprecated-attributes', 'info', messages.DetectorSvgMensagens.deprecatedSvgAttributes, relPath, nLinha, messages.DetectorSvgMensagens.deprecatedSvgAttributesSugestao));
         }
     });
+    // Structure: missing stroke-width on visible strokes
     linhas.forEach((linha, index) => {
         const nLinha = index + 1;
         if (/\bstroke\s*=\s*['"]/i.test(linha) && !/\bstroke-width\s*=/i.test(linha) && !/<svg\b/i.test(linha)) {
             ocorrencias.push(makeMsg('svg-missing-stroke-width', 'info', messages.DetectorSvgMensagens.missingStrokeWidth, relPath, nLinha, messages.DetectorSvgMensagens.missingStrokeWidthSugestao));
         }
     });
+    // Structure: fill="none" on transparent backgrounds
     linhas.forEach((linha, index) => {
         const nLinha = index + 1;
         if (/\bfill\s*=\s*['"]none['"]/i.test(linha) && !/\bstroke\s*=/i.test(linha)) {
             ocorrencias.push(makeMsg('svg-fill-none-on-transparent', 'info', messages.DetectorSvgMensagens.fillNoneOnTransparent, relPath, nLinha, messages.DetectorSvgMensagens.fillNoneOnTransparentSugestao));
         }
     });
+    // Structure: text that should be converted to path
     if (/<text\b/i.test(src)) {
         ocorrencias.push(makeMsg('svg-text-not-converted-to-path', 'info', messages.DetectorSvgMensagens.textNotConvertedToPath, relPath, 1, messages.DetectorSvgMensagens.textNotConvertedToPathSugestao));
     }
+    // Animation without prefers-reduced-motion
     if (/(<animate\b|<animateTransform\b|<animateMotion\b)/i.test(src) &&
         !/prefers-reduced-motion/i.test(src)) {
         ocorrencias.push(makeMsg('svg-animation-without-reduced-motion', 'aviso', messages.DetectorSvgMensagens.animationWithoutReduceMotion, relPath, 1, messages.DetectorSvgMensagens.animationWithoutReduceMotionSugestao));
     }
+    // Missing sanitizer suggestion
     ocorrencias.push(makeMsg('svg-missing-sanitizer', 'info', messages.DetectorSvgMensagens.missingSvgSanitizer, relPath, 1, messages.DetectorSvgMensagens.missingSvgSanitizerSugestao));
     return ocorrencias;
 }
@@ -159,4 +188,3 @@ export const detectorSvgSecurity = {
         return detectarSegurancaSvg(src, relPath);
     }
 };
-//# sourceMappingURL=detector-svg-security.js.map

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

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