@empline/preflight 1.0.20

package/dist/checks/ui/label-description-spacing.js

@@ -0,0 +1,285 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Label-Description Spacing Preflight
+ *
+ * Detects negative margins that pull form inputs/labels too close to description text.
+ * This catches the common issue where -mt-* classes cause labels to butt up against
+ * preceding description text in FormSection or similar components.
+ *
+ * PATTERNS DETECTED:
+ * - Negative margin-top (-mt-*) on elements following description text
+ * - Content boxes inside FormSection with -mt-* classes
+ * - Any element with -mt-* that follows Typography/description text
+ *
+ * VALID PATTERNS:
+ * - Positive margins (mt-1, mt-2, etc.)
+ * - No margin (relies on parent spacing)
+ * - Negative margins with preflight-ignore comment
+ *
+ * Usage:
+ *   pnpm preflight:label-description-spacing
+ *   pnpm preflight:label-description-spacing --verbose
+ *   pnpm preflight:label-description-spacing --warn
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+const fs = __importStar(require("fs"));
+const console_chars_1 = require("../../utils/console-chars");
+const file_cache_1 = require("../../shared/file-cache");
+const glob_patterns_1 = require("../../shared/glob-patterns");
+// Check metadata
+exports.id = "ui/label-description-spacing";
+exports.name = "Label Description Spacing";
+exports.category = "ui";
+exports.blocking = false;
+exports.description = "Label-Description Spacing Preflight";
+exports.tags = ["ui"];
+const EXCLUDED = (0, glob_patterns_1.extendExcludes)(glob_patterns_1.STANDARD_EXCLUDES_WITH_TESTS, [
+    "**/scripts/**",
+    "**/packages/ui/**",
+]);
+// Components that typically have description text followed by content
+const DESCRIPTION_CONTAINERS = [
+    "FormSection",
+    "FormSubSection",
+    "FormGroup",
+    "FieldGroup",
+    "InputGroup",
+    "SettingsSection",
+    "ConfigSection",
+];
+// Elements that indicate description/helper text
+const DESCRIPTION_INDICATORS = [
+    "description=",
+    "description:",
+    'variant="caption"',
+    "variant='caption'",
+    'variant="body2"',
+    "variant='body2'",
+    "text.secondary",
+    'color="text.secondary"',
+    "color='text.secondary'",
+    "helperText",
+];
+// CACHED FILE LISTS - Scan once, use everywhere
+let _cachedAppComponentsTsxFiles = null;
+async function getAppComponentsTsxFiles() {
+    if (!_cachedAppComponentsTsxFiles) {
+        _cachedAppComponentsTsxFiles = await file_cache_1.fileCache.getAppAndComponentsTSX();
+    }
+    return _cachedAppComponentsTsxFiles;
+}
+async function checkLabelDescriptionSpacing() {
+    const verbose = process.argv.includes("--verbose");
+    const warnOnly = process.argv.includes("--warn");
+    console.log("\n📏 Label-Description Spacing Preflight\n");
+    console.log("Detects negative margins that pull labels too close to description text.\n");
+    const files = await getAppComponentsTsxFiles();
+    const issues = [];
+    for (const file of files) {
+        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;
+            const trimmed = line.trim();
+            // Skip comments
+            if (trimmed.startsWith("//") || trimmed.startsWith("/*") || trimmed.startsWith("*"))
+                continue;
+            // Check for preflight-ignore
+            const prevLine = i > 0 ? lines[i - 1] : "";
+            if (line.includes("preflight-ignore") || prevLine.includes("preflight-ignore"))
+                continue;
+            // Pattern 1: Negative margin-top in className after FormSection/description containers
+            // Look for: className="... -mt-* ..."
+            const negativeMtMatch = line.match(/-mt-(\d+)/);
+            if (negativeMtMatch) {
+                // Check context - is this inside a description container or near description text?
+                const contextBefore = lines.slice(Math.max(0, i - 15), i).join("\n");
+                const contextAfter = lines.slice(i, Math.min(i + 5, lines.length)).join("\n");
+                // Check if we're inside a FormSection or similar
+                const inDescriptionContainer = DESCRIPTION_CONTAINERS.some((c) => contextBefore.includes(`<${c}`));
+                // Check if there's description text nearby
+                const hasDescriptionNearby = DESCRIPTION_INDICATORS.some((indicator) => contextBefore.includes(indicator) || line.includes(indicator));
+                // Check if this line itself contains description text (Typography with -mt-*)
+                const isDescriptionWithNegativeMargin = (line.includes("Typography") || line.includes("caption") || line.includes("body2")) &&
+                    negativeMtMatch;
+                // Check if this is followed by an input/label component
+                const followedByInput = contextAfter.includes("Input") ||
+                    contextAfter.includes("label=") ||
+                    contextAfter.includes("TextField") ||
+                    contextAfter.includes("Select") ||
+                    contextAfter.includes("Switch") ||
+                    contextAfter.includes("Checkbox") ||
+                    contextAfter.includes("SimplePriceInput") ||
+                    contextAfter.includes("IntegerInput");
+                // Flag if: in a form container, has description nearby, or is description text itself with negative margin
+                const shouldFlag = inDescriptionContainer || hasDescriptionNearby || isDescriptionWithNegativeMargin;
+                const mtValue = parseInt(negativeMtMatch[1]);
+                // Also flag larger negative margins (-mt-4 and above) as they're almost always problematic
+                const isLargeNegativeMargin = mtValue >= 4;
+                if (shouldFlag || isLargeNegativeMargin) {
+                    issues.push({
+                        file,
+                        line: lineNum,
+                        type: mtValue >= 2 ? "error" : "warning",
+                        message: `Negative margin-top (-mt-${mtValue}) pulls content too close to preceding text`,
+                        context: trimmed.substring(0, 100),
+                        suggestion: `Replace -mt-${mtValue} with mt-1 or remove the margin to maintain proper spacing`,
+                    });
+                }
+            }
+            // Pattern 2: Inline style with negative marginTop
+            const negativeMarginStyleMatch = line.match(/marginTop:\s*["']?-(\d+)/);
+            if (negativeMarginStyleMatch) {
+                const contextBefore = lines.slice(Math.max(0, i - 15), i).join("\n");
+                const inDescriptionContainer = DESCRIPTION_CONTAINERS.some((c) => contextBefore.includes(`<${c}`));
+                const hasDescriptionNearby = contextBefore.includes("description=") || contextBefore.includes("description:");
+                if (inDescriptionContainer || hasDescriptionNearby) {
+                    issues.push({
+                        file,
+                        line: lineNum,
+                        type: "error",
+                        message: `Negative marginTop style pulls content too close to description text`,
+                        context: trimmed.substring(0, 100),
+                        suggestion: "Use positive marginTop or remove to maintain proper spacing",
+                    });
+                }
+            }
+            // Pattern 3: Box/div immediately after description with negative margin
+            // This catches: <Box className="... -mt-2"> right after description prop
+            if (line.includes("<Box") || line.includes("<div")) {
+                const prevLines = lines.slice(Math.max(0, i - 5), i).join("\n");
+                const hasDescriptionJustBefore = prevLines.includes("description=") || prevLines.match(/>\s*$/m); // Closing of description container
+                if (hasDescriptionJustBefore && negativeMtMatch) {
+                    // Already caught above, but double-check
+                }
+            }
+        }
+    }
+    // Deduplicate issues (same file + line)
+    const uniqueIssues = issues.filter((issue, index, self) => index === self.findIndex((i) => i.file === issue.file && i.line === issue.line));
+    // Report
+    console.log((0, console_chars_1.createDivider)(60, "light"));
+    if (uniqueIssues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No label-description spacing issues found!\n`);
+        return;
+    }
+    const errors = uniqueIssues.filter((i) => i.type === "error");
+    const warnings = uniqueIssues.filter((i) => i.type === "warning");
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} ERRORS (${errors.length}):\n`);
+        if (verbose) {
+            errors.forEach((e) => {
+                console.log(`  ${e.file}:${e.line}`);
+                console.log(`    ${e.message}`);
+                console.log(`    Context: ${e.context}...`);
+                console.log(`    Fix: ${e.suggestion}`);
+                console.log("");
+            });
+        }
+        else {
+            const byFile = new Map();
+            errors.forEach((e) => {
+                if (!byFile.has(e.file))
+                    byFile.set(e.file, []);
+                byFile.get(e.file).push(e);
+            });
+            for (const [file, fileIssues] of byFile) {
+                console.log(`  ${file}:`);
+                fileIssues.forEach((e) => {
+                    console.log(`    L${e.line}: ${e.message}`);
+                });
+            }
+        }
+    }
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  WARNINGS (${warnings.length}):\n`);
+        if (verbose) {
+            warnings.forEach((w) => {
+                console.log(`  ${w.file}:${w.line}`);
+                console.log(`    ${w.message}`);
+                console.log(`    Context: ${w.context}...`);
+                console.log(`    Fix: ${w.suggestion}`);
+                console.log("");
+            });
+        }
+        else {
+            const byFile = new Map();
+            warnings.forEach((w) => {
+                if (!byFile.has(w.file))
+                    byFile.set(w.file, []);
+                byFile.get(w.file).push(w);
+            });
+            let shown = 0;
+            for (const [file, fileIssues] of byFile) {
+                if (shown >= 15) {
+                    console.log(`  ... and ${warnings.length - shown} more warnings`);
+                    break;
+                }
+                console.log(`  ${file}:`);
+                fileIssues.slice(0, 3).forEach((w) => {
+                    console.log(`    L${w.line}: ${w.message}`);
+                    shown++;
+                });
+                if (fileIssues.length > 3) {
+                    console.log(`    ... and ${fileIssues.length - 3} more in this file`);
+                    shown += fileIssues.length - 3;
+                }
+            }
+        }
+    }
+    console.log("\n" + `${console_chars_1.box.horizontal}`.repeat(60));
+    console.log(`\n${console_chars_1.emoji.chart} Summary:`);
+    console.log(`  Errors: ${errors.length}`);
+    console.log(`  Warnings: ${warnings.length}`);
+    if (errors.length > 0 && !warnOnly) {
+        console.log(`\n${console_chars_1.emoji.error} Label-description spacing check FAILED\n`);
+        process.exit(1);
+    }
+    else if (errors.length > 0 && warnOnly) {
+        console.log(`\n${console_chars_1.emoji.warning}  Label-description spacing check passed (warn mode - errors treated as warnings)\n`);
+    }
+    else {
+        console.log(`\n${console_chars_1.emoji.success} Label-description spacing check passed\n`);
+    }
+}
+checkLabelDescriptionSpacing().catch((err) => {
+    console.error("Error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=label-description-spacing.js.map

package/dist/checks/ui/label-description-spacing.js.map

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

package/dist/checks/ui/layout-shift-detection.d.ts

@@ -0,0 +1,31 @@
+#!/usr/bin/env tsx
+/**
+ * Layout Shift Detection Preflight (BLOCKING)
+ *
+ * Detects patterns that cause Cumulative Layout Shift (CLS) issues:
+ * - Inline alerts/messages that appear conditionally and push content down
+ * - Success/error states rendered in document flow instead of fixed toasts
+ * - Missing skeleton/placeholder patterns for async content
+ * - Conditional rendering that changes layout without reserving space
+ *
+ * BLOCKS:
+ * - {message && <Alert>} patterns in page content (causes shift)
+ * - {error && <div>} inline error displays
+ * - Conditional content without min-height reservation
+ *
+ * APPROVED patterns:
+ * - useStatus() / showToast() (fixed position, no shift)
+ * - Alert inside dedicated error boundary with reserved space
+ * - Skeleton placeholders for loading states
+ * - min-h-* classes reserving space for conditional content
+ *
+ * Usage:
+ *   pnpm preflight:ui:layout-shift
+ */
+export declare const id = "ui/layout-shift-detection";
+export declare const name = "Layout Shift Detection";
+export declare const category = "ui";
+export declare const blocking = true;
+export declare const description = "Layout Shift Detection Preflight (BLOCKING)";
+export declare const tags: string[];
+//# sourceMappingURL=layout-shift-detection.d.ts.map

package/dist/checks/ui/layout-shift-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-shift-detection.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/layout-shift-detection.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AASH,eAAO,MAAM,EAAE,8BAA8B,CAAC;AAC9C,eAAO,MAAM,IAAI,2BAA2B,CAAC;AAC7C,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,gDAAgD,CAAC;AACzE,eAAO,MAAM,IAAI,UAAS,CAAC"}