@empline/preflight 1.1.0

package/dist/checks/ui/dialog-state-management.js

@@ -0,0 +1,301 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Dialog State Management Preflight
+ *
+ * Detects scattered dialog state management patterns that could
+ * be consolidated using the useConfirmDialog or useMultiDialog hooks.
+ *
+ * Anti-patterns detected:
+ * - Multiple useState calls for dialog open/close states
+ * - Repeated pattern of dialogOpen + setDialogOpen + selectedItem
+ * - Missing use of useConfirmDialog for confirmation dialogs
+ * - Missing use of useMultiDialog for multi-dialog pages
+ *
+ * Correct patterns:
+ * - Use useConfirmDialog() for single confirmation dialogs
+ * - Use useMultiDialog() for pages with multiple dialogs
+ * - Use ConfirmDialog component with useConfirmDialog hook
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const glob_1 = require("glob");
+const console_chars_1 = require("../../utils/console-chars");
+const exclusions_1 = require("../../shared/exclusions");
+let appExclusions = [];
+// METADATA
+exports.id = "ui/dialog-state-management";
+exports.name = "Dialog State Management";
+exports.description = "Detects scattered dialog state management that should use hooks";
+exports.category = "ui";
+exports.blocking = false;
+exports.tags = ["ui", "dialogs", "state-management", "hooks", "consolidation"];
+// Patterns that indicate dialog state
+const DIALOG_STATE_PATTERNS = [
+    /const\s+\[(\w*[Dd]ialog\w*Open|\w*[Mm]odal\w*Open|open\w*Dialog|show\w*Modal),\s*set\w+\]\s*=\s*useState\(\s*false\s*\)/g,
+    /const\s+\[is(\w+)Open,\s*setIs\1Open\]\s*=\s*useState\(\s*false\s*\)/g,
+    /const\s+\[(show|open)(\w+),\s*set(?:Show|Open)\2\]\s*=\s*useState\(\s*false\s*\)/g,
+];
+// Patterns that indicate proper hook usage
+const HOOK_USAGE_PATTERNS = [
+    /useConfirmDialog\s*\(/,
+    /useMultiDialog\s*\(/,
+    /useDialog\s*\(/,
+];
+// Anti-patterns to detect
+const ANTI_PATTERNS = [
+    {
+        pattern: /const\s+\[\w+DialogOpen,\s*set\w+DialogOpen\]\s*=\s*useState\(\s*false\s*\)/,
+        name: "raw-dialog-state",
+        message: "Raw useState for dialog open state",
+        suggestion: "Use useConfirmDialog() or useMultiDialog() for standardized dialog management",
+        severity: "info",
+        countBased: true,
+    },
+    {
+        pattern: /const\s+\[selectedItem,\s*setSelectedItem\]\s*=\s*useState<[^>]+>\s*\(\s*null\s*\)[\s\S]{0,100}DialogOpen/,
+        name: "dialog-with-selected-item",
+        message: "Dialog state with selected item pattern",
+        suggestion: "useConfirmDialog() manages both open state and data together",
+        severity: "warning",
+    },
+    {
+        pattern: /const\s+handleOpen\w*Dialog\s*=\s*\([^)]*\)\s*=>\s*\{[\s\S]{0,100}setSelectedItem[\s\S]{0,50}setDialogOpen\(true\)/,
+        name: "manual-dialog-open-handler",
+        message: "Manual dialog open handler setting multiple states",
+        suggestion: "useConfirmDialog().open(data) handles this in one call",
+        severity: "info",
+    },
+    {
+        pattern: /const\s+handleClose\w*Dialog\s*=\s*\(\)\s*=>\s*\{[\s\S]{0,100}setSelectedItem\(null\)[\s\S]{0,50}setDialogOpen\(false\)/,
+        name: "manual-dialog-close-handler",
+        message: "Manual dialog close handler resetting multiple states",
+        suggestion: "useConfirmDialog().close() handles cleanup automatically",
+        severity: "info",
+    },
+    {
+        pattern: /<Dialog[\s\S]{0,50}open\s*=\s*\{\s*\w+DialogOpen\s*\}[\s\S]{0,50}onClose\s*=\s*\{\s*\(\)\s*=>\s*set\w+DialogOpen\(false\)/,
+        name: "dialog-with-inline-close",
+        message: "Dialog with inline close handler",
+        suggestion: "Use dialog hook which provides consistent open/close handlers",
+        severity: "info",
+    },
+];
+// Files/patterns to ignore
+const IGNORE_PATTERNS = [
+    "**/components/ui/**", // UI primitives are expected to have raw state
+    "**/hooks/**", // Hooks themselves manage state
+    "**/*.test.tsx",
+    "**/*.stories.tsx",
+];
+async function findComponentFiles() {
+    const patterns = [
+        "app/**/*Client.tsx",
+        "app/**/components/*.tsx",
+        "components/**/*.tsx",
+    ];
+    const allFiles = [];
+    for (const pattern of patterns) {
+        const matches = await (0, glob_1.glob)(pattern, {
+            ignore: [
+                "**/node_modules/**",
+                ...IGNORE_PATTERNS,
+            ],
+        });
+        allFiles.push(...matches);
+    }
+    return [...new Set(allFiles)].filter((file) => !(0, exclusions_1.shouldExcludeFile)(file, appExclusions));
+}
+function countDialogStates(content) {
+    let count = 0;
+    for (const pattern of DIALOG_STATE_PATTERNS) {
+        const matches = content.match(pattern);
+        if (matches) {
+            count += matches.length;
+        }
+    }
+    return count;
+}
+function usesDialogHooks(content) {
+    return HOOK_USAGE_PATTERNS.some((pattern) => pattern.test(content));
+}
+function checkFile(filePath, content) {
+    const issues = [];
+    const lines = content.split("\n");
+    const dialogStateCount = countDialogStates(content);
+    const usesHooks = usesDialogHooks(content);
+    // Only report issues if file has dialog state but doesn't use hooks
+    if (dialogStateCount === 0) {
+        return { file: filePath, issues: [], dialogStateCount: 0, usesHooks };
+    }
+    // If using hooks, fewer issues to report
+    if (usesHooks && dialogStateCount <= 1) {
+        return { file: filePath, issues: [], dialogStateCount, usesHooks };
+    }
+    // Multiple dialog states without hooks is a warning
+    if (dialogStateCount >= 2 && !usesHooks) {
+        issues.push({
+            file: filePath,
+            line: 1,
+            severity: "warning",
+            message: `Multiple dialog states (${dialogStateCount}) without useMultiDialog hook`,
+            suggestion: "Use useMultiDialog() hook to manage multiple dialogs in one place",
+            code: "multiple-dialog-states",
+            dialogCount: dialogStateCount,
+        });
+    }
+    // Check other anti-patterns
+    for (const antiPattern of ANTI_PATTERNS) {
+        if (antiPattern.countBased && dialogStateCount < 2)
+            continue;
+        if (usesHooks && antiPattern.severity === "info")
+            continue;
+        const match = content.match(antiPattern.pattern);
+        if (match) {
+            let lineNumber = 1;
+            let charCount = 0;
+            for (let i = 0; i < lines.length; i++) {
+                charCount += lines[i].length + 1;
+                if (charCount > (match.index || 0)) {
+                    lineNumber = i + 1;
+                    break;
+                }
+            }
+            issues.push({
+                file: filePath,
+                line: lineNumber,
+                severity: antiPattern.severity,
+                message: antiPattern.message,
+                suggestion: antiPattern.suggestion,
+                code: antiPattern.name,
+            });
+        }
+    }
+    return { file: filePath, issues, dialogStateCount, usesHooks };
+}
+async function run() {
+    const startTime = Date.now();
+    const verbose = process.argv.includes("--verbose") || process.argv.includes("-v");
+    const preflightFindings = [];
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`${console_chars_1.emoji.search} Dialog State Management`);
+    console.log(`Checking for dialog state consolidation opportunities...\n`);
+    try {
+        appExclusions = await (0, exclusions_1.getExclusions)(exports.id);
+    }
+    catch {
+        appExclusions = [];
+    }
+    const files = await findComponentFiles();
+    console.log(`Scanning ${files.length} component files...\n`);
+    const results = [];
+    const allIssues = [];
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, "utf-8");
+            const result = checkFile(file, content);
+            results.push(result);
+            allIssues.push(...result.issues);
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    // Summary stats
+    const filesWithDialogs = results.filter((r) => r.dialogStateCount > 0);
+    const filesWithMultipleDialogs = results.filter((r) => r.dialogStateCount >= 2);
+    const filesUsingHooks = results.filter((r) => r.usesHooks);
+    const warnings = allIssues.filter((i) => i.severity === "warning");
+    const info = allIssues.filter((i) => i.severity === "info");
+    if (warnings.length > 0) {
+        console.log(`${console_chars_1.emoji.warning}  FILES WITH MULTIPLE DIALOGS (no hook usage):`);
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        for (const issue of warnings.filter((i) => i.code === "multiple-dialog-states")) {
+            console.log(`  ${issue.file}`);
+            console.log(`    ${console_chars_1.chars.bullet} ${issue.dialogCount} dialog states found`);
+            preflightFindings.push({
+                level: "warning",
+                message: issue.message,
+                file: issue.file,
+                startLine: issue.line,
+                suggestion: issue.suggestion,
+                ruleId: `dialog-state/${issue.code}`,
+            });
+            if (verbose) {
+                console.log(`    ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            }
+        }
+        console.log("");
+    }
+    if (verbose && info.length > 0) {
+        console.log(`${console_chars_1.emoji.info}  ADDITIONAL PATTERNS:`);
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        const issuesByCode = new Map();
+        for (const issue of info) {
+            if (!issuesByCode.has(issue.code)) {
+                issuesByCode.set(issue.code, []);
+            }
+            issuesByCode.get(issue.code).push(issue);
+        }
+        for (const [code, issues] of issuesByCode) {
+            console.log(`  ${console_chars_1.chars.bullet} ${code}: ${issues.length} occurrences`);
+        }
+        console.log("");
+    }
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`Files scanned: ${files.length}`);
+    console.log(`Files with dialogs: ${filesWithDialogs.length}`);
+    console.log(`Files with multiple dialogs: ${filesWithMultipleDialogs.length}`);
+    console.log(`Files using dialog hooks: ${filesUsingHooks.length}`);
+    console.log(`\nWarnings: ${warnings.length}`);
+    console.log(`Info: ${info.length}`);
+    if (warnings.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No major dialog state issues detected\n`);
+        return { passed: true, findings: [], duration: Date.now() - startTime };
+    }
+    console.log(`\n${console_chars_1.emoji.docs} Available dialog hooks:`);
+    console.log(`   ${console_chars_1.chars.bullet} useConfirmDialog() - For single confirmation dialogs with data`);
+    console.log(`   ${console_chars_1.chars.bullet} useMultiDialog() - For managing multiple dialogs`);
+    console.log(`   ${console_chars_1.chars.bullet} ConfirmDialog component - Pre-built confirmation dialog\n`);
+    return { passed: true, findings: preflightFindings, duration: Date.now() - startTime };
+}
+// CLI execution
+if (require.main === module) {
+    run().then((result) => process.exit(result.passed ? 0 : 1)).catch(() => process.exit(1));
+}
+//# sourceMappingURL=dialog-state-management.js.map

package/dist/checks/ui/dialog-state-management.js.map

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

package/dist/checks/ui/doubled-padding-check.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Doubled Padding Check Preflight
+ *
+ * Detects patterns where padding-top is applied at multiple nested levels,
+ * creating unintended doubled spacing. This commonly happens when:
+ * - A layout container has pt-3 and its child content wrapper also has pt-3
+ * - Nested flex containers both apply top padding
+ * - Parent has inline style paddingTop and child has pt-X className
+ *
+ * Standard: Use padding at ONE level only, not nested.
+ *
+ * Usage:
+ *   pnpm preflight:ui-spacing:doubled-padding
+ */
+export declare const id = "ui/doubled-padding-check";
+export declare const name = "Doubled Padding Check";
+export declare const category = "ui";
+export declare const blocking = false;
+export declare const description = "Doubled Padding Check Preflight";
+export declare const tags: string[];
+/**
+ * Detects nested pt-X patterns in JSX that create doubled padding
+ *
+ * Focuses on the specific anti-pattern:
+ *   <Box className="pt-3">
+ *     <Container className="pt-4">  // BAD - doubled padding
+ *
+ * Does NOT flag sibling sections with their own padding (e.g., gap-based layouts)
+ */
+export declare function run(): Promise<void>;
+//# sourceMappingURL=doubled-padding-check.d.ts.map

package/dist/checks/ui/doubled-padding-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doubled-padding-check.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/doubled-padding-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,eAAO,MAAM,EAAE,6BAA6B,CAAC;AAC7C,eAAO,MAAM,IAAI,0BAA0B,CAAC;AAC5C,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,oCAAoC,CAAC;AAC7D,eAAO,MAAM,IAAI,UAAS,CAAC;AAqC3B;;;;;;;;GAQG;AACH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAkKzC"}

package/dist/checks/ui/doubled-padding-check.js

@@ -0,0 +1,236 @@
+"use strict";
+/**
+ * Doubled Padding Check Preflight
+ *
+ * Detects patterns where padding-top is applied at multiple nested levels,
+ * creating unintended doubled spacing. This commonly happens when:
+ * - A layout container has pt-3 and its child content wrapper also has pt-3
+ * - Nested flex containers both apply top padding
+ * - Parent has inline style paddingTop and child has pt-X className
+ *
+ * Standard: Use padding at ONE level only, not nested.
+ *
+ * Usage:
+ *   pnpm preflight:ui-spacing:doubled-padding
+ */
+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 file_cache_1 = require("../../shared/file-cache");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "ui/doubled-padding-check";
+exports.name = "Doubled Padding Check";
+exports.category = "ui";
+exports.blocking = false;
+exports.description = "Doubled Padding Check Preflight";
+exports.tags = ["ui"];
+// Files that are allowed to have nested padding patterns
+const ALLOWED_FILES = ["tailwind.config.ts", "spacing.ts", "critical-css.ts"];
+// CACHED FILE LISTS
+let _cachedAllTsTsxFiles = null;
+async function getAllTsTsxFiles() {
+    if (!_cachedAllTsTsxFiles) {
+        const allFiles = await file_cache_1.fileCache.getAllTsTsx();
+        _cachedAllTsTsxFiles = allFiles.filter((file) => {
+            const normalizedPath = file.replace(/\\/g, "/");
+            return (!normalizedPath.startsWith("scripts/") &&
+                !normalizedPath.includes("/scripts/") &&
+                !normalizedPath.startsWith("tests/") &&
+                !normalizedPath.includes("/tests/") &&
+                !normalizedPath.startsWith("test-results/") &&
+                !normalizedPath.includes("/test-results/"));
+        });
+    }
+    return _cachedAllTsTsxFiles;
+}
+/**
+ * Detects nested pt-X patterns in JSX that create doubled padding
+ *
+ * Focuses on the specific anti-pattern:
+ *   <Box className="pt-3">
+ *     <Container className="pt-4">  // BAD - doubled padding
+ *
+ * Does NOT flag sibling sections with their own padding (e.g., gap-based layouts)
+ */
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    console.log(`\n${console_chars_1.emoji.search} Doubled Padding Check\n`);
+    console.log("Standard: Apply padding-top at ONE level only, not nested containers");
+    console.log("Rules:");
+    console.log(`  ${console_chars_1.emoji.error} Nested pt-X classes create doubled spacing`);
+    console.log(`  ${console_chars_1.emoji.error} Inline paddingTop + child pt-X creates doubled spacing`);
+    console.log(`  ${console_chars_1.emoji.warning}  Parent with pt-X should not have child with pt-X\n`);
+    const files = await getAllTsTsxFiles();
+    const issues = [];
+    for (const file of files) {
+        const fileName = path.basename(file);
+        if (ALLOWED_FILES.includes(fileName))
+            continue;
+        const content = fs.readFileSync(file, "utf8");
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNum = i + 1;
+            // Skip comments and preflight-ignore
+            if (line.includes("preflight-ignore"))
+                continue;
+            const trimmed = line.trim();
+            if (trimmed.startsWith("//") || trimmed.startsWith("/*") || trimmed.startsWith("*"))
+                continue;
+            const currentIndent = line.search(/\S/);
+            // Pattern 1: Check for pt-X pattern in className
+            const ptMatch = line.match(/className="[^"]*\b(pt-(\d+))\b[^"]*"/);
+            if (ptMatch) {
+                const ptClass = ptMatch[1];
+                const ptValue = parseInt(ptMatch[2]);
+                // Look ahead for a DIRECT child with pt-X (within 5 lines, increased indentation)
+                for (let j = i + 1; j < Math.min(i + 6, lines.length); j++) {
+                    const nextLine = lines[j];
+                    const nextTrimmed = nextLine.trim();
+                    if (!nextTrimmed || nextTrimmed.startsWith("//") || nextTrimmed.startsWith("/*"))
+                        continue;
+                    if (nextLine.includes("preflight-ignore"))
+                        break;
+                    const nextIndent = nextLine.search(/\S/);
+                    if (nextIndent <= currentIndent)
+                        break;
+                    const childPtMatch = nextLine.match(/className="[^"]*\b(pt-(\d+))\b[^"]*"/);
+                    if (childPtMatch) {
+                        const childPtClass = childPtMatch[1];
+                        const childPtValue = parseInt(childPtMatch[2]);
+                        const isLayoutContainer = /^<(Box|Container|div|section|main|article|aside)/i.test(trimmed);
+                        const isChildLayoutContainer = /^<(Box|Container|div|section|main|article|aside)/i.test(nextTrimmed);
+                        if (isLayoutContainer && isChildLayoutContainer) {
+                            const col = nextLine.indexOf(childPtClass) + 1;
+                            const totalPx = (ptValue + childPtValue) * 4;
+                            const expectedPx = childPtValue * 4;
+                            issues.push({
+                                file,
+                                line: j + 1,
+                                column: col,
+                                type: "warning",
+                                rule: "no-doubled-padding-top",
+                                message: `Doubled padding: Parent has ${ptClass} (line ${lineNum}), child has ${childPtClass}. Creates ${totalPx}px instead of ${expectedPx}px.`,
+                                snippet: nextTrimmed,
+                                suggestion: `Remove ${ptClass} from parent OR ${childPtClass} from child. Use padding at ONE level only.`,
+                            });
+                        }
+                        break;
+                    }
+                    if (nextTrimmed.includes("/>") || nextTrimmed.startsWith("</"))
+                        break;
+                }
+            }
+            // Pattern 2: Check for inline style paddingTop + child pt-X className
+            const inlinePaddingMatch = line.match(/style=\{\s*\{[^}]*paddingTop:\s*["']?var\(--spacing-(\d+)\)["']?/);
+            if (inlinePaddingMatch) {
+                const spacingValue = parseInt(inlinePaddingMatch[1]);
+                // Look ahead for a child with pt-X class
+                for (let j = i + 1; j < Math.min(i + 10, lines.length); j++) {
+                    const nextLine = lines[j];
+                    const nextTrimmed = nextLine.trim();
+                    if (!nextTrimmed || nextTrimmed.startsWith("//") || nextTrimmed.startsWith("/*"))
+                        continue;
+                    if (nextLine.includes("preflight-ignore"))
+                        break;
+                    const nextIndent = nextLine.search(/\S/);
+                    if (nextIndent <= currentIndent)
+                        break;
+                    const childPtMatch = nextLine.match(/<(?:Box|div)\s+[^>]*className="[^"]*\b(pt-(\d+))\b/);
+                    if (childPtMatch) {
+                        const childPtClass = childPtMatch[1];
+                        const childPtValue = parseInt(childPtMatch[2]);
+                        const col = nextLine.indexOf(childPtClass) + 1;
+                        issues.push({
+                            file,
+                            line: j + 1,
+                            column: col,
+                            type: "error",
+                            rule: "no-inline-style-doubled-padding",
+                            message: `Doubled padding: Parent has inline paddingTop (--spacing-${spacingValue}, line ${lineNum}), child has ${childPtClass}.`,
+                            snippet: nextTrimmed,
+                            suggestion: `Remove paddingTop from parent style OR remove ${childPtClass} from child. Use padding at ONE level only.`,
+                        });
+                        break;
+                    }
+                    if (nextTrimmed.includes("/>") || nextTrimmed.startsWith("</"))
+                        break;
+                }
+            }
+        }
+    }
+    // Report results
+    const errors = issues.filter((i) => i.type === "error");
+    const warnings = issues.filter((i) => i.type === "warning");
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  WARNINGS (${warnings.length}):\n`);
+        warnings.slice(0, 20).forEach((issue) => {
+            console.log(`  ${issue.file}:${issue.line}:${issue.column}`);
+            console.log(`    Rule: ${issue.rule}`);
+            console.log(`    ${issue.message}`);
+            if (issue.suggestion) {
+                console.log(`    ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            }
+            console.log("");
+        });
+        if (warnings.length > 20) {
+            console.log(`  ... and ${warnings.length - 20} more warnings\n`);
+        }
+    }
+    // Summary
+    console.log("\n" + (0, console_chars_1.createDivider)(60, "light"));
+    console.log(`${console_chars_1.emoji.chart} Summary: ${errors.length} errors, ${warnings.length} warnings`);
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} PREFLIGHT FAILED - Fix doubled padding issues`);
+        process.exit(1);
+    }
+    else if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  Review warnings - doubled padding may cause spacing inconsistencies`);
+        // Don't fail on warnings, but flag them
+    }
+    else {
+        console.log(`\n${console_chars_1.emoji.success} No doubled padding issues detected!`);
+    }
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=doubled-padding-check.js.map

