Types

export type AlertVariant = 'neutral' | 'accent' | 'success' | 'warning' | 'danger' | 'info';

export type BadgeVariant =
	'neutral' | 'accent' | 'success' | 'warning' | 'danger' | 'info' | 'outline';

export type ButtonSize = 'sm' | 'md' | 'lg' | 'icon' | 'icon-sm';

export type ButtonVariant = 'solid' | 'soft' | 'outline' | 'ghost' | 'link' | 'danger';

export interface Command {
	id: string;
	label: string;
	/** Commands with the same group are listed under one heading. */
	group?: string;
	/** Shown on the right, usually a shortcut. */
	hint?: string;
	/** Extra words that should find this command. */
	keywords?: string[];
	icon?: Snippet;
	disabled?: boolean;
	onselect: () => void;
}

export interface Crumb {
	label: string;
	href?: string;
}

export interface SegmentedOption {
	value: string;
	label: string;
	disabled?: boolean;
}

export interface SelectOption {
	value: string;
	label: string;
	disabled?: boolean;
}

export type TabsVariant = 'line' | 'pill';

export interface TerminalLine {
	/** `command` lines are typed after the prompt; `output` lines appear whole. */
	kind?: 'command' | 'output';
	text: string;
	tone?: 'default' | 'muted' | 'success' | 'accent' | 'warning' | 'danger';
	/** Pause before this line, in milliseconds. Overrides `lineDelay`. */
	delay?: number;
}

export interface TriggerAttrs {
	onclick: (event: MouseEvent) => void;
	'aria-expanded': boolean;
	'aria-haspopup': 'dialog' | 'menu';
}

export type Accent = (typeof accents)[number] | (string & {});

export const accents = ['plum', 'cobalt', 'pine', 'ember', 'gold', 'ink'] as const;

export type ThemeMode = 'light' | 'dark' | 'system';

export interface Toast extends ToastOptions {
	id: string;
	title: string;
	variant: ToastVariant;
	duration: number;
}

export interface ToastOptions {
	title?: string;
	description?: string;
	variant?: ToastVariant;
	/** Milliseconds before it dismisses itself. `0` keeps it until dismissed. */
	duration?: number;
	action?: { label: string; onclick: () => void };
}

export type ToastVariant = 'default' | 'success' | 'warning' | 'danger' | 'info';

export interface ToastOptions {
	title?: string;
	description?: string;
	variant?: ToastVariant;
	/** Milliseconds before it dismisses itself. `0` keeps it until dismissed. */
	duration?: number;
	action?: { label: string; onclick: () => void };
}

export type ToastVariant = 'default' | 'success' | 'warning' | 'danger' | 'info';

export type ToastVariant = 'default' | 'success' | 'warning' | 'danger' | 'info';

export type ClickOutsideParams =
	| Handler
	| {
			handler: Handler;
			/** Presses inside these elements do not count as outside. */
			ignore?: (HTMLElement | null | undefined)[];
	  };

type Handler = (event: PointerEvent) => void;

export interface AnchorParams {
	/** The element the panel should sit next to. */
	to: HTMLElement | null | undefined;
	placement?: Placement;
	/** Gap between anchor and panel, in pixels. */
	offset?: number;
	/** Minimum distance to the viewport edge. */
	padding?: number;
}

export type Placement =
	'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'right';

export type { ClassValue } from 'clsx';

export interface ConfettiOptions {
	/** Where the burst starts: an element's centre, or a point in viewport pixels. */
	origin?: HTMLElement | { x: number; y: number };
	/** Number of pieces. */
	count?: number;
	/** Width of the cone, in degrees. */
	spread?: number;
	/** Middle of the cone, in degrees: -90 is straight up, 0 is to the right. */
	angle?: number;
	/** Launch speed; around 10 clears a button, 16 clears the screen. */
	velocity?: number;
	/** How hard the pieces fall. Below 1 they hang about, above 1 they drop. */
	gravity?: number;
	/** Size of the pieces, as a multiplier. */
	scale?: number;
	/** CSS colours. Defaults to the theme's accent and status colours. */
	colors?: string[];
	/** Milliseconds until every piece has faded. */
	duration?: number;
}

export type Placement =
	'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'right';