@gravity-ui/date-components 3.4.1 → 4.0.0

package/dist/docs/components/DatePicker.md

@@ -0,0 +1,194 @@
+# DatePicker
+
+`DatePicker` is a sophisticated, lightweight, and fully customizable component designed to provide intuitive date picking functionality in your React applications. Built with user experience and ease of integration in mind, it fits seamlessly within forms, modals, or any UI element requiring date input. It can be controlled if you set `value` property. Or it can be uncontrolled if you don't set any value, but in this case you can manage the initial state with optional property `defaultValue`. Component is uncontrolled by default.
+
+```tsx
+import {DatePicker} from '@gravity-ui/date-components';
+```
+
+### Useful addition
+
+To set dates in the right format you may need to include additional helpers from [Date Utils library](https://gravity-ui.com/libraries/date-utils)
+
+```tsx
+import {dateTimeParse, dateTime} from '@gravity-ui/date-utils';
+```
+
+## Appearance
+
+The appearance of `DatePicker` is controlled by the `size`, `view` and `pin` properties.
+
+### Size
+
+To control the size of the `DatePicker` use the `size` property. Default size is `m`.
+
+```tsx
+<DatePicker size="s" />
+<DatePicker size="m" />
+<DatePicker size="l" />
+<DatePicker size="xl" />
+```
+
+### View
+
+`normal` - the main view of `DatePicker` (used by default).
+
+`clear` - view of `DatePicker` without visible borders (can be used with a custom wrapper)
+
+```tsx
+<DatePicker view="normal" />
+<DatePicker view="clear" />
+```
+
+### Pin
+
+The `pin` property allows you to control the shape of the right and left edges and is usually used for combining multiple controls in a single unit.
+The value of the `pin` property consists of left and edge style names divided by a dash, e.g. `"round-brick"`.
+The edge styles are: `round` (default), `circle`, `brick` and `clear`.
+
+```tsx
+<DatePicker pin="round-brick" />
+<DatePicker pin="brick-brick" />
+<DatePicker pin="brick-round" />
+```
+
+## Value
+
+### Min and max value
+
+The `minValue` property allows you to specify the earliest date and time that can be entered by the user. Conversely, the `maxValue` property specifies the latest date and time that can be entered. If you input the value out of this bounds component changes it's view like in case of invalid validation state.
+
+```tsx
+
+<DatePicker minValue={dateTimeParse('01.01.2024')} />
+<DatePicker maxValue={dateTimeParse('01.01.2025')} />
+```
+
+## States
+
+### Disabled
+
+The state of the `DatePicker` where you don't want the user to be able to interact with the component.
+
+```tsx
+<DatePicker disabled defaultValue={dateTime()} />
+```
+
+### Readonly
+
+`readOnly` is a boolean attribute that, when set to true, makes the `DatePicker` component immutable to the user. This means that while the input will display its current value, users will not be able to change it.
+
+```tsx
+<DatePicker readOnly defaultValue={dateTime()} />
+```
+
+### Error
+
+The state of the `DatePicker` in which you want to indicate incorrect user input. To change `DatePicker` appearance, use the `validationState` property with the `"invalid"` value. An optional message text can be added via the `errorMessage` property. Message text will be rendered under the component.
+
+```tsx
+<DatePicker errorMessage="Error message" validationState="invalid" />
+<DatePicker validationState="invalid" />
+```
+
+## Additional content
+
+### Placeholder
+
+This prop allows you to provide a short hint that describes the expected value of the input field. This hint is displayed within the input field before the user enters a value, and it disappears upon the entry of text.
+
+```tsx
+<DatePicker placeholder="Placeholder" />
+```
+
+### Label
+
+Allows you to place the label in the left part of the field. Label can take up no more than half the width of the entire space of `DatePicker`.
+
+```tsx
+<DatePicker label="Label" />
+```
+
+### Clear button
+
+`hasClear` is a boolean prop that, provides users with the ability to quickly clear the content of the input field.
+
+```tsx
+<DatePicker hasClear />
+```
+
+## Format
+
+The `format` prop is a string that defines the date and time format the `DatePicker` component will accept and display. This prop determines how the date and time are visually presented to the user and how the user's input is expected to be formatted. [Available formats](https://day.js.org/docs/en/display/format)
+
+```tsx
+<DatePicker format="LL" />
+```
+
+### Custom Date Parser
+
+You can provide a custom parser function to handle pasted date strings through the `parseDateFromString` prop. This is useful when you need to support specific date formats or custom parsing logic that differs from the default behavior.
+
+```tsx
+import {dateTime} from '@gravity-ui/date-utils';
+
+const customParser = (dateStr: string, format: string, timeZone?: string) => {
+  // Custom parsing logic
+  // For example, handle DD/MM/YYYY format specifically
+  if (dateStr.match(/^\d{2}\/\d{2}\/\d{4}$/)) {
+    const [day, month, year] = dateStr.split('/');
+    return dateTime({input: `${year}-${month}-${day}`, timeZone});
+  }
+  // Fallback to default parsing
+  return dateTime({input: dateStr, format, timeZone});
+};
+
+<DatePicker parseDateFromString={customParser} />;
+```
+
+## Time zone
+
+`timeZone` is the property to set the time zone of the value in the input. [Learn more about time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List)
+
+## Customisation
+
+If you want to use custom calendar component inside `DatePicker` you can pass it as `children` with calendar like props.
+
+[Learn more about calendar](https://github.com/gravity-ui/date-components/blob/main/src/components/Calendar/README.md)
+
+## Properties
+
+| Name                           | Description                                                                                                                                |                                 Type                                 |          Default          |
+| :----------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------: | :-----------------------: |
+| aria-describedby               | The control's `aria-describedby`. Identifies the element (or elements) that describes the object. attribute                                |                               `string`                               |                           |
+| aria-details                   | The control's `aria-details`. Identifies the element (or elements) that provide a detailed, extended description for the object. attribute |                               `string`                               |                           |
+| aria-label                     | The control's `aria-label`. Defines a string value that labels the current element. attribute                                              |                               `string`                               |                           |
+| aria-labelledby                | The control's `aria-labelledby`. Identifies the element (or elements) that labels the current element. attribute                           |                               `string`                               |                           |
+| autoFocus                      | The control's `autofocus`. Whether the element should receive focus on render. attribute                                                   |                              `boolean`                               |                           |
+| className                      | The control's wrapper class name                                                                                                           |                               `string`                               |                           |
+| [defaultValue](#datepicker)    | Sets the initial value for uncontrolled component.                                                                                         |                              `DateTime`                              |                           |
+| [disabled](#disabled)          | Indicates that the user cannot interact with the control                                                                                   |                              `boolean`                               |          `false`          |
+| [errorMessage](#error)         | Error text                                                                                                                                 |                             `ReactNode`                              |                           |
+| [format](#format)              | Format of the date when rendered in the input. [Available formats](https://day.js.org/docs/en/display/format)                              |                               `string`                               |                           |
+| [hasClear](#clear-button)      | Shows the icon for clearing control's value                                                                                                |                              `boolean`                               |          `false`          |
+| id                             | The control's `id` attribute                                                                                                               |                               `string`                               |                           |
+| isDateUnavailable              | Callback that is called for each date of the calendar. If it returns true, then the date is unavailable.                                   |                   `((date: DateTime) => boolean)`                    |                           |
+| [label](#label)                | Help text rendered to the left of the input node                                                                                           |                               `string`                               |                           |
+| [maxValue](#min-and-max-value) | The maximum allowed date that a user may select.                                                                                           |                              `DateTime`                              |                           |
+| [minValue](#min-and-max-value) | The minimum allowed date that a user may select.                                                                                           |                              `DateTime`                              |                           |
+| onBlur                         | Fires when the control lost focus. Provides focus event as a callback's argument                                                           |            `((e: FocusEvent<Element, Element>) => void)`             |                           |
+| onFocus                        | Fires when the control gets focus. Provides focus event as a callback's argument                                                           |            `((e: FocusEvent<Element, Element>) => void)`             |                           |
+| onKeyDown                      | Fires when a key is pressed. Provides keyboard event as a callback's argument                                                              |               `((e: KeyboardEvent<Element>) => void)`                |                           |
+| onKeyUp                        | Fires when a key is released. Provides keyboard event as a callback's argument                                                             |               `((e: KeyboardEvent<Element>) => void)`                |                           |
+| onUpdate                       | Fires when the value is changed by the user. Provides new value as an callback's argument                                                  |                 `((value: DateTime \| null) => void`                 |                           |
+| parseDateFromString            | Custom parser function for parsing pasted date strings. If not provided, the default parser will be used.                                  | `((dateStr: string, format: string, timeZone?: string) => DateTime)` |                           |
+| [pin](#pin)                    | Corner rounding                                                                                                                            |                            `TextInputPin`                            |      `'round-round'`      |
+| [placeholder](#placeholder)    | Text that appears in the control when it has no value set                                                                                  |                               `string`                               |                           |
+| placeholderValue               | A placeholder date that controls the default values of each segment when the user first interacts with them.                               |                              `DateTime`                              | `today's date at midnigh` |
+| [readOnly](#readonly)          | Whether the component's value is immutable.                                                                                                |                              `boolean`                               |          `false`          |
+| [size](#size)                  | The size of the control                                                                                                                    |                       `"s"` `"m"` `"l"` `"xl"`                       |           `"m"`           |
+| style                          | Sets inline style for the element.                                                                                                         |                           `CSSProperties`                            |                           |
+| [timeZone](#time-zone)         | Sets the time zone. [Learn more about time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List)                       |                               `string`                               |                           |
+| [validationState](#error)      | Validation state                                                                                                                           |                             `"invalid"`                              |                           |
+| [value](#datepicker)           | The value of the control                                                                                                                   |                          `DateTime` `null`                           |                           |
+| [view](#view)                  | The view of the control                                                                                                                    |                         `"normal"` `"clear"`                         |        `"normal"`         |

package/dist/docs/components/RangeCalendar.md

@@ -0,0 +1,125 @@
+# RangeCalendar
+
+`RangeCalendar` is a powerful, flexible, and user-friendly UI component designed for selecting a range of dates. Built with React, it combines the functionality of a calendar and a date range picker, making it an ideal choice for applications that require users to input a start and end date. It can be controlled if you set `value` property. Or it can be uncontrolled if you don't set any value, but in this case you can manage the initial state with optional property `defaultValue`. Component is uncontrolled by default.
+
+```tsx
+import {RangeCalendar} from '@gravity-ui/date-components';
+```
+
+### Useful addition
+
+To set dates in the right format you may need to include additional helpers from [Date Utils library](https://gravity-ui.com/libraries/date-utils)
+
+```tsx
+import {dateTimeParse, dateTime} from '@gravity-ui/date-utils';
+```
+
+## Size
+
+To control the size of the `RangeCalendar` use the `size` property. Default size is `m`.
+
+```tsx
+<RangeCalendar size="m" />
+<RangeCalendar size="l" />
+<RangeCalendar size="xl" />
+```
+
+## Value
+
+### Min and max value
+
+The `minValue` property allows you to specify the earliest date and time that can be entered by the user. Conversely, the `maxValue` property specifies the latest date and time that can be entered. All other values will be disabled for user.
+
+```tsx
+<RangeCalendar minValue={dateTimeParse('01.01.2024')} maxValue={dateTimeParse('01.01.2025')} />
+```
+
+## Mode
+
+Defines the time interval that `RangeCalendar` should display. With `mode` you can choose it in controlled way. For uncontrolled way you don't need to specify any value. Also you can set the initial mode in uncontrolled way with `defaultMode` prop.
+
+`days` - default mode for `RangeCalendar`. It shows days in month.
+
+`months` - shows months in year
+
+`quarters` - shows quarters by years (not available as value in `defaultMode`)
+
+`years` - shows several years for select
+
+You can limit enabled modes by using prop `modes`.
+
+```tsx
+<RangeCalendar defaultMode="months" />
+```
+
+## States
+
+### Disabled
+
+The state of the `RangeCalendar` where you don't want the user to be able to interact with the component.
+
+```tsx
+<RangeCalendar
+  disabled={true}
+  defaultValue={{start: dateTime().add({days: 2}), end: dateTime().subtract({days: 2})}}
+/>
+```
+
+### Readonly
+
+`readOnly` is a boolean attribute that, when set to true, makes the `RangeCalendar` component immutable to the user. This means that while the input will display its current value, users will not be able to change it.
+
+```tsx
+<RangeCalendar
+  readOnly={true}
+  defaultValue={{start: dateTime().add({days: 2}), end: dateTime().subtract({days: 2})}}
+/>
+```
+
+## Focused value
+
+Allows to select the date that `RangeCalendar` view is focused on. If you need it to be controlled you shoud use `focusedValue` prop. You can set the initial focused value for uncontrolled component with optional prop `defaultFocusedValue`.
+
+```tsx
+<RangeCalendar
+  defaultFocusedValue={dateTimeParse('01.01.2020')}
+  defaultValue={{start: dateTime().add({days: 2}), end: dateTime().subtract({days: 2})}}
+/>
+```
+
+## Time zone
+
+`timeZone` is the property to set the time zone of the value in the input. [Learn more about time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List)
+
+## Properties
+
+| Name                                  | Description                                                                                                          |                               Type                               |                           Default                           |
+| :------------------------------------ | :------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------: | :---------------------------------------------------------: |
+| aria-describedby                      | The control's `aria-describedby` attribute                                                                           |                             `string`                             |                                                             |
+| aria-details                          | The control's `aria-details` attribute                                                                               |                             `string`                             |                                                             |
+| aria-label                            | The control's `aria-label` attribute                                                                                 |                             `string`                             |                                                             |
+| aria-labelledby                       | The control's `aria-labelledby` attribute                                                                            |                             `string`                             |                                                             |
+| autoFocus                             | The control's `autofocus` attribute                                                                                  |                            `boolean`                             |                                                             |
+| className                             | The control's wrapper class name                                                                                     |                             `string`                             |                                                             |
+| [defaultFocusedValue](#focused-value) | The date that is focused when the calendar first mounts (uncontrolled)                                               |                            `DateTime`                            |                                                             |
+| [defaultMode](#mode)                  | Initial mode to show in calendar                                                                                     |                `days` `months` `quarters` `years`                |                                                             |
+| [defaultValue](#value)                | Sets the initial value for uncontrolled component.                                                                   |                      `RangeValue<DateTime>`                      |                                                             |
+| [disabled](#disabled)                 | Indicates that the user cannot interact with the control                                                             |                            `boolean`                             |                           `false`                           |
+| [focusedValue](#focused-value)        | Set the default view of uncontrolled component which includes this value                                             |                        `DateTime` `null`                         |                                                             |
+| id                                    | The control's `id` attribute                                                                                         |                             `string`                             |                                                             |
+| isDateUnavailable                     | Callback that is called for each date of the calendar. If it returns true, then the date is unavailable.             |                 `((date: DateTime) => boolean)`                  |                                                             |
+| isWeekend                             | Callback that is called for each date of the calendar. If it returns true, then the date is weekend.                 |                 `((date: DateTime) => boolean)`                  |                                                             |
+| [maxValue](#min-and-max-value)        | The maximum allowed date that a user may select.                                                                     |                            `DateTime`                            |                                                             |
+| [minValue](#min-and-max-value)        | The minimum allowed date that a user may select.                                                                     |                            `DateTime`                            |                                                             |
+| [mode](#mode)                         | Defines the time interval that `RangeCalendar` should display in colttrolled way.                                    |                `days` `months` `quarters` `years`                |                                                             |
+| modes                                 | Modes available to user                                                                                              |         `Partial<Record<RangeCalendarLayout, boolean>>`          | `{days: true, months: true, quarters: false, years: true }` |
+| onBlur                                | Fires when the control lost focus. Provides focus event as a callback's argument                                     |          `((e: FocusEvent<Element, Element>) => void)`           |                                                             |
+| onFocus                               | Fires when the control gets focus. Provides focus event as a callback's argument                                     |          `((e: FocusEvent<Element, Element>) => void)`           |                                                             |
+| onFocusUpdate                         | Fires when the control's focused date changes.                                                                       |                   `((date: DateTime) => void)`                   |                                                             |
+| onUpdate                              | Fires when the value is changed.                                                                                     |                   `((value: DateTime) => void`                   |                                                             |
+| onUpdateMode                          | Fires when the mode is changed.                                                                                      | `((value: 'days' \| 'months' \| 'quarters' \| 'years' ) => void` |                                                             |
+| [readOnly](#readonly)                 | Whether the calendar value is immutable.                                                                             |                            `boolean`                             |                           `false`                           |
+| [size](#size)                         | The size of the control                                                                                              |                        `"m"` `"l"` `"xl"`                        |                            `"m"`                            |
+| style                                 | Sets inline style for the element.                                                                                   |                         `CSSProperties`                          |                                                             |
+| [timeZone](#time-zone)                | Sets the time zone. [Learn more about time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List) |                             `string`                             |                                                             |
+| [value](#calendar)                    | The value of the control                                                                                             |                  `RangeValue<DateTime>` `null`                   |                                                             |

package/dist/docs/components/RelativeDateField.md

@@ -0,0 +1,73 @@
+# RelativeDateField
+
+`RelativeDateField` component is used only for entering relative dates. It can't be used as "normal" `DateField`.
+
+```tsx
+import {RelativeDateField} from '@gravity-ui/date-components';
+```
+
+## Relative input
+
+The component get values in special relative format. You set values as formulas which will help you to compute the exact date. We can call it `grafana-like format` because it is very similar to format of Grafana's relative time fields. To know more about relative time values in Grafana read [the docs](https://grafana.com/docs/grafana/latest/panels-visualizations/query-transform-data/).
+
+Using this mode you can deliver your data from source to destination and compute the exact value straight on the necessary endpoit without inaccuracy.
+
+## Valid input rules
+
+- a value should starts from keyword `now`
+- relative date expression in common looks like: `now${operand}${count}${unit}`
+- available values for `operand`:
+  - `-` - subtraction
+  - `+` - addition
+  - `/` - bringing to the start of the `unit`
+- valid values of `count` - any natural number
+- valid values of `unit`:
+  - `d` - day
+  - `w` - week
+  - `M` - month
+  - `Q` - quarter
+  - `y` - year
+  - `h` - hour
+  - `m` - minute
+
+### Examples of usage
+
+> `now-1d`
+>
+> `now/w`
+>
+> `now+10d-5d/M`
+
+## Properties
+
+| Name             | Description                                                                                                          |                     Type                      |     Default     |
+| :--------------- | :------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------: | :-------------: |
+| aria-describedby | The control's `aria-describedby` attribute                                                                           |                   `string`                    |                 |
+| aria-details     | The control's `aria-details` attribute                                                                               |                   `string`                    |                 |
+| aria-label       | The control's `aria-label` attribute                                                                                 |                   `string`                    |                 |
+| aria-labelledby  | The control's `aria-labelledby` attribute                                                                            |                   `string`                    |                 |
+| autoFocus        | The control's `autofocus` attribute                                                                                  |                   `boolean`                   |                 |
+| className        | The control's wrapper class name                                                                                     |                   `string`                    |                 |
+| defaultValue     | Sets the initial value for uncontrolled component.                                                                   |                   `string`                    |                 |
+| disabled         | Indicates that the user cannot interact with the control                                                             |                   `boolean`                   |     `false`     |
+| errorMessage     | Error text                                                                                                           |                  `ReactNode`                  |                 |
+| hasClear         | Shows the icon for clearing control's value                                                                          |                   `boolean`                   |     `false`     |
+| hasTime          | Show time field in popupvalue                                                                                        |                   `boolean`                   |     `false`     |
+| id               | The control's `id` attribute                                                                                         |                   `string`                    |                 |
+| label            | Help text rendered to the left of the input node                                                                     |                   `string`                    |                 |
+| leftContent      | The user`s node rendered before label and input                                                                      |               `React.ReactNode`               |                 |
+| onBlur           | Fires when the control lost focus. Provides focus event as a callback's argument                                     | `((e: FocusEvent<Element, Element>) => void)` |                 |
+| onFocus          | Fires when the control gets focus. Provides focus event as a callback's argument                                     | `((e: FocusEvent<Element, Element>) => void)` |                 |
+| onKeyDown        | Fires when a key is pressed. Provides keyboard event as a callback's argument                                        |    `((e: KeyboardEvent<Element>) => void)`    |                 |
+| onKeyUp          | Fires when a key is released. Provides keyboard event as a callback's argument                                       |    `((e: KeyboardEvent<Element>) => void)`    |                 |
+| onUpdate         | Fires when the value is changed by the user. Provides new value as an callback's argument                            |      `((value: string \| null) => void`       |                 |
+| pin              | Corner rounding                                                                                                      |                   `string`                    | `'round-round'` |
+| placeholder      | Text that appears in the control when it has no value set                                                            |                   `string`                    |                 |
+| readOnly         | Whether the component's value is immutable.                                                                          |                   `boolean`                   |     `false`     |
+| rightContent     | User`s node rendered after the input node and clear button                                                           |               `React.ReactNode`               |                 |
+| size             | The size of the control                                                                                              |           `"s"` `"m"` `"l"` `"xl"`            |      `"m"`      |
+| style            | Sets inline style for the element.                                                                                   |                `CSSProperties`                |                 |
+| timeZone         | Sets the time zone. [Learn more about time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List) |                   `string`                    |                 |
+| validationState  | Validation state                                                                                                     |                  `"invalid"`                  |                 |
+| value            | The value of the control                                                                                             |                `string` `null`                |                 |
+| view             | The view of the control                                                                                              |             `"normal"` `"clear"`              |   `"normal"`    |

package/dist/docs/components/RelativeDatePicker.md

@@ -0,0 +1,59 @@
+# RelativeDatePicker
+
+`RelativeDatePicker` is almost the same component as `DatePicker` but it has ability to use relative dates.
+
+```tsx
+import {RelativeDatePicker} from '@gravity-ui/date-components';
+```
+
+## Difference from `DatePicker`
+
+`RelativeDatePicker` can work in two modes: `absolute` and `relative`. You can switch it interactively by click on `f(x)` button. Or you can set field `type` in `value` or `defaultValue` object.
+
+### Absolute
+
+`RelativeDatePicker`'s behaviour in `absolute` mode is very similar to simple `DatePicker`.
+
+Learn more about DatePicker
+
+### Relative
+
+In this mode `RelativeDatePicker` get and return values in special relative format.
+
+Learn more about rules of relative formulas
+
+## Properties
+
+| Name              | Description                                                                                                                                |                     Type                      |          Default          |
+| :---------------- | :----------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------: | :-----------------------: |
+| aria-describedby  | The control's `aria-describedby`. Identifies the element (or elements) that describes the object. attribute                                |                   `string`                    |                           |
+| aria-details      | The control's `aria-details`. Identifies the element (or elements) that provide a detailed, extended description for the object. attribute |                   `string`                    |                           |
+| aria-label        | The control's `aria-label`. Defines a string value that labels the current element. attribute                                              |                   `string`                    |                           |
+| aria-labelledby   | The control's `aria-labelledby`. Identifies the element (or elements) that labels the current element. attribute                           |                   `string`                    |                           |
+| autoFocus         | The control's `autofocus`. Whether the element should receive focus on render. attribute                                                   |                   `boolean`                   |                           |
+| className         | The control's wrapper class name                                                                                                           |                   `string`                    |                           |
+| defaultValue      | Sets the initial value for uncontrolled component.                                                                                         |                    `Value`                    |                           |
+| disabled          | Indicates that the user cannot interact with the control                                                                                   |                   `boolean`                   |          `false`          |
+| errorMessage      | Error text                                                                                                                                 |                  `ReactNode`                  |                           |
+| format            | Format of the date when rendered in the input. [Available formats](https://day.js.org/docs/en/display/format)                              |                   `string`                    |                           |
+| hasClear          | Shows the icon for clearing control's value                                                                                                |                   `boolean`                   |          `false`          |
+| id                | The control's `id` attribute                                                                                                               |                   `string`                    |                           |
+| isDateUnavailable | Callback that is called for each date of the calendar. If it returns true, then the date is unavailable.                                   |        `((date: DateTime) => boolean)`        |                           |
+| label             | Help text rendered to the left of the input node                                                                                           |                   `string`                    |                           |
+| maxValue          | The maximum allowed date that a user may select.                                                                                           |                  `DateTime`                   |                           |
+| minValue          | The minimum allowed date that a user may select.                                                                                           |                  `DateTime`                   |                           |
+| onBlur            | Fires when the control lost focus. Provides focus event as a callback's argument                                                           | `((e: FocusEvent<Element, Element>) => void)` |                           |
+| onFocus           | Fires when the control gets focus. Provides focus event as a callback's argument                                                           | `((e: FocusEvent<Element, Element>) => void)` |                           |
+| onKeyDown         | Fires when a key is pressed. Provides keyboard event as a callback's argument                                                              |    `((e: KeyboardEvent<Element>) => void)`    |                           |
+| onKeyUp           | Fires when a key is released. Provides keyboard event as a callback's argument                                                             |    `((e: KeyboardEvent<Element>) => void)`    |                           |
+| onUpdate          | Fires when the value is changed by the user. Provides new value as an callback's argument                                                  |       `((value: Value \| null) => void`       |                           |
+| pin               | Corner rounding                                                                                                                            |                `TextInputPin`                 |      `'round-round'`      |
+| placeholder       | Text that appears in the control when it has no value set                                                                                  |                   `string`                    |                           |
+| placeholderValue  | A placeholder date that controls the default values of each segment when the user first interacts with them.                               |                  `DateTime`                   | `today's date at midnigh` |
+| readOnly          | Whether the component's value is immutable.                                                                                                |                   `boolean`                   |          `false`          |
+| size              | The size of the control                                                                                                                    |           `"s"` `"m"` `"l"` `"xl"`            |           `"m"`           |
+| style             | Sets inline style for the element.                                                                                                         |                `CSSProperties`                |                           |
+| timeZone          | Sets the time zone. [Learn more about time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List)                       |                   `string`                    |                           |
+| validationState   | Validation state                                                                                                                           |                  `"invalid"`                  |                           |
+| value             | The value of the control                                                                                                                   |                `Value` `null`                 |                           |
+| view              | The view of the control                                                                                                                    |             `"normal"` `"clear"`              |        `"normal"`         |

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

@@ -1,14 +1,18 @@
 import React from 'react';
 import type { DateTime } from '@gravity-ui/date-utils';
 import type { CalendarInstance, CalendarSize } from "../CalendarView/CalendarView.js";
+import type { CalendarValueType, SelectionMode } from "../CalendarView/hooks/types.js";
 import type { CalendarStateOptions } from "../CalendarView/hooks/useCalendarState.js";
 import type { AccessibilityProps, DomProps, FocusEvents, StyleProps } from "../types/index.js";
 import "../CalendarView/Calendar.css";
-export interface CalendarProps<T = DateTime> extends CalendarStateOptions<T>, DomProps, StyleProps, FocusEvents, AccessibilityProps {
+export interface CalendarCommonProps<T = DateTime> extends CalendarStateOptions<T>, DomProps, StyleProps, FocusEvents, AccessibilityProps {
     /**
      * The size of the element.
      * @default m
      */
     size?: CalendarSize;
 }
-export declare const Calendar: React.ForwardRefExoticComponent<CalendarProps<DateTime> & React.RefAttributes<CalendarInstance>>;
+export interface CalendarProps<M extends SelectionMode = 'single'> extends CalendarCommonProps<CalendarValueType<M>> {
+    selectionMode?: M;
+}
+export declare const Calendar: <M extends SelectionMode = "single">(props: CalendarProps<M> & React.RefAttributes<CalendarInstance>) => React.ReactNode;

package/dist/esm/components/Calendar/Calendar.js

@@ -6,6 +6,6 @@ import { useCalendarState } from "../CalendarView/hooks/useCalendarState.js";
 import "../CalendarView/Calendar.css";
 export const Calendar = React.forwardRef(function Calendar(props, ref) {
     const state = useCalendarState(props);
-    return _jsx(CalendarView, Object.assign({ ref: ref }, props, { state: state }));
+    return _jsx(CalendarView, { ref: ref, ...props, state: state });
 });
 //# sourceMappingURL=Calendar.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Calendar.js","sourceRoot":"../../../../src","sources":["components/Calendar/Calendar.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAC,YAAY,EAAC,wCAAqC;AAE1D,OAAO,EAAC,gBAAgB,EAAC,kDAA+C;AAIxE,sCAAuC;AAcvC,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAkC,SAAS,QAAQ,CACvF,KAAoB,EACpB,GAAG;IAEH,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAEtC,OAAO,KAAC,YAAY,kBAAC,GAAG,EAAE,GAAG,IAAM,KAAK,IAAE,KAAK,EAAE,KAAK,IAAI,CAAC;AAC/D,CAAC,CAAC,CAAC","sourcesContent":["'use client';\n\nimport React from 'react';\n\nimport type {DateTime} from '@gravity-ui/date-utils';\n\nimport {CalendarView} from '../CalendarView/CalendarView';\nimport type {CalendarInstance, CalendarSize} from '../CalendarView/CalendarView';\nimport {useCalendarState} from '../CalendarView/hooks/useCalendarState';\nimport type {CalendarStateOptions} from '../CalendarView/hooks/useCalendarState';\nimport type {AccessibilityProps, DomProps, FocusEvents, StyleProps} from '../types';\n\nimport '../CalendarView/Calendar.scss';\n\nexport interface CalendarProps<T = DateTime>\n    extends CalendarStateOptions<T>,\n        DomProps,\n        StyleProps,\n        FocusEvents,\n        AccessibilityProps {\n    /**\n     * The size of the element.\n     * @default m\n     */\n    size?: CalendarSize;\n}\nexport const Calendar = React.forwardRef<CalendarInstance, CalendarProps>(function Calendar(\n    props: CalendarProps,\n    ref,\n) {\n    const state = useCalendarState(props);\n\n    return <CalendarView ref={ref} {...props} state={state} />;\n});\n"]}
+{"version":3,"file":"Calendar.js","sourceRoot":"../../../../src","sources":["components/Calendar/Calendar.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAC,YAAY,EAAC,wCAAqC;AAG1D,OAAO,EAAC,gBAAgB,EAAC,kDAA+C;AAIxE,sCAAuC;AAiBvC,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAkC,SAAS,QAAQ,CACvF,KAAoB,EACpB,GAAG;IAEH,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAEtC,OAAO,KAAC,YAAY,IAAC,GAAG,EAAE,GAAG,KAAM,KAAK,EAAE,KAAK,EAAE,KAAK,GAAI,CAAC;AAC/D,CAAC,CAEmB,CAAC","sourcesContent":["'use client';\n\nimport React from 'react';\n\nimport type {DateTime} from '@gravity-ui/date-utils';\n\nimport {CalendarView} from '../CalendarView/CalendarView';\nimport type {CalendarInstance, CalendarSize} from '../CalendarView/CalendarView';\nimport type {CalendarValueType, SelectionMode} from '../CalendarView/hooks/types';\nimport {useCalendarState} from '../CalendarView/hooks/useCalendarState';\nimport type {CalendarStateOptions} from '../CalendarView/hooks/useCalendarState';\nimport type {AccessibilityProps, DomProps, FocusEvents, StyleProps} from '../types';\n\nimport '../CalendarView/Calendar.scss';\n\nexport interface CalendarCommonProps<T = DateTime>\n    extends CalendarStateOptions<T>, DomProps, StyleProps, FocusEvents, AccessibilityProps {\n    /**\n     * The size of the element.\n     * @default m\n     */\n    size?: CalendarSize;\n}\n\nexport interface CalendarProps<M extends SelectionMode = 'single'> extends CalendarCommonProps<\n    CalendarValueType<M>\n> {\n    selectionMode?: M;\n}\n\nexport const Calendar = React.forwardRef<CalendarInstance, CalendarProps>(function Calendar(\n    props: CalendarProps,\n    ref,\n) {\n    const state = useCalendarState(props);\n\n    return <CalendarView ref={ref} {...props} state={state} />;\n}) as <M extends SelectionMode = 'single'>(\n    props: CalendarProps<M> & React.RefAttributes<CalendarInstance>,\n) => React.ReactNode;\n"]}

package/dist/esm/components/CalendarView/Calendar.css

@@ -206,6 +206,9 @@
 .g-date-calendar__button_selected.g-date-calendar__button_selection-start, .g-date-calendar__button_selected.g-date-calendar__button_selection-end {
   background-color: var(--g-color-base-brand);
 }
+.g-date-calendar__button_selected.g-date-calendar__button_selection-start:not(.g-date-calendar__button_weekend), .g-date-calendar__button_selected.g-date-calendar__button_selection-end:not(.g-date-calendar__button_weekend) {
+  color: var(--g-color-text-brand-contrast);
+}
 .g-date-calendar__button_weekend {
   color: var(--g-color-text-danger);
 }