@snack-uikit/calendar 0.13.12 → 0.13.13

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## <small>0.13.13 (2026-01-19)</small>
+
+* chore(FF-6693): migrate tests from TestCafe to Playwright ([f32aff8](https://github.com/cloud-ru-tech/snack-uikit/commit/f32aff8))
+* chore(FF-6693): tune test configs ([d194f4d](https://github.com/cloud-ru-tech/snack-uikit/commit/d194f4d))
+* docs(FF-7788): readme update ([e3142b8](https://github.com/cloud-ru-tech/snack-uikit/commit/e3142b8))
+
+
+
+
+
 ## <small>0.13.12 (2025-12-06)</small>
 
 ### Only dependencies have been changed

package/README.md

@@ -5,24 +5,95 @@
 
 [Changelog](./CHANGELOG.md)
 
-## Example
+## Description
+
+- Пакет `@snack-uikit/calendar` предоставляет компоненты для выбора даты, диапазона дат и времени: календарь (`Calendar`) и отдельный пикер времени (`TimePicker`).
+- Компоненты покрывают основные сценарии работы с датой и временем: выбор одной даты, периода, месяца, года или даты с временем, а также точную установку времени по часам, минутам и опционально секундам.
+- Оба компонента поддерживают локализацию (язык и формат дат), управление фокусом с клавиатуры и подстройку под размер контейнера через `fitToContainer`, что упрощает их встраивание в сложные интерфейсы.
+- Для режима диапазона в календаре доступны пресеты быстрого выбора периода (например, «Сегодня», «Неделя», «Месяц»), которые можно настраивать через проп `presets`.
+
+## Calendar
+
+### Description
+
+- `Calendar` — основной компонент для выбора дат и периодов: он может работать в режимах `date`, `range`, `month`, `year` и `date-time` (дата и время).
+- Компонент поддерживает как контролируемый (`value` + `onChangeValue`), так и неконтролируемый (`defaultValue`) режимы и умеет подстраиваться под разные размеры через проп `size` (`s`, `m`, `l`).
+- С помощью колбека `buildCellProps` можно управлять доступностью и подсветкой отдельных ячеек (например, отключить прошлые даты или выделить праздничные дни), а опция `showHolidays` автоматически раскрашивает выходные.
+- Проп `presets` позволяет добавить панель с пресетами для быстрого выбора периода в режиме `range`, в том числе с собственным списком вариантов.
+- Локаль (`locale`) задаёт язык подписей и первый день недели, при отсутствии явно переданного значения используется язык браузера пользователя.
+- Figma: [`Calendar`](https://www.figma.com/file/jtGxAPvFJOMir7V0eQFukN/Snack-UI-Kit-1.1.0?node-id=41%3A27244&mode=design).
+
+### Example
 
 ```tsx
 import { Calendar } from '@snack-uikit/calendar';
 
-<Calendar
-  mode='date'
-  onChangeValue={(selectedDate: Date) => {
-    // do something
-  }}
-/>
-
-<Calendar
-  mode='range'
-  onChangeValue={(selectedRange: [Date, Date]) => {
-    // do something
-  }}
-/>
+function CalendarExample() {
+  return (
+    <>
+      {/* Выбор одной даты */}
+      <Calendar
+        mode='date'
+        onChangeValue={(selectedDate: Date) => {
+          console.log('Selected date:', selectedDate);
+        }}
+      />
+
+      {/* Выбор периода c пресетами */}
+      <Calendar
+        mode='range'
+        presets={{
+          enabled: true,
+          title: true,
+        }}
+        onChangeValue={(selectedRange) => {
+          console.log('Selected range:', selectedRange);
+        }}
+      />
+
+      {/* Выбор даты и времени с отображением секунд */}
+      <Calendar
+        mode='date-time'
+        showSeconds
+        onChangeValue={(selectedDateTime: Date) => {
+          console.log('Selected date and time:', selectedDateTime);
+        }}
+      />
+    </>
+  );
+}
+```
+
+## TimePicker
+
+### Description
+
+- `TimePicker` — компонент для точного выбора времени (часы, минуты и при необходимости секунды) без выбора календарной даты.
+- Поддерживает контролируемый и неконтролируемый режимы через пропы `value`, `defaultValue` и `onChangeValue`, а результирующее значение представлено объектом `TimeValue` (`{ hours, minutes, seconds }`).
+- Проп `today` позволяет подсветить «текущее» время (например, рабочее время или время на момент открытия) на основании переданной даты.
+- Компонент адаптируется под размеры (`size` — `s`, `m`, `l`) и может растягиваться по контейнеру через `fitToContainer`, а также поддерживает управление фокусом (`onFocusLeave`, `navigationStartRef`) для сложных форм и диалогов.
+- Figma: [`TimePicker`](https://www.figma.com/file/jtGxAPvFJOMir7V0eQFukN/Snack-UI-Kit-1.1.0?node-id=41%3A27244&mode=design).
+
+### Example
+
+```tsx
+import { TimePicker } from '@snack-uikit/calendar';
+
+function TimePickerExample() {
+  return (
+    <TimePicker
+      showSeconds
+      onChangeValue={value => {
+        if (!value) {
+          return;
+        }
+
+        const { hours, minutes, seconds } = value;
+        console.log(`Selected time: ${hours}:${minutes}:${seconds}`);
+      }}
+    />
+  );
+}
 ```
 
 [//]: DOCUMENTATION_SECTION_START

package/package.json

@@ -4,7 +4,7 @@
     "access": "public"
   },
   "title": "Calendar",
-  "version": "0.13.12",
+  "version": "0.13.13",
   "sideEffects": [
     "*.css",
     "*.woff",
@@ -36,11 +36,11 @@
   "license": "Apache-2.0",
   "scripts": {},
   "dependencies": {
-    "@snack-uikit/button": "0.19.16",
-    "@snack-uikit/divider": "3.2.10",
-    "@snack-uikit/icons": "0.27.4",
-    "@snack-uikit/list": "0.32.11",
-    "@snack-uikit/utils": "4.0.0",
+    "@snack-uikit/button": "0.19.17",
+    "@snack-uikit/divider": "3.2.11",
+    "@snack-uikit/icons": "0.27.5",
+    "@snack-uikit/list": "0.32.12",
+    "@snack-uikit/utils": "4.0.1",
     "classnames": "2.5.1",
     "uncontrollable": "8.0.4",
     "weekstart": "2.0.0"
@@ -48,5 +48,5 @@
   "peerDependencies": {
     "@snack-uikit/locale": "*"
   },
-  "gitHead": "78bb9c9dd3a49941fa39bde71d838e9bf036e65d"
+  "gitHead": "84371bbf91915f650a852df849cd71d416c5b7b2"
 }