freezmo/components/ui.tsx
Martin Dvorak 374752c59e Animation pass: one shared motion language for phones
Mobile only (<=639px / coarse pointers); desktop keeps its behaviour.

Foundation
- lib/motion.ts owns the spring presets (snappy/gentle/sheet), durations,
  easings and variants (screens, tabs, wizard steps, list stagger).
- Native-feel CSS: press feedback scales every button, card, chip, tab,
  row and summary to 0.96 with a spring-like cubic-bezier on transform
  (scoped to phones/coarse pointers), tap-highlight off, touch-action
  manipulation, chrome text non-selectable, reduced motion drops it.
- App shell fades in once on launch; the study feed fades in on phones.

Applied
- Tab bar: sliding active pill (shared layoutId) + icon bounce.
- Study Decks/Homework, language toggle, difficulty and size pickers:
  the same gliding highlight, gated so desktop keeps the old styling.
- Route content enters direction-aware (deeper = from the right, back =
  from the left, same-depth = crossfade) via RouteTransition on the
  library/create/homework content columns; library tab switches
  crossfade; wizard steps slide forward/backward (reduced motion safe).
- Library: cards fade up in a capped stagger on first load, glide with
  layout animations and shrink away on delete (AnimatePresence).
- Study feed: correct feedback pulses, wrong shakes, the progress bar
  settles with a spring curve, score and XP count up on the results.
- Settings sheet uses the sheet spring; the drawer now follows the
  finger and closes on release velocity, like the sheet.
- Generation progress: the stage message fades/slides between stages;
  the icon keeps its gentle wobble; the feed fades in on hand-off.

Skipped, on purpose: LazyMotion (the sliding highlights need layout
animations = domMax, same features the current import already has);
route exit animations (the App Router unmounts the outgoing page —
exits are handled by in-page AnimatePresence); replacing the study
feed's native scroll-snap with finger-follow drag (would fight the
platform scroller); finger-follow height animation for native <details>
expanders.

Verified: animation suite 8/8 (reduced motion + 4x-CPU-throttled trace:
no long tasks, CLS 0.0000), regression 74/74, mobile 52/52, declutter
116/116, i18n 25/25. Lint + build clean. SW freezmo-v21.
2026-10-10 11:01:29 +00:00

162 lines
5 KiB
TypeScript

"use client";
import { forwardRef } from "react";
import { cn } from "@/lib/utils";
type ButtonVariant = "primary" | "secondary" | "ghost" | "danger" | "success";
type ButtonSize = "sm" | "md" | "lg";
/**
* ChatGPT-flavoured buttons: pill-shaped, near-black primary in light mode and
* white in dark mode, quiet secondaries with hairline borders.
*/
const VARIANTS: Record<ButtonVariant, string> = {
primary: "btn-primary",
secondary: "btn-secondary",
ghost: "btn-ghost",
// bg-none strips the primary gradient, which otherwise paints over the
// rose/emerald background-color and wins visually.
danger:
"btn-primary bg-none !bg-rose-600 hover:!bg-rose-700 dark:!bg-rose-500 dark:!text-white dark:hover:!bg-rose-600",
success:
"btn-primary bg-none !bg-emerald-600 hover:!bg-emerald-700 dark:!bg-emerald-500 dark:!text-white dark:hover:!bg-emerald-600",
};
const SIZES: Record<ButtonSize, string> = {
sm: "h-9 px-3.5 text-[13px] rounded-[14px]",
md: "h-10 px-4 text-sm rounded-[14px]",
lg: "h-11 px-5 text-[15px] rounded-[14px]",
};
export type ButtonProps = React.ButtonHTMLAttributes<HTMLButtonElement> & {
variant?: ButtonVariant;
size?: ButtonSize;
loading?: boolean;
};
export const Button = forwardRef<HTMLButtonElement, ButtonProps>(function Button(
{ className, variant = "primary", size = "md", loading, children, disabled, ...props },
ref,
) {
return (
<button
ref={ref}
disabled={disabled || loading}
className={cn(
"inline-flex select-none items-center justify-center whitespace-nowrap font-medium transition disabled:cursor-not-allowed",
VARIANTS[variant],
SIZES[size],
// A visible, muted chip rather than a ghosted primary. Only for an
// explicit `disabled`; a `loading` button stays vivid with its spinner.
disabled && "btn-disabled",
className,
)}
{...props}
>
{loading ? <Spinner className="size-4" /> : null}
{children}
</button>
);
});
export function Spinner({ className }: { className?: string }) {
return (
<svg className={cn("animate-spin", className)} viewBox="0 0 24 24" fill="none" aria-hidden="true">
<circle cx="12" cy="12" r="9" stroke="currentColor" strokeOpacity="0.25" strokeWidth="3" />
<path d="M21 12a9 9 0 0 0-9-9" stroke="currentColor" strokeWidth="3" strokeLinecap="round" />
</svg>
);
}
/** Small neutral pill. Colour is reserved for meaning, not decoration. */
export function Chip({
children,
className,
tone = "neutral",
}: {
children: React.ReactNode;
className?: string;
tone?: "neutral" | "accent" | "success" | "warning" | "danger";
}) {
const tones: Record<string, string> = {
neutral: "bg-[var(--surface-sunken)] text-[var(--text-muted)]",
accent: "bg-accent-500/12 text-accent-700 dark:text-accent-200",
success: "bg-emerald-500/12 text-emerald-700 dark:text-emerald-300",
warning: "bg-amber-500/14 text-amber-800 dark:text-amber-300",
danger: "bg-rose-500/12 text-rose-700 dark:text-rose-300",
};
return (
<span
className={cn(
"inline-flex items-center gap-1.5 rounded-full px-2.5 py-1 text-[12px] font-medium leading-none",
tones[tone],
className,
)}
>
{children}
</span>
);
}
export function ProgressBar({
value,
max,
className,
label,
}: {
value: number;
max: number;
className?: string;
label?: string;
}) {
const percent = max <= 0 ? 0 : Math.min(100, Math.max(0, (value / max) * 100));
return (
<div
className={cn("h-1 w-full overflow-hidden rounded-full bg-[var(--surface-sunken)]", className)}
role="progressbar"
aria-valuenow={Math.round(percent)}
aria-valuemin={0}
aria-valuemax={100}
aria-label={label ?? "Progress"}
>
<div
className="grad-ice h-full rounded-full transition-[width] duration-[420ms] [transition-timing-function:cubic-bezier(0.34,1.56,0.64,1)] motion-reduce:transition-none"
style={{ width: `${percent}%` }}
/>
</div>
);
}
export function EmptyState({
title,
children,
icon,
action,
}: {
title: string;
children?: React.ReactNode;
icon?: React.ReactNode;
action?: React.ReactNode;
}) {
return (
<div className="animate-rise flex flex-col items-center px-6 py-6 text-center sm:py-24">
{icon ? (
<span
className="mb-4 grid size-12 place-items-center rounded-2xl border border-[var(--hairline)] bg-[var(--surface-strong)] text-[var(--text-subtle)]"
aria-hidden
>
{icon}
</span>
) : (
/* eslint-disable-next-line @next/next/no-img-element -- static app icon, no optimisation needed */
<img src="/icons/icon-192.png" alt="" aria-hidden className="mb-4 size-12 rounded-2xl" />
)}
<h2 className="text-[17px] font-semibold tracking-[-0.01em] text-[var(--text)]">{title}</h2>
{children ? (
<p className="mt-2 max-w-md text-sm leading-relaxed text-[var(--text-muted)]">{children}</p>
) : null}
{action ? <div className="mt-6">{action}</div> : null}
</div>
);
}