/**
 * @factory/ui — EmptyState (icon + title + description + optional action).
 * Used for empty pages/databases/search results (Definition of Done: "empty
 * state" per AGENTS.md).
 */
import * as React from "react";
import { clsx } from "clsx";

export interface EmptyStateProps extends React.HTMLAttributes<HTMLDivElement> {
  /** Optional icon node (e.g. a lucide-react element). */
  icon?: React.ReactNode;
  title: string;
  description?: string;
  /** Call-to-action button/node (e.g. <Button>Create page</Button>). */
  action?: React.ReactNode;
}

export function EmptyState({
  icon,
  title,
  description,
  action,
  className,
  ...props
}: EmptyStateProps) {
  return (
    <div
      className={clsx(
        "flex flex-col items-center justify-center gap-2 rounded-lg border border-dashed border-border",
        "p-10 text-center",
        className,
      )}
      {...props}
    >
      {icon !== undefined && (
        <div className="mb-1 text-muted-foreground" aria-hidden="true">
          {icon}
        </div>
      )}
      <h3 className="text-base font-semibold text-foreground">{title}</h3>
      {description !== undefined && (
        <p className="max-w-sm text-sm text-muted-foreground">{description}</p>
      )}
      {action !== undefined && <div className="mt-3">{action}</div>}
    </div>
  );
}