beez-ui 2.7.1 → 3.0.1

package/dist/constants/dialog.d.ts

@@ -1,6 +1,11 @@
-/** Tuning shared by the Arc surfaces of `Dialog` and `AlertDialog`. */
+/** Tuning and default copy shared by the Arc surfaces of `Dialog` and its `alert` mode. */
 /** Vertical offsets, in em, of a changed title or description rising in and lifting out while the dialog is open. */
 export declare const DIALOG_TEXT_SWAP_OFFSET_EM: {
     readonly enter: 0.3;
     readonly exit: -0.3;
 };
+/** Default Spanish copy of Dialog; the close button name can be overridden with `closeLabel`. */
+export declare const DIALOG_DEFAULT_COPY: {
+    /** Accessible name of the built-in close button (Arc's "Close dialog"). */
+    readonly closeLabel: "Cerrar diálogo";
+};

package/dist/constants/dialog.js

@@ -1,6 +1,10 @@
-/** Tuning shared by the Arc surfaces of `Dialog` and `AlertDialog`. */
+/** Tuning and default copy shared by the Arc surfaces of `Dialog` and its `alert` mode. */
 /** Vertical offsets, in em, of a changed title or description rising in and lifting out while the dialog is open. */
 export const DIALOG_TEXT_SWAP_OFFSET_EM = {
 	enter: .3,
 	exit: -.3
 };
+/** Default Spanish copy of Dialog; the close button name can be overridden with `closeLabel`. */
+export const DIALOG_DEFAULT_COPY = { 
+/** Accessible name of the built-in close button (Arc's "Close dialog"). */
+closeLabel: "Cerrar diálogo" };

package/dist/constants/dropdown-menu.d.ts

@@ -1,5 +1,5 @@
-/** Placement defaults of `DropdownMenuContent` and `DropdownMenuSubContent`, taken from Arc's Dropdown menu. */
+/** Placement defaults of the dropdown menu content, taken from Arc's Dropdown menu. */
 /** Gap, in pixels, between the trigger and the menu. */
 export declare const DROPDOWN_MENU_SIDE_OFFSET_PX = 6;
-/** Minimum distance, in pixels, a menu or submenu keeps from the viewport edges. */
+/** Minimum distance, in pixels, a menu keeps from the viewport edges. */
 export declare const DROPDOWN_MENU_COLLISION_PADDING_PX = 12;

package/dist/constants/dropdown-menu.js

@@ -1,5 +1,5 @@
-/** Placement defaults of `DropdownMenuContent` and `DropdownMenuSubContent`, taken from Arc's Dropdown menu. */
+/** Placement defaults of the dropdown menu content, taken from Arc's Dropdown menu. */
 /** Gap, in pixels, between the trigger and the menu. */
 export const DROPDOWN_MENU_SIDE_OFFSET_PX = 6;
-/** Minimum distance, in pixels, a menu or submenu keeps from the viewport edges. */
+/** Minimum distance, in pixels, a menu keeps from the viewport edges. */
 export const DROPDOWN_MENU_COLLISION_PADDING_PX = 12;

package/dist/constants/pagination.d.ts

@@ -1,9 +1,20 @@
-/** Default Spanish copy of Pagination; every value can be overridden through props. */
+/** Default Spanish copy and window of Arc's Pagination. */
+/** Default Spanish copy of Pagination; the landmark and arrow copy can be overridden through props. */
 export declare const PAGINATION_DEFAULT_COPY: {
+    /** Accessible name of the navigation landmark (Arc's "Pagination"). */
     readonly navigationLabel: "Paginación";
+    /** Visible label of the previous arrow. */
     readonly previousText: "Anterior";
+    /** Visible label of the next arrow. */
     readonly nextText: "Siguiente";
+    /** Accessible name of the previous arrow while it keeps its default label (Arc's "Previous page"). */
     readonly previousLabel: "Ir a la página anterior";
+    /** Accessible name of the next arrow while it keeps its default label (Arc's "Next page"). */
     readonly nextLabel: "Ir a la página siguiente";
-    readonly morePages: "Más páginas";
+    /** Word before the number in the accessible name of each page (Arc's "Page 3"). */
+    readonly pageLabelPrefix: "Página";
 };
