@fiestaboard/ui 3.0.1 → 3.1.0

package/dist/components/forms/time-picker.js

@@ -0,0 +1,260 @@
+"use client";
+import { cn as e } from "../../lib/utils.js";
+import { Button as t } from "./button.js";
+import { Flex as n } from "../layout/flex.js";
+import { Popover as r, PopoverContent as i, PopoverTrigger as a } from "../overlays/popover.js";
+import { Text as o } from "../typography/text.js";
+import { Clock as s } from "lucide-react";
+import * as c from "react";
+import { Fragment as l, jsx as u, jsxs as d } from "react/jsx-runtime";
+//#region src/components/forms/time-picker.tsx
+var f = /^(\d{1,2}):(\d{1,2})$/, p = {
+	hours: "00",
+	minutes: "00"
+};
+function m(e) {
+	if (!e) return null;
+	let t = f.exec(e.trim());
+	if (!t) return null;
+	let n = Number(t[1]), r = Number(t[2]);
+	return n > 23 || r > 59 ? null : {
+		hours: String(n).padStart(2, "0"),
+		minutes: String(r).padStart(2, "0")
+	};
+}
+function h({ hours: e, minutes: t }, n, r, i) {
+	if (n === "24") return `${e}:${t}`;
+	let a = Number(e), o = a >= 12 ? i : r;
+	return `${a % 12 == 0 ? 12 : a % 12}:${t} ${o}`;
+}
+function g(e, t, n, r) {
+	return t === "24" ? String(e).padStart(2, "0") : `${e % 12 == 0 ? 12 : e % 12} ${e >= 12 ? r : n}`;
+}
+var _ = [
+	"08:00",
+	"12:00",
+	"18:00",
+	"20:00",
+	"00:00"
+], v = "[role=\"option\"]";
+function y(e, t) {
+	let n = e.findIndex((e) => e.value === t);
+	if (n >= 0) return n;
+	let r = Number(t), i = 0;
+	for (let t = 1; t < e.length; t += 1) Math.abs(Number(e[t].value) - r) < Math.abs(Number(e[i].value) - r) && (i = t);
+	return i;
+}
+var b = {
+	panel: "Choose a time",
+	hour: "Hour",
+	minute: "Minute",
+	quickPresets: "Quick presets",
+	am: "AM",
+	pm: "PM"
+};
+function x({ value: n, defaultValue: o = "", onValueChange: l, placeholder: f = "00:00", className: g, contentClassName: _, disabled: v, id: y, "aria-label": x, "aria-labelledby": C, "aria-describedby": w, "aria-invalid": T, hourCycle: E = "12", minuteStep: D = 5, presets: O, labels: k, defaultOpen: A = !1, open: j, onOpenChange: M, ref: N }) {
+	let [P, F] = c.useState(A), I = j ?? P, [L, R] = c.useState(o), z = n ?? L, B = c.useId(), V = {
+		...b,
+		...k
+	}, H = m(z), U = H ?? p, W = (e) => {
+		j === void 0 && F(e), M?.(e);
+	}, G = (e) => {
+		n === void 0 && R(e), l?.(e);
+	}, K = H ? h(H, E, V.am, V.pm) : f, q = `${B}-value`, J = `${B}-label`, Y = C ?? (x ? J : void 0);
+	return /* @__PURE__ */ d(r, {
+		open: I,
+		onOpenChange: W,
+		children: [/* @__PURE__ */ u(a, {
+			asChild: !0,
+			children: /* @__PURE__ */ d(t, {
+				ref: N,
+				id: y,
+				type: "button",
+				variant: "outline",
+				disabled: v,
+				"aria-labelledby": Y ? `${Y} ${q}` : void 0,
+				"aria-describedby": w,
+				"aria-invalid": T,
+				className: e("h-9 w-full justify-start px-3 text-sm font-normal", !H && "text-muted-foreground", g),
+				children: [
+					/* @__PURE__ */ u(s, {
+						className: "size-4",
+						"aria-hidden": "true"
+					}),
+					x && !C ? /* @__PURE__ */ u("span", {
+						id: J,
+						className: "sr-only",
+						children: x
+					}) : null,
+					/* @__PURE__ */ u("span", {
+						id: q,
+						children: K
+					})
+				]
+			})
+		}), /* @__PURE__ */ u(i, {
+			className: e("w-64", _),
+			align: "start",
+			label: V.panel,
+			children: I ? /* @__PURE__ */ u(S, {
+				baseId: B,
+				parts: U,
+				hasValue: H !== null,
+				hourCycle: E,
+				minuteStep: D,
+				presets: O,
+				text: V,
+				onChange: G,
+				onClose: () => W(!1)
+			}) : null
+		})]
+	});
+}
+function S({ baseId: e, parts: r, hasValue: i, hourCycle: a, minuteStep: s, presets: f, text: y, onChange: b, onClose: x }) {
+	let S = c.useRef(null), w = c.useMemo(() => Array.from({ length: 24 }, (e, t) => ({
+		value: String(t).padStart(2, "0"),
+		label: g(t, a, y.am, y.pm)
+	})), [
+		a,
+		y.am,
+		y.pm
+	]), T = c.useMemo(() => {
+		let e = Math.min(60, Math.max(1, Math.floor(s) || 1));
+		return Array.from({ length: Math.ceil(60 / e) }, (t, n) => {
+			let r = String(n * e).padStart(2, "0");
+			return {
+				value: r,
+				label: r
+			};
+		});
+	}, [s]), E = c.useMemo(() => (f ?? _.map((e) => ({ value: e }))).filter((e) => m(e.value) !== null), [f]);
+	c.useEffect(() => {
+		let e = requestAnimationFrame(() => {
+			S.current?.querySelector(`${v}[tabindex="0"]`)?.focus({ preventScroll: !0 });
+		});
+		return () => cancelAnimationFrame(e);
+	}, []);
+	let D = `${e}-hour`, O = `${e}-minute`, k = `${e}-presets`;
+	return /* @__PURE__ */ d(l, { children: [/* @__PURE__ */ d(n, {
+		gap: "4",
+		children: [/* @__PURE__ */ d("div", {
+			className: "flex-1",
+			ref: S,
+			children: [/* @__PURE__ */ u(o, {
+				as: "span",
+				id: D,
+				size: "xs",
+				weight: "medium",
+				tone: "muted",
+				className: "mb-2 block",
+				children: y.hour
+			}), /* @__PURE__ */ u(C, {
+				labelId: D,
+				options: w,
+				selected: r.hours,
+				onSelect: (e) => b(`${e}:${r.minutes}`)
+			})]
+		}), /* @__PURE__ */ d("div", {
+			className: "flex-1",
+			children: [/* @__PURE__ */ u(o, {
+				as: "span",
+				id: O,
+				size: "xs",
+				weight: "medium",
+				tone: "muted",
+				className: "mb-2 block",
+				children: y.minute
+			}), /* @__PURE__ */ u(C, {
+				labelId: O,
+				options: T,
+				selected: r.minutes,
+				onSelect: (e) => b(`${r.hours}:${e}`)
+			})]
+		})]
+	}), E.length > 0 && /* @__PURE__ */ d("div", {
+		className: "mt-4 border-t pt-4",
+		children: [/* @__PURE__ */ u(o, {
+			as: "span",
+			id: k,
+			size: "xs",
+			weight: "medium",
+			tone: "muted",
+			className: "mb-2 block",
+			children: y.quickPresets
+		}), /* @__PURE__ */ u(n, {
+			gap: "2",
+			wrap: !0,
+			role: "group",
+			"aria-labelledby": k,
+			children: E.map((e) => {
+				let n = m(e.value) ?? p, o = `${n.hours}:${n.minutes}`;
+				return /* @__PURE__ */ u(t, {
+					type: "button",
+					variant: "outline",
+					size: "sm",
+					"aria-current": i && o === `${r.hours}:${r.minutes}` ? !0 : void 0,
+					onClick: () => {
+						b(o), x();
+					},
+					className: "h-7 px-2 text-xs aria-[current=true]:bg-accent aria-[current=true]:text-accent-foreground",
+					children: e.label ?? h(n, a, y.am, y.pm)
+				}, e.value);
+			})
+		})]
+	})] });
+}
+function C({ labelId: t, options: n, selected: r, onSelect: i }) {
+	let a = c.useRef(null), o = y(n, r);
+	c.useEffect(() => {
+		let e = a.current, t = e?.querySelectorAll(v)[o];
+		if (!e || !t) return;
+		let n = e.getBoundingClientRect(), r = t.getBoundingClientRect();
+		e.scrollTop += r.top - n.top - (e.clientHeight - r.height) / 2;
+	}, []);
+	let s = (e) => {
+		let t = Math.max(0, Math.min(n.length - 1, e));
+		i(n[t].value), (a.current?.querySelectorAll(v))?.[t]?.focus();
+	}, l = (e, t) => {
+		switch (e.key) {
+			case "ArrowDown":
+				e.preventDefault(), s(t + 1);
+				break;
+			case "ArrowUp":
+				e.preventDefault(), s(t - 1);
+				break;
+			case "PageDown":
+				e.preventDefault(), s(t + 5);
+				break;
+			case "PageUp":
+				e.preventDefault(), s(t - 5);
+				break;
+			case "Home":
+				e.preventDefault(), s(0);
+				break;
+			case "End":
+				e.preventDefault(), s(n.length - 1);
+				break;
+			case "Enter":
+			case " ": e.preventDefault(), i(n[t].value);
+		}
+	};
+	return /* @__PURE__ */ u("div", {
+		ref: a,
+		role: "listbox",
+		"aria-labelledby": t,
+		className: "max-h-48 overflow-y-auto rounded-md border bg-background",
+		children: n.map((t, n) => /* @__PURE__ */ u("div", {
+			role: "option",
+			"aria-selected": t.value === r,
+			tabIndex: n === o ? 0 : -1,
+			onClick: () => i(t.value),
+			onKeyDown: (e) => l(e, n),
+			className: e("cursor-default px-3 py-2 text-left text-sm transition-colors duration-control", "hover:bg-accent hover:text-accent-foreground", "outline-none focus:bg-accent focus:text-accent-foreground focus:ring-[3px] focus:ring-inset focus:ring-ring/50", t.value === r && "bg-accent font-medium text-accent-foreground"),
+			children: t.label
+		}, t.value))
+	});
+}
+//#endregion
+export { x as TimePicker };
+
+//# sourceMappingURL=time-picker.js.map

