@empline/preflight 1.1.0

package/dist/checks/ui/flex-spacing-validation.d.ts

@@ -0,0 +1,54 @@
+#!/usr/bin/env tsx
+/**
+ * Flex Spacing Validation Preflight (NON-BLOCKING)
+ *
+ * Detects missing gap/spacing in flex containers, particularly:
+ * - Button + checkbox/label combinations without proper gap
+ * - Empty label elements that break visual spacing
+ * - Flex containers with multiple children but no gap class
+ *
+ * Usage:
+ *   pnpm preflight:flex-spacing
+ *   pnpm preflight:flex-spacing --verbose
+ */
+export declare const id = "ui/flex-spacing-validation";
+export declare const name = "Flex Spacing Validation";
+export declare const description = "Detects missing gap/spacing in flex containers";
+export declare const category = "ui";
+export declare const blocking = false;
+export declare const tags: string[];
+interface CheckResult {
+    name: string;
+    passed: boolean;
+    duration: number;
+    errors: string[];
+    warnings: string[];
+}
+declare class FlexSpacingPreflight {
+    private verbose;
+    constructor(options?: {
+        verbose?: boolean;
+    });
+    private readFile;
+    /**
+     * Check for empty or broken label elements
+     * Pattern: <label ...></label> with nothing between tags
+     */
+    private checkEmptyLabels;
+    /**
+     * Check for flex containers with Button + checkbox without gap
+     */
+    private checkButtonCheckboxSpacing;
+    /**
+     * Check for Typography inside label (should use span for inline)
+     */
+    private checkTypographyInLabel;
+    private validateFlexSpacing;
+    runAll(): Promise<{
+        passed: boolean;
+        results: CheckResult[];
+    }>;
+    private printResults;
+}
+export { FlexSpacingPreflight };
+//# sourceMappingURL=flex-spacing-validation.d.ts.map

package/dist/checks/ui/flex-spacing-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flex-spacing-validation.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/flex-spacing-validation.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AAYH,eAAO,MAAM,EAAE,+BAA+B,CAAC;AAC/C,eAAO,MAAM,IAAI,4BAA4B,CAAC;AAC9C,eAAO,MAAM,WAAW,mDAAmD,CAAC;AAC5E,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,IAAI,UAAoD,CAAC;AAEtE,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAiBD,cAAM,oBAAoB;IACxB,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO;IAI/C,OAAO,CAAC,QAAQ;IAMhB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAkClC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAwB9B,OAAO,CAAC,mBAAmB;IA2CrB,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;IAapE,OAAO,CAAC,YAAY;CA0CrB;AAkBD,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/checks/ui/flex-spacing-validation.js

