Button
A D-pad-focusable action. Renders a real <button> with the focusable class, so useDpad walks it and activates it on Enter/Space. Primary wears the accent fill; positive and danger carry the semantic accept and destroy fills; ghost is chrome-less.
Installation
npx @glasskit-ui/cli add buttonInstall the SDK (it provides GlassViewport, useDpad and the stylesheet), then copy these files into your project:
npm install @glasskit-ui/react// components/lib/utils.tsimport { clsx, type ClassValue } from "clsx";import { twMerge } from "tailwind-merge";export type { ClassValue };/** * Merge class names the shadcn way: clsx joins conditionals, tailwind-merge * de-dupes conflicting Tailwind utilities so a consumer's `className` override * wins (e.g. passing `px-2` beats the component's `px-6`). Lens components are * Tailwind utilities + `--gk-*` tokens, so this de-dupe matters. */export function cn(...inputs: ClassValue[]): string { return twMerge(clsx(inputs));}/** * Accessible name from a free-form `label` prop: the label itself when it's a * plain string, otherwise undefined (a ReactNode can't become an aria-label). */export function stringLabel(label: unknown): string | undefined { return typeof label === "string" ? label : undefined;}// components/glasskit/button.tsximport type { ReactNode } from "react";import { cn } from "../lib/utils";/** * <Button> — a D-pad-focusable action. Renders a real <button> carrying * the `focusable` class, so `useDpad()` includes it in spatial navigation * and activates it on Enter/Space (the hook calls `.click()`, which fires * `onClick`). `primary` wears the accent fill; `positive`/`danger` carry the * semantic accept/destroy fills (calls, irreversible confirms); `ghost` is * chrome-less (just text + focus ring + press) for toolbars and icon rows. */export function Button({ children, variant = "secondary", icon, disabled, onClick, type = "button", initialFocus = false, "aria-label": ariaLabel, className,}: { /** The label. Omit for an icon-only button, but then set `aria-label`. */ children?: ReactNode; variant?: "primary" | "secondary" | "ghost" | "positive" | "danger"; /** Optional leading glyph — typically a <Icon>. */ icon?: ReactNode; disabled?: boolean; onClick?: () => void; type?: "button" | "submit" | "reset"; /** Seed the D-pad ring here when the screen mounts (`data-autofocus`). */ initialFocus?: boolean; /** Accessible name — required for an icon-only button. */ "aria-label"?: string; className?: string;}) { return ( <button type={type} disabled={disabled} onClick={onClick} aria-label={ariaLabel} data-autofocus={initialFocus || undefined} className={cn( "focusable press-scale t-body inline-flex items-center justify-center gap-2 rounded-2xl", variant === "primary" ? "btn-primary" : variant === "positive" ? "btn-positive" : variant === "danger" ? "btn-danger" : variant === "ghost" ? "bg-transparent border-0 text-foreground" : "surface", !children ? "p-[13px] [&_svg]:size-[22px]" : "px-6 py-4", className, )} > {icon} {children} </button> );}Usage
<Button variant="primary" onClick={log}> Confirm</Button>Props
| Prop | Type | Default | Description |
|---|---|---|---|
children | ReactNode | — | The label. Omit for an icon-only button, but then set aria-label. |
variant | "primary" | "secondary" | "ghost" | "positive" | "danger" | "secondary" | Primary wears the accent fill; positive and danger carry the accept and destroy fills; ghost is chrome-less. |
icon | ReactNode | — | Optional leading glyph, typically an Icon. |
disabled | boolean | — | Excluded from D-pad focus. |
onClick | () => void | — | Fires on Enter/Space/click. |
type | "button" | "submit" | "reset" | "button" | Native button type. |
initialFocus | boolean | false | Seed the D-pad ring here when the screen mounts (data-autofocus). |
aria-label | string | — | Accessible name, required for an icon-only button. |
className | string | — | Extra classes merged onto the button. |
Icon
Wraps a stroke-only line-icon SVG and applies the two-tier luminance rule: inert = near-white, active = the accent with a faint glow, or an iOS-style gradient plate via `plate`. Token sizes, no inline style.
Pressable
The focusable wrapper for custom UI. Renders a real button carrying the focusable class, so useDpad walks it and fires onPress on Enter or the Neural Band pinch. Use it to make any custom content D-pad-interactive when no first-class component fits.