@empline/preflight 1.1.50 → 1.1.52

package/dist/checks/react/session-provider-usage.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { PreflightCheckResult } from "../../core/types";
+export declare const id = "react/session-provider-usage";
+export declare const name = "Session Provider Usage";
+export declare const description = "Detects useSession usage without proper SessionProvider context";
+export declare const category = "react";
+export declare const blocking = true;
+export declare const tags: string[];
+export declare const requires: string[];
+export declare function run(): Promise<PreflightCheckResult>;
+//# sourceMappingURL=session-provider-usage.d.ts.map

package/dist/checks/react/session-provider-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-provider-usage.d.ts","sourceRoot":"","sources":["../../../src/checks/react/session-provider-usage.ts"],"names":[],"mappings":";AAwBA,OAAO,EAAE,oBAAoB,EAAoB,MAAM,kBAAkB,CAAC;AAI1E,eAAO,MAAM,EAAE,iCAAiC,CAAC;AACjD,eAAO,MAAM,IAAI,2BAA2B,CAAC;AAC7C,eAAO,MAAM,WAAW,oEAAoE,CAAC;AAC7F,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,IAAI,UAAoD,CAAC;AACtE,eAAO,MAAM,QAAQ,UAAgB,CAAC;AAmEtC,wBAAsB,GAAG,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAkFzD"}

package/dist/checks/react/session-provider-usage.js

