@mocoto/mahoraga 0.14.7 → 0.14.9

package/dist/reports/structure.js

@@ -1,5 +1 @@
-// SPDX-License-Identifier: MIT
-/**
- * Tipos para relatórios de estrutura
- */
 export {};

package/dist/scripts/index.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT export type { AliasRule } from 'migrar-aliases.jsmigrar-aliases.js';
 export * from './migrar-aliases.js';

package/dist/scripts/migrar-aliases.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export {};

package/dist/shared/context-project.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * Detecta o contexto de um arquivo/projeto para análise inteligente
- */
 export function detectarContextoProjeto(opcoes) {
     const { arquivo, conteudo, relPath, packageJson } = opcoes;
     const caminho = arquivo.replace(/\\/g, '/').toLowerCase();
@@ -17,7 +13,6 @@ export function detectarContextoProjeto(opcoes) {
         frameworks: [],
         linguagens: []
     };
-    // Detecta linguagens
     if (/\.(ts|tsx)$/.test(caminho)) {
         contexto.linguagens.push('typescript');
     }
@@ -36,12 +31,10 @@ export function detectarContextoProjeto(opcoes) {
     if (/\.(css)$/.test(caminho)) {
         contexto.linguagens.push('css');
     }
-    // Detecta se é arquivo de teste (PRIORIDADE ALTA - deve ser verificado primeiro)
     const isTestPath = /(^|\/)tests?(\/|\.)/i.test(rel) || /\.(test|spec)\.(ts|js|tsx|jsx)$/i.test(caminho) || /__tests__/.test(rel);
     const belongsToTestExt = /\.(ts|js|tsx|jsx)$/i.test(caminho);
     const hasTestContent = belongsToTestExt && (/^(describe|it|test|expect)\s*\(/m.test(conteudo) || /\.(it|test|describe|expect)\s*\(/m.test(conteudo));
     contexto.isTest = isTestPath || hasTestContent;
-    // Se é arquivo de teste, não deve ser classificado como outros tipos
     if (contexto.isTest) {
         return {
             ...contexto,
@@ -51,16 +44,11 @@ export function detectarContextoProjeto(opcoes) {
             isLibrary: false
         };
     }
-    // Detecta se é arquivo de configuração
-    contexto.isConfiguracao = /config|\.config\.|\.rc\.|\.json$|\.yaml$|\.yml$|\.env/.test(caminho) || /(^|\/)(\.|config|configs?)(\/|\.)/i.test(rel) || /package\.json|tsconfig|eslint|prettier|vitest|jest|babel/.test(caminho) || /stub|mock|fixture|example/i.test(caminho); // Inclui stubs e mocks
-    // Detecta se é arquivo de infraestrutura (setup, main, index)
+    contexto.isConfiguracao = /config|\.config\.|\.rc\.|\.json$|\.yaml$|\.yml$|\.env/.test(caminho) || /(^|\/)(\.|config|configs?)(\/|\.)/i.test(rel) || /package\.json|tsconfig|eslint|prettier|vitest|jest|babel/.test(caminho) || /stub|mock|fixture|example/i.test(caminho);
     contexto.isInfrastructure = /index\.|main\.|app\.|server\.|setup\.|bootstrap/.test(caminho) || /(client\.login|client\.connect|createApp|express\(\)|listen\(|server\.start)/.test(conteudo) || /export\s+default|module\.exports\s*=/.test(conteudo) || /(guardian|sentinela|verificador|hash|diff|baseline)/i.test(caminho) ||
-        // Guardian e verificação
-        /(monitor|watch|observer|scanner)/i.test(caminho); // Monitoring
-    // Detecta frameworks por imports/requires
+        /(monitor|watch|observer|scanner)/i.test(caminho);
     const importMatches = conteudo.match(/import.*from.*['"`]([^'"`]+)['"`]|require\(['"`]([^'"`]+)['"`]\)/g) ?? [];
     const allImports = importMatches.join(' ').toLowerCase();
-    // Frameworks de bot
     if (/discord\.js|@discordjs|eris/.test(allImports)) {
         contexto.frameworks.push('discord.js');
         contexto.isBot = true;
@@ -69,7 +57,6 @@ export function detectarContextoProjeto(opcoes) {
         contexto.frameworks.push('telegraf');
         contexto.isBot = true;
     }
-    // Frameworks CLI
     if (/commander|yargs|inquirer|chalk|ora/.test(allImports)) {
         contexto.frameworks.push('cli');
         contexto.isCLI = true;
@@ -78,7 +65,6 @@ export function detectarContextoProjeto(opcoes) {
         contexto.frameworks.push('oclif');
         contexto.isCLI = true;
     }
-    // Frameworks web
     if (/express|fastify|koa|hapi/.test(allImports)) {
         contexto.frameworks.push('backend');
         contexto.isWebApp = true;
@@ -91,28 +77,22 @@ export function detectarContextoProjeto(opcoes) {
         contexto.frameworks.push('fullstack');
         contexto.isWebApp = true;
     }
-    // Detecta por conteúdo específico se imports não cobrirem
     if (!contexto.isBot && /slash.*command|interaction\.|commandName|client\.on.*message/i.test(conteudo)) {
         contexto.isBot = true;
     }
     if (!contexto.isCLI && /process\.argv|command.*line|\.option\(|\.command\(/i.test(conteudo)) {
         contexto.isCLI = true;
     }
-    // Detecta se é arquivo de infraestrutura por conteúdo (NÃO é comando)
     if (/export\s+(interface|type|class.*\{)/i.test(conteudo) || /import.*types?.*from|export.*types?/i.test(conteudo) || /function\s+format|function\s+display|function\s+render/i.test(conteudo) || /console\.log|logger\.|\.write\(|\.render\(/i.test(conteudo)) {
         contexto.isInfrastructure = true;
     }
-    // Detecta se é biblioteca por estrutura de exports
     if (/export\s+(class|function|const|interface|type)|module\.exports/.test(conteudo) && !contexto.isWebApp && !contexto.isBot && !contexto.isCLI) {
         contexto.isLibrary = true;
     }
-    // Detecta por path patterns (mais específico)
     if (/(^|\/)bot(\/|\.|-)|discord|telegram/.test(rel)) {
         contexto.isBot = true;
     }
-    // CLI paths - mais específico para evitar falsos positivos
     if (/(^|\/)(cli|commands?|comandos?)(\/|\.|-)|bin\//.test(rel)) {
-        // Mas não se for apenas processamento, display, options, ou utilitários
         if (!/\/(processing|display|options|utils|helpers|types|interfaces)\//.test(rel) && !/\/(options|display|processing|filter|helper|util|type)\./.test(rel) && !/(options|processing|display|filter|helper|util|types?)[-.]/.test(caminho)) {
             contexto.isCLI = true;
         }
@@ -123,7 +103,6 @@ export function detectarContextoProjeto(opcoes) {
     if (packageJson) {
         detectarFrameworksPackageJson(packageJson, contexto);
     }
-    // Remove duplicatas
     contexto.frameworks = [...new Set(contexto.frameworks)];
     contexto.linguagens = [...new Set(contexto.linguagens)];
     return contexto;
@@ -151,18 +130,13 @@ function detectarFrameworksPackageJson(packageJson, contexto) {
         }
     }
 }
-/**
- * Verifica se um arquivo é relevante para um tipo específico de análise
- */
 export function isRelevanteParaAnalise(contexto, tipoAnalise) {
-    // Nunca analise arquivos de teste, config ou infraestrutura para padrões específicos
     if (contexto.isTest || contexto.isConfiguracao || contexto.isInfrastructure) {
         return false;
     }
     switch (tipoAnalise) {
         case 'comando':
         case 'bot':
-            // Para análise de comando, deve ser bot/CLI E não ser infraestrutura
             return (contexto.isBot || contexto.isCLI) && !contexto.isInfrastructure;
         case 'cli':
             return contexto.isCLI && !contexto.isInfrastructure;
@@ -174,9 +148,6 @@ export function isRelevanteParaAnalise(contexto, tipoAnalise) {
             return true;
     }
 }
-/**
- * Sugere frameworks baseado no contexto detectado
- */
 export function sugerirFrameworks(contexto) {
     const sugestoes = [];
     if (contexto.isBot && !contexto.frameworks.some((arquivo) => arquivo.includes('discord') || arquivo.includes('telegraf'))) {
@@ -187,9 +158,6 @@ export function sugerirFrameworks(contexto) {
     }
     return sugestoes;
 }
-/**
-* Verifica se um caminho de arquivo pertence ao contexto de documentação.
-*/
 export function isContextoDocumentacao(relPath) {
     const arquivosDoc = ['readme', 'doc/', 'docs/', '.md', '.example', '.sample', '.template', 'third-party-notices', 'license', 'changelog'];
     const pathLower = relPath.toLowerCase();

package/dist/shared/data-processing/fragment-report.js

@@ -1,5 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import path from 'node:path';
 import { gzipSync } from 'node:zlib';
 import { config } from '../../core/config/index.js';
@@ -15,19 +13,16 @@ export async function fragmentarRelatorio(relatorioFull, dir, ts, options) {
     const maxOcorrencias = options?.maxOcorrenciasPerShard ?? config.REPORT_FRAGMENT_OCCURRENCES;
     const maxArquivoEntries = options?.maxFileEntriesPerShard ?? config.REPORT_FRAGMENT_FILEENTRIES;
     const topN = config.REPORT_FRAGMENT_SUMMARY_TOPN;
-    // Normaliza a estrutura esperada
     const rel = relatorioFull;
     const resultado = 'resultado' in rel ? rel.resultado : rel;
     const ocorrencias = Array.isArray((resultado).ocorrencias) ? (resultado).ocorrencias : [];
     const fileEntries = Array.isArray((resultado).fileEntries) ? (resultado).fileEntries : [];
     const salvar = salvarEstado;
-    // Manifest que descreve as partes geradas
     const manifest = {
         generatedAt: new Date().toISOString(),
         baseNome: `mahoraga-relatorio-full-${ts}`,
         parts: []
     };
-    // Salva meta (tudo exceto ocorrencias/fileEntries)
     const meta = {
         ...rel
     };
@@ -45,7 +40,6 @@ export async function fragmentarRelatorio(relatorioFull, dir, ts, options) {
         file: metaFilename,
         bytes: metaGz.length
     });
-    // Fragmenta ocorrencias se necessário
     if (ocorrencias.length > 0) {
         const occPedacos = chunkArray(ocorrencias, maxOcorrencias);
         for (let indice = 0; indice < occPedacos.length; indice++) {
@@ -62,11 +56,9 @@ export async function fragmentarRelatorio(relatorioFull, dir, ts, options) {
             const buf = Buffer.from(JSON.stringify(payload, null, 2), 'utf-8');
             const gz = gzipSync(buf);
             await salvarBinario(path.join(dir, fname), gz);
-            // Gerar resumo por shard: top tipos e top arquivos (relPath)
             const tiposContagem = {};
             const arquivosContagem = {};
             for (const ocorrencia of occPedacos[indice]) {
-                // Suporta formatos legados com 'type' e 'path' para compatibilidade
                 const oLegacy = ocorrencia;
                 const tipoOcorrencia = ocorrencia.tipo ?? oLegacy.type ?? 'desconhecido';
                 tiposContagem[tipoOcorrencia] = (tiposContagem[tipoOcorrencia] || 0) + 1;
@@ -95,7 +87,6 @@ export async function fragmentarRelatorio(relatorioFull, dir, ts, options) {
             });
         }
     }
-    // Fragmenta fileEntries (ASTs) se necessário
     if (fileEntries.length > 0) {
         const fePedacos = chunkArray(fileEntries, maxArquivoEntries);
         for (let indice = 0; indice < fePedacos.length; indice++) {
@@ -112,10 +103,8 @@ export async function fragmentarRelatorio(relatorioFull, dir, ts, options) {
             const buf = Buffer.from(JSON.stringify(payload, null, 2), 'utf-8');
             const gz = gzipSync(buf);
             await salvarBinario(path.join(dir, fname), gz);
-            // Resumo por shard de fileEntries: top arquivos por tamanho (linhas) quando possível
             const arquivosResumo = [];
             for (const fe of fePedacos[indice]) {
-                // Suporta formato legado com 'path' para compatibilidade
                 const feLegacy = fe;
                 const rel = fe.relPath ?? fe.fullCaminho ?? feLegacy.path ?? 'desconhecido';
                 let linhas = undefined;
@@ -124,7 +113,7 @@ export async function fragmentarRelatorio(relatorioFull, dir, ts, options) {
                         linhas = fe.content.split(/\r?\n/).length;
                     }
                 }
-                catch { /* ignore */ }
+                catch { }
                 arquivosResumo.push({
                     arquivo: rel,
                     linhas
@@ -144,7 +133,6 @@ export async function fragmentarRelatorio(relatorioFull, dir, ts, options) {
             });
         }
     }
-    // Salva o manifest final
     const manifestFilename = `mahoraga-relatorio-full-${ts}-manifest.json`;
     await salvar(path.join(dir, manifestFilename), manifest);
     return {

package/dist/shared/data-processing/index.js

@@ -1,7 +1,3 @@
-/**
- * Módulo de processamento de dados
- * Fornece utilitários para transformação e análise de dados
- */
 export * from './data-processing-stub.js';
 export * from './fragment-report.js';
 export * from './json.js';

package/dist/shared/data-processing/json.js

@@ -1,14 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
-/**
- * Utilidades de JSON: escape Unicode e stringificação segura para consumidores legados.
- *
- * Regras:
- * - Converte qualquer caractere fora do ASCII básico em sequências \uXXXX.
- * - Para caracteres fora do BMP, emite pares substitutos (dois \uXXXX).
- * - Mantém caracteres ASCII intactos.
- */
-// Constantes Unicode e BMP
 const ASCII_MAX = 0x7f;
 const BMP_MAX = 0xffff;
 const SUPPLEMENTARY_PLANO_DESLOCAMENTO = 0x10000;
@@ -18,9 +7,6 @@ const SURROGATE_DESLOCAMENTO = 10;
 const SURROGATE_MASCARA = 0x3ff;
 const HEX_PAD_LENGTH = 4;
 const JSON_INDENTACAO_PADRAO = 2;
-/**
- * Escapa caracteres não-ASCII para sequências \uXXXX, incluindo pares substitutos.
- */
 export function escapeNonAscii(string) {
     let out = '';
     for (const ch of string) {
@@ -32,7 +18,6 @@ export function escapeNonAscii(string) {
             out += `\\u${cp.toString(16).padStart(HEX_PAD_LENGTH, '0')}`;
         }
         else {
-            // caracteres fora do BMP -> pares substitutos
             const codePointOffset = cp - SUPPLEMENTARY_PLANO_DESLOCAMENTO;
             const highSurrogate = HIGH_SURROGATE_BASE + (codePointOffset >> SURROGATE_DESLOCAMENTO);
             const lowSurrogate = LOW_SURROGATE_BASE + (codePointOffset & SURROGATE_MASCARA);
@@ -42,52 +27,34 @@ export function escapeNonAscii(string) {
     }
     return out;
 }
-/**
- * Stringifica um objeto em JSON aplicando escapeNonAscii em todos os strings do objeto.
- * Normaliza possíveis double-escapes ("\\uXXXX" -> "\uXXXX").
- */
-/**
- * Converte uma string JSON (já gerada) em uma versão ASCII-only
- * substituindo todos os codepoints >= 0x80 por \uXXXX (pares substitutos
- * para codepoints fora do BMP).
- */
 export function escapeJsonAscii(raw) {
     let out = '';
     for (let indice = 0; indice < raw.length; indice++) {
         const cp = raw.codePointAt(indice) ?? raw.charCodeAt(indice);
         if (cp <= ASCII_MAX) {
-            // Escapar caracteres de controle JSON obrigatórios
             switch (cp) {
                 case 0x08:
                     out += '\\b';
                     break;
-                // backspace
                 case 0x09:
                     out += '\\t';
                     break;
-                // tab
                 case 0x0A:
                     out += '\\n';
                     break;
-                // newline
                 case 0x0C:
                     out += '\\f';
                     break;
-                // form feed
                 case 0x0D:
                     out += '\\r';
                     break;
-                // carriage return
                 case 0x22:
                     out += '\\"';
                     break;
-                // double quote
                 case 0x5C:
                     out += '\\\\';
                     break;
-                // backslash
                 default:
-                    // Outros caracteres de controle (0x00-0x1F) escapados como \u00XX
                     if (cp < 0x20) {
                         out += `\\u${cp.toString(16).padStart(HEX_PAD_LENGTH, '0')}`;
                     }
@@ -101,22 +68,15 @@ export function escapeJsonAscii(raw) {
             out += `\\u${cp.toString(16).padStart(HEX_PAD_LENGTH, '0')}`;
         }
         else {
-            // fora do BMP: gerar pares substitutos
             const codePointOffset = cp - SUPPLEMENTARY_PLANO_DESLOCAMENTO;
             const highSurrogate = HIGH_SURROGATE_BASE + (codePointOffset >> SURROGATE_DESLOCAMENTO);
             const lowSurrogate = LOW_SURROGATE_BASE + (codePointOffset & SURROGATE_MASCARA);
             out += `\\u${highSurrogate.toString(16).padStart(HEX_PAD_LENGTH, '0')}\\u${lowSurrogate.toString(16).padStart(HEX_PAD_LENGTH, '0')}`;
-            // pular o segundo code unit já consumido pelo codePointAt
             indice++;
         }
     }
     return out;
 }
-/**
- * Stringifica um objeto em JSON. Por padrão emite UTF-8 (legível). Se
- * options.asciiOnly for true, converte o JSON resultante em ASCII-only
- * substituindo caracteres > 0x7F por \uXXXX.
- */
 export function stringifyJsonEscaped(value, space = JSON_INDENTACAO_PADRAO, options) {
     const raw = JSON.stringify(value, null, space);
     if (options?.asciiOnly) {

package/dist/shared/data-processing/occurrences.js

@@ -1,14 +1,7 @@
-// SPDX-License-Identifier: MIT
-/**
- * Helpers utilitários para manipulação de ocorrências e métricas de analistas.
- *
- * Observação: centralizados conforme diretriz de helpers em src/shared/.
- */
-/**
- * Deduplica ocorrências preservando a primeira ocorrência encontrada.
- * A chave de deduplicação é composta por: relPath|linha|tipo|mensagem.
- */
 export function dedupeOcorrencias(arr) {
+    if (!arr || !Array.isArray(arr)) {
+        return [];
+    }
     const seen = new Map();
     for (const ocorrencia of arr) {
         const key = `${ocorrencia.relPath ?? ''}|${String(ocorrencia.linha ?? '')}|${ocorrencia.tipo ?? ''}|${ocorrencia.mensagem ?? ''}`;
@@ -18,10 +11,6 @@ export function dedupeOcorrencias(arr) {
     }
     return Array.from(seen.values());
 }
-/**
- * Agrupa métricas de analistas por nome, somando duração e ocorrências e contando execuções.
- * Retorna array ordenado por ocorrências desc, depois duração desc.
- */
 export function agruparAnalistas(analistas) {
     if (!analistas || !Array.isArray(analistas) || analistas.length === 0) {
         return [];

package/dist/shared/formatters/code-min-formatter.js

@@ -1,16 +1,10 @@
 import { normalizarFimDeLinha, normalizarNewlinesFinais, removerEspacosFinaisPorLinha } from './formatters/commons.js';
-/**
- * Formata código minimamente, normalizando terminações de linha, newlines finais e espaços
- * @param code - Código fonte a ser formatado
- * @param opts - Opções de formatação (separadores, relPath, parser)
- * @returns Resultado da formatação
- */
 export function formatarCodeMinimo(code, opts) {
     const normalized = normalizarFimDeLinha(code);
     const formatted = normalizarNewlinesFinais(removerEspacosFinaisPorLinha(normalized));
     return {
         ok: true,
-        parser: opts?.parser,
+        parser: (opts?.parser ?? 'code'),
         formatted,
         changed: formatted !== normalizarNewlinesFinais(normalized),
     };

package/dist/shared/formatters/core/formatter-registry.js

@@ -1,18 +1,7 @@
-// SPDX-License-Identifier: MIT
 const registry = new Map();
-/**
- * Registra um formatador para uma extensão de arquivo específica.
- * @param ext Extensão do arquivo (ex: '.ts', '.md').
- * @param fn Função de formatação a ser associada à extensão.
- */
 export function registerFormatter(ext, fn) {
     registry.set(ext.toLowerCase(), fn);
 }
-/**
- * Obtém o formatador registrado para um determinado caminho de arquivo.
- * @param relPath Caminho relativo do arquivo.
- * @returns A função de formatação ou null se nenhum formatador estiver registrado.
- */
 export function getFormatterForPath(relPath) {
     const normalizedPath = (relPath || '').toLowerCase();
     for (const [ext, fn] of registry.entries()) {

package/dist/shared/formatters/core/syntax-map.js

@@ -1,8 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * Mapa de extensões de arquivo para informações de sintaxe.
- * Cada entrada mapeia uma extensão para o parser correspondente e se é formatável.
- */
 export const syntaxMap = {
     '.ts': { parser: 'typescript', formatavel: true },
     '.tsx': { parser: 'typescript', formatavel: true },
@@ -26,10 +21,8 @@ export const syntaxMap = {
     '.htm': { parser: 'html', formatavel: true },
     '.php': { parser: 'php', formatavel: true },
     '.xml': { parser: 'xml', formatavel: true },
-    // Linguagens de programação
     '.py': { parser: 'python', formatavel: true },
     '.go': { parser: 'go', formatavel: true },
-    // Arquivos de configuração e sistema
     '.gitignore': { parser: 'gitignore', formatavel: true },
     '.editorconfig': { parser: 'editorconfig', formatavel: true },
     '.npmrc': { parser: 'npmrc', formatavel: true },
@@ -44,16 +37,10 @@ export const syntaxMap = {
     '.dockerfile': { parser: 'dockerfile', formatavel: true },
     '.sh': { parser: 'shell', formatavel: true },
     '.bash': { parser: 'shell', formatavel: true },
-    // Arquivos de texto e logs
     '.txt': { parser: 'code', formatavel: true },
     '.log': { parser: 'code', formatavel: true },
     '.env': { parser: 'code', formatavel: true },
 };
-/**
- * Obtém informações de sintaxe para um caminho de arquivo baseado na extensão.
- * @param relPath Caminho relativo do arquivo.
- * @returns Informações de sintaxe ou null se a extensão não for reconhecida.
- */
 export function getSyntaxInfoForPath(relPath) {
     const normalizedPath = (relPath || '').toLowerCase();
     for (const ext of Object.keys(syntaxMap)) {

package/dist/shared/formatters/engines/prettier.js

@@ -1,5 +1,3 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
 import fs from 'node:fs';
 import { createRequire } from 'node:module';
 import path from 'node:path';
@@ -48,7 +46,7 @@ async function carregarPrettierDoProjeto(baseDir) {
                 return api;
             }
         }
-        const feedbackDir = process.env.SUKUNA_PRETTIER_FEEDBACK_DIR ?? path.join(base, 'feedback', 'prettier');
+        const feedbackDir = process.env.MAHORAGA_PRETTIER_FEEDBACK_DIR ?? path.join(base, 'feedback', 'prettier');
         const fromFeedback = await tryResolveFromFeedbackDir(feedbackDir, tryImportPrettier);
         if (fromFeedback) {
             return fromFeedback;
@@ -87,7 +85,6 @@ async function tryResolveFromFeedbackDir(feedbackDir, tryImportPrettier) {
         }
     }
     catch {
-        // feedback package not found, continue
     }
     return null;
 }

package/dist/shared/formatters/engines/stylelint.js

@@ -1,11 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
-/**
- * Lint de CSS interno do Mahoraga (inspirado em linters de CSS do ecossistema).
- *
- * Importante: este arquivo NÃO usa nem depende dos artefatos em /implis.
- * A pasta implis serve apenas como referência/"inspiração" de regras.
- */
 import postcss, {} from 'postcss';
 function normalizeWhitespace(input) {
     return input.replace(/\s+/g, ' ').trim();
@@ -50,40 +42,32 @@ function hasImageSet(value) {
 }
 export function isLikelyIntentionalDuplicate(prop, prevValue, newValue, ctx) {
     const normalizedProp = prop.toLowerCase();
-    // Fallbacks de viewport (100vh / 100dvh)
     if (/(100)?(vh|dvh|vw|dvw)/i.test(prevValue) || /(100)?(vh|dvh|vw|dvw)/i.test(newValue)) {
         return true;
     }
-    // Fallback com var(); comum quando há valor default + CSS custom properties
     if (hasCssVar(prevValue) || hasCssVar(newValue)) {
         return true;
     }
-    // Fallbacks de cor (rgb/rgba/hex)
     if (/(^#|rgb|hsl|color)/i.test(prevValue) && /(^#|rgb|hsl|color)/i.test(newValue) && prevValue !== newValue) {
         return true;
     }
     const gradientPrev = hasGradient(prevValue);
     const gradientNew = hasGradient(newValue);
-    // Fallbacks de gradient (ou cor -> gradient) são intencionais para browsers antigos
     const isBackgroundProp = normalizedProp === 'background' || normalizedProp === 'background-image';
     if (gradientPrev && gradientNew && prevValue !== newValue || isBackgroundProp && (gradientPrev || gradientNew)) {
         return true;
     }
-    // image-set() vs url() costuma ser fallback/resolução
     if (isBackgroundProp && (hasImageSet(prevValue) || hasImageSet(newValue))) {
         return true;
     }
-    // Fallback de fontes em @font-face: múltiplos src são esperados
     const inFontFace = (ctx?.currentAtRule ?? '').toLowerCase() === 'font-face';
     if (inFontFace && normalizedProp === 'src') {
         return true;
     }
-    // Propriedades com prefixos vendor (transform, animation, transition, etc)
     const vendorProp = normalizedProp.replace(/^(-webkit|-moz|-ms|-o)-/, '');
     if (vendorProp !== normalizedProp) {
         return true;
     }
-    // Fallback de display entre flex e grid é suspeito mas não impossível
     if (normalizedProp === 'display' && (prevValue === 'flex' || prevValue === 'grid') && (newValue === 'flex' || newValue === 'grid')) {
         return false;
     }
@@ -274,7 +258,6 @@ export function lintCssLikeStylelint(opts) {
             }
         }
     });
-    // Duplicatas por bloco (declarações)
     const conflictProps = new Set(['display', 'position', 'float', 'clear']);
     const atruleStackForDecl = [];
     const declStack = [];

package/dist/shared/formatters/engines/svgs.js

@@ -1,10 +1,5 @@
-// Limiar padrão para evitar ruído em galerias de ícones:
-// só sugerimos otimização quando a economia é relevante.
 export const SVG_OPT_MIN_BYTES_SALVO = 40;
 export const SVG_OPT_MIN_PORCENTAGEM_SALVO = 5;
-/**
- * Checks if SVG optimization should be suggested based on byte savings.
- */
 export function shouldSugerirOtimizacaoSvg(originalBytes, optimizedBytes) {
     if (!Number.isFinite(originalBytes) || originalBytes <= 0) {
         return false;
@@ -74,19 +69,16 @@ function removerDefsVazio(code) {
 function removerAtributosRaiz(code) {
     let out = code;
     const mudancas = [];
-    // remove version="1.1" etc (geralmente redundante)
     const beforeVersion = out;
     out = out.replace(/(<svg\b[^>]*?)\s+version=("[^"]*"|'[^']*')/i, '$1');
     if (out !== beforeVersion) {
         mudancas.push('remover-version');
     }
-    // remove enable-background="new ..." (deprecated)
     const beforeEnable = out;
     out = out.replace(/(<svg\b[^>]*?)\s+enable-background=("[^"]*"|'[^']*')/i, '$1');
     if (out !== beforeEnable) {
         mudancas.push('remover-enable-background');
     }
-    // remove xmlns:xlink se xlink: não aparece no arquivo
     if (!/\bxlink:/i.test(out)) {
         const beforeXlink = out;
         out = out.replace(/(<svg\b[^>]*?)\s+xmlns:xlink=("[^"]*"|'[^']*')/i, '$1');
@@ -102,9 +94,7 @@ function removerAtributosRaiz(code) {
 }
 function colapsarEspacosEntreTags(code, params) {
     if (params?.pretty) {
-        // Adiciona quebra de linha entre TODAS as tags, mesmo quando estão coladas
         const out = code.replace(/></g, '>\\n<');
-        // Indentação básica para pretty mode
         const lines = out.split('\n');
         let indent = 0;
         const formatted = lines.map(line => {
@@ -129,23 +119,18 @@ function colapsarEspacosEntreTags(code, params) {
             changed: formatted !== code
         };
     }
-    // Sem pretty: colapsa tudo em uma linha
     const out = code.replace(/>\\s+</g, '><');
     return {
         out,
         changed: out !== code
     };
 }
-/**
- * Optimizes SVG content using SVGO-like transformations.
- */
 export function otimizarSvgLikeSvgo(params) {
     const warnings = [];
     const original = params.svg;
     const originalBytes = Buffer.byteLength(original, 'utf8');
     let out = original;
     const mudancas = [];
-    // Flags de segurança: não altera, só sinaliza
     if (/<script\b/i.test(out)) {
         warnings.push('script-inline');
     }
@@ -155,7 +140,6 @@ export function otimizarSvgLikeSvgo(params) {
     if (/javascript:\s*/i.test(out)) {
         warnings.push('javascript-url');
     }
-    // Default para pretty: true (manter legibilidade com quebras de linha)
     const opts = {
         ...params,
         pretty: params.pretty ?? true

package/dist/shared/formatters/formatter.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 import { getFormatterForPath, registerFormatter } from './core/formatter-registry.js';
 import { formatarCodeMinimo, formatarJavaScriptMinimo, formatarPhpMinimo, formatarPythonMinimo, formatarTypeScriptMinimo } from './formatters/code.js';
 import { corrigirPontuacaoECodigo, normalizarFimDeLinha, normalizarNewlinesFinais, removerEspacosFinaisPorLinha } from './formatters/commons.js';
@@ -29,9 +28,6 @@ function formatarJsoncMinimo(code) {
         parser: 'json',
     });
 }
-/**
- * Fallback minimal formatter for code files without a specific formatter.
- */
 export function formatarPrettierMinimo(params) {
     const relPath = params.relPath ?? '';
     const code = params.code;
@@ -39,7 +35,6 @@ export function formatarPrettierMinimo(params) {
     if (formatter) {
         return formatter(code, relPath);
     }
-    // Fallback genérico para arquivos sem formatador específico
     const normalized = normalizarFimDeLinha(code);
     const semEspacos = removerEspacosFinaisPorLinha(normalized);
     const { text: comPontuacao, stats } = corrigirPontuacaoECodigo(semEspacos);
@@ -82,7 +77,7 @@ registerFormatter('.properties', formatarPropertiesMinimo);
 registerFormatter('.py', formatarPythonMinimo);
 registerFormatter('.php', formatarPhpMinimo);
 registerFormatter('.dockerfile', formatarDockerfileMinimo);
-registerFormatter('Dockerfile', formatarDockerfileMinimo); // Case exact match support
+registerFormatter('Dockerfile', formatarDockerfileMinimo);
 registerFormatter('.txt', (code) => formatarCodeMinimo(code, { normalizarSeparadoresDeSecao: false, parser: 'code' }));
 registerFormatter('.log', (code) => formatarCodeMinimo(code, { normalizarSeparadoresDeSecao: false, parser: 'code' }));
 registerFormatter('.env', (code) => formatarCodeMinimo(code, { normalizarSeparadoresDeSecao: false, parser: 'code' }));