Files
fusion/packages/dashboard/app/components/Header.tsx
gsxdsm e35c745fc2 feat(KB-133): add mobile-responsive header with collapsible controls
- Add mobile-only header with collapsible search and overflow menu interactions

- Implement responsive layout locks in CSS for all screen sizes

- Update Header component with touch-friendly interaction states

- Add comprehensive unit and integration tests for mobile controls

- Document mobile header behavior and responsive design in README
2026-03-30 08:31:29 -07:00

338 lines
11 KiB
TypeScript

import { useState, useEffect, useRef, useCallback } from "react";
import { Settings, Pause, Play, Square, Download, LayoutGrid, List, Terminal, Lightbulb, Search, X, Activity, MoreHorizontal } from "lucide-react";
interface HeaderProps {
onOpenSettings?: () => void;
onOpenGitHubImport?: () => void;
onOpenPlanning?: () => void;
onOpenUsage?: () => void;
onToggleTerminal?: () => void;
globalPaused?: boolean;
enginePaused?: boolean;
onToggleGlobalPause?: () => void;
onToggleEnginePause?: () => void;
view?: "board" | "list";
onChangeView?: (view: "board" | "list") => void;
searchQuery?: string;
onSearchChange?: (query: string) => void;
}
function useIsMobile() {
const [isMobile, setIsMobile] = useState(() => {
if (typeof window === "undefined") return false;
return window.matchMedia("(max-width: 768px)").matches;
});
useEffect(() => {
if (typeof window === "undefined") return;
const mediaQuery = window.matchMedia("(max-width: 768px)");
const handleChange = (e: MediaQueryListEvent) => setIsMobile(e.matches);
mediaQuery.addEventListener("change", handleChange);
return () => mediaQuery.removeEventListener("change", handleChange);
}, []);
return isMobile;
}
export function Header({
onOpenSettings,
onOpenGitHubImport,
onOpenPlanning,
onOpenUsage,
onToggleTerminal,
globalPaused,
enginePaused,
onToggleGlobalPause,
onToggleEnginePause,
view = "board",
onChangeView,
searchQuery = "",
onSearchChange,
}: HeaderProps) {
const isMobile = useIsMobile();
const [isMobileSearchOpen, setIsMobileSearchOpen] = useState(false);
const [isOverflowMenuOpen, setIsOverflowMenuOpen] = useState(false);
const overflowButtonRef = useRef<HTMLButtonElement>(null);
const overflowMenuRef = useRef<HTMLDivElement>(null);
const mobileSearchRef = useRef<HTMLDivElement>(null);
const mobileSearchInputRef = useRef<HTMLInputElement>(null);
// Keep mobile search open if there's an active search query
const shouldShowMobileSearch = isMobileSearchOpen || searchQuery.length > 0;
// Close overflow menu on outside click
useEffect(() => {
if (!isOverflowMenuOpen) return;
const handleClickOutside = (e: MouseEvent) => {
if (
overflowMenuRef.current &&
!overflowMenuRef.current.contains(e.target as Node) &&
overflowButtonRef.current &&
!overflowButtonRef.current.contains(e.target as Node)
) {
setIsOverflowMenuOpen(false);
}
};
document.addEventListener("mousedown", handleClickOutside);
return () => document.removeEventListener("mousedown", handleClickOutside);
}, [isOverflowMenuOpen]);
// Close menus on Escape key
useEffect(() => {
const handleKeyDown = (e: KeyboardEvent) => {
if (e.key === "Escape") {
setIsOverflowMenuOpen(false);
setIsMobileSearchOpen(false);
}
};
document.addEventListener("keydown", handleKeyDown);
return () => document.removeEventListener("keydown", handleKeyDown);
}, []);
// Focus input when mobile search opens
useEffect(() => {
if (isMobileSearchOpen && mobileSearchInputRef.current) {
setTimeout(() => mobileSearchInputRef.current?.focus(), 0);
}
}, [isMobileSearchOpen]);
const handleMobileSearchToggle = useCallback(() => {
setIsMobileSearchOpen((prev) => !prev);
}, []);
const handleOverflowToggle = useCallback(() => {
setIsOverflowMenuOpen((prev) => !prev);
}, []);
const handleOverflowAction = useCallback((callback?: () => void) => {
if (callback) callback();
setIsOverflowMenuOpen(false);
}, []);
const handleMobileSearchClose = useCallback(() => {
setIsMobileSearchOpen(false);
if (onSearchChange) onSearchChange("");
}, [onSearchChange]);
return (
<header className="header">
<div className="header-left">
<img src="/logo.svg" alt="Fusion logo" className="header-logo" width={24} height={24} />
<h1 className="logo">Fusion</h1>
<span className="logo-sub">tasks</span>
</div>
<div className="header-actions">
{/* View Toggle - always inline, even on mobile */}
{onChangeView && (
<div className="view-toggle">
<button
className={`view-toggle-btn${view === "board" ? " active" : ""}`}
onClick={() => onChangeView("board")}
title="Board view"
aria-label="Board view"
aria-pressed={view === "board"}
>
<LayoutGrid size={16} />
</button>
<button
className={`view-toggle-btn${view === "list" ? " active" : ""}`}
onClick={() => onChangeView("list")}
title="List view"
aria-label="List view"
aria-pressed={view === "list"}
>
<List size={16} />
</button>
</div>
)}
{/* Desktop Search - only show in board view */}
{onSearchChange && view === "board" && !isMobile && (
<div className="header-search">
<Search size={14} className="header-search-icon" />
<input
type="text"
placeholder="Search tasks..."
value={searchQuery}
onChange={(e) => onSearchChange(e.target.value)}
className="header-search-input"
/>
{searchQuery && (
<button
className="header-search-clear"
onClick={() => onSearchChange("")}
aria-label="Clear search"
>
<X size={14} />
</button>
)}
</div>
)}
{/* Mobile Search Trigger - only show in board view on mobile */}
{onSearchChange && view === "board" && isMobile && (
<>
{!shouldShowMobileSearch ? (
<button
className="btn-icon mobile-search-trigger"
onClick={handleMobileSearchToggle}
title="Open search"
aria-label="Open search"
aria-expanded={false}
>
<Search size={16} />
</button>
) : (
<div
ref={mobileSearchRef}
className="header-search mobile-search-expanded"
>
<Search size={14} className="header-search-icon" />
<input
ref={mobileSearchInputRef}
type="text"
placeholder="Search tasks..."
value={searchQuery}
onChange={(e) => onSearchChange(e.target.value)}
className="header-search-input"
/>
<button
className="header-search-clear"
onClick={handleMobileSearchClose}
aria-label="Close search"
>
<X size={14} />
</button>
</div>
)}
</>
)}
{/* Desktop actions */}
{!isMobile && onOpenUsage && (
<button className="btn-icon" onClick={onOpenUsage} title="View usage">
<Activity size={16} />
</button>
)}
{!isMobile && (
<button className="btn-icon" onClick={onOpenGitHubImport} title="Import from GitHub">
<Download size={16} />
</button>
)}
{!isMobile && (
<button
className="btn-icon"
onClick={onOpenPlanning}
title="Create a task with AI planning"
data-testid="planning-btn"
>
<Lightbulb size={16} />
</button>
)}
{/* Terminal button - always inline */}
<button
className="btn-icon btn-icon--terminal"
onClick={onToggleTerminal}
title="Open Terminal"
data-testid="terminal-toggle-btn"
>
<Terminal size={16} />
</button>
{/* Pause button (soft pause) - always inline */}
<button
className={`btn-icon${enginePaused ? " btn-icon--paused" : ""}`}
onClick={onToggleEnginePause}
title={enginePaused ? "Resume scheduling" : "Pause scheduling"}
disabled={!!globalPaused}
>
{enginePaused ? <Play size={16} /> : <Pause size={16} />}
</button>
{/* Stop button (hard stop) - always inline */}
<button
className={`btn-icon${globalPaused ? " btn-icon--stopped" : ""}`}
onClick={onToggleGlobalPause}
title={globalPaused ? "Start AI engine" : "Stop AI engine"}
>
{globalPaused ? <Play size={16} /> : <Square size={16} />}
</button>
{/* Mobile overflow menu trigger */}
{isMobile && (
<button
ref={overflowButtonRef}
className="btn-icon mobile-overflow-trigger"
onClick={handleOverflowToggle}
title="More header actions"
aria-label="More header actions"
aria-expanded={isOverflowMenuOpen}
aria-haspopup="menu"
>
<MoreHorizontal size={16} />
</button>
)}
{/* Settings - always inline on desktop */}
{!isMobile && (
<button className="btn-icon" onClick={onOpenSettings} title="Settings">
<Settings size={16} />
</button>
)}
{/* Mobile overflow menu */}
{isMobile && isOverflowMenuOpen && (
<div
ref={overflowMenuRef}
className="mobile-overflow-menu"
role="menu"
aria-label="Additional header actions"
>
{onOpenUsage && (
<button
className="mobile-overflow-item"
onClick={() => handleOverflowAction(onOpenUsage)}
role="menuitem"
>
<Activity size={16} />
<span>View usage</span>
</button>
)}
<button
className="mobile-overflow-item"
onClick={() => handleOverflowAction(onOpenGitHubImport)}
role="menuitem"
>
<Download size={16} />
<span>Import from GitHub</span>
</button>
<button
className="mobile-overflow-item"
onClick={() => handleOverflowAction(onOpenPlanning)}
role="menuitem"
data-testid="overflow-planning-btn"
>
<Lightbulb size={16} />
<span>Create a task with AI planning</span>
</button>
<button
className="mobile-overflow-item"
onClick={() => handleOverflowAction(onOpenSettings)}
role="menuitem"
>
<Settings size={16} />
<span>Settings</span>
</button>
</div>
)}
</div>
</header>
);
}