wulf-pulse/components/navigation/mobile-nav.tsx
lorentz 9bfb57553d feat(design): nav/visual overhaul — brand layer, /status route, KPI dashboard, TanStack DataTable
Major UI refresh on the nav-design-improvements branch.  Drops 2013-era
inline styles and consolidates patterns behind shared primitives.

Foundation
- New Wulf brand layer in app/styles/brand.css repointing --primary to
  the standards-guide blue (#0075AD) with utility classes for numerics
  (.num / .num-lg / .num-xl), metric labels, surface tints, and the
  wolf-mark watermark
- Switch primary face to IBM Plex Sans + IBM Plex Mono via next/font;
  Helvetica/Arial stays in the fallback chain for brand fidelity
- Wordmark subtitle changed from "PSA Management System" to
  "Operations console" everywhere it appeared
- Tagline footer ("Don't be afraid to cry") on every non-mobile page

Status moved out of /dashboard
- New /status route with integration tiles grouped by category, sync
  health table, worker pulse cards (analyzer / RMM / sync scheduler),
  token-expiry section, conditional alert banner
- Top-bar StatusIndicator polls integration health every 60s and links
  to /status
- INTEGRATIONS_DISABLED env var suppresses operator-disabled
  integrations (e.g. SentinelOne) — no failure noise from broken-on-
  purpose entries.  Aliases supported (sentinelone → s1, etc.)

Dashboard rebuilt around KPIs
- /api/dashboard/overview adds today snapshot (opened, resolved, open
  total, SLA breaches) with delta math
- /api/dashboard/trends backs queue × priority heatmap, 30-day volume
  area chart, 30-day mean resolution time line chart, today's active
  engineers leaderboard

Components
- StatusBadge driven by lib/status-registry.ts (priority, ticket
  status, classification, source, company type, publish, active /
  yes-no / billable / approved registries)
- StatusLight (8px geometric square, five states, three sizes)
- EmptyState (shared dashed panel with icon + headline + optional CTA)
- KpiCard with delta indicator and tonal left border
- WulfMark (mark / wordmark variants from /public/branding)
- Skeleton helpers (SkeletonRow / Rows / Card / Chart / Header / Table)

Navigation
- Admin flat link → dropdown with seven shortcuts
- New UserMenu (initials avatar, role badge, settings + sign-out)
- Active-route highlight is now a 2px Wulf-blue underline echoing the
  PageHeader rule (consistent across flat links and submenu triggers);
  active children inside dropdowns use bg-primary/10
- Submenu width is content-driven (min-w 320 / max-w 440, single col)
- Mobile hamburger via Sheet, reuses the same nav config

Pages migrated
- 16 admin sub-pages adopt PageHeader (with accent prop)
- /addigy-devices: shadcn Table + Checkbox; PageHeader; status badges
- 10 raw <table> blocks across admin/sync/* migrated to shadcn Table
- /veeam-analysis migrated to shadcn Table (kept its expansion logic)
- Detail routes (analyzer ticket, analyzer analysis) get breadcrumbs

DataTable
- Rewritten on @tanstack/react-table v8 in manual mode; external API
  unchanged so all 10+ data-browser pages keep working
- New optional props for drill-down rows: getRowCanExpand + renderSubRow

Mobile
- Multi-select Popover gets max-w-[calc(100vw-1rem)] and
  collisionPadding so dropdowns can't overflow narrow viewports
- CI filter bar wraps and shrinks; stat pill flows below

Docs
- New ARCHITECTURE.md (load-bearing reference for runtime, data flow,
  workers, analyzer pipeline, auth, deployment, gotchas)
- New DESIGN.md (tokens, layout, navigation IA, component vocabulary,
  rolling backlog of remaining cleanup)
- CLAUDE.md refreshed with pointers to the two new docs and the
  INTEGRATIONS_DISABLED operator config note
- shadcn registry registered as project-level MCP server (.mcp.json)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-03 09:33:13 -04:00

149 lines
4.1 KiB
TypeScript

/* MobileNav — hamburger menu for sub-md viewports.
*
* Reuses the same nav config that the desktop NavigationMenu consumes
* (passed in via prop) so the IA stays in sync. Renders as a Sheet
* sliding in from the left, with the same active-route treatment
* (2 px brand-blue underline). */
'use client';
import { useState } from 'react';
import Link from 'next/link';
import { Menu } from 'lucide-react';
import { cn } from '@/lib/utils';
import { Button } from '@/components/ui/button';
import {
Sheet,
SheetContent,
SheetHeader,
SheetTitle,
SheetTrigger,
} from '@/components/ui/sheet';
import { Separator } from '@/components/ui/separator';
interface NavItem {
title: string;
href?: string;
icon?: React.ElementType;
description?: string;
children?: NavItem[];
}
interface MobileNavProps {
items: NavItem[];
pathname: string;
isActive: (href?: string) => boolean;
}
export function MobileNav({ items, pathname, isActive }: MobileNavProps) {
const [open, setOpen] = useState(false);
// Close the sheet when the path changes — handles the link click before
// useEffect from a route subscription. Effect would also work but this
// is simpler and side-effect-free.
const handleNav = () => setOpen(false);
return (
<Sheet open={open} onOpenChange={setOpen}>
<SheetTrigger asChild>
<Button
variant="ghost"
size="icon"
className="md:hidden h-9 w-9"
aria-label="Open navigation"
>
<Menu className="h-5 w-5" />
</Button>
</SheetTrigger>
<SheetContent side="left" className="w-72 p-0 flex flex-col">
<SheetHeader className="border-b">
<SheetTitle className="px-4 py-3 text-left">Pulse</SheetTitle>
</SheetHeader>
<nav className="flex-1 overflow-y-auto p-2 space-y-0.5">
{items.map((item) => (
<MobileNavGroup
key={item.title}
item={item}
isActive={isActive}
onNav={handleNav}
/>
))}
</nav>
<Separator />
<p className="tagline px-4 py-3">
Don&apos;t be afraid to cry · Wulf Consulting
</p>
</SheetContent>
</Sheet>
);
}
function MobileNavGroup({
item,
isActive,
onNav,
}: {
item: NavItem;
isActive: (href?: string) => boolean;
onNav: () => void;
}) {
if (!item.children) {
const active = isActive(item.href);
return (
<Link
href={item.href || '#'}
onClick={onNav}
className={cn(
'flex items-center gap-3 rounded-sm px-3 py-2 text-sm transition-colors',
'hover:bg-accent/50',
active
? 'text-primary font-medium border-l-2 border-primary pl-[10px]'
: 'text-foreground border-l-2 border-transparent pl-[10px]',
)}
>
{item.icon && <item.icon className="h-4 w-4 shrink-0" />}
{item.title}
</Link>
);
}
const groupActive = item.children.some((c) => isActive(c.href));
return (
<div className="space-y-0.5">
<p
className={cn(
'flex items-center gap-3 px-3 pt-3 pb-1 metric-label',
groupActive && 'text-primary',
)}
>
{item.icon && <item.icon className="h-3.5 w-3.5 shrink-0" />}
{item.title}
</p>
<div className="ml-2 space-y-0.5">
{item.children.map((child) => {
const active = isActive(child.href);
return (
<Link
key={child.title}
href={child.href || '#'}
onClick={onNav}
className={cn(
'flex items-center gap-3 rounded-sm px-3 py-1.5 text-sm transition-colors',
'hover:bg-accent/50',
active
? 'text-primary font-medium border-l-2 border-primary pl-[10px]'
: 'text-foreground border-l-2 border-transparent pl-[10px]',
)}
>
{child.icon && <child.icon className="h-4 w-4 shrink-0 text-muted-foreground" />}
<span className="truncate">{child.title}</span>
</Link>
);
})}
</div>
</div>
);
}