package/dist/components/forms/time-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-picker.js","names":[],"sources":["../../../src/components/forms/time-picker.tsx"],"mappings":"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"}

package/dist/components/forms/toggle-card.d.ts

@@ -0,0 +1,120 @@
+import { type VariantProps } from "class-variance-authority";
+import * as React from "react";
+/**
+ * A `radiogroup` has no implicit label, so axe (and every screen reader)
+ * needs one from the call site. Requiring it in the type means a group can
+ * never ship nameless: pass `aria-label`, or `aria-labelledby` pointing at
+ * the heading/`<Label>` that already introduces the options.
+ */
+export type SelectionGroupNameProps = {
+    "aria-label": string;
+    "aria-labelledby"?: string;
+} | {
+    "aria-labelledby": string;
+    "aria-label"?: string;
+};
+export interface SelectionGroupBaseProps {
+    /** Selected option value (controlled). Pair with `onValueChange`. */
+    value?: string | null;
+    /** Initially selected option value (uncontrolled). */
+    defaultValue?: string | null;
+    /** Fired with the newly selected value. Selection is never emptied. */
+    onValueChange?: (value: string) => void;
+    /** Disables every option in the group. */
+    disabled?: boolean;
+    /** Form field name — each option renders a hidden radio input under it. */
+    name?: string;
+    /** id of the form that owns the group, when rendered outside it. */
+    form?: string;
+    /** Marks the group required for form validation. */
+    required?: boolean;
+}
+declare const toggleCardGroupVariants: (props?: ({
+    columns?: "1" | "2" | "3" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare const toggleCardVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    align?: "start" | "center" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type ToggleCardSize = NonNullable<VariantProps<typeof toggleCardVariants>["size"]>;
+type ToggleCardAlign = NonNullable<VariantProps<typeof toggleCardVariants>["align"]>;
+export type ToggleCardGroupProps = SelectionGroupBaseProps & SelectionGroupNameProps & VariantProps<typeof toggleCardGroupVariants> & {
+    /** Size applied to every card in the group; a card may override it. */
+    size?: ToggleCardSize;
+    /** Content alignment applied to every card in the group. */
+    align?: ToggleCardAlign;
+    /** Show the selected-check on every card in the group. @default true */
+    indicator?: boolean;
+    className?: string;
+    children?: React.ReactNode;
+} & Omit<React.ComponentProps<"div">, "defaultValue" | "onChange">;
+/**
+ * Single-select group of {@link ToggleCard}s — a real `radiogroup`.
+ *
+ * One tab stop for the whole group; arrow keys move the selection and wrap.
+ * Cards inside it take their state from the group's `value`, so they need a
+ * `value` of their own and must NOT be given `pressed`.
+ */
+declare function ToggleCardGroup({ className, columns, size, align, indicator, children, ...props }: ToggleCardGroupProps): React.JSX.Element;
+export type ToggleCardProps = Omit<React.ComponentProps<"button">, "value" | "title"> & VariantProps<typeof toggleCardVariants> & {
+    /** Identifies the card inside a {@link ToggleCardGroup}. */
+    value?: string;
+    /** Standalone toggle state — only outside a group. Pair with `onPressedChange`. */
+    pressed?: boolean;
+    onPressedChange?: (pressed: boolean) => void;
+    /** Leading icon (a lucide element); sized to 16px unless it sets its own. */
+    icon?: React.ReactNode;
+    /** Primary label. Provides the card's accessible name. */
+    title?: React.ReactNode;
+    /** Secondary line under the title. */
+    description?: React.ReactNode;
+    /** Trailing content on the title row — a badge, a size indicator, a price. */
+    meta?: React.ReactNode;
+    /**
+     * Render a check in the corner when selected, so selection is not carried
+     * by hue alone. @default true
+     */
+    indicator?: boolean;
+    /** Extra body content below the title row — a preview, a thumbnail row. */
+    children?: React.ReactNode;
+};
+/**
+ * A large selectable tile: optional icon, title, description and preview
+ * body.
+ *
+ * Inside a {@link ToggleCardGroup} it is a `radio` (`aria-checked`, roving
+ * tabindex, arrow-key navigation). On its own, with `pressed`, it is a
+ * toggle button (`aria-pressed`). See the note at the top of this file.
+ */
+declare function ToggleCard({ className, size, align, value, pressed, onPressedChange, icon, title, description, meta, indicator, children, ...props }: ToggleCardProps): React.JSX.Element;
+declare const segmentedControlVariants: (props?: ({
+    wrap?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare const segmentedControlItemVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type SegmentedControlSize = NonNullable<VariantProps<typeof segmentedControlItemVariants>["size"]>;
+export type SegmentedControlProps = SelectionGroupBaseProps & SelectionGroupNameProps & VariantProps<typeof segmentedControlVariants> & {
+    /** Size applied to every item; an item may override it. */
+    size?: SegmentedControlSize;
+    className?: string;
+    children?: React.ReactNode;
+} & Omit<React.ComponentProps<"div">, "defaultValue" | "onChange">;
+/**
+ * Compact single-select pill row — the toolbar-scale sibling of
+ * {@link ToggleCardGroup}, with the same `radiogroup` semantics.
+ */
+declare function SegmentedControl({ className, size, wrap, children, ...props }: SegmentedControlProps): React.JSX.Element;
+export type SegmentedControlItemProps = Omit<React.ComponentProps<"button">, "value"> & VariantProps<typeof segmentedControlItemVariants> & {
+    /** Identifies the item inside a {@link SegmentedControl}. */
+    value?: string;
+    /** Standalone toggle state — only outside a SegmentedControl. */
+    pressed?: boolean;
+    onPressedChange?: (pressed: boolean) => void;
+};
+/**
+ * One pill. Inside a {@link SegmentedControl} it is a `radio`; on its own
+ * with `pressed` it is an `aria-pressed` toggle (a filter chip).
+ */
+declare function SegmentedControlItem({ className, size, value, pressed, onPressedChange, children, ...props }: SegmentedControlItemProps): React.JSX.Element;
+export { SegmentedControl, SegmentedControlItem, segmentedControlItemVariants, segmentedControlVariants, ToggleCard, ToggleCardGroup, toggleCardGroupVariants, toggleCardVariants, };

package/dist/components/forms/toggle-card.js

@@ -0,0 +1,211 @@
+"use client";
+import { cn as e } from "../../lib/utils.js";
+import { Check as t } from "lucide-react";
+import * as n from "react";
+import { jsx as r, jsxs as i } from "react/jsx-runtime";
+import { cva as a } from "class-variance-authority";
+import { Radio as o } from "@base-ui/react/radio";
+import { RadioGroup as s } from "@base-ui/react/radio-group";
+//#region src/components/forms/toggle-card.tsx
+function c({ slot: e, onValueChange: t, className: n, children: i, ...a }) {
+	return /* @__PURE__ */ r(s, {
+		"data-slot": e,
+		className: n,
+		onValueChange: (e) => t?.(e),
+		...a,
+		children: i
+	});
+}
+function l({ grouped: e, value: t, pressed: n, onPressedChange: i, onClick: a, disabled: s, ref: c, children: l, ...u }) {
+	if (e) return /* @__PURE__ */ r(o.Root, {
+		value: t,
+		render: /* @__PURE__ */ r("button", { type: "button" }),
+		nativeButton: !0,
+		disabled: s,
+		onClick: a,
+		ref: c,
+		...u,
+		children: l
+	});
+	let d = (e) => {
+		a?.(e), !e.defaultPrevented && i?.(!n);
+	};
+	return /* @__PURE__ */ r("button", {
+		type: "button",
+		disabled: s,
+		ref: c,
+		...n === void 0 ? {} : {
+			"aria-pressed": n,
+			...n ? { "data-checked": "" } : { "data-unchecked": "" }
+		},
+		onClick: d,
+		...u,
+		children: l
+	});
+}
+var u = a("gap-3", {
+	variants: { columns: {
+		1: "flex flex-col",
+		2: "grid grid-cols-1 sm:grid-cols-2",
+		3: "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3"
+	} },
+	defaultVariants: { columns: "1" }
+}), d = a([
+	"group/toggle-card relative flex w-full cursor-pointer flex-col border border-input bg-transparent",
+	"transition-[color,background-color,border-color,box-shadow] duration-control outline-none",
+	"not-data-[checked]:hover:border-primary/50 not-data-[checked]:hover:bg-accent/50",
+	"focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]",
+	"data-[checked]:border-primary data-[checked]:bg-primary/5",
+	"disabled:pointer-events-none disabled:opacity-50",
+	"[&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4"
+], {
+	variants: {
+		size: {
+			sm: "gap-1.5 rounded-md p-2 text-xs",
+			md: "gap-2 rounded-lg p-3 text-sm",
+			lg: "gap-2.5 rounded-xl px-4 py-3.5 text-sm"
+		},
+		align: {
+			start: "text-left",
+			center: "text-center"
+		}
+	},
+	defaultVariants: {
+		size: "md",
+		align: "start"
+	}
+}), f = a("flex w-full min-w-0", {
+	variants: { align: {
+		start: "flex-row items-start gap-3",
+		center: "flex-col items-center gap-1.5"
+	} },
+	defaultVariants: { align: "start" }
+}), p = n.createContext(null);
+function m({ className: t, columns: i, size: a, align: o, indicator: s, children: l, ...d }) {
+	let f = n.useMemo(() => ({
+		size: a,
+		align: o,
+		indicator: s
+	}), [
+		a,
+		o,
+		s
+	]);
+	return /* @__PURE__ */ r(p.Provider, {
+		value: f,
+		children: /* @__PURE__ */ r(c, {
+			slot: "toggle-card-group",
+			className: e(u({ columns: i }), t),
+			...d,
+			children: l
+		})
+	});
+}
+function h({ className: a, size: o, align: s, value: c, pressed: u, onPressedChange: m, icon: h, title: g, description: _, meta: v, indicator: y, children: b, ...x }) {
+	let S = n.useContext(p), C = o ?? S?.size ?? "md", w = s ?? S?.align ?? "start", T = y ?? S?.indicator ?? !0;
+	return /* @__PURE__ */ i(l, {
+		grouped: S !== null,
+		value: c,
+		pressed: u,
+		onPressedChange: m,
+		"data-slot": "toggle-card",
+		"data-size": C,
+		className: e(d({
+			size: C,
+			align: w
+		}), T && (w === "center" ? "px-6" : "pr-8"), a),
+		...x,
+		children: [
+			/* @__PURE__ */ i("span", {
+				"data-slot": "toggle-card-header",
+				className: f({ align: w }),
+				children: [
+					h != null && /* @__PURE__ */ r("span", {
+						"data-slot": "toggle-card-icon",
+						className: e("flex shrink-0 items-center text-muted-foreground transition-colors duration-control group-data-[checked]/toggle-card:text-primary", w === "start" && "mt-0.5"),
+						"aria-hidden": "true",
+						children: h
+					}),
+					(g != null || _ != null) && /* @__PURE__ */ i("span", {
+						"data-slot": "toggle-card-body",
+						className: "flex min-w-0 flex-1 flex-col gap-1",
+						children: [g != null && /* @__PURE__ */ r("span", {
+							"data-slot": "toggle-card-title",
+							className: "font-medium",
+							children: g
+						}), _ != null && /* @__PURE__ */ r("span", {
+							"data-slot": "toggle-card-description",
+							className: "text-xs font-normal text-muted-foreground",
+							children: _
+						})]
+					}),
+					v != null && /* @__PURE__ */ r("span", {
+						"data-slot": "toggle-card-meta",
+						className: "shrink-0 text-muted-foreground",
+						children: v
+					})
+				]
+			}),
+			b,
+			T && /* @__PURE__ */ r("span", {
+				"data-slot": "toggle-card-indicator",
+				"aria-hidden": "true",
+				className: "pointer-events-none absolute right-2 top-2 flex size-4 items-center justify-center rounded-full border border-input text-primary-foreground opacity-0 transition-[color,background-color,border-color,opacity] duration-control group-data-[checked]/toggle-card:border-primary group-data-[checked]/toggle-card:bg-primary group-data-[checked]/toggle-card:opacity-100",
+				children: /* @__PURE__ */ r(t, { className: "size-3" })
+			})
+		]
+	});
+}
+var g = a("flex items-center gap-2", {
+	variants: { wrap: {
+		true: "flex-wrap",
+		false: "flex-nowrap"
+	} },
+	defaultVariants: { wrap: !0 }
+}), _ = a([
+	"group/segmented-item inline-flex cursor-pointer items-center justify-center gap-1.5 whitespace-nowrap",
+	"border border-input bg-transparent font-medium text-foreground",
+	"transition-[color,background-color,border-color,box-shadow] duration-control outline-none",
+	"not-data-[checked]:hover:border-primary/50 not-data-[checked]:hover:bg-accent",
+	"focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]",
+	"data-[checked]:border-primary data-[checked]:bg-primary/10 data-[checked]:text-primary",
+	"disabled:pointer-events-none disabled:opacity-50",
+	"[&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4"
+], {
+	variants: { size: {
+		sm: "h-7 rounded-md px-2.5 text-xs",
+		md: "h-8 rounded-md px-3 text-sm",
+		lg: "h-9 rounded-md px-4 text-sm"
+	} },
+	defaultVariants: { size: "md" }
+}), v = n.createContext(null);
+function y({ className: t, size: i, wrap: a, children: o, ...s }) {
+	let l = n.useMemo(() => ({ size: i }), [i]);
+	return /* @__PURE__ */ r(v.Provider, {
+		value: l,
+		children: /* @__PURE__ */ r(c, {
+			slot: "segmented-control",
+			className: e(g({ wrap: a }), t),
+			...s,
+			children: o
+		})
+	});
+}
+function b({ className: t, size: i, value: a, pressed: o, onPressedChange: s, children: c, ...u }) {
+	let d = n.useContext(v), f = i ?? d?.size ?? "md";
+	return /* @__PURE__ */ r(l, {
+		grouped: d !== null,
+		value: a,
+		pressed: o,
+		onPressedChange: s,
+		"data-slot": "segmented-control-item",
+		"data-size": f,
+		className: e(_({ size: f }), t),
+		...u,
+		children: c
+	});
+}
+//#endregion
+export { y as SegmentedControl, b as SegmentedControlItem, h as ToggleCard, m as ToggleCardGroup, _ as segmentedControlItemVariants, g as segmentedControlVariants, u as toggleCardGroupVariants, d as toggleCardVariants };
+
+//# sourceMappingURL=toggle-card.js.map

package/dist/components/forms/toggle-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle-card.js","names":[],"sources":["../../../src/components/forms/toggle-card.tsx"],"mappings":";;;;;;;;;AA+EA,SAAS,EAAmB,EAAE,SAAM,kBAAe,cAAW,aAAU,GAAG,KAAkC;CAC3G,OACE,kBAAC,GAAD;EACE,aAAW;EACA;EACX,gBAAgB,MAAS,IAAgB,CAAc;EACvD,GAAI;EAEH;CACkB,CAAA;AAEzB;AA8BA,SAAS,EAAmB,EAC1B,YACA,UACA,YACA,oBACA,YACA,aACA,QACA,aACA,GAAG,KACuB;CAC1B,IAAI,GACF,OAGE,kBAAC,EAAe,MAAhB;EACS;EACP,QAAQ,kBAAC,UAAD,EAAQ,MAAK,SAAU,CAAA;EAC/B,cAAA;EACU;EACD;EACJ;EACL,GAAI;EAEH;CACkB,CAAA;CAIzB,IAAM,KAAe,MAAyC;EAC5D,IAAU,CAAK,GACX,GAAM,oBACV,IAAkB,CAAC,CAAO;CAC5B;CAEA,OACE,kBAAC,UAAD;EACE,MAAK;EACK;EACL;EAIL,GAAK,MAAY,KAAA,IACb,CAAC,IACD;GAAE,gBAAgB;GAAS,GAAI,IAAU,EAAE,gBAAgB,GAAG,IAAI,EAAE,kBAAkB,GAAG;EAAG;EAChG,SAAS;EACT,GAAI;EAEH;CACK,CAAA;AAEZ;AAMA,IAAM,IAA0B,EAAI,SAAS;CAC3C,UAAU,EACR,SAAS;EACP,GAAK;EACL,GAAK;EACL,GAAK;CACP,EACF;CACA,iBAAiB,EACf,SAAS,IACX;AACF,CAAC,GAEK,IAAqB,EACzB;CAIE;CAGA;CAGA;CACA;CAKA;CACA;CACA;AACF,GACA;CACE,UAAU;EACR,MAAM;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;EACN;EACA,OAAO;GACL,OAAO;GACP,QAAQ;EACV;CACF;CACA,iBAAiB;EACf,MAAM;EACN,OAAO;CACT;AACF,CACF,GAEM,IAA2B,EAAI,uBAAuB;CAC1D,UAAU,EACR,OAAO;EACL,OAAO;EACP,QAAQ;CACV,EACF;CACA,iBAAiB,EACf,OAAO,QACT;AACF,CAAC,GAWK,IAAyB,EAAM,cAAkD,IAAI;AAsB3F,SAAS,EAAgB,EAAE,cAAW,YAAS,SAAM,UAAO,cAAW,aAAU,GAAG,KAA+B;CACjH,IAAM,IAAU,EAAM,eACb;EAAE;EAAM;EAAO;CAAU,IAChC;EAAC;EAAM;EAAO;CAAS,CACzB;CAEA,OACE,kBAAC,EAAuB,UAAxB;EAAiC,OAAO;EACtC,UAAA,kBAAC,GAAD;GACE,MAAK;GACL,WAAW,EAAG,EAAwB,EAAE,WAAQ,CAAC,GAAG,CAAS;GAC7D,GAAI;GAEH;EACiB,CAAA;CACW,CAAA;AAErC;AAkCA,SAAS,EAAW,EAClB,cACA,SACA,UACA,UACA,YACA,oBACA,SACA,UACA,gBACA,SACA,cACA,aACA,GAAG,KACe;CAClB,IAAM,IAAQ,EAAM,WAAW,CAAsB,GAC/C,IAAe,KAAQ,GAAO,QAAQ,MACtC,IAAgB,KAAS,GAAO,SAAS,SACzC,IAAgB,KAAa,GAAO,aAAa;CAEvD,OACE,kBAAC,GAAD;EACE,SAAS,MAAU;EACZ;EACE;EACQ;EACjB,aAAU;EACV,aAAW;EACX,WAAW,EACT,EAAmB;GAAE,MAAM;GAAc,OAAO;EAAc,CAAC,GAI/D,MAAkB,MAAkB,WAAW,SAAS,SACxD,CACF;EACA,GAAI;EAfN,UAAA;GAiBE,kBAAC,QAAD;IAAM,aAAU;IAAqB,WAAW,EAAyB,EAAE,OAAO,EAAc,CAAC;IAAjG,UAAA;KACG,KAAQ,QACP,kBAAC,QAAD;MACE,aAAU;MACV,WAAW,EACT,qIACA,MAAkB,WAAW,QAC/B;MACA,eAAY;MAEX,UAAA;KACG,CAAA;MAEN,KAAS,QAAQ,KAAe,SAChC,kBAAC,QAAD;MAAM,aAAU;MAAmB,WAAU;MAA7C,UAAA,CACG,KAAS,QACR,kBAAC,QAAD;OAAM,aAAU;OAAoB,WAAU;OAC3C,UAAA;MACG,CAAA,GAEP,KAAe,QACd,kBAAC,QAAD;OAAM,aAAU;OAA0B,WAAU;OACjD,UAAA;MACG,CAAA,CAEJ;;KAEP,KAAQ,QACP,kBAAC,QAAD;MAAM,aAAU;MAAmB,WAAU;MAC1C,UAAA;KACG,CAAA;IAEJ;;GACL;GACA,KACC,kBAAC,QAAD;IACE,aAAU;IACV,eAAY;IACZ,WAAU;IAEV,UAAA,kBAAC,GAAD,EAAO,WAAU,SAAU,CAAA;GACvB,CAAA;EAEU;;AAExB;AAMA,IAAM,IAA2B,EAAI,2BAA2B;CAC9D,UAAU,EACR,MAAM;EACJ,MAAM;EACN,OAAO;CACT,EACF;CACA,iBAAiB,EACf,MAAM,GACR;AACF,CAAC,GAEK,IAA+B,EACnC;CACE;CACA;CACA;CACA;CACA;CAIA;CACA;CACA;AACF,GACA;CACE,UAAU,EACR,MAAM;EAGJ,IAAI;EACJ,IAAI;EACJ,IAAI;CACN,EACF;CACA,iBAAiB,EACf,MAAM,KACR;AACF,CACF,GAQM,IAA0B,EAAM,cAAmD,IAAI;AAe7F,SAAS,EAAiB,EAAE,cAAW,SAAM,SAAM,aAAU,GAAG,KAAgC;CAC9F,IAAM,IAAU,EAAM,eAA6C,EAAE,QAAK,IAAI,CAAC,CAAI,CAAC;CAEpF,OACE,kBAAC,EAAwB,UAAzB;EAAkC,OAAO;EACvC,UAAA,kBAAC,GAAD;GACE,MAAK;GACL,WAAW,EAAG,EAAyB,EAAE,QAAK,CAAC,GAAG,CAAS;GAC3D,GAAI;GAEH;EACiB,CAAA;CACY,CAAA;AAEtC;AAeA,SAAS,EAAqB,EAC5B,cACA,SACA,UACA,YACA,oBACA,aACA,GAAG,KACyB;CAC5B,IAAM,IAAQ,EAAM,WAAW,CAAuB,GAChD,IAAe,KAAQ,GAAO,QAAQ;CAE5C,OACE,kBAAC,GAAD;EACE,SAAS,MAAU;EACZ;EACE;EACQ;EACjB,aAAU;EACV,aAAW;EACX,WAAW,EAAG,EAA6B,EAAE,MAAM,EAAa,CAAC,GAAG,CAAS;EAC7E,GAAI;EAEH;CACiB,CAAA;AAExB"}

package/dist/components/overlays/popover.d.ts

@@ -0,0 +1,65 @@
+import { Popover as PopoverPrimitive } from "@base-ui/react/popover";
+import * as React from "react";
+type PopoverRootProps = React.ComponentProps<typeof PopoverPrimitive.Root>;
+type PopoverPositionerProps = React.ComponentProps<typeof PopoverPrimitive.Positioner>;
+declare function usePopoverClose(): () => void;
+interface PopoverProps extends Omit<PopoverRootProps, "children"> {
+    children?: React.ReactNode;
+    /**
+     * Whether a press outside the popup dismisses it. Escape and `<PopoverClose>`
+     * keep working when this is `false`, so the popup is never a keyboard trap.
+     * @default true
+     */
+    closeOnOutsideClick?: boolean;
+}
+declare function Popover({ actionsRef, closeOnOutsideClick, onOpenChange, children, ...props }: PopoverProps): React.JSX.Element;
+declare function PopoverTrigger({ asChild, children, ...props }: React.ComponentProps<typeof PopoverPrimitive.Trigger> & {
+    asChild?: boolean;
+}): React.JSX.Element;
+interface PopoverContentProps extends Omit<React.ComponentProps<typeof PopoverPrimitive.Popup>, "children"> {
+    /** Preferred side of the anchor. Flipped automatically when it does not fit. */
+    side?: "top" | "right" | "bottom" | "left";
+    /** Alignment along the chosen side. Shifted automatically when it does not fit. */
+    align?: "start" | "center" | "end";
+    /** Distance in pixels between the anchor and the popup. */
+    sideOffset?: number;
+    /** Offset in pixels along the alignment axis. */
+    alignOffset?: number;
+    /** Minimum gap kept between the popup and the edge of the viewport. */
+    collisionPadding?: PopoverPositionerProps["collisionPadding"];
+    /** Element the popup is kept inside of. Defaults to the viewport. */
+    collisionBoundary?: PopoverPositionerProps["collisionBoundary"];
+    /** How side/alignment overflow is corrected. See Base UI's `collisionAvoidance`. */
+    collisionAvoidance?: PopoverPositionerProps["collisionAvoidance"];
+    /** Keep the popup on screen after the anchor scrolls out of view. */
+    sticky?: boolean;
+    /**
+     * Anchor the popup to something other than the trigger — an element, a ref,
+     * or a virtual element (`getBoundingClientRect`). Useful for anchoring to a
+     * text selection or an editor node rather than a button.
+     */
+    anchor?: PopoverPositionerProps["anchor"];
+    /** Class applied to the positioner wrapper rather than the popup surface. */
+    positionerClassName?: string;
+    /**
+     * Accessible name for the popup, which Base UI renders with `role="dialog"`.
+     * Ignored once a `<PopoverTitle>` is rendered inside, since that wins by
+     * `aria-labelledby`.
+     * @default "Popover"
+     */
+    label?: string;
+    /**
+     * Popup body. A function receives an imperative `close`, so a picker can
+     * dismiss itself on selection.
+     */
+    children?: React.ReactNode | ((api: {
+        close: () => void;
+    }) => React.ReactNode);
+}
+declare function PopoverContent({ className, positionerClassName, side, align, sideOffset, alignOffset, collisionPadding, collisionBoundary, collisionAvoidance, sticky, anchor, label, children, ...props }: PopoverContentProps): React.JSX.Element;
+declare function PopoverTitle({ className, ...props }: React.ComponentProps<typeof PopoverPrimitive.Title>): React.JSX.Element;
+declare function PopoverDescription({ className, ...props }: React.ComponentProps<typeof PopoverPrimitive.Description>): React.JSX.Element;
+declare function PopoverClose({ asChild, children, ...props }: React.ComponentProps<typeof PopoverPrimitive.Close> & {
+    asChild?: boolean;
+}): React.JSX.Element;
+export { Popover, PopoverClose, PopoverContent, PopoverDescription, PopoverTitle, PopoverTrigger, usePopoverClose };