HealthLog/src/components/ui/empty-state.tsx

import * as React from "react";

import { cn } from "@/lib/utils";

/**
 * Reusable empty-state for lists, tiles, and chart panels that have no
 * data yet. Always pair an icon, a one-sentence explanation, and a
 * single primary action. Mounts inside the same container the loaded
 * UI uses so the layout does not shift on first data.
 *
 * Pattern (per `docs/ui-guidelines.md` §4.2):
 *
 *   <EmptyState
 *     icon={<Plus className="size-6" />}
 *     title={t("empty.measurements.title")}
 *     description={t("empty.measurements.description")}
 *     action={<Button>{t("empty.measurements.add")}</Button>}
 *   />
 */
export interface EmptyStateProps extends Omit<
  React.HTMLAttributes<HTMLDivElement>,
  "title"
> {
  icon?: React.ReactNode;
  title: React.ReactNode;
  description?: React.ReactNode;
  action?: React.ReactNode;
  /**
   * `"card"` (default) wraps the empty-state in a bordered surface so
   * it sits visually inside a list/tile.
   * `"plain"` renders inline without the wrapper — for use inside
   * chart panels that already have their own card.
   */
  variant?: "card" | "plain";
  /**
   * Compact density for use inside tiles or table-row empty rows.
   */
  size?: "default" | "compact";
  /**
   * v1.4.27 MB7 / CF-36 — size hint for the inner action wrapper.
   *
   * `"default"` keeps the legacy inline-tight CTA. `"lg"` adds a
   * `[&_button]:min-h-11 [&_a]:min-h-11` selector so the inner button
   * or `asChild` link meets the 44 px floor on mobile, and lifts the
   * wrapper to `w-full sm:w-auto` so the CTA fills the column at
   * narrow viewports and centres at `sm+`.
   */
  ctaSize?: "default" | "lg";
}

function EmptyState({
  icon,
  title,
  description,
  action,
  variant = "card",
  size = "default",
  ctaSize = "default",
  className,
  ...props
}: EmptyStateProps) {
  const inner = (
    <div
      className={cn(
        "flex flex-col items-center justify-center text-center",
        size === "compact" ? "gap-2 py-4" : "gap-3 py-8",
      )}
    >
      {icon ? (
        <div
          aria-hidden="true"
          className={cn(
            "text-muted-foreground bg-muted/60 flex items-center justify-center rounded-full",
            size === "compact" ? "size-8 p-1.5" : "size-12 p-2.5",
          )}
        >
          {icon}
        </div>
      ) : null}
      <div className="space-y-1">
        <p
          className={cn(
            "font-medium",
            size === "compact" ? "text-sm" : "text-base",
          )}
        >
          {title}
        </p>
        {description ? (
          <p className="text-muted-foreground max-w-xs text-sm">
            {description}
          </p>
        ) : null}
      </div>
      {action ? (
        <div
          className={cn(
            "mt-1",
            // v1.4.27 MB7 / CF-36 — when `ctaSize === "lg"` the wrapper
            // lifts to full-width on mobile and constrains the inner
            // `<Button>` / `asChild` `<Link>` to the 44 px tap floor.
            // The selectors target the wrapper's immediate child so
            // existing CTAs that pass a plain `<Button>` (no class
            // overrides) pick up the lift automatically.
            ctaSize === "lg" &&
              "w-full sm:w-auto [&>a]:min-h-11 [&>a]:w-full sm:[&>a]:w-auto [&>button]:min-h-11 [&>button]:w-full sm:[&>button]:w-auto",
          )}
        >
          {action}
        </div>
      ) : null}
    </div>
  );

  if (variant === "plain") {
    return (
      <div
        data-slot="empty-state"
        role="status"
        aria-live="polite"
        className={cn("w-full", className)}
        {...props}
      >
        {inner}
      </div>
    );
  }

  return (
    <div
      data-slot="empty-state"
      role="status"
      aria-live="polite"
      className={cn(
        "border-border bg-card rounded-lg border border-dashed",
        className,
      )}
      {...props}
    >
      {inner}
    </div>
  );
}

export { EmptyState };