@design-guard/core 0.3.1

package/dist/validation/design-validator.js

@@ -0,0 +1,396 @@
+/**
+ * Design Quality Validator for DESIGN.md files.
+ *
+ * Scores a DESIGN.md across four dimensions — specificity, differentiation,
+ * completeness, and actionability — and surfaces concrete issues.
+ */
+// ─── Hex distance utility ──────────────────────────────────────────
+function parseHex(hex) {
+    const clean = hex.replace('#', '');
+    const r = parseInt(clean.substring(0, 2), 16);
+    const g = parseInt(clean.substring(2, 4), 16);
+    const b = parseInt(clean.substring(4, 6), 16);
+    return [r, g, b];
+}
+/**
+ * Euclidean distance between two hex colors in RGB space.
+ * Threshold for "too similar": distance < 50.
+ */
+export function hexDistance(a, b) {
+    const [r1, g1, b1] = parseHex(a);
+    const [r2, g2, b2] = parseHex(b);
+    return Math.sqrt((r1 - r2) ** 2 + (g1 - g2) ** 2 + (b1 - b2) ** 2);
+}
+// ─── Section extraction helpers ────────────────────────────────────
+function extractSection(markdown, sectionNumber) {
+    const pattern = new RegExp(`## ${sectionNumber}\\..*?\n([\\s\\S]*?)(?=## \\d+\\.|$)`);
+    const match = markdown.match(pattern);
+    return match ? match[1].trim() : '';
+}
+function extractDosSection(markdown) {
+    const match = markdown.match(/### Do\b\n([\s\S]*?)(?=### Don|$)/);
+    return match ? match[1].trim() : '';
+}
+function extractDontsSection(markdown) {
+    const match = markdown.match(/### Don'?t\b\n([\s\S]*?)(?=##|$)/);
+    return match ? match[1].trim() : '';
+}
+function extractColorHexes(markdown) {
+    const section = extractSection(markdown, 2);
+    const hexPattern = /#[0-9A-Fa-f]{6}/g;
+    return [...(section.match(hexPattern) || [])];
+}
+function countColorTableRows(markdown) {
+    const section = extractSection(markdown, 2);
+    const lines = section.split('\n');
+    let count = 0;
+    for (const line of lines) {
+        // Count table rows with hex values, skip header and separator
+        if (line.includes('|') && /#[0-9A-Fa-f]{6}/.test(line)) {
+            count++;
+        }
+    }
+    return count;
+}
+function countListItems(text) {
+    const items = text.split('\n').filter((l) => /^- /.test(l.trim()));
+    return items.length;
+}
+// ─── Sub-scorers ───────────────────────────────────────────────────
+/**
+ * Scores how specific and concrete the DESIGN.md is (0-25).
+ * Penalizes placeholders, generic adjectives, missing hex values, etc.
+ */
+export function scoreSpecificity(markdown) {
+    let score = 25;
+    const issues = [];
+    // -5 for each <!-- --> placeholder
+    const placeholders = (markdown.match(/<!--[\s\S]*?-->/g) || []).length;
+    score -= placeholders * 5;
+    // -3 for generic words used in isolation (not as part of specific rules)
+    const genericWords = ['modern', 'clean', 'professional', 'nice', 'beautiful'];
+    for (const word of genericWords) {
+        // Match word in isolation (not within a quoted string or compound rule)
+        const regex = new RegExp(`(?<![\\w"'])\\b${word}\\b(?![\\w"'])`, 'gi');
+        const matches = markdown.match(regex) || [];
+        // Only penalize if the word appears standalone-ish (not in a longer rule)
+        for (const _match of matches) {
+            // Check context: find the line containing this match
+            const lines = markdown.split('\n');
+            for (const line of lines) {
+                if (regex.test(line)) {
+                    // If line is short (< 40 chars) and mostly just the generic word, penalize
+                    const trimmed = line.replace(/^[-#|*\s]+/, '').trim();
+                    if (trimmed.length < 40 || trimmed.toLowerCase() === word) {
+                        score -= 3;
+                        break;
+                    }
+                }
+            }
+        }
+    }
+    // -2 if no hex color values found in color table
+    const hexes = extractColorHexes(markdown);
+    if (hexes.length === 0) {
+        score -= 2;
+    }
+    // -2 if typography section has no quoted font names
+    const typoSection = extractSection(markdown, 3);
+    if (!/"[^"]+"/.test(typoSection)) {
+        score -= 2;
+    }
+    // -2 for each section with no content, -1 for sections under 20 characters
+    for (let i = 1; i <= 8; i++) {
+        const section = extractSection(markdown, i);
+        if (section.length === 0) {
+            score -= 2;
+        }
+        else if (section.length < 20) {
+            score -= 1;
+        }
+    }
+    return Math.max(0, score);
+}
+/**
+ * Scores how differentiated the design is from competitors (0-25).
+ * Without competitor data, caps at 15 (cannot assess differentiation).
+ */
+export function scoreDifferentiation(markdown, competitors) {
+    const hasCompetitors = competitors && competitors.length > 0;
+    let score = hasCompetitors ? 25 : 15;
+    if (!hasCompetitors)
+        return score;
+    // Extract primary color from markdown (try section 2 first, then full markdown)
+    const colorSection = extractSection(markdown, 2);
+    const searchText = colorSection || markdown;
+    const primaryLine = searchText
+        .split('\n')
+        .find((l) => /primary/i.test(l) && /#[0-9A-Fa-f]{6}/.test(l));
+    const primaryHexMatch = primaryLine?.match(/#[0-9A-Fa-f]{6}/);
+    const primaryHex = primaryHexMatch ? primaryHexMatch[0] : null;
+    if (primaryHex) {
+        for (const comp of competitors) {
+            const compDominant = comp.palette.dominantHex;
+            if (!compDominant)
+                continue;
+            // -8 for exact match
+            if (primaryHex.toLowerCase() === compDominant.toLowerCase()) {
+                score -= 8;
+                break;
+            }
+            // -4 if within distance 30
+            const dist = hexDistance(primaryHex, compDominant);
+            if (dist < 30) {
+                score -= 4;
+                break;
+            }
+            // Also check within distance 50 for a lesser penalty
+            if (dist < 50) {
+                score -= 2;
+                break;
+            }
+        }
+    }
+    // -5 if heading font matches any competitor's heading font
+    const typoSection = extractSection(markdown, 3) || markdown;
+    for (const comp of competitors) {
+        if (comp.typography.headingFont) {
+            if (typoSection.includes(comp.typography.headingFont)) {
+                score -= 5;
+                break;
+            }
+        }
+    }
+    // -3 if "Don't" section doesn't mention any competitor differentiation rule
+    const dontsSection = extractDontsSection(markdown) || markdown;
+    const hasCompetitorMention = competitors.some((c) => dontsSection.toLowerCase().includes(c.name.toLowerCase()) ||
+        (c.typography.headingFont &&
+            dontsSection.includes(c.typography.headingFont)));
+    if (!hasCompetitorMention) {
+        score -= 3;
+    }
+    return Math.max(0, score);
+}
+/**
+ * Scores structural completeness of the DESIGN.md (0-25).
+ * Checks for all 8 sections, color count, component patterns, do/don't counts.
+ */
+export function scoreCompleteness(markdown) {
+    let score = 25;
+    // Check for all 8 section headers
+    for (let i = 1; i <= 8; i++) {
+        const pattern = new RegExp(`## ${i}\\.`);
+        if (!pattern.test(markdown)) {
+            score -= 4;
+        }
+    }
+    // Check color table has >= 5 rows with hex values
+    const colorRows = countColorTableRows(markdown);
+    if (colorRows < 5) {
+        score -= 3;
+    }
+    // Check >= 3 component patterns (subsections under section 5)
+    const compSection = extractSection(markdown, 5);
+    const componentHeaders = (compSection.match(/### /g) || []).length;
+    if (componentHeaders < 3) {
+        score -= 3;
+    }
+    // Check Do's has >= 3 items
+    const dosSection = extractDosSection(markdown);
+    const dosCount = countListItems(dosSection);
+    if (dosCount < 3) {
+        score -= 3;
+    }
+    // Check Don'ts has >= 3 items
+    const dontsSection = extractDontsSection(markdown);
+    const dontsCount = countListItems(dontsSection);
+    if (dontsCount < 3) {
+        score -= 3;
+    }
+    return Math.max(0, score);
+}
+/**
+ * Scores how actionable and implementation-ready the rules are (0-25).
+ * Penalizes vague language, color words without hex, non-numeric sizes.
+ */
+export function scoreActionability(markdown) {
+    let score = 25;
+    const dosSection = extractDosSection(markdown);
+    const dontsSection = extractDontsSection(markdown);
+    const rulesText = `${dosSection}\n${dontsSection}`;
+    // -3 for each "should" or "consider" in Do's/Don'ts
+    const vagueMatches = rulesText.match(/\b(should|consider)\b/gi) || [];
+    score -= vagueMatches.length * 3;
+    // -2 for each rule that is too short to be actionable (< 15 chars)
+    const ruleLines = rulesText.split('\n').filter((l) => /^- /.test(l.trim()));
+    for (const rule of ruleLines) {
+        const content = rule.replace(/^-\s*/, '').trim();
+        if (content.length > 0 && content.length < 15) {
+            score -= 2;
+        }
+    }
+    // -2 for each color described with words instead of hex
+    const colorSection = extractSection(markdown, 2);
+    const colorWordPatterns = [
+        /\b(trustworthy|calming|vibrant|warm|cool)\s+(blue|red|green|yellow|orange|purple|pink|teal)\b/gi,
+    ];
+    for (const pattern of colorWordPatterns) {
+        const matches = colorSection.match(pattern) || [];
+        score -= matches.length * 2;
+    }
+    // -2 for each font size not in px/rem in typography section
+    const typoSection = extractSection(markdown, 3);
+    const sizeEntries = typoSection.match(/\|\s*\w+\s*\|\s*([^|]+)\s*\|/g) || [];
+    for (const entry of sizeEntries) {
+        // Skip header row
+        if (/Size/i.test(entry))
+            continue;
+        if (!/\d+(\.\d+)?(px|rem)/.test(entry)) {
+            score -= 2;
+        }
+    }
+    // -2 if spacing section has no numeric values
+    const spacingSection = extractSection(markdown, 4);
+    if (!/\d+/.test(spacingSection)) {
+        score -= 2;
+    }
+    // -1 for each "e.g." or "for example" in rules
+    const exampleMatches = rulesText.match(/\b(e\.g\.|for example)\b/gi) || [];
+    score -= exampleMatches.length;
+    return Math.max(0, score);
+}
+// ─── Cultural alignment ────────────────────────────────────────────
+/**
+ * Checks for cultural alignment issues in the DESIGN.md.
+ */
+export function checkCulturalAlignment(markdown, locale, audience) {
+    const issues = [];
+    const context = `${locale || ''} ${audience || ''}`.toLowerCase();
+    if (/\bes\b|mexic|latino|latina|español/.test(context)) {
+        // Check for Spanish copy guidance
+        const dosSection = extractDosSection(markdown);
+        const dontsSection = extractDontsSection(markdown);
+        const allRules = `${dosSection}\n${dontsSection}`.toLowerCase();
+        if (!allRules.includes('spanish') &&
+            !allRules.includes('español') &&
+            !allRules.includes('spanish-language')) {
+            issues.push({
+                section: "Do's and Don'ts",
+                severity: 'warning',
+                message: 'No Spanish copy guidance found for Spanish-locale audience — add rules for natural Spanish copy',
+            });
+        }
+        // Check imagery for American/European references
+        const imagerySection = extractSection(markdown, 7).toLowerCase();
+        if (imagerySection.includes('american') ||
+            imagerySection.includes('european')) {
+            issues.push({
+                section: 'Imagery Guidelines',
+                severity: 'info',
+                message: 'Imagery section references "American" or "European" stock — consider local imagery for this audience',
+            });
+        }
+    }
+    return issues;
+}
+// ─── Orchestrator ──────────────────────────────────────────────────
+/**
+ * Orchestrates all sub-scorers and returns a complete quality score.
+ */
+export function scoreDesignMd(markdown, research) {
+    const specificity = scoreSpecificity(markdown);
+    const differentiation = scoreDifferentiation(markdown, research?.competitors);
+    const completeness = scoreCompleteness(markdown);
+    const actionability = scoreActionability(markdown);
+    const total = specificity + differentiation + completeness + actionability;
+    const issues = [];
+    // Collect issues from specificity
+    const placeholders = (markdown.match(/<!--[\s\S]*?-->/g) || []).length;
+    if (placeholders > 0) {
+        issues.push({
+            section: 'General',
+            severity: 'error',
+            message: `Contains ${placeholders} placeholder comment(s) — replace with real content`,
+        });
+    }
+    // Check for vague language in rules
+    const dosSection = extractDosSection(markdown);
+    const dontsSection = extractDontsSection(markdown);
+    const rulesText = `${dosSection}\n${dontsSection}`;
+    if (/\b(should|consider)\b/i.test(rulesText)) {
+        issues.push({
+            section: "Do's and Don'ts",
+            severity: 'warning',
+            message: 'Contains "should" or "consider" — make rules definitive',
+        });
+    }
+    // Check for missing sections
+    for (let i = 1; i <= 8; i++) {
+        const section = extractSection(markdown, i);
+        if (section.length < 20) {
+            const sectionNames = {
+                1: 'Visual Theme & Atmosphere',
+                2: 'Color Palette & Roles',
+                3: 'Typography',
+                4: 'Spacing & Layout',
+                5: 'Component Patterns',
+                6: 'Iconography',
+                7: 'Imagery Guidelines',
+                8: "Do's and Don'ts",
+            };
+            issues.push({
+                section: sectionNames[i] || `Section ${i}`,
+                severity: 'warning',
+                message: `Section has very little content (${section.length} chars)`,
+            });
+        }
+    }
+    // Check competitor differentiation status
+    if (!research?.competitors || research.competitors.length === 0) {
+        issues.push({
+            section: 'Differentiation',
+            severity: 'info',
+            message: 'No competitor data available for differentiation scoring',
+        });
+    }
+    // Cultural alignment issues
+    if (research) {
+        const culturalIssues = checkCulturalAlignment(markdown, research.brief.locale, research.brief.targetAudience);
+        issues.push(...culturalIssues);
+    }
+    return {
+        specificity,
+        differentiation,
+        completeness,
+        actionability,
+        total,
+        issues,
+    };
+}
+// ─── Report formatter ──────────────────────────────────────────────
+/**
+ * Formats a DesignQualityScore into a human-readable report.
+ */
+export function formatDesignQualityReport(score) {
+    const lines = [];
+    lines.push(`Design Quality: ${score.total}/100`);
+    lines.push('');
+    lines.push(`  Specificity:      ${String(score.specificity).padStart(2)}/25`);
+    lines.push(`  Differentiation:  ${String(score.differentiation).padStart(2)}/25`);
+    lines.push(`  Completeness:     ${String(score.completeness).padStart(2)}/25`);
+    lines.push(`  Actionability:    ${String(score.actionability).padStart(2)}/25`);
+    if (score.issues.length > 0) {
+        lines.push('');
+        lines.push('Issues:');
+        for (const issue of score.issues) {
+            const icon = issue.severity === 'error'
+                ? '[!]'
+                : issue.severity === 'warning'
+                    ? '[!]'
+                    : '[i]';
+            lines.push(`  ${icon} Section "${issue.section}": ${issue.message}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=design-validator.js.map

package/dist/validation/design-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-validator.js","sourceRoot":"","sources":["../../src/validation/design-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,sEAAsE;AAEtE,SAAS,QAAQ,CAAC,GAAW;IAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS;IAC9C,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,sEAAsE;AAEtE,SAAS,cAAc,CAAC,QAAgB,EAAE,aAAqB;IAC7D,MAAM,OAAO,GAAG,IAAI,MAAM,CACxB,MAAM,aAAa,sCAAsC,CAC1D,CAAC;IACF,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAgB;IAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,kBAAkB,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAgB;IAC3C,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,8DAA8D;QAC9D,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvD,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACnE,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC;AAED,sEAAsE;AAEtE;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,mCAAmC;IACnC,MAAM,YAAY,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACvE,KAAK,IAAI,YAAY,GAAG,CAAC,CAAC;IAE1B,yEAAyE;IACzE,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC9E,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,wEAAwE;QACxE,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,kBAAkB,IAAI,gBAAgB,EAAE,IAAI,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5C,0EAA0E;QAC1E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,qDAAqD;YACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrB,2EAA2E;oBAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;oBACtD,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC;wBAC1D,KAAK,IAAI,CAAC,CAAC;wBACX,MAAM;oBACR,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,oDAAoD;IACpD,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,2EAA2E;IAC3E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC/B,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,WAAkC;IAElC,MAAM,cAAc,GAAG,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7D,IAAI,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAErC,IAAI,CAAC,cAAc;QAAE,OAAO,KAAK,CAAC;IAElC,gFAAgF;IAChF,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,YAAY,IAAI,QAAQ,CAAC;IAC5C,MAAM,WAAW,GAAG,UAAU;SAC3B,KAAK,CAAC,IAAI,CAAC;SACX,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,eAAe,GAAG,WAAW,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE/D,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;YAC9C,IAAI,CAAC,YAAY;gBAAE,SAAS;YAE5B,qBAAqB;YACrB,IAAI,UAAU,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC5D,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM;YACR,CAAC;YAED,2BAA2B;YAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YACnD,IAAI,IAAI,GAAG,EAAE,EAAE,CAAC;gBACd,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM;YACR,CAAC;YAED,qDAAqD;YACrD,IAAI,IAAI,GAAG,EAAE,EAAE,CAAC;gBACd,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC5D,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;YAChC,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBACtD,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;IAC/D,MAAM,oBAAoB,GAAG,WAAW,CAAC,IAAI,CAC3C,CAAC,CAAC,EAAE,EAAE,CACJ,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACzD,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW;YACvB,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CACrD,CAAC;IACF,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,IAAI,KAAK,GAAG,EAAE,CAAC;IAEf,kCAAkC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,MAAM,SAAS,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,8DAA8D;IAC9D,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAChD,MAAM,gBAAgB,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACnE,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,4BAA4B;IAC5B,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,8BAA8B;IAC9B,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,IAAI,KAAK,GAAG,EAAE,CAAC;IAEf,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,GAAG,UAAU,KAAK,YAAY,EAAE,CAAC;IAEnD,oDAAoD;IACpD,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,yBAAyB,CAAC,IAAI,EAAE,CAAC;IACtE,KAAK,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAEjC,mEAAmE;IACnE,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5E,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC9C,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACjD,MAAM,iBAAiB,GAAG;QACxB,iGAAiG;KAClG,CAAC;IACF,KAAK,MAAM,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClD,KAAK,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,4DAA4D;IAC5D,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CACnC,+BAA+B,CAChC,IAAI,EAAE,CAAC;IACR,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,kBAAkB;QAClB,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS;QAClC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,MAAM,cAAc,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,+CAA+C;IAC/C,MAAM,cAAc,GAClB,SAAS,CAAC,KAAK,CAAC,4BAA4B,CAAC,IAAI,EAAE,CAAC;IACtD,KAAK,IAAI,cAAc,CAAC,MAAM,CAAC;IAE/B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,sEAAsE;AAEtE;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAgB,EAChB,MAAe,EACf,QAAiB;IAEjB,MAAM,MAAM,GAAyB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,GAAG,MAAM,IAAI,EAAE,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC;IAElE,IAAI,oCAAoC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,kCAAkC;QAClC,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,GAAG,UAAU,KAAK,YAAY,EAAE,CAAC,WAAW,EAAE,CAAC;QAEhE,IACE,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC7B,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC7B,CAAC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EACtC,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,iBAAiB;gBAC1B,QAAQ,EAAE,SAAS;gBACnB,OAAO,EACL,iGAAiG;aACpG,CAAC,CAAC;QACL,CAAC;QAED,iDAAiD;QACjD,MAAM,cAAc,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACjE,IACE,cAAc,CAAC,QAAQ,CAAC,UAAU,CAAC;YACnC,cAAc,CAAC,QAAQ,CAAC,UAAU,CAAC,EACnC,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,oBAAoB;gBAC7B,QAAQ,EAAE,MAAM;gBAChB,OAAO,EACL,sGAAsG;aACzG,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,sEAAsE;AAEtE;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,QAAiC;IAEjC,MAAM,WAAW,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,eAAe,GAAG,oBAAoB,CAC1C,QAAQ,EACR,QAAQ,EAAE,WAAW,CACtB,CAAC;IACF,MAAM,YAAY,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,aAAa,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,WAAW,GAAG,eAAe,GAAG,YAAY,GAAG,aAAa,CAAC;IAE3E,MAAM,MAAM,GAAyB,EAAE,CAAC;IAExC,kCAAkC;IAClC,MAAM,YAAY,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACvE,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC;YACV,OAAO,EAAE,SAAS;YAClB,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,YAAY,YAAY,qDAAqD;SACvF,CAAC,CAAC;IACL,CAAC;IAED,oCAAoC;IACpC,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,GAAG,UAAU,KAAK,YAAY,EAAE,CAAC;IACnD,IAAI,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC;YACV,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,yDAAyD;SACnE,CAAC,CAAC;IACL,CAAC;IAED,6BAA6B;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACxB,MAAM,YAAY,GAA2B;gBAC3C,CAAC,EAAE,2BAA2B;gBAC9B,CAAC,EAAE,uBAAuB;gBAC1B,CAAC,EAAE,YAAY;gBACf,CAAC,EAAE,kBAAkB;gBACrB,CAAC,EAAE,oBAAoB;gBACvB,CAAC,EAAE,aAAa;gBAChB,CAAC,EAAE,oBAAoB;gBACvB,CAAC,EAAE,iBAAiB;aACrB,CAAC;YACF,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,EAAE;gBAC1C,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,oCAAoC,OAAO,CAAC,MAAM,SAAS;aACrE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,IAAI,CAAC,QAAQ,EAAE,WAAW,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC;YACV,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE,MAAM;YAChB,OAAO,EACL,0DAA0D;SAC7D,CAAC,CAAC;IACL,CAAC;IAED,4BAA4B;IAC5B,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,cAAc,GAAG,sBAAsB,CAC3C,QAAQ,EACR,QAAQ,CAAC,KAAK,CAAC,MAAM,EACrB,QAAQ,CAAC,KAAK,CAAC,cAAc,CAC9B,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;IACjC,CAAC;IAED,OAAO;QACL,WAAW;QACX,eAAe;QACf,YAAY;QACZ,aAAa;QACb,KAAK;QACL,MAAM;KACP,CAAC;AACJ,CAAC;AAED,sEAAsE;AAEtE;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAyB;IAEzB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,KAAK,MAAM,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CACR,uBAAuB,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CACtE,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CACR,uBAAuB,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CACpE,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,IAAI,GACR,KAAK,CAAC,QAAQ,KAAK,OAAO;gBACxB,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS;oBAC5B,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,KAAK,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,aAAa,KAAK,CAAC,OAAO,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/validation/output-validator.d.ts

@@ -0,0 +1,46 @@
+export type IssueCategory = 'color' | 'typography' | 'layout' | 'content' | 'structure' | 'slop' | 'accessibility';
+export interface ValidationIssue {
+    type: 'error' | 'warning' | 'info';
+    category: IssueCategory;
+    message: string;
+}
+export interface CategoryScore {
+    score: number;
+    issues: number;
+    maxPossible: number;
+}
+export interface ScoringBreakdown {
+    typography: CategoryScore;
+    color: CategoryScore;
+    layout: CategoryScore;
+    content: CategoryScore;
+    structure: CategoryScore;
+    slop: CategoryScore;
+    accessibility: CategoryScore;
+}
+export interface OutputValidationResult {
+    /** Overall quality score 0-100 */
+    score: number;
+    /** All detected issues */
+    issues: ValidationIssue[];
+    /** Whether the output passes the quality threshold (score >= 70) */
+    passed: boolean;
+    /** 0-100 confidence -- how much of the page we actually checked */
+    confidence: number;
+    /** Per-category score breakdown */
+    breakdown: ScoringBreakdown;
+}
+/**
+ * Validate generated HTML against design system and quality rules.
+ *
+ * Uses the modular rule registry -- each check is an independent LintRule.
+ * Returns an enhanced result with per-category breakdown and confidence metric.
+ *
+ * Scoring: error=-20, warning=-10, info=-5, threshold=70 (Frente C calibration).
+ */
+export declare function validateOutput(html: string, designMdPath?: string): OutputValidationResult;
+/**
+ * Format validation results for display.
+ */
+export declare function formatValidationReport(result: OutputValidationResult): string;
+//# sourceMappingURL=output-validator.d.ts.map

package/dist/validation/output-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-validator.d.ts","sourceRoot":"","sources":["../../src/validation/output-validator.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,eAAe,CAAC;AAEnH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACnC,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,aAAa,CAAC;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,aAAa,CAAC;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AA4CD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAwE1F;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CA8C7E"}

package/dist/validation/output-validator.js

@@ -0,0 +1,146 @@
+import { load } from 'cheerio';
+import { existsSync, readFileSync } from 'node:fs';
+import { getAllRules } from './rules/index.js';
+// ---------------------------------------------------------------------------
+// Scoring engine (Frente C: error=-20, warn=-10, info=-5, threshold=70)
+// ---------------------------------------------------------------------------
+const DEDUCTION = {
+    error: 20,
+    warning: 10,
+    info: 5,
+};
+const PASS_THRESHOLD = 70;
+const ALL_CATEGORIES = [
+    'typography', 'color', 'layout', 'content', 'structure', 'slop', 'accessibility',
+];
+function computeBreakdown(issues, rulesRanByCategory) {
+    const breakdown = {};
+    for (const cat of ALL_CATEGORIES) {
+        const catIssues = issues.filter(i => i.category === cat);
+        const maxPossible = rulesRanByCategory.get(cat) ?? 0;
+        const deductions = catIssues.reduce((sum, i) => sum + DEDUCTION[i.type], 0);
+        const rawScore = maxPossible > 0 ? Math.max(0, 100 - deductions) : 100;
+        breakdown[cat] = {
+            score: rawScore,
+            issues: catIssues.length,
+            maxPossible,
+        };
+    }
+    return breakdown;
+}
+// ---------------------------------------------------------------------------
+// Main validator
+// ---------------------------------------------------------------------------
+/**
+ * Validate generated HTML against design system and quality rules.
+ *
+ * Uses the modular rule registry -- each check is an independent LintRule.
+ * Returns an enhanced result with per-category breakdown and confidence metric.
+ *
+ * Scoring: error=-20, warning=-10, info=-5, threshold=70 (Frente C calibration).
+ */
+export function validateOutput(html, designMdPath) {
+    const $ = load(html);
+    // Build shared context once for all rules
+    const allStyles = $('style').text() +
+        $('[style]')
+            .map((_i, el) => $(el).attr('style'))
+            .get()
+            .join(' ');
+    const allClasses = $('[class]')
+        .map((_i, el) => $(el).attr('class'))
+        .get()
+        .join(' ');
+    // Load DESIGN.md content
+    const resolvedPath = designMdPath ?? 'DESIGN.md';
+    const designMdContent = existsSync(resolvedPath) ? readFileSync(resolvedPath, 'utf-8') : undefined;
+    const context = {
+        html,
+        allStyles,
+        allClasses,
+        $,
+        designMdContent,
+    };
+    // Run all applicable rules and track which ones ran
+    const allRules = getAllRules();
+    const allIssues = [];
+    const rulesRanByCategory = new Map();
+    const totalRulesAvailable = allRules.length;
+    let rulesChecked = 0;
+    for (const rule of allRules) {
+        // Skip rules that require DESIGN.md when it is not available
+        if (rule.requiresDesign && !designMdContent) {
+            continue;
+        }
+        rulesChecked++;
+        const cat = rule.category;
+        const count = rulesRanByCategory.get(cat) ?? 0;
+        rulesRanByCategory.set(cat, count + 1);
+        const ruleIssues = rule.check(context);
+        allIssues.push(...ruleIssues);
+    }
+    // Calculate confidence: what fraction of rules could actually run
+    const confidence = totalRulesAvailable > 0
+        ? Math.round((rulesChecked / totalRulesAvailable) * 100)
+        : 0;
+    // Calculate overall score
+    const errorCount = allIssues.filter(i => i.type === 'error').length;
+    const warningCount = allIssues.filter(i => i.type === 'warning').length;
+    const infoCount = allIssues.filter(i => i.type === 'info').length;
+    const score = Math.max(0, 100 - (errorCount * DEDUCTION.error) - (warningCount * DEDUCTION.warning) - (infoCount * DEDUCTION.info));
+    const breakdown = computeBreakdown(allIssues, rulesRanByCategory);
+    return {
+        score,
+        issues: allIssues,
+        passed: score >= PASS_THRESHOLD,
+        confidence,
+        breakdown,
+    };
+}
+// ---------------------------------------------------------------------------
+// Report formatter
+// ---------------------------------------------------------------------------
+/**
+ * Format validation results for display.
+ */
+export function formatValidationReport(result) {
+    const lines = [];
+    const passLabel = result.passed ? 'PASS' : 'NEEDS REVIEW';
+    lines.push(`Quality Score: ${result.score}/100 (${passLabel}) [confidence: ${result.confidence}%]`);
+    lines.push('');
+    // Category breakdown
+    lines.push('Category Breakdown:');
+    for (const cat of ALL_CATEGORIES) {
+        const b = result.breakdown[cat];
+        if (b.maxPossible > 0) {
+            lines.push(`  ${cat.padEnd(14)} ${b.score}/100  (${b.issues} issue${b.issues !== 1 ? 's' : ''}, ${b.maxPossible} rule${b.maxPossible !== 1 ? 's' : ''} checked)`);
+        }
+        else {
+            lines.push(`  ${cat.padEnd(14)} --  (no rules ran)`);
+        }
+    }
+    lines.push('');
+    if (result.issues.length === 0) {
+        lines.push('No issues detected.');
+        return lines.join('\n');
+    }
+    const errors = result.issues.filter(i => i.type === 'error');
+    const warnings = result.issues.filter(i => i.type === 'warning');
+    const infos = result.issues.filter(i => i.type === 'info');
+    if (errors.length > 0) {
+        lines.push('Errors:');
+        errors.forEach(e => lines.push(`  [x] ${e.message}`));
+        lines.push('');
+    }
+    if (warnings.length > 0) {
+        lines.push('Warnings:');
+        warnings.forEach(w => lines.push(`  [!] ${w.message}`));
+        lines.push('');
+    }
+    if (infos.length > 0) {
+        lines.push('Info:');
+        infos.forEach(i => lines.push(`  [i] ${i.message}`));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=output-validator.js.map

package/dist/validation/output-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-validator.js","sourceRoot":"","sources":["../../src/validation/output-validator.ts"],"names":[],"mappings":"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"}

package/dist/validation/rules/alt-text.d.ts

@@ -0,0 +1,8 @@
+import type { LintRule } from './types.js';
+/**
+ * Checks for missing img alt attributes.
+ * Bug Fix (Frente A): detects data-alt without alt (Stitch pattern),
+ * separately counts data-alt-only vs fully missing alt.
+ */
+export declare const altText: LintRule;
+//# sourceMappingURL=alt-text.d.ts.map

package/dist/validation/rules/alt-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alt-text.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/alt-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,YAAY,CAAC;AAGxD;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,QAiCrB,CAAC"}