Stirling-PDF/frontend/shared/components/PanelHeader.tsx

import type { ReactNode } from "react";
import "@shared/components/PanelHeader.css";
import { IconBadge } from "@shared/components/IconBadge";

export interface PanelHeaderProps {
  title: ReactNode;
  /** Sub-heading below the title. */
  subtitle?: ReactNode;
  /** Show a back chevron and trigger this callback when clicked. */
  onBack?: () => void;
  /** Optional leading visual (e.g. a category glyph) shown in a tinted box. */
  icon?: ReactNode;
  /** Accent tint for the leading icon box. Defaults to blue. */
  iconAccent?: "blue" | "purple" | "green" | "amber" | "red";
  /** Right-aligned action buttons / chips. */
  actions?: ReactNode;
  className?: string;
}

/**
 * Header strip used by drill-down panels (admin tabs, agent detail, settings
 * sub-pages). Back chevron renders only when `onBack` is supplied; an optional
 * leading `icon` renders in a tinted box before the title.
 */
export function PanelHeader({
  title,
  subtitle,
  onBack,
  icon,
  iconAccent = "blue",
  actions,
  className,
}: PanelHeaderProps) {
  return (
    <div
      className={["sui-panelhdr", className ?? ""].filter(Boolean).join(" ")}
    >
      <div className="sui-panelhdr__left">
        {onBack && (
          <button
            type="button"
            className="sui-panelhdr__back"
            onClick={onBack}
            aria-label="Back"
          >
            <svg
              viewBox="0 0 24 24"
              width={18}
              height={18}
              fill="none"
              stroke="currentColor"
              strokeWidth={1.75}
              strokeLinecap="round"
              strokeLinejoin="round"
            >
              <polyline points="15 18 9 12 15 6" />
            </svg>
          </button>
        )}
        {icon && (
          <IconBadge accent={iconAccent} size="md">
            {icon}
          </IconBadge>
        )}
        <div className="sui-panelhdr__text">
          <div className="sui-panelhdr__title">{title}</div>
          {subtitle && <div className="sui-panelhdr__sub">{subtitle}</div>}
        </div>
      </div>
      {actions && <div className="sui-panelhdr__actions">{actions}</div>}
    </div>
  );
}