@@ -0,0 +1,263 @@
+#!/usr/bin/env node
+"use strict";
+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.requires = exports.tags = exports.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+exports.run = run;
+/**
+ * Session Provider Usage Preflight
+ *
+ * Detects common issues with next-auth useSession hook usage that cause:
+ * "useSession must be wrapped in a <SessionProvider />"
+ *
+ * Common problematic patterns:
+ *
+ * 1. Components using useSession without "use client" directive
+ *    Server components cannot use React hooks
+ *
+ * 2. Components using useSession imported directly in server components
+ *    Should use dynamic import with { ssr: false } or wrap in Suspense
+ *
+ * 3. useSession used in components rendered outside SessionProvider context
+ *    Usually happens when components are rendered in a sub-layout that
+ *    doesn't inherit from the root layout's Providers
+ *
+ * BLOCKING: Yes - This causes runtime errors
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const glob_1 = require("glob");
+const console_chars_1 = require("../../utils/console-chars");
+// METADATA
+exports.id = "react/session-provider-usage";
+exports.name = "Session Provider Usage";
+exports.description = "Detects useSession usage without proper SessionProvider context";
+exports.category = "react";
+exports.blocking = true;
+exports.tags = ["react", "next-auth", "session", "hooks", "ssr"];
+exports.requires = ["next-auth"];
+const FILE_PATTERNS = ["components/**/*.tsx", "app/**/*.tsx", "src/**/*.tsx", "pages/**/*.tsx"];
+const EXCLUDE_PATTERNS = [
+    "**/node_modules/**",
+    "**/*.test.tsx",
+    "**/*.spec.tsx",
+    "**/*.stories.tsx",
+    "**/.storybook/**",
+    "**/providers.tsx",
+];
+function hasUseClientDirective(content) {
+    const firstNonCommentLine = content
+        .split("\n")
+        .find(line => {
+        const trimmed = line.trim();
+        return trimmed && !trimmed.startsWith("//") && !trimmed.startsWith("/*") && !trimmed.startsWith("*");
+    });
+    return firstNonCommentLine?.includes('"use client"') ||
+        firstNonCommentLine?.includes("'use client'") ||
+        content.trimStart().startsWith('"use client"') ||
+        content.trimStart().startsWith("'use client'");
+}
+function usesSessionHook(content) {
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].includes("useSession") && !lines[i].includes("import")) {
+            return { uses: true, line: i + 1 };
+        }
+    }
+    return { uses: false, line: 0 };
+}
+function importsSessionComponent(content, sessionComponents) {
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.includes("import") && line.includes("from")) {
+            for (const component of sessionComponents) {
+                if (line.includes(component) && !line.includes("dynamic(")) {
+                    return { imports: true, component, line: i + 1 };
+                }
+            }
+        }
+    }
+    return { imports: false, component: "", line: 0 };
+}
+function isDynamicImportWithSsrFalse(content, componentName) {
+    const dynamicPattern = new RegExp(`dynamic\\s*\\([^)]*${componentName}[^)]*\\{[^}]*ssr\\s*:\\s*false`, "s");
+    return dynamicPattern.test(content);
+}
+async function run() {
+    const startTime = Date.now();
+    const findings = [];
+    // Find all component files
+    const allFiles = [];
+    for (const pattern of FILE_PATTERNS) {
+        const matches = await (0, glob_1.glob)(pattern, { cwd: process.cwd(), ignore: EXCLUDE_PATTERNS });
+        allFiles.push(...matches);
+    }
+    const uniqueFiles = [...new Set(allFiles)];
+    // First pass: Find all components that use useSession
+    const sessionComponents = new Map();
+    for (const relativePath of uniqueFiles) {
+        const filePath = path.join(process.cwd(), relativePath);
+        if (!fs.existsSync(filePath))
+            continue;
+        const content = fs.readFileSync(filePath, "utf-8");
+        const { uses, line } = usesSessionHook(content);
+        if (uses) {
+            const fileName = path.basename(relativePath, ".tsx");
+            sessionComponents.set(fileName, relativePath);
+            // Check if it has "use client" directive
+            if (!hasUseClientDirective(content)) {
+                findings.push({
+                    level: "error",
+                    message: `Component uses useSession but missing "use client" directive`,
+                    file: relativePath,
+                    startLine: line,
+                    ruleId: "missing-use-client",
+                    suggestion: `Add "use client" at the top of the file`,
+                });
+            }
+        }
+    }
+    // Second pass: Check for server components importing session-using components
+    for (const relativePath of uniqueFiles) {
+        const filePath = path.join(process.cwd(), relativePath);
+        if (!fs.existsSync(filePath))
+            continue;
+        const content = fs.readFileSync(filePath, "utf-8");
+        // Skip client components - they're safe
+        if (hasUseClientDirective(content))
+            continue;
+        // Skip files that are the session components themselves
+        const fileName = path.basename(relativePath, ".tsx");
+        if (sessionComponents.has(fileName))
+            continue;
+        // Check if this server component imports any session-using component
+        const componentNames = new Set(sessionComponents.keys());
+        const { imports, component, line } = importsSessionComponent(content, componentNames);
+        if (imports) {
+            // Check if it's a safe dynamic import
+            if (!isDynamicImportWithSsrFalse(content, component)) {
+                findings.push({
+                    level: "error",
+                    message: `Server component imports ${component} (uses useSession) without dynamic({ ssr: false })`,
+                    file: relativePath,
+                    startLine: line,
+                    ruleId: "server-component-import",
+                    suggestion: `Use dynamic import: const ${component} = dynamic(() => import("..."), { ssr: false })`,
+                });
+            }
+        }
+    }
+    return {
+        passed: findings.filter(f => f.level === "error").length === 0,
+        findings,
+        duration: Date.now() - startTime,
+        metadata: {
+            sessionComponents: Array.from(sessionComponents.entries()).map(([name, file]) => ({ name, file })),
+        },
+    };
+}
+async function main() {
+    console.log(`\n${console_chars_1.emoji.ruler} SESSION PROVIDER USAGE CHECK`);
+    console.log((0, console_chars_1.createDivider)(65, "heavy"));
+    const result = await run();
+    const sessionComponents = (result.metadata?.sessionComponents || []);
+    console.log(`\n${console_chars_1.emoji.info} Found ${sessionComponents.length} components using useSession:`);
+    for (const comp of sessionComponents) {
+        console.log(`   - ${comp.name} (${comp.file})`);
+    }
+    if (result.passed) {
+        console.log(`\n${console_chars_1.emoji.success} SESSION PROVIDER USAGE CHECK PASSED`);
+        console.log(`\nAll useSession usages are properly configured.`);
+        // Advisory: Check if SessionProvider is in root layout
+        const layoutPath = path.join(process.cwd(), "app/layout.tsx");
+        const providersPath = path.join(process.cwd(), "app/providers.tsx");
+        if (fs.existsSync(layoutPath) && fs.existsSync(providersPath)) {
+            const layoutContent = fs.readFileSync(layoutPath, "utf-8");
+            const providersContent = fs.readFileSync(providersPath, "utf-8");
+            const hasProvidersInLayout = layoutContent.includes("<Providers") || layoutContent.includes("Providers>");
+            const hasSessionProvider = providersContent.includes("SessionProvider");
+            if (!hasProvidersInLayout || !hasSessionProvider) {
+                console.log(`\n${console_chars_1.emoji.warning} Advisory: SessionProvider setup may be incomplete`);
+                if (!hasSessionProvider) {
+                    console.log(`   - app/providers.tsx should include SessionProvider`);
+                }
+                if (!hasProvidersInLayout) {
+                    console.log(`   - app/layout.tsx should wrap children with <Providers>`);
+                }
+            }
+        }
+        console.log(`\n${console_chars_1.emoji.info} If you still see "useSession must be wrapped in SessionProvider":`);
+        console.log(`   1. Ensure components using useSession are rendered INSIDE Providers`);
+        console.log(`   2. Check for sub-layouts that might bypass root layout's Providers`);
+        console.log(`   3. For Turbopack/dev mode: Try hard refresh (Ctrl+Shift+R)`);
+        console.log(`   4. Check if the component is rendered before hydration completes`);
+        process.exit(0);
+    }
+    // Group issues by type
+    const missingDirective = result.findings?.filter(f => f.ruleId === "missing-use-client") || [];
+    const serverImports = result.findings?.filter(f => f.ruleId === "server-component-import") || [];
+    if (missingDirective.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} Missing "use client" directive (${missingDirective.length}):`);
+        console.log((0, console_chars_1.createDivider)(65, "light"));
+        for (const issue of missingDirective) {
+            console.log(`   ${issue.file}:${issue.startLine}`);
+            console.log(`   ${issue.message}`);
+        }
+        console.log(`\n   Fix: Add "use client" at the top of the file`);
+    }
+    if (serverImports.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} Server components importing session hooks (${serverImports.length}):`);
+        console.log((0, console_chars_1.createDivider)(65, "light"));
+        for (const issue of serverImports) {
+            console.log(`   ${issue.file}:${issue.startLine}`);
+            console.log(`   ${issue.message}`);
+        }
+        console.log(`\n   Fix: Use dynamic import with ssr: false:`);
+        console.log(`   const UserMenu = dynamic(() => import("@/components/UserMenu"), { ssr: false })`);
+    }
+    console.log(`\n${console_chars_1.emoji.info} Why this matters:`);
+    console.log(`   useSession requires SessionProvider context which is only available client-side.`);
+    console.log(`   Server components that directly import session-using components will error.`);
+    console.log(`\n${console_chars_1.emoji.error} SESSION PROVIDER USAGE CHECK FAILED`);
+    process.exit(1);
+}
+if (require.main === module) {
+    main().catch((err) => {
+        console.error(`${console_chars_1.emoji.error} Preflight failed:`, err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=session-provider-usage.js.map

package/dist/checks/react/session-provider-usage.js.map

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

package/dist/checks/react/state-update-during-render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-update-during-render.d.ts","sourceRoot":"","sources":["../../../src/checks/react/state-update-during-render.ts"],"names":[],"mappings":";AAeA,OAAO,EAAE,oBAAoB,EAAoB,MAAM,kBAAkB,CAAC;AAI1E,eAAO,MAAM,EAAE,qCAAqC,CAAC;AACrD,eAAO,MAAM,IAAI,yCAAyC,CAAC;AAC3D,eAAO,MAAM,WAAW,4DAA4D,CAAC;AACrF,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,IAAI,UAAuD,CAAC;AACzE,eAAO,MAAM,QAAQ,UAAY,CAAC;AA2ClC,wBAAsB,GAAG,IAAI,OAAO,CAAC,oBAAoB,CAAC,CA+CzD"}
+{"version":3,"file":"state-update-during-render.d.ts","sourceRoot":"","sources":["../../../src/checks/react/state-update-during-render.ts"],"names":[],"mappings":";AAeA,OAAO,EAAE,oBAAoB,EAAoB,MAAM,kBAAkB,CAAC;AAI1E,eAAO,MAAM,EAAE,qCAAqC,CAAC;AACrD,eAAO,MAAM,IAAI,yCAAyC,CAAC;AAC3D,eAAO,MAAM,WAAW,4DAA4D,CAAC;AACrF,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,IAAI,UAAuD,CAAC;AACzE,eAAO,MAAM,QAAQ,UAAY,CAAC;AA4ClC,wBAAsB,GAAG,IAAI,OAAO,CAAC,oBAAoB,CAAC,CA+CzD"}

package/dist/checks/react/state-update-during-render.js

@@ -72,6 +72,7 @@ const SAFE_CONTEXTS = [
     /\.catch\s*\(/,
     /async\s+function/,
     /const\s+\w+\s*=\s*async/,
+    /=>\s*\{[\s\S]*?await\b/, // Async arrow functions with await
 ];
 const SET_STATE_PATTERN = /\b(set[A-Z]\w+)\s*\(/g;
 function isInSafeContext(content, position) {

package/dist/checks/react/state-update-during-render.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-update-during-render.js","sourceRoot":"","sources":["../../../src/checks/react/state-update-during-render.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"state-update-during-render.js","sourceRoot":"","sources":["../../../src/checks/react/state-update-during-render.ts"],"names":[],"mappings":"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"}

package/dist/checks/react/turbopack-safe-expressions.d.ts

@@ -0,0 +1,49 @@
+#!/usr/bin/env tsx
+/**
+ * Preflight: Turbopack Safe Expressions
+ *
+ * Detects JavaScript expression patterns in JSX that can cause runtime errors
+ * when compiled by Turbopack (Next.js 13+). These patterns often result in
+ * cryptic "_ref is not defined" or similar errors.
+ *
+ * Known problematic patterns:
+ * 1. Nested optional chaining in template literals: ${a?.b?.c}
+ * 2. Optional chaining + nullish coalescing in JSX: ${a?.b ?? c}
+ * 3. Complex computed property access: obj[a?.b]
+ * 4. Optional chaining in function calls within JSX: ${fn(a?.b)}
+ *
+ * These patterns compile to temporary _ref variables that can become
+ * undefined in edge cases, causing runtime ReferenceErrors.
+ *
+ * BLOCKING: These cause runtime crashes that are hard to debug
+ */
+export declare const id = "react/turbopack-safe-expressions";
+export declare const name = "Turbopack Safe Expressions";
+export declare const category = "react";
+export declare const blocking = true;
+export declare const description = "Detects JSX expression patterns that cause Turbopack runtime errors";
+export declare const tags: string[];
+export declare function run(): Promise<{
+    passed: boolean;
+    findings: any[];
+    duration: number;
+    metadata?: undefined;
+} | {
+    passed: boolean;
+    findings: {
+        message: string;
+        level: "error" | "warning";
+        file: string;
+        line: number;
+        code: string;
+        suggestion: string;
+    }[];
+    duration: number;
+    metadata: {
+        filesScanned: number;
+        errors: number;
+        warnings: number;
+        byRule: Record<string, number>;
+    };
+}>;
+//# sourceMappingURL=turbopack-safe-expressions.d.ts.map

package/dist/checks/react/turbopack-safe-expressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turbopack-safe-expressions.d.ts","sourceRoot":"","sources":["../../../src/checks/react/turbopack-safe-expressions.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG;AAQH,eAAO,MAAM,EAAE,qCAAqC,CAAC;AACrD,eAAO,MAAM,IAAI,+BAA+B,CAAC;AACjD,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,wEAAwE,CAAC;AACjG,eAAO,MAAM,IAAI,UAAqE,CAAC;AAkUvF,wBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;GA+IxB"}

package/dist/checks/react/turbopack-safe-expressions.js

@@ -0,0 +1,450 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Preflight: Turbopack Safe Expressions
+ *
+ * Detects JavaScript expression patterns in JSX that can cause runtime errors
+ * when compiled by Turbopack (Next.js 13+). These patterns often result in
+ * cryptic "_ref is not defined" or similar errors.
+ *
+ * Known problematic patterns:
+ * 1. Nested optional chaining in template literals: ${a?.b?.c}
+ * 2. Optional chaining + nullish coalescing in JSX: ${a?.b ?? c}
+ * 3. Complex computed property access: obj[a?.b]
+ * 4. Optional chaining in function calls within JSX: ${fn(a?.b)}
+ *
+ * These patterns compile to temporary _ref variables that can become
+ * undefined in edge cases, causing runtime ReferenceErrors.
+ *
+ * BLOCKING: These cause runtime crashes that are hard to debug
+ */
+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 glob_1 = require("glob");
+const console_chars_1 = require("../../utils/console-chars");
+// Check metadata
+exports.id = "react/turbopack-safe-expressions";
+exports.name = "Turbopack Safe Expressions";
+exports.category = "react";
+exports.blocking = true;
+exports.description = "Detects JSX expression patterns that cause Turbopack runtime errors";
+exports.tags = ["turbopack", "nextjs", "runtime", "optional-chaining", "bundler"];
+// =============================================================================
+// CONFIGURATION
+// =============================================================================
+const FILE_PATTERNS = [
+    "app/**/*.{tsx,jsx}",
+    "src/**/*.{tsx,jsx}",
+    "pages/**/*.{tsx,jsx}",
+    "components/**/*.{tsx,jsx}",
+];
+const EXCLUDE_PATTERNS = [
+    "node_modules/**",
+    "**/*.test.{ts,tsx}",
+    "**/*.spec.{ts,tsx}",
+    "**/*.stories.{tsx}",
+    "**/*.d.ts",
+    ".next/**",
+    "dist/**",
+];
+// =============================================================================
+// DETECTION PATTERNS
+// =============================================================================
+/**
+ * Detect nested optional chaining in template literals within JSX
+ * Pattern: ${a?.b?.c} or ${a?.b?.c?.d}
+ */
+function detectNestedOptionalChaining(content, filePath) {
+    const findings = [];
+    const lines = content.split("\n");
+    // Track if we're in JSX context
+    let inJSX = false;
+    let jsxDepth = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Simple JSX detection (not perfect but catches most cases)
+        const jsxOpens = (line.match(/<[A-Z][a-zA-Z]*|<[a-z]+\s/g) || []).length;
+        const jsxCloses = (line.match(/\/>/g) || []).length + (line.match(/<\/[a-zA-Z]+>/g) || []).length;
+        jsxDepth += jsxOpens - jsxCloses;
+        inJSX = jsxDepth > 0 || jsxOpens > 0;
+        // Look for template literals with nested optional chaining
+        // Pattern: `...${something?.nested?.property}...`
+        const templateMatches = line.matchAll(/\$\{([^}]+)\}/g);
+        for (const match of templateMatches) {
+            const expression = match[1];
+            const columnIndex = match.index || 0;
+            // Count optional chaining operators
+            const optionalChainCount = (expression.match(/\?\./g) || []).length;
+            if (optionalChainCount >= 2) {
+                // Nested optional chaining detected
+                findings.push({
+                    file: filePath,
+                    line: i + 1,
+                    column: columnIndex,
+                    rule: "turbopack-nested-optional",
+                    severity: "error",
+                    message: `Nested optional chaining in template literal can cause "_ref is not defined" runtime error`,
+                    code: expression.trim(),
+                    suggestion: `Extract to variable: const value = ${expression.trim()}; then use \${value}`,
+                });
+            }
+            // Check for optional chaining + nullish coalescing
+            if (expression.includes("?.") && expression.includes("??")) {
+                findings.push({
+                    file: filePath,
+                    line: i + 1,
+                    column: columnIndex,
+                    rule: "turbopack-optional-nullish",
+                    severity: "error",
+                    message: `Optional chaining with nullish coalescing in template literal can cause Turbopack runtime errors`,
+                    code: expression.trim(),
+                    suggestion: `Extract to variable: const value = ${expression.trim()}; then use \${value}`,
+                });
+            }
+        }
+    }
+    return findings;
+}
+/**
+ * Detect optional chaining in JSX attribute values (non-template)
+ * Pattern: prop={a?.b?.c ?? d}
+ */
+function detectOptionalChainingInJSXProps(content, filePath) {
+    const findings = [];
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Match JSX prop assignments with complex expressions
+        // Pattern: propName={expression}
+        const propMatches = line.matchAll(/(\w+)=\{([^}]+)\}/g);
+        for (const match of propMatches) {
+            const propName = match[1];
+            const expression = match[2];
+            const columnIndex = match.index || 0;
+            // Skip simple expressions
+            if (!expression.includes("?."))
+                continue;
+            // Check for nested optional chaining with nullish coalescing
+            const hasNestedOptional = (expression.match(/\?\./g) || []).length >= 2;
+            const hasNullishCoalescing = expression.includes("??");
+            if (hasNestedOptional && hasNullishCoalescing) {
+                findings.push({
+                    file: filePath,
+                    line: i + 1,
+                    column: columnIndex,
+                    rule: "turbopack-complex-prop",
+                    severity: "error",
+                    message: `Complex expression in JSX prop "${propName}" can cause Turbopack runtime errors`,
+                    code: expression.trim(),
+                    suggestion: `Extract to variable above JSX: const ${propName}Value = ${expression.trim()};`,
+                });
+            }
+            // Check for optional chaining in computed property access
+            if (/\[[^\]]*\?\.[^\]]*\]/.test(expression)) {
+                findings.push({
+                    file: filePath,
+                    line: i + 1,
+                    column: columnIndex,
+                    rule: "turbopack-computed-optional",
+                    severity: "error",
+                    message: `Optional chaining in computed property access can cause runtime errors`,
+                    code: expression.trim(),
+                    suggestion: `Extract the optional chain: const key = a?.b; then use obj[key]`,
+                });
+            }
+        }
+    }
+    return findings;
+}
+/**
+ * Detect optional chaining in callback arguments within JSX
+ * Pattern: onClick={() => fn(a?.b?.c)}
+ */
+function detectOptionalChainingInCallbacks(content, filePath) {
+    const findings = [];
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Match arrow functions in JSX with function calls containing optional chaining
+        // Pattern: () => fn(a?.b?.c) or (e) => fn(e, a?.b?.c)
+        const callbackMatches = line.matchAll(/=>\s*\w+\(([^)]+)\)/g);
+        for (const match of callbackMatches) {
+            const args = match[1];
+            const columnIndex = match.index || 0;
+            // Check for nested optional chaining in function arguments
+            const optionalChainCount = (args.match(/\?\./g) || []).length;
+            if (optionalChainCount >= 2) {
+                findings.push({
+                    file: filePath,
+                    line: i + 1,
+                    column: columnIndex,
+                    rule: "turbopack-callback-optional",
+                    severity: "warning",
+                    message: `Nested optional chaining in callback argument may cause issues`,
+                    code: args.trim(),
+                    suggestion: `Extract to variable inside callback: const value = ${args.split(",")[0].trim()}; fn(value)`,
+                });
+            }
+        }
+    }
+    return findings;
+}
+/**
+ * Detect spread with optional chaining in JSX
+ * Pattern: {...obj?.nested?.props}
+ */
+function detectOptionalSpread(content, filePath) {
+    const findings = [];
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Match spread with optional chaining
+        const spreadMatches = line.matchAll(/\{\s*\.\.\.([^}]+\?\.[^}]+)\}/g);
+        for (const match of spreadMatches) {
+            const expression = match[1];
+            const columnIndex = match.index || 0;
+            if ((expression.match(/\?\./g) || []).length >= 1) {
+                findings.push({
+                    file: filePath,
+                    line: i + 1,
+                    column: columnIndex,
+                    rule: "turbopack-optional-spread",
+                    severity: "error",
+                    message: `Spread with optional chaining can cause runtime errors when undefined`,
+                    code: `{...${expression.trim()}}`,
+                    suggestion: `Use conditional: {...(obj?.nested?.props ?? {})} or extract: const props = obj?.nested?.props ?? {}; {...props}`,
+                });
+            }
+        }
+    }
+    return findings;
+}
+/**
+ * Detect chained method calls with optional chaining
+ * Pattern: ${arr?.filter(...)?.map(...)}
+ */
+function detectChainedMethodsWithOptional(content, filePath) {
+    const findings = [];
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Match template literals containing chained optional method calls
+        const templateMatches = line.matchAll(/\$\{([^}]*\?\.\w+\([^)]*\)\?\.[^}]+)\}/g);
+        for (const match of templateMatches) {
+            const expression = match[1];
+            const columnIndex = match.index || 0;
+            findings.push({
+                file: filePath,
+                line: i + 1,
+                column: columnIndex,
+                rule: "turbopack-chained-methods",
+                severity: "error",
+                message: `Chained optional method calls in template literal can cause Turbopack runtime errors`,
+                code: expression.trim(),
+                suggestion: `Extract chain: const result = ${expression.trim()}; then use \${result}`,
+            });
+        }
+    }
+    return findings;
+}
+/**
+ * Detect ternary with optional chaining in JSX
+ * Pattern: {a?.b ? x : y} where a?.b?.c is used
+ */
+function detectTernaryWithNestedOptional(content, filePath) {
+    const findings = [];
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Match ternary expressions with nested optional chaining
+        const ternaryMatches = line.matchAll(/\{([^}]*\?\.[^}]*\?\.[^}]*\?[^:}]+:[^}]+)\}/g);
+        for (const match of ternaryMatches) {
+            const expression = match[1];
+            const columnIndex = match.index || 0;
+            // Only flag if there's nested optional chaining before the ternary
+            const beforeTernary = expression.split("?")[0] + "?." + (expression.split("?.")[1]?.split("?")[0] || "");
+            if ((beforeTernary.match(/\?\./g) || []).length >= 2) {
+                findings.push({
+                    file: filePath,
+                    line: i + 1,
+                    column: columnIndex,
+                    rule: "turbopack-ternary-optional",
+                    severity: "warning",
+                    message: `Ternary with nested optional chaining may cause Turbopack issues`,
+                    code: expression.trim().substring(0, 60) + (expression.length > 60 ? "..." : ""),
+                    suggestion: `Extract condition: const hasValue = Boolean(a?.b?.c); then {hasValue ? x : y}`,
+                });
+            }
+        }
+    }
+    return findings;
+}
+// =============================================================================
+// MAIN
+// =============================================================================
+function createDivider(length) {
+    return "═".repeat(length);
+}
+async function run() {
+    const startTime = Date.now();
+    const allFindings = [];
+    console.log(`\n${console_chars_1.emoji.lightning} TURBOPACK SAFE EXPRESSIONS CHECK`);
+    console.log(createDivider(65));
+    console.log(`\n${console_chars_1.emoji.info} Detects patterns that cause "_ref is not defined" runtime errors`);
+    // Find all files
+    const allFiles = [];
+    for (const pattern of FILE_PATTERNS) {
+        const matches = await (0, glob_1.glob)(pattern, {
+            cwd: process.cwd(),
+            ignore: EXCLUDE_PATTERNS,
+        });
+        allFiles.push(...matches);
+    }
+    const uniqueFiles = [...new Set(allFiles)];
+    if (uniqueFiles.length === 0) {
+        console.log(`${console_chars_1.emoji.skip} No React/JSX files found`);
+        return {
+            passed: true,
+            findings: [],
+            duration: Date.now() - startTime,
+        };
+    }
+    console.log(`\n${console_chars_1.emoji.search} Scanning ${uniqueFiles.length} files for unsafe patterns...`);
+    // Analyze each file
+    for (const relativePath of uniqueFiles) {
+        const filePath = path.join(process.cwd(), relativePath);
+        if (!fs.existsSync(filePath))
+            continue;
+        const content = fs.readFileSync(filePath, "utf-8");
+        // Skip files with ignore comment
+        if (content.includes("turbopack-safe-ignore") || content.includes("preflight-ignore-turbopack")) {
+            continue;
+        }
+        allFindings.push(...detectNestedOptionalChaining(content, relativePath));
+        allFindings.push(...detectOptionalChainingInJSXProps(content, relativePath));
+        allFindings.push(...detectOptionalChainingInCallbacks(content, relativePath));
+        allFindings.push(...detectOptionalSpread(content, relativePath));
+        allFindings.push(...detectChainedMethodsWithOptional(content, relativePath));
+        allFindings.push(...detectTernaryWithNestedOptional(content, relativePath));
+    }
+    // Group by severity
+    const errors = allFindings.filter((f) => f.severity === "error");
+    const warnings = allFindings.filter((f) => f.severity === "warning");
+    // Group by rule
+    const byRule = allFindings.reduce((acc, f) => {
+        acc[f.rule] = (acc[f.rule] || 0) + 1;
+        return acc;
+    }, {});
+    // Summary
+    console.log(`\n${console_chars_1.emoji.chart} Summary:`);
+    console.log(`   Files scanned: ${uniqueFiles.length}`);
+    console.log(`   Errors: ${errors.length} (blocking)`);
+    console.log(`   Warnings: ${warnings.length}`);
+    if (Object.keys(byRule).length > 0) {
+        console.log(`\n   By rule:`);
+        for (const [rule, count] of Object.entries(byRule)) {
+            console.log(`     ${rule}: ${count}`);
+        }
+    }
+    if (allFindings.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} TURBOPACK SAFE EXPRESSIONS CHECK PASSED`);
+        console.log(`\nNo unsafe expression patterns detected.`);
+    }
+    else {
+        // Show errors first
+        if (errors.length > 0) {
+            console.log(`\n${console_chars_1.emoji.error} BLOCKING: Unsafe Patterns Detected`);
+            console.log(`\nThese patterns WILL cause runtime errors with Turbopack:\n`);
+            for (const f of errors.slice(0, 15)) {
+                console.log(`   ${console_chars_1.emoji.error} ${f.file}:${f.line}:${f.column}`);
+                console.log(`      Rule: ${f.rule}`);
+                console.log(`      Code: ${f.code}`);
+                console.log(`      Fix: ${f.suggestion}`);
+                console.log();
+            }
+            if (errors.length > 15) {
+                console.log(`   ... and ${errors.length - 15} more errors\n`);
+            }
+        }
+        // Show warnings
+        if (warnings.length > 0) {
+            console.log(`${console_chars_1.emoji.warning} Warnings (${warnings.length}):`);
+            for (const f of warnings.slice(0, 5)) {
+                console.log(`   ${f.file}:${f.line} [${f.rule}]`);
+                console.log(`      ${f.message}`);
+            }
+            if (warnings.length > 5) {
+                console.log(`   ... and ${warnings.length - 5} more warnings`);
+            }
+        }
+        console.log(`\n${console_chars_1.emoji.hint} How to fix:`);
+        console.log(`   1. Extract complex expressions to variables BEFORE the JSX return`);
+        console.log(`   2. Use simple variable references in template literals: \${value}`);
+        console.log(`   3. Avoid nested optional chaining (?.) in JSX expressions`);
+        console.log(`\n   Example fix:`);
+        console.log(`   ${console_chars_1.emoji.error} BEFORE: alt={\`Image: \${obj?.nested?.name ?? 'default'}\`}`);
+        console.log(`   ${console_chars_1.emoji.success} AFTER:  const altText = obj?.nested?.name ?? 'default';`);
+        console.log(`           alt={\`Image: \${altText}\`}`);
+        const status = errors.length > 0 ? "FAILED" : "PASSED WITH WARNINGS";
+        console.log(`\n${errors.length > 0 ? console_chars_1.emoji.error : console_chars_1.emoji.warning} TURBOPACK SAFE EXPRESSIONS ${status}`);
+    }
+    return {
+        passed: errors.length === 0,
+        findings: allFindings.map((f) => ({
+            message: `[${f.rule}] ${f.message}`,
+            level: f.severity,
+            file: f.file,
+            line: f.line,
+            code: f.rule,
+            suggestion: f.suggestion,
+        })),
+        duration: Date.now() - startTime,
+        metadata: {
+            filesScanned: uniqueFiles.length,
+            errors: errors.length,
+            warnings: warnings.length,
+            byRule,
+        },
+    };
+}
+// Standalone execution
+if (require.main === module) {
+    run().then((result) => process.exit(result.passed ? 0 : 1));
+}
+//# sourceMappingURL=turbopack-safe-expressions.js.map

