popeye-cli 1.4.7 → 1.6.0

package/dist/generators/website-context.js

@@ -0,0 +1,350 @@
+/**
+ * Website content context builder
+ * Discovers user documentation and brand assets to populate website templates
+ * with project-specific content instead of generic placeholders
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { stripCodeFences, extractProductName, extractTagline, extractDescription, extractFeatures, extractPricing, extractPrimaryColor, } from './doc-parser.js';
+import { getScanDirectories } from './workspace-root.js';
+/** Per-file character cap to prevent a single large doc from consuming the budget */
+const PER_FILE_CAP = 8000;
+/**
+ * Resolve brand assets into a deterministic contract
+ * Searches for logo/favicon in project directory and workspace root,
+ * sets canonical output paths
+ *
+ * @param cwd - Directory to scan for brand assets
+ * @param brandContext - Optional existing brand context from state
+ * @returns Resolved brand assets contract
+ */
+export async function resolveBrandAssets(cwd, brandContext) {
+    const assets = await findBrandAssets(cwd);
+    const logoPath = brandContext?.logoPath || assets.logoPath;
+    const ext = logoPath ? path.extname(logoPath) : '.svg';
+    return {
+        logoPath,
+        logoOutputPath: `public/brand/logo${ext}`,
+        primaryColor: brandContext?.primaryColor,
+    };
+}
+/** Patterns to match documentation files */
+const DOC_PATTERNS = [
+    /spec/i,
+    /pricing/i,
+    /color/i,
+    /brand/i,
+    /ui[\s_-]?spec/i,
+    /^readme\.md$/i,
+    /overview/i,
+    /features/i,
+    /product/i,
+];
+/** Directories to exclude from scanning */
+const EXCLUDED_DIRS = [
+    'node_modules',
+    '.popeye',
+    '.git',
+    'dist',
+    'build',
+    '.next',
+    '__pycache__',
+    'venv',
+    '.venv',
+    'coverage',
+];
+/**
+ * Discover project documentation files in a directory
+ *
+ * @param cwd - Directory to scan for documentation
+ * @returns Array of absolute paths to discovered doc files
+ */
+export async function discoverProjectDocs(cwd) {
+    const scanDirs = await getScanDirectories(cwd);
+    const allDocs = [];
+    const seenPaths = new Set();
+    for (const dir of scanDirs) {
+        const found = await scanDirectoryForDocs(dir);
+        for (const docPath of found) {
+            const resolved = path.resolve(docPath);
+            if (!seenPaths.has(resolved)) {
+                seenPaths.add(resolved);
+                allDocs.push(resolved);
+            }
+        }
+    }
+    // Sort: brand/color docs first, then spec, then pricing, then others
+    // Reason: ensures critical brand context isn't truncated by the maxLength cap
+    allDocs.sort((a, b) => {
+        const nameA = path.basename(a).toLowerCase();
+        const nameB = path.basename(b).toLowerCase();
+        const priorityA = getDocPriority(nameA);
+        const priorityB = getDocPriority(nameB);
+        return priorityA - priorityB;
+    });
+    return allDocs;
+}
+/**
+ * Get sort priority for a doc file (lower = higher priority)
+ */
+function getDocPriority(fileName) {
+    if (/color|brand/.test(fileName))
+        return 0;
+    if (/spec/.test(fileName))
+        return 1;
+    if (/pricing/.test(fileName))
+        return 2;
+    if (/feature/.test(fileName))
+        return 3;
+    return 4;
+}
+/**
+ * Scan a single directory for doc files (flat + docs/ subdirectory)
+ */
+async function scanDirectoryForDocs(dir) {
+    const docs = [];
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory() && EXCLUDED_DIRS.includes(entry.name)) {
+                continue;
+            }
+            if (entry.isFile() && entry.name.endsWith('.md')) {
+                const matches = DOC_PATTERNS.some((pattern) => pattern.test(entry.name));
+                if (matches) {
+                    docs.push(path.join(dir, entry.name));
+                }
+            }
+            // Check one level of subdirectories (e.g., docs/)
+            if (entry.isDirectory() && entry.name === 'docs') {
+                try {
+                    const subEntries = await fs.readdir(path.join(dir, entry.name), {
+                        withFileTypes: true,
+                    });
+                    for (const subEntry of subEntries) {
+                        if (subEntry.isFile() && subEntry.name.endsWith('.md')) {
+                            docs.push(path.join(dir, entry.name, subEntry.name));
+                        }
+                    }
+                }
+                catch {
+                    // Skip unreadable directories
+                }
+            }
+        }
+    }
+    catch {
+        // Directory not accessible
+    }
+    return docs;
+}
+/**
+ * Find brand assets (logo files) in a directory
+ * Also searches workspace root and parent directories
+ *
+ * @param cwd - Directory to scan for brand assets
+ * @returns Object with optional logoPath
+ */
+export async function findBrandAssets(cwd) {
+    const scanDirs = await getScanDirectories(cwd);
+    for (const dir of scanDirs) {
+        const result = await scanDirectoryForLogo(dir);
+        if (result.logoPath)
+            return result;
+    }
+    return {};
+}
+/**
+ * Scan a single directory for logo files
+ */
+async function scanDirectoryForLogo(dir) {
+    const logoExtensions = ['.png', '.svg', '.jpg', '.jpeg', '.webp'];
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isFile())
+                continue;
+            const lowerName = entry.name.toLowerCase();
+            const hasLogoInName = lowerName.includes('logo');
+            const hasValidExt = logoExtensions.some((ext) => lowerName.endsWith(ext));
+            if (hasLogoInName && hasValidExt) {
+                return { logoPath: path.join(dir, entry.name) };
+            }
+        }
+    }
+    catch {
+        // Directory not accessible
+    }
+    return {};
+}
+/**
+ * Read and concatenate project documentation files
+ *
+ * @param docPaths - Array of absolute paths to doc files
+ * @param maxLength - Maximum combined length (default 25000 chars)
+ * @returns Combined documentation content with file headers
+ */
+export async function readProjectDocs(docPaths, maxLength = 25000) {
+    const sections = [];
+    let totalLength = 0;
+    for (const docPath of docPaths) {
+        if (totalLength >= maxLength)
+            break;
+        try {
+            let content = await fs.readFile(docPath, 'utf-8');
+            const fileName = path.basename(docPath);
+            const header = `--- ${fileName} ---`;
+            // Per-file cap to prevent a single large doc from consuming the budget
+            if (content.length > PER_FILE_CAP) {
+                content = content.slice(0, PER_FILE_CAP) + '...';
+            }
+            const remaining = maxLength - totalLength;
+            const trimmedContent = content.length > remaining ? content.slice(0, remaining) + '...' : content;
+            sections.push(`${header}\n${trimmedContent}`);
+            totalLength += header.length + 1 + trimmedContent.length;
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return sections.join('\n\n');
+}
+/**
+ * Build a structured website content context from discovered docs
+ *
+ * @param cwd - Working directory to scan for docs
+ * @param projectName - The project name (folder name fallback)
+ * @param specification - Optional expanded specification text
+ * @returns Structured content context for website templates
+ */
+export async function buildWebsiteContext(cwd, projectName, specification) {
+    const docPaths = await discoverProjectDocs(cwd);
+    const rawDocs = docPaths.length > 0 ? await readProjectDocs(docPaths) : '';
+    const brandAssets = await findBrandAssets(cwd);
+    // Strip markdown code fences that wrap entire doc files
+    const cleanDocs = stripCodeFences(rawDocs);
+    const context = {
+        productName: extractProductName(cleanDocs, specification) || projectName,
+        features: extractFeatures(cleanDocs, specification),
+        rawDocs,
+    };
+    context.tagline = extractTagline(cleanDocs, context.productName);
+    context.description = extractDescription(cleanDocs, specification);
+    context.pricing = extractPricing(cleanDocs);
+    // Extract brand info
+    if (brandAssets.logoPath) {
+        context.brand = { ...context.brand, logoPath: brandAssets.logoPath };
+    }
+    const primaryColor = extractPrimaryColor(cleanDocs);
+    if (primaryColor) {
+        context.brand = { ...context.brand, primaryColor };
+    }
+    return context;
+}
+/** Default pricing tier names that indicate placeholder content */
+const DEFAULT_PRICING_NAMES = ['starter', 'free', 'pro', 'enterprise'];
+/** Default pricing amounts that indicate placeholder content */
+const DEFAULT_PRICING_AMOUNTS = ['$0', '$29', '$99', 'custom', 'free'];
+/**
+ * Validate website content context without throwing
+ * Returns structured result with issues, warnings, and a content quality score
+ *
+ * @param context - The built website content context
+ * @param projectName - The project name for validation
+ * @returns Validation result with issues, warnings, and score
+ */
+export function validateWebsiteContext(context, _projectName) {
+    const issues = [];
+    const warnings = [];
+    let contentScore = 100;
+    // Suspicious product name (looks like a directory name with hyphens/underscores)
+    const suspiciousNames = ['my-app', 'my-project', 'project', 'app', 'website', 'frontend'];
+    if (/^[a-z]+-[a-z]+(-[a-z]+)*$/.test(context.productName) ||
+        suspiciousNames.includes(context.productName.toLowerCase())) {
+        issues.push(`Product name "${context.productName}" looks like a directory name, not a product. ` +
+            `Provide .md docs with "# ProductName -- tagline" heading.`);
+        contentScore -= 25;
+    }
+    // No docs found at all
+    if (!context.rawDocs || context.rawDocs.length < 100) {
+        issues.push('No project documentation found. Place .md files (spec, pricing, brand) ' +
+            'in the project directory or its parent.');
+        contentScore -= 30;
+    }
+    // No features extracted
+    if (context.features.length === 0) {
+        issues.push('No product features extracted from docs. Add a "## Features" section to your spec.');
+        contentScore -= 20;
+    }
+    // Strategy validation
+    if (!context.strategy) {
+        issues.push('Website strategy missing. Strategy generation may have failed or been skipped.');
+        contentScore -= 15;
+    }
+    // Brand color validation: brand/color docs exist but no color extracted
+    if (!context.brand?.primaryColor && context.rawDocs && /color|brand/i.test(context.rawDocs)) {
+        issues.push('Brand/color docs found but no primary color extracted. Check color doc format.');
+        contentScore -= 5;
+    }
+    // Logo found but output path not resolved
+    if (context.brand?.logoPath && !context.brandAssets?.logoOutputPath) {
+        issues.push('Logo found but output path not resolved. Call resolveBrandAssets().');
+        contentScore -= 5;
+    }
+    // --- Non-blocking warnings ---
+    // Default pricing tiers detection
+    if (context.pricing && context.pricing.length > 0) {
+        const tierNames = context.pricing.map((t) => t.name.toLowerCase());
+        const tierPrices = context.pricing.map((t) => t.price.toLowerCase().replace(/\/mo.*/, ''));
+        const nameMatches = tierNames.filter((n) => DEFAULT_PRICING_NAMES.includes(n));
+        const priceMatches = tierPrices.filter((p) => DEFAULT_PRICING_AMOUNTS.includes(p));
+        // Reason: if most tier names AND prices match defaults, it's likely placeholder content
+        if (nameMatches.length >= 2 && priceMatches.length >= 2) {
+            warnings.push('Pricing tiers appear to use default values (Starter/Pro/Enterprise at $0/$29/Custom). ' +
+                'Add a pricing section to your docs for accurate tiers.');
+            contentScore -= 10;
+        }
+    }
+    // Missing tagline
+    if (!context.tagline) {
+        warnings.push('No tagline extracted from docs. Footer and meta tags will use generic defaults. ' +
+            'Add "# ProductName -- Your tagline here" to your spec.');
+        contentScore -= 5;
+    }
+    // Missing description
+    if (!context.description) {
+        warnings.push('No product description extracted. Meta description will use generic text.');
+        contentScore -= 5;
+    }
+    // No brand color at all (not just missing from color docs)
+    if (!context.brand?.primaryColor && !(context.rawDocs && /color|brand/i.test(context.rawDocs))) {
+        warnings.push('No brand color found. Website will use default color scheme.');
+        contentScore -= 5;
+    }
+    // Clamp score to 0-100
+    contentScore = Math.max(0, Math.min(100, contentScore));
+    return {
+        passed: issues.length === 0,
+        issues,
+        warnings,
+        contentScore,
+    };
+}
+/**
+ * Validate website content context and throw if insufficient
+ * Prevents generation of generic websites with placeholder content
+ *
+ * @param context - The built website content context
+ * @param projectName - The project name for validation
+ * @throws Error with actionable message if context is insufficient
+ */
+export function validateWebsiteContextOrThrow(context, projectName) {
+    const result = validateWebsiteContext(context, projectName);
+    if (!result.passed) {
+        throw new Error(`Website generation blocked - insufficient project context:\n` +
+            result.issues.map((i) => `  - ${i}`).join('\n') +
+            `\n\nFix these issues and re-run. Use POPEYE_DEBUG_WEBSITE=1 to see discovery details.`);
+    }
+    return { passed: true, issues: [] };
+}
+//# sourceMappingURL=website-context.js.map

package/dist/generators/website-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-context.js","sourceRoot":"","sources":["../../src/generators/website-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,qFAAqF;AACrF,MAAM,YAAY,GAAG,IAAI,CAAC;AA+B1B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAW,EACX,YAA2D;IAE3D,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,YAAY,EAAE,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC;IAC3D,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEvD,OAAO;QACL,QAAQ;QACR,cAAc,EAAE,oBAAoB,GAAG,EAAE;QACzC,YAAY,EAAE,YAAY,EAAE,YAAY;KACzC,CAAC;AACJ,CAAC;AAED,4CAA4C;AAC5C,MAAM,YAAY,GAAG;IACnB,OAAO;IACP,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,gBAAgB;IAChB,eAAe;IACf,WAAW;IACX,WAAW;IACX,UAAU;CACX,CAAC;AAEF,2CAA2C;AAC3C,MAAM,aAAa,GAAG;IACpB,cAAc;IACd,SAAS;IACT,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,aAAa;IACb,MAAM;IACN,OAAO;IACP,UAAU;CACX,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW;IACnD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAC9C,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,8EAA8E;IAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC;IACvC,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,oBAAoB,CAAC,GAAW;IAC7C,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9D,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBACzE,IAAI,OAAO,EAAE,CAAC;oBACZ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;YAED,kDAAkD;YAClD,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACjD,IAAI,CAAC;oBACH,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;wBAC9D,aAAa,EAAE,IAAI;qBACpB,CAAC,CAAC;oBACH,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;wBAClC,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;4BACvD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;wBACvD,CAAC;oBACH,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,8BAA8B;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW;IAEX,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAE/C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,MAAM,CAAC,QAAQ;YAAE,OAAO,MAAM,CAAC;IACrC,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,oBAAoB,CAAC,GAAW;IAC7C,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAElE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;gBAAE,SAAS;YAE9B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACjD,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YAE1E,IAAI,aAAa,IAAI,WAAW,EAAE,CAAC;gBACjC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAkB,EAClB,YAAoB,KAAK;IAEzB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,WAAW,IAAI,SAAS;YAAE,MAAM;QAEpC,IAAI,CAAC;YACH,IAAI,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,MAAM,GAAG,OAAO,QAAQ,MAAM,CAAC;YAErC,uEAAuE;YACvE,IAAI,OAAO,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;gBAClC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,KAAK,CAAC;YACnD,CAAC;YAED,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;YAC1C,MAAM,cAAc,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;YAE7E,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,cAAc,EAAE,CAAC,CAAC;YAC9C,WAAW,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,WAAmB,EACnB,aAAsB;IAEtB,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAE/C,wDAAwD;IACxD,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,OAAO,GAA0B;QACrC,WAAW,EAAE,kBAAkB,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,WAAW;QACxE,QAAQ,EAAE,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC;QACnD,OAAO;KACR,CAAC;IAEF,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACjE,OAAO,CAAC,WAAW,GAAG,kBAAkB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACnE,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAE5C,qBAAqB;IACrB,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC;IACvE,CAAC;IAED,MAAM,YAAY,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;IACrD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAgBD,mEAAmE;AACnE,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;AAEvE,gEAAgE;AAChE,MAAM,uBAAuB,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAA8B,EAC9B,YAAoB;IAEpB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,YAAY,GAAG,GAAG,CAAC;IAEvB,iFAAiF;IACjF,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC1F,IACE,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QACrD,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,EAC3D,CAAC;QACD,MAAM,CAAC,IAAI,CACT,iBAAiB,OAAO,CAAC,WAAW,gDAAgD;YACpF,2DAA2D,CAC5D,CAAC;QACF,YAAY,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,uBAAuB;IACvB,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACrD,MAAM,CAAC,IAAI,CACT,yEAAyE;YACzE,yCAAyC,CAC1C,CAAC;QACF,YAAY,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,wBAAwB;IACxB,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CACT,oFAAoF,CACrF,CAAC;QACF,YAAY,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,sBAAsB;IACtB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CACT,gFAAgF,CACjF,CAAC;QACF,YAAY,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,wEAAwE;IACxE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,IAAI,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5F,MAAM,CAAC,IAAI,CACT,gFAAgF,CACjF,CAAC;QACF,YAAY,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,0CAA0C;IAC1C,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,EAAE,CAAC;QACpE,MAAM,CAAC,IAAI,CACT,qEAAqE,CACtE,CAAC;QACF,YAAY,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,gCAAgC;IAEhC,kCAAkC;IAClC,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QAC3F,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnF,wFAAwF;QACxF,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACxD,QAAQ,CAAC,IAAI,CACX,wFAAwF;gBACxF,wDAAwD,CACzD,CAAC;YACF,YAAY,IAAI,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CACX,kFAAkF;YAClF,wDAAwD,CACzD,CAAC;QACF,YAAY,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,sBAAsB;IACtB,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CACX,2EAA2E,CAC5E,CAAC;QACF,YAAY,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,2DAA2D;IAC3D,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC/F,QAAQ,CAAC,IAAI,CACX,8DAA8D,CAC/D,CAAC;QACF,YAAY,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,uBAAuB;IACvB,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;IAExD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC3B,MAAM;QACN,QAAQ;QACR,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAA8B,EAC9B,WAAmB;IAEnB,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAE5D,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,8DAA8D;YAC9D,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC/C,uFAAuF,CACxF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACtC,CAAC"}

package/dist/generators/website-debug.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Debug tracing for website generation pipeline
+ * Enabled via POPEYE_DEBUG_WEBSITE=1 environment variable
+ * Shows exactly which value came from where during website generation
+ */
+/**
+ * Structured trace of website generation pipeline decisions
+ */
+export interface WebsiteDebugTrace {
+    workspaceRoot: string;
+    docsFound: Array<{
+        path: string;
+        size: number;
+    }>;
+    brandAssets: {
+        logoPath?: string;
+        logoOutputPath: string;
+    };
+    productName: {
+        value: string;
+        source: 'docs' | 'spec' | 'package.json' | 'directory';
+    };
+    primaryColor: {
+        value?: string;
+        source: 'brand-docs' | 'frontend' | 'defaults';
+    };
+    strategyStatus: 'success' | 'failed' | 'skipped';
+    strategyError?: string;
+    feDesignAnalysis?: {
+        componentLib?: string;
+        darkMode: boolean;
+        primaryColor?: string;
+    };
+    templateValues: {
+        headline?: string;
+        features: number;
+        pricingTiers: number;
+    };
+    /** Sections rendered with their data sources */
+    sectionsRendered: Array<{
+        name: string;
+        dataSource: 'strategy' | 'docs' | 'defaults' | 'skipped';
+        itemCount: number;
+    }>;
+    /** Validation result from quality gate */
+    validationPassed: boolean;
+    validationIssues: string[];
+}
+/**
+ * Check if debug tracing is enabled
+ *
+ * @returns True if POPEYE_DEBUG_WEBSITE=1 is set
+ */
+export declare function isDebugEnabled(): boolean;
+/**
+ * Format a debug trace for terminal output
+ *
+ * @param trace - The debug trace to format
+ * @returns Formatted string for terminal output
+ */
+export declare function formatDebugTrace(trace: WebsiteDebugTrace): string;
+/**
+ * Print debug trace to console if debug mode is enabled
+ *
+ * @param trace - The debug trace to print
+ */
+export declare function printDebugTrace(trace: WebsiteDebugTrace): void;
+//# sourceMappingURL=website-debug.d.ts.map

package/dist/generators/website-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-debug.d.ts","sourceRoot":"","sources":["../../src/generators/website-debug.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,WAAW,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,GAAG,WAAW,CAAA;KAAE,CAAC;IACvF,YAAY,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,GAAG,UAAU,GAAG,UAAU,CAAA;KAAE,CAAC;IACjF,cAAc,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvF,cAAc,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,gDAAgD;IAChD,gBAAgB,EAAE,KAAK,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;QACzD,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,0CAA0C;IAC1C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAyEjE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAI9D"}

package/dist/generators/website-debug.js

@@ -0,0 +1,93 @@
+/**
+ * Debug tracing for website generation pipeline
+ * Enabled via POPEYE_DEBUG_WEBSITE=1 environment variable
+ * Shows exactly which value came from where during website generation
+ */
+/**
+ * Check if debug tracing is enabled
+ *
+ * @returns True if POPEYE_DEBUG_WEBSITE=1 is set
+ */
+export function isDebugEnabled() {
+    return process.env.POPEYE_DEBUG_WEBSITE === '1';
+}
+/**
+ * Format a debug trace for terminal output
+ *
+ * @param trace - The debug trace to format
+ * @returns Formatted string for terminal output
+ */
+export function formatDebugTrace(trace) {
+    const lines = [];
+    lines.push('');
+    lines.push('=== WEBSITE GENERATION DEBUG TRACE ===');
+    lines.push('');
+    lines.push(`Workspace Root: ${trace.workspaceRoot}`);
+    lines.push('');
+    lines.push(`Docs Found (${trace.docsFound.length}):`);
+    if (trace.docsFound.length === 0) {
+        lines.push('  (none)');
+    }
+    else {
+        for (const doc of trace.docsFound) {
+            lines.push(`  - ${doc.path} (${doc.size} chars)`);
+        }
+    }
+    lines.push('');
+    lines.push(`Brand Assets:`);
+    lines.push(`  Logo Source: ${trace.brandAssets.logoPath || '(none)'}`);
+    lines.push(`  Logo Output: ${trace.brandAssets.logoOutputPath}`);
+    lines.push('');
+    lines.push(`Product Name: "${trace.productName.value}" (from: ${trace.productName.source})`);
+    lines.push('');
+    lines.push(`Primary Color: ${trace.primaryColor.value || '(default)'} (from: ${trace.primaryColor.source})`);
+    lines.push('');
+    lines.push(`Strategy: ${trace.strategyStatus}`);
+    if (trace.strategyError) {
+        lines.push(`  Error: ${trace.strategyError}`);
+    }
+    lines.push('');
+    if (trace.feDesignAnalysis) {
+        lines.push('Frontend Design Analysis:');
+        lines.push(`  Component Library: ${trace.feDesignAnalysis.componentLib || '(unknown)'}`);
+        lines.push(`  Dark Mode: ${trace.feDesignAnalysis.darkMode}`);
+        lines.push(`  Primary Color: ${trace.feDesignAnalysis.primaryColor || '(none)'}`);
+        lines.push('');
+    }
+    lines.push('Template Values:');
+    lines.push(`  Headline: ${trace.templateValues.headline || '(default)'}`);
+    lines.push(`  Features: ${trace.templateValues.features}`);
+    lines.push(`  Pricing Tiers: ${trace.templateValues.pricingTiers}`);
+    lines.push('');
+    lines.push(`Sections Rendered (${trace.sectionsRendered.length}):`);
+    if (trace.sectionsRendered.length === 0) {
+        lines.push('  (none)');
+    }
+    else {
+        for (const section of trace.sectionsRendered) {
+            lines.push(`  - ${section.name}: ${section.dataSource} (${section.itemCount} items)`);
+        }
+    }
+    lines.push('');
+    lines.push(`Validation: ${trace.validationPassed ? 'PASSED' : 'FAILED'}`);
+    if (trace.validationIssues.length > 0) {
+        for (const issue of trace.validationIssues) {
+            lines.push(`  - ${issue}`);
+        }
+    }
+    lines.push('');
+    lines.push('=== END DEBUG TRACE ===');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Print debug trace to console if debug mode is enabled
+ *
+ * @param trace - The debug trace to print
+ */
+export function printDebugTrace(trace) {
+    if (isDebugEnabled()) {
+        console.log(formatDebugTrace(trace));
+    }
+}
+//# sourceMappingURL=website-debug.js.map

package/dist/generators/website-debug.js.map

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

package/dist/generators/website.d.ts

@@ -3,6 +3,7 @@
  * Creates SEO-ready Next.js marketing website
  */
 import type { ProjectSpec } from '../types/project.js';
+import type { WebsiteContentContext } from './website-context.js';
 /**
  * Project generation result
  */
@@ -26,6 +27,10 @@ export interface WebsiteGeneratorOptions {
     skipDocker?: boolean;
     /** Skip README (fullstack has root README) */
     skipReadme?: boolean;
+    /** Content context from user docs for populating templates */
+    contentContext?: WebsiteContentContext;
+    /** Skip content validation (scaffold-only use) */
+    skipValidation?: boolean;
 }
 /**
  * Generate a complete Next.js website project

package/dist/generators/website.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"website.d.ts","sourceRoot":"","sources":["../../src/generators/website.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAwBvD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAgBD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CA6L3B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAgCrE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IACxE,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC,CA0BD"}
+{"version":3,"file":"website.d.ts","sourceRoot":"","sources":["../../src/generators/website.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AA0CvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAMlE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,kDAAkD;IAClD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAgBD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CA+T3B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAgCrE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IACxE,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC,CA0BD"}