@kalyx/react 0.4.0 → 1.0.0-rc.1

package/CHANGELOG.md

@@ -1,5 +1,137 @@
 # @kalyx/react
 
+## 1.0.0-rc.1
+
+### Patch Changes
+
+- 3afb15b: Fix popover styling regression that broke documentation live previews.
+  - `DatePicker.Popover` and `RangePicker.Popover` now merge user-provided `style` props _under_ Floating UI's positioning instead of being overwritten by it. Previously, passing `style={{...}}` to a Popover stripped away `position: absolute`, `top`, `left`, and `transform`, causing the popover to render as a static block at full container width.
+  - The popover is now hidden until Floating UI computes its position, eliminating an unpositioned first-frame flash on every open.
+  - The shared `usePopover` hook also wires the floating element's reference synchronously in the ref callback, so positioning is resolved before paint in most cases.
+
+## 1.0.0-rc.0
+
+### Major Changes
+
+- ca7180e: chore: v1.0 milestone — API freeze.
+
+  Kalyx v1.0 declares the public API stable. This is a milestone release bundling the v0.5 surface additions (MonthPicker, YearPicker, WeekPicker, DatePicker.Presets, `onOpenChange`/`onCalendarNavigate` event callbacks) with an explicit commitment to semantic versioning going forward.
+
+  ### What v1.0 commits to
+  - **Public API surface** — exports from `@kalyx/react` and `@kalyx/core` listed in their `index.ts` files. Any breaking change requires a major bump.
+  - **Compositional structure** — Root + subcomponent names (`DatePicker.Input`, `DatePicker.Calendar`, …) are stable. Removal or renaming requires a major bump.
+  - **Value semantics** — ISO 8601 UTC strings for single dates, `DateRange` `{start, end}` for ranges. `displayTimezone` behavior (civil-midnight-in-tz for date selection) is stable.
+  - **Accessibility contracts** — role/aria-\* attributes emitted by each component are stable.
+
+  ### What v1.0 does NOT freeze
+  - Internal implementation details (non-exported functions, component file layout).
+  - CSS class name strings on elements — no classes are applied by default; only when a consumer passes them via `classNames` props.
+  - Error message text.
+  - Peer dependency version ranges (may expand to cover new React majors).
+
+  ### Breaking changes vs 0.4.x
+
+  None. v1.0 is API-compatible with 0.4.x — existing code continues to work. The major bump communicates stability commitment, not breakage.
+
+### Minor Changes
+
+- 3db8444: feat: add `DatePicker.Presets` and `DatePicker.Preset` for single-date quick selection.
+
+  Mirrors the existing `RangePicker.Presets` API. Pass a predefined `value` key (`today`, `tomorrow`, `yesterday`, `startOfMonth`, `endOfMonth`, `startOfYear`) or a direct ISO via `date`.
+
+  ```tsx
+  <DatePicker value={date} onChange={setDate}>
+    <DatePicker.Input />
+    <DatePicker.Popover>
+      <DatePicker.Presets>
+        <DatePicker.Preset value="today">Today</DatePicker.Preset>
+        <DatePicker.Preset value="tomorrow">Tomorrow</DatePicker.Preset>
+        <DatePicker.Preset date="2026-12-25T00:00:00.000Z">Christmas</DatePicker.Preset>
+      </DatePicker.Presets>
+      <DatePicker.Calendar />
+    </DatePicker.Popover>
+  </DatePicker>
+  ```
+
+  - Active preset is marked `aria-selected="true"` when its resolved date matches the current value (timezone-aware).
+  - Clicking a preset commits and closes the popover.
+  - `displayTimezone` is honored when resolving "today"-relative presets.
+
+- 56e1ce9: feat: add `onOpenChange` and `onCalendarNavigate` callbacks on `DatePicker`, `RangePicker`, and `DateTimePicker` Root components.
+  - `onOpenChange(isOpen: boolean)` fires whenever the popover opens or closes (regardless of trigger — click, keyboard, outside click, selection).
+  - `onCalendarNavigate(viewMonth: ISODateString)` fires when the calendar view moves to a different month. The emitted value is the first day of the newly-visible month in UTC.
+
+  Neither callback fires on initial mount. `TimePicker` does not expose these callbacks since it has no popover or calendar.
+
+- 6fc7c59: feat: add `MonthPicker` — a headless month selector.
+
+  `MonthPicker` stores the selected month as the first day of that month in UTC-ISO form (e.g., `"2026-04-01T00:00:00.000Z"`). It reuses `DatePicker` infrastructure (Input, Trigger, Popover), so the only new primitive is `MonthPicker.Grid`, a 12-month commit grid with year navigation.
+
+  ```tsx
+  <MonthPicker value={month} onChange={setMonth}>
+    <MonthPicker.Input placeholder="Pick a month" />
+    <MonthPicker.Popover>
+      <MonthPicker.Grid />
+    </MonthPicker.Popover>
+  </MonthPicker>
+  ```
+
+  - Default `displayFormat` is `"yyyy-MM"`.
+  - `displayTimezone` is supported (commits map to civil midnight of month-start in the target zone).
+  - Month selection highlighting is timezone-aware — the grid reflects the month of the current value even when stored in zone-adjusted UTC form.
+  - Primary UX is click-to-select; full `yyyy-MM-dd` typed input still works via the inherited Input behavior.
+
+- 6fdf8fe: feat: add `WeekPicker` — a headless week selector.
+
+  `WeekPicker` stores the selected week as a `DateRange` covering all seven days (based on `weekStartsOn`). Unlike `RangePicker`, a single click on any day selects the entire week containing that day.
+
+  ```tsx
+  <WeekPicker value={week} onChange={setWeek} weekStartsOn={1}>
+    <WeekPicker.Input part="start" />
+    <WeekPicker.Input part="end" />
+    <WeekPicker.Popover>
+      <WeekPicker.Calendar />
+    </WeekPicker.Popover>
+  </WeekPicker>
+  ```
+
+  - Reuses `RangePicker` Root / Input / Popover; only `WeekPicker.Calendar` is new.
+  - `weekStartsOn` (0=Sunday, 1=Monday) controls which seven days constitute a week.
+  - Enter / Space on the focused day commits the full week containing it.
+  - `displayTimezone`, `disabled` rules, and all other RangePicker props are supported.
+
+- 6fc7c59: feat: add `YearPicker` — a headless year selector.
+
+  `YearPicker` stores the selected year as Jan 1 of that year in UTC-ISO form (e.g., `"2026-01-01T00:00:00.000Z"`). It reuses `DatePicker` infrastructure (Input, Trigger, Popover) and exposes `YearPicker.Grid`, a 12-year decade commit grid with decade navigation.
+
+  ```tsx
+  <YearPicker value={year} onChange={setYear}>
+    <YearPicker.Input placeholder="Pick a year" />
+    <YearPicker.Popover>
+      <YearPicker.Grid />
+    </YearPicker.Popover>
+  </YearPicker>
+  ```
+
+  - Default `displayFormat` is `"yyyy"`.
+  - `displayTimezone` is supported with timezone-aware year highlighting.
+  - Primary UX is click-to-select; full `yyyy-MM-dd` typed input still works via the inherited Input behavior.
+
+### Patch Changes
+
+- 1ca818c: fix(react): prevent WeekPicker from mutating RangePicker.Calendar
+
+  `WeekPicker` previously called `Object.assign(RangePickerRoot, { ..., Calendar: WeekPickerCalendar })`, which mutates the shared `RangePickerRoot` function object. Because `RangePicker.Calendar` is attached to the same object (via the earlier `Object.assign` in `RangePicker/index.ts`), importing `WeekPicker` would overwrite `RangePicker.Calendar` with `WeekPickerCalendar`.
+
+  Users of `RangePicker` would then see week-selection behavior (single click commits a full week and closes the popover) instead of the documented two-click range flow — even without importing `WeekPicker` directly, because both pickers share the module graph.
+
+  Added an internal `WeekPickerRoot` wrapper that the `Object.assign` target now uses, preserving `RangePickerRoot.Calendar` intact.
+
+  Caught by the `RangePicker › select range in start-date -> end-date order` Playwright test; all existing behavior is restored.
+
+- Updated dependencies [ca7180e]
+  - @kalyx/core@1.0.0-rc.0
+
 ## 0.4.0
 
 ### Minor Changes