@@ -0,0 +1,263 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Flex Spacing Validation Preflight (NON-BLOCKING)
+ *
+ * Detects missing gap/spacing in flex containers, particularly:
+ * - Button + checkbox/label combinations without proper gap
+ * - Empty label elements that break visual spacing
+ * - Flex containers with multiple children but no gap class
+ *
+ * Usage:
+ *   pnpm preflight:flex-spacing
+ *   pnpm preflight:flex-spacing --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.FlexSpacingPreflight = exports.tags = exports.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+const glob_1 = require("glob");
+// METADATA
+exports.id = "ui/flex-spacing-validation";
+exports.name = "Flex Spacing Validation";
+exports.description = "Detects missing gap/spacing in flex containers";
+exports.category = "ui";
+exports.blocking = false;
+exports.tags = ["ui", "spacing", "flex", "gap", "accessibility"];
+const EXCLUDED_DIRS = [
+    "**/node_modules/**",
+    "**/.next/**",
+    "**/__tests__/**",
+    "**/*.test.tsx",
+    "**/*.stories.tsx",
+];
+class FlexSpacingPreflight {
+    verbose;
+    constructor(options = {}) {
+        this.verbose = options.verbose || false;
+    }
+    readFile(filePath) {
+        const fullPath = path.join(process.cwd(), filePath);
+        if (!fs.existsSync(fullPath))
+            return null;
+        return fs.readFileSync(fullPath, "utf-8");
+    }
+    /**
+     * Check for empty or broken label elements
+     * Pattern: <label ...></label> with nothing between tags
+     */
+    checkEmptyLabels(content, filePath) {
+        const issues = [];
+        const lines = content.split("\n");
+        // Pattern: label with className but empty content or only whitespace before closing
+        const emptyLabelPattern = /<label[^>]*className[^>]*>\s*<\/label>/g;
+        let match;
+        while ((match = emptyLabelPattern.exec(content)) !== null) {
+            const lineNum = content.substring(0, match.index).split("\n").length;
+            issues.push({
+                file: filePath,
+                line: lineNum,
+                issue: "Empty <label> element found - content may be outside the label",
+                suggestion: "Ensure checkbox and text are inside the label element",
+            });
+        }
+        // Pattern: label that opens but input/checkbox is after closing tag
+        // This catches: <label className="..."></label>\n<input
+        for (let i = 0; i < lines.length - 1; i++) {
+            const line = lines[i];
+            const nextLine = lines[i + 1] || "";
+            if (line.includes("</label>") && nextLine.trim().startsWith("<input")) {
+                issues.push({
+                    file: filePath,
+                    line: i + 1,
+                    issue: "Input element outside its label - breaks accessibility and spacing",
+                    suggestion: "Move <input> inside the <label> element",
+                });
+            }
+        }
+        return issues;
+    }
+    /**
+     * Check for flex containers with Button + checkbox without gap
+     */
+    checkButtonCheckboxSpacing(content, filePath) {
+        const issues = [];
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Look for flex containers
+            if (line.includes("flex") && line.includes("className")) {
+                // Check if it has gap
+                const hasGap = /gap-\d|gap-\[/.test(line);
+                if (!hasGap) {
+                    // Look ahead for Button + checkbox/label pattern within 10 lines
+                    const nextLines = lines.slice(i, i + 10).join("\n");
+                    const hasButton = /<Button|Button\s+/.test(nextLines);
+                    const hasCheckbox = /checkbox|<input\s+type=["']checkbox/.test(nextLines.toLowerCase());
+                    const hasLabel = /<label/.test(nextLines);
+                    if (hasButton && (hasCheckbox || hasLabel)) {
+                        issues.push({
+                            file: filePath,
+                            line: i + 1,
+                            issue: "Flex container with Button + checkbox/label missing gap class",
+                            suggestion: "Add gap-2, gap-3, or gap-4 to the flex container",
+                        });
+                    }
+                }
+            }
+        }
+        return issues;
+    }
+    /**
+     * Check for Typography inside label (should use span for inline)
+     */
+    checkTypographyInLabel(content, filePath) {
+        const issues = [];
+        // Pattern: <label...><Typography - Typography adds block-level styling
+        const pattern = /<label[^>]*>[\s\S]*?<Typography/g;
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+            // Make sure it's actually inside the label (not after)
+            const snippet = match[0];
+            if (!snippet.includes("</label>")) {
+                const lineNum = content.substring(0, match.index).split("\n").length;
+                issues.push({
+                    file: filePath,
+                    line: lineNum,
+                    issue: "Typography component inside <label> may cause spacing issues",
+                    suggestion: "Use <span className=\"text-sm\"> instead of Typography for inline label text",
+                });
+            }
+        }
+        return issues;
+    }
+    validateFlexSpacing() {
+        const startTime = Date.now();
+        const errors = [];
+        const warnings = [];
+        const files = glob_1.glob.sync("components/**/*.tsx", { ignore: EXCLUDED_DIRS });
+        for (const filePath of files) {
+            const content = this.readFile(filePath);
+            if (!content)
+                continue;
+            const fileName = path.basename(filePath);
+            // Run checks
+            const emptyLabelIssues = this.checkEmptyLabels(content, fileName);
+            const buttonCheckboxIssues = this.checkButtonCheckboxSpacing(content, fileName);
+            const typographyIssues = this.checkTypographyInLabel(content, fileName);
+            // Empty labels are errors (broken UI)
+            for (const issue of emptyLabelIssues) {
+                errors.push(`${issue.file}:${issue.line} - ${issue.issue}`);
+            }
+            // Button+checkbox spacing are warnings
+            for (const issue of buttonCheckboxIssues) {
+                warnings.push(`${issue.file}:${issue.line} - ${issue.issue}`);
+            }
+            // Typography in label are warnings
+            for (const issue of typographyIssues) {
+                warnings.push(`${issue.file}:${issue.line} - ${issue.issue}`);
+            }
+        }
+        return {
+            name: "Flex Spacing",
+            passed: errors.length === 0,
+            duration: Date.now() - startTime,
+            errors,
+            warnings,
+        };
+    }
+    async runAll() {
+        console.log("\n" + console_chars_1.emoji.chart + " FLEX SPACING VALIDATION");
+        console.log((0, console_chars_1.createDivider)(60, "heavy"));
+        const results = [];
+        results.push(this.validateFlexSpacing());
+        this.printResults(results);
+        const allPassed = results.every((r) => r.passed);
+        return { passed: allPassed, results };
+    }
+    printResults(results) {
+        console.log("\n" + (0, console_chars_1.createDivider)(60, "light"));
+        for (const result of results) {
+            const icon = result.passed ? console_chars_1.emoji.success : console_chars_1.emoji.error;
+            const time = result.duration < 1000
+                ? `${result.duration}ms`
+                : `${(result.duration / 1000).toFixed(1)}s`;
+            console.log(`${icon} ${result.name.padEnd(35)} ${time.padStart(8)}`);
+            if (this.verbose || !result.passed) {
+                for (const error of result.errors) {
+                    console.log(`   ${console_chars_1.emoji.error} ${error}`);
+                }
+            }
+            if (this.verbose && result.warnings.length > 0) {
+                for (const warning of result.warnings) {
+                    console.log(`   ${console_chars_1.emoji.warning} ${warning}`);
+                }
+            }
+        }
+        console.log("\n" + (0, console_chars_1.createDivider)(60, "heavy"));
+        const passed = results.filter((r) => r.passed).length;
+        const failed = results.filter((r) => !r.passed).length;
+        const totalWarnings = results.reduce((sum, r) => sum + r.warnings.length, 0);
+        const totalTime = results.reduce((sum, r) => sum + r.duration, 0);
+        console.log(`${console_chars_1.emoji.chart} Results: ${passed} passed, ${failed} failed`);
+        if (totalWarnings > 0) {
+            console.log(`${console_chars_1.emoji.warning} Warnings: ${totalWarnings}`);
+        }
+        console.log(`${console_chars_1.emoji.clock} Total time: ${(totalTime / 1000).toFixed(1)}s`);
+        if (failed === 0) {
+            console.log(`\n${console_chars_1.emoji.success} FLEX SPACING PASSED`);
+        }
+        else {
+            console.log(`\n${console_chars_1.emoji.error} FLEX SPACING FAILED`);
+        }
+    }
+}
+exports.FlexSpacingPreflight = FlexSpacingPreflight;
+// CLI
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const args = process.argv.slice(2);
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    const preflight = new FlexSpacingPreflight({ verbose });
+    const { passed } = await preflight.runAll();
+    process.exit(passed ? 0 : 1);
+}
+if (require.main === module) {
+    main();
+}
+//# sourceMappingURL=flex-spacing-validation.js.map

