@empline/preflight 1.1.0

package/dist/checks/ui/size-naming-consistency.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Size Naming Consistency Preflight
+ *
+ * Ensures consistent size prop naming across the codebase.
+ * Standard: Use "sm", "md", "lg" (not "small", "medium", "large")
+ *
+ * BLOCKING: No - existing code may use legacy naming, warn only
+ *
+ * The codebase has backward compatibility (normalizeSize utility),
+ * but new code should use the short convention.
+ *
+ * Scans: components/, app/
+ */
+export declare const id = "ui/size-naming-consistency";
+export declare const name = "Size Naming Consistency";
+export declare const description = "Ensures size props use \"sm/md/lg\" convention, not \"small/medium/large\"";
+export declare const category = "ui";
+export declare const blocking = false;
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=size-naming-consistency.d.ts.map

package/dist/checks/ui/size-naming-consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-naming-consistency.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/size-naming-consistency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAYH,eAAO,MAAM,EAAE,+BAA+B,CAAC;AAC/C,eAAO,MAAM,IAAI,4BAA4B,CAAC;AAC9C,eAAO,MAAM,WAAW,+EAA2E,CAAC;AACpG,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,IAAI,UAA2C,CAAC;AAmH7D,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA8EzC"}

package/dist/checks/ui/size-naming-consistency.js