@@ -11,7 +143,6 @@
   When set, the value stored via `onChange` is the **civil midnight of the selected day in the target timezone** (in UTC-ISO form), eliminating the classic "day off by one" bug that affects picker libraries bound to `new Date()`. Input formatting, calendar highlighting, and the time-of-day controls all follow the display timezone — including DST-aware offsets for zones like `America/New_York` and `Europe/London`.
 
   `DateFnsAdapter` now honors the `timezone` argument on `format`, `isSameDay`, `startOfDay`, and `today` (previously declared-but-ignored). Core also exposes new helpers:
-
   - `civilMidnightFromUtcDay(iso, tz)`
   - `getTimeInTimezone(iso, tz)`
   - `setTimeInTimezone(iso, partial, tz)`
@@ -29,7 +160,6 @@
 ### Minor Changes
 
 - 669391b: Improve code quality, performance, and stability
-
   - Enforce UTC timezone suffix in ISO regex
   - Extract shared usePopover and useListboxNavigation hooks
   - Add Intl.DateTimeFormat caching for locale/timezone utilities
@@ -68,7 +198,6 @@
 - e9bb9e8: Initial release of Kalyx — headless, SSR-safe React DatePicker library.
 
   Features:
-
   - DatePicker: single date selection with Calendar, Input, Trigger, Popover
   - RangePicker: date range selection with auto-swap and hover preview
   - TimePicker: 12h/24h mode, minute step, HourList/MinuteList/AmPmToggle

