@empline/preflight 1.1.0

package/dist/checks/master-preflight.js

@@ -0,0 +1,257 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Master Preflight System - Unified Entry Point
+ *
+ * This is a thin wrapper around workflows/all.ts that provides:
+ * - Category-based filtering (e.g., `pnpm preflight ui`)
+ * - Quick mode for fast checks only
+ * - Verbose output option
+ *
+ * ALL check definitions live in workflows/all.ts (single source of truth).
+ * This file only provides the CLI interface and category mapping.
+ *
+ * Usage:
+ *   pnpm preflight                    # All blocking checks
+ *   pnpm preflight all                # All checks with warnings
+ *   pnpm preflight typescript         # Single category
+ *   pnpm preflight ui database        # Multiple categories
+ *   pnpm preflight --quick            # Critical checks only (< 30s)
+ *   pnpm preflight --verbose          # Show detailed output
+ *
+ * CLI Options (passed through to workflows/all.ts):
+ *   --timeout-ms <ms>     Override default timeout (env: PREFLIGHT_TIMEOUT_MS)
+ *   --fail-fast           Stop on first failure (env: PREFLIGHT_FAIL_FAST)
+ *   --json <path>         Write JSON report (env: PREFLIGHT_JSON)
+ *   --junit <path>        Write JUnit XML report (env: PREFLIGHT_JUNIT)
+ *   --sarif <path>        Write SARIF report (env: PREFLIGHT_SARIF)
+ *
+ * Environment Variables:
+ *   PREFLIGHT_TIMEOUT_MS      Default timeout for all checks
+ *   PREFLIGHT_FAIL_FAST       Stop on first failure (true/false)
+ *   PREFLIGHT_JSON            Path for JSON output
+ *   PREFLIGHT_JUNIT           Path for JUnit XML output
+ *   PREFLIGHT_SARIF           Path for SARIF output
+ *   PREFLIGHT_FINDINGS_PATH   Path for structured findings output
+ *   PREFLIGHT_FINDINGS_FILE   Alias for PREFLIGHT_FINDINGS_PATH
+ *
+ * Categories map to filter patterns for workflows/all.ts:
+ *   typescript  ${chars.arrow} TypeScript|Syntax
+ *   runtime     → Runtime|Hydration|process\.env|publicEnv|Error Boundaries
+ *   security    → Security|NextAuth|API Route|Env
+ *   database    → Database|Prisma|Schema
+ *   ui          → UI |Component|Spacing|Accessibility|Mobile|Navigation
+ *   quality     → Quality|Shared Components|Dead Code|Import
+ *   performance → Performance|Bundle|Lazy|Image
+ *   testing     → Test|E2E|Coverage|Regression
+ *   organization→ Organization|File|Route|Cleanup|Steering
+ *   business    → Business|Shipping|Price|Currency|Order|Inventory
+ *   hardened    → Hardened|DRAFT|Secret|Hook|Async|Console
+ */
+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 child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const console_chars_1 = require("../utils/console-chars");
+const universal_progress_reporter_1 = require("./system/universal-progress-reporter");
+// Check metadata
+exports.id = "misc/master-preflight";
+exports.name = "Master Preflight";
+exports.category = "misc";
+exports.blocking = false;
+exports.description = "Master Preflight System - Unified Entry Point";
+exports.tags = ["misc"];
+// CATEGORY → FILTER PATTERN MAPPING
+const CATEGORY_FILTERS = {
+    typescript: "TypeScript|Syntax Validation",
+    runtime: "Runtime|Hydration|process\\.env|publicEnv|Error Boundaries|Node Deprecations",
+    security: "Security|NextAuth|API Route|Env file|Env value|Rate Limiting|Webhook|Path Traversal|SQL Injection|Sensitive Data|CSRF",
+    database: "Database|Prisma|Schema|Transaction|Soft Delete",
+    ui: "UI |Component|Spacing|Accessibility|Mobile|Navigation|Breadcrumb|Touch Target|Viewport|Typography|Responsive|Media|Loading|Forms|Tokens|Style|Layout|Cleanup|Standards",
+    quality: "Quality|Shared Components|Dead Code|Import|Architecture|Styling Standards|SX Prop",
+    performance: "Performance|Bundle|Lazy|Image|Core Web Vitals|Script Performance",
+    testing: "Test|E2E|Coverage|Regression|Action Regression|Data Entry",
+    organization: "Organization|File|Route|Cleanup|Steering|Agent|API Route Naming|Store vs Seller",
+    business: "Business|Shipping|Price|Currency|Order|Inventory|Idempotency|Timezone|Store Order",
+    hardened: "Hardened|DRAFT|Secret|Hook|Async|Console|Type Safety|ESLint Concurrency",
+    imports: "Import|N\\+1",
+    seo: "SEO|Hardcoded URLs|Category FAQ|Missing Metadata",
+    framework: "Compatibility|Node 25|Next\\.js 16|Prisma 7|React 19|Zod 4|TanStack|Tailwind",
+};
+// Quick mode only runs these categories (fast checks)
+const QUICK_CATEGORIES = ["typescript", "runtime", "security", "hardened"];
+// CLI PARSING
+function parseBool(value) {
+    if (!value)
+        return undefined;
+    const v = value.trim().toLowerCase();
+    if (["1", "true", "yes", "y", "on"].includes(v))
+        return true;
+    if (["0", "false", "no", "n", "off"].includes(v))
+        return false;
+    return undefined;
+}
+function parseIntArg(value) {
+    if (!value)
+        return undefined;
+    const n = Number.parseInt(value, 10);
+    return Number.isFinite(n) ? n : undefined;
+}
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    const quick = args.includes("--quick") || args.includes("-q");
+    const all = args.includes("all") || args.includes("--all");
+    const timeoutIdx = args.indexOf("--timeout-ms");
+    const cliTimeoutMs = timeoutIdx !== -1 ? parseIntArg(args[timeoutIdx + 1]) : undefined;
+    const envTimeoutMs = parseIntArg(process.env.PREFLIGHT_TIMEOUT_MS);
+    const failFast = args.includes("--fail-fast") || parseBool(process.env.PREFLIGHT_FAIL_FAST) === true;
+    const jsonIdx = args.indexOf("--json");
+    const jsonPath = jsonIdx !== -1 ? args[jsonIdx + 1] : process.env.PREFLIGHT_JSON;
+    const junitIdx = args.indexOf("--junit");
+    const junitPath = junitIdx !== -1 ? args[junitIdx + 1] : process.env.PREFLIGHT_JUNIT;
+    const sarifIdx = args.indexOf("--sarif");
+    const sarifPath = sarifIdx !== -1 ? args[sarifIdx + 1] : process.env.PREFLIGHT_SARIF;
+    const categories = [];
+    const flagsWithValue = new Set(["--timeout-ms", "--json", "--junit", "--sarif"]);
+    for (let i = 0; i < args.length; i += 1) {
+        const a = args[i];
+        if (a === "all")
+            continue;
+        if (flagsWithValue.has(a)) {
+            i += 1;
+            continue;
+        }
+        if (a.startsWith("-"))
+            continue;
+        if (CATEGORY_FILTERS[a]) {
+            categories.push(a);
+        }
+    }
+    return {
+        categories,
+        verbose,
+        quick,
+        all,
+        timeoutMs: cliTimeoutMs ?? envTimeoutMs,
+        failFast,
+        jsonPath,
+        junitPath,
+        sarifPath,
+    };
+}
+// SARIF SUPPORT (for CI integration - required by preflight-system-validation)
+// Note: SARIF generation is handled by workflows/all.ts
+// This file just passes through the --sarif flag
+// The defaultConfiguration level is set in workflows/all.ts toSarif() function
+// MAIN
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const { categories, verbose, quick, all, timeoutMs, failFast, jsonPath, junitPath, sarifPath } = parseArgs();
+    console.log(`\n${console_chars_1.emoji.rocket} MASTER PREFLIGHT SYSTEM`);
+    console.log((0, console_chars_1.createDivider)(70, "heavy"));
+    // Build filter pattern from categories
+    let filterPattern;
+    if (quick) {
+        // Quick mode: only fast checks from specific categories
+        const quickFilters = QUICK_CATEGORIES.map((c) => CATEGORY_FILTERS[c]).filter(Boolean);
+        filterPattern = quickFilters.join("|");
+        console.log(`Mode: Quick (fast checks only)`);
+        console.log(`Categories: ${QUICK_CATEGORIES.join(", ")}`);
+    }
+    else if (categories.length > 0) {
+        // Specific categories requested
+        const categoryFilters = categories.map((c) => CATEGORY_FILTERS[c]).filter(Boolean);
+        filterPattern = categoryFilters.join("|");
+        console.log(`Mode: Category filter`);
+        console.log(`Categories: ${categories.join(", ")}`);
+    }
+    else {
+        // Default: all checks
+        console.log(`Mode: ${all ? "All (including warnings)" : "Standard (blocking only)"}`);
+    }
+    if (filterPattern) {
+        console.log(`Filter: ${filterPattern.substring(0, 80)}${filterPattern.length > 80 ? "..." : ""}`);
+    }
+    console.log((0, console_chars_1.createDivider)(70, "heavy"));
+    console.log("");
+    // Build command args for workflows/all.ts
+    const allTsPath = path.join(__dirname, "workflows", "all.ts");
+    // Execute workflows/all.ts with the filter
+    // Build the full command as a single string to avoid shell interpretation issues
+    const tsxPath = "pnpm";
+    const tsxArgs = ["tsx", allTsPath];
+    if (filterPattern) {
+        // Quote the filter pattern to prevent shell interpretation
+        tsxArgs.push("--filter", `"${filterPattern}"`);
+    }
+    if (timeoutMs) {
+        tsxArgs.push("--timeout-ms", String(timeoutMs));
+    }
+    if (failFast) {
+        tsxArgs.push("--fail-fast");
+    }
+    if (jsonPath) {
+        tsxArgs.push("--json", jsonPath);
+    }
+    if (junitPath) {
+        tsxArgs.push("--junit", junitPath);
+    }
+    if (sarifPath) {
+        tsxArgs.push("--sarif", sarifPath);
+    }
+    return new Promise((resolve) => {
+        const child = (0, child_process_1.spawn)(tsxPath, tsxArgs, {
+            stdio: "inherit",
+            env: process.env,
+            cwd: process.cwd(),
+            shell: true,
+        });
+        child.on("close", (code) => {
+            process.exit(code ?? 0);
+        });
+        child.on("error", (err) => {
+            console.error("Failed to run preflight:", err);
+            process.exit(1);
+        });
+    });
+}
+run().catch((err) => {
+    console.error("Preflight error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=master-preflight.js.map

package/dist/checks/master-preflight.js.map

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

package/dist/checks/nextjs/dynamic-route-exports.d.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env tsx
+/**
+ * Dynamic Route Exports Preflight - BLOCKING
+ *
+ * This preflight BLOCKS when `export const dynamic = "force-dynamic"` is found
+ * because the project uses `cacheComponents: true` in next.config.js.
+ *
+ * With cacheComponents enabled, Next.js 16 automatically handles dynamic rendering
+ * when routes use dynamic APIs like:
+ * - headers() / cookies() from next/headers
+ * - auth() from auth libraries (uses headers internally)
+ * - request.url / request.nextUrl access
+ * - searchParams access in route handlers
+ *
+ * No manual `export const dynamic` is needed - Next.js detects these automatically.
+ * Adding `export const dynamic` will cause build failures.
+ *
+ * Usage:
+ *   pnpm preflight:dynamic-routes       # Check for violations (blocking)
+ *   pnpm preflight:dynamic-routes --fix # Auto-remove violations
+ */
+export declare const id = "nextjs/dynamic-route-exports";
+export declare const name = "Dynamic Route Exports";
+export declare const category = "nextjs";
+export declare const blocking = true;
+export declare const description = "Dynamic Route Exports Preflight - BLOCKING";
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=dynamic-route-exports.d.ts.map

package/dist/checks/nextjs/dynamic-route-exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-route-exports.d.ts","sourceRoot":"","sources":["../../../src/checks/nextjs/dynamic-route-exports.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,eAAO,MAAM,EAAE,iCAAiC,CAAC;AACjD,eAAO,MAAM,IAAI,0BAA0B,CAAC;AAC5C,eAAO,MAAM,QAAQ,WAAW,CAAC;AACjC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,+CAA+C,CAAC;AACxE,eAAO,MAAM,IAAI,UAAa,CAAC;AAgH/B,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAqDzC"}

package/dist/checks/nextjs/dynamic-route-exports.js

@@ -0,0 +1,204 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Dynamic Route Exports Preflight - BLOCKING
+ *
+ * This preflight BLOCKS when `export const dynamic = "force-dynamic"` is found
+ * because the project uses `cacheComponents: true` in next.config.js.
+ *
+ * With cacheComponents enabled, Next.js 16 automatically handles dynamic rendering
+ * when routes use dynamic APIs like:
+ * - headers() / cookies() from next/headers
+ * - auth() from auth libraries (uses headers internally)
+ * - request.url / request.nextUrl access
+ * - searchParams access in route handlers
+ *
+ * No manual `export const dynamic` is needed - Next.js detects these automatically.
+ * Adding `export const dynamic` will cause build failures.
+ *
+ * Usage:
+ *   pnpm preflight:dynamic-routes       # Check for violations (blocking)
+ *   pnpm preflight:dynamic-routes --fix # Auto-remove violations
+ */
+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 path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "nextjs/dynamic-route-exports";
+exports.name = "Dynamic Route Exports";
+exports.category = "nextjs";
+exports.blocking = true;
+exports.description = "Dynamic Route Exports Preflight - BLOCKING";
+exports.tags = ["nextjs"];
+const DYNAMIC_EXPORT_PATTERN = /^export\s+const\s+dynamic\s*=\s*["']force-dynamic["']/;
+function findViolations(dir, violations = []) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        // Skip node_modules, .next, test files, and non-route directories
+        if (entry.name === "node_modules" ||
+            entry.name === ".next" ||
+            entry.name === ".git" ||
+            entry.name.includes(".test.") ||
+            entry.name.includes(".spec.")) {
+            continue;
+        }
+        if (entry.isDirectory()) {
+            findViolations(fullPath, violations);
+        }
+        else if (entry.isFile() && /\.(ts|tsx|js|jsx)$/.test(entry.name)) {
+            // Only check app directory route files
+            const relativePath = path.relative(process.cwd(), fullPath).replace(/\\/g, "/");
+            if (!relativePath.startsWith("app/"))
+                continue;
+            // Skip steering/docs files that might have examples
+            if (relativePath.includes(".kiro/") || relativePath.includes("docs/"))
+                continue;
+            try {
+                const content = fs.readFileSync(fullPath, "utf8");
+                const lines = content.split("\n");
+                for (let i = 0; i < lines.length; i++) {
+                    const line = lines[i].trim();
+                    if (DYNAMIC_EXPORT_PATTERN.test(line)) {
+                        violations.push({
+                            file: relativePath,
+                            line: i + 1,
+                            content: line,
+                        });
+                    }
+                }
+            }
+            catch {
+                // Skip files that can't be read
+            }
+        }
+    }
+    return violations;
+}
+function fixViolations(violations) {
+    let fixed = 0;
+    for (const violation of violations) {
+        const fullPath = path.join(process.cwd(), violation.file);
+        try {
+            const content = fs.readFileSync(fullPath, "utf8");
+            const lines = content.split("\n");
+            // Remove the line and any preceding comment about dynamic rendering
+            const newLines = [];
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                const trimmed = line.trim();
+                // Skip the dynamic export line
+                if (DYNAMIC_EXPORT_PATTERN.test(trimmed)) {
+                    // Also remove preceding comment if it's about dynamic rendering
+                    if (newLines.length > 0) {
+                        const prevLine = newLines[newLines.length - 1].trim();
+                        if (prevLine.startsWith("//") &&
+                            (prevLine.toLowerCase().includes("dynamic") ||
+                                prevLine.toLowerCase().includes("force") ||
+                                prevLine.toLowerCase().includes("rendering"))) {
+                            newLines.pop();
+                        }
+                    }
+                    continue;
+                }
+                newLines.push(line);
+            }
+            // Clean up extra blank lines
+            const cleanedContent = newLines
+                .join("\n")
+                .replace(/\n{3,}/g, "\n\n")
+                .replace(/^\n+/, "");
+            fs.writeFileSync(fullPath, cleanedContent, "utf8");
+            fixed++;
+            console.log(`  ${console_chars_1.emoji.success} Fixed: ${violation.file}`);
+        }
+        catch (err) {
+            console.log(`  ${console_chars_1.emoji.error} Failed to fix: ${violation.file}`);
+        }
+    }
+    return fixed;
+}
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const args = process.argv.slice(2);
+    const shouldFix = args.includes("--fix");
+    const verbose = args.includes("--verbose");
+    console.log(`\n${console_chars_1.emoji.search} Dynamic Route Exports Check`);
+    console.log(`${console_chars_1.box.doubleHorizontal}`.repeat(50));
+    console.log(`\n${console_chars_1.emoji.info} Checking for incompatible "export const dynamic" exports...`);
+    console.log("   (cacheComponents: true requires NO manual dynamic exports)\n");
+    const appDir = path.join(process.cwd(), "app");
+    if (!fs.existsSync(appDir)) {
+        console.log(`${console_chars_1.emoji.warning} No app/ directory found. Skipping.\n`);
+        process.exit(0);
+    }
+    const violations = findViolations(appDir);
+    if (violations.length === 0) {
+        console.log(`${console_chars_1.emoji.success} No violations found. All routes are compatible with cacheComponents.\n`);
+        process.exit(0);
+    }
+    console.log(`${console_chars_1.emoji.error} Found ${violations.length} violation(s):\n`);
+    for (const v of violations) {
+        console.log(`  ${console_chars_1.emoji.error} ${v.file}:${v.line}`);
+        if (verbose) {
+            console.log(`     ${v.content}`);
+        }
+    }
+    console.log("");
+    console.log(`${console_chars_1.emoji.info} Why this fails:`);
+    console.log("   - next.config.js has cacheComponents: true");
+    console.log('   - This is INCOMPATIBLE with "export const dynamic = \\"force-dynamic\\""');
+    console.log("   - Next.js 16 automatically detects dynamic APIs and opts out of prerendering");
+    console.log("   - Remove these exports to fix the build\n");
+    if (shouldFix) {
+        console.log(`${console_chars_1.emoji.wrench} Auto-fixing violations...\n`);
+        const fixed = fixViolations(violations);
+        console.log(`\n${console_chars_1.emoji.success} Fixed ${fixed} file(s).\n`);
+        process.exit(0);
+    }
+    console.log(`${console_chars_1.emoji.info} Run with --fix to auto-remove these exports:\n`);
+    console.log("   pnpm preflight:dynamic-routes --fix\n");
+    process.exit(1);
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=dynamic-route-exports.js.map

package/dist/checks/nextjs/dynamic-route-exports.js.map

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

package/dist/checks/nextjs/essential-files-validation.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Preflight: Essential Files Validation
+ *
+ * Validates that critical Next.js files exist before build:
+ * - Error pages (404, 500, error boundaries)
+ * - Layout and loading states
+ * - Configuration files
+ * - Security files
+ *
+ * Also validates content patterns:
+ * - Error pages must use UnifiedErrorState for consistency
+ * - Loading pages should use skeletons (not spinners)
+ *
+ * These files are essential for production reliability and user experience.
+ * Missing error pages cause poor UX when errors occur.
+ */
+export declare const id = "nextjs/essential-files-validation";
+export declare const name = "Essential Files Validation";
+export declare const category = "nextjs";
+export declare const blocking = true;
+export declare const description = "Preflight: Essential Files Validation";
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=essential-files-validation.d.ts.map

package/dist/checks/nextjs/essential-files-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"essential-files-validation.d.ts","sourceRoot":"","sources":["../../../src/checks/nextjs/essential-files-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,eAAO,MAAM,EAAE,sCAAsC,CAAC;AACtD,eAAO,MAAM,IAAI,+BAA+B,CAAC;AACjD,eAAO,MAAM,QAAQ,WAAW,CAAC;AACjC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,0CAA0C,CAAC;AACnE,eAAO,MAAM,IAAI,UAA0B,CAAC;AAuN5C,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAgJzC"}