+/** Pages shown at once: Arc's five page window, so the control keeps one width on any screen. */
+export declare const PAGINATION_WINDOW_SIZE = 5;
+/** First page number: pages are 1-based. */
+export declare const PAGINATION_FIRST_PAGE = 1;

package/dist/constants/pagination.js

@@ -1,9 +1,20 @@
-/** Default Spanish copy of Pagination; every value can be overridden through props. */
+/** Default Spanish copy and window of Arc's Pagination. */
+/** Default Spanish copy of Pagination; the landmark and arrow copy can be overridden through props. */
 export const PAGINATION_DEFAULT_COPY = {
+	/** Accessible name of the navigation landmark (Arc's "Pagination"). */
 	navigationLabel: "Paginación",
+	/** Visible label of the previous arrow. */
 	previousText: "Anterior",
+	/** Visible label of the next arrow. */
 	nextText: "Siguiente",
+	/** Accessible name of the previous arrow while it keeps its default label (Arc's "Previous page"). */
 	previousLabel: "Ir a la página anterior",
+	/** Accessible name of the next arrow while it keeps its default label (Arc's "Next page"). */
 	nextLabel: "Ir a la página siguiente",
-	morePages: "Más páginas"
+	/** Word before the number in the accessible name of each page (Arc's "Page 3"). */
+	pageLabelPrefix: "Página"
 };
+/** Pages shown at once: Arc's five page window, so the control keeps one width on any screen. */
+export const PAGINATION_WINDOW_SIZE = 5;
+/** First page number: pages are 1-based. */
+export const PAGINATION_FIRST_PAGE = 1;

package/dist/constants/select.d.ts

@@ -1,3 +1,5 @@
-/** Placement defaults of `SelectContent`, taken from Arc's Select. */
-/** Minimum distance, in pixels, a `position="popper"` list keeps from the viewport edges. */
+/** Placement defaults and copy of Arc's Select. */
+/** Minimum distance, in pixels, the option list keeps from the viewport edges. */
 export declare const SELECT_COLLISION_PADDING_PX = 12;
+/** Default Spanish placeholder, shown while no option is chosen. Arc's English default is "Select an option". */
+export declare const SELECT_DEFAULT_PLACEHOLDER = "Seleccion\u00E1 una opci\u00F3n";

package/dist/constants/select.js

@@ -1,3 +1,5 @@
-/** Placement defaults of `SelectContent`, taken from Arc's Select. */
-/** Minimum distance, in pixels, a `position="popper"` list keeps from the viewport edges. */
+/** Placement defaults and copy of Arc's Select. */
+/** Minimum distance, in pixels, the option list keeps from the viewport edges. */
 export const SELECT_COLLISION_PADDING_PX = 12;
+/** Default Spanish placeholder, shown while no option is chosen. Arc's English default is "Select an option". */
+export const SELECT_DEFAULT_PLACEHOLDER = "Seleccioná una opción";

package/dist/constants/switch.d.ts

@@ -1,25 +1,14 @@
 /** Tuning of Arc's Switch thumb, adapted from Arc (https://uiarc.dev, MIT License, see THIRD_PARTY_NOTICES.md). */
-/** Sizes the switch accepts; `default` is Arc's 42 by 24 track and `sm` a compact one for dense rows. */
-export type SwitchSize = "default" | "sm";
 /**
- * Thumb geometry per size, in pixels: its resting width and how far it travels, which is the track's inner width
- * minus the thumb. Keep in sync with the track and thumb sizes in `switch.tsx`.
+ * Thumb geometry on Arc's 42 by 24 track, in pixels: its resting width and how far it travels, which is the track's
+ * inner width minus the thumb. Keep in sync with the track and thumb sizes in `switch.tsx`.
  */
 export declare const SWITCH_THUMB_GEOMETRY_PX: {
-    readonly default: {
-        readonly size: 18;
-        readonly travel: 18;
-    };
-    readonly sm: {
-        readonly size: 14;
-        readonly travel: 14;
-    };
+    readonly size: 18;
+    readonly travel: 18;
 };
 /** How far, in pixels, the thumb widens toward the other side while it is held down. */
