@mocoto/mahoraga 0.14.0 → 0.14.1

package/dist/shared/formatters/formatters/commons.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export function normalizarFimDeLinha(code) {
     return code.replace(/\r\n?/g, '\n');
 }
@@ -14,8 +15,9 @@ export function removerEspacosFinaisPorLinha(code) {
 export function removerEspacosFinaisPorLinhaComProtecao(code, protectedLines) {
     return code.split('\n').map((linha, idx) => {
         const lineNo = idx + 1;
-        if (protectedLines && protectedLines.has(lineNo))
+        if (protectedLines?.has(lineNo)) {
             return linha;
+        }
         return linha.replace(/[ \t]+$/g, '');
     }).join('\n');
 }
@@ -27,7 +29,7 @@ export function limitarLinhasEmBranco(code, maxConsecutivas = 2, protectedLines)
     for (let indice = 0; indice < lines.length; indice++) {
         const line = lines[indice] ?? '';
         const lineNo = indice + 1;
-        if (protectedLines && protectedLines.has(lineNo)) {
+        if (protectedLines?.has(lineNo)) {
             out.push(line);
             consecutive = 0;
             continue;
@@ -94,7 +96,9 @@ const SPACE_BEFORE_PUNCT_RE = /\s+([,.:;!?])/g;
 const NO_SPACE_AFTER_NON_DOT_PUNCT_RE = /([,:;!?])([^\s\)\]\}\[!,;:?])/g;
 const SPACE_BEFORE_ELLIPSIS_RE = /([^0-9])(\.{3})/g;
 const PROTECTED_PATTERNS = [/https?:\/\/[^\s"'<>]+/gi, /ftp:\/\/[^\s"'<>]+/gi, /file:\/\/[^\s"'<>]+/gi, /www\.[^\s"'<>]+/gi, /[a-zA-Z0-9](?:\.[a-zA-Z0-9-]+)+\.[a-zA-Z]{2,}/g, /(?:^|(?<=\s|["'=(\[,]))\.\//g, /(?:^|(?<=\s|["'=(\[,]))\.\.\//g, /(?<=[/\\])[\w-]+\.[\w]+/g, /\d+\.\d+(?:\.\d+)*/g, /\b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\b/g, /[a-f0-9]{7,}\.[a-f0-9]+/gi, /[\w-]+\.[\w-]+\.[\w]+/g,
+    // Proteger paths e nomes de arquivo com extensão
     /(?:^|[\s"'=(\[,])([\/\\][\w-]+(?:[\/\\][\w-]+)*[\/\\]?[\w-]+\.[a-zA-Z0-9]+)/g, /(?:^|[\s"'=(\[,])([\w-]+(?:[\/\\][\w-]+)+\.[a-zA-Z0-9]+)/g,
+    // Proteger imports/require paths
     /(?:from\s+|require\(|import\s+)(["'])([^"']+\.[a-zA-Z0-9]+)\1/g];
 function protectSequences(code) {
     const placeholders = [];
@@ -121,18 +125,23 @@ const NO_SPACE_AFTER_DOT_RE = /(?<![a-zA-Z0-9_.])\.(?![a-zA-Z0-9/\\.\s])/g;
 function isLikelyFilePathOrExtension(line, index) {
     const before = line.slice(Math.max(0, index - 50), index);
     const after = line.slice(index + 1, Math.min(line.length, index + 10));
+    // Verifica se parece extensão de arquivo: algo.ts, algo.js, etc
     if (/[a-zA-Z0-9_-]$/.test(before) && /^[a-zA-Z0-9]+$/.test(after)) {
         return true;
     }
+    // Verifica se parece path: /path/to/file.txt ou ./file.txt
     if (/[\/\\]$/.test(before) || /[\/\\]/.test(before.slice(-10))) {
         return true;
     }
+    // Verifica se parece nome de arquivo com extensão
     if (/\.[a-zA-Z0-9]+$/.test(after)) {
         return true;
     }
+    // Verifica se o ponto está após código inline markdown (backtick)
     if (/`[^`]*`\s*$/.test(before)) {
         return true;
     }
+    // Verifica se o ponto está no final da linha (final de frase)
     if (after.trim() === '') {
         return true;
     }
@@ -140,13 +149,15 @@ function isLikelyFilePathOrExtension(line, index) {
 }
 function isInStringOrComment(line, index) {
     const prefix = line.slice(0, index);
-    const stringCount = (prefix.match(/(?<!\\)(?:\\\\)*['"`]/g) || []).length;
-    if (stringCount % 2 === 1)
+    const stringCount = (prefix.match(/(?<!\\)(?:\\\\)*['"`]/g) ?? []).length;
+    if (stringCount % 2 === 1) {
         return true;
-    if (/\/\/[^]*$/.test(prefix))
+    }
+    if (/\/\/[^]*$/.test(prefix)) {
         return true;
-    const blockOpens = (prefix.match(/\/\*/g) || []).length;
-    const blockCloses = (prefix.match(/\*\//g) || []).length;
+    }
+    const blockOpens = (prefix.match(/\/\*/g) ?? []).length;
+    const blockCloses = (prefix.match(/\*\//g) ?? []).length;
     return blockOpens > blockCloses;
 }
 function isMarkdownCodeFence(line) {
@@ -169,7 +180,7 @@ function isInsideMarkdownCodeBlock(lines, lineIndex) {
         }
         if (inFence && fenceChar) {
             const closeMatch = trimmed.match(/^(`{3,}|~{3,})\s*$/);
-            if (closeMatch && closeMatch[1][0] === fenceChar && closeMatch[1].length >= fenceLen) {
+            if (closeMatch?.[1][0] === fenceChar && closeMatch[1].length >= fenceLen) {
                 inFence = false;
                 fenceChar = null;
             }
@@ -178,25 +189,39 @@ function isInsideMarkdownCodeBlock(lines, lineIndex) {
     return inFence;
 }
 function shouldSkipLineForPunctuation(line, lineIndex, lines) {
-    if (isMarkdownCodeFence(line))
+    if (isMarkdownCodeFence(line)) {
         return true;
-    if (isInsideMarkdownCodeBlock(lines, lineIndex))
+    }
+    if (isInsideMarkdownCodeBlock(lines, lineIndex)) {
         return true;
+    }
     const trimmed = line.trim();
-    if (trimmed.startsWith('//') || trimmed.startsWith('#') || trimmed.startsWith('--'))
+    if (trimmed.startsWith('//') || trimmed.startsWith('#') || trimmed.startsWith('--')) {
         return true;
-    if (trimmed.startsWith('/*') || trimmed.startsWith('*/'))
+    }
+    if (trimmed.startsWith('/*') || trimmed.startsWith('*/')) {
         return true;
-    if (/\b(?:import|export|require|from)\s+.*["'][^"']+\.[a-zA-Z0-9]+["']/.test(line))
+    }
+    // Não modificar linhas que parecem ser imports/exports de arquivos
+    if (/\b(?:import|export|require|from)\s+.*["'][^"']+\.[a-zA-Z0-9]+["']/.test(line)) {
         return true;
-    if (/^(?:[\/\\]|\.\/|\.\.\/|~\/)[\w-\/\\]+\.[a-zA-Z0-9]+$/.test(trimmed))
+    }
+    // Não modificar linhas que são paths puros
+    if (/^(?:[\/\\]|\.\/|\.\.\/|~\/)[\w-\/\\]+\.[a-zA-Z0-9]+$/.test(trimmed)) {
         return true;
-    if (/\*\*[^*]+\*\*/.test(line) || /(?<!\*)\*[^*\s][^*]*[^*\s]\*(?!\*)/.test(line))
+    }
+    // Não modificar linhas com ênfase markdown (**texto** ou *texto*)
+    if (/\*\*[^*]+\*\*/.test(line) || /(?<!\*)\*[^*\s][^*]*[^*\s]\*(?!\*)/.test(line)) {
         return true;
-    if (/\[!\[/.test(line))
+    }
+    // Não modificar linhas com sintaxe de imagem/link markdown [![...](...)](...
+    if (/\[!\[/.test(line)) {
         return true;
-    if (/^[\s]*\*-\s+\*\*[^*]+\*\*/.test(line))
+    }
+    // Não modificar linhas que começam com padrão changelog *- **texto**
+    if (/^[\s]*\*-\s+\*\*[^*]+\*\*/.test(line)) {
         return true;
+    }
     return false;
 }
 function collapseRepeatedPunct(code) {
@@ -204,8 +229,9 @@ function collapseRepeatedPunct(code) {
     let totalCount = 0;
     let changed = false;
     const out = lines.map((line, idx) => {
-        if (shouldSkipLineForPunctuation(line, idx, lines))
+        if (shouldSkipLineForPunctuation(line, idx, lines)) {
             return line;
+        }
         let count = 0;
         let lineChanged = false;
         let result = line;
@@ -235,8 +261,9 @@ function collapseRepeatedPunct(code) {
                 MULTI_PUNCT_RE.lastIndex = matchIndex + replacement.length;
             }
         }
-        if (lineChanged)
+        if (lineChanged) {
             changed = true;
+        }
         totalCount += count;
         return result;
     });
@@ -258,8 +285,9 @@ function fixNonDotPunct(match, p1, _p2, offset, fullLine) {
     return `${p1} `;
 }
 function fixDotPunct(match, offset, fullLine) {
-    if (isLikelyFilePathOrExtension(fullLine, offset))
+    if (isLikelyFilePathOrExtension(fullLine, offset)) {
         return match;
+    }
     return '. ';
 }
 function fixSpacingAroundPunct(code) {
@@ -268,8 +296,9 @@ function fixSpacingAroundPunct(code) {
     let totalChanges = 0;
     let changed = false;
     const out = lines.map((line, idx) => {
-        if (shouldSkipLineForPunctuation(line, idx, lines))
+        if (shouldSkipLineForPunctuation(line, idx, lines)) {
             return line;
+        }
         const t1 = line.replace(SPACE_BEFORE_PUNCT_RE, '$1');
         const t2 = t1.replace(NO_SPACE_AFTER_NON_DOT_PUNCT_RE, (m, p1, _p2, off) => fixNonDotPunct(m, p1, _p2, off, t1));
         const t3 = t2.replace(NO_SPACE_AFTER_DOT_RE, (m, off) => fixDotPunct(m, off, t2));
@@ -311,8 +340,9 @@ function normalizeRelationalOperators(code) {
     let totalCount = 0;
     let changed = false;
     const out = lines.map((line, idx) => {
-        if (shouldSkipLineForPunctuation(line, idx, lines))
+        if (shouldSkipLineForPunctuation(line, idx, lines)) {
             return line;
+        }
         let result = line;
         for (const { pattern, replacement } of RELATIONAL_OPS) {
             const matches = result.match(pattern);
@@ -321,8 +351,9 @@ function normalizeRelationalOperators(code) {
                 result = result.replace(pattern, replacement);
             }
         }
-        if (result !== line)
+        if (result !== line) {
             changed = true;
+        }
         return result;
     });
     return {
@@ -353,8 +384,9 @@ function skipJsonYamlResult(code) {
     return { text: code, changed: false, stats: { pontuacaoRepetida: 0, espacamentoIncorreto: 0, operadoresRelacionais: 0 } };
 }
 export function corrigirPontuacaoECodigo(code) {
-    if (isJsonOrYaml(code))
+    if (isJsonOrYaml(code)) {
         return skipJsonYamlResult(code);
+    }
     const { text: semHtml, placeholders } = extractHtmlComments(code);
     const { text: collapsed, count: pontuacaoRepetida } = collapseRepeatedPunct(semHtml);
     const { text: spaced, count: espacamentoIncorreto } = fixSpacingAroundPunct(collapsed);
@@ -364,8 +396,9 @@ export function corrigirPontuacaoECodigo(code) {
     return { text: restored, changed, stats: { pontuacaoRepetida, espacamentoIncorreto, operadoresRelacionais } };
 }
 export function corrigirPontuacaoECodigoConservador(code) {
-    if (isJsonOrYaml(code))
+    if (isJsonOrYaml(code)) {
         return skipJsonYamlResult(code);
+    }
     const { text: semHtml, placeholders } = extractHtmlComments(code);
     const { text: collapsed, count: pontuacaoRepetida } = collapseRepeatedPunct(semHtml);
     const { text: spaced, count: espacamentoIncorreto } = corrigirEspacamentoBasicoCodigo(collapsed);
@@ -373,4 +406,3 @@ export function corrigirPontuacaoECodigoConservador(code) {
     const changed = pontuacaoRepetida > 0 || espacamentoIncorreto > 0;
     return { text: restored, changed, stats: { pontuacaoRepetida, espacamentoIncorreto, operadoresRelacionais: 0 } };
 }
-//# sourceMappingURL=commons.js.map

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 = '';
@@ -213,7 +255,7 @@ 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;
@@ -224,13 +266,16 @@ function parseCssTokens(tokenList) {
                             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 +315,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 +347,7 @@ function parseCssTokens(tokenList) {
                     continue;
                 }
             }
+            // It's a selector fragment
             currentSelector = (currentSelector ? `${currentSelector} ` : '') + trimmed;
             idx++;
             continue;
@@ -309,12 +357,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,6 +372,7 @@ 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 {
@@ -329,6 +380,7 @@ function renderCssItems(items, depth) {
             }
         }
         else if (item.kind === 'block') {
+            // 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 !== '') {
@@ -344,6 +396,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 +415,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 +427,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 +447,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 +472,7 @@ export function formatarScssMinimo(code) {
             indent++;
             continue;
         }
+        // --- line contains { inline ---
         if (trimmed.includes('{')) {
             const parts = trimmed.split('{');
             const selector = parts[0]?.trim() ?? '';
@@ -436,7 +502,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 +518,7 @@ export function formatarScssMinimo(code) {
                 continue;
             }
         }
+        // --- everything else ---
         out.push(`${'  '.repeat(indent)}${trimmed.endsWith(';') ? trimmed : trimmed}`);
     }
     const formatted = normalizarNewlinesFinais(out.join('\n'));
@@ -462,7 +531,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