ui/empty-state.tsx

GitHub
'use client';

import {useRef, useState} from 'react';
import {cva, type VariantProps} from 'class-variance-authority';
import {Icon, Retry, Empty as EmptyGlyph, Failed, NoAccess, NoResults, type GlazeIcon} from '../icon';
import {Button} from './button';
import {cn} from '../lib/utils';

type EmptyReason = 'empty' | 'no-results' | 'no-access' | 'error';

const reasonGlyph: Record<EmptyReason, GlazeIcon> = {empty: EmptyGlyph, 'no-results': NoResults, 'no-access': NoAccess, error: Failed};

const emptyVariants = cva('group/empty flex w-full min-w-0 flex-col items-center gap-3 text-center text-text-1', {
  variants: {
    variant: {
      panel: 'panel forced-colors:border-[CanvasText]',
      plain: '',
    },
    size: {
      default: 'px-4 py-6',
      sm: 'gap-2 px-3 py-4',
    },
  },
  defaultVariants: {variant: 'panel', size: 'default'},
});

type EmptyProps = React.ComponentProps<'div'> & VariantProps<typeof emptyVariants> & {
  reason?: EmptyReason;
};

function Empty({className, reason = 'empty', variant = 'panel', size = 'default', role, ...props}: EmptyProps) {
  return <div
    data-slot="empty"
    data-reason={reason}
    data-size={size}
    role={role ?? (reason === 'error' ? 'alert' : undefined)}
    className={cn(emptyVariants({variant, size}), className)}
    {...props}
  />;
}

function EmptyHeader({className, ...props}: React.ComponentProps<'div'>) {
  return <div data-slot="empty-header" className={cn('flex max-w-(--measure-hint) min-w-0 flex-col items-center gap-1', className)} {...props}/>;
}

type EmptyTitleProps = React.ComponentProps<'h3'> & {
  icon?: GlazeIcon | false;
};

function EmptyTitle({className, icon, children, ...props}: EmptyTitleProps) {
  return <h3 data-slot="empty-title" className={cn('flex min-w-0 flex-col items-center gap-3 type-label text-text-1 group-data-[reason=error]/empty:text-fail-text group-data-[size=sm]/empty:gap-2', className)} {...props}>
    {icon !== false && <EmptyIcon icon={icon}/>}
    <span className="min-w-0 text-pretty">{children}</span>
  </h3>;
}

function EmptyIcon({icon}: {icon?: GlazeIcon}) {
  return <span data-slot="empty-icon" className="flex shrink-0 text-text-3 group-data-[reason=error]/empty:text-fail-text">
    <EmptyReasonGlyph icon={icon}/>
  </span>;
}

function EmptyReasonGlyph({icon}: {icon?: GlazeIcon}) {
  const sized = 'group-data-[size=sm]/empty:size-8';
  if (icon) return <Icon icon={icon} size={40} weight="light" className={sized}/>;
  return <>
    {(Object.keys(reasonGlyph) as EmptyReason[]).map(reason => <Icon key={reason} icon={reasonGlyph[reason]} size={40} weight="light" data-reason={reason} className={cn('hidden', sized, {
      empty: 'group-data-[reason=empty]/empty:block',
      'no-results': 'group-data-[reason=no-results]/empty:block',
      'no-access': 'group-data-[reason=no-access]/empty:block',
      error: 'group-data-[reason=error]/empty:block',
    }[reason])}/>)}
  </>;
}

function EmptyDescription({className, ...props}: React.ComponentProps<'p'>) {
  return <p
    data-slot="empty-description"
    className={cn(
      'type-body-sm text-pretty text-text-2 [&_a]:text-text-1 [&_a]:underline [&_a]:decoration-1 [&_a]:underline-offset-2',
      className,
    )}
    {...props}
  />;
}

function EmptyContent({className, ...props}: React.ComponentProps<'div'>) {
  return <div data-slot="empty-content" className={cn('flex min-w-0 flex-wrap items-center justify-center gap-2', className)} {...props}/>;
}

function EmptyCode({className, ...props}: React.ComponentProps<'code'>) {
  return <code data-slot="empty-code" className={cn('break-all text-text-1 select-all', className)} {...props}/>;
}

const clock = (d: Date) => d.toLocaleTimeString('en-GB', {hour: '2-digit', minute: '2-digit', second: '2-digit', hour12: false});

type EmptyRetryProps = Omit<React.ComponentProps<typeof Button>, 'onClick' | 'pending' | 'children'> & {
  onRetry: () => Promise<unknown>;
  children?: React.ReactNode;
};

function EmptyRetry({onRetry, children = 'Retry', variant = 'secondary', size = 'sm', className, ...props}: EmptyRetryProps) {
  const [pending, setPending] = useState(false);
  const [failed, setFailed] = useState<{attempt: number; at: string} | null>(null);
  const attempts = useRef(0);
  const run = async () => {
    if (pending) return;
    setPending(true);
    try {
      await onRetry();
      setFailed(null);
    } catch {
      attempts.current += 1;
      setFailed({attempt: attempts.current, at: clock(new Date())});
    } finally {
      setPending(false);
    }
  };
  return <span data-slot="empty-retry" className="inline-flex flex-col items-center gap-1">
    <Button variant={variant} size={size} pending={pending} pendingLabel="Retrying" onClick={run} className={className} {...props}>
      <Icon icon={Retry} size={12}/>{children}
    </Button>
    <span role="status" data-slot="empty-retry-status" className="type-caption text-text-2 data empty:hidden">
      {failed && `Retry ${failed.attempt} failed at ${failed.at}`}
    </span>
  </span>;
}

export {Empty, EmptyHeader, EmptyTitle, EmptyDescription, EmptyContent, EmptyCode, EmptyRetry, emptyVariants, type EmptyProps, type EmptyReason, type EmptyRetryProps};