@mocoto/mahoraga 0.14.0 → 0.14.2

package/dist/shared/formatters/formatters/css.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { normalizarFimDeLinha, normalizarNewlinesFinais, removerBom } from './commons.js';
 function tokenizeCssBlocks(src) {
     const out = [];
@@ -18,6 +19,7 @@ function tokenizeCssBlocks(src) {
         return posAtual;
     };
     while (indice < src.length) {
+        // ─── block comments ───────────────────────────────────────────
         if (src[indice] === '/' && src[indice + 1] === '*') {
             const end = src.indexOf('*/', indice + 2);
             if (end === -1) {
@@ -34,6 +36,7 @@ function tokenizeCssBlocks(src) {
             indice = end + 2;
             continue;
         }
+        // ─── strings ──────────────────────────────────────────────────
         if (src[indice] === '"' || src[indice] === "'") {
             const start = indice;
             indice = skipString(src[indice]);
@@ -43,19 +46,24 @@ function tokenizeCssBlocks(src) {
             });
             continue;
         }
+        // ─── parenthesised groups (url(...), calc(...), etc.) ─────────
         if (src[indice] === '(') {
             const parenStart = indice;
             let depth = 1;
             indice++;
             while (indice < src.length && depth > 0) {
-                if (src[indice] === '(')
+                if (src[indice] === '(') {
                     depth++;
-                else if (src[indice] === ')')
+                }
+                else if (src[indice] === ')') {
                     depth--;
-                if (depth > 0)
+                }
+                if (depth > 0) {
                     indice++;
-                else
+                }
+                else {
                     indice++;
+                }
             }
             out.push({
                 kind: 'rule',
@@ -63,19 +71,23 @@ function tokenizeCssBlocks(src) {
             });
             continue;
         }
+        // ─── at-rules ─────────────────────────────────────────────────
         if (src[indice] === '@') {
             let depth = 0;
             const atStart = indice;
             let blockStarted = false;
             while (indice < src.length) {
+                // skip parenthesised expressions inside at-rules
                 if (src[indice] === '(') {
                     let pd = 1;
                     indice++;
                     while (indice < src.length && pd > 0) {
-                        if (src[indice] === '(')
+                        if (src[indice] === '(') {
                             pd++;
-                        else if (src[indice] === ')')
+                        }
+                        else if (src[indice] === ')') {
                             pd--;
+                        }
                         indice++;
                     }
                     continue;
@@ -107,6 +119,7 @@ function tokenizeCssBlocks(src) {
             });
             continue;
         }
+        // ─── structural characters ────────────────────────────────────
         if (src[indice] === '{' || src[indice] === '}' || src[indice] === ';') {
             out.push({
                 kind: 'text',
@@ -115,9 +128,11 @@ function tokenizeCssBlocks(src) {
             indice++;
             continue;
         }
+        // ─── rule chunk (selectors / declarations) ────────────────────
         {
             const ruleStart = indice;
             while (indice < src.length && src[indice] !== '{' && src[indice] !== '}' && src[indice] !== ';' && src[indice] !== '@' && !(src[indice] === '/' && src[indice + 1] === '*')) {
+                // skip strings inside rule text
                 if (src[indice] === '"' || src[indice] === "'") {
                     indice = skipString(src[indice]);
                     continue;
@@ -135,31 +150,50 @@ function tokenizeCssBlocks(src) {
     }
     return out;
 }
+/* ────────────────────────── Helpers ────────────────────────── */
+/**
+ * Find the colon that separates property from value, ignoring colons inside
+ * parentheses (e.g. `url(data:image/png)`) and colons that are part of
+ * pseudo-selectors (`:hover`, `::before`).
+ */
 function findPropertyColon(str) {
     let depth = 0;
     for (let indice = 0; indice < str.length; indice++) {
-        if (str[indice] === '(')
+        if (str[indice] === '(') {
             depth++;
-        else if (str[indice] === ')')
+        }
+        else if (str[indice] === ')') {
             depth--;
+        }
         else if (str[indice] === ':' && depth === 0) {
             const rest = str.slice(indice + 1);
             const before = str.slice(0, indice).trim();
+            // Skip pseudo-elements: ::after, ::before, ::first-line, etc.
             if (/^::[a-zA-Z-]/.test(rest)) {
+                // If "before" starts with --, it's a CSS custom property
                 if (before.startsWith('--')) {
                     return indice;
                 }
+                // Otherwise skip - it's definitely a pseudo-element
                 continue;
             }
+            // Skip pseudo-classes: :hover, :first-child, :nth-child, etc.
             if (/^:[a-zA-Z-]/.test(rest)) {
+                // If "before" starts with --, it's a CSS custom property
                 if (before.startsWith('--')) {
                     return indice;
                 }
+                // If "before" is a short selector (likely an HTML tag like a, i, b, u, s)
+                // or contains selector characters, skip - it's a pseudo-class
                 if (before.length <= 2 || /[\s>+~\[*.#:]/.test(before)) {
                     continue;
                 }
+                // "before" is longer - could be either property or selector
+                // Default to skipping for safety (most colons in selectors are pseudo-classes)
                 continue;
             }
+            // Not a pseudo-selector - check if "before" is a CSS property
+            // CSS properties don't contain selector characters
             if (before.length > 0 && !before.includes(' ') && !before.includes('>') && !before.includes('+') && !before.includes('~') && !before.includes('[') && !before.startsWith('.') && !before.startsWith('#') && !before.startsWith(':') && !before.startsWith('@') && !before.startsWith('&')) {
                 return indice;
             }
@@ -170,17 +204,25 @@ function findPropertyColon(str) {
 }
 function isCssPropertyName(name) {
     const textoTitulo = name.trim();
-    if (!textoTitulo)
+    if (!textoTitulo) {
         return false;
-    if (textoTitulo.startsWith('--'))
+    }
+    // CSS custom properties
+    if (textoTitulo.startsWith('--')) {
         return true;
+    }
+    // Common HTML tag names that are NOT CSS properties
     const commonTags = new Set(['a', 'b', 'i', 'u', 's', 'em', 'strong', 'code', 'span', 'div', 'html', 'head', 'body', 'title', 'link', 'meta', 'script', 'style', 'header', 'footer', 'nav', 'main', 'section', 'article', 'aside', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'p', 'ul', 'ol', 'li', 'table', 'tr', 'td', 'th', 'form', 'input', 'button', 'label', 'img', 'a', 'br', 'hr', 'pre', 'blockquote', 'iframe']);
-    if (commonTags.has(textoTitulo.toLowerCase()))
+    if (commonTags.has(textoTitulo.toLowerCase())) {
         return false;
-    if (/^-?[a-zA-Z][a-zA-Z0-9-]*$/.test(textoTitulo))
+    }
+    // Standard properties (possibly vendor-prefixed)
+    if (/^-?[a-zA-Z][a-zA-Z0-9-]*$/.test(textoTitulo)) {
         return true;
+    }
     return false;
 }
+/* ────────────────────────── Parser ────────────────────────── */
 function parseCssTokens(tokenList) {
     const items = [];
     let currentSelector = '';
@@ -197,10 +239,6 @@ function parseCssTokens(tokenList) {
     let idx = 0;
     while (idx < tokenList.length) {
         const tok = tokenList[idx];
-        if (!tok) {
-            idx++;
-            continue;
-        }
         if (tok.kind === 'comment') {
             items.push({
                 kind: 'comment',
@@ -213,24 +251,23 @@ function parseCssTokens(tokenList) {
             if (tok.value === '{') {
                 flushSelector();
                 const lastBlock = items[items.length - 1];
-                if (lastBlock?.kind === 'block') {
+                if (lastBlock.kind === 'block') {
                     idx++;
                     const innerTokens = [];
                     let depth = 1;
                     while (idx < tokenList.length && depth > 0) {
                         const innerTok = tokenList[idx];
-                        if (!innerTok) {
-                            idx++;
-                            continue;
-                        }
                         if (innerTok.kind === 'text') {
-                            if (innerTok.value === '{')
+                            if (innerTok.value === '{') {
                                 depth++;
-                            else if (innerTok.value === '}')
+                            }
+                            else if (innerTok.value === '}') {
                                 depth--;
+                            }
                         }
-                        if (depth > 0)
+                        if (depth > 0) {
                             innerTokens.push(innerTok);
+                        }
                         idx++;
                     }
                     lastBlock.items = parseCssTokens(innerTokens);
@@ -270,6 +307,8 @@ function parseCssTokens(tokenList) {
                 items.push(block);
             }
             else {
+                // At-rule without block (e.g. @import, @charset, @namespace)
+                // Treat as a property-like statement (no braces)
                 const cleaned = trimmed.replace(/;[\s]*$/, '').trim();
                 items.push({
                     kind: 'prop',
@@ -300,6 +339,7 @@ function parseCssTokens(tokenList) {
                     continue;
                 }
             }
+            // It's a selector fragment
             currentSelector = (currentSelector ? `${currentSelector} ` : '') + trimmed;
             idx++;
             continue;
@@ -309,12 +349,14 @@ function parseCssTokens(tokenList) {
     flushSelector();
     return items;
 }
+/* ────────────────────────── Renderer ────────────────────────── */
 function renderCssItems(items, depth) {
     const lines = [];
     const indent = (node) => '  '.repeat(Math.max(0, node));
     for (let indice = 0; indice < items.length; indice++) {
         const item = items[indice];
         if (item.kind === 'comment') {
+            // Preserve multi-line comments
             const commentLines = item.text.split('\n');
             for (const cl of commentLines) {
                 lines.push(`${indent(depth)}${cl.trim()}`);
@@ -322,16 +364,18 @@ function renderCssItems(items, depth) {
         }
         else if (item.kind === 'prop') {
             if (item.value === '') {
+                // At-rule without block (e.g. @import url(...))
                 lines.push(`${indent(depth)}${item.prop};`);
             }
             else {
                 lines.push(`${indent(depth)}${item.prop}: ${item.value};`);
             }
         }
-        else if (item.kind === 'block') {
+        else {
+            // Add blank line before top-level blocks (except the first)
             if (depth === 0 && indice > 0) {
                 const prevLine = lines[lines.length - 1];
-                if (prevLine !== undefined && prevLine !== '') {
+                if (prevLine !== '') {
                     lines.push('');
                 }
             }
@@ -344,6 +388,10 @@ function renderCssItems(items, depth) {
     }
     return lines;
 }
+/* ────────────────────────── Public API ────────────────────────── */
+/**
+ * Minimal CSS formatter.
+ */
 export function formatarCssMinimo(code) {
     const normalized = normalizarFimDeLinha(removerBom(code));
     const tokens = tokenizeCssBlocks(normalized);
@@ -359,6 +407,9 @@ export function formatarCssMinimo(code) {
         reason: 'estilo-mahoraga-css'
     };
 }
+/**
+ * Minimal SCSS formatter.
+ */
 export function formatarScssMinimo(code) {
     const normalized = normalizarFimDeLinha(removerBom(code));
     const lines = normalized.split('\n');
@@ -368,12 +419,14 @@ export function formatarScssMinimo(code) {
     for (let indice = 0; indice < lines.length; indice++) {
         const raw = lines[indice] ?? '';
         const trimmed = raw.trim();
+        // --- empty lines ---
         if (!trimmed) {
             if (out.length > 0 && out[out.length - 1] !== '') {
                 out.push('');
             }
             continue;
         }
+        // --- multi-line comments ---
         if (inMultilineComment) {
             out.push(`${'  '.repeat(indent)}${trimmed}`);
             if (trimmed.includes('*/')) {
@@ -386,16 +439,20 @@ export function formatarScssMinimo(code) {
             out.push(`${'  '.repeat(indent)}${trimmed}`);
             continue;
         }
+        // --- single-line comments ---
         if (trimmed.startsWith('//') || trimmed.startsWith('/*') && trimmed.includes('*/')) {
             out.push(`${'  '.repeat(indent)}${trimmed}`);
             continue;
         }
+        // --- closing brace ---
         if (trimmed === '}' || trimmed.startsWith('}')) {
             indent = Math.max(0, indent - 1);
             out.push(`${'  '.repeat(indent)}${trimmed}`);
             continue;
         }
+        // --- opening brace at end of line ---
         if (trimmed.endsWith('{')) {
+            // Add blank line before nested rules (but not the first rule)
             if (out.length > 0 && out[out.length - 1] !== '' && !out[out.length - 1]?.trim().startsWith('//') && !out[out.length - 1]?.trim().startsWith('/*')) {
                 const prevTrimmed = (out[out.length - 1] ?? '').trim();
                 if (prevTrimmed !== '' && !prevTrimmed.endsWith('{') && prevTrimmed !== '}') {
@@ -407,6 +464,7 @@ export function formatarScssMinimo(code) {
             indent++;
             continue;
         }
+        // --- line contains { inline ---
         if (trimmed.includes('{')) {
             const parts = trimmed.split('{');
             const selector = parts[0]?.trim() ?? '';
@@ -436,7 +494,9 @@ export function formatarScssMinimo(code) {
             }
             continue;
         }
+        // --- declarations and at-rules ---
         if (trimmed.startsWith('@')) {
+            // SCSS at-rule without block (e.g. @import, @include, @use, @extend)
             out.push(`${'  '.repeat(indent)}${trimmed.endsWith(';') ? trimmed : `${trimmed};`}`);
             continue;
         }
@@ -450,6 +510,7 @@ export function formatarScssMinimo(code) {
                 continue;
             }
         }
+        // --- everything else ---
         out.push(`${'  '.repeat(indent)}${trimmed.endsWith(';') ? trimmed : trimmed}`);
     }
     const formatted = normalizarNewlinesFinais(out.join('\n'));
@@ -462,7 +523,9 @@ export function formatarScssMinimo(code) {
         reason: 'estilo-mahoraga-scss'
     };
 }
+/**
+ * Minimal Less formatter.
+ */
 export function formatarLessMinimo(code) {
     return formatarScssMinimo(code);
 }
-//# sourceMappingURL=css.js.map

package/dist/shared/formatters/formatters/dockerfile.js

@@ -1,4 +1,6 @@
+// SPDX-License-Identifier: MIT
 import { limitarLinhasEmBranco, normalizarFimDeLinha, normalizarNewlinesFinais, removerBom } from './commons.js';
+/* ────────────────────────── Dockerfile Context-Aware Parser ────────────────────────── */
 const DOCKER_KEYWORDS = new Set([
     'from', 'run', 'cmd', 'label', 'maintainer', 'expose', 'env',
     'add', 'copy', 'entrypoint', 'volume', 'user', 'workdir', 'arg',
@@ -8,10 +10,12 @@ function corrigirInstrucoesDockerfile(lines) {
     const out = [];
     for (const raw of lines) {
         const trimmed = raw.trim();
+        // Linhas vazias e comentários: preservar
         if (!trimmed || trimmed.startsWith('#')) {
             out.push(raw);
             continue;
         }
+        // Continuação de linha: preservar
         if (trimmed.endsWith('\\') && !trimmed.startsWith('\\')) {
             const firstWord = trimmed.split(/\s+/)[0]?.toUpperCase() ?? '';
             if (DOCKER_KEYWORDS.has(firstWord.toLowerCase())) {
@@ -22,6 +26,7 @@ function corrigirInstrucoesDockerfile(lines) {
             }
             continue;
         }
+        // Keywords Docker em uppercase
         const firstWord = trimmed.split(/\s+/)[0] ?? '';
         if (DOCKER_KEYWORDS.has(firstWord.toLowerCase())) {
             const upper = firstWord.toUpperCase();
@@ -29,18 +34,22 @@ function corrigirInstrucoesDockerfile(lines) {
             out.push(`${upper}${rest}`);
             continue;
         }
+        // ENV: normalizar para ENV KEY=VALUE (sem espaço antes de =)
         if (/^ENV\s+\S+\s+=/.test(trimmed)) {
             const rest = trimmed.slice(4).trim();
             out.push(`ENV ${rest.replace(/\s+=\s/, '=')}`);
             continue;
         }
+        // ARG: normalizar para ARG KEY=VALUE
         if (/^ARG\s+\S+\s+=/.test(trimmed)) {
             const rest = trimmed.slice(4).trim();
             out.push(`ARG ${rest.replace(/\s+=\s/, '=')}`);
             continue;
         }
+        // LABEL: garantir aspas em valores com espaços
         if (/^LABEL\s+/.test(trimmed)) {
             const rest = trimmed.slice(6).trim();
+            // KEY=value com espaços → KEY="value"
             const normalized = rest.replace(/(\S+)=(\S.*\S)(?=\s+\S+=|$)/g, (_m, key, val) => {
                 if (!val.startsWith('"') && !val.startsWith("'")) {
                     return `${key}="${val}"`;
@@ -50,6 +59,7 @@ function corrigirInstrucoesDockerfile(lines) {
             out.push(`LABEL ${normalized}`);
             continue;
         }
+        // EXPOSE: múltiplas portas em uma linha
         if (/^EXPOSE\s+/.test(trimmed)) {
             const ports = trimmed.slice(7).trim().split(/\s+/);
             out.push(`EXPOSE ${ports.join(' ')}`);
@@ -65,7 +75,8 @@ function adicionarEspacamentoEntreStages(lines) {
     for (const line of lines) {
         const trimmed = line.trim();
         const isFrom = /^FROM\s/i.test(trimmed);
-        if (isFrom && prevWasFrom === false && out.length > 0) {
+        if (isFrom && !prevWasFrom && out.length > 0) {
+            // Adicionar linha em branco antes de novo stage
             if (out[out.length - 1] !== '') {
                 out.push('');
             }
@@ -75,11 +86,18 @@ function adicionarEspacamentoEntreStages(lines) {
     }
     return out;
 }
+/* ────────────────────────── Public API ────────────────────────── */
+/**
+ * Dockerfile formatter com detecção de multi-stage builds e normalização de instruções.
+ */
 export function formatarDockerfileMinimo(code) {
     const normalized = normalizarFimDeLinha(removerBom(code));
     const lines = normalized.split('\n');
+    // Correção de instruções context-aware
     const comInstrucoes = corrigirInstrucoesDockerfile(lines);
+    // Espaçamento entre stages
     const comEspacamento = adicionarEspacamentoEntreStages(comInstrucoes);
+    // Limitar linhas em branco
     const { code: limitedBlanks } = limitarLinhasEmBranco(comEspacamento.join('\n'), 2);
     const formatted = normalizarNewlinesFinais(limitedBlanks);
     const baseline = normalizarNewlinesFinais(normalized);
@@ -92,4 +110,3 @@ export function formatarDockerfileMinimo(code) {
         reason: anyChanged ? 'estilo-mahoraga-dockerfile' : 'normalizacao-basica'
     };
 }
-//# sourceMappingURL=dockerfile.js.map

package/dist/shared/formatters/formatters/dotfiles.js

@@ -1,4 +1,14 @@
+// SPDX-License-Identifier: MIT
 import { corrigirPontuacaoECodigo, normalizarFimDeLinha, normalizarNewlinesFinais, removerBom } from './commons.js';
+/* ────────────────────────── Gitignore ────────────────────────── */
+/**
+ * Gitignore formatter com agrupamento por contexto e seções organizadas.
+ * - Normaliza line endings e remove BOM
+ * - Agrupa patterns por seções baseadas em comentários
+ * - Ordena patterns alfabeticamente dentro de cada seção
+ * - Garante espaço após # em comentários
+ * - Remove linhas em branco duplicadas
+ */
 export function formatarGitignoreMinimo(code) {
     const normalized = normalizarFimDeLinha(removerBom(code));
     const lines = normalized.split('\n');
@@ -45,8 +55,9 @@ export function formatarGitignoreMinimo(code) {
         const sortedPatterns = [...section.patterns].sort((a, b) => {
             const aNegated = a.startsWith('!');
             const bNegated = b.startsWith('!');
-            if (aNegated !== bNegated)
+            if (aNegated !== bNegated) {
                 return aNegated ? 1 : -1;
+            }
             return a.localeCompare(b);
         });
         for (const pattern of sortedPatterns) {
@@ -65,6 +76,10 @@ export function formatarGitignoreMinimo(code) {
         reason: anyChanged ? `estilo-mahoraga-gitignore(punct:${stats.pontuacaoRepetida},space:${stats.espacamentoIncorreto},ops:${stats.operadoresRelacionais})` : 'normalizacao-basica'
     };
 }
+/* ────────────────────────── EditorConfig ────────────────────────── */
+/**
+ * EditorConfig formatter com alinhamento de chaves.
+ */
 export function formatarEditorconfigMinimo(code) {
     const normalized = normalizarFimDeLinha(removerBom(code));
     const lines = normalized.split('\n');
@@ -104,7 +119,7 @@ export function formatarEditorconfigMinimo(code) {
         const sectionMatch = trimmed.match(/^\[(.+)\]$/);
         if (sectionMatch) {
             flushSection();
-            currentSection = sectionMatch[1]?.trim() ?? '';
+            currentSection = sectionMatch[1].trim();
             continue;
         }
         const eqIdx = trimmed.indexOf('=');
@@ -132,6 +147,10 @@ export function formatarEditorconfigMinimo(code) {
         reason: anyChanged ? `estilo-mahoraga-editorconfig(punct:${stats.pontuacaoRepetida},space:${stats.espacamentoIncorreto},ops:${stats.operadoresRelacionais})` : 'normalizacao-basica'
     };
 }
+/* ────────────────────────── Npmrc ────────────────────────── */
+/**
+ * Npmrc formatter com normalização de chaves.
+ */
 export function formatarNpmrcMinimo(code) {
     const normalized = normalizarFimDeLinha(removerBom(code));
     const lines = normalized.split('\n');
@@ -145,6 +164,7 @@ export function formatarNpmrcMinimo(code) {
             continue;
         }
         if (trimmed.startsWith('#') || trimmed.startsWith(';')) {
+            // Comentários: garantir espaço após #
             if (/^[#;]\S/.test(trimmed)) {
                 out.push(`${trimmed[0]} ${trimmed.slice(1).trim()}`);
             }
@@ -153,6 +173,7 @@ export function formatarNpmrcMinimo(code) {
             }
             continue;
         }
+        // Key=value → key = value
         const eqIdx = trimmed.indexOf('=');
         if (eqIdx > 0) {
             const key = trimmed.slice(0, eqIdx).trim();
@@ -174,6 +195,10 @@ export function formatarNpmrcMinimo(code) {
         reason: anyChanged ? `estilo-mahoraga-npmrc(punct:${stats.pontuacaoRepetida},space:${stats.espacamentoIncorreto},ops:${stats.operadoresRelacionais})` : 'normalizacao-basica'
     };
 }
+/* ────────────────────────── Nvmrc ────────────────────────── */
+/**
+ * Nvmrc formatter - apenas uma versão.
+ */
 export function formatarNvmrcMinimo(code) {
     const normalized = normalizarFimDeLinha(removerBom(code)).trim();
     const { text: comPontuacao, stats } = corrigirPontuacaoECodigo(normalized);
@@ -188,4 +213,3 @@ export function formatarNvmrcMinimo(code) {
         reason: anyChanged ? `estilo-mahoraga-nvmrc(punct:${stats.pontuacaoRepetida},space:${stats.espacamentoIncorreto},ops:${stats.operadoresRelacionais})` : 'normalizacao-basica'
     };
 }
-//# sourceMappingURL=dotfiles.js.map

package/dist/shared/formatters/formatters/go.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { corrigirPontuacaoECodigo, limitarLinhasEmBranco, normalizarFimDeLinha, normalizarNewlinesFinais, removerBom } from './commons.js';
 function corrigirImportsGo(lines) {
     const out = [];
@@ -11,9 +12,12 @@ function corrigirImportsGo(lines) {
         braceDepth: 0
     };
     const flushImports = (imports, beforeLines) => {
-        if (imports.length === 0)
+        if (imports.length === 0) {
             return;
+        }
+        // Ordenar imports
         const sorted = [...imports].sort();
+        // Separar stdlib de third-party
         const stdlib = [];
         const thirdParty = [];
         for (const imp of sorted) {
@@ -25,13 +29,16 @@ function corrigirImportsGo(lines) {
                 thirdParty.push(imp);
             }
         }
+        // Adicionar linha em branco antes dos imports se necessário
         if (beforeLines.length > 0 && beforeLines[beforeLines.length - 1] !== '') {
             out.push('');
         }
         if (stdlib.length + thirdParty.length === 1) {
+            // Single import
             out.push(...stdlib, ...thirdParty);
         }
         else {
+            // Grouped imports
             out.push('import (');
             for (const imp of stdlib) {
                 out.push(`\t${imp.trim()}`);
@@ -49,6 +56,7 @@ function corrigirImportsGo(lines) {
     let beforeImportLines = [];
     for (const raw of lines) {
         const trimmed = raw.trim();
+        // Multiline comments
         if (ctx.inMultilineComment) {
             out.push(raw);
             if (trimmed.includes('*/')) {
@@ -61,6 +69,7 @@ function corrigirImportsGo(lines) {
             out.push(raw);
             continue;
         }
+        // Single line comments
         if (trimmed.startsWith('//')) {
             if (ctx.inImportBlock) {
                 pendingImports.push(raw);
@@ -70,11 +79,13 @@ function corrigirImportsGo(lines) {
             }
             continue;
         }
+        // Import block start
         if (/^import\s+\(/.test(trimmed)) {
             ctx.inImportBlock = true;
             pendingImports = [];
             continue;
         }
+        // Import block end
         if (ctx.inImportBlock && trimmed === ')') {
             ctx.inImportBlock = false;
             flushImports(pendingImports, beforeImportLines);
@@ -82,6 +93,7 @@ function corrigirImportsGo(lines) {
             beforeImportLines = [];
             continue;
         }
+        // Single import: import "path"
         if (/^import\s+"/.test(trimmed)) {
             flushImports([trimmed], beforeImportLines);
             beforeImportLines = [];
@@ -93,12 +105,14 @@ function corrigirImportsGo(lines) {
             }
             continue;
         }
+        // Package declaration - always first
         if (/^package\s+/.test(trimmed)) {
             out.push(raw);
             continue;
         }
         out.push(raw);
     }
+    // Flush remaining imports
     if (pendingImports.length > 0) {
         flushImports(pendingImports, beforeImportLines);
     }
@@ -109,26 +123,37 @@ function corrigirEspacamentoGo(lines) {
     let prevWasFunc = false;
     for (const raw of lines) {
         const trimmed = raw.trim();
+        // Linhas vazias e comentários
         if (!trimmed || trimmed.startsWith('//') || trimmed.startsWith('/*')) {
             out.push(raw);
             continue;
         }
-        if (/^(func|type)\s+/.test(trimmed) && prevWasFunc === false && out.length > 0) {
+        // Adicionar linha em branco antes de func (exceto a primeira)
+        if (/^(func|type)\s+/.test(trimmed) && !prevWasFunc && out.length > 0) {
             if (out[out.length - 1] !== '') {
                 out.push('');
             }
         }
+        // Trailing whitespace
         out.push(raw.replace(/[ \t]+$/, ''));
         prevWasFunc = /^(func|type)\s+/.test(trimmed);
     }
     return out;
 }
+/* ────────────────────────── Public API ────────────────────────── */
+/**
+ * Go formatter com organização de imports e espaçamento de blocos.
+ */
 export function formatarGoMinimo(code) {
     const normalized = normalizarFimDeLinha(removerBom(code));
     const lines = normalized.split('\n');
+    // Organizar imports
     const comImports = corrigirImportsGo(lines);
+    // Espaçamento de blocos
     const comEspacamento = corrigirEspacamentoGo(comImports);
+    // Limitar linhas em branco
     const { code: limitado } = limitarLinhasEmBranco(comEspacamento.join('\n'), 2);
+    // Correção de pontuação (preserva strings e comentários)
     const { text: comPontuacao, stats } = corrigirPontuacaoECodigo(limitado);
     const formatted = normalizarNewlinesFinais(comPontuacao);
     const baseline = normalizarNewlinesFinais(normalized);
@@ -143,4 +168,3 @@ export function formatarGoMinimo(code) {
             : 'normalizacao-basica'
     };
 }
-//# sourceMappingURL=go.js.map