@empline/preflight 1.0.20

package/dist/checks/nextjs/metadata-api-placement.js

@@ -0,0 +1,274 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Metadata API Placement Preflight - BLOCKING
+ *
+ * Ensures Next.js metadata API functions are only exported from correct locations.
+ *
+ * PROBLEM THIS PREVENTS:
+ * - `generateSitemaps()` exported from route handlers causes:
+ *   "You cannot use different slug names for the same dynamic path ('__metadata_id__' !== 'id')"
+ * - This cryptic error breaks ALL dynamic routes, not just sitemaps
+ *
+ * RULES:
+ * - `generateSitemaps()` → Only in app/sitemap.ts (NOT in app/sitemap/[id]/route.ts)
+ * - `generateImageMetadata()` → Only in opengraph-image.tsx or twitter-image.tsx files
+ *
+ * WHY:
+ * Next.js uses internal `__metadata_id__` slug for these APIs. Exporting them from
+ * custom dynamic routes like `[id]` creates a slug naming conflict.
+ *
+ * Usage:
+ *   pnpm preflight:metadata-api-placement
+ */
+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;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+// Check metadata
+exports.id = "nextjs/metadata-api-placement";
+exports.name = "Metadata Api Placement";
+exports.category = "nextjs";
+exports.blocking = false;
+exports.description = "Metadata API Placement Preflight - BLOCKING";
+exports.tags = ["nextjs"];
+// Metadata API functions that must be in specific locations
+const METADATA_API_RULES = {
+    generateSitemaps: {
+        allowedPatterns: [/^app\/sitemap\.ts$/],
+        description: "generateSitemaps() must only be exported from app/sitemap.ts",
+    },
+    generateImageMetadata: {
+        allowedPatterns: [/opengraph-image\.(ts|tsx|js|jsx)$/, /twitter-image\.(ts|tsx|js|jsx)$/],
+        description: "generateImageMetadata() must only be exported from opengraph-image or twitter-image files",
+    },
+};
+// Forbidden folder patterns that conflict with Next.js metadata conventions
+// These file names are reserved by Next.js and use __metadata_id__ internally
+const FORBIDDEN_FOLDER_PATTERNS = [
+    {
+        pattern: /^app\/sitemap\/\[/,
+        description: "app/sitemap/[id] conflicts with app/sitemap.ts metadata convention. Use app/sitemaps/[id] instead (plural).",
+    },
+    {
+        pattern: /^app\/robots\/\[/,
+        description: "app/robots/[id] conflicts with app/robots.ts metadata convention. Use a different folder name.",
+    },
+    {
+        pattern: /^app\/manifest\/\[/,
+        description: "app/manifest/[id] conflicts with app/manifest.ts metadata convention. Use a different folder name.",
+    },
+    {
+        pattern: /^app\/.*\/opengraph-image\/\[/,
+        description: "opengraph-image/[id] conflicts with Next.js image metadata convention. Use a different folder name.",
+    },
+    {
+        pattern: /^app\/.*\/twitter-image\/\[/,
+        description: "twitter-image/[id] conflicts with Next.js image metadata convention. Use a different folder name.",
+    },
+    {
+        pattern: /^app\/.*\/icon\/\[/,
+        description: "icon/[id] conflicts with Next.js icon metadata convention. Use a different folder name (e.g., icons/).",
+    },
+    {
+        pattern: /^app\/.*\/apple-icon\/\[/,
+        description: "apple-icon/[id] conflicts with Next.js icon metadata convention. Use a different folder name.",
+    },
+];
+// Pattern to detect exports of these functions
+const EXPORT_PATTERNS = Object.keys(METADATA_API_RULES).map((name) => ({
+    name,
+    // Matches: export async function generateSitemaps, export function generateSitemaps, export { generateSitemaps }
+    pattern: new RegExp(`(?:export\\s+(?:async\\s+)?function\\s+${name}|export\\s*\\{[^}]*\\b${name}\\b[^}]*\\})`),
+}));
+// Check for metadata file + same-named folder conflicts
+function findMetadataFolderConflicts(appDir) {
+    const conflicts = [];
+    // Metadata files that reserve their folder namespace
+    const metadataFiles = [
+        { file: "sitemap.ts", folder: "sitemap" },
+        { file: "sitemap.tsx", folder: "sitemap" },
+        { file: "robots.ts", folder: "robots" },
+        { file: "robots.tsx", folder: "robots" },
+        { file: "manifest.ts", folder: "manifest" },
+        { file: "manifest.tsx", folder: "manifest" },
+    ];
+    for (const { file, folder } of metadataFiles) {
+        const filePath = path.join(appDir, file);
+        const folderPath = path.join(appDir, folder);
+        if (fs.existsSync(filePath) && fs.existsSync(folderPath)) {
+            const stat = fs.statSync(folderPath);
+            if (stat.isDirectory()) {
+                conflicts.push({
+                    folder: `app/${folder}`,
+                    reason: `Both app/${file} and app/${folder}/ exist. Next.js uses __metadata_id__ for ${file}, which conflicts with any dynamic routes in ${folder}/. Rename the folder (e.g., ${folder}s/).`,
+                });
+            }
+        }
+    }
+    return conflicts;
+}
+function findFolderViolations(dir, violations = []) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.name === "node_modules" || entry.name === ".next" || entry.name === ".git") {
+            continue;
+        }
+        if (entry.isDirectory()) {
+            const relativePath = path.relative(process.cwd(), fullPath).replace(/\\/g, "/");
+            // Check against forbidden folder patterns
+            for (const { pattern, description } of FORBIDDEN_FOLDER_PATTERNS) {
+                if (pattern.test(relativePath)) {
+                    violations.push({
+                        folder: relativePath,
+                        reason: description,
+                    });
+                }
+            }
+            findFolderViolations(fullPath, violations);
+        }
+    }
+    return violations;
+}
+function findViolations(dir, violations = []) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        // Skip non-essential 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)) {
+            const relativePath = path.relative(process.cwd(), fullPath).replace(/\\/g, "/");
+            // Only check app directory
+            if (!relativePath.startsWith("app/"))
+                continue;
+            // Skip docs/examples
+            if (relativePath.includes(".kiro/") || relativePath.includes("docs/"))
+                continue;
+            try {
+                const content = fs.readFileSync(fullPath, "utf8");
+                const lines = content.split("\n");
+                for (const { name, pattern } of EXPORT_PATTERNS) {
+                    const rule = METADATA_API_RULES[name];
+                    // Check if this file is allowed to export this function
+                    const isAllowed = rule.allowedPatterns.some((p) => p.test(relativePath));
+                    if (isAllowed)
+                        continue;
+                    // Check if file exports this function
+                    for (let i = 0; i < lines.length; i++) {
+                        if (pattern.test(lines[i])) {
+                            violations.push({
+                                file: relativePath,
+                                line: i + 1,
+                                exportName: name,
+                                reason: rule.description,
+                            });
+                        }
+                    }
+                }
+            }
+            catch {
+                // Skip files that can't be read
+            }
+        }
+    }
+    return violations;
+}
+async function run() {
+    const args = process.argv.slice(2);
+    const verbose = args.includes("--verbose");
+    console.log(`\n${console_chars_1.emoji.search} Metadata API Placement Check`);
+    console.log(`${console_chars_1.box.doubleHorizontal}`.repeat(50));
+    console.log(`\n${console_chars_1.emoji.info} Checking for misplaced Next.js metadata API exports...`);
+    console.log("   (These cause '__metadata_id__' vs '[id]' slug conflicts)\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);
+    const folderViolations = findFolderViolations(appDir);
+    const metadataConflicts = findMetadataFolderConflicts(appDir);
+    const allFolderViolations = [...folderViolations, ...metadataConflicts];
+    const totalViolations = violations.length + allFolderViolations.length;
+    if (totalViolations === 0) {
+        console.log(`${console_chars_1.emoji.success} No violations found. Metadata APIs are correctly placed.\n`);
+        process.exit(0);
+    }
+    console.log(`${console_chars_1.emoji.error} Found ${totalViolations} violation(s):\n`);
+    // Show folder violations first
+    for (const v of allFolderViolations) {
+        console.log(`  ${console_chars_1.emoji.error} ${v.folder}/`);
+        console.log(`     ${v.reason}`);
+        console.log("");
+    }
+    // Show export violations
+    for (const v of violations) {
+        console.log(`  ${console_chars_1.emoji.error} ${v.file}:${v.line}`);
+        console.log(`     Export: ${v.exportName}()`);
+        console.log(`     ${v.reason}`);
+        if (verbose) {
+            console.log("");
+        }
+    }
+    console.log("");
+    console.log(`${console_chars_1.emoji.info} Why this fails:`);
+    console.log("   - Next.js metadata APIs use internal '__metadata_id__' slug");
+    console.log("   - Exporting from custom dynamic routes like [id] creates a conflict");
+    console.log("   - Error: 'You cannot use different slug names for the same dynamic path'");
+    console.log("   - This breaks ALL dynamic routes, not just the offending file\n");
+    console.log(`${console_chars_1.emoji.wrench} How to fix:`);
+    console.log("   - Move generateSitemaps() to app/sitemap.ts");
+    console.log("   - Move generateImageMetadata() to opengraph-image.tsx files");
+    console.log("   - Route handlers should use regular GET/POST exports only");
+    console.log("   - Rename app/sitemap/[id] to app/sitemaps/[id] (plural) to avoid conflict\n");
+    process.exit(1);
+}
+run().catch((error) => {
+    console.error(`${console_chars_1.emoji.error} Metadata API placement check failed:`, error);
+    process.exit(1);
+});
+//# sourceMappingURL=metadata-api-placement.js.map

package/dist/checks/nextjs/metadata-api-placement.js.map

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

package/dist/checks/nextjs/nextjs-image-validation.d.ts

@@ -0,0 +1,52 @@
+#!/usr/bin/env tsx
+/**
+ * Next.js Image Component Validation Preflight
+ *
+ * Catches common Next.js Image component issues:
+ * - Modified width/height without width: "auto" or height: "auto" in style
+ * - Missing loading="eager" on LCP (above-the-fold) images
+ * - CSS dimension conflicts that break aspect ratio
+ *
+ * Usage:
+ *   pnpm preflight:nextjs-image
+ *   pnpm preflight:nextjs-image --verbose
+ */
+export declare const id = "nextjs/nextjs-image-validation";
+export declare const name = "Nextjs Image Validation";
+export declare const category = "nextjs";
+export declare const blocking = false;
+export declare const description = "Next.js Image Component Validation Preflight";
+export declare const tags: string[];
+interface Issue {
+    file: string;
+    line: number;
+    type: string;
+    severity: "error" | "warning";
+    message: string;
+    suggestion: string;
+    snippet?: string;
+}
+interface CheckResult {
+    name: string;
+    passed: boolean;
+    issues: Issue[];
+    duration: number;
+}
+declare class NextJSImageValidator {
+    private verbose;
+    constructor(options?: {
+        verbose?: boolean;
+    });
+    /**
+     * Check for Next.js Image components with modified dimensions but missing auto styles
+     */
+    checkImageAspectRatio(): Promise<CheckResult>;
+    private analyzeImageComponent;
+    runAll(): Promise<{
+        passed: boolean;
+        issues: Issue[];
+        duration: number;
+    }>;
+}
+export { NextJSImageValidator };
+//# sourceMappingURL=nextjs-image-validation.d.ts.map

package/dist/checks/nextjs/nextjs-image-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-image-validation.d.ts","sourceRoot":"","sources":["../../../src/checks/nextjs/nextjs-image-validation.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AASH,eAAO,MAAM,EAAE,mCAAmC,CAAC;AACnD,eAAO,MAAM,IAAI,4BAA4B,CAAC;AAC9C,eAAO,MAAM,QAAQ,WAAW,CAAC;AACjC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,iDAAiD,CAAC;AAC1E,eAAO,MAAM,IAAI,UAA0B,CAAC;AAE5C,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAiBD,cAAM,oBAAoB;IACxB,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO;IAI/C;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,WAAW,CAAC;IA4DnD,OAAO,CAAC,qBAAqB;IAwFvB,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAyChF;AAYD,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/checks/nextjs/nextjs-image-validation.js

@@ -0,0 +1,253 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Next.js Image Component Validation Preflight
+ *
+ * Catches common Next.js Image component issues:
+ * - Modified width/height without width: "auto" or height: "auto" in style
+ * - Missing loading="eager" on LCP (above-the-fold) images
+ * - CSS dimension conflicts that break aspect ratio
+ *
+ * Usage:
+ *   pnpm preflight:nextjs-image
+ *   pnpm preflight:nextjs-image --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.NextJSImageValidator = exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+const fs = __importStar(require("fs"));
+const console_chars_1 = require("../../utils/console-chars");
+const file_cache_1 = require("../../shared/file-cache");
+const glob_patterns_1 = require("../../shared/glob-patterns");
+// Check metadata
+exports.id = "nextjs/nextjs-image-validation";
+exports.name = "Nextjs Image Validation";
+exports.category = "nextjs";
+exports.blocking = false;
+exports.description = "Next.js Image Component Validation Preflight";
+exports.tags = ["nextjs", "validation"];
+const EXCLUDED = [...glob_patterns_1.STANDARD_EXCLUDES_WITH_TESTS];
+// Images that are typically above-the-fold and should have loading="eager"
+const LCP_IMAGE_PATTERNS = [/logo/i, /hero/i, /banner/i, /featured/i, /header/i];
+// CACHED FILE LISTS - Scan once, use everywhere
+let _cachedAppComponentsTsxFiles = null;
+async function getAppComponentsTsxFiles() {
+    if (!_cachedAppComponentsTsxFiles) {
+        _cachedAppComponentsTsxFiles = await file_cache_1.fileCache.getAppAndComponentsTSX();
+    }
+    return _cachedAppComponentsTsxFiles;
+}
+class NextJSImageValidator {
+    verbose;
+    constructor(options = {}) {
+        this.verbose = options.verbose || false;
+    }
+    /**
+     * Check for Next.js Image components with modified dimensions but missing auto styles
+     */
+    async checkImageAspectRatio() {
+        const startTime = Date.now();
+        const issues = [];
+        const files = await getAppComponentsTsxFiles();
+        for (const file of files) {
+            const content = fs.readFileSync(file, "utf8");
+            const lines = content.split("\n");
+            // Track multi-line Image components
+            let inImageComponent = false;
+            let imageStartLine = 0;
+            let imageContent = "";
+            let braceDepth = 0;
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                // Skip comments
+                if (line.trim().startsWith("//") || line.trim().startsWith("*"))
+                    continue;
+                // Detect start of Image component
+                if (line.includes("<Image") && !line.includes("</Image>")) {
+                    inImageComponent = true;
+                    imageStartLine = i;
+                    imageContent = line;
+                    braceDepth = (line.match(/\{/g) || []).length - (line.match(/\}/g) || []).length;
+                    // Check if single-line Image
+                    if (line.includes("/>") || line.includes("</Image>")) {
+                        this.analyzeImageComponent(file, imageStartLine, imageContent, issues);
+                        inImageComponent = false;
+                        imageContent = "";
+                    }
+                    continue;
+                }
+                // Continue collecting multi-line Image component
+                if (inImageComponent) {
+                    imageContent += "\n" + line;
+                    braceDepth += (line.match(/\{/g) || []).length - (line.match(/\}/g) || []).length;
+                    if (line.includes("/>") || line.includes("</Image>")) {
+                        this.analyzeImageComponent(file, imageStartLine, imageContent, issues);
+                        inImageComponent = false;
+                        imageContent = "";
+                    }
+                }
+            }
+        }
+        const hasErrors = issues.some((i) => i.severity === "error");
+        return {
+            name: "Next.js Image Aspect Ratio",
+            passed: !hasErrors,
+            issues,
+            duration: Date.now() - startTime,
+        };
+    }
+    analyzeImageComponent(file, lineNum, content, issues) {
+        // Check if width or height is dynamic (using variables)
+        const hasWidthProp = /width=\{/.test(content);
+        const hasHeightProp = /height=\{/.test(content);
+        // Check for style prop with width/height auto
+        const hasStyleProp = /style=\{/.test(content);
+        const hasWidthAuto = /width:\s*["']auto["']/.test(content) || /width:\s*'auto'/.test(content);
+        const hasHeightAuto = /height:\s*["']auto["']/.test(content) || /height:\s*'auto'/.test(content);
+        // Check for CSS classes that might modify dimensions
+        const hasClassWithSize = /className=.*(?:w-|h-|size-|max-w-|max-h-)/.test(content);
+        // Check for minHeight/minWidth in style (common pattern that triggers the warning)
+        const hasMinHeight = /minHeight/.test(content);
+        const hasMinWidth = /minWidth/.test(content);
+        const hasMaxHeight = /maxHeight/.test(content);
+        const hasMaxWidth = /maxWidth/.test(content);
+        // If dimensions are modified via style but no auto is set
+        if (hasStyleProp && (hasMinHeight || hasMinWidth || hasMaxHeight || hasMaxWidth)) {
+            if (!hasWidthAuto && !hasHeightAuto) {
+                issues.push({
+                    file,
+                    line: lineNum + 1,
+                    type: "missing-auto-dimension",
+                    severity: "warning",
+                    message: 'Image with modified dimensions in style but missing width: "auto" or height: "auto"',
+                    suggestion: 'Add style={{ width: "auto", height: "auto" }} to maintain aspect ratio',
+                    snippet: content.split("\n")[0].trim().substring(0, 100),
+                });
+            }
+        }
+        // If using dynamic width/height props with CSS size classes
+        if ((hasWidthProp || hasHeightProp) && hasClassWithSize && !hasWidthAuto && !hasHeightAuto) {
+            issues.push({
+                file,
+                line: lineNum + 1,
+                type: "css-dimension-conflict",
+                severity: "warning",
+                message: "Image with width/height props and CSS size classes may cause aspect ratio issues",
+                suggestion: 'Add style={{ width: "auto", height: "auto" }} or remove conflicting CSS classes',
+                snippet: content.split("\n")[0].trim().substring(0, 100),
+            });
+        }
+        // Check for LCP images missing loading="eager" or priority
+        const srcMatch = content.match(/src=["']([^"']+)["']/);
+        const hasLoadingEager = /loading=["']eager["']/.test(content);
+        const hasPriority = /priority/.test(content);
+        if (srcMatch) {
+            const src = srcMatch[1];
+            const isLikelyLCP = LCP_IMAGE_PATTERNS.some((pattern) => pattern.test(src));
+            if (isLikelyLCP && !hasLoadingEager && !hasPriority) {
+                issues.push({
+                    file,
+                    line: lineNum + 1,
+                    type: "missing-lcp-optimization",
+                    severity: "warning",
+                    message: `Image "${src}" appears to be above-the-fold but missing loading="eager" or priority`,
+                    suggestion: 'Add loading="eager" for LCP images to improve page load performance',
+                    snippet: content.split("\n")[0].trim().substring(0, 100),
+                });
+            }
+        }
+        // Check for CSS variable heights without auto width (common issue)
+        const hasCssVarHeight = /height:\s*["']var\(--/.test(content);
+        if (hasCssVarHeight && !hasWidthAuto && !hasHeightAuto) {
+            issues.push({
+                file,
+                line: lineNum + 1,
+                type: "css-var-dimension",
+                severity: "warning",
+                message: 'Image using CSS variable for height without width: "auto" or height: "auto"',
+                suggestion: 'Add height: "auto" to style to maintain aspect ratio when using CSS variable dimensions',
+                snippet: content.split("\n")[0].trim().substring(0, 100),
+            });
+        }
+    }
+    async runAll() {
+        console.log(`\n${console_chars_1.emoji.file} NEXT.JS IMAGE VALIDATION PREFLIGHT`);
+        console.log((0, console_chars_1.createDivider)(80, "heavy"));
+        const result = await this.checkImageAspectRatio();
+        console.log(`\n${console_chars_1.emoji.chart} RESULTS`);
+        console.log((0, console_chars_1.createDivider)(80, "light"));
+        if (result.issues.length === 0) {
+            console.log(`${console_chars_1.emoji.success} No issues found`);
+        }
+        else {
+            result.issues.forEach((issue) => {
+                const icon = issue.severity === "error" ? `${console_chars_1.emoji.error}` : `${console_chars_1.emoji.warning}`;
+                console.log(`\n${icon} ${issue.file}:${issue.line}`);
+                console.log(`   ${issue.message}`);
+                console.log(`   ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+                if (issue.snippet) {
+                    console.log(`   ${console_chars_1.emoji.memo} ${issue.snippet}`);
+                }
+            });
+        }
+        console.log((0, console_chars_1.createDivider)(80, "heavy"));
+        console.log(`Duration: ${(result.duration / 1000).toFixed(2)}s`);
+        const hasErrors = result.issues.some((i) => i.severity === "error");
+        if (hasErrors) {
+            console.log(`\n${console_chars_1.emoji.error} FAILED - Fix errors before committing`);
+        }
+        else if (result.issues.length > 0) {
+            console.log(`\n${console_chars_1.emoji.warning} PASSED with warnings`);
+        }
+        else {
+            console.log(`\n${console_chars_1.emoji.success} PASSED`);
+        }
+        return {
+            passed: !hasErrors,
+            issues: result.issues,
+            duration: result.duration,
+        };
+    }
+}
+exports.NextJSImageValidator = NextJSImageValidator;
+async function main() {
+    const validator = new NextJSImageValidator({ verbose: process.argv.includes("--verbose") });
+    const result = await validator.runAll();
+    process.exit(result.passed ? 0 : 1);
+}
+if (require.main === module) {
+    main();
+}
+//# sourceMappingURL=nextjs-image-validation.js.map

package/dist/checks/nextjs/nextjs-image-validation.js.map

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

package/dist/checks/nextjs/nextjs16-compatibility.d.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env tsx
+/**
+ * Next.js 16+ Compatibility Preflight (BLOCKING)
+ *
+ * Ensures codebase is ready for Next.js 16 and future versions.
+ * Detects deprecated patterns and enforces new APIs.
+ *
+ * Key Next.js 16 Changes:
+ * 1. Turbopack is default (no --turbopack flag needed)
+ * 2. Async Request APIs are REQUIRED (no sync fallback)
+ * 3. middleware.ts renamed to proxy.ts (edge runtime deprecated)
+ * 4. React 19.2 with React Compiler support
+ * 5. cacheLife/cacheTag stable (no unstable_ prefix)
+ * 6. PPR via cacheComponents (not experimental_ppr)
+ * 7. next/legacy/image deprecated
+ * 8. images.domains deprecated (use remotePatterns)
+ * 9. Parallel routes require default.js
+ * 10. ESLint flat config default
+ * 11. SSR/Client boundary validation (Turbopack module instantiation)
+ * 12. Date.now()/new Date() in Client Components require Suspense boundary
+ * 13. generateStaticParams must be async
+ * 14. next/router removed (use next/navigation)
+ * 15. next/font optimization changes
+ * 16. instrumentation.ts for monitoring setup
+ *
+ * Usage:
+ *   pnpm preflight:nextjs16           # All checks
+ *   pnpm preflight:nextjs16:verbose   # Detailed output
+ *   pnpm preflight:nextjs16:warn      # Warning mode (non-blocking)
+ *   pnpm preflight:nextjs16:json      # JSON output for CI
+ *   pnpm preflight:nextjs16:fix       # Auto-fix simple issues
+ */
+export declare const id = "nextjs/nextjs16-compatibility";
+export declare const name = "Nextjs16 Compatibility";
+export declare const category = "nextjs";
+export declare const blocking = true;
+export declare const description = "Next.js 16+ Compatibility Preflight (BLOCKING)";
+export declare const tags: string[];
+//# sourceMappingURL=nextjs16-compatibility.d.ts.map

package/dist/checks/nextjs/nextjs16-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs16-compatibility.d.ts","sourceRoot":"","sources":["../../../src/checks/nextjs/nextjs16-compatibility.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAYH,eAAO,MAAM,EAAE,kCAAkC,CAAC;AAClD,eAAO,MAAM,IAAI,2BAA2B,CAAC;AAC7C,eAAO,MAAM,QAAQ,WAAW,CAAC;AACjC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,mDAAmD,CAAC;AAC5E,eAAO,MAAM,IAAI,UAAa,CAAC"}