@empline/preflight 1.1.11 → 1.1.13

package/dist/checks/consolidated/ui-interactive-states.d.ts

@@ -0,0 +1,240 @@
+#!/usr/bin/env tsx
+/**
+ * UI Interactive States Preflight (BLOCKING)
+ *
+ * Google/Meta/X-level interactive state consistency.
+ * Ensures hover, active, focus, and disabled states are consistent across all components.
+ *
+ * Checks:
+ * 1. Hover state consistency - Same hover tokens across similar components
+ * 2. Active/pressed state coverage - All buttons have active states
+ * 3. Focus ring consistency - Same focus style across components
+ * 4. Disabled state styling - Consistent disabled appearance
+ * 5. Cursor consistency - Correct cursor for each state
+ *
+ * Usage:
+ *   pnpm preflight:ui-interactive-states              # All checks
+ *   pnpm preflight:ui-interactive-states hover        # Hover states only
+ *   pnpm preflight:ui-interactive-states active       # Active states only
+ *   pnpm preflight:ui-interactive-states focus        # Focus states only
+ *   pnpm preflight:ui-interactive-states disabled     # Disabled states only
+ *   pnpm preflight:ui-interactive-states cursor       # Cursor consistency only
+ */
+interface Issue {
+    file: string;
+    line: number;
+    type: string;
+    severity: "error" | "warning" | "info";
+    message: string;
+    suggestion: string;
+    snippet?: string;
+}
+interface CheckResult {
+    name: string;
+    passed: boolean;
+    blocking: boolean;
+    issues: Issue[];
+    duration: number;
+}
+interface ModuleResult {
+    module: string;
+    passed: boolean;
+    totalDuration: number;
+    checks: CheckResult[];
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        errors: number;
+        warnings: number;
+    };
+}
+/**
+ * Standard hover tokens - should be consistent across components
+ */
+declare const STANDARD_HOVER_TOKENS: {
+    "bg-tertiary": string;
+    "overlay-light": string;
+    "overlay-medium": string;
+    "primary-hover": string;
+    "bg-tertiary-tw": string;
+    "overlay-light-tw": string;
+};
+/**
+ * Standard focus ring styles
+ */
+declare const STANDARD_FOCUS_STYLES: {
+    ring: string;
+    ringColor: string;
+    outline: string;
+};
+declare class UIInteractiveStatesModule {
+    private verbose;
+    private parallel;
+    constructor(options?: {
+        verbose?: boolean;
+        parallel?: boolean;
+    });
+    private getTsxFiles;
+    /**
+     * 1. Hover State Consistency
+     * Ensure consistent hover background tokens
+     */
+    checkHoverStateConsistency(): Promise<CheckResult>;
+    /**
+     * 2. Active/Pressed State Coverage
+     * Ensure interactive elements have active states
+     */
+    checkActiveStateCoverage(): Promise<CheckResult>;
+    /**
+     * 3. Focus Ring Consistency
+     * Ensure focus states use consistent styling
+     */
+    checkFocusRingConsistency(): Promise<CheckResult>;
+    /**
+     * 4. Disabled State Styling
+     * Ensure disabled states are consistent
+     */
+    checkDisabledStateStyling(): Promise<CheckResult>;
+    /**
+     * 5. Cursor Consistency
+     * Ensure correct cursor for each element type
+     */
+    checkCursorConsistency(): Promise<CheckResult>;
+    /**
+     * 6. Scale Feedback Consistency
+     * Ensure active:scale values are consistent across components
+     */
+    checkScaleFeedbackConsistency(): Promise<CheckResult>;
+    /**
+     * 7. Loading Spinner Consistency
+     * Ensure loading spinners use consistent sizing and patterns
+     */
+    checkLoadingSpinnerConsistency(): Promise<CheckResult>;
+    /**
+     * 8. Reduced Motion Support (Accessibility)
+     * Check for prefers-reduced-motion support in animations
+     */
+    checkReducedMotionSupport(): Promise<CheckResult>;
+    /**
+     * 9. Async Operation Feedback
+     * Check that async operations provide success/error feedback
+     */
+    checkAsyncOperationFeedback(): Promise<CheckResult>;
+    /**
+     * 10. Transition Property Consistency
+     * Ensure transition properties are consistent (all vs specific)
+     */
+    checkTransitionConsistency(): Promise<CheckResult>;
+    /**
+     * 11. Touch/Gesture Feedback
+     * Check for mobile touch states and gesture feedback
+     */
+    checkTouchGestureFeedback(): Promise<CheckResult>;
+    /**
+     * 12. Scroll Snap Consistency
+     * Check for consistent scroll-snap patterns
+     */
+    checkScrollSnapConsistency(): Promise<CheckResult>;
+    /**
+     * 13. Drag and Drop Feedback
+     * Check for DnD visual indicators and feedback
+     */
+    checkDragDropFeedback(): Promise<CheckResult>;
+    /**
+     * 14. Input Validation Feedback
+     * Check for real-time validation visual feedback
+     */
+    checkInputValidationFeedback(): Promise<CheckResult>;
+    /**
+     * 15. Toast/Notification Timing
+     * Check for consistent notification durations
+     */
+    checkToastNotificationTiming(): Promise<CheckResult>;
+    /**
+     * 16. Skeleton-to-Content Match
+     * Check that skeleton sizes match actual loaded content
+     */
+    checkSkeletonContentMatch(): Promise<CheckResult>;
+    /**
+     * 17. Empty State Patterns
+     * Check for consistent empty state component usage
+     */
+    checkEmptyStatePatterns(): Promise<CheckResult>;
+    /**
+     * 18. Selection Feedback
+     * Check for multi-select and checkbox visual states
+     */
+    checkSelectionFeedback(): Promise<CheckResult>;
+    /**
+     * 19. Accordion Animation
+     * Check for consistent expand/collapse animations
+     */
+    checkAccordionAnimation(): Promise<CheckResult>;
+    /**
+     * 20. Modal Entry/Exit Animation
+     * Check for consistent modal animation patterns
+     */
+    checkModalAnimation(): Promise<CheckResult>;
+    /**
+     * 21. Copy-to-Clipboard Feedback
+     * Check for success indication after clipboard operations
+     */
+    checkCopyFeedback(): Promise<CheckResult>;
+    /**
+     * 22. Infinite Scroll Loading
+     * Check for loading indicators at scroll boundaries
+     */
+    checkInfiniteScrollLoading(): Promise<CheckResult>;
+    /**
+     * 23. Filter Active State
+     * Check for visual feedback when filters are applied
+     */
+    checkFilterActiveState(): Promise<CheckResult>;
+    /**
+     * 24. Optimistic Updates
+     * Check for optimistic UI patterns in mutations
+     */
+    checkOptimisticUpdates(): Promise<CheckResult>;
+    /**
+     * 25. Undo/Redo Patterns
+     * Check for undo functionality on destructive actions
+     */
+    checkUndoRedoPatterns(): Promise<CheckResult>;
+    /**
+     * 26. Keyboard Shortcuts
+     * Check for keyboard navigation and shortcut support
+     */
+    checkKeyboardShortcuts(): Promise<CheckResult>;
+    /**
+     * 27. Search Debounce
+     * Check for debouncing on search/filter inputs
+     */
+    checkSearchDebounce(): Promise<CheckResult>;
+    /**
+     * 28. Confirmation Dialogs
+     * Check for confirmation on destructive actions
+     */
+    checkConfirmationDialogs(): Promise<CheckResult>;
+    /**
+     * 29. Progress Indicators
+     * Check for progress tracking on multi-step operations
+     */
+    checkProgressIndicators(): Promise<CheckResult>;
+    /**
+     * 30. Error Recovery
+     * Check for retry mechanisms and error recovery UI
+     */
+    checkErrorRecovery(): Promise<CheckResult>;
+    /**
+     * 31. Success Celebrations
+     * Check for micro-animations and feedback on successful actions
+     */
+    checkSuccessCelebrations(): Promise<CheckResult>;
+    /**
+     * Run all checks
+     */
+    runAll(filter?: string): Promise<ModuleResult>;
+}
+export { STANDARD_FOCUS_STYLES, STANDARD_HOVER_TOKENS, UIInteractiveStatesModule };
+//# sourceMappingURL=ui-interactive-states.d.ts.map

package/dist/checks/consolidated/ui-interactive-states.d.ts.map

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