@adgytec/adgytec-web-ui-components 2.3.0 → 2.3.1

package/dist/components/Button/core/color.d.ts

@@ -1,9 +1,47 @@
+/**
+ * Fundamental Material 3 button color styles shared across all button variants:
+ * - `"filled"`: High-emphasis solid surface with inverted text.
+ * - `"tonal"`: Medium-high emphasis filled container with primary-tonal background.
+ * - `"outlined"`: Medium-emphasis button with container outline and transparent background.
+ */
 export type CoreButtonColor = "filled" | "tonal" | "outlined";
+/**
+ * Color variants supported by standard buttons (`Button`, `LinkButton`):
+ * - Includes {@link CoreButtonColor} (`"filled"`, `"tonal"`, `"outlined"`).
+ * - `"elevated"`: Low-emphasis surface container with shadow elevation.
+ * - `"text"`: Lowest-emphasis flat text button with transparent background.
+ */
 export type ButtonColor = CoreButtonColor | "elevated" | "text";
+/**
+ * Color variants supported by toggle buttons (`ToggleButton`):
+ * - Includes {@link CoreButtonColor} plus `"elevated"`.
+ */
 export type ToggleButtonColor = CoreButtonColor | "elevated";
+/**
+ * Color variants supported by icon buttons (`IconButton`, `LinkIconButton`):
+ * - Includes {@link CoreButtonColor} plus `"standard"` (unfilled, frameless icon).
+ */
 export type IconButtonColor = CoreButtonColor | "standard";
+/**
+ * Color variants supported by split buttons (`SplitButton`):
+ * - Includes {@link CoreButtonColor} plus `"elevated"`.
+ */
 export type SplitButtonColor = CoreButtonColor | "elevated";
+/**
+ * Color variants supported by connected button groups (`ConnectedButtonGroup`):
+ * - Includes {@link CoreButtonColor} plus `"elevated"`.
+ */
 export type ConnectedButtonGroupColor = CoreButtonColor | "elevated";
+/**
+ * Union of all valid button color style names across all button components.
+ */
 export type AllButtonColor = ButtonColor | IconButtonColor | SplitButtonColor | ConnectedButtonGroupColor;
+/**
+ * Resolves a button color style name to its CSS module class name.
+ *
+ * @param color - The button color identifier.
+ * @returns CSS class name applying the color styling rules.
+ */
 export declare const buttonColorConfig: (color: AllButtonColor) => string;
+/** CSS class providing base color custom properties and transition states. */
 export declare const buttonColorBase: string;

package/dist/components/Button/core/shape.d.ts

@@ -1 +1,7 @@
+/**
+ * Supported corner rounding styles for button components.
+ *
+ * - `"round"`: Full border-radius (pill shape for labeled buttons, circular for icon buttons).
+ * - `"square"`: Slightly rounded rectangular corners.
+ */
 export type ButtonShape = "round" | "square";

package/dist/components/Button/core/sizes.d.ts

@@ -1,6 +1,32 @@
+/**
+ * Supported size presets for button and button group components.
+ * Controls dimensions, typography, icon scale, and internal padding.
+ */
 export type ButtonSize = "extra-small" | "small" | "medium" | "large" | "extra-large";
+/**
+ * Maps each {@link ButtonSize} preset to its recommended icon size in pixels
+ * for standard labeled buttons (with leading or trailing icons).
+ */
 export declare const ButtonIconSizeMapping: Record<ButtonSize, number>;
+/**
+ * Maps each {@link ButtonSize} preset to its recommended icon size in pixels
+ * for icon-only buttons (e.g. `IconButton`, `ToggleIconButton`, `LinkIconButton`).
+ * Note that the `"small"` preset uses 24px for icon buttons compared to 20px in labeled buttons.
+ */
 export declare const IconButtonIconSizeMapping: Record<ButtonSize, number>;
+/**
+ * Maps each {@link ButtonSize} preset to its typography token class name
+ * for button label text.
+ */
 export declare const ButtonLabelTextMapping: Record<ButtonSize, string>;
+/**
+ * Resolves the CSS module class name for a given button size preset.
+ *
+ * @param size - The button size preset to retrieve styling for.
+ * @returns The CSS module class name corresponding to the specified size.
+ */
 export declare const buttonSizeConfig: (size: ButtonSize) => string;
+/**
+ * Base CSS module class name applying common layout and sizing structure across buttons.
+ */
 export declare const ButtonSizeBase: string;

package/dist/components/Button/core/useButtonConfig.d.ts

@@ -1,12 +1,37 @@
 import { ButtonIconPlacement } from './button';
 import { ButtonShape } from './shape';
 import { ButtonSize } from './sizes';
+/**
+ * Configuration options passed to {@link useButtonConfig} to resolve button styles.
+ */
 type ButtonConfigOptions<C extends string> = {
+    /** Explicit button size preset override. */
     size?: ButtonSize;
+    /** Explicit button corner shape override. */
     shape?: ButtonShape;
+    /** Explicit button color style override. */
     color?: C;
+    /** Explicit icon placement override relative to label. */
     iconPlacement?: ButtonIconPlacement;
 };