package/dist/checks/ui/doubled-padding-check.js.map

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

package/dist/checks/ui/dropdown-positioning-check.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env tsx
+/**
+ * Dropdown Positioning Check Preflight (BLOCKING)
+ *
+ * Detects Menu/Dropdown components that may render off-screen due to missing
+ * anchor positioning props. Menus near the right edge of the screen need
+ * proper anchorOrigin/transformOrigin to prevent clipping.
+ *
+ * BLOCKS:
+ * - <Menu> without anchorOrigin when used in right-aligned contexts
+ * - Dropdown menus in cards/tables without positioning props
+ *
+ * APPROVED patterns:
+ * - <Menu anchorOrigin={{ vertical: "bottom", horizontal: "right" }} transformOrigin={{ vertical: "top", horizontal: "right" }}>
+ * - <DropdownMenu> (Radix-based, handles positioning automatically)
+ *
+ * Usage:
+ *   pnpm preflight:ui:dropdown-positioning
+ */
+export declare const id = "ui/dropdown-positioning-check";
+export declare const name = "Dropdown Positioning Check";
+export declare const category = "ui";
+export declare const blocking = true;
+export declare const description = "Dropdown Positioning Check Preflight (BLOCKING)";
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=dropdown-positioning-check.d.ts.map

package/dist/checks/ui/dropdown-positioning-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropdown-positioning-check.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/dropdown-positioning-check.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG;AAUH,eAAO,MAAM,EAAE,kCAAkC,CAAC;AAClD,eAAO,MAAM,IAAI,+BAA+B,CAAC;AACjD,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,oDAAoD,CAAC;AAC7E,eAAO,MAAM,IAAI,UAAS,CAAC;AA+C3B,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA2KzC"}