@xsolla/xui-date-picker 0.195.1 → 0.196.1

package/native/index.d.mts

@@ -20,12 +20,24 @@ type DatePickerAlignment = "start" | "center" | "end";
 type DatePickerPlacement = DatePickerSide | `${DatePickerSide}-${DatePickerAlignment}`;
 interface DatePickerProps extends Omit<CalendarProps, "onChange"> {
     /**
-     * Calendar variant: "single" shows a single month, "dual" shows two months side-by-side.
-     * Dual variant forces range selection mode.
+     * Calendar variant: "single" shows a single month, "dual" shows two months
+     * side-by-side.
+     *
+     * `"dual"` forces range selection mode, which **changes the value contract**:
+     * the picker reads `startDate`/`endDate` (not `selectedDate`) and `onChange`
+     * reports a `[start, end]` {@link DateRangeType} tuple rather than a single
+     * `Date`. Switch a control between the two variants and you have to switch
+     * the props with it — feeding a range tuple back in as `selectedDate` is a
+     * type error that surfaces at runtime (FEP-887).
      */
     variant?: "single" | "dual";
     /**
      * Event handler when the value of a Datepicker changes.
+     *
+     * Receives a single `Date` in single-date mode, and a `[start, end]`
+     * {@link DateRangeType} tuple whenever the picker is in range mode
+     * (`variant="dual"` or `selectsRange`). Either side of the tuple can be
+     * `null` while a range is only half-picked.
      */
     onChange?: (date: Date | DateRangeType) => void;
     /**

package/native/index.d.ts

@@ -20,12 +20,24 @@ type DatePickerAlignment = "start" | "center" | "end";
 type DatePickerPlacement = DatePickerSide | `${DatePickerSide}-${DatePickerAlignment}`;
 interface DatePickerProps extends Omit<CalendarProps, "onChange"> {
     /**
-     * Calendar variant: "single" shows a single month, "dual" shows two months side-by-side.
-     * Dual variant forces range selection mode.
+     * Calendar variant: "single" shows a single month, "dual" shows two months
+     * side-by-side.
+     *
+     * `"dual"` forces range selection mode, which **changes the value contract**:
+     * the picker reads `startDate`/`endDate` (not `selectedDate`) and `onChange`
+     * reports a `[start, end]` {@link DateRangeType} tuple rather than a single
+     * `Date`. Switch a control between the two variants and you have to switch
+     * the props with it — feeding a range tuple back in as `selectedDate` is a
+     * type error that surfaces at runtime (FEP-887).
      */
     variant?: "single" | "dual";
     /**
      * Event handler when the value of a Datepicker changes.
+     *
+     * Receives a single `Date` in single-date mode, and a `[start, end]`
+     * {@link DateRangeType} tuple whenever the picker is in range mode
+     * (`variant="dual"` or `selectsRange`). Either side of the tuple can be
+     * `null` while a range is only half-picked.
      */
     onChange?: (date: Date | DateRangeType) => void;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xsolla/xui-date-picker",
-  "version": "0.195.1",
+  "version": "0.196.1",
   "main": "./web/index.js",
   "module": "./web/index.mjs",
   "types": "./web/index.d.ts",
@@ -13,11 +13,11 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@xsolla/xui-calendar": "0.195.1",
-    "@xsolla/xui-core": "0.195.1",
-    "@xsolla/xui-icons-base": "0.195.1",
-    "@xsolla/xui-input": "0.195.1",
-    "@xsolla/xui-primitives-core": "0.195.1",
+    "@xsolla/xui-calendar": "0.196.1",
+    "@xsolla/xui-core": "0.196.1",
+    "@xsolla/xui-icons-base": "0.196.1",
+    "@xsolla/xui-input": "0.196.1",
+    "@xsolla/xui-primitives-core": "0.196.1",
     "date-fns": "^3.0.0"
   },
   "peerDependencies": {

package/web/index.d.mts

@@ -20,12 +20,24 @@ type DatePickerAlignment = "start" | "center" | "end";
 type DatePickerPlacement = DatePickerSide | `${DatePickerSide}-${DatePickerAlignment}`;
 interface DatePickerProps extends Omit<CalendarProps, "onChange"> {
     /**
-     * Calendar variant: "single" shows a single month, "dual" shows two months side-by-side.
-     * Dual variant forces range selection mode.
+     * Calendar variant: "single" shows a single month, "dual" shows two months
+     * side-by-side.
+     *
+     * `"dual"` forces range selection mode, which **changes the value contract**:
+     * the picker reads `startDate`/`endDate` (not `selectedDate`) and `onChange`
+     * reports a `[start, end]` {@link DateRangeType} tuple rather than a single
+     * `Date`. Switch a control between the two variants and you have to switch
+     * the props with it — feeding a range tuple back in as `selectedDate` is a
+     * type error that surfaces at runtime (FEP-887).
      */
     variant?: "single" | "dual";
     /**
      * Event handler when the value of a Datepicker changes.
+     *
+     * Receives a single `Date` in single-date mode, and a `[start, end]`
+     * {@link DateRangeType} tuple whenever the picker is in range mode
+     * (`variant="dual"` or `selectsRange`). Either side of the tuple can be
+     * `null` while a range is only half-picked.
      */
     onChange?: (date: Date | DateRangeType) => void;
     /**

package/web/index.d.ts

@@ -20,12 +20,24 @@ type DatePickerAlignment = "start" | "center" | "end";
 type DatePickerPlacement = DatePickerSide | `${DatePickerSide}-${DatePickerAlignment}`;
 interface DatePickerProps extends Omit<CalendarProps, "onChange"> {
     /**
-     * Calendar variant: "single" shows a single month, "dual" shows two months side-by-side.
-     * Dual variant forces range selection mode.
+     * Calendar variant: "single" shows a single month, "dual" shows two months
+     * side-by-side.
+     *
+     * `"dual"` forces range selection mode, which **changes the value contract**:
+     * the picker reads `startDate`/`endDate` (not `selectedDate`) and `onChange`
+     * reports a `[start, end]` {@link DateRangeType} tuple rather than a single
+     * `Date`. Switch a control between the two variants and you have to switch
+     * the props with it — feeding a range tuple back in as `selectedDate` is a
+     * type error that surfaces at runtime (FEP-887).
      */
     variant?: "single" | "dual";
     /**
      * Event handler when the value of a Datepicker changes.
+     *
+     * Receives a single `Date` in single-date mode, and a `[start, end]`
+     * {@link DateRangeType} tuple whenever the picker is in range mode
+     * (`variant="dual"` or `selectsRange`). Either side of the tuple can be
+     * `null` while a range is only half-picked.
      */
     onChange?: (date: Date | DateRangeType) => void;
     /**