+/**
+ * Resolves button configuration by prioritizing component-level props and falling back
+ * to contextual values from an ancestor `ButtonGroupContext` (or system defaults).
+ *
+ * @template C - String union of allowed color variant values for the button type.
+ * @param options - Component-level prop overrides.
+ * @returns Resolved visual configuration: `buttonSize`, `buttonShape`, `buttonColor`, and `buttonIconPlacement`.
+ *
+ * @example
+ * ```tsx
+ * const { buttonSize, buttonShape, buttonColor, buttonIconPlacement } = useButtonConfig({
+ *     size,
+ *     shape,
+ *     color,
+ *     iconPlacement,
+ * });
+ * ```
+ */
 export declare function useButtonConfig<C extends string>({ size, shape, color, iconPlacement, }: ButtonConfigOptions<C>): {
     buttonSize: ButtonSize;
     buttonShape: ButtonShape;

package/dist/components/Button/core/variant.d.ts

@@ -1 +1,7 @@
+/**
+ * Base button style variant distinguishing standard push buttons from toggle state buttons.
+ *
+ * - `"default"`: Standard interactive push button styling.
+ * - `"toggle"`: Stateful button styling supporting active/pressed selection states.
+ */
 export type ButtonVariant = "default" | "toggle";

package/dist/components/Button/core/width.d.ts

@@ -1 +1,8 @@
+/**
+ * Width sizing options for icon buttons.
+ *
+ * - `"narrow"`: Compact width variant for tighter layouts.
+ * - `"default"`: Standard square/circular aspect ratio matching button height.
+ * - `"wide"`: Expanded horizontal padding for larger tap targets or elongated pill buttons.
+ */
 export type IconButtonWidth = "narrow" | "default" | "wide";

package/dist/components/Button/core/withTooltip.d.ts

@@ -1,2 +1,9 @@
-import { ReactElement } from 'react';
-export declare const withTooltip: (element: ReactElement, tooltip?: string) => import("react").JSX.Element;
+import { ReactNode } from 'react';
+/**
+ * Conditionally wraps a React node in a tooltip trigger when tooltip text is provided.
+ *
+ * @param node - The React element to display (e.g. button or icon button).
+ * @param tooltip - The optional tooltip text to show on hover/focus. If omitted or empty, `node` is returned unwrapped.
+ * @returns The wrapped element with tooltip, or the original node if no tooltip was supplied.
+ */
+export declare const withTooltip: (node: ReactNode, tooltip?: string) => string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import('react').JSX.Element | null | undefined;

package/dist/components/Calendar/BaseCalendar/BaseCalendar.d.ts

@@ -1,5 +1,26 @@
 import { WeekdayStyle } from '../core';
-export declare const BaseCalendar: React.FC<{
+/**
+ * Props for the {@link BaseCalendar} component.
+ */
+export interface BaseCalendarProps {
+    /** Whether the calendar is operating in range selection mode. */
     isRangeCalendar?: boolean;
+    /** Formatting style for weekday column headers. */
     weekdayStyle?: WeekdayStyle;
-}>;
+    /** Accessible label for the previous month button. */
+    previousMonthAriaLabel?: string;
+    /** Accessible label for the next month button. */
+    nextMonthAriaLabel?: string;
+    /** Accessible label for the previous year button. */
+    previousYearAriaLabel?: string;
+    /** Accessible label for the next year button. */
+    nextYearAriaLabel?: string;
+}
+/**
+ * Core calendar layout and view orchestrator.
+ *
+ * Manages the calendar header with navigation controls (prev/next month, prev/next year,
+ * month/year dropdown buttons), animated transitions between grid, month, and year views,
+ * and maintains anchor date state during view changes in range selection mode.
+ */
+export declare const BaseCalendar: React.FC<BaseCalendarProps>;

package/dist/components/Calendar/Calendar/Calendar.d.ts

@@ -1,5 +1,42 @@
 import { Calendar as AriaCalendar } from 'react-aria-components';
 import { WeekdayStyle } from '../core';
-export declare const Calendar: React.FC<Omit<React.ComponentPropsWithRef<typeof AriaCalendar>, "children" | "visibleDuration" | "pageBehavior"> & {
+/**
+ * Props for the {@link Calendar} component.
+ * Extends React Aria's `Calendar` props (excluding `children`, `visibleDuration`, and `pageBehavior`).
+ */
+export interface CalendarProps extends Omit<React.ComponentPropsWithRef<typeof AriaCalendar>, "children" | "visibleDuration" | "pageBehavior"> {
+    /**
+     * Formatting style for weekday column headers in the calendar grid.
+     *
+     * - `"narrow"`: Typically a single character (e.g. "S", "M", "T").
+     * - `"short"`: Abbreviated weekday name (e.g. "Sun", "Mon", "Tue").
+     */
     weekdayStyle?: WeekdayStyle;
-}>;
+    /** Accessible label for the previous month button. */
+    previousMonthAriaLabel?: string;
+    /** Accessible label for the next month button. */
+    nextMonthAriaLabel?: string;
+    /** Accessible label for the previous year button. */
+    previousYearAriaLabel?: string;
+    /** Accessible label for the next year button. */
+    nextYearAriaLabel?: string;
+}
+/**
+ * A single date selection calendar component implementing Material Design 3 Date Picker guidelines.
+ *
+ * Features an interactive date grid, fast month and year selector menus, localized date formatting,
+ * keyboard accessibility, and touch-responsive ripple effects. Built on top of React Aria's `Calendar`.
+ *
+ * @example
+ * ```tsx
+ * import { Calendar } from '@adgytec/web-ui-components';
+ * import { today, getLocalTimeZone } from '@internationalized/date';
+ *
+ * <Calendar
+ *     aria-label="Appointment date"
+ *     minValue={today(getLocalTimeZone())}
+ *     onChange={(date) => console.log('Selected date:', date)}
+ * />
+ * ```
+ */
+export declare const Calendar: React.FC<CalendarProps>;

package/dist/components/Calendar/Calendar/index.js

@@ -6,19 +6,25 @@ import { jsx as i } from "react/jsx-runtime";
 import { Calendar as a } from "react-aria-components";
 //#region src/components/Calendar/Calendar/Calendar.tsx
 var o = e(), s = (e) => {
-	let s = (0, o.c)(12), c, l, u;
-	s[0] === e ? (c = s[1], l = s[2], u = s[3]) : ({weekdayStyle: u, className: c, ...l} = e, s[0] = e, s[1] = c, s[2] = l, s[3] = u);
-	let d;
-	s[4] === c ? d = s[5] : (d = (e) => r(t, typeof c == "function" ? c(e) : c), s[4] = c, s[5] = d);
-	let f;
-	s[6] === u ? f = s[7] : (f = /* @__PURE__ */ i(n, { weekdayStyle: u }), s[6] = u, s[7] = f);
-	let p;
-	return s[8] !== l || s[9] !== d || s[10] !== f ? (p = /* @__PURE__ */ i(a, {
-		className: d,
-		...l,
+	let s = (0, o.c)(20), c, l, u, d, f, p, m;
+	s[0] === e ? (c = s[1], l = s[2], u = s[3], d = s[4], f = s[5], p = s[6], m = s[7]) : ({weekdayStyle: m, className: c, previousMonthAriaLabel: d, nextMonthAriaLabel: l, previousYearAriaLabel: f, nextYearAriaLabel: u, ...p} = e, s[0] = e, s[1] = c, s[2] = l, s[3] = u, s[4] = d, s[5] = f, s[6] = p, s[7] = m);
+	let h;
+	s[8] === c ? h = s[9] : (h = (e) => r(t, typeof c == "function" ? c(e) : c), s[8] = c, s[9] = h);
+	let g;
+	s[10] !== l || s[11] !== u || s[12] !== d || s[13] !== f || s[14] !== m ? (g = /* @__PURE__ */ i(n, {
+		weekdayStyle: m,
+		previousMonthAriaLabel: d,
+		nextMonthAriaLabel: l,
+		previousYearAriaLabel: f,
+		nextYearAriaLabel: u
+	}), s[10] = l, s[11] = u, s[12] = d, s[13] = f, s[14] = m, s[15] = g) : g = s[15];
+	let _;
+	return s[16] !== p || s[17] !== h || s[18] !== g ? (_ = /* @__PURE__ */ i(a, {
+		className: h,
+		...p,
 		"data-calendar": !0,
-		children: f
-	}), s[8] = l, s[9] = d, s[10] = f, s[11] = p) : p = s[11], p;
+		children: g
+	}), s[16] = p, s[17] = h, s[18] = g, s[19] = _) : _ = s[19], _;
 };
 //#endregion
 export { s as Calendar };

package/dist/components/Calendar/Calendar/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["weekdayStyle"],"sources":["../../../../src/components/Calendar/Calendar/Calendar.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { Calendar as AriaCalendar } from \"react-aria-components\";\nimport { BaseCalendar } from \"../BaseCalendar\";\nimport { CalendarBaseStyles, type WeekdayStyle } from \"../core\";\n\nexport const Calendar: React.FC<\n    Omit<\n        React.ComponentPropsWithRef<typeof AriaCalendar>,\n        \"children\" | \"visibleDuration\" | \"pageBehavior\"\n    > & {\n        weekdayStyle?: WeekdayStyle;\n    }\n> = ({ weekdayStyle, className, ...props }) => {\n    return (\n        <AriaCalendar\n            className={(renderProps) =>\n                clsx(\n                    CalendarBaseStyles,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            data-calendar\n        >\n            <BaseCalendar weekdayStyle={weekdayStyle} />\n        </AriaCalendar>\n    );\n};\n"],"mappings":";;;;;;;aAKa,KAOT,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,EAAA,GAAA,GAAA,GAAA;CAAA,AAAA,EAAA,OAAA,KAAsC,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,OAArC,mCAAA,KAAA,GAAqC,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,IASzB,IAAA,EAAA,MANM,KAAA,MACP,EACI,GACA,OAAO,KAAc,aACf,EAAU,CACF,IAFd,CAGJ,GAAC,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,IAKuC,IAAA,EAAA,MAA5C,IAAA,kBAAC,GAAD,EAA4B,gBAAY,CAAA,GAAI,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CACjC,OADiC,EAAA,OAAA,KAAA,EAAA,OAAA,KAAA,EAAA,QAAA,KAZhD,IAAA,kBAAC,GAAD;EACe,WAAA;EAMN,GAED;EACJ,iBAAA;YAEA;CAZS,CAAA,GAaE,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA,KAbf;AAae"}
+{"version":3,"file":"index.js","names":["weekdayStyle","previousMonthAriaLabel","nextMonthAriaLabel","previousYearAriaLabel","nextYearAriaLabel","_c","clsx","AriaCalendar","require_compiler_runtime","CalendarBaseStyles","BaseCalendar","clsx$1","Calendar$1","import_compiler_runtime","Calendar","$","className","nextMonthAriaLabel","nextYearAriaLabel","previousMonthAriaLabel","previousYearAriaLabel","props","weekdayStyle","t0","t1","renderProps","t2","t3"],"sources":["../../../../src/components/Calendar/Calendar/Calendar.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { Calendar as AriaCalendar } from \"react-aria-components\";\nimport { BaseCalendar } from \"../BaseCalendar\";\nimport { CalendarBaseStyles, type WeekdayStyle } from \"../core\";\n\n/**\n * Props for the {@link Calendar} component.\n * Extends React Aria's `Calendar` props (excluding `children`, `visibleDuration`, and `pageBehavior`).\n */\nexport interface CalendarProps\n    extends Omit<\n        React.ComponentPropsWithRef<typeof AriaCalendar>,\n        \"children\" | \"visibleDuration\" | \"pageBehavior\"\n    > {\n    /**\n     * Formatting style for weekday column headers in the calendar grid.\n     *\n     * - `\"narrow\"`: Typically a single character (e.g. \"S\", \"M\", \"T\").\n     * - `\"short\"`: Abbreviated weekday name (e.g. \"Sun\", \"Mon\", \"Tue\").\n     */\n    weekdayStyle?: WeekdayStyle;\n\n    /** Accessible label for the previous month button. */\n    previousMonthAriaLabel?: string;\n\n    /** Accessible label for the next month button. */\n    nextMonthAriaLabel?: string;\n\n    /** Accessible label for the previous year button. */\n    previousYearAriaLabel?: string;\n\n    /** Accessible label for the next year button. */\n    nextYearAriaLabel?: string;\n}\n\n/**\n * A single date selection calendar component implementing Material Design 3 Date Picker guidelines.\n *\n * Features an interactive date grid, fast month and year selector menus, localized date formatting,\n * keyboard accessibility, and touch-responsive ripple effects. Built on top of React Aria's `Calendar`.\n *\n * @example\n * ```tsx\n * import { Calendar } from '@adgytec/web-ui-components';\n * import { today, getLocalTimeZone } from '@internationalized/date';\n *\n * <Calendar\n *     aria-label=\"Appointment date\"\n *     minValue={today(getLocalTimeZone())}\n *     onChange={(date) => console.log('Selected date:', date)}\n * />\n * ```\n */\nexport const Calendar: React.FC<CalendarProps> = ({\n    weekdayStyle,\n    className,\n    previousMonthAriaLabel,\n    nextMonthAriaLabel,\n    previousYearAriaLabel,\n    nextYearAriaLabel,\n    ...props\n}) => {\n    return (\n        <AriaCalendar\n            className={(renderProps) =>\n                clsx(\n                    CalendarBaseStyles,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            data-calendar\n        >\n            <BaseCalendar\n                weekdayStyle={weekdayStyle}\n                previousMonthAriaLabel={previousMonthAriaLabel}\n                nextMonthAriaLabel={nextMonthAriaLabel}\n                previousYearAriaLabel={previousYearAriaLabel}\n                nextYearAriaLabel={nextYearAriaLabel}\n            />\n        </AriaCalendar>\n    );\n};\n"],"mappings":";;;;;;;aAqDac,KAAoC,MAAA;CAAA,IAAAC,KAAA,GAAAV,EAAAA,EAAAA,CAAA,EAAA,GAAAW,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC;CAAA,AAAAP,EAAA,OAAAQ,KAQhD,IAAAR,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,OARiD,kIAAA,GAAAM,KAAAE,GAQjD,EAAA,KAAAA,GAAA,EAAA,KAAAP,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC;CAAA,IAAAE;CAAA,AAAAT,EAAA,OAAAC,IASgB,IAAAD,EAAA,MANM,KAAA,MACPT,EACIG,GACA,OAAOO,KAAc,aACfA,EAAUS,CACF,IAFdT,CAGJ,GAAC,EAAA,KAAAA,GAAA,EAAA,KAAAQ;CAAA,IAAAE;CAAA,AAAAX,EAAA,QAAAE,KAAAF,EAAA,QAAAG,KAAAH,EAAA,QAAAI,KAAAJ,EAAA,QAAAK,KAAAL,EAAA,QAAAO,KAKL,IAAA,kBAACZ,GAAD;EACkB;EACU;EACJ;EACG;EACJ;CAAiB,CAAA,GACtC,EAAA,MAAAO,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAE,GAAA,EAAA,MAAAI,KAAA,IAAAX,EAAA;CAAA,IAAAY;CACS,OADTZ,EAAA,QAAAM,KAAAN,EAAA,QAAAS,KAAAT,EAAA,QAAAW,KAlBN,IAAA,kBAACnB,GAAD;EACe,WAAAiB;EAMN,GAEDH;EACJ,iBAAA;EAEA,UAAAK;CAZS,CAAA,GAmBE,EAAA,MAAAL,GAAA,EAAA,MAAAG,GAAA,EAAA,MAAAE,GAAA,EAAA,MAAAC,KAAA,IAAAZ,EAAA,KAnBfY;AAmBe"}

