@cascivo/react 0.7.1 → 0.9.0

package/dist/date-picker/date-picker.js

@@ -2,25 +2,25 @@
 
 import e from "./date-picker.module.js";
 import { batch as t, cn as n, createMachine as r, useMachine as i, useSignal as a, useSignalEffect as o, useSignals as s } from "@cascivo/core";
-import { builtin as c, currentLocale as l, t as u } from "@cascivo/i18n";
-import { jsx as d, jsxs as f } from "react/jsx-runtime";
-import { useId as p, useRef as m } from "react";
+import { builtin as c, currentLocale as ee, t as l } from "@cascivo/i18n";
+import { jsx as u, jsxs as d } from "react/jsx-runtime";
+import { useId as f, useRef as te } from "react";
 //#region ../components/src/date-picker/date-picker.tsx
-var h = r({
+var p = r({
 	initial: "closed",
 	states: {
 		closed: { on: { OPEN: "open" } },
 		open: { on: { CLOSE: "closed" } }
 	}
 });
-function ee(e) {
+function ne(e) {
 	try {
 		let t = new Intl.Locale(e).weekInfo;
 		if (t) return t.firstDay % 7;
 	} catch {}
 	return 1;
 }
-function g(e, t, n) {
+function m(e, t, n) {
 	let r = new Date(Date.UTC(e, t, 1)), i = new Date(Date.UTC(e, t + 1, 0)), a = (r.getUTCDay() - n + 7) % 7, o = [];
 	for (let e = 0; e < a; e++) o.push(null);
 	for (let n = 1; n <= i.getUTCDate(); n++) o.push(new Date(Date.UTC(e, t, n)));
@@ -29,170 +29,170 @@ function g(e, t, n) {
 	for (let e = 0; e < o.length; e += 7) s.push(o.slice(e, e + 7));
 	return s;
 }
-function _(e, t) {
+function h(e, t) {
 	return new Intl.DateTimeFormat(t).format(e);
 }
-function v(e) {
+function g(e) {
 	return e.toISOString().slice(0, 10);
 }
-function y(e) {
+function _(e) {
 	let [t, n, r] = e.split("-").map(Number);
 	return new Date(Date.UTC(t, n - 1, r));
 }
-function b({ value: r, defaultValue: b, onChange: x, min: S, max: C, clearable: w = !1, label: T, hint: E, error: D, size: O = "md", disabled: k = !1, labels: A, className: j, id: M }) {
+function v({ value: r, defaultValue: v, onValueChange: y, onChange: b, min: x, max: S, clearable: C = !1, label: w, hint: T, error: E, size: D = "md", disabled: O = !1, labels: k, className: re, id: A }) {
 	s();
-	let [N, P] = i(h), F = p(), I = M ?? `cascade-date-picker-${F}`, L = `${F}-grid`, R = l(), z = A?.placeholder ?? u(c.datePicker.placeholder), te = A?.previousMonth ?? u(c.datePicker.previousMonth), ne = A?.nextMonth ?? u(c.datePicker.nextMonth), B = A?.clear ?? u(c.datePicker.clear), V = /* @__PURE__ */ new Date(), H = v(V), U = a(r ?? b);
-	r !== void 0 && (U.value = r);
-	let W = a(U.value ? y(U.value).getUTCFullYear() : V.getUTCFullYear()), G = a(U.value ? y(U.value).getUTCMonth() : V.getUTCMonth()), K = a(U.value), q = m(null);
+	let [j, M] = i(p), N = f(), P = A ?? `cascade-date-picker-${N}`, F = `${N}-grid`, I = ee(), ie = k?.placeholder ?? l(c.datePicker.placeholder), ae = k?.previousMonth ?? l(c.datePicker.previousMonth), L = k?.nextMonth ?? l(c.datePicker.nextMonth), R = k?.clear ?? l(c.datePicker.clear), z = /* @__PURE__ */ new Date(), B = g(z), V = a(r ?? v);
+	r !== void 0 && (V.value = r);
+	let H = a(V.value ? _(V.value).getUTCFullYear() : z.getUTCFullYear()), U = a(V.value ? _(V.value).getUTCMonth() : z.getUTCMonth()), W = a(V.value), G = te(null);
 	o(() => {
-		if (N.value !== "open") return;
+		if (j.value !== "open") return;
 		let e = (e) => {
-			q.current && !q.current.contains(e.target) && P("CLOSE");
+			G.current && !G.current.contains(e.target) && M("CLOSE");
 		};
 		return document.addEventListener("mousedown", e), () => document.removeEventListener("mousedown", e);
 	});
-	let J = () => {
-		k || P("OPEN");
-	}, Y = () => P("CLOSE"), X = (e) => {
-		S && e < S || C && e > C || (r === void 0 && (U.value = e), x?.(e), Y());
-	}, re = (e) => {
-		e.stopPropagation(), r === void 0 && (U.value = void 0), x?.(void 0);
-	}, ie = () => {
-		G.value === 0 ? t(() => {
-			W.value--, G.value = 11;
-		}) : G.value--;
-	}, ae = () => {
-		G.value === 11 ? t(() => {
-			W.value++, G.value = 0;
-		}) : G.value++;
-	}, Z = ee(R), oe = g(W.value, G.value, Z), se = new Intl.DateTimeFormat(R, { weekday: "short" }), ce = Array.from({ length: 7 }, (e, t) => {
-		let n = new Date(Date.UTC(2024, 0, 7 + Z + t));
-		return se.format(n);
-	}), Q = new Intl.DateTimeFormat(R, {
+	let K = () => {
+		O || M("OPEN");
+	}, q = () => M("CLOSE"), J = y ?? b, Y = (e) => {
+		x && e < x || S && e > S || (r === void 0 && (V.value = e), J?.(e), q());
+	}, oe = (e) => {
+		e.stopPropagation(), r === void 0 && (V.value = void 0), J?.(void 0);
+	}, se = () => {
+		U.value === 0 ? t(() => {
+			H.value--, U.value = 11;
+		}) : U.value--;
+	}, ce = () => {
+		U.value === 11 ? t(() => {
+			H.value++, U.value = 0;
+		}) : U.value++;
+	}, X = ne(I), Z = m(H.value, U.value, X), le = new Intl.DateTimeFormat(I, { weekday: "short" }), ue = Array.from({ length: 7 }, (e, t) => {
+		let n = new Date(Date.UTC(2024, 0, 7 + X + t));
+		return le.format(n);
+	}), Q = new Intl.DateTimeFormat(I, {
 		month: "long",
 		year: "numeric"
-	}).format(new Date(Date.UTC(W.value, G.value, 1))), le = (e) => {
-		let n = K.value;
+	}).format(new Date(Date.UTC(H.value, U.value, 1))), de = (e) => {
+		let n = W.value;
 		if (!n) return;
-		let r = y(n), i;
+		let r = _(n), i;
 		if (e.key === "ArrowRight") i = new Date(Date.UTC(r.getUTCFullYear(), r.getUTCMonth(), r.getUTCDate() + 1));
 		else if (e.key === "ArrowLeft") i = new Date(Date.UTC(r.getUTCFullYear(), r.getUTCMonth(), r.getUTCDate() - 1));
 		else if (e.key === "ArrowDown") i = new Date(Date.UTC(r.getUTCFullYear(), r.getUTCMonth(), r.getUTCDate() + 7));
 		else if (e.key === "ArrowUp") i = new Date(Date.UTC(r.getUTCFullYear(), r.getUTCMonth(), r.getUTCDate() - 7));
 		else if (e.key === "Enter" || e.key === " ") {
-			e.preventDefault(), X(n);
+			e.preventDefault(), Y(n);
 			return;
 		} else if (e.key === "Escape") {
-			Y();
+			q();
 			return;
 		} else return;
 		if (e.preventDefault(), i) {
-			let e = v(i);
-			if (S && e < S || C && e > C) return;
-			K.value = e, t(() => {
-				W.value = i.getUTCFullYear(), G.value = i.getUTCMonth();
+			let e = g(i);
+			if (x && e < x || S && e > S) return;
+			W.value = e, t(() => {
+				H.value = i.getUTCFullYear(), U.value = i.getUTCMonth();
 			});
 		}
-	}, $ = U.value ? _(y(U.value), R) : "";
-	return /* @__PURE__ */ f("div", {
-		ref: q,
-		className: n(e.wrapper, j),
-		"data-state": D ? "error" : N.value,
-		"data-size": O,
+	}, $ = V.value ? h(_(V.value), I) : "";
+	return /* @__PURE__ */ d("div", {
+		ref: G,
+		className: n(e.wrapper, re),
+		"data-state": E ? "error" : j.value,
+		"data-size": D,
 		children: [
-			T && /* @__PURE__ */ d("label", {
+			w && /* @__PURE__ */ u("label", {
 				className: e.label,
-				htmlFor: I,
-				children: T
+				htmlFor: P,
+				children: w
 			}),
-			/* @__PURE__ */ f("div", {
+			/* @__PURE__ */ d("div", {
 				className: e.field,
-				children: [/* @__PURE__ */ f("button", {
-					id: I,
+				children: [/* @__PURE__ */ d("button", {
+					id: P,
 					type: "button",
 					role: "combobox",
-					"aria-expanded": N.value === "open",
-					"aria-controls": L,
+					"aria-expanded": j.value === "open",
+					"aria-controls": F,
 					"aria-haspopup": "dialog",
-					"aria-invalid": D ? !0 : void 0,
-					"aria-describedby": D ? `${F}-error` : E ? `${F}-hint` : void 0,
+					"aria-invalid": E ? !0 : void 0,
+					"aria-describedby": E ? `${N}-error` : T ? `${N}-hint` : void 0,
 					className: e.trigger,
-					disabled: k,
-					onClick: N.value === "open" ? Y : J,
-					children: [/* @__PURE__ */ d("span", {
+					disabled: O,
+					onClick: j.value === "open" ? q : K,
+					children: [/* @__PURE__ */ u("span", {
 						className: n(e.value, $ ? void 0 : e.placeholder),
-						children: $ || z
-					}), /* @__PURE__ */ d("span", {
+						children: $ || ie
+					}), /* @__PURE__ */ u("span", {
 						className: e.icon,
 						"aria-hidden": "true",
 						children: "📅"
 					})]
-				}), w && U.value !== void 0 && /* @__PURE__ */ d("button", {
+				}), C && V.value !== void 0 && /* @__PURE__ */ u("button", {
 					type: "button",
 					className: e.clear,
-					"aria-label": B,
-					onClick: re,
+					"aria-label": R,
+					onClick: oe,
 					children: "✕"
 				})]
 			}),
-			/* @__PURE__ */ f("div", {
-				id: L,
+			/* @__PURE__ */ d("div", {
+				id: F,
 				role: "dialog",
 				"aria-label": Q,
 				className: e.calendar,
-				"data-state": N.value,
-				onKeyDown: le,
-				children: [/* @__PURE__ */ f("div", {
+				"data-state": j.value,
+				onKeyDown: de,
+				children: [/* @__PURE__ */ d("div", {
 					className: e.header,
 					children: [
-						/* @__PURE__ */ d("button", {
+						/* @__PURE__ */ u("button", {
 							type: "button",
 							className: e.navButton,
-							"aria-label": te,
-							onClick: ie,
+							"aria-label": ae,
+							onClick: se,
 							children: "‹"
 						}),
-						/* @__PURE__ */ d("span", {
+						/* @__PURE__ */ u("span", {
 							className: e.monthLabel,
 							"aria-live": "polite",
 							children: Q
 						}),
-						/* @__PURE__ */ d("button", {
+						/* @__PURE__ */ u("button", {
 							type: "button",
 							className: e.navButton,
-							"aria-label": ne,
-							onClick: ae,
+							"aria-label": L,
+							onClick: ce,
 							children: "›"
 						})
 					]
-				}), /* @__PURE__ */ f("table", {
+				}), /* @__PURE__ */ d("table", {
 					role: "grid",
 					className: e.grid,
-					children: [/* @__PURE__ */ d("thead", { children: /* @__PURE__ */ d("tr", { children: ce.map((t) => /* @__PURE__ */ d("th", {
+					children: [/* @__PURE__ */ u("thead", { children: /* @__PURE__ */ u("tr", { children: ue.map((t) => /* @__PURE__ */ u("th", {
 						className: e.weekday,
 						abbr: t,
 						scope: "col",
 						children: t
-					}, t)) }) }), /* @__PURE__ */ d("tbody", { children: oe.map((t, n) => /* @__PURE__ */ d("tr", { children: t.map((t, n) => {
-						if (!t) return /* @__PURE__ */ d("td", { className: e.empty }, n);
-						let r = v(t), i = r === U.value, a = r === H, o = r === K.value, s = S !== void 0 && r < S || C !== void 0 && r > C;
-						return /* @__PURE__ */ d("td", {
+					}, t)) }) }), /* @__PURE__ */ u("tbody", { children: Z.map((t, n) => /* @__PURE__ */ u("tr", { children: t.map((t, n) => {
+						if (!t) return /* @__PURE__ */ u("td", { className: e.empty }, n);
+						let r = g(t), i = r === V.value, a = r === B, o = r === W.value, s = x !== void 0 && r < x || S !== void 0 && r > S;
+						return /* @__PURE__ */ u("td", {
 							className: e.cell,
-							children: /* @__PURE__ */ d("button", {
+							children: /* @__PURE__ */ u("button", {
 								type: "button",
 								className: e.day,
 								tabIndex: o ? 0 : -1,
 								"aria-pressed": i,
-								"aria-label": _(t, R),
+								"aria-label": h(t, I),
 								"aria-current": a ? "date" : void 0,
 								"aria-disabled": s || void 0,
 								"data-selected": i || void 0,
 								"data-today": a || void 0,
 								onClick: () => {
-									s || X(r);
+									s || Y(r);
 								},
 								onFocus: () => {
-									K.value = r;
+									W.value = r;
 								},
 								children: t.getUTCDate()
 							})
@@ -200,19 +200,19 @@ function b({ value: r, defaultValue: b, onChange: x, min: S, max: C, clearable:
 					}) }, n)) })]
 				})]
 			}),
-			D && /* @__PURE__ */ d("span", {
-				id: `${F}-error`,
+			E && /* @__PURE__ */ u("span", {
+				id: `${N}-error`,
 				className: e.error,
 				role: "alert",
-				children: D
+				children: E
 			}),
-			!D && E && /* @__PURE__ */ d("span", {
-				id: `${F}-hint`,
+			!E && T && /* @__PURE__ */ u("span", {
+				id: `${N}-hint`,
 				className: e.hint,
-				children: E
+				children: T
 			})
 		]
 	});
 }
 //#endregion
-export { b as DatePicker };
+export { v as DatePicker };

package/dist/filter/filter.js

@@ -4,28 +4,28 @@ import e from "./filter.module.js";
 import { useControllableSignal as t, useSignals as n } from "@cascivo/core";
 import { jsx as r } from "react/jsx-runtime";
 //#region ../components/src/filter/filter.tsx
-function i({ options: i, value: a, defaultValue: o = [], onChange: s, multi: c = !1, variant: l = "pill", className: u, ...d }) {
+function i({ options: i, value: a, defaultValue: o = [], onValueChange: s, onChange: c, multi: l = !1, variant: u = "pill", className: d, ...f }) {
 	n();
-	let [f, p] = t({
+	let [p, m] = t({
 		value: a,
 		defaultValue: o,
-		onChange: s
+		onChange: s ?? c
 	});
-	function m(e) {
-		let t = f.value, n;
-		n = c ? t.includes(e) ? t.filter((t) => t !== e) : [...t, e] : t.includes(e) ? [] : [e], p(n);
+	function h(e) {
+		let t = p.value, n;
+		n = l ? t.includes(e) ? t.filter((t) => t !== e) : [...t, e] : t.includes(e) ? [] : [e], m(n);
 	}
 	return /* @__PURE__ */ r("div", {
 		role: "group",
-		className: [e.filter, u].filter(Boolean).join(" "),
-		"data-variant": l,
-		...d,
+		className: [e.filter, d].filter(Boolean).join(" "),
+		"data-variant": u,
+		...f,
 		children: i.map((t) => /* @__PURE__ */ r("button", {
 			type: "button",
 			className: e.item,
-			"data-selected": f.value.includes(t.value) || void 0,
-			onClick: () => m(t.value),
-			"aria-pressed": f.value.includes(t.value),
+			"data-selected": p.value.includes(t.value) || void 0,
+			onClick: () => h(t.value),
+			"aria-pressed": p.value.includes(t.value),
 			children: t.label
 		}, t.value))
 	});

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ErrorBoundary, FocusScope, Portal, RovingOrientation, Signal, SuspenseBoundary } from "@cascivo/core";
+import { ErrorBoundary, FocusScope, LinkComponent, LinkComponentProps, Portal, RovingOrientation, Signal, SuspenseBoundary, getLinkComponent, setLinkComponent } from "@cascivo/core";
 import { AnchorHTMLAttributes, ButtonHTMLAttributes, FormHTMLAttributes, HTMLAttributes, ImgHTMLAttributes, InputHTMLAttributes, LabelHTMLAttributes, LiHTMLAttributes, MouseEvent, ReactElement, ReactNode, RefObject, SelectHTMLAttributes, TextareaHTMLAttributes, TimeHTMLAttributes } from "react";
 
 interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
@@ -151,6 +151,9 @@ declare function Alert({
 interface AvatarProps extends HTMLAttributes<HTMLSpanElement> {
   src?: string;
   alt?: string;
+  /** Full name — used to derive initials for the fallback and as the accessible label. */
+  name?: string;
+  /** Explicit fallback text (initials/glyph). Overrides initials derived from `name`. */
   fallback?: string;
   size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
   status?: 'online' | 'offline' | 'busy';
@@ -158,6 +161,7 @@ interface AvatarProps extends HTMLAttributes<HTMLSpanElement> {
 declare function Avatar({
   src,
   alt,
+  name,
   fallback,
   size,
   status,
@@ -331,6 +335,9 @@ declare function RadioGroup({
 interface ToggleProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange'> {
   checked?: boolean;
   defaultChecked?: boolean;
+  /** Called with the new checked state when the switch is toggled. */
+  onValueChange?: (checked: boolean) => void;
+  /** @deprecated Use `onValueChange` — it receives the same `checked` boolean. */
   onChange?: (checked: boolean) => void;
   /**
    * Renders a **visible** text label beside the switch that also becomes its
@@ -344,6 +351,7 @@ interface ToggleProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onC
 declare function Toggle({
   checked,
   defaultChecked,
+  onValueChange,
   onChange,
   label,
   size,
@@ -648,7 +656,13 @@ interface SideNavLinkProps {
   'data-state'?: 'active' | undefined;
   'data-tone'?: Exclude<SideNavTone, 'default'> | undefined;
   tabIndex?: number | undefined;
-  onClick: (e: MouseEvent<HTMLAnchorElement>) => void;
+  /**
+   * Always provided by cascivo when it builds the bag; only calls
+   * `preventDefault()` for a disabled item, otherwise inert. Optional on the type
+   * so it composes cleanly — spread it onto a router `<Link>`, which layers its own
+   * click handling on top.
+   */
+  onClick?: (e: MouseEvent<HTMLAnchorElement>) => void;
 }
 /** A selectable/navigable sub-item (link when `href` is set, action when `onSelect` is set). */
 interface SideNavLinkSubItem {
@@ -693,7 +707,8 @@ interface SideNavItem {
    * the default layout), and `linkProps` is the anchor prop bag cascivo would spread
    * onto the `<a>` (including active-state and a11y attributes) — spread it onto your
    * router `<Link>` to preserve them. For a global router integration prefer
-   * `setLinkComponent` from `@cascivo/core` over a per-item hatch.
+   * `setLinkComponent` (from `@cascivo/react`, or `@cascivo/core` for copied source)
+   * over a per-item hatch.
    */
   render?: (ctx: {
     collapsed: boolean;
@@ -919,6 +934,9 @@ declare function OverflowMenu({
 interface SearchProps {
   value?: string;
   defaultValue?: string;
+  /** Called with the current text on every keystroke. */
+  onValueChange?: (value: string) => void;
+  /** @deprecated Use `onValueChange` — it receives the same string. */
   onChange?: (value: string) => void;
   onSearch?: (value: string) => void;
   debounceMs?: number;
@@ -933,6 +951,7 @@ interface SearchProps {
 declare function Search({
   value,
   defaultValue,
+  onValueChange,
   onChange,
   onSearch,
   debounceMs,
@@ -947,6 +966,9 @@ declare function Search({
 interface NumberInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'type' | 'value' | 'defaultValue' | 'onChange' | 'min' | 'max' | 'step'> {
   value?: number | null;
   defaultValue?: number;
+  /** Called with the new numeric value (or null when cleared). */
+  onValueChange?: (value: number | null) => void;
+  /** @deprecated Use `onValueChange` — it receives the same `number | null`. */
   onChange?: (value: number | null) => void;
   min?: number;
   max?: number;
@@ -963,6 +985,7 @@ interface NumberInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, '
 declare function NumberInput({
   value,
   defaultValue,
+  onValueChange,
   onChange,
   min,
   max,
@@ -1246,6 +1269,9 @@ interface ComboboxProps {
   options: ComboboxOption[];
   value?: string;
   defaultValue?: string;
+  /** Called with the selected option value (or undefined when cleared). */
+  onValueChange?: (value: string | undefined) => void;
+  /** @deprecated Use `onValueChange` — it receives the same `string | undefined`. */
   onChange?: (value: string | undefined) => void;
   clearable?: boolean;
   searchable?: boolean;
@@ -1262,6 +1288,7 @@ declare function Combobox({
   options,
   value,
   defaultValue,
+  onValueChange,
   onChange,
   clearable,
   searchable,
@@ -1283,6 +1310,9 @@ interface DatePickerLabels {
 interface DatePickerProps {
   value?: string;
   defaultValue?: string;
+  /** Called with the selected ISO date string (or undefined when cleared). */
+  onValueChange?: (value: string | undefined) => void;
+  /** @deprecated Use `onValueChange` — it receives the same ISO `string | undefined`. */
   onChange?: (value: string | undefined) => void;
   min?: string;
   max?: string;
@@ -1299,6 +1329,7 @@ interface DatePickerProps {
 declare function DatePicker({
   value,
   defaultValue,
+  onValueChange,
   onChange,
   min,
   max,
@@ -1358,6 +1389,9 @@ declare function FileUploader({
 interface TimePickerProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'type' | 'value' | 'defaultValue' | 'onChange' | 'min' | 'max' | 'step'> {
   value?: string;
   defaultValue?: string;
+  /** Called with the new `HH:MM` time string when the value changes. */
+  onValueChange?: (value: string) => void;
+  /** @deprecated Use `onValueChange` — it receives the same time string. */
   onChange?: (value: string) => void;
   min?: string;
   max?: string;
@@ -1370,6 +1404,7 @@ interface TimePickerProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 's
 declare function TimePicker({
   value,
   defaultValue,
+  onValueChange,
   onChange,
   min,
   max,
@@ -2310,6 +2345,9 @@ interface FilterProps {
   options: FilterOption[];
   value?: string[];
   defaultValue?: string[];
+  /** Called with the selected values whenever the selection changes. */
+  onValueChange?: (selected: string[]) => void;
+  /** @deprecated Use `onValueChange` — it receives the same `string[]`. */
   onChange?: (selected: string[]) => void;
   multi?: boolean;
   variant?: FilterVariant;
@@ -2320,6 +2358,7 @@ declare function Filter({
   options,
   value,
   defaultValue,
+  onValueChange,
   onChange,
   multi,
   variant,
@@ -3196,6 +3235,9 @@ interface SwapProps {
   on: React.ReactNode;
   off: React.ReactNode;
   checked?: boolean;
+  /** Called with the new checked state when the swap is toggled. */
+  onValueChange?: (checked: boolean) => void;
+  /** @deprecated Use `onValueChange` — it receives the same `checked` boolean. */
   onChange?: (checked: boolean) => void;
   mode?: SwapMode;
   'aria-label'?: string;
@@ -3205,6 +3247,7 @@ declare function Swap({
   on,
   off,
   checked,
+  onValueChange,
   onChange,
   mode,
   className,
@@ -3360,8 +3403,11 @@ declare function setTheme(next: string): void;
 declare function useTheme(): readonly [Signal<string>, (next: string) => void];
 interface ThemeProviderProps {
   /**
-   * Theme to use when nothing is persisted yet. Falls back to the visitor's OS
-   * `prefers-color-scheme` (light/dark), then to `'light'`.
+   * Theme to use when nothing is persisted yet. When set, it **wins over** the
+   * visitor's OS `prefers-color-scheme` — pass it for a "dark by default" or
+   * custom-theme (`'midnight'`, …) app. Omit it to follow the OS (light/dark),
+   * falling back to `'light'`. Precedence: persisted value > `defaultTheme` (if
+   * set) > OS preference > `'light'`.
    */
   defaultTheme?: string;
   /**
@@ -3408,11 +3454,23 @@ declare function ThemeProvider({
  * SSR or a hard reload. Pass the same `storageKey`/`attribute`/`defaultTheme`
  * you give {@link ThemeProvider}.
  *
+ * Precedence matches {@link ThemeProvider}: persisted value > `defaultTheme`
+ * (if set) > OS `prefers-color-scheme` > `'light'`. Passing `defaultTheme`
+ * suppresses the OS check, so a "dark by default" app stays dark on a light-OS
+ * visitor.
+ *
+ * The script sets `data-theme` **before** React hydrates, so add
+ * `suppressHydrationWarning` to the element that carries the attribute (usually
+ * `<html>`) — the mutation is intentional, and without the flag React 19 logs a
+ * hydration mismatch.
+ *
  * ```tsx
  * // Next.js app/layout.tsx
- * <head>
- *   <script dangerouslySetInnerHTML={{ __html: themePreloadScript() }} />
- * </head>
+ * <html suppressHydrationWarning>
+ *   <head>
+ *     <script dangerouslySetInnerHTML={{ __html: themePreloadScript({ defaultTheme: 'dark' }) }} />
+ *   </head>
+ * </html>
  * ```
  */
 declare function themePreloadScript(options?: {
@@ -3420,4 +3478,4 @@ declare function themePreloadScript(options?: {
   attribute?: string;
   defaultTheme?: string;
 }): string;
-export { Accordion, AccordionContent, AccordionItem, AccordionItemProps, AccordionProps, AccordionTrigger, ActionSheet, ActionSheetAction, ActionSheetProps, Alert, AlertDialog, AlertDialogLabels, AlertDialogProps, AlertProps, AppShell, AppShellProps, AspectRatio, AspectRatioProps, AutoGrid, AutoGridProps, Avatar, AvatarGroup, AvatarGroupLabels, AvatarGroupProps, AvatarProps, Badge, BadgeProps, Blockquote, BlockquoteProps, BottomSheet, BottomSheetProps, Breadcrumb, BreadcrumbItem, BreadcrumbProps, Button, ButtonGroup, ButtonGroupProps, ButtonProps, Calendar, CalendarLabels, CalendarProps, Card, CardContent, CardContentProps, CardFooter, CardFooterProps, CardHeader, CardHeaderProps, CardProps, CardTitle, CardTitleProps, Carousel, CarouselLabels, CarouselProps, Center, CenterProps, ChatBubble, ChatBubbleProps, ChatBubbleSide, Checkbox, CheckboxCard, CheckboxCardProps, CheckboxProps, Code, type CodeLang, CodeProps, CodeSnippet, CodeSnippetProps, Collapsible, CollapsibleProps, ColorPicker, ColorPickerLabels, ColorPickerProps, Column, Columns, ColumnsProps, Combobox, ComboboxLabels, ComboboxOption, ComboboxProps, CommandAction, CommandGroup, CommandItem, CommandMenu, CommandMenuProps, CommandPage, CommandScope, CommandStatus, Comparison, ComparisonProps, ContainedList, ContainedListItem, ContainedListItemProps, ContainedListProps, ContextMenu, ContextMenuItem, ContextMenuItemProps, ContextMenuProps, CopyButton, CopyButtonProps, DataList, DataListItem, DataListProps, DataTable, DataTableLabels, DataTableProps, DatePicker, DatePickerLabels, DatePickerProps, DateRange, DateRangePicker, DateRangePickerLabels, DateRangePickerProps, DateRangePreset, Dock, DockItem, DockProps, Drawer, DrawerProps, Dropdown, DropdownItem, DropdownProps, Editable, EditableProps, EmptyState, EmptyStateProps, ErrorBoundary, Fab, FabAction, FabProps, Field, FieldProps, FileUploader, FileUploaderLabels, FileUploaderProps, Filter, FilterOption, FilterProps, FilterVariant, Flex, FlexProps, FocusScope, Form, FormConfig, FormProps, FormStore, FuzzyMatch, Grid, GridAlign, GridItem, GridItemProps, GridProps, Header, HeaderLabels, HeaderLink, HeaderPanel, HeaderPanelLabels, HeaderPanelProps, HeaderProps, Heading, HeadingLevel, HeadingProps, HeadingSize, HoverCard, HoverCardContent, HoverCardContentProps, HoverCardProps, HoverCardTrigger, HoverCardTriggerProps, IconButton, IconButtonProps, Image, ImageProps, Indicator, IndicatorPlacement, IndicatorProps, InlineLoading, InlineLoadingProps, InlineLoadingStatus, Input, InputGroup, InputGroupAddon, type InputGroupAddonProps, type InputGroupProps, InputProps, Item, ItemActions, ItemActionsProps, ItemContent, ItemContentProps, ItemDescription, ItemDescriptionProps, ItemMedia, ItemMediaProps, ItemProps, ItemTitle, ItemTitleProps, Join, JoinOrientation, JoinProps, Kbd, KbdProps, Label, LabelProps, Link, LinkProps, List, ListItem, ListItemProps, ListProps, LogLevel, LogLine, LogViewer, LogViewerLabels, LogViewerProps, Menu, MenuButton, MenuButtonItem, MenuButtonProps, MenuItem, MenuItemProps, MenuProps, MenuSeparator, MenuTrigger, MenuTriggerProps, Menubar, MenubarItem, MenubarMenu, MenubarProps, Modal, ModalProps, MultiSelect, MultiSelectLabels, MultiSelectOption, MultiSelectProps, NativeSelect, NativeSelectOption, NativeSelectProps, NavigationMenu, NavigationMenuItem, NavigationMenuProps, Notification, NotificationProps, NotificationVariant, NumberInput, NumberInputProps, OtpInput, OtpInputProps, OverflowMenu, OverflowMenuItem, OverflowMenuProps, Pagination, PaginationLabels, PaginationProps, PasswordInput, PasswordInputLabels, PasswordInputProps, Popover, PopoverContent, PopoverContentProps, PopoverProps, PopoverTrigger, PopoverTriggerProps, Portal, Progress, ProgressBar, ProgressBarProps, ProgressCircle, ProgressCircleProps, ProgressIndicator, ProgressIndicatorProps, ProgressProps, ProgressSize, ProgressStep, ProgressVariant, Prose, ProseProps, PullToRefresh, PullToRefreshProps, QrCode, QrCodeProps, RadialProgress, RadialProgressProps, RadialProgressSize, RadialProgressVariant, Radio, RadioCard, RadioCardGroup, RadioCardGroupProps, RadioCardProps, RadioGroup, RadioGroupProps, RadioProps, RatingGroup, RatingGroupLabels, RatingGroupProps, RelativeTime, RelativeTimeProps, Resizable, ResizableProps, Responsive, ScrollArea, ScrollAreaProps, Search, SearchProps, SegmentedControl, SegmentedControlOption, SegmentedControlProps, Select, SelectOption, SelectProps, Separator, SeparatorProps, Sheet, SheetProps, ShellHeader, ShellHeaderAction, ShellHeaderBrand, ShellHeaderLabels, ShellHeaderNavItem, ShellHeaderNavLink, ShellHeaderNavMenu, ShellHeaderNavMenuItem, ShellHeaderProps, SideNav, SideNavGroup, SideNavItem, SideNavLinkProps, SideNavLinkSubItem, SideNavProps, SideNavSubItem, SideNavTone, Skeleton, SkeletonProps, SkipNavLink, SkipNavLinkProps, SkipNavTarget, SkipNavTargetProps, Slider, SliderProps, SortDirection, SortState, Spacer, SpacerProps, Spinner, SpinnerProps, Stack, StackProps, type StandardSchemaV1, Stat, StatProps, Status, StatusProps, Step, StepState, Steps, StepsProps, StructuredList, StructuredListItem, StructuredListProps, SuspenseBoundary, Swap, SwapMode, SwapProps, SwipeAction, SwipeItem, SwipeItemProps, Switcher, SwitcherEntry, SwitcherLink, SwitcherProps, Tabs, TabsContent, TabsContentProps, TabsList, TabsProps, TabsTrigger, TabsTriggerProps, Tag$1 as Tag, TagProps, TagsInput, TagsInputProps, Text, TextProps, Textarea, TextareaProps, ThemeProvider, type ThemeProviderProps, Tile, TileProps, TimePicker, TimePickerProps, Timeline, TimelineItem, TimelineProps, ToastOptions, ToastProvider, ToastVariant, Toc, TocItem, TocProps, Toggle, ToggleGroup, ToggleGroupItem, ToggleGroupProps, ToggleProps, Toggletip, ToggletipPlacement, ToggletipProps, Tooltip, TooltipProps, TreeNode, TreeView, TreeViewProps, UploaderFile, type UsePopoverOptions, type UsePopoverReturn, type UseTocFromRegionOptions, User, UserProps, VisuallyHidden, VisuallyHiddenProps, createForm, dismissAllToasts, fuzzyMatch, fuzzyScore, setTheme, themePreloadScript, treeViewMessages, useForm, usePopover, useTheme, useToast, useTocFromRegion };
+export { Accordion, AccordionContent, AccordionItem, AccordionItemProps, AccordionProps, AccordionTrigger, ActionSheet, ActionSheetAction, ActionSheetProps, Alert, AlertDialog, AlertDialogLabels, AlertDialogProps, AlertProps, AppShell, AppShellProps, AspectRatio, AspectRatioProps, AutoGrid, AutoGridProps, Avatar, AvatarGroup, AvatarGroupLabels, AvatarGroupProps, AvatarProps, Badge, BadgeProps, Blockquote, BlockquoteProps, BottomSheet, BottomSheetProps, Breadcrumb, BreadcrumbItem, BreadcrumbProps, Button, ButtonGroup, ButtonGroupProps, ButtonProps, Calendar, CalendarLabels, CalendarProps, Card, CardContent, CardContentProps, CardFooter, CardFooterProps, CardHeader, CardHeaderProps, CardProps, CardTitle, CardTitleProps, Carousel, CarouselLabels, CarouselProps, Center, CenterProps, ChatBubble, ChatBubbleProps, ChatBubbleSide, Checkbox, CheckboxCard, CheckboxCardProps, CheckboxProps, Code, type CodeLang, CodeProps, CodeSnippet, CodeSnippetProps, Collapsible, CollapsibleProps, ColorPicker, ColorPickerLabels, ColorPickerProps, Column, Columns, ColumnsProps, Combobox, ComboboxLabels, ComboboxOption, ComboboxProps, CommandAction, CommandGroup, CommandItem, CommandMenu, CommandMenuProps, CommandPage, CommandScope, CommandStatus, Comparison, ComparisonProps, ContainedList, ContainedListItem, ContainedListItemProps, ContainedListProps, ContextMenu, ContextMenuItem, ContextMenuItemProps, ContextMenuProps, CopyButton, CopyButtonProps, DataList, DataListItem, DataListProps, DataTable, DataTableLabels, DataTableProps, DatePicker, DatePickerLabels, DatePickerProps, DateRange, DateRangePicker, DateRangePickerLabels, DateRangePickerProps, DateRangePreset, Dock, DockItem, DockProps, Drawer, DrawerProps, Dropdown, DropdownItem, DropdownProps, Editable, EditableProps, EmptyState, EmptyStateProps, ErrorBoundary, Fab, FabAction, FabProps, Field, FieldProps, FileUploader, FileUploaderLabels, FileUploaderProps, Filter, FilterOption, FilterProps, FilterVariant, Flex, FlexProps, FocusScope, Form, FormConfig, FormProps, FormStore, FuzzyMatch, Grid, GridAlign, GridItem, GridItemProps, GridProps, Header, HeaderLabels, HeaderLink, HeaderPanel, HeaderPanelLabels, HeaderPanelProps, HeaderProps, Heading, HeadingLevel, HeadingProps, HeadingSize, HoverCard, HoverCardContent, HoverCardContentProps, HoverCardProps, HoverCardTrigger, HoverCardTriggerProps, IconButton, IconButtonProps, Image, ImageProps, Indicator, IndicatorPlacement, IndicatorProps, InlineLoading, InlineLoadingProps, InlineLoadingStatus, Input, InputGroup, InputGroupAddon, type InputGroupAddonProps, type InputGroupProps, InputProps, Item, ItemActions, ItemActionsProps, ItemContent, ItemContentProps, ItemDescription, ItemDescriptionProps, ItemMedia, ItemMediaProps, ItemProps, ItemTitle, ItemTitleProps, Join, JoinOrientation, JoinProps, Kbd, KbdProps, Label, LabelProps, Link, type LinkComponent, type LinkComponentProps, LinkProps, List, ListItem, ListItemProps, ListProps, LogLevel, LogLine, LogViewer, LogViewerLabels, LogViewerProps, Menu, MenuButton, MenuButtonItem, MenuButtonProps, MenuItem, MenuItemProps, MenuProps, MenuSeparator, MenuTrigger, MenuTriggerProps, Menubar, MenubarItem, MenubarMenu, MenubarProps, Modal, ModalProps, MultiSelect, MultiSelectLabels, MultiSelectOption, MultiSelectProps, NativeSelect, NativeSelectOption, NativeSelectProps, NavigationMenu, NavigationMenuItem, NavigationMenuProps, Notification, NotificationProps, NotificationVariant, NumberInput, NumberInputProps, OtpInput, OtpInputProps, OverflowMenu, OverflowMenuItem, OverflowMenuProps, Pagination, PaginationLabels, PaginationProps, PasswordInput, PasswordInputLabels, PasswordInputProps, Popover, PopoverContent, PopoverContentProps, PopoverProps, PopoverTrigger, PopoverTriggerProps, Portal, Progress, ProgressBar, ProgressBarProps, ProgressCircle, ProgressCircleProps, ProgressIndicator, ProgressIndicatorProps, ProgressProps, ProgressSize, ProgressStep, ProgressVariant, Prose, ProseProps, PullToRefresh, PullToRefreshProps, QrCode, QrCodeProps, RadialProgress, RadialProgressProps, RadialProgressSize, RadialProgressVariant, Radio, RadioCard, RadioCardGroup, RadioCardGroupProps, RadioCardProps, RadioGroup, RadioGroupProps, RadioProps, RatingGroup, RatingGroupLabels, RatingGroupProps, RelativeTime, RelativeTimeProps, Resizable, ResizableProps, Responsive, ScrollArea, ScrollAreaProps, Search, SearchProps, SegmentedControl, SegmentedControlOption, SegmentedControlProps, Select, SelectOption, SelectProps, Separator, SeparatorProps, Sheet, SheetProps, ShellHeader, ShellHeaderAction, ShellHeaderBrand, ShellHeaderLabels, ShellHeaderNavItem, ShellHeaderNavLink, ShellHeaderNavMenu, ShellHeaderNavMenuItem, ShellHeaderProps, SideNav, SideNavGroup, SideNavItem, SideNavLinkProps, SideNavLinkSubItem, SideNavProps, SideNavSubItem, SideNavTone, Skeleton, SkeletonProps, SkipNavLink, SkipNavLinkProps, SkipNavTarget, SkipNavTargetProps, Slider, SliderProps, SortDirection, SortState, Spacer, SpacerProps, Spinner, SpinnerProps, Stack, StackProps, type StandardSchemaV1, Stat, StatProps, Status, StatusProps, Step, StepState, Steps, StepsProps, StructuredList, StructuredListItem, StructuredListProps, SuspenseBoundary, Swap, SwapMode, SwapProps, SwipeAction, SwipeItem, SwipeItemProps, Switcher, SwitcherEntry, SwitcherLink, SwitcherProps, Tabs, TabsContent, TabsContentProps, TabsList, TabsProps, TabsTrigger, TabsTriggerProps, Tag$1 as Tag, TagProps, TagsInput, TagsInputProps, Text, TextProps, Textarea, TextareaProps, ThemeProvider, type ThemeProviderProps, Tile, TileProps, TimePicker, TimePickerProps, Timeline, TimelineItem, TimelineProps, ToastOptions, ToastProvider, ToastVariant, Toc, TocItem, TocProps, Toggle, ToggleGroup, ToggleGroupItem, ToggleGroupProps, ToggleProps, Toggletip, ToggletipPlacement, ToggletipProps, Tooltip, TooltipProps, TreeNode, TreeView, TreeViewProps, UploaderFile, type UsePopoverOptions, type UsePopoverReturn, type UseTocFromRegionOptions, User, UserProps, VisuallyHidden, VisuallyHiddenProps, createForm, dismissAllToasts, fuzzyMatch, fuzzyScore, getLinkComponent, setLinkComponent, setTheme, themePreloadScript, treeViewMessages, useForm, usePopover, useTheme, useToast, useTocFromRegion };

package/dist/index.js

@@ -0,0 +1,2 @@
+'use client';
+export * from './react/src/index.js';