Deliberate confirm
Adds friction to risky actions in two modes. Slide: drag a round knob along a pill track that fills behind it; letting go before 90% springs it back, reaching the end locks it with a check and a green track. Hold: press and hold a button whose background fills over a set time and drains back at double speed if released early. A tick ruler under both lights segment by segment. onConfirm may return a promise, which shows a spinner until it settles and then success or an inline error with Retry. An optional Undo appears for a set window, after which it resets or stays done. The slider works with arrow keys, End or Enter and Escape, the hold button with Space or Enter, touch works through pointer capture, the result is announced, and reduced motion swaps the spring for a snap.
Source
"use client";
import {
useCallback, useEffect, useId, useLayoutEffect, useRef, useState,
type KeyboardEvent, type PointerEvent, type ReactNode,
} from "react";
import { AlertTriangle, Check, ChevronsRight, Loader2 } from "lucide-react";
import { cn } from "@/lib/utils";
type Status = "idle" | "pending" | "done" | "error";
export type DeliberateConfirmProps = {
/** "slide": drag a knob to the end. "hold": press and hold a button. */
mode?: "slide" | "hold";
label: ReactNode;
confirmedLabel?: ReactNode;
tone?: "primary" | "destructive";
/** How long the hold takes to fill, in milliseconds. */
holdMs?: number;
/** May return a promise: a spinner shows until it settles, then success or an error with retry. */
onConfirm: () => unknown;
disabled?: boolean;
/** Shows an Undo button for this long after confirming. */
undoWindowMs?: number;
onUndo?: () => void;
/** Return to the start once the undo window (or a short pause) has passed, instead of staying done. */
resetAfter?: boolean;
/** Message for a failed onConfirm. */
errorLabel?: ReactNode;
className?: string;
};
const TICKS = 24;
const KNOB = 44;
const PAD = 4;
function prefersReducedMotion() {
return typeof window !== "undefined" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
}
function Ruler({ value, status, tone }: { value: number; status: Status; tone: "primary" | "destructive" }) {
const lit = Math.round(value * TICKS);
return (
<div aria-hidden="true" className="mt-2 flex h-2.5 items-end justify-between px-1">
{Array.from({ length: TICKS + 1 }, (_, i) => (
<span
key={i}
className={cn(
"w-px rounded-full motion-safe:transition-colors",
i % 4 === 0 ? "h-2.5" : "h-1.5",
i <= lit && value > 0
? status === "done" ? "bg-emerald-500" : tone === "destructive" ? "bg-destructive" : "bg-primary"
: "bg-border",
)}
/>
))}
</div>
);
}
export function DeliberateConfirm({
mode = "slide", label, confirmedLabel = "Confirmed", tone = "primary", holdMs = 1200, onConfirm, disabled = false,
undoWindowMs, onUndo, resetAfter = false, errorLabel = "That did not go through.", className,
}: DeliberateConfirmProps) {
const [value, setValue] = useState(0);
const [status, setStatus] = useState<Status>("idle");
const [undoOpen, setUndoOpen] = useState(false);
const [announce, setAnnounce] = useState("");
const [dragging, setDragging] = useState(false);
const valueRef = useRef(0);
const frame = useRef(0);
const timers = useRef<number[]>([]);
const trackRef = useRef<HTMLDivElement>(null);
const [trackWidth, setTrackWidth] = useState(320);
const drag = useRef({ startX: 0, startValue: 0 });
const holdDir = useRef<0 | 1 | -1>(0);
const hintId = useId();
const errorId = useId();
const set = useCallback((next: number) => {
valueRef.current = Math.min(1, Math.max(0, next));
setValue(valueRef.current);
}, []);
const stop = () => cancelAnimationFrame(frame.current);
const later = (fn: () => void, ms: number) => { timers.current.push(window.setTimeout(fn, ms)); };
useEffect(() => () => { stop(); timers.current.forEach(clearTimeout); }, []);
useLayoutEffect(() => {
const el = trackRef.current;
if (!el) return;
const measure = () => setTrackWidth(el.clientWidth);
measure();
const observer = new ResizeObserver(measure);
observer.observe(el);
return () => observer.disconnect();
}, [mode]);
const reset = useCallback(() => {
stop();
holdDir.current = 0;
setStatus("idle");
setUndoOpen(false);
setAnnounce("");
if (prefersReducedMotion() || mode === "hold") { set(0); return; }
// A small spring back to the start: stiffness pulls, damping settles.
let v = 0;
let last = performance.now();
const step = (now: number) => {
const dt = Math.min(0.032, (now - last) / 1000);
last = now;
v += (-260 * valueRef.current - 24 * v) * dt;
const next = valueRef.current + v * dt;
if (Math.abs(next) < 0.002 && Math.abs(v) < 0.02) { set(0); return; }
set(next);
frame.current = requestAnimationFrame(step);
};
frame.current = requestAnimationFrame(step);
}, [mode, set]);
const finish = useCallback(() => {
setStatus("done");
setAnnounce("Confirmed");
if (undoWindowMs) {
setUndoOpen(true);
later(() => { setUndoOpen(false); if (resetAfter) reset(); }, undoWindowMs);
} else if (resetAfter) {
later(reset, 1600);
}
}, [undoWindowMs, resetAfter, reset]);
const complete = useCallback(async () => {
stop();
holdDir.current = 0;
set(1);
let result: unknown;
try {
result = onConfirm();
} catch {
setStatus("error");
setAnnounce("Failed");
return;
}
if (result && typeof (result as Promise<unknown>).then === "function") {
setStatus("pending");
setAnnounce("Working");
try {
await result;
} catch {
setStatus("error");
setAnnounce("Failed");
return;
}
}
finish();
}, [onConfirm, finish, set]);
const locked = disabled || status !== "idle";
const toneFill = tone === "destructive" ? "bg-destructive" : "bg-primary";
const toneText = tone === "destructive" ? "text-destructive" : "text-primary";
/* ---------- slide ---------- */
const travel = Math.max(1, trackWidth - KNOB - PAD * 2);
function onPointerDown(event: PointerEvent<HTMLDivElement>) {
if (locked || event.button !== 0) return;
stop();
event.currentTarget.setPointerCapture(event.pointerId);
drag.current = { startX: event.clientX, startValue: valueRef.current };
setDragging(true);
}
function onPointerMove(event: PointerEvent<HTMLDivElement>) {
if (!dragging) return;
set(drag.current.startValue + (event.clientX - drag.current.startX) / travel);
}
function onPointerUp() {
if (!dragging) return;
setDragging(false);
if (valueRef.current >= 0.9) void complete();
else reset();
}
function onSliderKey(event: KeyboardEvent<HTMLDivElement>) {
if (event.key === "Escape") { event.preventDefault(); if (status !== "pending") reset(); return; }
if (locked) return;
const moves: Record<string, number> = { ArrowRight: 0.1, ArrowUp: 0.1, ArrowLeft: -0.1, ArrowDown: -0.1 };
if (event.key in moves) {
event.preventDefault();
stop();
const next = Math.round((valueRef.current + moves[event.key]) * 10) / 10;
if (next >= 1) void complete();
else set(next);
} else if (event.key === "End" || event.key === "Enter") {
event.preventDefault();
void complete();
} else if (event.key === "Home") {
event.preventDefault();
set(0);
}
}
/* ---------- hold ---------- */
const runHold = useCallback(() => {
stop();
let last = performance.now();
const step = (now: number) => {
const dt = now - last;
last = now;
const dir = holdDir.current;
if (dir === 0) return;
const next = valueRef.current + (dir === 1 ? dt / holdMs : -(dt * 2) / holdMs);
if (next >= 1) { void complete(); return; }
if (next <= 0) { set(0); holdDir.current = 0; return; }
set(next);
frame.current = requestAnimationFrame(step);
};
frame.current = requestAnimationFrame(step);
}, [holdMs, complete, set]);
function startHold() {
if (locked || holdDir.current === 1) return;
holdDir.current = 1;
runHold();
}
function endHold() {
if (holdDir.current !== 1) return;
if (prefersReducedMotion()) { holdDir.current = 0; stop(); set(0); return; }
holdDir.current = -1;
runHold();
}
const done = status === "done";
const pending = status === "pending";
const failed = status === "error";
const pct = Math.round(value * 100);
const footer = (failed || (done && undoOpen)) && (
<div className="mt-1 flex min-h-7 items-center justify-between gap-3 text-sm">
{failed ? (
<p id={errorId} className="flex items-center gap-1.5 text-destructive">
<AlertTriangle className="size-3.5 shrink-0" aria-hidden="true" />
{errorLabel}
</p>
) : <span />}
{failed && (
<button
type="button"
onClick={() => void complete()}
className="rounded-md px-2 py-1 font-medium text-foreground underline underline-offset-4 outline-none hover:bg-accent focus-visible:ring-2 focus-visible:ring-ring"
>
Retry
</button>
)}
{done && undoOpen && (
<button
type="button"
onClick={() => { timers.current.forEach(clearTimeout); onUndo?.(); reset(); }}
className="rounded-md px-2 py-1 font-medium text-muted-foreground underline underline-offset-4 outline-none hover:bg-accent hover:text-foreground focus-visible:ring-2 focus-visible:ring-ring"
>
Undo
</button>
)}
</div>
);
const live = <span role="status" aria-live="polite" className="sr-only">{announce}</span>;
if (mode === "hold") {
return (
<div className={cn("w-full max-w-sm", className)}>
<button
type="button"
disabled={disabled}
aria-describedby={failed ? `${hintId} ${errorId}` : hintId}
aria-disabled={locked || undefined}
onPointerDown={(event) => { if (event.button === 0) { event.currentTarget.setPointerCapture(event.pointerId); startHold(); } }}
onPointerUp={endHold}
onPointerCancel={endHold}
onContextMenu={(event) => event.preventDefault()}
onKeyDown={(event) => { if ((event.key === " " || event.key === "Enter") && !event.repeat) { event.preventDefault(); startHold(); } }}
onKeyUp={(event) => { if (event.key === " " || event.key === "Enter") endHold(); }}
onBlur={endHold}
className={cn(
"relative isolate flex h-12 w-full touch-none select-none items-center justify-center overflow-hidden rounded-xl border bg-card px-5 font-medium text-foreground shadow-sm",
"outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background",
"disabled:cursor-not-allowed disabled:opacity-50",
done && "border-emerald-600 bg-emerald-600 text-white",
)}
>
<span
aria-hidden="true"
className={cn("absolute inset-y-0 left-0 -z-10", done ? "bg-emerald-600" : toneFill)}
style={{ width: `${pct}%` }}
/>
<span
className={cn(
"relative flex items-center gap-2",
value > 0.5 && !done && "text-primary-foreground",
value > 0.5 && !done && tone === "destructive" && "text-white",
)}
>
{pending ? <Loader2 className="size-4 motion-safe:animate-spin" aria-hidden="true" />
: done ? <Check className="size-4" aria-hidden="true" /> : null}
{done ? confirmedLabel : label}
</span>
</button>
<span id={hintId} className="sr-only">Press and hold to confirm</span>
<Ruler value={value} status={status} tone={tone} />
{footer}
{live}
</div>
);
}
const knobX = value * travel;
return (
<div className={cn("w-full max-w-sm", className)}>
<div
ref={trackRef}
className={cn(
"relative isolate h-[52px] w-full select-none overflow-hidden rounded-full border bg-muted",
done && "border-emerald-600 bg-emerald-600",
disabled && "opacity-50",
)}
>
<span
aria-hidden="true"
className={cn("absolute inset-y-0 left-0 rounded-full", done ? "bg-emerald-600" : toneFill)}
style={{ width: knobX + KNOB + PAD * 2, opacity: value > 0 || done ? 1 : 0 }}
/>
<span
aria-hidden="true"
className={cn(
"pointer-events-none absolute inset-0 flex items-center justify-center pl-12 pr-4 text-sm font-medium",
done ? "text-white" : "text-muted-foreground",
)}
style={{ opacity: done ? 1 : Math.max(0, 1 - value * 1.6) }}
>
<span className="truncate">{done ? confirmedLabel : label}</span>
</span>
<div
role="slider"
tabIndex={disabled ? -1 : 0}
aria-label={typeof label === "string" ? label : "Slide the handle to confirm"}
aria-valuemin={0}
aria-valuemax={100}
aria-valuenow={pct}
aria-valuetext={done ? "Confirmed" : pending ? "Working" : failed ? "Failed" : `${pct}%`}
aria-disabled={disabled || undefined}
aria-describedby={failed ? errorId : undefined}
onPointerDown={onPointerDown}
onPointerMove={onPointerMove}
onPointerUp={onPointerUp}
onPointerCancel={onPointerUp}
onKeyDown={onSliderKey}
className={cn(
"absolute top-1 grid touch-none place-items-center rounded-full bg-background shadow-md ring-1 ring-black/5",
"outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-muted",
locked ? "cursor-default" : dragging ? "cursor-grabbing" : "cursor-grab",
)}
style={{ left: PAD, width: KNOB, height: KNOB, transform: `translateX(${knobX}px)` }}
>
{pending ? <Loader2 className={cn("size-5 motion-safe:animate-spin", toneText)} aria-hidden="true" />
: done ? <Check className="size-5 text-emerald-600" strokeWidth={2.75} aria-hidden="true" />
: failed ? <AlertTriangle className="size-5 text-destructive" aria-hidden="true" />
: <ChevronsRight className={cn("size-5", toneText)} aria-hidden="true" />}
</div>
</div>
<Ruler value={value} status={status} tone={tone} />
{footer}
{live}
</div>
);
}