package/dist/checks/react/turbopack-safe-expressions.js.map

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

package/dist/checks/ui/floating-element-zindex.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { PreflightCheckResult } from "../../core/types";
+export declare const id = "ui/floating-element-zindex";
+export declare const name = "Floating Element Z-Index";
+export declare const description = "Detects floating badges inside ring-offset elements and missing z-index";
+export declare const category = "ui";
+export declare const blocking = true;
+export declare const tags: string[];
+export declare function run(): Promise<PreflightCheckResult>;
+//# sourceMappingURL=floating-element-zindex.d.ts.map

package/dist/checks/ui/floating-element-zindex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floating-element-zindex.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/floating-element-zindex.ts"],"names":[],"mappings":";AAiCA,OAAO,EAAE,oBAAoB,EAAoB,MAAM,kBAAkB,CAAC;AAI1E,eAAO,MAAM,EAAE,+BAA+B,CAAC;AAC/C,eAAO,MAAM,IAAI,6BAA6B,CAAC;AAC/C,eAAO,MAAM,WAAW,4EAA4E,CAAC;AACrG,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,IAAI,UAAiF,CAAC;AA+FnG,wBAAsB,GAAG,IAAI,OAAO,CAAC,oBAAoB,CAAC,CA0EzD"}

package/dist/checks/ui/floating-element-zindex.js