@@ -0,0 +1,220 @@
+"use strict";
+/**
+ * Size Naming Consistency Preflight
+ *
+ * Ensures consistent size prop naming across the codebase.
+ * Standard: Use "sm", "md", "lg" (not "small", "medium", "large")
+ *
+ * BLOCKING: No - existing code may use legacy naming, warn only
+ *
+ * The codebase has backward compatibility (normalizeSize utility),
+ * but new code should use the short convention.
+ *
+ * Scans: components/, app/
+ */
+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 fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const exclusions_1 = require("../../shared/exclusions");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+let appExclusions = [];
+// METADATA
+exports.id = "ui/size-naming-consistency";
+exports.name = "Size Naming Consistency";
+exports.description = 'Ensures size props use "sm/md/lg" convention, not "small/medium/large"';
+exports.category = "ui";
+exports.blocking = false; // Warning only since legacy code exists
+exports.tags = ["ui", "consistency", "naming", "props"];
+// Directories to scan
+const SCAN_DIRS = ["components", "app"];
+// Directories to skip
+const SKIP_DIRS = [
+    "node_modules",
+    ".next",
+    "__mocks__",
+    "__tests__",
+    "scripts/preflights", // Don't scan preflights themselves
+];
+// Files to exclude
+const EXCLUDED_FILES = ["size-utils.ts"]; // The normalization utility itself
+// Patterns to detect old naming in JSX props
+const SIZE_PATTERNS = [
+    { pattern: /size=["']small["']/g, found: "small", suggested: "sm" },
+    { pattern: /size=["']medium["']/g, found: "medium", suggested: "md" },
+    { pattern: /size=["']large["']/g, found: "large", suggested: "lg" },
+    // Also check size prop in object literals
+    { pattern: /size:\s*["']small["']/g, found: "small", suggested: "sm" },
+    { pattern: /size:\s*["']medium["']/g, found: "medium", suggested: "md" },
+    { pattern: /size:\s*["']large["']/g, found: "large", suggested: "lg" },
+];
+function scanFile(filePath) {
+    const results = [];
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    const relativePath = path.relative(process.cwd(), filePath);
+    const fileName = path.basename(filePath);
+    // Skip excluded files
+    if (EXCLUDED_FILES.includes(fileName)) {
+        return results;
+    }
+    // Skip if in centralized exclusions
+    if ((0, exclusions_1.shouldExcludeFile)(relativePath, appExclusions)) {
+        return results;
+    }
+    lines.forEach((line, index) => {
+        const lineNum = index + 1;
+        // Skip comments
+        if (line.trim().startsWith("//") || line.trim().startsWith("*")) {
+            return;
+        }
+        // Skip lines that are type definitions (interfaces, types)
+        if (line.includes("type ") || line.includes("interface ") || line.includes(": \"small\"") && line.includes("|")) {
+            return;
+        }
+        for (const { pattern, found, suggested } of SIZE_PATTERNS) {
+            // Reset regex lastIndex
+            pattern.lastIndex = 0;
+            if (pattern.test(line)) {
+                results.push({
+                    file: relativePath,
+                    line: lineNum,
+                    issue: `Legacy size naming "${found}" found. Use "${suggested}" instead.`,
+                    severity: "warning",
+                    found,
+                    suggested,
+                });
+            }
+        }
+    });
+    return results;
+}
+function scanDirectory(dirPath) {
+    const results = [];
+    const fullPath = path.join(process.cwd(), dirPath);
+    if (!fs.existsSync(fullPath)) {
+        return results;
+    }
+    function walk(dir) {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const entryPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!SKIP_DIRS.includes(entry.name)) {
+                    walk(entryPath);
+                }
+            }
+            else if (entry.isFile() && /\.(tsx|ts)$/.test(entry.name)) {
+                results.push(...scanFile(entryPath));
+            }
+        }
+    }
+    walk(fullPath);
+    return results;
+}
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const args = process.argv.slice(2);
+    const strict = args.includes("--strict");
+    console.log(`${console_chars_1.emoji.search} Size Naming Consistency Check\n`);
+    console.log('Checking for legacy "small/medium/large" size naming...\n');
+    // Load centralized exclusions
+    appExclusions = await (0, exclusions_1.getExclusions)(exports.id);
+    reporter.start(SCAN_DIRS.length, "Scanning for legacy size naming");
+    const allResults = [];
+    for (let i = 0; i < SCAN_DIRS.length; i++) {
+        const dir = SCAN_DIRS[i];
+        reporter.updateStep(dir, i + 1, SCAN_DIRS.length);
+        allResults.push(...scanDirectory(dir));
+    }
+    // Group by type for summary
+    const bySuggested = {
+        sm: allResults.filter((r) => r.suggested === "sm").length,
+        md: allResults.filter((r) => r.suggested === "md").length,
+        lg: allResults.filter((r) => r.suggested === "lg").length,
+    };
+    console.log("\n" + "=".repeat(60) + "\n");
+    if (allResults.length > 0) {
+        console.log(`${console_chars_1.emoji.warning}  WARNINGS (${allResults.length} total):\n`);
+        // Show first 20 examples
+        const examples = allResults.slice(0, 20);
+        for (const warning of examples) {
+            console.log(`  ${warning.file}:${warning.line}`);
+            console.log(`    ${warning.issue}\n`);
+        }
+        if (allResults.length > 20) {
+            console.log(`  ... and ${allResults.length - 20} more\n`);
+        }
+        console.log("Summary by size:");
+        console.log(`  - "small" -> "sm": ${bySuggested.sm} occurrences`);
+        console.log(`  - "medium" -> "md": ${bySuggested.md} occurrences`);
+        console.log(`  - "large" -> "lg": ${bySuggested.lg} occurrences\n`);
+    }
+    console.log("=".repeat(60));
+    reporter.showSummary({
+        filesProcessed: SCAN_DIRS.length,
+        issuesFound: allResults.length,
+        errors: 0,
+        warnings: allResults.length,
+        customMetrics: bySuggested,
+    });
+    if (allResults.length > 0 && strict) {
+        console.log(`${console_chars_1.emoji.error} FAILED (strict mode) - Legacy size naming found\n`);
+        console.log("Migrate to standard naming convention:");
+        console.log('  - Use "sm" instead of "small"');
+        console.log('  - Use "md" instead of "medium"');
+        console.log('  - Use "lg" instead of "large"\n');
+        process.exit(1);
+    }
+    if (allResults.length > 0) {
+        console.log(`${console_chars_1.emoji.warning}  PASSED with warnings - Legacy size naming found\n`);
+        console.log("Components support both conventions via normalizeSize(),");
+        console.log("but new code should use sm/md/lg for consistency.\n");
+        process.exit(0);
+    }
+    console.log(`${console_chars_1.emoji.success} PASSED - Consistent size naming throughout\n`);
+    process.exit(0);
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch((error) => {
+        console.error("Preflight error:", error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=size-naming-consistency.js.map

package/dist/checks/ui/size-naming-consistency.js.map

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

package/dist/checks/ui/skeleton-empty-state-validation.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env tsx
+/**
+ * Skeleton/Empty State Validation Preflight
+ *
+ * Ensures components don't show misleading skeleton loaders when there's no data.
+ *
+ * Problem: Showing skeleton rows (implying data is loading) when there are no items
+ * creates a confusing UX - users see loading indicators then suddenly an empty state.
+ *
+ * Correct Pattern:
+ * - Initial load with no prior data → Show empty state or minimal loading indicator
+ * - Refreshing existing data → Show skeleton matching expected data structure
+ * - Filtering/searching → Show skeleton only if data existed before filter
+ *
+ * Checks for:
+ * - Inline skeleton arrays without empty state consideration
+ * - Loading states that always show skeleton rows regardless of data existence
+ * - Missing empty state handling in table/list components
+ *
+ * Usage:
+ *   pnpm preflight:skeleton-empty-state
+ */
+export declare const id = "ui/skeleton-empty-state-validation";
+export declare const name = "Skeleton/Empty State Validation";
+export declare const description = "Ensures skeleton loaders don't mislead users when there's no data";
+export declare const category = "ui";
+export declare const blocking = true;
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=skeleton-empty-state-validation.d.ts.map

package/dist/checks/ui/skeleton-empty-state-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-empty-state-validation.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/skeleton-empty-state-validation.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAUH,eAAO,MAAM,EAAE,uCAAuC,CAAC;AACvD,eAAO,MAAM,IAAI,oCAAoC,CAAC;AACtD,eAAO,MAAM,WAAW,sEAAsE,CAAC;AAC/F,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,IAAI,UAAqD,CAAC;AA6JvE,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAiFzC"}

package/dist/checks/ui/skeleton-empty-state-validation.js

@@ -0,0 +1,268 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Skeleton/Empty State Validation Preflight
+ *
+ * Ensures components don't show misleading skeleton loaders when there's no data.
+ *
+ * Problem: Showing skeleton rows (implying data is loading) when there are no items
+ * creates a confusing UX - users see loading indicators then suddenly an empty state.
+ *
+ * Correct Pattern:
+ * - Initial load with no prior data → Show empty state or minimal loading indicator
+ * - Refreshing existing data → Show skeleton matching expected data structure
+ * - Filtering/searching → Show skeleton only if data existed before filter
+ *
+ * Checks for:
+ * - Inline skeleton arrays without empty state consideration
+ * - Loading states that always show skeleton rows regardless of data existence
+ * - Missing empty state handling in table/list components
+ *
+ * Usage:
+ *   pnpm preflight:skeleton-empty-state
+ */
+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 fs = __importStar(require("fs"));
+const console_chars_1 = require("../../utils/console-chars");
+const exclusions_1 = require("../../shared/exclusions");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+const glob_1 = require("glob");
+// Check metadata
+exports.id = "ui/skeleton-empty-state-validation";
+exports.name = "Skeleton/Empty State Validation";
+exports.description = "Ensures skeleton loaders don't mislead users when there's no data";
+exports.category = "ui";
+exports.blocking = true;
+exports.tags = ["ui", "skeleton", "loading", "empty-state", "ux"];
+// App-specific exclusions loaded from config
+let appExclusions = [];
+// Anti-patterns to detect
+const ANTI_PATTERNS = [
+    {
+        // Pattern: loading ? skeleton : data (without empty state check)
+        pattern: /\{loading\s*\?\s*(?:Array\.from|[\[\(])/,
+        name: "unconditional-skeleton-array",
+        message: "Skeleton array shown unconditionally during loading",
+        suggestion: "Check if data exists before showing skeleton rows. Use empty state for initial load with no data.",
+        severity: "error",
+    },
+    {
+        // Pattern: (loading || items.length > 0) showing skeleton
+        pattern: /\(\s*loading\s*\|\|\s*\w+\.length\s*>\s*0\s*\)\s*\?\s*(?:<|{)/,
+        name: "misleading-loading-condition",
+        message: "Loading state shows skeleton even when no data exists",
+        suggestion: "Separate initial loading (show empty state) from refresh loading (show skeleton).",
+        severity: "warning",
+    },
+    {
+        // Pattern: loading ? <Box>...Array.from... (skeleton in loading branch without data check)
+        pattern: /loading\s*\?\s*\(\s*<[A-Z][a-zA-Z]*[^>]*>[\s\S]{0,200}Array\.from/,
+        name: "skeleton-array-in-loading-branch",
+        message: "Skeleton array in loading branch without checking if data exists",
+        suggestion: "Add condition: loading && data.length > 0 for skeleton, else show loading message.",
+        severity: "warning",
+    },
+];
+// Good patterns that indicate proper handling
+const GOOD_PATTERNS = [
+    // Checks data existence before showing skeleton
+    /loading\s*&&\s*\w+\.length\s*>\s*0/,
+    /\w+\.length\s*>\s*0\s*&&\s*loading/,
+    // Uses separate conditions for loading vs empty
+    /loading\s*\?\s*.*:\s*\w+\.length\s*===?\s*0\s*\?/,
+    // Has explicit empty state component
+    /UnifiedEmptyState|EmptyState/,
+    // Uses SkeletonTable or similar preset
+    /SkeletonTable|SkeletonList|SkeletonProductGrid/,
+    // Uses a LoadingEmptyState component
+    /LoadingEmptyState/,
+    // Has proper conditional: loading && (hasData || hasFilters)
+    /loading\s*&&\s*\([^)]*\|\|/,
+];
+async function findComponentFiles() {
+    const patterns = [
+        "app/**/*.tsx",
+        "components/**/*.tsx",
+    ];
+    const allFiles = [];
+    for (const pattern of patterns) {
+        const matches = await (0, glob_1.glob)(pattern, {
+            ignore: ["**/node_modules/**", "**/*.test.tsx", "**/*.stories.tsx"],
+        });
+        allFiles.push(...matches);
+    }
+    // Filter using centralized exclusions
+    return allFiles.filter((file) => !(0, exclusions_1.shouldExcludeFile)(file, appExclusions));
+}
+function checkFile(filePath, content) {
+    const issues = [];
+    const lines = content.split("\n");
+    // Skip if file has good patterns (proper handling)
+    const hasGoodPattern = GOOD_PATTERNS.some((pattern) => pattern.test(content));
+    // Check if file uses skeleton components
+    const usesSkeleton = /UnifiedSkeleton|Skeleton|skeleton-row/.test(content);
+    // Check if file has table/list with loading state
+    const hasTableOrList = /TableBody|TableRow|\.map\s*\(/.test(content);
+    const hasLoadingState = /loading|isLoading/.test(content);
+    if (!usesSkeleton || !hasTableOrList || !hasLoadingState) {
+        return { file: filePath, issues: [] };
+    }
+    // Check for anti-patterns
+    for (const antiPattern of ANTI_PATTERNS) {
+        const match = content.match(antiPattern.pattern);
+        if (match && !hasGoodPattern) {
+            // Find line number
+            let lineNumber = 1;
+            let charCount = 0;
+            for (let i = 0; i < lines.length; i++) {
+                charCount += lines[i].length + 1;
+                if (charCount > (match.index || 0)) {
+                    lineNumber = i + 1;
+                    break;
+                }
+            }
+            issues.push({
+                file: filePath,
+                line: lineNumber,
+                severity: antiPattern.severity,
+                message: antiPattern.message,
+                suggestion: antiPattern.suggestion,
+                code: antiPattern.name,
+            });
+        }
+    }
+    // Check for inline skeleton arrays without empty state handling
+    const skeletonArrayMatch = content.match(/Array\.from\(\s*\{\s*length:\s*\d+\s*\}\s*\)\.map.*skeleton/is);
+    if (skeletonArrayMatch && !hasGoodPattern) {
+        // Check if there's an empty state nearby
+        const hasEmptyStateNearby = /UnifiedEmptyState|EmptyState|no.*found|no.*yet/i.test(content);
+        if (!hasEmptyStateNearby) {
+            let lineNumber = 1;
+            let charCount = 0;
+            for (let i = 0; i < lines.length; i++) {
+                charCount += lines[i].length + 1;
+                if (charCount > (skeletonArrayMatch.index || 0)) {
+                    lineNumber = i + 1;
+                    break;
+                }
+            }
+            issues.push({
+                file: filePath,
+                line: lineNumber,
+                severity: "warning",
+                message: "Skeleton array without corresponding empty state",
+                suggestion: "Add an EmptyState component for when data is empty after loading completes.",
+                code: "missing-empty-state",
+            });
+        }
+    }
+    return { file: filePath, issues };
+}
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const verbose = process.argv.includes("--verbose") || process.argv.includes("-v");
+    console.log(`\n${console_chars_1.emoji.search} Skeleton/Empty State Validation Preflight\n`);
+    console.log("Checking for proper skeleton/empty state handling...\n");
+    // Load app-specific exclusions from config
+    appExclusions = await (0, exclusions_1.getExclusions)(exports.id);
+    const files = await findComponentFiles();
+    console.log(`Scanning ${files.length} component files...\n`);
+    const allIssues = [];
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, "utf-8");
+            const result = checkFile(file, content);
+            allIssues.push(...result.issues);
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    // Group by severity
+    const errors = allIssues.filter((i) => i.severity === "error");
+    const warnings = allIssues.filter((i) => i.severity === "warning");
+    console.log((0, console_chars_1.createDivider)(70, "light"));
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} ERRORS (blocking):\n`);
+        for (const issue of errors) {
+            console.log(`  ${issue.file}:${issue.line}`);
+            console.log(`    ${issue.message}`);
+            console.log(`    ${console_chars_1.emoji.hint} ${issue.suggestion}\n`);
+        }
+    }
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning} WARNINGS:\n`);
+        const toShow = verbose ? warnings : warnings.slice(0, 10);
+        for (const issue of toShow) {
+            console.log(`  ${issue.file}:${issue.line}`);
+            console.log(`    ${issue.message}`);
+            if (verbose) {
+                console.log(`    ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            }
+            console.log();
+        }
+        if (!verbose && warnings.length > 10) {
+            console.log(`  ... and ${warnings.length - 10} more warnings\n`);
+        }
+    }
+    console.log((0, console_chars_1.createDivider)(70, "light"));
+    console.log(`\nFiles scanned: ${files.length}`);
+    console.log(`Errors: ${errors.length}`);
+    console.log(`Warnings: ${warnings.length}`);
+    if (errors.length === 0 && warnings.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} All skeleton loaders have proper empty state handling!\n`);
+    }
+    console.log(`\n${console_chars_1.emoji.hint} Correct patterns:`);
+    console.log("   - Initial load (no data): Show EmptyState or loading message");
+    console.log("   - Refresh (has data): Show skeleton matching data structure");
+    console.log("   - Filter/search: Show skeleton only if data existed before");
+    console.log("   - Always: Have EmptyState for when data.length === 0\n");
+    if (errors.length > 0) {
+        console.log(`${console_chars_1.emoji.error} Skeleton/Empty State Validation FAILED\n`);
+        process.exit(1);
+    }
+    if (warnings.length > 0) {
+        console.log(`${console_chars_1.emoji.warning} Skeleton/Empty State Validation passed with warnings\n`);
+    }
+    process.exit(0);
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=skeleton-empty-state-validation.js.map

package/dist/checks/ui/skeleton-empty-state-validation.js.map

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

package/dist/checks/ui/skeleton-size-consistency.d.ts

@@ -0,0 +1,37 @@
+#!/usr/bin/env tsx
+/**
+ * Skeleton Size Consistency Preflight Check (Enhanced)
+ *
+ * Comprehensive validation that skeleton components match their corresponding
+ * real components to prevent Cumulative Layout Shift (CLS) during loading.
+ *
+ * BLOCKING: No (warning only - helps catch CLS issues before they ship)
+ *
+ * Run: pnpm preflight:skeleton-size
+ *
+ * Checks:
+ * 1. KNOWN MAPPINGS - Validates skeleton heights against expected component heights
+ * 2. STRUCTURAL MAPPINGS - Validates skeleton elements match component structure
+ *    - Detects missing placeholders for component elements
+ *    - Detects stale placeholders for removed elements
+ *    - Compares action button counts between skeleton and component
+ * 3. AUTO-DISCOVERY - Finds skeleton/component pairs by naming convention
+ * 4. RESPONSIVE ANALYSIS - Compares mobile vs desktop height definitions
+ * 5. STRUCTURE MATCHING - Validates loading.tsx structure matches page structure
+ * 6. ELEMENT COUNT - Checks skeleton element counts match actual components
+ * 7. GRID PATTERNS - Validates grid column counts match between skeleton and page
+ * 8. DOCUMENTATION - Ensures skeletons document what they mirror
+ * 9. SPACING TOKENS - Validates consistent spacing between skeleton and component
+ * 10. DESIGN TOKEN CONSISTENCY - Validates CSS variables match between pairs
+ * 11. BORDER/SHADOW CONSISTENCY - Validates visual styling matches
+ * 12. ARIA/ACCESSIBILITY - Validates skeleton has proper aria-labels
+ * 13. ICON PLACEHOLDER VALIDATION - Validates icon placeholders match actual icons
+ */
+export declare const id = "ui/skeleton-size-consistency";
+export declare const name = "Skeleton Size Consistency";
+export declare const category = "ui";
+export declare const blocking = false;
+export declare const description = "Skeleton Size Consistency Preflight Check (Enhanced)";
+export declare const tags: string[];
+export declare function run(): Promise<boolean>;
+//# sourceMappingURL=skeleton-size-consistency.d.ts.map

package/dist/checks/ui/skeleton-size-consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-size-consistency.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/skeleton-size-consistency.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAYH,eAAO,MAAM,EAAE,iCAAiC,CAAC;AACjD,eAAO,MAAM,IAAI,8BAA8B,CAAC;AAChD,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,yDAAyD,CAAC;AAClF,eAAO,MAAM,IAAI,UAAS,CAAC;AA05C3B,wBAAsB,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAG5C"}