package/dist/checks/ui/flex-spacing-validation.js.map

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

package/dist/checks/ui/floating-action-buttons.d.ts

@@ -0,0 +1,36 @@
+#!/usr/bin/env tsx
+/**
+ * Floating Action Buttons Check Preflight (BLOCKING)
+ *
+ * Detects action buttons (Button, IconButton) that are not contained within
+ * a Card component in admin/dashboard pages.
+ *
+ * WHY THIS MATTERS:
+ * - Floating buttons look disconnected and unprofessional
+ * - Buttons should be grouped with related content in Cards
+ * - Consistent Card usage improves visual hierarchy
+ *
+ * PATTERNS DETECTED:
+ * 1. Button groups in Box/div without Card wrapper in admin pages
+ * 2. Action buttons directly in page layout without Card
+ * 3. Toolbar-style button groups that should be in a Card header
+ *
+ * ALLOWED PATTERNS (not flagged):
+ * - Buttons inside Card/CardContent/CardHeader/CardFooter
+ * - Buttons inside Dialog/Modal
+ * - Buttons inside TableCell (action column)
+ * - Navigation buttons in headers/navbars
+ * - Single icon buttons (typically navigation/close)
+ *
+ * Usage:
+ *   pnpm preflight:floating-action-buttons
+ *   pnpm preflight:floating-action-buttons --verbose
+ */
+export declare const id = "ui/floating-action-buttons";
+export declare const name = "Floating Action Buttons";
+export declare const category = "ui";
+export declare const blocking = false;
+export declare const description = "Detects action buttons not contained in Card components";
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=floating-action-buttons.d.ts.map

package/dist/checks/ui/floating-action-buttons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floating-action-buttons.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/floating-action-buttons.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AASH,eAAO,MAAM,EAAE,+BAA+B,CAAC;AAC/C,eAAO,MAAM,IAAI,4BAA4B,CAAC;AAC9C,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,4DAA4D,CAAC;AACrF,eAAO,MAAM,IAAI,UAAwD,CAAC;AA2D1E,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAkRzC"}