package/dist/components/Calendar/CalendarCell/CalendarCell.d.ts

@@ -1,4 +1,16 @@
 import { CalendarCell as AriaCalendarCell } from 'react-aria-components';
-export declare const CalendarCell: React.FC<Omit<React.ComponentPropsWithRef<typeof AriaCalendarCell>, "children"> & {
+/**
+ * Props for the {@link CalendarCell} component.
+ * Extends React Aria's `CalendarCell` props (excluding `children`).
+ */
+export interface CalendarCellProps extends Omit<React.ComponentPropsWithRef<typeof AriaCalendarCell>, "children"> {
+    /** Whether the cell is being rendered within a range calendar. */
     isRangeCalendar?: boolean;
-}>;
+}
+/**
+ * An individual date cell within the calendar grid.
+ *
+ * Handles day number rendering, selection indicators, range highlight backgrounds
+ * (selection start, in-between range, selection end), and disabled and outside-month styling.
+ */
+export declare const CalendarCell: React.FC<CalendarCellProps>;

package/dist/components/Calendar/CalendarGrid/CalendarGrid.d.ts

@@ -1,4 +1,14 @@
 import { CalendarGrid as AriaCalendarGrid } from 'react-aria-components';
-export declare const CalendarGrid: React.FC<Omit<React.ComponentPropsWithRef<typeof AriaCalendarGrid>, "children" | "className"> & {
+/**
+ * Props for the {@link CalendarGrid} component.
+ * Extends React Aria's `CalendarGrid` props (excluding `children` and `className`).
+ */
+export interface CalendarGridProps extends Omit<React.ComponentPropsWithRef<typeof AriaCalendarGrid>, "children" | "className"> {
+    /** Whether the calendar is operating in range selection mode. */
     isRangeCalendar?: boolean;
-}>;
+}
+/**
+ * Renders the 7-column calendar date grid, including weekday column headers
+ * and day date cells.
+ */
+export declare const CalendarGrid: React.FC<CalendarGridProps>;