package/README.md

@@ -3,7 +3,7 @@
 > The headless React DatePicker, finally complete. Zero CSS · SSR-safe · under 12 KB gzip.
 
 [![npm](https://img.shields.io/npm/v/@kalyx/react?color=5b4fe1)](https://www.npmjs.com/package/@kalyx/react)
-[![Bundle](https://img.shields.io/badge/gzip-9.2KB-brightgreen)](https://kalyx-docs.vercel.app/docs/api/react#bundle-size)
+[![Bundle](https://img.shields.io/badge/gzip-11.36KB-brightgreen)](https://kalyx-docs.vercel.app/docs/api/react#bundle-size)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)](https://www.typescriptlang.org/)
 [![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/jiji-hoon96/kalyx/blob/main/LICENSE)
 
@@ -51,6 +51,9 @@ import {
   RangePicker,       // date range + presets
   TimePicker,        // hour + minute (+ seconds)
   DateTimePicker,    // date + time combined
+  MonthPicker,       // month-only selection
+  YearPicker,        // year-only selection
+  WeekPicker,        // full-week range selection
   useDatePicker,     // hook for custom UIs
   useRangePicker,
   useTimePicker,
@@ -90,6 +93,8 @@ Full recipes: [Tailwind](https://kalyx-docs.vercel.app/docs/recipes/tailwind), [
 - [Quick Start](https://kalyx-docs.vercel.app/docs/getting-started/quick-start)
 - [Components](https://kalyx-docs.vercel.app/docs/components/datepicker)
 - [Hooks](https://kalyx-docs.vercel.app/docs/hooks/use-date-picker)
+- [Testing](https://kalyx-docs.vercel.app/docs/recipes/testing)
+- [Troubleshooting](https://kalyx-docs.vercel.app/docs/troubleshooting)
 - [Migration from react-datepicker / react-day-picker / React Aria](https://kalyx-docs.vercel.app/docs/migration)
 
 ## License