react-day-picker 9.6.7 → 9.7.0

package/dist/cjs/labels/labelPrevious.d.ts

@@ -1,10 +1,11 @@
 /**
- * The ARIA label for previous month button.
+ * Generates the ARIA label for the "previous month" button.
  *
  * @defaultValue `"Go to the Previous Month"`
+ * @param month - The date representing the previous month, or `undefined` if
+ *   there is no previous month.
+ * @returns The ARIA label for the "previous month" button.
  * @group Labels
  * @see https://daypicker.dev/docs/translation#aria-labels
  */
-export declare function labelPrevious(
-/** Undefined where there's no previous month to navigate to. */
-month: Date | undefined): string;
+export declare function labelPrevious(month: Date | undefined): string;

package/dist/cjs/labels/labelPrevious.js

@@ -2,15 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.labelPrevious = labelPrevious;
 /**
- * The ARIA label for previous month button.
+ * Generates the ARIA label for the "previous month" button.
  *
  * @defaultValue `"Go to the Previous Month"`
+ * @param month - The date representing the previous month, or `undefined` if
+ *   there is no previous month.
+ * @returns The ARIA label for the "previous month" button.
  * @group Labels
  * @see https://daypicker.dev/docs/translation#aria-labels
  */
-function labelPrevious(
-/** Undefined where there's no previous month to navigate to. */
-month) {
+function labelPrevious(month) {
     return "Go to the Previous Month";
 }
 //# sourceMappingURL=labelPrevious.js.map

package/dist/cjs/labels/labelPrevious.js.map

@@ -1 +1 @@
-{"version":3,"file":"labelPrevious.js","sourceRoot":"","sources":["../../../src/labels/labelPrevious.ts"],"names":[],"mappings":";;AAOA,sCAKC;AAZD;;;;;;GAMG;AACH,SAAgB,aAAa;AAC3B,gEAAgE;AAChE,KAAuB;IAEvB,OAAO,0BAA0B,CAAC;AACpC,CAAC"}
+{"version":3,"file":"labelPrevious.js","sourceRoot":"","sources":["../../../src/labels/labelPrevious.ts"],"names":[],"mappings":";;AAUA,sCAEC;AAZD;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAAC,KAAuB;IACnD,OAAO,0BAA0B,CAAC;AACpC,CAAC"}

package/dist/cjs/labels/labelWeekNumber.d.ts

@@ -1,8 +1,11 @@
 import type { DateLibOptions } from "../classes/DateLib.js";
 /**
- * The ARIA label for the week number cell (the first cell in the row).
+ * Generates the ARIA label for the week number cell (the first cell in a row).
  *
  * @defaultValue `Week ${weekNumber}`
+ * @param weekNumber - The number of the week.
+ * @param options - Optional configuration for the date formatting library.
+ * @returns The ARIA label for the week number cell.
  * @group Labels
  * @see https://daypicker.dev/docs/translation#aria-labels
  */

package/dist/cjs/labels/labelWeekNumber.js

@@ -2,9 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.labelWeekNumber = labelWeekNumber;
 /**
- * The ARIA label for the week number cell (the first cell in the row).
+ * Generates the ARIA label for the week number cell (the first cell in a row).
  *
  * @defaultValue `Week ${weekNumber}`
+ * @param weekNumber - The number of the week.
+ * @param options - Optional configuration for the date formatting library.
+ * @returns The ARIA label for the week number cell.
  * @group Labels
  * @see https://daypicker.dev/docs/translation#aria-labels
  */

package/dist/cjs/labels/labelWeekNumber.js.map

@@ -1 +1 @@
-{"version":3,"file":"labelWeekNumber.js","sourceRoot":"","sources":["../../../src/labels/labelWeekNumber.ts"],"names":[],"mappings":";;AASA,0CAKC;AAZD;;;;;;GAMG;AACH,SAAgB,eAAe,CAC7B,UAAkB,EAClB,OAAwB;IAExB,OAAO,QAAQ,UAAU,EAAE,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"labelWeekNumber.js","sourceRoot":"","sources":["../../../src/labels/labelWeekNumber.ts"],"names":[],"mappings":";;AAYA,0CAKC;AAfD;;;;;;;;;GASG;AACH,SAAgB,eAAe,CAC7B,UAAkB,EAClB,OAAwB;IAExB,OAAO,QAAQ,UAAU,EAAE,CAAC;AAC9B,CAAC"}

package/dist/cjs/labels/labelWeekNumberHeader.d.ts

@@ -1,8 +1,10 @@
 import type { DateLibOptions } from "../classes/DateLib.js";
 /**
- * The ARIA label for the week number header element.
+ * Generates the ARIA label for the week number header element.
  *
  * @defaultValue `"Week Number"`
+ * @param options - Optional configuration for the date formatting library.
+ * @returns The ARIA label for the week number header.
  * @group Labels
  * @see https://daypicker.dev/docs/translation#aria-labels
  */

package/dist/cjs/labels/labelWeekNumberHeader.js

@@ -2,9 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.labelWeekNumberHeader = labelWeekNumberHeader;
 /**
- * The ARIA label for the week number header element.
+ * Generates the ARIA label for the week number header element.
  *
  * @defaultValue `"Week Number"`
+ * @param options - Optional configuration for the date formatting library.
+ * @returns The ARIA label for the week number header.
  * @group Labels
  * @see https://daypicker.dev/docs/translation#aria-labels
  */

package/dist/cjs/labels/labelWeekNumberHeader.js.map

@@ -1 +1 @@
-{"version":3,"file":"labelWeekNumberHeader.js","sourceRoot":"","sources":["../../../src/labels/labelWeekNumberHeader.ts"],"names":[],"mappings":";;AASA,sDAEC;AATD;;;;;;GAMG;AACH,SAAgB,qBAAqB,CAAC,OAAwB;IAC5D,OAAO,aAAa,CAAC;AACvB,CAAC"}
+{"version":3,"file":"labelWeekNumberHeader.js","sourceRoot":"","sources":["../../../src/labels/labelWeekNumberHeader.ts"],"names":[],"mappings":";;AAWA,sDAEC;AAXD;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CAAC,OAAwB;IAC5D,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/cjs/labels/labelWeekday.d.ts

@@ -1,8 +1,12 @@
 import { DateLib, type DateLibOptions } from "../classes/DateLib.js";
 /**
- * The ARIA label for the Weekday column header.
+ * Generates the ARIA label for a weekday column header.
  *
  * @defaultValue `"Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"`
+ * @param date - The date representing the weekday.
+ * @param options - Optional configuration for the date formatting library.
+ * @param dateLib - An optional instance of the date formatting library.
+ * @returns The ARIA label for the weekday column header.
  * @group Labels
  * @see https://daypicker.dev/docs/translation#aria-labels
  */

package/dist/cjs/labels/labelWeekday.js

@@ -3,9 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.labelWeekday = labelWeekday;
 const DateLib_js_1 = require("../classes/DateLib.js");
 /**
- * The ARIA label for the Weekday column header.
+ * Generates the ARIA label for a weekday column header.
  *
  * @defaultValue `"Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"`
+ * @param date - The date representing the weekday.
+ * @param options - Optional configuration for the date formatting library.
+ * @param dateLib - An optional instance of the date formatting library.
+ * @returns The ARIA label for the weekday column header.
  * @group Labels
  * @see https://daypicker.dev/docs/translation#aria-labels
  */

package/dist/cjs/labels/labelWeekday.js.map

@@ -1 +1 @@
-{"version":3,"file":"labelWeekday.js","sourceRoot":"","sources":["../../../src/labels/labelWeekday.ts"],"names":[],"mappings":";;AASA,oCAMC;AAfD,sDAAqE;AAErE;;;;;;GAMG;AACH,SAAgB,YAAY,CAC1B,IAAU,EACV,OAAwB,EACxB,OAAiB;IAEjB,OAAO,CAAC,OAAO,IAAI,IAAI,oBAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"labelWeekday.js","sourceRoot":"","sources":["../../../src/labels/labelWeekday.ts"],"names":[],"mappings":";;AAaA,oCAMC;AAnBD,sDAAqE;AAErE;;;;;;;;;;GAUG;AACH,SAAgB,YAAY,CAC1B,IAAU,EACV,OAAwB,EACxB,OAAiB;IAEjB,OAAO,CAAC,OAAO,IAAI,IAAI,oBAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC"}

package/dist/cjs/labels/labelYearDropdown.d.ts

@@ -1,8 +1,10 @@
 import type { DateLibOptions } from "../classes/DateLib.js";
 /**
- * The ARIA label for the years dropdown.
+ * Generates the ARIA label for the years dropdown.
  *
  * @defaultValue `"Choose the Year"`
+ * @param options - Optional configuration for the date formatting library.
+ * @returns The ARIA label for the years dropdown.
  * @group Labels
  * @see https://daypicker.dev/docs/translation#aria-labels
  */

package/dist/cjs/labels/labelYearDropdown.js

@@ -2,9 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.labelYearDropdown = labelYearDropdown;
 /**
- * The ARIA label for the years dropdown.
+ * Generates the ARIA label for the years dropdown.
  *
  * @defaultValue `"Choose the Year"`
+ * @param options - Optional configuration for the date formatting library.
+ * @returns The ARIA label for the years dropdown.
  * @group Labels
  * @see https://daypicker.dev/docs/translation#aria-labels
  */

package/dist/cjs/labels/labelYearDropdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"labelYearDropdown.js","sourceRoot":"","sources":["../../../src/labels/labelYearDropdown.ts"],"names":[],"mappings":";;AASA,8CAEC;AATD;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,OAAwB;IACxD,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"labelYearDropdown.js","sourceRoot":"","sources":["../../../src/labels/labelYearDropdown.ts"],"names":[],"mappings":";;AAWA,8CAEC;AAXD;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAAC,OAAwB;IACxD,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/cjs/persian.d.ts

@@ -6,8 +6,16 @@ import type { DayPickerProps } from "./types/props.js";
 export declare const faIR: dateFnsJalali.Locale;
 export declare const enUS: dateFnsJalali.Locale;
 /**
- * Render the Persian Calendar.
+ * Renders the Persian calendar using the DayPicker component.
  *
+ * @defaultValue
+ * - `locale`: `faIR`
+ * - `dir`: `rtl`
+ * - `dateLib`: `jalaliDateLib` from `date-fns-jalali`
+ * - `numerals`: `arabext` (Eastern Arabic-Indic)
+ * @param props - The props for the Persian calendar, including locale, text
+ *   direction, date library, and numeral system.
+ * @returns The Persian calendar component.
  * @see https://daypicker.dev/docs/localization#persian-calendar
  */
 export declare function DayPicker(props: DayPickerProps & {
@@ -50,5 +58,10 @@ export declare function DayPicker(props: DayPickerProps & {
      */
     numerals?: DayPickerProps["numerals"];
 }): React.JSX.Element;
-/** Returns the date library used in the calendar. */
+/**
+ * Returns the date library used in the Persian calendar.
+ *
+ * @param options - Optional configuration for the date library.
+ * @returns The date library instance.
+ */
 export declare const getDateLib: (options?: DateLibOptions) => DateLib;

package/dist/cjs/persian.js

@@ -45,8 +45,16 @@ const index_js_1 = require("./index.js");
 exports.faIR = locales.faIR;
 exports.enUS = locales.enUS;
 /**
- * Render the Persian Calendar.
+ * Renders the Persian calendar using the DayPicker component.
  *
+ * @defaultValue
+ * - `locale`: `faIR`
+ * - `dir`: `rtl`
+ * - `dateLib`: `jalaliDateLib` from `date-fns-jalali`
+ * - `numerals`: `arabext` (Eastern Arabic-Indic)
+ * @param props - The props for the Persian calendar, including locale, text
+ *   direction, date library, and numeral system.
+ * @returns The Persian calendar component.
  * @see https://daypicker.dev/docs/localization#persian-calendar
  */
 function DayPicker(props) {
@@ -60,7 +68,12 @@ function DayPicker(props) {
     });
     return (react_1.default.createElement(index_js_1.DayPicker, { ...props, locale: props.locale ?? exports.faIR, numerals: props.numerals ?? "arabext", dir: props.dir ?? "rtl", dateLib: dateLib }));
 }
-/** Returns the date library used in the calendar. */
+/**
+ * Returns the date library used in the Persian calendar.
+ *
+ * @param options - Optional configuration for the date library.
+ * @returns The date library instance.
+ */
 const getDateLib = (options) => {
     return new index_js_1.DateLib(options, dateFnsJalali);
 };

package/dist/cjs/persian.js.map

@@ -1 +1 @@
-{"version":3,"file":"persian.js","sourceRoot":"","sources":["../../src/persian.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBA,8BA2DC;AAhFD,kDAA0B;AAE1B,+DAAiD;AAEjD,gEAAkD;AAElD,yCAIoB;AAGP,QAAA,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;AACpB,QAAA,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;AAEjC;;;;GAIG;AACH,SAAgB,SAAS,CACvB,KAuCC;IAED,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC;QACzB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY;QAC9D,qBAAqB,EAAE,KAAK,CAAC,qBAAqB;QAClD,2BAA2B,EAAE,KAAK,CAAC,2BAA2B;QAC9D,4BAA4B,EAAE,KAAK,CAAC,4BAA4B;QAChE,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;IACH,OAAO,CACL,8BAAC,oBAAkB,OACb,KAAK,EACT,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,YAAI,EAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,SAAS,EACrC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,KAAK,EACvB,OAAO,EAAE,OAAO,GAChB,CACH,CAAC;AACJ,CAAC;AAED,qDAAqD;AAC9C,MAAM,UAAU,GAAG,CAAC,OAAwB,EAAE,EAAE;IACrD,OAAO,IAAI,kBAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC,CAAC;AAFW,QAAA,UAAU,cAErB"}
+{"version":3,"file":"persian.js","sourceRoot":"","sources":["../../src/persian.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,8BA2DC;AAxFD,kDAA0B;AAE1B,+DAAiD;AAEjD,gEAAkD;AAElD,yCAIoB;AAGP,QAAA,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;AACpB,QAAA,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;AAEjC;;;;;;;;;;;;GAYG;AACH,SAAgB,SAAS,CACvB,KAuCC;IAED,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC;QACzB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY;QAC9D,qBAAqB,EAAE,KAAK,CAAC,qBAAqB;QAClD,2BAA2B,EAAE,KAAK,CAAC,2BAA2B;QAC9D,4BAA4B,EAAE,KAAK,CAAC,4BAA4B;QAChE,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;IACH,OAAO,CACL,8BAAC,oBAAkB,OACb,KAAK,EACT,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,YAAI,EAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,SAAS,EACrC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,KAAK,EACvB,OAAO,EAAE,OAAO,GAChB,CACH,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACI,MAAM,UAAU,GAAG,CAAC,OAAwB,EAAE,EAAE;IACrD,OAAO,IAAI,kBAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC,CAAC;AAFW,QAAA,UAAU,cAErB"}

package/dist/cjs/selection/useMulti.d.ts

@@ -1,3 +1,12 @@
 import type { DateLib } from "../classes/DateLib.js";
 import type { DayPickerProps, Selection } from "../types/index.js";
+/**
+ * Hook to manage multiple-date selection in the DayPicker component.
+ *
+ * @template T - The type of DayPicker props.
+ * @param props - The DayPicker props.
+ * @param dateLib - The date utility library instance.
+ * @returns An object containing the selected dates, a function to select dates,
+ *   and a function to check if a date is selected.
+ */
 export declare function useMulti<T extends DayPickerProps>(props: T, dateLib: DateLib): Selection<T>;

package/dist/cjs/selection/useMulti.js

@@ -2,6 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useMulti = useMulti;
 const useControlledValue_js_1 = require("../helpers/useControlledValue.js");
+/**
+ * Hook to manage multiple-date selection in the DayPicker component.
+ *
+ * @template T - The type of DayPicker props.
+ * @param props - The DayPicker props.
+ * @param dateLib - The date utility library instance.
+ * @returns An object containing the selected dates, a function to select dates,
+ *   and a function to check if a date is selected.
+ */
 function useMulti(props, dateLib) {
     const { selected: initiallySelected, required, onSelect } = props;
     const [internallySelected, setSelected] = (0, useControlledValue_js_1.useControlledValue)(initiallySelected, onSelect ? initiallySelected : undefined);

package/dist/cjs/selection/useMulti.js.map

@@ -1 +1 @@
-{"version":3,"file":"useMulti.js","sourceRoot":"","sources":["../../../src/selection/useMulti.tsx"],"names":[],"mappings":";;AAWA,4BA8DC;AAtED,4EAAsE;AAQtE,SAAgB,QAAQ,CACtB,KAAQ,EACR,OAAgB;IAEhB,MAAM,EACJ,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EACR,QAAQ,EACT,GAAG,KAAmB,CAAC;IAExB,MAAM,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAA,0CAAkB,EAC1D,iBAAiB,EACjB,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CACzC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAEpE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9B,MAAM,UAAU,GAAG,CAAC,IAAU,EAAE,EAAE;QAChC,OAAO,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;IAC5D,CAAC,CAAC;IAEF,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAmB,CAAC;IAEzC,MAAM,MAAM,GAAG,CACb,WAAiB,EACjB,SAAoB,EACpB,CAAyC,EACzC,EAAE;QACF,IAAI,QAAQ,GAAuB,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,IAAI,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC7B,gCAAgC;gBAChC,OAAO;YACT,CAAC;YACD,IAAI,QAAQ,IAAI,QAAQ,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvC,6CAA6C;gBAC7C,OAAO;YACT,CAAC;YACD,QAAQ,GAAG,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,IAAI,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC7B,iDAAiD;gBACjD,QAAQ,GAAG,CAAC,WAAW,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,gCAAgC;gBAChC,QAAQ,GAAG,CAAC,GAAG,QAAQ,EAAE,WAAW,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,WAAW,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,MAAM;QACN,UAAU;KACK,CAAC;AACpB,CAAC"}
+{"version":3,"file":"useMulti.js","sourceRoot":"","sources":["../../../src/selection/useMulti.tsx"],"names":[],"mappings":";;AAoBA,4BA8DC;AA/ED,4EAAsE;AAQtE;;;;;;;;GAQG;AACH,SAAgB,QAAQ,CACtB,KAAQ,EACR,OAAgB;IAEhB,MAAM,EACJ,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EACR,QAAQ,EACT,GAAG,KAAmB,CAAC;IAExB,MAAM,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAA,0CAAkB,EAC1D,iBAAiB,EACjB,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CACzC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAEpE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9B,MAAM,UAAU,GAAG,CAAC,IAAU,EAAE,EAAE;QAChC,OAAO,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;IAC5D,CAAC,CAAC;IAEF,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAmB,CAAC;IAEzC,MAAM,MAAM,GAAG,CACb,WAAiB,EACjB,SAAoB,EACpB,CAAyC,EACzC,EAAE;QACF,IAAI,QAAQ,GAAuB,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,IAAI,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC7B,gCAAgC;gBAChC,OAAO;YACT,CAAC;YACD,IAAI,QAAQ,IAAI,QAAQ,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvC,6CAA6C;gBAC7C,OAAO;YACT,CAAC;YACD,QAAQ,GAAG,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,IAAI,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC7B,iDAAiD;gBACjD,QAAQ,GAAG,CAAC,WAAW,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,gCAAgC;gBAChC,QAAQ,GAAG,CAAC,GAAG,QAAQ,EAAE,WAAW,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,WAAW,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,MAAM;QACN,UAAU;KACK,CAAC;AACpB,CAAC"}

package/dist/cjs/selection/useRange.d.ts

@@ -1,3 +1,12 @@
 import type { DateLib } from "../classes/DateLib.js";
 import type { DayPickerProps, Selection } from "../types/index.js";
+/**
+ * Hook to manage range selection in the DayPicker component.
+ *
+ * @template T - The type of DayPicker props.
+ * @param props - The DayPicker props.
+ * @param dateLib - The date utility library instance.
+ * @returns An object containing the selected range, a function to select a
+ *   range, and a function to check if a date is within the range.
+ */
 export declare function useRange<T extends DayPickerProps>(props: T, dateLib: DateLib): Selection<T>;

package/dist/cjs/selection/useRange.js

@@ -4,6 +4,15 @@ exports.useRange = useRange;
 const useControlledValue_js_1 = require("../helpers/useControlledValue.js");
 const index_js_1 = require("../utils/index.js");
 const rangeIncludesDate_js_1 = require("../utils/rangeIncludesDate.js");
+/**
+ * Hook to manage range selection in the DayPicker component.
+ *
+ * @template T - The type of DayPicker props.
+ * @param props - The DayPicker props.
+ * @param dateLib - The date utility library instance.
+ * @returns An object containing the selected range, a function to select a
+ *   range, and a function to check if a date is within the range.
+ */
 function useRange(props, dateLib) {
     const { disabled, excludeDisabled, selected: initiallySelected, required, onSelect } = props;
     const [internallySelected, setSelected] = (0, useControlledValue_js_1.useControlledValue)(initiallySelected, onSelect ? initiallySelected : undefined);

package/dist/cjs/selection/useRange.js.map

@@ -1 +1 @@
-{"version":3,"file":"useRange.js","sourceRoot":"","sources":["../../../src/selection/useRange.tsx"],"names":[],"mappings":";;AAaA,4BA2DC;AArED,4EAAsE;AAOtE,gDAAuE;AACvE,wEAAkE;AAElE,SAAgB,QAAQ,CACtB,KAAQ,EACR,OAAgB;IAEhB,MAAM,EACJ,QAAQ,EACR,eAAe,EACf,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EACR,QAAQ,EACT,GAAG,KAAmB,CAAC;IAExB,MAAM,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAA,0CAAkB,EAC1D,iBAAiB,EACjB,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CACzC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAEpE,MAAM,UAAU,GAAG,CAAC,IAAU,EAAE,EAAE,CAChC,QAAQ,IAAI,IAAA,wCAAiB,EAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAG,CACb,WAAiB,EACjB,SAAoB,EACpB,CAAyC,EACzC,EAAE;QACF,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAmB,CAAC;QACzC,MAAM,QAAQ,GAAG,WAAW;YAC1B,CAAC,CAAC,IAAA,qBAAU,EAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC;YAChE,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,eAAe,IAAI,QAAQ,IAAI,QAAQ,EAAE,IAAI,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjE,IACE,IAAA,iCAAsB,EACpB,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,EACxC,QAAQ,EACR,OAAO,CACR,EACD,CAAC;gBACD,kDAAkD;gBAClD,QAAQ,CAAC,IAAI,GAAG,WAAW,CAAC;gBAC5B,QAAQ,CAAC,EAAE,GAAG,SAAS,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,WAAW,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAEhD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,MAAM;QACN,UAAU;KACK,CAAC;AACpB,CAAC"}
+{"version":3,"file":"useRange.js","sourceRoot":"","sources":["../../../src/selection/useRange.tsx"],"names":[],"mappings":";;AAsBA,4BA2DC;AA9ED,4EAAsE;AAOtE,gDAAuE;AACvE,wEAAkE;AAElE;;;;;;;;GAQG;AACH,SAAgB,QAAQ,CACtB,KAAQ,EACR,OAAgB;IAEhB,MAAM,EACJ,QAAQ,EACR,eAAe,EACf,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EACR,QAAQ,EACT,GAAG,KAAmB,CAAC;IAExB,MAAM,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAA,0CAAkB,EAC1D,iBAAiB,EACjB,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CACzC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAEpE,MAAM,UAAU,GAAG,CAAC,IAAU,EAAE,EAAE,CAChC,QAAQ,IAAI,IAAA,wCAAiB,EAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAG,CACb,WAAiB,EACjB,SAAoB,EACpB,CAAyC,EACzC,EAAE;QACF,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAmB,CAAC;QACzC,MAAM,QAAQ,GAAG,WAAW;YAC1B,CAAC,CAAC,IAAA,qBAAU,EAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC;YAChE,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,eAAe,IAAI,QAAQ,IAAI,QAAQ,EAAE,IAAI,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjE,IACE,IAAA,iCAAsB,EACpB,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,EACxC,QAAQ,EACR,OAAO,CACR,EACD,CAAC;gBACD,kDAAkD;gBAClD,QAAQ,CAAC,IAAI,GAAG,WAAW,CAAC;gBAC5B,QAAQ,CAAC,EAAE,GAAG,SAAS,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,WAAW,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAEhD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,MAAM;QACN,UAAU;KACK,CAAC;AACpB,CAAC"}

package/dist/cjs/selection/useSingle.d.ts

@@ -5,4 +5,13 @@ export type UseSingle<T extends DayPickerProps> = {
     isSelected: (date: Date) => boolean;
     selected: SelectedValue<T>;
 };
+/**
+ * Hook to manage single-date selection in the DayPicker component.
+ *
+ * @template T - The type of DayPicker props.
+ * @param props - The DayPicker props.
+ * @param dateLib - The date utility library instance.
+ * @returns An object containing the selected date, a function to select a date,
+ *   and a function to check if a date is selected.
+ */
 export declare function useSingle<T extends DayPickerProps>(props: DayPickerProps, dateLib: DateLib): Selection<T>;

package/dist/cjs/selection/useSingle.js

@@ -2,6 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useSingle = useSingle;
 const useControlledValue_js_1 = require("../helpers/useControlledValue.js");
+/**
+ * Hook to manage single-date selection in the DayPicker component.
+ *
+ * @template T - The type of DayPicker props.
+ * @param props - The DayPicker props.
+ * @param dateLib - The date utility library instance.
+ * @returns An object containing the selected date, a function to select a date,
+ *   and a function to check if a date is selected.
+ */
 function useSingle(props, dateLib) {
     const { selected: initiallySelected, required, onSelect } = props;
     const [internallySelected, setSelected] = (0, useControlledValue_js_1.useControlledValue)(initiallySelected, onSelect ? initiallySelected : undefined);

package/dist/cjs/selection/useSingle.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSingle.js","sourceRoot":"","sources":["../../../src/selection/useSingle.tsx"],"names":[],"mappings":";;AAmBA,8BAiDC;AAjED,4EAAsE;AAgBtE,SAAgB,SAAS,CACvB,KAAqB,EACrB,OAAgB;IAEhB,MAAM,EACJ,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EACR,QAAQ,EACT,GAAG,KAAoB,CAAC;IAEzB,MAAM,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAA,0CAAkB,EAC1D,iBAAiB,EACjB,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CACzC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAEpE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9B,MAAM,UAAU,GAAG,CAAC,WAAiB,EAAE,EAAE;QACvC,OAAO,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7D,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CACb,WAAiB,EACjB,SAAoB,EACpB,CAAyC,EACzC,EAAE;QACF,IAAI,OAAO,GAAqB,WAAW,CAAC;QAC5C,IAAI,CAAC,QAAQ,IAAI,QAAQ,IAAI,QAAQ,IAAI,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC1E,gDAAgD;YAChD,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,WAAW,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,EAAE,CAAC,OAAe,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,MAAM;QACN,UAAU;KACK,CAAC;AACpB,CAAC"}
+{"version":3,"file":"useSingle.js","sourceRoot":"","sources":["../../../src/selection/useSingle.tsx"],"names":[],"mappings":";;AA4BA,8BAiDC;AA1ED,4EAAsE;AAgBtE;;;;;;;;GAQG;AACH,SAAgB,SAAS,CACvB,KAAqB,EACrB,OAAgB;IAEhB,MAAM,EACJ,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EACR,QAAQ,EACT,GAAG,KAAoB,CAAC;IAEzB,MAAM,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAA,0CAAkB,EAC1D,iBAAiB,EACjB,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CACzC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAEpE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9B,MAAM,UAAU,GAAG,CAAC,WAAiB,EAAE,EAAE;QACvC,OAAO,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7D,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CACb,WAAiB,EACjB,SAAoB,EACpB,CAAyC,EACzC,EAAE;QACF,IAAI,OAAO,GAAqB,WAAW,CAAC;QAC5C,IAAI,CAAC,QAAQ,IAAI,QAAQ,IAAI,QAAQ,IAAI,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC1E,gDAAgD;YAChD,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,WAAW,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,EAAE,CAAC,OAAe,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,MAAM;QACN,UAAU;KACK,CAAC;AACpB,CAAC"}

package/dist/cjs/types/deprecated.d.ts

@@ -63,7 +63,7 @@ export type DayPickerMultipleProps = PropsMulti;
 export type DayPickerRangeProps = PropsRange;
 /**
  * @ignore
- * @deprecated This type will be removed. Use `NonNullable<unknown>` instead
+ * @deprecated This type will be removed. Use `NonNullable<unknown>` instead.
  */
 export type DayPickerDefaultProps = NonNullable<unknown>;
 /**
@@ -73,7 +73,7 @@ export type DayPickerDefaultProps = NonNullable<unknown>;
 export type DaySelectionMode = Mode;
 /**
  * @ignore
- * @deprecated This type will be removed. Use `string` instead;
+ * @deprecated This type will be removed. Use `string` instead.
  */
 export type Modifier = string;
 /**
@@ -84,19 +84,19 @@ export type Modifier = string;
 export type InternalModifier = DayFlag.disabled | DayFlag.hidden | DayFlag.focused | SelectionState.range_end | SelectionState.range_middle | SelectionState.range_start | SelectionState.selected;
 /**
  * @ignore
- * @deprecated This type will be removed. Use `SelectHandler<{mode: "single"}>`
- *   instead.
+ * @deprecated This type will be removed. Use `SelectHandler<{ mode: "single"
+ *   }>` instead.
  */
 export type SelectSingleEventHandler = PropsSingle["onSelect"];
 /**
  * @ignore
- * @deprecated This type will be removed. Use `SelectHandler<{mode:
- *   "multiple"}>` instead.
+ * @deprecated This type will be removed. Use `SelectHandler<{ mode: "multiple"
+ *   }>` instead.
  */
 export type SelectMultipleEventHandler = PropsMulti["onSelect"];
 /**
  * @ignore
- * @deprecated This type will be removed. Use `SelectHandler<{mode: "range"}>`
+ * @deprecated This type will be removed. Use `SelectHandler<{ mode: "range" }>`
  *   instead.
  */
 export type SelectRangeEventHandler = PropsRange["onSelect"];
@@ -107,7 +107,7 @@ export type SelectRangeEventHandler = PropsRange["onSelect"];
 export type DayPickerProviderProps = any;
 /**
  * @ignore
- * @deprecated This type has been removed to `useDayPicker`.
+ * @deprecated This type has been moved to `useDayPicker`.
  * @group Hooks
  */
 export declare const useNavigation: typeof useDayPicker;

package/dist/cjs/types/deprecated.js

@@ -20,7 +20,7 @@ exports.Caption = MonthCaption_js_1.MonthCaption;
 exports.Row = Week_js_1.Week;
 /**
  * @ignore
- * @deprecated This type has been removed to `useDayPicker`.
+ * @deprecated This type has been moved to `useDayPicker`.
  * @group Hooks
  */
 exports.useNavigation = useDayPicker_js_1.useDayPicker;

package/dist/cjs/types/props.d.ts

@@ -181,13 +181,28 @@ export interface PropsBase {
      * - `month`: display only the dropdown for the months
      * - `year`: display only the dropdown for the years
      *
-     * **Note:** showing the dropdown will set the start/end months
-     * {@link startMonth} to 100 years ago, and {@link endMonth} to the end of the
-     * current year.
+     * **Note:** By default, showing the dropdown will set the {@link startMonth}
+     * to 100 years ago and {@link endMonth} to the end of the current year. You
+     * can override this behavior by explicitly setting `startMonth` and
+     * `endMonth`.
      *
      * @see https://daypicker.dev/docs/customization#caption-layouts
      */
     captionLayout?: "label" | "dropdown" | "dropdown-months" | "dropdown-years";
+    /**
+     * Adjust the positioning of the navigation buttons.
+     *
+     * - `around`: Displays the buttons on either side of the caption.
+     * - `after`: Displays the buttons after the caption. This ensures the tab order
+     *   matches the visual order.
+     *
+     * If not set, the buttons default to being displayed after the caption, but
+     * the tab order may not align with the visual order.
+     *
+     * @since 9.7.0
+     * @see https://daypicker.dev/docs/customization#navigation-layouts
+     */
+    navLayout?: "around" | "after" | undefined;
     /**
      * Display always 6 weeks per each month, regardless of the month’s number of
      * weeks. Weeks will be filled with the days from the next month.
@@ -244,16 +259,12 @@ export interface PropsBase {
     ISOWeek?: boolean;
     /**
      * The time zone (IANA or UTC offset) to use in the calendar (experimental).
+     *
      * See
      * [Wikipedia](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
      * for the possible values.
      *
-     * Time zones are supported by the `TZDate` object by the
-     * [@date-fns/tz](https://github.com/date-fns/tz) package. Please refer to the
-     * package documentation for more information.
-     *
      * @since 9.1.1
-     * @experimental
      * @see https://daypicker.dev/docs/time-zone
      */
     timeZone?: string | undefined;
@@ -288,9 +299,10 @@ export interface PropsBase {
      */
     initialFocus?: boolean;
     /**
-     * Apply the `disabled` modifier to the matching days.
+     * Apply the `disabled` modifier to the matching days. Disabled days cannot be
+     * selected when in a selection mode is set.
      *
-     * @see https://daypicker.dev/docs/selection-modes#disabling-dates
+     * @see https://daypicker.dev/docs/selection-modes#disabled
      */
     disabled?: Matcher | Matcher[] | undefined;
     /**
@@ -310,6 +322,13 @@ export interface PropsBase {
     /**
      * Add modifiers to the matching days.
      *
+     * @example
+     *   const modifiers = {
+     *   weekend: { dayOfWeek: [0, 6] }, // Match weekends
+     *   holiday: [new Date(2023, 11, 25)] // Match Christmas
+     *   };
+     *   <DayPicker modifiers={modifiers} />
+     *
      * @see https://daypicker.dev/guides/custom-modifiers
      */
     modifiers?: Record<string, Matcher | Matcher[] | undefined> | undefined;
@@ -392,13 +411,13 @@ export interface PropsBase {
     numerals?: Numerals | undefined;
     /**
      * The index of the first day of the week (0 - Sunday). Overrides the locale's
-     * one.
+     * default.
      *
      * @see https://daypicker.dev/docs/localization#first-date-of-the-week
      */
     weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | undefined;
     /**
-     * The day of January, which is always in the first week of the year.
+     * The day of January that is always in the first week of the year.
      *
      * @see https://daypicker.dev/docs/localization#first-week-contains-date
      */
@@ -507,10 +526,22 @@ export interface PropsBase {
 /**
  * Shared handler type for `onSelect` callback when a selection mode is set.
  *
+ * @example
+ *   const handleSelect: OnSelectHandler<Date> = (
+ *     selected,
+ *     triggerDate,
+ *     modifiers,
+ *     e
+ *   ) => {
+ *     console.log("Selected:", selected);
+ *     console.log("Triggered by:", triggerDate);
+ *   };
+ *
  * @template T - The type of the selected item.
  * @callback OnSelectHandler
  * @param {T} selected - The selected item after the event.
- * @param {Date} triggerDate - The date when the event was triggered.
+ * @param {Date} triggerDate - The date when the event was triggered. This is
+ *   typically the day clicked or interacted with.
  * @param {Modifiers} modifiers - The modifiers associated with the event.
  * @param {React.MouseEvent | React.KeyboardEvent} e - The event object.
  */
@@ -588,6 +619,12 @@ export interface PropsMulti {
 export interface PropsRangeRequired {
     mode: "range";
     required: true;
+    /**
+     * Apply the `disabled` modifier to the matching days. Disabled days cannot be
+     * selected when in a selection mode is set.
+     *
+     * @see https://daypicker.dev/docs/selection-modes#disabled
+     */
     disabled?: Matcher | Matcher[] | undefined;
     /**
      * When `true`, the range will reset when including a disabled day.
@@ -613,11 +650,18 @@ export interface PropsRangeRequired {
 export interface PropsRange {
     mode: "range";
     required?: false | undefined;
+    /**
+     * Apply the `disabled` modifier to the matching days. Disabled days cannot be
+     * selected when in a selection mode is set.
+     *
+     * @see https://daypicker.dev/docs/selection-modes#disabled
+     */
     disabled?: Matcher | Matcher[] | undefined;
     /**
      * When `true`, the range will reset when including a disabled day.
      *
      * @since V9.0.2
+     * @see https://daypicker.dev/docs/selection-modes#exclude-disabled
      */
     excludeDisabled?: boolean | undefined;
     /** The selected range. */

package/dist/cjs/types/selection.d.ts

@@ -17,6 +17,19 @@ export type SelectedMulti<T extends {
 export type SelectedRange<T extends {
     required?: boolean;
 }> = T["required"] extends true ? DateRange : DateRange | undefined;
+/**
+ * Represents the selected value based on the selection mode.
+ *
+ * @example
+ *   // Single selection mode
+ *   const selected: SelectedValue<{ mode: "single" }> = new Date();
+ *
+ *   // Multiple selection mode
+ *   const selected: SelectedValue<{ mode: "multiple" }> = [new Date(), new Date()];
+ *
+ *   // Range selection mode
+ *   const selected: SelectedValue<{ mode: "range" }> = { from: new Date(), to: new Date() };
+ */
 export type SelectedValue<T> = T extends {
     mode: "single";
     required?: boolean;
@@ -36,6 +49,18 @@ export type SelectHandlerMulti<T extends {
 export type SelectHandlerRange<T extends {
     required?: boolean | undefined;
 }> = (triggerDate: Date, modifiers: Modifiers, e: React.MouseEvent | React.KeyboardEvent) => T["required"] extends true ? DateRange : DateRange | undefined;
+/**
+ * The handler to set a selection based on the mode.
+ *
+ * @example
+ *   const handleSelect: SelectHandler<{ mode: "single" }> = (
+ *     triggerDate,
+ *     modifiers,
+ *     e
+ *   ) => {
+ *     console.log("Selected date:", triggerDate);
+ *   };
+ */
 export type SelectHandler<T extends {
     mode?: Mode | undefined;
     required?: boolean | undefined;