@empline/preflight 1.1.0

package/dist/checks/ui/duplicate-shared-component-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-shared-component-detection.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/duplicate-shared-component-detection.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG;AAeH,eAAO,MAAM,EAAE,4CAA4C,CAAC;AAC5D,eAAO,MAAM,IAAI,yCAAyC,CAAC;AAC3D,eAAO,MAAM,WAAW,+EAA+E,CAAC;AACxG,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,IAAI,UAA4E,CAAC;AA2R9F,wBAAsB,GAAG,kBAyDxB"}

package/dist/checks/ui/duplicate-shared-component-detection.js

@@ -0,0 +1,340 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Duplicate Shared Component Detection Preflight
+ *
+ * Detects components that may be duplicates or variations of each other,
+ * helping maintain a single source of truth for shared UI patterns.
+ *
+ * Features:
+ * - Detects components with similar names (e.g., FooStepper vs BarStepper)
+ * - Identifies components with similar purposes across different directories
+ * - Flags deprecated components still in use
+ * - Suggests consolidation opportunities
+ *
+ * Usage:
+ *   pnpm preflight:duplicate-components
+ *   pnpm preflight:duplicate-components --verbose
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+exports.run = run;
+const console_chars_1 = require("../../utils/console-chars");
+const exclusions_1 = require("../../shared/exclusions");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+const glob_1 = require("glob");
+// App-specific exclusions loaded from config
+let appExclusions = [];
+// METADATA - Required for plugin loader discovery
+exports.id = "ui/duplicate-shared-component-detection";
+exports.name = "Duplicate Shared Component Detection";
+exports.description = "Detects duplicate or similar shared components that should be consolidated";
+exports.category = "ui";
+exports.blocking = false;
+exports.tags = ["ui", "shared-components", "duplication", "consistency", "architecture"];
+// Known duplicate/similar component patterns to detect
+const SIMILAR_COMPONENT_PATTERNS = [
+    {
+        pattern: /Stepper/i,
+        category: "stepper",
+        preferredComponent: "IntegrationStepper",
+        suggestion: "Use IntegrationStepper from @/components/shared/integration for all stepper needs",
+    },
+    {
+        pattern: /EmptyState/i,
+        category: "empty-state",
+        preferredComponent: "UnifiedEmptyState",
+        suggestion: "Use UnifiedEmptyState from @/components/shared for consistent empty states",
+    },
+    {
+        pattern: /Loading(?:State|Spinner|Indicator)/i,
+        category: "loading",
+        preferredComponent: "LoadingEmptyState",
+        suggestion: "Use LoadingEmptyState or LoadingState from @/components/shared",
+    },
+    {
+        pattern: /(?:Confirm|Delete)(?:Dialog|Modal)/i,
+        category: "dialog",
+        preferredComponent: "ConfirmDialog",
+        suggestion: "Use ConfirmDialog or DeleteDialog from @/components/shared",
+    },
+    {
+        pattern: /Status(?:Chip|Badge|Indicator)/i,
+        category: "status",
+        preferredComponent: "StatusChip",
+        suggestion: "Use StatusChip or StatusIconChip from @/components/shared",
+    },
+    {
+        pattern: /(?:Stat|Metric)(?:Card|Display)/i,
+        category: "stat",
+        preferredComponent: "StatCard",
+        suggestion: "Use StatCard or CompactStatCard from @/components/shared",
+    },
+    {
+        pattern: /(?:Image|Photo)(?:Display|Viewer|Card)/i,
+        category: "image",
+        preferredComponent: "UnifiedImage",
+        suggestion: "Use UnifiedImage from @/components/shared/UnifiedImage",
+    },
+    {
+        pattern: /(?:Search|Filter)(?:Bar|Input|Field)/i,
+        category: "search",
+        preferredComponent: "SearchInput",
+        suggestion: "Use SearchInput from @/components/shared for consistent search UI",
+    },
+    {
+        pattern: /(?:Tab|Tabs)(?:Layout|Container|Panel)/i,
+        category: "tabs",
+        preferredComponent: "IntegrationTabsLayout",
+        suggestion: "Use IntegrationTabsLayout from @/components/shared/integration for tabbed interfaces",
+    },
+    {
+        pattern: /(?:Upload|Drop)(?:Zone|Area|Container)/i,
+        category: "upload",
+        preferredComponent: "UploadCommandCenter",
+        suggestion: "Use UploadCommandCenter from @/components/upload for file uploads",
+    },
+];
+// Directories to scan for components
+const COMPONENT_DIRECTORIES = [
+    "components/shared/**/*.tsx",
+    "components/upload/**/*.tsx",
+    "components/seller/**/*.tsx",
+    "app/**/components/**/*.tsx",
+    "app/**/_components/**/*.tsx",
+];
+// Directories to skip
+const SKIP_PATTERNS = [
+    "**/node_modules/**",
+    "**/*.test.tsx",
+    "**/*.stories.tsx",
+    "**/*.d.ts",
+    "components/ui/**", // Primitive UI components are fine
+];
+async function findComponentFiles() {
+    const allFiles = [];
+    for (const pattern of COMPONENT_DIRECTORIES) {
+        const matches = await (0, glob_1.glob)(pattern, {
+            ignore: SKIP_PATTERNS,
+        });
+        allFiles.push(...matches);
+    }
+    return allFiles.filter((file) => {
+        if ((0, exclusions_1.shouldExcludeFile)(file, appExclusions))
+            return false;
+        return true;
+    });
+}
+function extractComponentInfo(filePath, content) {
+    // Extract component name from filename or export
+    const fileName = path.basename(filePath, ".tsx");
+    // Check for @deprecated JSDoc comment
+    const isDeprecated = /@deprecated/i.test(content);
+    const deprecationMatch = content.match(/@deprecated\s+([^\n*]+)/i);
+    const deprecationMessage = deprecationMatch?.[1]?.trim();
+    // Extract exports
+    const exports = [];
+    const exportMatches = content.matchAll(/export\s+(?:function|const|class)\s+(\w+)/g);
+    for (const match of exportMatches) {
+        exports.push(match[1]);
+    }
+    // Also check for default exports
+    if (/export\s+default\s+(?:function\s+)?(\w+)?/.test(content)) {
+        exports.push(fileName);
+    }
+    if (exports.length === 0) {
+        return null; // Not a component file
+    }
+    return {
+        name: exports[0] || fileName,
+        filePath,
+        directory: path.dirname(filePath),
+        isDeprecated,
+        deprecationMessage,
+        exports,
+        importedBy: [], // Will be populated later
+    };
+}
+async function findComponentUsage(componentName, files) {
+    const usedIn = [];
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, "utf-8");
+            // Check for imports of this component
+            const importPattern = new RegExp(`import\\s*\\{[^}]*\\b${componentName}\\b[^}]*\\}\\s*from|import\\s+${componentName}\\s+from`, "i");
+            if (importPattern.test(content)) {
+                usedIn.push(file);
+            }
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return usedIn;
+}
+function groupSimilarComponents(components) {
+    const groups = [];
+    const categorized = new Map();
+    // Group components by pattern
+    for (const component of components) {
+        for (const patternDef of SIMILAR_COMPONENT_PATTERNS) {
+            if (patternDef.pattern.test(component.name)) {
+                const category = patternDef.category;
+                if (!categorized.has(category)) {
+                    categorized.set(category, []);
+                }
+                categorized.get(category).push(component);
+                break; // Only match first pattern
+            }
+        }
+    }
+    // Create groups for categories with multiple components
+    for (const [category, comps] of categorized) {
+        if (comps.length > 1) {
+            const patternDef = SIMILAR_COMPONENT_PATTERNS.find((p) => p.category === category);
+            // Determine severity based on whether deprecated components are still in use
+            const hasDeprecatedInUse = comps.some((c) => c.isDeprecated && c.importedBy.length > 0);
+            const hasMultipleNonDeprecated = comps.filter((c) => !c.isDeprecated).length > 1;
+            groups.push({
+                pattern: category,
+                components: comps,
+                suggestion: patternDef.suggestion,
+                severity: hasDeprecatedInUse || hasMultipleNonDeprecated ? "warning" : "info",
+            });
+        }
+    }
+    return groups;
+}
+function printGroup(group, verbose) {
+    const icon = group.severity === "warning" ? console_chars_1.emoji.warning : console_chars_1.emoji.info;
+    console.log(`\n${icon} ${group.pattern.toUpperCase()} components (${group.components.length} found):`);
+    console.log(`  ${console_chars_1.emoji.hint} ${group.suggestion}`);
+    console.log("");
+    for (const comp of group.components) {
+        const deprecatedTag = comp.isDeprecated ? " [DEPRECATED]" : "";
+        const usageCount = comp.importedBy.length;
+        console.log(`  ${console_chars_1.chars.bullet} ${comp.name}${deprecatedTag}`);
+        console.log(`      Path: ${comp.filePath}`);
+        console.log(`      Used in: ${usageCount} file(s)`);
+        if (verbose && comp.isDeprecated && comp.deprecationMessage) {
+            console.log(`      Deprecation: ${comp.deprecationMessage}`);
+        }
+        if (verbose && usageCount > 0 && usageCount <= 5) {
+            for (const usage of comp.importedBy) {
+                console.log(`        ${console_chars_1.chars.arrow} ${usage}`);
+            }
+        }
+    }
+}
+function printSummary(groups, allComponents) {
+    console.log((0, console_chars_1.createDivider)(70, "heavy"));
+    console.log(`${console_chars_1.emoji.docs} SUMMARY:`);
+    console.log((0, console_chars_1.createDivider)(70, "light"));
+    const totalDuplicates = groups.reduce((sum, g) => sum + g.components.length, 0);
+    const deprecatedInUse = allComponents.filter((c) => c.isDeprecated && c.importedBy.length > 0);
+    const warnings = groups.filter((g) => g.severity === "warning").length;
+    console.log(`  Duplicate groups found: ${groups.length}`);
+    console.log(`  Total similar components: ${totalDuplicates}`);
+    console.log(`  Deprecated components still in use: ${deprecatedInUse.length}`);
+    console.log(`  Warnings: ${warnings}`);
+    if (deprecatedInUse.length > 0) {
+        console.log("");
+        console.log(`${console_chars_1.emoji.warning} Deprecated components that need migration:`);
+        for (const comp of deprecatedInUse) {
+            console.log(`  ${console_chars_1.chars.bullet} ${comp.name} (used in ${comp.importedBy.length} files)`);
+        }
+    }
+    console.log("");
+    console.log(`${console_chars_1.emoji.hint} Recommendations:`);
+    console.log(`  1. Migrate deprecated components to their replacements`);
+    console.log(`  2. Consolidate similar components into shared versions`);
+    console.log(`  3. Add @deprecated comments to components being phased out`);
+}
+// Main
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const args = process.argv.slice(2);
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    console.log(`${console_chars_1.emoji.search} Duplicate Shared Component Detection Preflight`);
+    console.log((0, console_chars_1.createDivider)(70, "heavy"));
+    // Load exclusions
+    appExclusions = await (0, exclusions_1.getExclusions)(exports.id);
+    const files = await findComponentFiles();
+    console.log(`Scanning ${files.length} component files...`);
+    // Parse all components
+    const components = [];
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, "utf-8");
+            const info = extractComponentInfo(file, content);
+            if (info) {
+                components.push(info);
+            }
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    console.log(`Found ${components.length} components`);
+    // Find usage for each component
+    const allSourceFiles = await (0, glob_1.glob)(["app/**/*.tsx", "components/**/*.tsx"], {
+        ignore: SKIP_PATTERNS,
+    });
+    for (const comp of components) {
+        comp.importedBy = await findComponentUsage(comp.name, allSourceFiles);
+    }
+    // Group similar components
+    const groups = groupSimilarComponents(components);
+    if (groups.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No duplicate component patterns detected!`);
+        return;
+    }
+    // Print groups
+    for (const group of groups) {
+        printGroup(group, verbose);
+    }
+    // Print summary
+    printSummary(groups, components);
+    console.log(`\n${console_chars_1.emoji.info} This preflight is non-blocking (suggestions only).`);
+    console.log(`${console_chars_1.emoji.hint} Run with --verbose for detailed output.`);
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=duplicate-shared-component-detection.js.map

package/dist/checks/ui/duplicate-shared-component-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-shared-component-detection.js","sourceRoot":"","sources":["../../../src/checks/ui/duplicate-shared-component-detection.ts"],"names":[],"mappings":"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"}

package/dist/checks/ui/feature-page-hero-consistency.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env tsx
+/**
+ * Feature Page Hero Consistency Preflight
+ *
+ * Ensures all feature/info pages linked from the homepage have consistent hero sections:
+ *
+ * REQUIRED PATTERN:
+ *   - pt-12 class on main content wrapper (top gap after header)
+ *   - Icon in circular gradient background with shadow
+ *   - Gradient text for main title using var(--gradient-hero-rainbow)
+ *   - CSS variables for spacing (var(--spacing-*))
+ *
+ * PAGES COVERED:
+ *   - app/features/* (marketplace, ai-recognition, collection, grading)
+ *   - app/shipping/ShippingClient.tsx
+ *   - app/returns/ReturnsClient.tsx
+ *   - app/trust-safety/TrustSafetyPageClient.tsx
+ *   - app/how-it-works/HowItWorksClient.tsx
+ *
+ * Usage:
+ *   pnpm preflight:feature-page-hero
+ */
+export declare const id = "ui/feature-page-hero-consistency";
+export declare const name = "Feature Page Hero Consistency";
+export declare const category = "ui";
+export declare const blocking = false;
+export declare const description = "Feature Page Hero Consistency Preflight";
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=feature-page-hero-consistency.d.ts.map

package/dist/checks/ui/feature-page-hero-consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-page-hero-consistency.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/feature-page-hero-consistency.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAWH,eAAO,MAAM,EAAE,qCAAqC,CAAC;AACrD,eAAO,MAAM,IAAI,kCAAkC,CAAC;AACpD,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,4CAA4C,CAAC;AACrE,eAAO,MAAM,IAAI,UAAS,CAAC;AAgJ3B,wBAAsB,GAAG,kBAiDxB"}

package/dist/checks/ui/feature-page-hero-consistency.js

@@ -0,0 +1,234 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Feature Page Hero Consistency Preflight
+ *
+ * Ensures all feature/info pages linked from the homepage have consistent hero sections:
+ *
+ * REQUIRED PATTERN:
+ *   - pt-12 class on main content wrapper (top gap after header)
+ *   - Icon in circular gradient background with shadow
+ *   - Gradient text for main title using var(--gradient-hero-rainbow)
+ *   - CSS variables for spacing (var(--spacing-*))
+ *
+ * PAGES COVERED:
+ *   - app/features/* (marketplace, ai-recognition, collection, grading)
+ *   - app/shipping/ShippingClient.tsx
+ *   - app/returns/ReturnsClient.tsx
+ *   - app/trust-safety/TrustSafetyPageClient.tsx
+ *   - app/how-it-works/HowItWorksClient.tsx
+ *
+ * Usage:
+ *   pnpm preflight:feature-page-hero
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const console_chars_1 = require("../../utils/console-chars");
+const glob_patterns_1 = require("../../shared/glob-patterns");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+const glob_1 = require("glob");
+// Check metadata
+exports.id = "ui/feature-page-hero-consistency";
+exports.name = "Feature Page Hero Consistency";
+exports.category = "ui";
+exports.blocking = false;
+exports.description = "Feature Page Hero Consistency Preflight";
+exports.tags = ["ui"];
+const FEATURE_PAGE_PATTERNS = [
+    "app/features/**/*(Client).tsx",
+    "app/shipping/ShippingClient.tsx",
+    "app/returns/ReturnsClient.tsx",
+    "app/trust-safety/TrustSafetyPageClient.tsx",
+    "app/how-it-works/HowItWorksClient.tsx",
+    "app/faq/FAQClient.tsx",
+];
+const EXCLUDED = [...glob_patterns_1.STANDARD_EXCLUDES];
+// Required hero patterns
+const HERO_REQUIREMENTS = {
+    topPadding: "pt-12",
+    iconCircleBackground: /background:\s*["']var\(--gradient-card-(?:primary|warning|success|info)\)["']/,
+    iconCircleShadow: /boxShadow:\s*["']var\(--shadow-xl\)["']/,
+    gradientTitle: /background:\s*["']var\(--gradient-hero-rainbow\)["']/,
+    webkitClip: /WebkitBackgroundClip:\s*["']text["']/,
+};
+async function checkFeaturePageHero() {
+    const issues = [];
+    // Get all feature page files
+    const files = [];
+    for (const pattern of FEATURE_PAGE_PATTERNS) {
+        const matches = await (0, glob_1.glob)(pattern, { ignore: EXCLUDED });
+        files.push(...matches);
+    }
+    for (const file of files) {
+        if (!fs.existsSync(file))
+            continue;
+        const content = fs.readFileSync(file, "utf8");
+        const lines = content.split("\n");
+        // Skip if not a client component with hero section
+        if (!content.includes('"use client"') && !content.includes("'use client'")) {
+            continue;
+        }
+        // Check for pt-12 top padding
+        const hasPt12 = content.includes('className="pt-12"') ||
+            content.includes("className='pt-12'") ||
+            /className=\{[^}]*pt-12/.test(content);
+        if (!hasPt12) {
+            // Find the main content wrapper line
+            let wrapperLine = 0;
+            for (let i = 0; i < lines.length; i++) {
+                if (/<div|<Box/.test(lines[i]) && /flex:\s*["']1["']/.test(lines[i])) {
+                    wrapperLine = i + 1;
+                    break;
+                }
+            }
+            issues.push({
+                file,
+                line: wrapperLine || 1,
+                type: "missing-top-padding",
+                severity: "error",
+                message: `Missing pt-12 class on main content wrapper`,
+                suggestion: `Add className="pt-12" to the main content wrapper div after UnifiedHeader`,
+            });
+        }
+        // Check for icon in circular gradient background
+        const hasIconCircle = HERO_REQUIREMENTS.iconCircleBackground.test(content);
+        if (!hasIconCircle) {
+            issues.push({
+                file,
+                line: 1,
+                type: "missing-icon-circle",
+                severity: "error",
+                message: `Hero icon missing circular gradient background`,
+                suggestion: `Wrap icon in a div with: background: "var(--gradient-card-primary)", borderRadius: "50%", width/height: "var(--spacing-20)"`,
+            });
+        }
+        // Check for icon circle shadow
+        const hasIconShadow = HERO_REQUIREMENTS.iconCircleShadow.test(content);
+        if (hasIconCircle && !hasIconShadow) {
+            issues.push({
+                file,
+                line: 1,
+                type: "missing-icon-shadow",
+                severity: "warning",
+                message: `Hero icon circle missing shadow`,
+                suggestion: `Add boxShadow: "var(--shadow-xl)" to the icon circle`,
+            });
+        }
+        // Check for gradient title
+        const hasGradientTitle = HERO_REQUIREMENTS.gradientTitle.test(content);
+        if (!hasGradientTitle) {
+            // Find h1 line
+            let h1Line = 0;
+            for (let i = 0; i < lines.length; i++) {
+                if (/<h1|<Typography.*variant=["']h1/.test(lines[i])) {
+                    h1Line = i + 1;
+                    break;
+                }
+            }
+            issues.push({
+                file,
+                line: h1Line || 1,
+                type: "missing-gradient-title",
+                severity: "error",
+                message: `Hero title missing gradient text effect`,
+                suggestion: `Add to h1 style: background: "var(--gradient-hero-rainbow)", WebkitBackgroundClip: "text", WebkitTextFillColor: "transparent"`,
+            });
+        }
+        // Check for webkit clip (required for gradient text)
+        if (hasGradientTitle && !HERO_REQUIREMENTS.webkitClip.test(content)) {
+            issues.push({
+                file,
+                line: 1,
+                type: "missing-webkit-clip",
+                severity: "error",
+                message: `Gradient title missing WebkitBackgroundClip: "text"`,
+                suggestion: `Add WebkitBackgroundClip: "text" and WebkitTextFillColor: "transparent" to make gradient visible`,
+            });
+        }
+    }
+    return issues;
+}
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    console.log(`\n${console_chars_1.emoji.palette} FEATURE PAGE HERO CONSISTENCY PREFLIGHT`);
+    console.log(`${console_chars_1.box.doubleHorizontal}`.repeat(70));
+    console.log("Checks: pt-12 top gap, icon in gradient circle, gradient title text");
+    console.log("Pages: features/*, shipping, returns, trust-safety, how-it-works, faq");
+    console.log((0, console_chars_1.createDivider)(70, "double"));
+    const issues = await checkFeaturePageHero();
+    const errors = issues.filter((i) => i.severity === "error");
+    const warnings = issues.filter((i) => i.severity === "warning");
+    if (issues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} All feature page heroes are consistent!`);
+        process.exit(0);
+    }
+    console.log(`\nFound ${errors.length} error(s), ${warnings.length} warning(s):\n`);
+    // Group by file
+    const byFile = new Map();
+    for (const issue of issues) {
+        const existing = byFile.get(issue.file) || [];
+        existing.push(issue);
+        byFile.set(issue.file, existing);
+    }
+    for (const [file, fileIssues] of byFile) {
+        console.log(`${console_chars_1.emoji.folder} ${file}`);
+        for (const issue of fileIssues) {
+            const icon = issue.severity === "error" ? `${console_chars_1.emoji.error}` : `${console_chars_1.emoji.warning}`;
+            console.log(`   ${icon} Line ${issue.line}: ${issue.message}`);
+            console.log(`      ${console_chars_1.chars.arrow} ${issue.suggestion}`);
+            if (issue.snippet) {
+                console.log(`      ${issue.snippet}`);
+            }
+        }
+        console.log();
+    }
+    console.log(`${console_chars_1.box.doubleHorizontal}`.repeat(70));
+    if (errors.length > 0) {
+        console.log(`${console_chars_1.emoji.error} FAILED: ${errors.length} error(s) must be fixed`);
+        process.exit(1);
+    }
+    else {
+        console.log(`${console_chars_1.emoji.warning} PASSED with ${warnings.length} warning(s)`);
+        process.exit(0);
+    }
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=feature-page-hero-consistency.js.map

package/dist/checks/ui/feature-page-hero-consistency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-page-hero-consistency.js","sourceRoot":"","sources":["../../../src/checks/ui/feature-page-hero-consistency.ts"],"names":[],"mappings":"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"}

package/dist/checks/ui/filter-loading-states.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Preflight: Filter Loading States Validation
+ *
+ * RULE: Core filter section builders (Year, Brand, Player, Set, Team) must ALWAYS
+ * return a FilterSection object, never null. They should use the `loading` property
+ * to indicate when data is not yet available.
+ *
+ * This prevents layout shift and provides better UX during page load.
+ *
+ * @blocking true
+ * @category ui
+ */
+export declare const id = "ui/filter-loading-states";
+export declare const name = "Filter Loading States";
+export declare const category = "ui";
+export declare const blocking = true;
+export declare const description = "Preflight: Filter Loading States Validation";
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=filter-loading-states.d.ts.map