Timace

Suggestions

Install
npm install react-aria-components
components/ui/suggestions.tsx
"use client";

import type { ComponentProps, ReactNode } from "react";
import { Button, type ButtonProps } from "react-aria-components";

const join = (...classes: (string | undefined)[]) => classes.filter(Boolean).join(" ");

const layouts = {
  chips: "flex flex-wrap gap-(--tui-suggestions-gap)",
  cards: "grid grid-cols-[repeat(auto-fit,minmax(min(100%,var(--tui-suggestions-card-width)),1fr))] gap-(--tui-suggestions-gap)",
};

const base =
  "group/suggestion cursor-default border-solid border-(length:--tui-suggestions-border-width) border-(--tui-suggestions-border) bg-(--tui-suggestions-bg) text-left font-(family-name:--tui-font) text-(--tui-suggestions-fg) outline-none transition-colors duration-(--tui-duration) data-disabled:opacity-(--tui-suggestions-disabled-opacity) data-focus-visible:[outline:var(--tui-suggestions-ring-width)_solid_var(--tui-suggestions-ring)] data-focus-visible:[outline-offset:var(--tui-suggestions-ring-offset)] data-hovered:border-(--tui-suggestions-border-hover) data-hovered:bg-(--tui-suggestions-bg-hover) data-pressed:bg-(--tui-suggestions-bg-pressed)";

const shapes = {
  chips: "inline-flex min-h-(--tui-suggestions-height) items-center gap-1.5 rounded-(--tui-suggestions-radius) px-(--tui-suggestions-padding-x) py-1 text-(length:--tui-suggestions-font-size) leading-tight font-(--tui-suggestions-font-weight) [&_svg]:size-3.5 [&_svg]:shrink-0 [&_svg]:text-(--tui-suggestions-muted)",
  cards: "flex flex-col gap-(--tui-suggestions-card-gap) rounded-(--tui-suggestions-card-radius) p-(--tui-suggestions-card-padding)",
};

export interface SuggestionsProps extends ComponentProps<"div"> {
  /** Chips are one line each. Cards have room for an icon and a description. */
  layout?: keyof typeof layouts;
}

/** A set of prompts to start from. Give it an aria-label that says what they are. */
export function Suggestions({ layout = "chips", className, ...props }: SuggestionsProps) {
  return <div role="group" data-layout={layout} {...props} className={join("group/suggestions font-(family-name:--tui-font)", layouts[layout], className)} />;
}

export interface SuggestionProps extends Omit<ButtonProps, "className" | "children"> {
  /** Match the layout of the Suggestions it is in. */
  layout?: keyof typeof shapes;
  icon?: ReactNode;
  /** The prompt, or a short title for it. */
  children: ReactNode;
  /** Cards only: a line about what it will do. */
  description?: ReactNode;
  className?: string;
}

/** One prompt. Pressing it should send it, or put it in the composer. */
export function Suggestion({ layout = "chips", icon, children, description, className, ...props }: SuggestionProps) {
  if (layout === "cards") {
    return (
      <Button data-slot="suggestion-card" {...props} className={join(base, shapes.cards, className)}>
        <span className="flex items-start justify-between gap-2">
          {icon ? <span className="flex size-(--tui-suggestions-icon-size) items-center justify-center rounded-[calc(var(--tui-suggestions-card-radius)_*_0.55)] bg-(--tui-suggestions-icon-bg) text-(--tui-suggestions-icon-fg) [&_svg]:size-[52%]">{icon}</span> : <span />}
          {/* Where it goes, shown when it is about to be pressed. */}
          <svg aria-hidden viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" className="size-4 shrink-0 -translate-x-0.5 translate-y-0.5 text-(--tui-suggestions-muted) opacity-0 transition-[opacity,translate] duration-(--tui-duration) group-data-focus-visible/suggestion:translate-0 group-data-focus-visible/suggestion:opacity-100 group-data-hovered/suggestion:translate-0 group-data-hovered/suggestion:opacity-100">
            <path d="M5 11l6-6M6 5h5v5" />
          </svg>
        </span>
        <span className="flex flex-col gap-1">
          <span className="text-(length:--tui-suggestions-title-size) leading-tight font-(--tui-suggestions-title-weight)">{children}</span>
          {description && <span className="text-(length:--tui-suggestions-font-size) leading-snug text-(--tui-suggestions-muted)">{description}</span>}
        </span>
      </Button>
    );
  }
  return (
    <Button data-slot="suggestion" {...props} className={join(base, shapes.chips, className)}>
      {icon}
      {children}
    </Button>
  );
}
styles/timace-ui.css
:root {
  color-scheme: light;
  --tui-bg: #ffffff;
  --tui-fg: #0a0a0a;
  --tui-muted: #f5f5f5;
  --tui-muted-fg: #737373;
  --tui-border: #e5e5e5;
  --tui-primary: #171717;
  --tui-primary-fg: #fafafa;
  --tui-ring: #a3a3a3;
  --tui-success: #16a34a;
  --tui-warning: #d97706;
  --tui-danger: #dc2626;
  --tui-radius: 8px;
  --tui-border-width: 1px;
  --tui-space: 4px;
  --tui-shadow: none;
  --tui-font: ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
  --tui-text: 14px;
  --tui-duration: 150ms;

  /* Suggestions */
  --tui-suggestions-gap: calc(var(--tui-space) * 2);
  --tui-suggestions-border-width: var(--tui-border-width);
  --tui-suggestions-font-size: var(--tui-text);
  --tui-suggestions-bg: var(--tui-bg);
  --tui-suggestions-fg: var(--tui-fg);
  --tui-suggestions-muted: var(--tui-muted-fg);
  --tui-suggestions-border: var(--tui-border);
  --tui-suggestions-card-width: 180px;
  --tui-suggestions-card-padding: calc(var(--tui-space) * 4);
  --tui-suggestions-card-gap: calc(var(--tui-space) * 5);
  --tui-suggestions-icon-size: calc(var(--tui-space) * 9);
  --tui-suggestions-card-radius: calc(var(--tui-radius) * 1.75);
  --tui-suggestions-title-size: var(--tui-text);
  --tui-suggestions-title-weight: 500;
  --tui-suggestions-icon-bg: var(--tui-muted);
  --tui-suggestions-icon-fg: var(--tui-fg);
  --tui-suggestions-height: calc(var(--tui-space) * 8);
  --tui-suggestions-padding-x: calc(var(--tui-space) * 3);
  --tui-suggestions-radius: 999px;
  --tui-suggestions-font-weight: 400;
  --tui-suggestions-bg-hover: var(--tui-muted);
  --tui-suggestions-border-hover: color-mix(in oklab, var(--tui-border) 55%, var(--tui-fg));
  --tui-suggestions-bg-pressed: color-mix(in oklab, var(--tui-muted) 60%, var(--tui-border));
  --tui-suggestions-ring: var(--tui-ring);
  --tui-suggestions-ring-width: 2px;
  --tui-suggestions-ring-offset: 2px;
  --tui-suggestions-disabled-opacity: 0.5;
}

.dark,
[data-theme="dark"] {
  color-scheme: dark;
  --tui-bg: #0a0a0a;
  --tui-fg: #fafafa;
  --tui-muted: #1c1c1c;
  --tui-muted-fg: #a3a3a3;
  --tui-border: #2a2a2a;
  --tui-primary: #fafafa;
  --tui-primary-fg: #171717;
  --tui-ring: #737373;
  --tui-success: #22c55e;
  --tui-warning: #f59e0b;
  --tui-danger: #ef4444;
}

Needs Tailwind CSS v4. Import the stylesheet once, after Tailwind.