@mocoto/mahoraga 0.14.0 → 0.14.1

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

@@ -1,10 +1,17 @@
+// 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)
+    if (!Number.isFinite(originalBytes) || originalBytes <= 0) {
         return false;
-    if (!Number.isFinite(optimizedBytes) || optimizedBytes >= originalBytes)
+    }
+    if (!Number.isFinite(optimizedBytes) || optimizedBytes >= originalBytes) {
         return false;
+    }
     const saved = originalBytes - optimizedBytes;
     const pct = saved / originalBytes * 100;
     return saved >= SVG_OPT_MIN_BYTES_SALVO || pct >= SVG_OPT_MIN_PORCENTAGEM_SALVO;
@@ -67,19 +74,25 @@ 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)
+    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)
+    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');
-        if (out !== beforeXlink)
+        if (out !== beforeXlink) {
             mudancas.push('remover-xmlns-xlink');
+        }
     }
     return {
         out,
@@ -89,21 +102,26 @@ 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 => {
             const trimmed = line.trim();
-            if (!trimmed)
+            if (!trimmed) {
                 return '';
+            }
             const isClosing = trimmed.startsWith('</');
             const isSelfClosing = trimmed.endsWith('/>');
             const isSingleTag = trimmed.startsWith('<') && trimmed.includes('>');
-            if (isClosing)
+            if (isClosing) {
                 indent = Math.max(0, indent - 1);
+            }
             const res = '  '.repeat(indent) + trimmed;
-            if (isSingleTag && !isClosing && !isSelfClosing)
+            if (isSingleTag && !isClosing && !isSelfClosing) {
                 indent++;
+            }
             return res;
         }).filter(linha => linha.trim()).join('\n');
         return {
@@ -111,24 +129,33 @@ 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 = [];
-    if (/<script\b/i.test(out))
+    // Flags de segurança: não altera, só sinaliza
+    if (/<script\b/i.test(out)) {
         warnings.push('script-inline');
-    if (/\son\w+\s*=\s*['"]/i.test(out))
+    }
+    if (/\son\w+\s*=\s*['"]/i.test(out)) {
         warnings.push('evento-inline');
-    if (/javascript:\s*/i.test(out))
+    }
+    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
@@ -194,4 +221,3 @@ export function otimizarSvgLikeSvgo(params) {
         warnings
     };
 }
-//# sourceMappingURL=svgs.js.map

package/dist/shared/formatters/formatter.js

@@ -1,3 +1,4 @@
+// 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';
@@ -28,6 +29,9 @@ 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;
@@ -35,6 +39,7 @@ 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);
@@ -77,7 +82,7 @@ registerFormatter('.properties', formatarPropertiesMinimo);
 registerFormatter('.py', formatarPythonMinimo);
 registerFormatter('.php', formatarPhpMinimo);
 registerFormatter('.dockerfile', formatarDockerfileMinimo);
-registerFormatter('Dockerfile', formatarDockerfileMinimo);
+registerFormatter('Dockerfile', formatarDockerfileMinimo); // Case exact match support
 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' }));
@@ -98,4 +103,3 @@ registerFormatter('.cjs', (code, relPath) => formatarJavaScriptMinimo(code, relP
 export function getRegisteredFormatter(relPath) {
     return getFormatterForPath(relPath);
 }
-//# sourceMappingURL=formatter.js.map

package/dist/shared/formatters/formatters/code.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { createRequire } from 'node:module';
 import { corrigirPontuacaoECodigoConservador, limitarLinhasEmBranco, normalizarFimDeLinha, normalizarNewlinesFinais, normalizarUnicode, removerBom, removerEspacosFinaisPorLinhaComProtecao } from './commons.js';
 const SPECIAL_TITLES_BY_SYMBOL = {
@@ -19,10 +20,12 @@ export function getProtectedLinesFromTemplateLiterals(code, relPath) {
         const plugins = ['importMeta', 'dynamicImport', 'topLevelAwait', 'classProperties', 'classPrivateProperties', 'classPrivateMethods', 'classStaticBlock', 'optionalChaining', 'nullishCoalescingOperator', 'numericSeparator', 'logicalAssignment', 'privateIn', 'objectRestSpread', 'decorators-legacy'];
         const isTs = rp.endsWith('.ts') || rp.endsWith('.tsx') || rp.endsWith('.cts') || rp.endsWith('.mts');
         const isJsx = rp.endsWith('.jsx') || rp.endsWith('.tsx');
-        if (isTs)
+        if (isTs) {
             plugins.push('typescript');
-        if (isJsx)
+        }
+        if (isJsx) {
             plugins.push('jsx');
+        }
         const ast = parser.parse(code, {
             sourceType: 'unambiguous',
             errorRecovery: true,
@@ -32,11 +35,14 @@ export function getProtectedLinesFromTemplateLiterals(code, relPath) {
         });
         const protectedLines = new Set();
         const seen = new Set();
+        // @mahoraga-disable tipo-inseguro-unknown
         const walk = (node) => {
-            if (!isAstNode(node))
+            if (!isAstNode(node)) {
                 return;
-            if (seen.has(node))
+            }
+            if (seen.has(node)) {
                 return;
+            }
             seen.add(node);
             if (node.type === 'TemplateLiteral') {
                 const loc = node.loc;
@@ -46,22 +52,26 @@ export function getProtectedLinesFromTemplateLiterals(code, relPath) {
                     const startLine = typeof start.line === 'number' ? start.line : 0;
                     const endLine = typeof end.line === 'number' ? end.line : 0;
                     if (startLine > 0 && endLine > 0) {
-                        for (let ln = startLine; ln <= endLine; ln++)
+                        for (let ln = startLine; ln <= endLine; ln++) {
                             protectedLines.add(ln);
+                        }
                     }
                 }
             }
             for (const chave of Object.keys(node)) {
-                if (chave === 'loc' || chave === 'start' || chave === 'end')
+                if (chave === 'loc' || chave === 'start' || chave === 'end') {
                     continue;
+                }
                 const valor = node[chave];
                 if (Array.isArray(valor)) {
-                    for (const item of valor)
+                    for (const item of valor) {
                         walk(item);
+                    }
                     continue;
                 }
-                if (isAstNode(valor) && typeof valor.type === 'string')
+                if (isAstNode(valor) && typeof valor.type === 'string') {
                     walk(valor);
+                }
             }
         };
         walk(ast);
@@ -77,31 +87,39 @@ export function normalizarSeparadoresDeSecao(code, opts = {}) {
     let changed = false;
     const toUpperTitle = (raw) => {
         const trimmed = raw.trim();
-        if (!trimmed)
+        if (!trimmed) {
             return trimmed;
+        }
         const withSpaces = trimmed.replace(/([a-z\d])([A-Z])/g, '$1 $2').replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2').replace(/[_\-]+/g, ' ').replace(/\s+/g, ' ').trim();
         return withSpaces.toUpperCase();
     };
     const inferTitleFromNextSymbol = (fromIndex) => {
         for (let indice = fromIndex + 1; indice < Math.min(lines.length, fromIndex + 35); indice++) {
             const linha = (lines[indice] ?? '').trim();
-            if (!linha)
+            if (!linha) {
                 continue;
-            if (linha.startsWith('//'))
+            }
+            if (linha.startsWith('//')) {
                 continue;
-            if (linha.startsWith('/*'))
+            }
+            if (linha.startsWith('/*')) {
                 continue;
-            if (linha.startsWith('#'))
+            }
+            if (linha.startsWith('#')) {
                 continue;
+            }
             const metrica = linha.match(/^(?:export\s+)?(?:const|function|class|interface|type)\s+([A-Za-z_$][\w$]*)\b/);
-            if (!metrica)
+            if (!metrica) {
                 continue;
+            }
             const symbol = metrica[1] ?? '';
-            if (!symbol)
+            if (!symbol) {
                 continue;
+            }
             const special = SPECIAL_TITLES_BY_SYMBOL[symbol];
-            if (special)
+            if (special) {
                 return special;
+            }
             if (symbol.endsWith('Messages')) {
                 const base = symbol.slice(0, -'Messages'.length);
                 const baseTitle = toUpperTitle(base);
@@ -110,14 +128,16 @@ export function normalizarSeparadoresDeSecao(code, opts = {}) {
             return toUpperTitle(symbol);
         }
         const relPath = (opts.relPath ?? '').toLowerCase();
-        if (relPath.includes('/messages/') || relPath.includes('messages'))
+        if (relPath.includes('/messages/') || relPath.includes('messages')) {
             return 'MENSAGENS';
+        }
         return null;
     };
     const parseNovoSeparadorComMarcacao = (line) => {
         const metrica = line.match(/^\s*\/\*\s*-{10,}\s*substituir\s+por\s+titulo\s+@mahoraga-secao(?:\((.+?)\))?\s*-{10,}\s*\*\/\s*$/i);
-        if (!metrica)
+        if (!metrica) {
             return null;
+        }
         const raw = (metrica[1] ?? '').trim();
         return {
             titulo: raw ? raw : null
@@ -140,80 +160,96 @@ export function normalizarSeparadoresDeSecao(code, opts = {}) {
     };
     const extractTitleFromLineComment = (line) => {
         const metrica = line.match(/^\s*\/\/\s*(.+?)\s*$/);
-        if (!metrica)
+        if (!metrica) {
             return null;
+        }
         const textoTitulo = metrica[1].trim();
-        if (!textoTitulo)
+        if (!textoTitulo) {
             return null;
-        if (/^(?:[=\-_*]){5,}$/.test(textoTitulo))
+        }
+        if (/^(?:[=\-_*]){5,}$/.test(textoTitulo)) {
             return null;
+        }
         return textoTitulo;
     };
     const extractTitleFromBlockComment = (line) => {
         const metrica = line.match(/^\s*\/\*\s*(.+?)\s*\*\/\s*$/);
-        if (!metrica)
+        if (!metrica) {
             return null;
+        }
         const textoTitulo = metrica[1].trim();
-        if (!textoTitulo)
+        if (!textoTitulo) {
             return null;
-        if (/^(?:[=\-_*]){5,}$/.test(textoTitulo))
+        }
+        if (/^(?:[=\-_*]){5,}$/.test(textoTitulo)) {
             return null;
+        }
         return textoTitulo;
     };
     const extractTitleFromHashComment = (line) => {
         const metrica = line.match(/^\s*#\s*(.+?)\s*$/);
-        if (!metrica)
+        if (!metrica) {
             return null;
+        }
         const textoTitulo = metrica[1].trim();
-        if (!textoTitulo)
+        if (!textoTitulo) {
             return null;
-        if (/^(?:[=\-_*]){5,}$/.test(textoTitulo))
+        }
+        if (/^(?:[=\-_*]){5,}$/.test(textoTitulo)) {
             return null;
+        }
         return textoTitulo;
     };
     const extractTitleFromSingleLine = (line) => {
         const metrica = line.match(/^\s*\/\/\s*(?:[=\-_*]){5,}\s*(.+?)\s*(?:[=\-_*]){5,}\s*$/);
-        if (!metrica)
+        if (!metrica) {
             return null;
+        }
         const textoTitulo = metrica[1].trim();
         return textoTitulo ? textoTitulo : null;
     };
     const extractTitleFromSingleBlockLine = (line) => {
         const metrica = line.match(/^\s*\/\*\s*(?:[=\-_*]){5,}\s*(.+?)\s*(?:[=\-_*]){5,}\s*\*\/\s*$/);
-        if (!metrica)
+        if (!metrica) {
             return null;
+        }
         const textoTitulo = metrica[1].trim();
         return textoTitulo ? textoTitulo : null;
     };
     const extractTitleFromSingleHashLine = (line) => {
         const metrica = line.match(/^\s*#\s*(?:[=\-_*]){5,}\s*(.+?)\s*(?:[=\-_*]){5,}\s*$/);
-        if (!metrica)
+        if (!metrica) {
             return null;
+        }
         const textoTitulo = metrica[1].trim();
         return textoTitulo ? textoTitulo : null;
     };
     const extractTitleFromSingleBareLine = (line) => {
         const metrica = line.match(/^\s*(?:[=\-_*]){5,}\s*(.+?)\s*(?:[=\-_*]){5,}\s*$/);
-        if (!metrica)
+        if (!metrica) {
             return null;
+        }
         const textoTitulo = metrica[1].trim();
-        if (!textoTitulo)
+        if (!textoTitulo) {
             return null;
-        if (/^(?:[=\-_*]){5,}$/.test(textoTitulo))
+        }
+        if (/^(?:[=\-_*]){5,}$/.test(textoTitulo)) {
             return null;
+        }
         return textoTitulo;
     };
     const extractTitleFromOldBlockFormat = (line) => {
         const metrica = line.match(/^\s*\/\*\s*-{3}\s+(.+?)\s+-{3}\s*\*\/\s*$/);
-        if (!metrica)
+        if (!metrica) {
             return null;
+        }
         const textoTitulo = metrica[1].trim();
         return textoTitulo || null;
     };
     for (let indice = 0; indice < lines.length; indice++) {
         const line = lines[indice] ?? '';
         const lineNo = indice + 1;
-        if (opts.protectedLines && opts.protectedLines.has(lineNo)) {
+        if (opts.protectedLines?.has(lineNo)) {
             out.push(line);
             continue;
         }
@@ -278,6 +314,9 @@ export function normalizarSeparadoresDeSecao(code, opts = {}) {
         changed
     };
 }
+/**
+ * Minimal code formatter for generic code files.
+ */
 export function formatarCodeMinimo(code, opts = {}) {
     const semBom = removerBom(code);
     const { text: comUnicode, changed: changedUnicode } = normalizarUnicode(semBom);
@@ -298,16 +337,21 @@ export function formatarCodeMinimo(code, opts = {}) {
     const baseline = normalizarNewlinesFinais(normalized);
     const changed = formatted !== baseline;
     const reasons = [];
-    if (changedUnicode)
+    if (changedUnicode) {
         reasons.push('unicode');
-    if (stats.pontuacaoRepetida > 0)
+    }
+    if (stats.pontuacaoRepetida > 0) {
         reasons.push(`punct:${stats.pontuacaoRepetida}`);
-    if (stats.espacamentoIncorreto > 0)
+    }
+    if (stats.espacamentoIncorreto > 0) {
         reasons.push(`space:${stats.espacamentoIncorreto}`);
-    if (changedSeparators)
+    }
+    if (changedSeparators) {
         reasons.push('separadores');
-    if (changedBlanks)
+    }
+    if (changedBlanks) {
         reasons.push('blanks');
+    }
     return {
         ok: true,
         parser: opts.parser ?? 'code',
@@ -316,6 +360,9 @@ export function formatarCodeMinimo(code, opts = {}) {
         reason: reasons.length > 0 ? `estilo-mahoraga(${reasons.join(',')})` : 'normalizacao-basica'
     };
 }
+/**
+ * Minimal TypeScript formatter.
+ */
 export function formatarTypeScriptMinimo(code, relPath) {
     const semBom = removerBom(code);
     const { text: comUnicode, changed: changedUnicode } = normalizarUnicode(semBom);
@@ -331,12 +378,15 @@ export function formatarTypeScriptMinimo(code, relPath) {
     const formatted = normalizarNewlinesFinais(limitado);
     const baseline = normalizarNewlinesFinais(normalized);
     const reasons = [];
-    if (changedUnicode)
+    if (changedUnicode) {
         reasons.push('unicode');
-    if (stats.pontuacaoRepetida > 0)
+    }
+    if (stats.pontuacaoRepetida > 0) {
         reasons.push(`punct:${stats.pontuacaoRepetida}`);
-    if (stats.espacamentoIncorreto > 0)
+    }
+    if (stats.espacamentoIncorreto > 0) {
         reasons.push(`space:${stats.espacamentoIncorreto}`);
+    }
     return {
         ok: true,
         parser: 'typescript',
@@ -345,6 +395,9 @@ export function formatarTypeScriptMinimo(code, relPath) {
         reason: reasons.length > 0 ? `estilo-mahoraga-typescript(${reasons.join(',')})` : 'estilo-mahoraga-typescript'
     };
 }
+/**
+ * Minimal JavaScript formatter.
+ */
 export function formatarJavaScriptMinimo(code, relPath) {
     const semBom = removerBom(code);
     const { text: comUnicode, changed: changedUnicode } = normalizarUnicode(semBom);
@@ -360,12 +413,15 @@ export function formatarJavaScriptMinimo(code, relPath) {
     const formatted = normalizarNewlinesFinais(limitado);
     const baseline = normalizarNewlinesFinais(normalized);
     const reasons = [];
-    if (changedUnicode)
+    if (changedUnicode) {
         reasons.push('unicode');
-    if (stats.pontuacaoRepetida > 0)
+    }
+    if (stats.pontuacaoRepetida > 0) {
         reasons.push(`punct:${stats.pontuacaoRepetida}`);
-    if (stats.espacamentoIncorreto > 0)
+    }
+    if (stats.espacamentoIncorreto > 0) {
         reasons.push(`space:${stats.espacamentoIncorreto}`);
+    }
     return {
         ok: true,
         parser: 'babel',
@@ -374,6 +430,9 @@ export function formatarJavaScriptMinimo(code, relPath) {
         reason: reasons.length > 0 ? `estilo-mahoraga-javascript(${reasons.join(',')})` : 'estilo-mahoraga-javascript'
     };
 }
+/**
+ * Minimal Python formatter.
+ */
 export function formatarPythonMinimo(code) {
     const semBom = removerBom(code);
     const { text: comUnicode, changed: changedUnicode } = normalizarUnicode(semBom);
@@ -394,10 +453,12 @@ export function formatarPythonMinimo(code) {
         reason: changedUnicode ? 'estilo-mahoraga-python(unicode)' : 'estilo-mahoraga-python'
     };
 }
+/**
+ * Minimal PHP formatter.
+ */
 export function formatarPhpMinimo(code) {
     return formatarCodeMinimo(code, {
         normalizarSeparadoresDeSecao: false,
         parser: 'php'
     });
 }
-//# sourceMappingURL=code.js.map