vtex-css-sanitizer-cli/dist/utils/report-generator.js

Herramienta CLI para eliminar CSS y blockClass no utilizados en proyectos VTEX IO.

"use strict";
var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
exports.generateAnalysisReport = generateAnalysisReport;
exports.generateFixReport = generateFixReport;
const promises_1 = __importDefault(require("fs/promises"));
const path_1 = __importDefault(require("path"));
// --- Helper para crear el directorio de informes ---
async function ensureReportDirectory(projectPath) {
    const reportDir = path_1.default.join(projectPath, '.sanitizer-reports');
    await promises_1.default.mkdir(reportDir, { recursive: true }); // recursive: true evita errores si el dir ya existe
    return reportDir;
}
// --- Helper para obtener la fecha en formato YYYY-MM-DD ---
function getFormattedDate() {
    const date = new Date();
    const year = date.getFullYear();
    const month = (date.getMonth() + 1).toString().padStart(2, '0');
    const day = date.getDate().toString().padStart(2, '0');
    return `${year}-${month}-${day}`;
}
// --- Generador para el informe de 'analyze' ---
async function generateAnalysisReport(projectPath, unusedCss, unusedBlockClasses, usedCssSuffixesMap, declaredBlockClassesMap) {
    const reportDir = await ensureReportDirectory(projectPath);
    const reportPath = path_1.default.join(reportDir, `analysis-report-${getFormattedDate()}.md`);
    let markdownContent = `# ✅ Informe de Análisis de CSS - ${getFormattedDate()}\n\n`;
    markdownContent += `Este informe detalla las clases CSS y declaraciones \`blockClass\` que podrían estar sin uso en el proyecto.\n\n`;
    markdownContent += `--- \n\n`;
    // Sección 1: CSS sin uso
    markdownContent += `## 🔴 Sufijos CSS sin \`blockClass\` correspondiente (${unusedCss.length} encontrados)\n\n`;
    if (unusedCss.length > 0) {
        unusedCss.forEach(suffix => {
            markdownContent += `### \`--${suffix}\`\n\n`;
            const locations = usedCssSuffixesMap.get(suffix) || [];
            locations.slice(0, 5).forEach(loc => {
                markdownContent += `*   **Usado en:** \`${path_1.default.relative(projectPath, loc.filePath)}\`\n`;
                markdownContent += `*   **Selector:** \`${loc.selector}\`\n\n`;
            });
        });
    }
    else {
        markdownContent += `¡Excelente! No se encontraron sufijos CSS sin uso.\n\n`;
    }
    markdownContent += `--- \n\n`;
    // Sección 2: blockClass sin uso
    markdownContent += `## 🟡 \`blockClass\` sin estilos CSS asociados (${unusedBlockClasses.length} encontrados)\n\n`;
    if (unusedBlockClasses.length > 0) {
        unusedBlockClasses.forEach(cls => {
            markdownContent += `### \`"${cls}"\`\n\n`;
            const locations = declaredBlockClassesMap.get(cls) || [];
            locations.slice(0, 5).forEach(loc => {
                markdownContent += `*   **Declarado en:** \`${path_1.default.relative(projectPath, loc.filePath)}\`\n`;
                markdownContent += `*   **Bloque:** \`${loc.blockName}\`\n\n`;
            });
        });
    }
    else {
        markdownContent += `¡Genial! Todas las \`blockClass\` declaradas se están utilizando.\n\n`;
    }
    await promises_1.default.writeFile(reportPath, markdownContent);
    return reportPath;
}
async function generateFixReport(projectPath, deletedRules, keptRules) {
    const reportDir = await ensureReportDirectory(projectPath);
    const reportPath = path_1.default.join(reportDir, `fix-report-${getFormattedDate()}.md`);
    let markdownContent = `# 🛠️ Informe de Limpieza de CSS - ${getFormattedDate()}\n\n`;
    markdownContent += `Este informe detalla las acciones realizadas durante el proceso de limpieza interactiva.\n\n`;
    markdownContent += `--- \n\n`;
    // Sección 1: Reglas eliminadas
    markdownContent += `## 🗑️ Reglas Eliminadas (${deletedRules.length})\n\n`;
    if (deletedRules.length > 0) {
        deletedRules.forEach(entry => {
            markdownContent += `*   **Archivo:** \`${path_1.default.relative(projectPath, entry.filePath)}\`\n`;
            markdownContent += `    \`\`\`css\n    ${entry.rule}\n    \`\`\`\n\n`;
        });
    }
    else {
        markdownContent += `No se eliminó ninguna regla durante esta sesión.\n\n`;
    }
    markdownContent += `--- \n\n`;
    // Sección 2: Reglas conservadas
    markdownContent += `## 👍 Reglas Conservadas por el Usuario (${keptRules.length})\n\n`;
    if (keptRules.length > 0) {
        keptRules.forEach(entry => {
            markdownContent += `*   **Archivo:** \`${path_1.default.relative(projectPath, entry.filePath)}\`\n`;
            markdownContent += `    \`\`\`css\n    ${entry.rule}\n    \`\`\`\n\n`;
        });
    }
    else {
        markdownContent += `No se conservó ninguna regla candidata durante esta sesión.\n\n`;
    }
    await promises_1.default.writeFile(reportPath, markdownContent);
    return reportPath;
}