@mocoto/mahoraga 0.14.7 → 0.14.9

package/dist/shared/formatters/formatters/shell.js

@@ -1,9 +1,7 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
+import { execSync } from 'node:child_process';
 import { corrigirPontuacaoECodigo, limitarLinhasEmBranco, normalizarFimDeLinha, normalizarNewlinesFinais, removerBom } from './commons.js';
 function parseShellLine(raw, ctx) {
     const trimmed = raw.trimEnd();
-    // Here-doc: preservar exatamente
     if (ctx.inHereDoc) {
         const isEnd = ctx.hereDocStripTabs ? trimmed.trim() === ctx.hereDocDelimiter : trimmed === ctx.hereDocDelimiter;
         if (isEnd) {
@@ -22,21 +20,18 @@ function parseShellLine(raw, ctx) {
             ctx
         };
     }
-    // Linha vazia
     if (!trimmed.trim()) {
         return {
             output: trimmed,
             ctx
         };
     }
-    // Comentário
     if (/^\s*#/.test(trimmed)) {
         return {
             output: trimmed,
             ctx
         };
     }
-    // Analisar quoting e here-doc
     let inSingleQuote = ctx.inSingleQuote;
     let inDoubleQuote = ctx.inDoubleQuote;
     let escaped = false;
@@ -49,7 +44,6 @@ function parseShellLine(raw, ctx) {
             continue;
         }
         if (ch === '\\') {
-            // Verificar se é continuação de linha
             if (indice === trimmed.length - 1 && !inSingleQuote) {
                 return {
                     output: trimmed,
@@ -87,7 +81,6 @@ function parseShellLine(raw, ctx) {
             indice++;
             continue;
         }
-        // Here-doc (fora de quotes)
         if (ch === '<') {
             const rest = trimmed.slice(indice);
             const hereDocMatch = rest.match(/<<-?\s*['"]?(\w+)['"]?/);
@@ -108,7 +101,6 @@ function parseShellLine(raw, ctx) {
         }
         indice++;
     }
-    // Verificar continuação
     const endsWithBackslash = trimmed.endsWith('\\') && !escaped;
     if (endsWithBackslash && !inSingleQuote && !inDoubleQuote) {
         return {
@@ -129,6 +121,60 @@ function parseShellLine(raw, ctx) {
         }
     };
 }
+function isIndexInQuotes(line, index) {
+    let inSingle = false;
+    let inDouble = false;
+    let escaped = false;
+    for (let i = 0; i < index && i < line.length; i++) {
+        const ch = line[i];
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (ch === '\\') {
+            escaped = true;
+            continue;
+        }
+        if (inSingle) {
+            if (ch === "'")
+                inSingle = false;
+            continue;
+        }
+        if (inDouble) {
+            if (ch === '"')
+                inDouble = false;
+            continue;
+        }
+        if (ch === "'") {
+            inSingle = true;
+            continue;
+        }
+        if (ch === '"') {
+            inDouble = true;
+            continue;
+        }
+    }
+    return inSingle || inDouble;
+}
+function isRealShellPipe(line, index) {
+    if (isIndexInQuotes(line, index))
+        return false;
+    const before = line.slice(0, index);
+    return true;
+}
+function aplicarEspacamentoRedirecionamento(line) {
+    const atomicos = [];
+    let result = line.replace(/(?:\d+>&?\d*|&>>?|<<[-]?|\|&|<>|>[\|]|>>|>&|<&)/g, (match) => {
+        const id = atomicos.length;
+        atomicos.push(match);
+        return `\x00ATOMIC_REDIR_${id}\x00`;
+    });
+    result = result.replace(/(?<!\x00)([^\s><])([><])([^\s><])/g, '$1 $2 $3');
+    result = result.replace(/\x00ATOMIC_REDIR_(\d+)\x00/g, (_m, id) => {
+        return atomicos[Number(id)] ?? _m;
+    });
+    return result;
+}
 function corrigirEspacamentoShell(lines) {
     const out = [];
     let ctx = {
@@ -152,47 +198,66 @@ function corrigirEspacamentoShell(lines) {
             out.push(output);
             continue;
         }
-        // Comentários: garantir espaço após #
+        if (/^\s*#!/.test(output)) {
+            out.push(output);
+            continue;
+        }
         if (/^\s*#\S/.test(output)) {
             out.push(output.replace(/^(\s*)#(\S)/, '$1# $2'));
             continue;
         }
-        // Espaçamento em atribuições: VAR=value (sem espaços em torno de =)
-        // Mas não em comparações [ $a = $b ]
         if (/^\s*[a-zA-Z_][\w]*\s+=\s/.test(output) && !output.includes('[')) {
             out.push(output.replace(/^(\s*[a-zA-Z_][\w]*)\s+=\s/, '$1='));
             continue;
         }
-        // Espaçamento em pipes: | → | (espaços em torno)
         if (/\S\|\S/.test(output)) {
-            out.push(output.replace(/(\S)\|(\S)/g, '$1 | $2'));
-            continue;
-        }
-        // Espaçamento em redirecionamentos: >file → > file
-        if (/\S[><]\S/.test(output)) {
-            out.push(output.replace(/(\S)([><])(\S)/g, '$1 $2 $3'));
-            continue;
+            const withPipeSpaces = output.replace(/(\S)\|(\S)/g, (match, before, after, offset) => {
+                if (isRealShellPipe(output, offset + before.length)) {
+                    return `${before} | ${after}`;
+                }
+                return match;
+            });
+            if (withPipeSpaces !== output) {
+                out.push(aplicarEspacamentoRedirecionamento(withPipeSpaces));
+                continue;
+            }
         }
-        out.push(output);
+        out.push(aplicarEspacamentoRedirecionamento(output));
     }
     return out;
 }
-/* ────────────────────────── Public API ────────────────────────── */
-/**
- * Shell formatter com detecção de contexto para here-docs, quoting e continuação.
- */
+function validarSintaxeShell(code) {
+    try {
+        execSync('bash -n', { input: code, timeout: 5000, stdio: ['pipe', 'ignore', 'ignore'] });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 export function formatarShellMinimo(code) {
     const normalized = normalizarFimDeLinha(removerBom(code));
     const lines = normalized.split('\n');
-    // Correção de espaçamento context-aware
     const comEspacamento = corrigirEspacamentoShell(lines);
-    // Limitar linhas em branco
     const { code: limitedBlanks } = limitarLinhasEmBranco(comEspacamento.join('\n'), 2);
-    // Correção de pontuação (preserva here-docs e comentários)
     const { text: comPontuacao, stats } = corrigirPontuacaoECodigo(limitedBlanks);
     const formatted = normalizarNewlinesFinais(comPontuacao);
     const baseline = normalizarNewlinesFinais(normalized);
     const anyChanged = formatted !== baseline;
+    if (anyChanged && lines.length > 1) {
+        try {
+            execSync('bash -n', { input: formatted, timeout: 5000, stdio: ['pipe', 'ignore', 'ignore'] });
+        }
+        catch {
+            return {
+                ok: true,
+                parser: 'shell',
+                formatted: baseline,
+                changed: false,
+                reason: 'shell-syntax-error-revert'
+            };
+        }
+    }
     return {
         ok: true,
         parser: 'shell',

package/dist/shared/formatters/formatters/sql.js

@@ -1,16 +1,11 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
 import { corrigirPontuacaoECodigo, normalizarFimDeLinha, normalizarNewlinesFinais, removerBom } from './commons.js';
-/* ────────────────────────── Keywords ────────────────────────── */
 const SQL_KEYWORDS = new Set(['select', 'from', 'where', 'insert', 'into', 'values', 'update', 'set', 'delete', 'create', 'table', 'drop', 'alter', 'add', 'column', 'index', 'join', 'left', 'right', 'inner', 'outer', 'on', 'and', 'or', 'not', 'in', 'is', 'null', 'as', 'order', 'by', 'group', 'having', 'limit', 'offset', 'union', 'all', 'distinct', 'case', 'when', 'then', 'else', 'end', 'exists', 'between', 'like', 'asc', 'desc', 'primary', 'key', 'foreign', 'references', 'constraint', 'default', 'check', 'unique', 'if', 'begin', 'commit', 'rollback', 'transaction', 'grant', 'revoke', 'with', 'recursive', 'over', 'partition', 'window', 'returning', 'cascade', 'restrict', 'no', 'action', 'using', 'cross', 'natural', 'full', 'replace', 'view', 'trigger', 'function', 'procedure', 'declare', 'fetch', 'cursor', 'open', 'close', 'deallocate']);
 const MAJOR_CLAUSE_KEYWORDS = new Set(['SELECT', 'FROM', 'WHERE', 'INSERT', 'UPDATE', 'DELETE', 'CREATE', 'DROP', 'ALTER', 'ORDER BY', 'GROUP BY', 'HAVING', 'LIMIT', 'OFFSET', 'UNION', 'SET', 'VALUES', 'INTO', 'BEGIN', 'COMMIT', 'ROLLBACK', 'WITH', 'RETURNING']);
 const JOIN_KEYWORDS = new Set(['JOIN', 'LEFT', 'RIGHT', 'INNER', 'OUTER', 'CROSS', 'NATURAL', 'FULL']);
-/* ────────────────────────── Tokenizer ────────────────────────── */
 function tokenizeSql(src) {
     const tokens = [];
     let indice = 0;
     while (indice < src.length) {
-        // -- line comments
         if (src[indice] === '-' && src[indice + 1] === '-') {
             const end = src.indexOf('\n', indice);
             tokens.push({
@@ -20,7 +15,6 @@ function tokenizeSql(src) {
             indice = end === -1 ? src.length : end;
             continue;
         }
-        // /* block comments */
         if (src[indice] === '/' && src[indice + 1] === '*') {
             const end = src.indexOf('*/', indice + 2);
             tokens.push({
@@ -30,7 +24,6 @@ function tokenizeSql(src) {
             indice = end === -1 ? src.length : end + 2;
             continue;
         }
-        // strings
         if (src[indice] === "'" || src[indice] === '"') {
             const delimitadorString = src[indice];
             let posAtual = indice + 1;
@@ -47,7 +40,6 @@ function tokenizeSql(src) {
             indice = posAtual + 1;
             continue;
         }
-        // numbers
         if (/\d/.test(src[indice] ?? '') && (indice === 0 || !/\w/.test(src[indice - 1] ?? ''))) {
             let posAtual = indice;
             while (posAtual < src.length && /[\d.]/.test(src[posAtual] ?? '')) {
@@ -60,7 +52,6 @@ function tokenizeSql(src) {
             indice = posAtual;
             continue;
         }
-        // identifiers / keywords
         if (/[a-zA-Z_]/.test(src[indice] ?? '')) {
             let posAtual = indice;
             while (posAtual < src.length && /[\w]/.test(src[posAtual] ?? '')) {
@@ -74,7 +65,6 @@ function tokenizeSql(src) {
             indice = posAtual;
             continue;
         }
-        // operators
         if (/[=<>!+\-*/%&|^~]/.test(src[indice] ?? '')) {
             let posAtual = indice;
             while (posAtual < src.length && /[=<>!+\-*/%&|^~]/.test(src[posAtual] ?? '')) {
@@ -87,7 +77,6 @@ function tokenizeSql(src) {
             indice = posAtual;
             continue;
         }
-        // punctuation
         if (/[(),.;:]/.test(src[indice] ?? '')) {
             tokens.push({
                 type: 'punct',
@@ -96,7 +85,6 @@ function tokenizeSql(src) {
             indice++;
             continue;
         }
-        // whitespace
         if (/\s/.test(src[indice] ?? '')) {
             let posAtual = indice;
             while (posAtual < src.length && /\s/.test(src[posAtual] ?? '')) {
@@ -109,15 +97,10 @@ function tokenizeSql(src) {
             indice = posAtual;
             continue;
         }
-        // fallback
         indice++;
     }
     return tokens;
 }
-/* ────────────────────────── Formatter ────────────────────────── */
-/**
- * Minimal SQL formatter.
- */
 export function formatarSqlMinimo(code) {
     const normalized = normalizarFimDeLinha(removerBom(code));
     const tokens = tokenizeSql(normalized);
@@ -141,7 +124,6 @@ export function formatarSqlMinimo(code) {
     };
     for (let textoTitulo = 0; textoTitulo < tokens.length; textoTitulo++) {
         const tok = tokens[textoTitulo];
-        // comments always on their own line
         if (tok.type === 'comment') {
             if (!lineStart) {
                 out.push('\n');
@@ -151,13 +133,11 @@ export function formatarSqlMinimo(code) {
             lineStart = true;
             continue;
         }
-        // skip whitespace (we control spacing)
         if (tok.type === 'ws') {
             continue;
         }
         if (tok.type === 'keyword') {
             const upper = tok.value.toUpperCase();
-            // ORDER BY / GROUP BY compound keyword
             if (upper === 'ORDER' || upper === 'GROUP') {
                 const next = peekKeyword(textoTitulo);
                 if (next === 'BY') {
@@ -167,7 +147,6 @@ export function formatarSqlMinimo(code) {
                     }
                     out.push(`${pushIndent()}${upper} BY`);
                     lineStart = false;
-                    // skip the BY token
                     for (let chave = textoTitulo + 1; chave < tokens.length; chave++) {
                         if (tokens[chave]?.type === 'ws') {
                             continue;
@@ -182,7 +161,6 @@ export function formatarSqlMinimo(code) {
                     continue;
                 }
             }
-            // Major clause keywords - new line
             if (MAJOR_CLAUSE_KEYWORDS.has(upper)) {
                 if (upper === 'FROM' || upper === 'WHERE' || upper === 'HAVING' || upper === 'LIMIT' || upper === 'OFFSET' || upper === 'SET' || upper === 'RETURNING') {
                     inSelectClause = false;
@@ -197,7 +175,6 @@ export function formatarSqlMinimo(code) {
                 }
                 continue;
             }
-            // JOIN keywords - new line
             if (JOIN_KEYWORDS.has(upper)) {
                 inSelectClause = false;
                 if (!lineStart) {
@@ -207,20 +184,17 @@ export function formatarSqlMinimo(code) {
                 lineStart = false;
                 continue;
             }
-            // AND / OR - new line with extra indent
             if (upper === 'AND' || upper === 'OR') {
                 out.push('\n');
                 out.push(`${pushIndent()}  ${upper}`);
                 lineStart = false;
                 continue;
             }
-            // ON - same line
             if (upper === 'ON') {
                 out.push(` ${upper}`);
                 lineStart = false;
                 continue;
             }
-            // Other keywords - inline
             if (lineStart) {
                 out.push(`${pushIndent()}${upper}`);
             }
@@ -230,7 +204,6 @@ export function formatarSqlMinimo(code) {
             lineStart = false;
             continue;
         }
-        // punctuation
         if (tok.type === 'punct') {
             if (tok.value === '(') {
                 out.push(' (');
@@ -270,7 +243,6 @@ export function formatarSqlMinimo(code) {
             lineStart = false;
             continue;
         }
-        // everything else (identifiers, strings, numbers, operators)
         if (lineStart) {
             out.push(`${pushIndent()}  ${tok.value}`);
         }

package/dist/shared/formatters/formatters/svg.js

@@ -1,10 +1,5 @@
-// SPDX-License-Identifier: MIT
 import { otimizarSvgLikeSvgo } from '../engines/svgs.js';
 import { corrigirPontuacaoECodigo, normalizarNewlinesFinais } from './commons.js';
-/**
- * Minimal SVG formatter with error handling.
- * Em caso de erro de parsing, retorna aviso recomendando o otimizador SVG.
- */
 export function formatarSvgMinimo(code) {
     try {
         if (!/<svg\b/i.test(code)) {

package/dist/shared/formatters/formatters/toml.js

@@ -1,5 +1,3 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
 import { corrigirPontuacaoECodigo, normalizarFimDeLinha, normalizarNewlinesFinais, removerBom } from './commons.js';
 function parseTomlLines(code) {
     const lines = normalizarFimDeLinha(code).split('\n');
@@ -47,7 +45,6 @@ function parseTomlLines(code) {
             });
             continue;
         }
-        // Array of tables: [[name]]
         if (/^\[\[.+\]\]$/.test(trimmed)) {
             result.push({
                 raw,
@@ -56,7 +53,6 @@ function parseTomlLines(code) {
             });
             continue;
         }
-        // Section: [name]
         if (/^\[.+\]$/.test(trimmed)) {
             result.push({
                 raw,
@@ -65,7 +61,6 @@ function parseTomlLines(code) {
             });
             continue;
         }
-        // Multiline string start
         if (/=\s*"""/.test(trimmed) || /=\s*'''/.test(trimmed)) {
             if (!trimmed.endsWith('"""') && !trimmed.endsWith("'''")) {
                 inMultilineString = true;
@@ -77,7 +72,6 @@ function parseTomlLines(code) {
             });
             continue;
         }
-        // Array value start
         if (/=\s*\[/.test(trimmed) && !trimmed.includes(']')) {
             inArrayValue = true;
             result.push({
@@ -87,7 +81,6 @@ function parseTomlLines(code) {
             });
             continue;
         }
-        // Inline table
         if (/=\s*\{/.test(trimmed)) {
             result.push({
                 raw,
@@ -96,7 +89,6 @@ function parseTomlLines(code) {
             });
             continue;
         }
-        // Key-value
         result.push({
             raw,
             kind: 'key-value',
@@ -113,10 +105,7 @@ function corrigirEspacamentoToml(entries) {
             continue;
         }
         let fixed = entry.raw;
-        // Key-value: key = value (espaços em torno de =)
         if (entry.kind === 'key-value' || entry.kind === 'multiline-string') {
-            // key=value → key = value
-            // Mas não dentro de strings
             const eqIdx = fixed.indexOf('=');
             if (eqIdx > 0) {
                 const before = fixed.slice(0, eqIdx);
@@ -132,12 +121,10 @@ function corrigirEspacamentoToml(entries) {
                 }
             }
         }
-        // Sections: [section] (sem espaços extras)
         if (entry.kind === 'section') {
             const inner = fixed.replace(/^\[/, '').replace(/\]$/, '').trim();
             fixed = `[${inner}]`;
         }
-        // Array of tables: [[section]] (sem espaços extras)
         if (entry.kind === 'array-of-tables') {
             const inner = fixed.replace(/^\[\[/, '').replace(/\]\]$/, '').trim();
             fixed = `[[${inner}]]`;
@@ -154,19 +141,11 @@ function corrigirEspacamentoToml(entries) {
     }
     return out;
 }
-/* ────────────────────────── TOML Public API ────────────────────────── */
-/**
- * TOML formatter com detecção de contexto para strings multiline e arrays.
- */
 export function formatarTomlMinimo(code) {
     const normalized = normalizarFimDeLinha(removerBom(code));
-    // Parse com contexto
     const entries = parseTomlLines(normalized);
-    // Correção de espaçamento
     const corrigidos = corrigirEspacamentoToml(entries);
-    // Reconstruir
     const rebuilt = corrigidos.map(erro => erro.raw).join('\n');
-    // Alinhar chaves por seção
     const lines = rebuilt.split('\n');
     const out = [];
     let currentSection = [];
@@ -253,10 +232,6 @@ export function formatarTomlMinimo(code) {
         reason: anyChanged ? `estilo-mahoraga-toml(punct:${stats.pontuacaoRepetida},space:${stats.espacamentoIncorreto},ops:${stats.operadoresRelacionais})` : 'normalizacao-basica'
     };
 }
-/* ────────────────────────── INI Public API ────────────────────────── */
-/**
- * INI formatter com detecção de contexto.
- */
 export function formatarIniMinimo(code) {
     const normalized = normalizarFimDeLinha(removerBom(code));
     const lines = normalized.split('\n');

package/dist/shared/formatters/formatters/xml.js

@@ -1,5 +1,3 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
 import { corrigirPontuacaoECodigo, normalizarFimDeLinha, normalizarNewlinesFinais, removerBom, removerEspacosFinaisPorLinha } from './commons.js';
 function tokenizeXml(src) {
     const re = /(<\?[\s\S]*?\?>|<!--[\s\S]*?-->|<!\[CDATA\[[\s\S]*?\]\]>|<!DOCTYPE[\s\S]*?>|<\/?[^>\n]+?>)/gi;
@@ -154,9 +152,6 @@ function prettyPrintXmlIfSafe(xml) {
         changed
     };
 }
-/**
- * Minimal XML formatter.
- */
 export function formatarXmlMinimo(code) {
     const normalized = normalizarFimDeLinha(removerBom(code));
     const semEspacosFinais = removerEspacosFinaisPorLinha(normalized);

package/dist/shared/formatters/formatters/yaml.js

@@ -1,5 +1,3 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
 import { limitarLinhasEmBranco, normalizarFimDeLinha, normalizarNewlinesFinais, removerEspacosFinaisPorLinha } from './commons.js';
 function parseYamlLines(code) {
     const lines = normalizarFimDeLinha(code).split('\n');
@@ -71,7 +69,6 @@ function parseYamlLines(code) {
             });
             continue;
         }
-        // Sequence item
         if (/^-\s/.test(trimmed)) {
             result.push({
                 raw,
@@ -83,15 +80,13 @@ function parseYamlLines(code) {
             });
             continue;
         }
-        // Mapping key: value
         if (/^[^\n:]+:\s/.test(trimmed) || /^[^\n:]+:$/.test(trimmed)) {
-            // Check for multiline block scalar
             const multilineMatch = trimmed.match(/:\s*\|[\+\-]?\s*$/);
             const multilineFolded = trimmed.match(/:\s*>[\+\-]?\s*$/);
             if (multilineMatch || multilineFolded) {
                 inMultiline = true;
                 multilineBlock = multilineMatch ? 'literal' : 'folded';
-                multilineIndent = indent + 2; // default, will adjust
+                multilineIndent = indent + 2;
                 result.push({
                     raw,
                     indent,
@@ -112,7 +107,6 @@ function parseYamlLines(code) {
             });
             continue;
         }
-        // Anchor or alias
         if (trimmed.startsWith('&') || trimmed.startsWith('*')) {
             result.push({
                 raw,
@@ -124,7 +118,6 @@ function parseYamlLines(code) {
             });
             continue;
         }
-        // Generic scalar
         result.push({
             raw,
             indent,
@@ -136,7 +129,6 @@ function parseYamlLines(code) {
     }
     return result;
 }
-/* ────────────────────────── Context-Aware Fixes ────────────────────────── */
 function corrigirIndentacaoYaml(lines) {
     const indentSize = 2;
     const out = [];
@@ -150,7 +142,6 @@ function corrigirIndentacaoYaml(lines) {
             out.push(line);
             continue;
         }
-        // Tabs → spaces
         if (line.raw.includes('\t')) {
             const tabCount = (line.raw.match(/\t/g) ?? []).length;
             const spaces = ' '.repeat(tabCount * indentSize);
@@ -164,7 +155,6 @@ function corrigirIndentacaoYaml(lines) {
             changed = true;
             continue;
         }
-        // Indentação inconsistente (não múltiplo de indentSize)
         if (line.indent > 0 && line.indent % indentSize !== 0) {
             const correctIndent = Math.round(line.indent / indentSize) * indentSize;
             const fixed = ' '.repeat(correctIndent) + line.content;
@@ -189,21 +179,16 @@ function corrigirEspacamentoYaml(lines) {
             continue;
         }
         let fixed = line.raw;
-        // Sequência: "- item" (espaço obrigatório após -)
         if (/^(\s*)-\S/.test(fixed)) {
             fixed = fixed.replace(/^(\s*)-(\S)/, '$1- $2');
             changed = true;
         }
-        // Mapping: "key: value" (espaço obrigatório após :)
-        // Mas não em URLs ou strings quoted
         if (!fixed.includes('"') && !fixed.includes("'")) {
-            // key:value → key: value
             if (/^(\s*[^\n:]+):(\S)/.test(fixed)) {
                 fixed = fixed.replace(/^(\s*[^\n:]+):(\S)/, '$1: $2');
                 changed = true;
             }
         }
-        // Espaço antes de comentário inline
         if (/\S#\s/.test(fixed) && !fixed.includes('"#') && !fixed.includes("'#")) {
             fixed = fixed.replace(/(\S)#/, '$1 #');
             changed = true;
@@ -266,7 +251,6 @@ function corrigirStringsMultilineYaml(lines) {
             if (contentLines.length > 0) {
                 const firstContent = contentLines.find(linha => linha.kind === 'multiline-content');
                 if (firstContent) {
-                    // Preservar conteúdo multiline exatamente como está
                     out.push(...contentLines);
                 }
             }
@@ -277,24 +261,15 @@ function corrigirStringsMultilineYaml(lines) {
     }
     return out;
 }
-/* ────────────────────────── Public API ────────────────────────── */
-/**
- * YAML formatter com detecção de contexto e correções robustas.
- */
 export function formatarYamlMinimo(code) {
     const normalized = normalizarFimDeLinha(code);
     const trimmed = removerEspacosFinaisPorLinha(normalized);
-    // Parse com contexto
     const parsedLines = parseYamlLines(trimmed);
-    // Correções context-aware
     let lines = corrigirIndentacaoYaml(parsedLines);
     lines = corrigirEspacamentoYaml(lines);
     lines = corrigirStringsMultilineYaml(lines);
-    // Detectar chaves duplicadas (apenas warning, não remove)
     const { lines: finalLines, warnings } = corrigirChavesDuplicadas(lines);
-    // Reconstruir
     const rebuilt = finalLines.map(linha => linha.raw).join('\n');
-    // Limitar linhas em branco
     const { code: semBlanks } = limitarLinhasEmBranco(rebuilt, 2);
     const formatted = normalizarNewlinesFinais(semBlanks);
     const baseline = normalizarNewlinesFinais(normalized);

package/dist/shared/formatters/index.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 import { normalizarFimDeLinha, normalizarNewlinesFinais, removerEspacosFinaisPorLinha } from './formatters/commons.js';
 export * from './code-min-formatter.js';
 export * from './core/formatter-registry.js';
@@ -11,13 +10,6 @@ export * from './formatter.js';
 export { getRegisteredFormatter } from './formatter.js';
 export { formatarPrettierMinimo } from './formatter.js';
 export { formatarMarkdownMinimo } from './formatters/markdown.js';
-/**
- * Formata código com regras mínimas: normaliza fins de linha,
- * remove espaços no final de cada linha e normaliza newlines finais.
- * @param code O código a ser formatado.
- * @param opts Opções opcionais incluindo parser e caminho relativo.
- * @returns Resultado da formatação mínima.
- */
 export function formatarCodeMinimo(code, opts) {
     const normalized = normalizarFimDeLinha(code);
     const formatted = normalizarNewlinesFinais(removerEspacosFinaisPorLinha(normalized));

package/dist/shared/helpers/analyst-wrapper.js

@@ -1,20 +1,10 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
-/**
- * Wrapper para analistas que adiciona suporte automático a supressões inline
- */
 import { filtrarOcorrenciasSuprimidas } from './suppressao.js';
-/**
- * Envolve um analista para adicionar suporte a supressões inline
- */
 export function comSupressaoInline(analista) {
     const aplicarOriginal = analista.aplicar;
     return {
         ...analista,
         aplicar: (src, relPath, ast, fullCaminho, contexto) => {
-            // Executa o analista original
             const resultado = aplicarOriginal(src, relPath, ast, fullCaminho, contexto);
-            // Se o resultado é uma Promise, aguarda antes de filtrar
             if (resultado instanceof Promise) {
                 return resultado.then(ocorrencias => {
                     const arr = !ocorrencias ? [] : Array.isArray(ocorrencias) ? ocorrencias : [ocorrencias];
@@ -26,9 +16,6 @@ export function comSupressaoInline(analista) {
         }
     };
 }
-/**
- * Aplica o wrapper de supressão a múltiplos analistas
- */
 export function aplicarSupressaoAAnalistas(analistas) {
     return analistas.map(comSupressaoInline);
 }