package/dist/components/Calendar/CalendarMenuItem/CalendarMenuItem.d.ts

@@ -1,2 +1,13 @@
 import { ListBoxItem } from 'react-aria-components';
-export declare const CalendarMenuItem: React.FC<React.ComponentPropsWithRef<typeof ListBoxItem>>;
+/**
+ * Props for the {@link CalendarMenuItem} component.
+ * Extends React Aria's {@link ListBoxItem} props.
+ */
+export interface CalendarMenuItemProps extends React.ComponentPropsWithRef<typeof ListBoxItem> {
+}
+/**
+ * An individual selectable item within the calendar month and year picker menus.
+ *
+ * Implements Material Design 3 selection styles, focus outlines, and typography.
+ */
+export declare const CalendarMenuItem: React.FC<CalendarMenuItemProps>;

package/dist/components/Calendar/CalendarMonthMenu/CalendarMonthMenu.d.ts

@@ -1,5 +1,17 @@
 import { MonthItem } from '../core';
-export declare const CalendarMonthMenu: React.FC<{
+/**
+ * Props for the {@link CalendarMonthMenu} component.
+ */
+export interface CalendarMonthMenuProps {
+    /** Callback invoked after a month item is selected to return to the calendar view. */
     onSelection: () => void;
+    /** Array of selectable month objects to render in the virtualized list. */
     months: MonthItem[];
-}>;
+}
+/**
+ * A virtualized list menu allowing users to quickly pick a month in the calendar.
+ *
+ * Automatically highlights the currently focused month with a checkmark, disables months
+ * that fall outside the allowable `minValue` / `maxValue` range, and shifts focused date on click.
+ */
+export declare const CalendarMonthMenu: React.FC<CalendarMonthMenuProps>;

package/dist/components/Calendar/CalendarMonthMenu/index.js

