stitch-forge 0.3.1

package/dist/utils/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/utils/design-validator.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,8 @@
+export declare const log: {
+    info: (msg: string) => void;
+    success: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    step: (n: number, total: number, msg: string) => void;
+    quota: (model: string, used: number, limit: number) => void;
+};

package/dist/utils/logger.js

@@ -0,0 +1,10 @@
+import chalk from 'chalk';
+export const log = {
+    info: (msg) => console.error(chalk.blue('ℹ'), msg),
+    success: (msg) => console.error(chalk.green('✓'), msg),
+    warn: (msg) => console.error(chalk.yellow('⚠'), msg),
+    error: (msg) => console.error(chalk.red('✗'), msg),
+    step: (n, total, msg) => console.error(chalk.dim(`[${n}/${total}]`), msg),
+    quota: (model, used, limit) => console.error(chalk.dim(`${model}: ${used}/${limit} used`)),
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IAC1D,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IAC9D,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IAC5D,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IAC1D,IAAI,EAAE,CAAC,CAAS,EAAE,KAAa,EAAE,GAAW,EAAE,EAAE,CAC9C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC;IAClD,KAAK,EAAE,CAAC,KAAa,EAAE,IAAY,EAAE,KAAa,EAAE,EAAE,CACpD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,IAAI,IAAI,KAAK,OAAO,CAAC,CAAC;CAC9D,CAAC"}

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

@@ -0,0 +1,18 @@
+export interface ValidationIssue {
+    type: 'error' | 'warning' | 'info';
+    category: 'color' | 'typography' | 'accessibility' | 'slop' | 'structure';
+    message: string;
+}
+export interface OutputValidationResult {
+    score: number;
+    issues: ValidationIssue[];
+    passed: boolean;
+}
+/**
+ * Validate generated HTML against design system and quality rules.
+ */
+export declare function validateOutput(html: string): OutputValidationResult;
+/**
+ * Format validation results for display.
+ */
+export declare function formatValidationReport(result: OutputValidationResult): string;

package/dist/utils/output-validator.js

@@ -0,0 +1,194 @@
+import { load } from 'cheerio';
+import { existsSync, readFileSync } from 'node:fs';
+/**
+ * Validate generated HTML against design system and quality rules.
+ */
+export function validateOutput(html) {
+    const issues = [];
+    const $ = load(html);
+    // 0. Check for empty or minimal HTML
+    const bodyText = $('body').text().trim();
+    if (!bodyText && $('body *').length === 0) {
+        issues.push({
+            type: 'error',
+            category: 'structure',
+            message: 'Generated HTML is empty — no content in body.',
+        });
+    }
+    // 1. Check for AI slop font patterns (both CSS and Tailwind classes)
+    const allStyles = $('style').text() + ($('[style]').map((_i, el) => $(el).attr('style')).get().join(' '));
+    const allClasses = $('[class]').map((_i, el) => $(el).attr('class')).get().join(' ');
+    if (/font-family[^;]*\bInter\b/i.test(allStyles) && !isIntentionalFont('Inter')) {
+        issues.push({
+            type: 'warning',
+            category: 'slop',
+            message: 'Detected "Inter" font — common AI default. Consider a more distinctive typeface.',
+        });
+    }
+    if (/font-family[^;]*\bPoppins\b/i.test(allStyles) && !isIntentionalFont('Poppins')) {
+        issues.push({
+            type: 'warning',
+            category: 'slop',
+            message: 'Detected "Poppins" font — common AI default. Consider a more distinctive typeface.',
+        });
+    }
+    // 1b. Check Tailwind font classes (font-sans resolves to Inter/system-ui)
+    if (/\bfont-sans\b/.test(allClasses) && !isIntentionalFont('Inter')) {
+        issues.push({
+            type: 'info',
+            category: 'slop',
+            message: 'Tailwind "font-sans" class detected — resolves to system sans-serif. Consider specifying a custom font.',
+        });
+    }
+    // 2. Check for purple-to-blue gradients
+    if (/gradient[^;]*(purple|#[89a-f][0-9a-f]{5})[^;]*(blue|#[0-5][0-9a-f]{5})/i.test(allStyles) ||
+        /gradient[^;]*(blue|#[0-5][0-9a-f]{5})[^;]*(purple|#[89a-f][0-9a-f]{5})/i.test(allStyles)) {
+        issues.push({
+            type: 'warning',
+            category: 'slop',
+            message: 'Detected purple-to-blue gradient — extremely common AI pattern.',
+        });
+    }
+    // 3. Check heading hierarchy
+    const headings = $('h1, h2, h3, h4, h5, h6').map((_i, el) => parseInt(el.tagName[1])).get();
+    if (headings.length > 0) {
+        for (let i = 1; i < headings.length; i++) {
+            if (headings[i] > headings[i - 1] + 1) {
+                issues.push({
+                    type: 'warning',
+                    category: 'structure',
+                    message: `Heading hierarchy skip: h${headings[i - 1]} → h${headings[i]}. Should not skip levels.`,
+                });
+                break;
+            }
+        }
+    }
+    // 4. Check for missing alt attributes
+    const imgsWithoutAlt = $('img:not([alt])').length;
+    if (imgsWithoutAlt > 0) {
+        issues.push({
+            type: 'error',
+            category: 'accessibility',
+            message: `${imgsWithoutAlt} image(s) missing alt attribute.`,
+        });
+    }
+    // 5. Check for DESIGN.md color adherence
+    const designColors = extractDesignColors();
+    if (designColors.length > 0) {
+        const usedColors = extractUsedColors(allStyles);
+        const unmatchedColors = usedColors.filter(c => !designColors.some(dc => dc.toLowerCase() === c.toLowerCase()) &&
+            !isNeutralColor(c));
+        if (unmatchedColors.length > 3) {
+            issues.push({
+                type: 'warning',
+                category: 'color',
+                message: `${unmatchedColors.length} colors used that aren't in DESIGN.md palette. Output may deviate from design system.`,
+            });
+        }
+    }
+    // 6. Check for three-column icon grid as second section (classic AI slop)
+    const sections = $('section, [class*="section"], main > div').toArray();
+    if (sections.length >= 2) {
+        const secondSection = $(sections[1]);
+        const icons = secondSection.find('svg, [class*="icon"], i[class]');
+        const columns = secondSection.find('[class*="col"], [class*="grid"]');
+        if (icons.length === 3 && columns.length > 0) {
+            issues.push({
+                type: 'info',
+                category: 'slop',
+                message: 'Second section appears to be a three-column icon grid — very common AI layout pattern.',
+            });
+        }
+    }
+    // 7. Check business model alignment (if DESIGN.md has business context)
+    if (existsSync('DESIGN.md')) {
+        const designContent = readFileSync('DESIGN.md', 'utf-8').toLowerCase();
+        // If NOT e-commerce, check for cart/checkout in generated HTML
+        if (designContent.includes('not an e-commerce') || designContent.includes('not e-commerce') || designContent.includes('no online purchasing')) {
+            const htmlLower = html.toLowerCase();
+            if (/\b(add.?to.?cart|shopping.?cart|checkout|buy.?now|carrito)\b/i.test(htmlLower)) {
+                issues.push({
+                    type: 'error',
+                    category: 'structure',
+                    message: 'Generated HTML contains e-commerce elements (cart/checkout) but DESIGN.md specifies this is NOT an e-commerce site.',
+                });
+            }
+        }
+        // If store locator is key, check for location-related elements
+        if (designContent.includes('store locator') || designContent.includes('find nearest store')) {
+            const hasLocationElements = /\b(location|store.?finder|find.?store|sucursal|ubicaci|postal|zip.?code|mapa|map)\b/i.test(html.toLowerCase());
+            if (!hasLocationElements) {
+                issues.push({
+                    type: 'info',
+                    category: 'structure',
+                    message: 'DESIGN.md specifies store locator as key feature but no location/finder elements detected in output.',
+                });
+            }
+        }
+    }
+    // Calculate score
+    const errorCount = issues.filter(i => i.type === 'error').length;
+    const warningCount = issues.filter(i => i.type === 'warning').length;
+    const infoCount = issues.filter(i => i.type === 'info').length;
+    const score = Math.max(0, 100 - (errorCount * 15) - (warningCount * 8) - (infoCount * 3));
+    return {
+        score,
+        issues,
+        passed: score >= 60,
+    };
+}
+function isIntentionalFont(fontName) {
+    if (!existsSync('DESIGN.md'))
+        return false;
+    const content = readFileSync('DESIGN.md', 'utf-8');
+    return content.includes(fontName);
+}
+function extractDesignColors() {
+    if (!existsSync('DESIGN.md'))
+        return [];
+    const content = readFileSync('DESIGN.md', 'utf-8');
+    const hexMatches = content.match(/#[0-9A-Fa-f]{6}/g) || [];
+    return [...new Set(hexMatches)];
+}
+function extractUsedColors(styles) {
+    const hexMatches = styles.match(/#[0-9A-Fa-f]{6}/g) || [];
+    return [...new Set(hexMatches)];
+}
+function isNeutralColor(hex) {
+    const r = parseInt(hex.slice(1, 3), 16);
+    const g = parseInt(hex.slice(3, 5), 16);
+    const b = parseInt(hex.slice(5, 7), 16);
+    const maxDiff = Math.max(Math.abs(r - g), Math.abs(g - b), Math.abs(r - b));
+    return maxDiff < 20; // Nearly grayscale
+}
+/**
+ * Format validation results for display.
+ */
+export function formatValidationReport(result) {
+    const lines = [];
+    lines.push(`Quality Score: ${result.score}/100 (${result.passed ? 'PASS' : 'NEEDS REVIEW'})`);
+    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