-export declare const SWITCH_PRESS_STRETCH_PX: {
-    readonly default: 5;
-    readonly sm: 4;
-};
+export declare const SWITCH_PRESS_STRETCH_PX = 5;
 /** Critically damped glide: the thumb lands on its end without overshooting the state it reports. */
 export declare const SWITCH_THUMB_GLIDE_SPRING: {
     readonly type: "spring";

package/dist/constants/switch.js

@@ -1,22 +1,14 @@
+/** Tuning of Arc's Switch thumb, adapted from Arc (https://uiarc.dev, MIT License, see THIRD_PARTY_NOTICES.md). */
 /**
-* Thumb geometry per size, in pixels: its resting width and how far it travels, which is the track's inner width
-* minus the thumb. Keep in sync with the track and thumb sizes in `switch.tsx`.
+* Thumb geometry on Arc's 42 by 24 track, in pixels: its resting width and how far it travels, which is the track's
+* inner width minus the thumb. Keep in sync with the track and thumb sizes in `switch.tsx`.
 */
 export const SWITCH_THUMB_GEOMETRY_PX = {
-	default: {
-		size: 18,
-		travel: 18
-	},
-	sm: {
-		size: 14,
-		travel: 14
-	}
+	size: 18,
+	travel: 18
 };
 /** How far, in pixels, the thumb widens toward the other side while it is held down. */
-export const SWITCH_PRESS_STRETCH_PX = {
-	default: 5,
-	sm: 4
-};
+export const SWITCH_PRESS_STRETCH_PX = 5;
 /** Critically damped glide: the thumb lands on its end without overshooting the state it reports. */
 export const SWITCH_THUMB_GLIDE_SPRING = {
 	type: "spring",

package/dist/hooks/use-today.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Arc's `useToday`: the viewer's local date at midnight. It is `undefined` while rendering on the server and during
+ * hydration, so markup never depends on the server clock, and it moves to the next day when the viewer's midnight
+ * passes. The same `Date` instance is returned until the day changes.
+ * @returns Today at 00:00 in the viewer's time zone, or `undefined` before hydration.
+ */
+export declare function useToday(): Date | undefined;

package/dist/hooks/use-today.js

@@ -0,0 +1,50 @@
+"use client";
+import { c as _c } from "react/compiler-runtime";
+/** The viewer's local date, kept out of server and hydration renders and refreshed at midnight. */
+import { useEffect, useState } from "react";
+import { useIsHydrated } from "./use-is-hydrated.js";
+/**
+* Midnight that starts the viewer's current local day.
+* @returns Today at 00:00 in the viewer's time zone.
+*/
+function startOfLocalToday() {
+	const now = new Date();
+	return new Date(now.getFullYear(), now.getMonth(), now.getDate());
+}
+/**
+* Milliseconds until the next local midnight, measured from now.
+* @param today - Start of the current local day.
+* @returns The delay before the day changes.
+*/
+function getDelayUntilNextDay(today) {
+	const nextDay = new Date(today.getFullYear(), today.getMonth(), today.getDate() + 1);
+	return Math.max(0, nextDay.getTime() - Date.now());
+}
+/**
+* Arc's `useToday`: the viewer's local date at midnight. It is `undefined` while rendering on the server and during
+* hydration, so markup never depends on the server clock, and it moves to the next day when the viewer's midnight
+* passes. The same `Date` instance is returned until the day changes.
+* @returns Today at 00:00 in the viewer's time zone, or `undefined` before hydration.
+*/
+export function useToday() {
+	const $ = _c(3);
+	const isHydrated = useIsHydrated();
+	const [today, setToday] = useState(startOfLocalToday);
+	let t0;
+	let t1;
+	if ($[0] !== today) {
+		t0 = () => {
+			const timeout = window.setTimeout(() => setToday(startOfLocalToday()), getDelayUntilNextDay(today));
+			return () => window.clearTimeout(timeout);
+		};
+		t1 = [today];
+		$[0] = today;
+		$[1] = t0;
+		$[2] = t1;
+	} else {
+		t0 = $[1];
+		t1 = $[2];
+	}
+	useEffect(t0, t1);
+	return isHydrated ? today : undefined;
+}

package/dist/hooks.d.ts

@@ -4,6 +4,7 @@
  */
 export { useIsMobile } from "./hooks/use-mobile.js";
 export { useIsHydrated } from "./hooks/use-is-hydrated.js";
+export { useToday } from "./hooks/use-today.js";
 export { usePrefersReducedMotion } from "./hooks/use-prefers-reduced-motion.js";
 export { useViewerTimeZone } from "./hooks/use-viewer-time-zone.js";
 export { useHorizontalSwipe, type HorizontalSwipeHandlers } from "./hooks/use-horizontal-swipe.js";

package/dist/hooks.js

@@ -4,6 +4,7 @@
 */
 export { useIsMobile } from "./hooks/use-mobile.js";
 export { useIsHydrated } from "./hooks/use-is-hydrated.js";
+export { useToday } from "./hooks/use-today.js";
 export { usePrefersReducedMotion } from "./hooks/use-prefers-reduced-motion.js";
 export { useViewerTimeZone } from "./hooks/use-viewer-time-zone.js";
 export { useHorizontalSwipe } from "./hooks/use-horizontal-swipe.js";

package/dist/index.d.ts

@@ -4,7 +4,6 @@ export { Link, type LinkProps } from "./components/link.js";
 export { BeezUIProvider, type BeezUIProviderProps } from "./providers/native-provider.js";
 export type { BeezUIComponents, BeezImageProps, BeezLinkProps } from "./providers/beez-ui-provider.js";
 export * from "./components/action-button.js";
-export * from "./components/alert-dialog.js";
 export * from "./components/avatar.js";
 export * from "./components/badge.js";
 export * from "./components/button.js";

package/dist/index.js

@@ -3,7 +3,6 @@ export { useTheme } from "next-themes";
 export { Link } from "./components/link.js";
 export { BeezUIProvider } from "./providers/native-provider.js";
 export * from "./components/action-button.js";
-export * from "./components/alert-dialog.js";
 export * from "./components/avatar.js";
 export * from "./components/badge.js";
 export * from "./components/button.js";

package/dist/motion/glide-indicator.d.ts

@@ -28,7 +28,7 @@ export declare const GLIDE_PRESETS: {
         containerSelector: string;
         attributes: string[];
         isActive: (item: Element) => boolean;
-        surface: (container: HTMLElement) => "after" | "background";
+        surface: () => "background";
         spring: {
             readonly type: "spring";
             readonly visualDuration: 0.42;

package/dist/motion/glide-indicator.js

@@ -12,7 +12,7 @@ export const GLIDE_PRESETS = {
 		containerSelector: "[role=\"tablist\"]",
 		attributes: ["data-state"],
 		isActive: (item) => item.getAttribute("data-state") === "active",
-		surface: (container) => container.getAttribute("data-variant") === "line" ? "after" : "background",
+		surface: () => "background",
 		// Arc glides the tab highlight and the current page mark with its morph spring.
 		spring: ARC_SPRING_MORPH
 	},

package/dist/motion/presence.d.ts

@@ -6,7 +6,6 @@ declare const OPEN_CONTEXTS: {
     "alert-dialog": import("react").Context<boolean>;
     sheet: import("react").Context<boolean>;
     "dropdown-menu": import("react").Context<boolean>;
-    "dropdown-sub": import("react").Context<boolean>;
     popover: import("react").Context<boolean>;
     "hover-card": import("react").Context<boolean>;
     tooltip: import("react").Context<boolean>;

package/dist/motion/presence.js

@@ -10,7 +10,6 @@ const OPEN_CONTEXTS = {
 	"alert-dialog": createContext(true),
 	sheet: createContext(true),
 	"dropdown-menu": createContext(true),
-	"dropdown-sub": createContext(true),
 	popover: createContext(true),
 	"hover-card": createContext(true),
 	tooltip: createContext(true)