@@ -14,12 +14,12 @@ var d = e(), f = (e) => {
 		let r = h.focusedDate.set({
 			month: e.id,
 			day: 1
-		}), o = r.set({ day: r.calendar.getDaysInMonth(r) });
+		}), o = r.set({ day: r.calendar.getDaysInMonth(r) }), s = h.maxValue && r.compare(h.maxValue) > 0 || h.minValue && o.compare(h.minValue) < 0;
 		return /* @__PURE__ */ a(n, {
 			onPress: () => {
 				h.setFocusedDate(h.focusedDate.set({ month: e.id })), p();
 			},
-			isDisabled: (h.maxValue && r.compare(h.maxValue) > 0 || h.minValue && o.compare(h.minValue) < 0) ?? void 0,
+			isDisabled: s ?? void 0,
 			textValue: e.formatted,
 			children: [/* @__PURE__ */ i(c, { children: /* @__PURE__ */ i(t, {
 				icon: u,

package/dist/components/Calendar/CalendarMonthMenu/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Check","ListLayout","months"],"sources":["../../../../src/components/Calendar/CalendarMonthMenu/CalendarMonthMenu.tsx"],"sourcesContent":["import { Check } from \"lucide-react\";\nimport {\n    ListBox,\n    ListLayout,\n    SelectionIndicator,\n    Virtualizer,\n} from \"react-aria-components\";\nimport { Icon } from \"@/components/Icon\";\nimport { CalendarMenuItem } from \"../CalendarMenuItem\";\nimport { type MonthItem, useCalendarState } from \"../core\";\n\nexport const CalendarMonthMenu: React.FC<{\n    onSelection: () => void;\n    months: MonthItem[];\n}> = ({ onSelection, months }) => {\n    const state = useCalendarState();\n\n    return (\n        <Virtualizer layout={ListLayout}>\n            <ListBox\n                aria-label=\"month selection\"\n                autoFocus\n                data-menu\n                items={months}\n                selectionMode=\"single\"\n                selectedKeys={[state.focusedDate.month]}\n            >\n                {(item) => {\n                    const nextDate = state.focusedDate.set({\n                        month: item.id,\n                        day: 1,\n                    });\n\n                    const endOfMonth = nextDate.set({\n                        day: nextDate.calendar.getDaysInMonth(nextDate),\n                    });\n\n                    const monthCompletelyInvalid =\n                        (state.maxValue &&\n                            nextDate.compare(state.maxValue) > 0) ||\n                        (state.minValue &&\n                            endOfMonth.compare(state.minValue) < 0);\n\n                    return (\n                        <CalendarMenuItem\n                            onPress={() => {\n                                state.setFocusedDate(\n                                    state.focusedDate.set({ month: item.id })\n                                );\n                                onSelection();\n                            }}\n                            isDisabled={monthCompletelyInvalid ?? undefined}\n                            textValue={item.formatted}\n                        >\n                            <SelectionIndicator>\n                                <Icon\n                                    icon={Check}\n                                    size={24}\n                                    data-selected-icon\n                                />\n                            </SelectionIndicator>\n                            {item.formatted}\n                        </CalendarMenuItem>\n                    );\n                }}\n            </ListBox>\n        </Virtualizer>\n    );\n};\n"],"mappings":";;;;;;;;aAWa,KAGR,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,CAAA,GAAC,EAAA,gBAAA,cAAA,GACF,IAAc,EAAiB,GAAE;CAAA,AAAA,EAAA,OAAA,EAAA,YAAA,QAUkB,IAAA,EAAA,MAAzB,IAAA,CAAC,EAAK,YAAY,KAAM,GAAC,EAAA,KAAA,EAAA,YAAA,OAAA,EAAA,KAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,KAAA,EAAA,OAAA,KAEtC,KAAA,MAAA;EACG,IAAA,IAAiB,EAAK,YAAY,IAAK;GAAA,OAC5B,EAAI;GAAG,KACT;EACT,CAAC,GAED,IAAmB,EAAQ,IAAK,EAAA,KACvB,EAAQ,SAAS,eAAgB,CAAQ,EAClD,CAAC;EAM+C,OAG5C,kBAAC,GAAD;GACa,eAAA;IAIL,AAHA,EAAK,eACD,EAAK,YAAY,IAAK,EAAA,OAAS,EAAI,GAAI,CAAC,CAC5C,GACA,EAAY;GAAC;GAEL,aAbf,EAAK,YACF,EAAQ,QAAS,EAAK,QAAS,IAAI,KACtC,EAAK,YACF,EAAU,QAAS,EAAK,QAAS,IAAI,MAUzB,KAAA;GACD,WAAA,EAAI;aARnB,CAUI,kBAAC,GAAD,EAAA,UACI,kBAAC,GAAD;IACUA,MAAA;IACA,MAAA;IACN,sBAAA;GAAkB,CAAA,EAJP,CAAA,GAOlB,EAAI,SAjBQ;;CAkBE,GAE1B,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAEK,OAFL,EAAA,OAAA,KAAA,EAAA,OAAA,KAAA,EAAA,OAAA,KA9CT,IAAA,kBAAC,GAAD;EAAqBC,QAAA;YACjB,kBAAC,GAAD;GACe,cAAA;GACX,WAAA;GACA,aAAA;GACOC,OAAA;GACO,eAAA;GACA,cAAA;aAEb;EARG,CAAA;CADA,CAAA,GAgDE,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA,IAhDd;AAgDc"}
+{"version":3,"file":"index.js","names":["Check","ListLayout","months","_c","require_compiler_runtime","CalendarMenuItem","useCalendarState","import_compiler_runtime","CalendarMonthMenu","$","t0","state","t1","t2","onSelection","nextDate","item","endOfMonth","monthCompletelyInvalid","SelectionIndicator","Icon","Check","t3","months","Virtualizer","ListLayout","ListBox"],"sources":["../../../../src/components/Calendar/CalendarMonthMenu/CalendarMonthMenu.tsx"],"sourcesContent":["import { Check } from \"lucide-react\";\nimport {\n    ListBox,\n    ListLayout,\n    SelectionIndicator,\n    Virtualizer,\n} from \"react-aria-components\";\nimport { Icon } from \"@/components/Icon\";\nimport { CalendarMenuItem } from \"../CalendarMenuItem\";\nimport { type MonthItem, useCalendarState } from \"../core\";\n\n/**\n * Props for the {@link CalendarMonthMenu} component.\n */\nexport interface CalendarMonthMenuProps {\n    /** Callback invoked after a month item is selected to return to the calendar view. */\n    onSelection: () => void;\n    /** Array of selectable month objects to render in the virtualized list. */\n    months: MonthItem[];\n}\n\n/**\n * A virtualized list menu allowing users to quickly pick a month in the calendar.\n *\n * Automatically highlights the currently focused month with a checkmark, disables months\n * that fall outside the allowable `minValue` / `maxValue` range, and shifts focused date on click.\n */\nexport const CalendarMonthMenu: React.FC<CalendarMonthMenuProps> = ({\n    onSelection,\n    months,\n}) => {\n    const state = useCalendarState();\n\n    return (\n        <Virtualizer layout={ListLayout}>\n            <ListBox\n                aria-label=\"month selection\"\n                autoFocus\n                data-menu\n                items={months}\n                selectionMode=\"single\"\n                selectedKeys={[state.focusedDate.month]}\n            >\n                {(item) => {\n                    const nextDate = state.focusedDate.set({\n                        month: item.id,\n                        day: 1,\n                    });\n\n                    const endOfMonth = nextDate.set({\n                        day: nextDate.calendar.getDaysInMonth(nextDate),\n                    });\n\n                    const monthCompletelyInvalid =\n                        (state.maxValue &&\n                            nextDate.compare(state.maxValue) > 0) ||\n                        (state.minValue &&\n                            endOfMonth.compare(state.minValue) < 0);\n\n                    return (\n                        <CalendarMenuItem\n                            onPress={() => {\n                                state.setFocusedDate(\n                                    state.focusedDate.set({ month: item.id })\n                                );\n                                onSelection();\n                            }}\n                            isDisabled={monthCompletelyInvalid ?? undefined}\n                            textValue={item.formatted}\n                        >\n                            <SelectionIndicator>\n                                <Icon\n                                    icon={Check}\n                                    size={24}\n                                    data-selected-icon\n                                />\n                            </SelectionIndicator>\n                            {item.formatted}\n                        </CalendarMenuItem>\n                    );\n                }}\n            </ListBox>\n        </Virtualizer>\n    );\n};\n"],"mappings":";;;;;;;;aA2BaQ,KAAsD,MAAA;CAAA,IAAAC,KAAA,GAAAN,EAAAA,EAAAA,CAAA,CAAA,GAAC,EAAA,gBAAA,cAAAO,GAIhEC,IAAcL,EAAiB,GAAEM;CAAA,AAAAH,EAAA,OAAAE,EAAA,YAAA,QAUkB,IAAAF,EAAA,MAAzB,IAAA,CAACE,EAAK,YAAY,KAAM,GAAC,EAAA,KAAAA,EAAA,YAAA,OAAA,EAAA,KAAAC;CAAA,IAAAC;CAAA,AAAAJ,EAAA,OAAAK,KAAAL,EAAA,OAAAE,KAEtC,KAAA,MAAA;EACG,IAAAI,IAAiBJ,EAAK,YAAY,IAAK;GAAA,OAC5BK,EAAI;GAAG,KACT;EACT,CAAC,GAEDC,IAAmBF,EAAQ,IAAK,EAAA,KACvBA,EAAQ,SAAS,eAAgBA,CAAQ,EAClD,CAAC,GAEDG,IACKP,EAAK,YACFI,EAAQ,QAASJ,EAAK,QAAS,IAAI,KACtCA,EAAK,YACFM,EAAU,QAASN,EAAK,QAAS,IAAI;EAAG,OAG5C,kBAACN,GAAD;GACa,eAAA;IAIL,AAHAM,EAAK,eACDA,EAAK,YAAY,IAAK,EAAA,OAASK,EAAI,GAAI,CAAC,CAC5C,GACAF,EAAY;GAAC;GAEL,YAAAI,KAAA,KAAA;GACD,WAAAF,EAAI;GARnB,UAAA,CAUI,kBAACG,GAAD,EAAA,UACI,kBAACC,GAAD;IACUpB,MAAAqB;IACA,MAAA;IACN,sBAAA;GAAkB,CAAA,EAJP,CAAA,GAOlBL,EAAI,SAjBQ;;CAkBE,GAE1B,EAAA,KAAAF,GAAA,EAAA,KAAAH,GAAA,EAAA,KAAAE,KAAA,IAAAJ,EAAA;CAAA,IAAAa;CAEK,OAFLb,EAAA,OAAAc,KAAAd,EAAA,OAAAG,KAAAH,EAAA,OAAAI,KA9CT,IAAA,kBAACW,GAAD;EAAqBvB,QAAAwB;EACjB,UAAA,kBAACC,GAAD;GACe,cAAA;GACX,WAAA;GACA,aAAA;GACOxB,OAAAqB;GACO,eAAA;GACA,cAAAX;GAEb,UAAAC;EARG,CAAA;CADA,CAAA,GAgDE,EAAA,KAAAU,GAAA,EAAA,KAAAX,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAS,KAAA,IAAAb,EAAA,IAhDda;AAgDc"}

package/dist/components/Calendar/CalendarYearMenu/CalendarYearMenu.d.ts

@@ -1,5 +1,17 @@
 import { YearItem } from '../core';
-export declare const CalendarYearMenu: React.FC<{
+/**
+ * Props for the {@link CalendarYearMenu} component.
+ */
+export interface CalendarYearMenuProps {
+    /** Callback invoked after a year item is selected to return to the calendar view. */
     onSelection: () => void;
+    /** Array of selectable year objects to render in the virtualized list. */
     years: YearItem[];
-}>;
+}
+/**
+ * A virtualized list menu allowing users to quickly pick a year in the calendar.
+ *
+ * Automatically highlights the currently focused year with a checkmark and shifts the focused date
+ * on selection.
+ */
+export declare const CalendarYearMenu: React.FC<CalendarYearMenuProps>;

package/dist/components/Calendar/CalendarYearMenu/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Check","ListLayout","years"],"sources":["../../../../src/components/Calendar/CalendarYearMenu/CalendarYearMenu.tsx"],"sourcesContent":["import { Check } from \"lucide-react\";\nimport {\n    ListBox,\n    ListLayout,\n    SelectionIndicator,\n    Virtualizer,\n} from \"react-aria-components\";\n\nimport { Icon } from \"@/components/Icon\";\nimport { CalendarMenuItem } from \"../CalendarMenuItem\";\nimport { useCalendarState, type YearItem } from \"../core\";\n\nexport const CalendarYearMenu: React.FC<{\n    onSelection: () => void;\n    years: YearItem[];\n}> = ({ onSelection, years }) => {\n    const state = useCalendarState();\n\n    return (\n        <Virtualizer layout={ListLayout}>\n            <ListBox\n                aria-label=\"year selection\"\n                autoFocus\n                data-menu\n                items={years}\n                selectionMode=\"single\"\n                selectedKeys={[state.focusedDate.year]}\n            >\n                {(item) => (\n                    <CalendarMenuItem\n                        onPress={() => {\n                            state.setFocusedDate(\n                                state.focusedDate.set({ year: item.id })\n                            );\n                            onSelection();\n                        }}\n                        textValue={item.formatted}\n                    >\n                        <SelectionIndicator>\n                            <Icon icon={Check} size={24} data-selected-icon />\n                        </SelectionIndicator>\n\n                        {item.formatted}\n                    </CalendarMenuItem>\n                )}\n            </ListBox>\n        </Virtualizer>\n    );\n};\n"],"mappings":";;;;;;;;aAYa,KAGR,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,CAAA,GAAC,EAAA,gBAAA,aAAA,GACF,IAAc,EAAiB,GAAE;CAAA,AAAA,EAAA,OAAA,EAAA,YAAA,OAUiB,IAAA,EAAA,MAAxB,IAAA,CAAC,EAAK,YAAY,IAAK,GAAC,EAAA,KAAA,EAAA,YAAA,MAAA,EAAA,KAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,KAAA,EAAA,OAAA,KAErC,KAAA,MACG,kBAAC,GAAD;EACa,eAAA;GAIL,AAHA,EAAK,eACD,EAAK,YAAY,IAAK,EAAA,MAAQ,EAAI,GAAI,CAAC,CAC3C,GACA,EAAY;EAAC;EAEN,WAAA,EAAI;YAPnB,CASI,kBAAC,GAAD,EAAA,UACI,kBAAC,GAAD;GAAYA,MAAA;GAAa,MAAA;GAAI,sBAAA;EAAkB,CAAA,EADhC,CAAA,GAIlB,EAAI,SAbQ;KAepB,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAEK,OAFL,EAAA,OAAA,KAAA,EAAA,OAAA,KAAA,EAAA,OAAA,KAzBT,IAAA,kBAAC,GAAD;EAAqBC,QAAA;YACjB,kBAAC,GAAD;GACe,cAAA;GACX,WAAA;GACA,aAAA;GACOC,OAAA;GACO,eAAA;GACA,cAAA;aAEb;EARG,CAAA;CADA,CAAA,GA2BE,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA,IA3Bd;AA2Bc"}
+{"version":3,"file":"index.js","names":["Check","ListLayout","years","_c","require_compiler_runtime","CalendarMenuItem","useCalendarState","import_compiler_runtime","CalendarYearMenu","$","t0","state","t1","t2","onSelection","item","SelectionIndicator","Icon","Check","t3","years","Virtualizer","ListLayout","ListBox"],"sources":["../../../../src/components/Calendar/CalendarYearMenu/CalendarYearMenu.tsx"],"sourcesContent":["import { Check } from \"lucide-react\";\nimport {\n    ListBox,\n    ListLayout,\n    SelectionIndicator,\n    Virtualizer,\n} from \"react-aria-components\";\n\nimport { Icon } from \"@/components/Icon\";\nimport { CalendarMenuItem } from \"../CalendarMenuItem\";\nimport { useCalendarState, type YearItem } from \"../core\";\n\n/**\n * Props for the {@link CalendarYearMenu} component.\n */\nexport interface CalendarYearMenuProps {\n    /** Callback invoked after a year item is selected to return to the calendar view. */\n    onSelection: () => void;\n    /** Array of selectable year objects to render in the virtualized list. */\n    years: YearItem[];\n}\n\n/**\n * A virtualized list menu allowing users to quickly pick a year in the calendar.\n *\n * Automatically highlights the currently focused year with a checkmark and shifts the focused date\n * on selection.\n */\nexport const CalendarYearMenu: React.FC<CalendarYearMenuProps> = ({\n    onSelection,\n    years,\n}) => {\n    const state = useCalendarState();\n\n    return (\n        <Virtualizer layout={ListLayout}>\n            <ListBox\n                aria-label=\"year selection\"\n                autoFocus\n                data-menu\n                items={years}\n                selectionMode=\"single\"\n                selectedKeys={[state.focusedDate.year]}\n            >\n                {(item) => (\n                    <CalendarMenuItem\n                        onPress={() => {\n                            state.setFocusedDate(\n                                state.focusedDate.set({ year: item.id })\n                            );\n                            onSelection();\n                        }}\n                        textValue={item.formatted}\n                    >\n                        <SelectionIndicator>\n                            <Icon icon={Check} size={24} data-selected-icon />\n                        </SelectionIndicator>\n\n                        {item.formatted}\n                    </CalendarMenuItem>\n                )}\n            </ListBox>\n        </Virtualizer>\n    );\n};\n"],"mappings":";;;;;;;;aA4BaQ,KAAoD,MAAA;CAAA,IAAAC,KAAA,GAAAN,EAAAA,EAAAA,CAAA,CAAA,GAAC,EAAA,gBAAA,aAAAO,GAI9DC,IAAcL,EAAiB,GAAEM;CAAA,AAAAH,EAAA,OAAAE,EAAA,YAAA,OAUiB,IAAAF,EAAA,MAAxB,IAAA,CAACE,EAAK,YAAY,IAAK,GAAC,EAAA,KAAAA,EAAA,YAAA,MAAA,EAAA,KAAAC;CAAA,IAAAC;CAAA,AAAAJ,EAAA,OAAAK,KAAAL,EAAA,OAAAE,KAErC,KAAA,MACG,kBAACN,GAAD;EACa,eAAA;GAIL,AAHAM,EAAK,eACDA,EAAK,YAAY,IAAK,EAAA,MAAQI,EAAI,GAAI,CAAC,CAC3C,GACAD,EAAY;EAAC;EAEN,WAAAC,EAAI;EAPnB,UAAA,CASI,kBAACC,GAAD,EAAA,UACI,kBAACC,GAAD;GAAYjB,MAAAkB;GAAa,MAAA;GAAI,sBAAA;EAAkB,CAAA,EADhC,CAAA,GAIlBH,EAAI,SAbQ;KAepB,EAAA,KAAAD,GAAA,EAAA,KAAAH,GAAA,EAAA,KAAAE,KAAA,IAAAJ,EAAA;CAAA,IAAAU;CAEK,OAFLV,EAAA,OAAAG,KAAAH,EAAA,OAAAI,KAAAJ,EAAA,OAAAW,KAzBT,IAAA,kBAACC,GAAD;EAAqBpB,QAAAqB;EACjB,UAAA,kBAACC,GAAD;GACe,cAAA;GACX,WAAA;GACA,aAAA;GACOrB,OAAAkB;GACO,eAAA;GACA,cAAAR;GAEb,UAAAC;EARG,CAAA;CADA,CAAA,GA2BE,EAAA,KAAAD,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAO,GAAA,EAAA,KAAAD,KAAA,IAAAV,EAAA,IA3BdU;AA2Bc"}

package/dist/components/Calendar/RangeCalendar/RangeCalendar.d.ts

@@ -1,5 +1,43 @@
 import { RangeCalendar as AriaRangeCalendar } from 'react-aria-components';
 import { WeekdayStyle } from '../core';
-export declare const RangeCalendar: React.FC<Omit<React.ComponentPropsWithRef<typeof AriaRangeCalendar>, "children" | "visibleDuration" | "pageBehavior"> & {
+/**
+ * Props for the {@link RangeCalendar} component.
+ * Extends React Aria's `RangeCalendar` props (excluding `children`, `visibleDuration`, and `pageBehavior`).
+ */
+export interface RangeCalendarProps extends Omit<React.ComponentPropsWithRef<typeof AriaRangeCalendar>, "children" | "visibleDuration" | "pageBehavior"> {
+    /**
+     * Formatting style for weekday column headers in the calendar grid.
+     *
+     * - `"narrow"`: Typically a single character (e.g. "S", "M", "T").
+     * - `"short"`: Abbreviated weekday name (e.g. "Sun", "Mon", "Tue").
+     */
     weekdayStyle?: WeekdayStyle;
-}>;
+    /** Accessible label for the previous month button. */
+    previousMonthAriaLabel?: string;
+    /** Accessible label for the next month button. */
+    nextMonthAriaLabel?: string;
+    /** Accessible label for the previous year button. */
+    previousYearAriaLabel?: string;
+    /** Accessible label for the next year button. */
+    nextYearAriaLabel?: string;
+}
+/**
+ * A date range selection calendar component implementing Material Design 3 Date Range Picker guidelines.
+ *
+ * Allows users to select a continuous range of dates (start date and end date) with visual
+ * range indicators, quick month/year jumping menus, keyboard navigation, and localized formatting.
+ * Built on top of React Aria's `RangeCalendar`.
+ *
+ * @example
+ * ```tsx
+ * import { RangeCalendar } from '@adgytec/web-ui-components';
+ * import { today, getLocalTimeZone } from '@internationalized/date';
+ *
+ * <RangeCalendar
+ *     aria-label="Trip dates"
+ *     minValue={today(getLocalTimeZone())}
+ *     onChange={(range) => console.log('Selected range:', range.start, range.end)}
+ * />
+ * ```
+ */
+export declare const RangeCalendar: React.FC<RangeCalendarProps>;

package/dist/components/Calendar/RangeCalendar/index.js

@@ -6,23 +6,27 @@ import { jsx as i } from "react/jsx-runtime";
 import { RangeCalendar as a } from "react-aria-components";
 //#region src/components/Calendar/RangeCalendar/RangeCalendar.tsx
 var o = e(), s = (e) => {
-	let s = (0, o.c)(12), c, l, u;
-	s[0] === e ? (c = s[1], l = s[2], u = s[3]) : ({weekdayStyle: u, className: c, ...l} = e, s[0] = e, s[1] = c, s[2] = l, s[3] = u);
-	let d;
-	s[4] === c ? d = s[5] : (d = (e) => r(t, typeof c == "function" ? c(e) : c), s[4] = c, s[5] = d);
-	let f;
-	s[6] === u ? f = s[7] : (f = /* @__PURE__ */ i(n, {
-		weekdayStyle: u,
-		isRangeCalendar: !0
-	}), s[6] = u, s[7] = f);
-	let p;
-	return s[8] !== l || s[9] !== d || s[10] !== f ? (p = /* @__PURE__ */ i(a, {
-		className: d,
-		...l,
+	let s = (0, o.c)(20), c, l, u, d, f, p, m;
+	s[0] === e ? (c = s[1], l = s[2], u = s[3], d = s[4], f = s[5], p = s[6], m = s[7]) : ({weekdayStyle: m, className: c, previousMonthAriaLabel: d, nextMonthAriaLabel: l, previousYearAriaLabel: f, nextYearAriaLabel: u, ...p} = e, s[0] = e, s[1] = c, s[2] = l, s[3] = u, s[4] = d, s[5] = f, s[6] = p, s[7] = m);
+	let h;
+	s[8] === c ? h = s[9] : (h = (e) => r(t, typeof c == "function" ? c(e) : c), s[8] = c, s[9] = h);
+	let g;
+	s[10] !== l || s[11] !== u || s[12] !== d || s[13] !== f || s[14] !== m ? (g = /* @__PURE__ */ i(n, {
+		weekdayStyle: m,
+		isRangeCalendar: !0,
+		previousMonthAriaLabel: d,
+		nextMonthAriaLabel: l,
+		previousYearAriaLabel: f,
+		nextYearAriaLabel: u
+	}), s[10] = l, s[11] = u, s[12] = d, s[13] = f, s[14] = m, s[15] = g) : g = s[15];
+	let _;
+	return s[16] !== p || s[17] !== h || s[18] !== g ? (_ = /* @__PURE__ */ i(a, {
+		className: h,
+		...p,
 		"data-calendar": !0,
 		"data-range-calendar": !0,
-		children: f
-	}), s[8] = l, s[9] = d, s[10] = f, s[11] = p) : p = s[11], p;
+		children: g
+	}), s[16] = p, s[17] = h, s[18] = g, s[19] = _) : _ = s[19], _;
 };
 //#endregion
 export { s as RangeCalendar };

package/dist/components/Calendar/RangeCalendar/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["weekdayStyle"],"sources":["../../../../src/components/Calendar/RangeCalendar/RangeCalendar.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { RangeCalendar as AriaRangeCalendar } from \"react-aria-components\";\nimport { BaseCalendar } from \"../BaseCalendar\";\nimport { CalendarBaseStyles, type WeekdayStyle } from \"../core\";\n\nexport const RangeCalendar: React.FC<\n    Omit<\n        React.ComponentPropsWithRef<typeof AriaRangeCalendar>,\n        \"children\" | \"visibleDuration\" | \"pageBehavior\"\n    > & {\n        weekdayStyle?: WeekdayStyle;\n    }\n> = ({ weekdayStyle, className, ...props }) => {\n    return (\n        <AriaRangeCalendar\n            className={(renderProps) =>\n                clsx(\n                    CalendarBaseStyles,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            data-calendar\n            data-range-calendar\n        >\n            <BaseCalendar weekdayStyle={weekdayStyle} isRangeCalendar />\n        </AriaRangeCalendar>\n    );\n};\n"],"mappings":";;;;;;;aAKa,KAOT,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,EAAA,GAAA,GAAA,GAAA;CAAA,AAAA,EAAA,OAAA,KAAsC,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,OAArC,mCAAA,KAAA,GAAqC,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,IASzB,IAAA,EAAA,MANM,KAAA,MACP,EACI,GACA,OAAO,KAAc,aACf,EAAU,CACF,IAFd,CAGJ,GAAC,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,IAMuD,IAAA,EAAA,MAA5D,IAAA,kBAAC,GAAD;EAA4B;EAAc,iBAAA;CAAe,CAAA,GAAG,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAC5C,OAD4C,EAAA,OAAA,KAAA,EAAA,OAAA,KAAA,EAAA,QAAA,KAbhE,IAAA,kBAAC,GAAD;EACe,WAAA;EAMN,GAED;EACJ,iBAAA;EACA,uBAAA;YAEA;CAbc,CAAA,GAcE,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA,KAdpB;AAcoB"}
+{"version":3,"file":"index.js","names":["weekdayStyle","previousMonthAriaLabel","nextMonthAriaLabel","previousYearAriaLabel","nextYearAriaLabel","_c","clsx","AriaRangeCalendar","require_compiler_runtime","CalendarBaseStyles","BaseCalendar","clsx$1","RangeCalendar$1","import_compiler_runtime","RangeCalendar","$","className","nextMonthAriaLabel","nextYearAriaLabel","previousMonthAriaLabel","previousYearAriaLabel","props","weekdayStyle","t0","t1","renderProps","t2","t3"],"sources":["../../../../src/components/Calendar/RangeCalendar/RangeCalendar.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { RangeCalendar as AriaRangeCalendar } from \"react-aria-components\";\nimport { BaseCalendar } from \"../BaseCalendar\";\nimport { CalendarBaseStyles, type WeekdayStyle } from \"../core\";\n\n/**\n * Props for the {@link RangeCalendar} component.\n * Extends React Aria's `RangeCalendar` props (excluding `children`, `visibleDuration`, and `pageBehavior`).\n */\nexport interface RangeCalendarProps\n    extends Omit<\n        React.ComponentPropsWithRef<typeof AriaRangeCalendar>,\n        \"children\" | \"visibleDuration\" | \"pageBehavior\"\n    > {\n    /**\n     * Formatting style for weekday column headers in the calendar grid.\n     *\n     * - `\"narrow\"`: Typically a single character (e.g. \"S\", \"M\", \"T\").\n     * - `\"short\"`: Abbreviated weekday name (e.g. \"Sun\", \"Mon\", \"Tue\").\n     */\n    weekdayStyle?: WeekdayStyle;\n\n    /** Accessible label for the previous month button. */\n    previousMonthAriaLabel?: string;\n\n    /** Accessible label for the next month button. */\n    nextMonthAriaLabel?: string;\n\n    /** Accessible label for the previous year button. */\n    previousYearAriaLabel?: string;\n\n    /** Accessible label for the next year button. */\n    nextYearAriaLabel?: string;\n}\n\n/**\n * A date range selection calendar component implementing Material Design 3 Date Range Picker guidelines.\n *\n * Allows users to select a continuous range of dates (start date and end date) with visual\n * range indicators, quick month/year jumping menus, keyboard navigation, and localized formatting.\n * Built on top of React Aria's `RangeCalendar`.\n *\n * @example\n * ```tsx\n * import { RangeCalendar } from '@adgytec/web-ui-components';\n * import { today, getLocalTimeZone } from '@internationalized/date';\n *\n * <RangeCalendar\n *     aria-label=\"Trip dates\"\n *     minValue={today(getLocalTimeZone())}\n *     onChange={(range) => console.log('Selected range:', range.start, range.end)}\n * />\n * ```\n */\nexport const RangeCalendar: React.FC<RangeCalendarProps> = ({\n    weekdayStyle,\n    className,\n    previousMonthAriaLabel,\n    nextMonthAriaLabel,\n    previousYearAriaLabel,\n    nextYearAriaLabel,\n    ...props\n}) => {\n    return (\n        <AriaRangeCalendar\n            className={(renderProps) =>\n                clsx(\n                    CalendarBaseStyles,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            data-calendar\n            data-range-calendar\n        >\n            <BaseCalendar\n                weekdayStyle={weekdayStyle}\n                isRangeCalendar\n                previousMonthAriaLabel={previousMonthAriaLabel}\n                nextMonthAriaLabel={nextMonthAriaLabel}\n                previousYearAriaLabel={previousYearAriaLabel}\n                nextYearAriaLabel={nextYearAriaLabel}\n            />\n        </AriaRangeCalendar>\n    );\n};\n"],"mappings":";;;;;;;aAsDac,KAA8C,MAAA;CAAA,IAAAC,KAAA,GAAAV,EAAAA,EAAAA,CAAA,EAAA,GAAAW,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC;CAAA,AAAAP,EAAA,OAAAQ,KAQ1D,IAAAR,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,OAR2D,kIAAA,GAAAM,KAAAE,GAQ3D,EAAA,KAAAA,GAAA,EAAA,KAAAP,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC;CAAA,IAAAE;CAAA,AAAAT,EAAA,OAAAC,IASgB,IAAAD,EAAA,MANM,KAAA,MACPT,EACIG,GACA,OAAOO,KAAc,aACfA,EAAUS,CACF,IAFdT,CAGJ,GAAC,EAAA,KAAAA,GAAA,EAAA,KAAAQ;CAAA,IAAAE;CAAA,AAAAX,EAAA,QAAAE,KAAAF,EAAA,QAAAG,KAAAH,EAAA,QAAAI,KAAAJ,EAAA,QAAAK,KAAAL,EAAA,QAAAO,KAML,IAAA,kBAACZ,GAAD;EACkB;EACd,iBAAA;EACwB;EACJ;EACG;EACJ;CAAiB,CAAA,GACtC,EAAA,MAAAO,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAE,GAAA,EAAA,MAAAI,KAAA,IAAAX,EAAA;CAAA,IAAAY;CACc,OADdZ,EAAA,QAAAM,KAAAN,EAAA,QAAAS,KAAAT,EAAA,QAAAW,KApBN,IAAA,kBAACnB,GAAD;EACe,WAAAiB;EAMN,GAEDH;EACJ,iBAAA;EACA,uBAAA;EAEA,UAAAK;CAbc,CAAA,GAqBE,EAAA,MAAAL,GAAA,EAAA,MAAAG,GAAA,EAAA,MAAAE,GAAA,EAAA,MAAAC,KAAA,IAAAZ,EAAA,KArBpBY;AAqBoB"}

package/dist/components/Calendar/core/calendar.d.ts

@@ -1,12 +1,38 @@
+/**
+ * Base CSS module class name providing layout and styling tokens for calendar containers.
+ */
 export declare const CalendarBaseStyles: string;
+/**
+ * Format style for weekday headers in the calendar grid.
+ *
+ * - `"narrow"`: Typically a single character (e.g. "S", "M", "T").
+ * - `"short"`: Abbreviated day name (e.g. "Sun", "Mon", "Tue").
+ */
 export type WeekdayStyle = "narrow" | "short";
+/**
+ * Represents a selectable month item within the month picker menu.
+ */
 export interface MonthItem {
+    /** 1-based month index (1 for January through 12 for December). */
     id: number;
+    /** Formatted localized month label (e.g. "January" or "Jan"). */
     formatted: string;
 }
+/**
+ * Represents a selectable year item within the year picker menu.
+ */
 export interface YearItem {
+    /** Full numeric year (e.g. 2026). */
     id: number;
+    /** Formatted localized year string (e.g. "2026"). */
     formatted: string;
 }
+/**
+ * Default fallback minimum year used in the year selection menu when no `minValue` is specified.
+ */
 export declare const defaultMinYear = 1900;
+/**
+ * Default number of years added to the current year when determining the maximum year
+ * in the year selection menu if no `maxValue` is specified.
+ */
 export declare const defaultMaxYearIncrement = 100;