@@ -0,0 +1,292 @@
+#!/usr/bin/env node
+"use strict";
+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;
+/**
+ * Floating Element Z-Index Preflight
+ *
+ * Detects two problematic patterns:
+ *
+ * 1. CRITICAL: Floating badges INSIDE elements with ring-offset
+ *    The ring-offset box-shadow will overlap badges regardless of z-index.
+ *    Solution: Move badge outside the ring-offset element as a sibling.
+ *
+ *    Problem pattern:
+ *    ```tsx
+ *    <Card className="ring-2 ring-offset-2">
+ *      <Badge className="absolute -top-2" />  // WRONG - ring overlaps badge
+ *    </Card>
+ *    ```
+ *
+ *    Correct pattern:
+ *    ```tsx
+ *    <Box className="relative">
+ *      <Badge className="absolute -top-2" style={{ zIndex: "var(--z-floating-badge)" }} />
+ *      <Card className="ring-2 ring-offset-2">...</Card>
+ *    </Box>
+ *    ```
+ *
+ * 2. Floating elements missing z-index (advisory)
+ *    Elements with negative positioning should have proper z-index.
+ *
+ * BLOCKING: Yes - Critical issues (ring-offset + badge) block the build
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const glob_1 = require("glob");
+const console_chars_1 = require("../../utils/console-chars");
+// METADATA
+exports.id = "ui/floating-element-zindex";
+exports.name = "Floating Element Z-Index";
+exports.description = "Detects floating badges inside ring-offset elements and missing z-index";
+exports.category = "ui";
+exports.blocking = true;
+exports.tags = ["ui", "z-index", "layout", "badge", "positioning", "ring-offset", "tailwind"];
+const FILE_PATTERNS = ["components/**/*.tsx", "app/**/*.tsx", "src/**/*.tsx", "pages/**/*.tsx"];
+const EXCLUDE_PATTERNS = [
+    "**/node_modules/**",
+    "**/*.test.tsx",
+    "**/*.spec.tsx",
+    "**/*.stories.tsx",
+    "**/.storybook/**",
+];
+const NEGATIVE_POSITION_PATTERNS = [
+    /-top-\d/,
+    /-bottom-\d/,
+    /-left-\d/,
+    /-right-\d/,
+    /top-\[-/,
+    /bottom-\[-/,
+    /left-\[-/,
+    /right-\[-/,
+];
+const VALID_ZINDEX_PATTERNS = [
+    /z-index:\s*["']?var\(--z-floating-badge\)/,
+    /z-index:\s*["']?var\(--z-content-controls\)/,
+    /z-index:\s*["']?var\(--z-/,
+    /zIndex:\s*["']?var\(--z-floating-badge\)/,
+    /zIndex:\s*["']?var\(--z-content-controls\)/,
+    /zIndex:\s*["']?var\(--z-/,
+    /z-\d{2,}/,
+    /z-\[/,
+];
+const SKIP_PATTERNS = [
+    /blur-/,
+    /opacity-\d/,
+    /bg-white\/\d/,
+    /animate-/,
+    /rounded-full.*bg-white\//,
+    /h-\d+.*w-\d+.*rounded/,
+];
+function detectRingOffsetBadgePattern(content, relativePath) {
+    const findings = [];
+    const ringOffsetPattern = /(<(?:Card|Box|div)[^>]*className="[^"]*ring-offset[^"]*"[^>]*>)([\s\S]*?)(<\/(?:Card|Box|div)>)/g;
+    let match;
+    while ((match = ringOffsetPattern.exec(content)) !== null) {
+        const openTag = match[1];
+        const innerContent = match[2];
+        const hasFloatingChild = NEGATIVE_POSITION_PATTERNS.some(pattern => pattern.test(innerContent));
+        if (hasFloatingChild) {
+            const hasBadgePattern = /(?:Badge|Chip|StatusChip|Box|span)[^>]*(?:-top-|-bottom-|-left-|-right-)/.test(innerContent);
+            if (hasBadgePattern) {
+                const beforeMatch = content.slice(0, match.index);
+                const lineNumber = (beforeMatch.match(/\n/g) || []).length + 1;
+                findings.push({
+                    level: "error",
+                    message: `Floating badge inside ring-offset element - badge will appear BEHIND ring regardless of z-index`,
+                    file: relativePath,
+                    startLine: lineNumber,
+                    ruleId: "ring-offset-badge",
+                    suggestion: `Move badge outside the ring-offset element as a sibling: <Box className="relative"><Badge .../><Card className="ring-offset-2">...</Card></Box>`,
+                });
+            }
+        }
+    }
+    return findings;
+}
+function extractLineContext(content, match) {
+    const beforeMatch = content.slice(0, match.index);
+    const lineNumber = (beforeMatch.match(/\n/g) || []).length + 1;
+    const lines = content.split("\n");
+    const lineContent = lines[lineNumber - 1] || "";
+    return { line: lineNumber, code: lineContent.trim() };
+}
+function hasProperZIndex(lineContent, surroundingContent) {
+    const contextToCheck = lineContent + " " + surroundingContent;
+    return VALID_ZINDEX_PATTERNS.some((pattern) => pattern.test(contextToCheck));
+}
+function isDecorativeElement(lineContent) {
+    return SKIP_PATTERNS.some((pattern) => pattern.test(lineContent));
+}
+async function run() {
+    const startTime = Date.now();
+    const findings = [];
+    let floatingElementsFound = 0;
+    // Find all component files
+    const allFiles = [];
+    for (const pattern of FILE_PATTERNS) {
+        const matches = await (0, glob_1.glob)(pattern, { cwd: process.cwd(), ignore: EXCLUDE_PATTERNS });
+        allFiles.push(...matches);
+    }
+    const uniqueFiles = [...new Set(allFiles)];
+    for (const relativePath of uniqueFiles) {
+        const filePath = path.join(process.cwd(), relativePath);
+        if (!fs.existsSync(filePath))
+            continue;
+        const content = fs.readFileSync(filePath, "utf-8");
+        // CRITICAL CHECK: Detect ring-offset + floating badge pattern
+        const ringOffsetIssues = detectRingOffsetBadgePattern(content, relativePath);
+        findings.push(...ringOffsetIssues);
+        // Check for each negative position pattern (advisory)
+        for (const pattern of NEGATIVE_POSITION_PATTERNS) {
+            const matches = content.matchAll(new RegExp(pattern, "g"));
+            for (const match of matches) {
+                floatingElementsFound++;
+                const { line, code } = extractLineContext(content, match);
+                // Skip if it's a decorative element
+                if (isDecorativeElement(code))
+                    continue;
+                // Skip if has preflight-ignore comment
+                const lineStart = content.lastIndexOf('\n', match.index || 0) + 1;
+                const lineBefore = content.substring(Math.max(0, lineStart - 100), lineStart);
+                if (/preflight-ignore/.test(lineBefore))
+                    continue;
+                // Get surrounding context (3 lines before and after)
+                const lines = content.split("\n");
+                const startLine = Math.max(0, line - 4);
+                const endLine = Math.min(lines.length, line + 3);
+                const surroundingContent = lines.slice(startLine, endLine).join("\n");
+                // Check if proper z-index exists
+                if (!hasProperZIndex(code, surroundingContent)) {
+                    findings.push({
+                        level: "warning",
+                        message: `Floating element with ${match[0]} may need z-index for proper stacking`,
+                        file: relativePath,
+                        startLine: line,
+                        ruleId: "missing-zindex",
+                        suggestion: `Add z-index: style={{ zIndex: "var(--z-floating-badge)" }}`,
+                    });
+                }
+            }
+        }
+    }
+    // Only block on critical errors (ring-offset + badge), not warnings
+    const criticalCount = findings.filter(f => f.ruleId === "ring-offset-badge").length;
+    return {
+        passed: criticalCount === 0,
+        findings,
+        duration: Date.now() - startTime,
+        metadata: {
+            floatingElementsFound,
+            criticalIssues: criticalCount,
+            advisoryIssues: findings.filter(f => f.level === "warning").length,
+        },
+    };
+}
+async function main() {
+    console.log(`\n${console_chars_1.emoji.ruler} FLOATING ELEMENT Z-INDEX CHECK`);
+    console.log((0, console_chars_1.createDivider)(65, "heavy"));
+    const result = await run();
+    const { floatingElementsFound, criticalIssues, advisoryIssues } = result.metadata || {};
+    console.log(`\n${console_chars_1.emoji.chart} Summary:`);
+    console.log(`   Floating elements found: ${floatingElementsFound}`);
+    console.log(`   Critical issues (ring-offset + badge): ${criticalIssues}`);
+    console.log(`   Advisory issues (missing z-index): ${advisoryIssues}`);
+    if (result.passed && advisoryIssues === 0) {
+        console.log(`\n${console_chars_1.emoji.success} FLOATING ELEMENT Z-INDEX CHECK PASSED`);
+        console.log(`\nAll floating elements are properly structured.`);
+        process.exit(0);
+    }
+    // Display CRITICAL issues first
+    const critical = result.findings?.filter(f => f.ruleId === "ring-offset-badge") || [];
+    if (critical.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} CRITICAL: Floating badges inside ring-offset elements (${critical.length}):`);
+        console.log((0, console_chars_1.createDivider)(65, "heavy"));
+        console.log(`\n   These will ALWAYS appear behind the ring, regardless of z-index!`);
+        console.log(`   Fix: Move the badge OUTSIDE the ring-offset element as a sibling.\n`);
+        for (const issue of critical) {
+            console.log(`${console_chars_1.emoji.file} ${issue.file}:${issue.startLine}`);
+            console.log(`   ${console_chars_1.emoji.warning} ${issue.message}\n`);
+        }
+        console.log(`${console_chars_1.emoji.info} Correct pattern:`);
+        console.log(`   <Box className="relative">`);
+        console.log(`     <Badge className="absolute -top-2" style={{ zIndex: "var(--z-floating-badge)" }} />`);
+        console.log(`     <Card className="ring-offset-2">...</Card>`);
+        console.log(`   </Box>`);
+    }
+    // Display advisory issues
+    const advisory = result.findings?.filter(f => f.level === "warning") || [];
+    if (advisory.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning} Advisory: Missing z-index on floating elements (${advisory.length}):`);
+        console.log((0, console_chars_1.createDivider)(65, "light"));
+        // Group by file
+        const byFile = new Map();
+        for (const issue of advisory) {
+            const existing = byFile.get(issue.file) || [];
+            existing.push(issue);
+            byFile.set(issue.file, existing);
+        }
+        for (const [file, fileIssues] of byFile) {
+            console.log(`\n${console_chars_1.emoji.file} ${file}`);
+            for (const issue of fileIssues) {
+                console.log(`   Line ${issue.startLine}: ${issue.message}`);
+            }
+        }
+        console.log(`\n${console_chars_1.emoji.info} Recommended fix:`);
+        console.log(`   Add z-index for floating badges/elements that appear outside parent bounds:`);
+        console.log(`   style={{ zIndex: "var(--z-floating-badge)" }}`);
+    }
+    console.log(`\n   Z-index tokens available:`);
+    console.log(`   - --z-content-overlay: 10 (within component)`);
+    console.log(`   - --z-content-controls: 20 (controls above content)`);
+    console.log(`   - --z-floating-badge: 30 (badges outside parent bounds)`);
+    if (!result.passed) {
+        console.log(`\n${console_chars_1.emoji.error} FLOATING ELEMENT Z-INDEX CHECK FAILED`);
+        console.log(`   ${criticalIssues} critical issue(s) must be fixed.`);
+        process.exit(1);
+    }
+    console.log(`\n${console_chars_1.emoji.warning} FLOATING ELEMENT Z-INDEX CHECK COMPLETED WITH WARNINGS`);
+    console.log(`   Review the advisory issues - some may be intentional.`);
+    process.exit(0);
+}
+if (require.main === module) {
+    main().catch((err) => {
+        console.error(`${console_chars_1.emoji.error} Preflight failed:`, err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=floating-element-zindex.js.map

package/dist/checks/ui/floating-element-zindex.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@empline/preflight",
-  "version": "1.1.50",
+  "version": "1.1.52",
   "description": "Distributable preflight validation system with app-specific plugin support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",