@kalyx/core 1.0.0-rc.0 → 1.0.0-rc.2

package/CHANGELOG.md

@@ -0,0 +1,125 @@
+# @kalyx/core
+
+## 1.0.0-rc.2
+
+### Patch Changes
+
+- aadb512: Security: pin transitive `postcss` to `>=8.5.10` via `pnpm.overrides`.
+
+  Two `postcss` versions in `pnpm-lock.yaml` (`8.4.31` from a `postcss-load-config` chain and `8.5.9` from the `tsup` chain) were affected by [GHSA-qx2v-qp2m-jg93](https://osv.dev/GHSA-qx2v-qp2m-jg93) (CVSS 6.1 — improper newline handling that lets crafted input bypass quote escapes). Both are now resolved to `8.5.10`+. The OSV scanner workflow (which auto-creates issues #23 / #24 / #27) now reports zero advisories.
+
+- 21f3c1f: Resolve v1.0-rc release-blocking defects (P0):
+  - **`"use client"` directive** — bundle is now marked as a React Server Component client boundary via tsup banner. Next.js App Router consumers no longer have to wrap each import.
+  - **Stable `today()`/`now()` initialization** — `viewMonth`/`focusedDate` `useState` calls in `DatePicker`/`RangePicker`/`DateTimePicker` Roots now use lazy initializers, so the adapter isn't called on every render.
+  - **`@kalyx/core` version sync** — bumped from `1.0.0-rc.0` to `1.0.0-rc.1` to match `@kalyx/react`.
+  - **`@kalyx/core` package contents** — `LICENSE` and `CHANGELOG.md` are now included in the npm tarball (`files` field).
+  - **Form auto-submit blocked when calendar open** — pressing Enter inside `DatePicker.Input`/`RangePicker.Input`/`DateTimePicker.Input` while the popover is open no longer submits the surrounding `<form>`.
+  - **`aria-haspopup="dialog"` on Trigger** — completes the WAI-ARIA combobox/dialog pattern.
+  - **Disabled cells skipped during keyboard navigation** — Calendar arrow keys / PageUp/Down / Home / End now step over disabled days and stop only when no enabled day is reachable.
+
+- 3228533: P1 v1.0-rc API/a11y/docs improvements:
+  - **Popover focus-out close** — `usePopover` now closes the popover when focus leaves the floating layer and the reference element (Tab through). Matches the Radix/Ark dismissable layer pattern.
+  - **`name` prop + hidden form input** — `DatePicker.Input` accepts a `name` prop. When set, a hidden `<input type="hidden">` is rendered alongside the visible input so the value participates in native form submission and integrates with `react-hook-form` Controller-less flows.
+  - **IME composition handling** — `DatePicker.Input` now defers parsing during IME composition (`compositionstart` / `compositionend`). Previously, partial Korean / Japanese / Chinese input was repeatedly re-parsed and the user's text disappeared.
+  - **README parity** — Korean README now has the "Styling with Tailwind CSS" and "Using data attributes" sections that were missing. Version table and bundle-size claim corrected to `v1.0.0-rc.1` / `11.57 KB`.
+  - **Package metadata** — `peerDependenciesMeta`, `engines.node`, and `publishConfig.provenance` added to both `@kalyx/react` and `@kalyx/core`.
+  - **`@kalyx/react` description** — corrected from "under 10 KB gzipped" (false claim) to "≤12 KB gzipped".
+
+- b6129ed: P2 polish for v1.0-rc:
+  - **Calendar grid `aria-rowindex` / `aria-colindex` / `aria-rowcount` / `aria-colcount`** — `DatePicker.Calendar` and `RangePicker.Calendar` now expose grid coordinates so screenreaders announce position ("row 3 of 6, column 4 of 7") during keyboard navigation.
+  - **`displayName` on all `forwardRef` components** — `DatePicker.Input`, `DatePicker.Trigger`, `RangePicker.Input`, `TimePicker.Input`, `DateTimePicker.Input` now render with their public dot-notation name in React DevTools.
+  - **JSDoc on `DatePicker.Input` and `DatePicker.Trigger`** — public API surface for the most-used components has explanatory docstrings.
+  - **`addYears` leap-day regression tests** — locked the date-fns clamp behavior (2024-02-29 + 1y → 2025-02-28, not March 1).
+  - **DST fall-back ambiguous-hour regression test** — captures the current behavior of `setTimeInTimezone` for 2026-11-01 01:30 America/New_York so silent drift surfaces as a test failure.
+  - **Test count claim corrected** — root and core `CLAUDE.md` previously claimed "1,000+ unit tests"; actual count is ~140 in core, 374 across the workspace.
+
+## 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.
+
+## 0.4.0
+
+### Minor Changes
+
+- 104bbf2: feat: full `displayTimezone` support across all pickers (v0.4)
+
+  All four pickers (`DatePicker`, `RangePicker`, `TimePicker`, `DateTimePicker`) and their corresponding hooks (`useDatePicker`, `useRangePicker`, `useTimePicker`) now accept a `displayTimezone` prop/option.
+
+  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)`
+
+  No breaking changes — omitting `displayTimezone` keeps the existing UTC semantics.
+
+### Patch Changes
+
+- b3a8897: perf: mark `@kalyx/core` as `sideEffects: false` so downstream bundlers can tree-shake unused exports. Safe because the package is purely functional (no module-level side effects).
+
+## 0.3.0
+
+### 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
+  - Memoize disabledRules to prevent unnecessary context re-creation
+  - Add try-catch around adapter.format() for error resilience
+  - Cancel requestAnimationFrame on unmount in listbox navigation
+  - Remove unused parseInputValue format parameter
+  - Boost test coverage: 87% → 92%
+  - Fix bundle size measurement to report both ESM and CJS
+
+## 0.2.2
+
+### Patch Changes
+
+- ebf4fd7: Add repository/homepage/bugs/keywords metadata to @kalyx/core for npm provenance validation
+
+## 0.2.1
+
+### Patch Changes
+
+- fe0e63e: Add full documentation site (Docusaurus, EN/KO), rewrite READMEs for npm, fix CI pnpm version to 10
+
+## 0.2.0
+
+### Minor Changes
+
+- 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
+  - DateTimePicker: combined date+time via context bridging (reuses existing components)
+  - useDatePicker, useRangePicker, useTimePicker hooks for custom UIs
+  - WAI-ARIA compliant: grid, dialog, combobox, listbox, radiogroup patterns
+  - SSR safe: verified with Next.js 15 App Router
+  - Zero CSS: style with classNames prop and data-\* attributes
+  - ISO 8601 UTC strings only (no native Date objects)
+  - Bundle: 7.71KB gzip (target ≤12KB)
+  - 185 unit/integration tests passing

package/README.md

@@ -73,6 +73,36 @@ import {
 } from '@kalyx/core';
 ```
 
+### Timezone helpers
+
+DST-aware timezone utilities used by every picker when `displayTimezone` is set.
+
+```ts
+import {
+  formatInTimezone,
+  startOfDayInTimezone,
+  isSameDayInTimezone,
+  todayInTimezone,
+  getTimezoneOffsetMinutes,
+  civilMidnightFromUtcDay,
+  getTimeInTimezone,
+  setTimeInTimezone,
+} from '@kalyx/core';
+```
+
+### Accessibility labels
+
+Default ARIA labels (English). Override via the `labels` prop on any picker Root.
+
+```ts
+import {
+  DEFAULT_DATEPICKER_LABELS,
+  DEFAULT_RANGEPICKER_LABELS,
+  DEFAULT_TIMEPICKER_LABELS,
+  DEFAULT_DATETIMEPICKER_LABELS,
+} from '@kalyx/core';
+```
+
 ## Principles
 
 - **All dates are ISO 8601 UTC strings** — never `Date` objects.

package/dist/index.cjs

@@ -82,9 +82,7 @@ function getCachedPartsFormatter(timeZone) {
 }
 function partsInTimezone(utc, timeZone) {
   const dtf = getCachedPartsFormatter(timeZone);
-  const parts = Object.fromEntries(
-    dtf.formatToParts(utc).map((p) => [p.type, p.value])
-  );
+  const parts = Object.fromEntries(dtf.formatToParts(utc).map((p) => [p.type, p.value]));
   return {
     year: Number(parts.year),
     month: Number(parts.month),
@@ -135,14 +133,9 @@ function todayInTimezone(timeZone) {
 }
 function civilMidnightFromUtcDay(gridUtcIso, timeZone) {
   const utc = (0, import_date_fns.parseISO)(gridUtcIso);
-  const probe = new Date(Date.UTC(
-    utc.getUTCFullYear(),
-    utc.getUTCMonth(),
-    utc.getUTCDate(),
-    12,
-    0,
-    0
-  )).toISOString();
+  const probe = new Date(
+    Date.UTC(utc.getUTCFullYear(), utc.getUTCMonth(), utc.getUTCDate(), 12, 0, 0)
+  ).toISOString();
   return startOfDayInTimezone(probe, timeZone);
 }
 function getTimeInTimezone(iso, timeZone) {
@@ -154,7 +147,14 @@ function setTimeInTimezone(iso, partial, timeZone) {
   const targetHours = partial.hours ?? p.hour;
   const targetMinutes = partial.minutes ?? p.minute;
   const targetSeconds = partial.seconds ?? p.second;
-  const civilEpoch = Date.UTC(p.year, p.month - 1, p.day, targetHours, targetMinutes, targetSeconds);
+  const civilEpoch = Date.UTC(
+    p.year,
+    p.month - 1,
+    p.day,
+    targetHours,
+    targetMinutes,
+    targetSeconds
+  );
   const probe1 = new Date(civilEpoch).toISOString();
   const offset1 = getTimezoneOffsetMinutes(probe1, timeZone);
   const realEpoch1 = civilEpoch - offset1 * 6e4;
@@ -193,15 +193,9 @@ function utcStartOfWeek(d, weekStartsOn) {
 }
 function utcEndOfWeek(d, weekStartsOn) {
   const start = utcStartOfWeek(d, weekStartsOn);
-  return new Date(Date.UTC(
-    start.getUTCFullYear(),
-    start.getUTCMonth(),
-    start.getUTCDate() + 6,
-    23,
-    59,
-    59,
-    999
-  ));
+  return new Date(
+    Date.UTC(start.getUTCFullYear(), start.getUTCMonth(), start.getUTCDate() + 6, 23, 59, 59, 999)
+  );
 }
 var DateFnsAdapter = {
   parse(value) {

package/dist/index.js

@@ -32,9 +32,7 @@ function getCachedPartsFormatter(timeZone) {
 }
 function partsInTimezone(utc, timeZone) {
   const dtf = getCachedPartsFormatter(timeZone);
-  const parts = Object.fromEntries(
-    dtf.formatToParts(utc).map((p) => [p.type, p.value])
-  );
+  const parts = Object.fromEntries(dtf.formatToParts(utc).map((p) => [p.type, p.value]));
   return {
     year: Number(parts.year),
     month: Number(parts.month),
@@ -85,14 +83,9 @@ function todayInTimezone(timeZone) {
 }
 function civilMidnightFromUtcDay(gridUtcIso, timeZone) {
   const utc = parseISO(gridUtcIso);
-  const probe = new Date(Date.UTC(
-    utc.getUTCFullYear(),
-    utc.getUTCMonth(),
-    utc.getUTCDate(),
-    12,
-    0,
-    0
-  )).toISOString();
+  const probe = new Date(
+    Date.UTC(utc.getUTCFullYear(), utc.getUTCMonth(), utc.getUTCDate(), 12, 0, 0)
+  ).toISOString();
   return startOfDayInTimezone(probe, timeZone);
 }
 function getTimeInTimezone(iso, timeZone) {
@@ -104,7 +97,14 @@ function setTimeInTimezone(iso, partial, timeZone) {
   const targetHours = partial.hours ?? p.hour;
   const targetMinutes = partial.minutes ?? p.minute;
   const targetSeconds = partial.seconds ?? p.second;
-  const civilEpoch = Date.UTC(p.year, p.month - 1, p.day, targetHours, targetMinutes, targetSeconds);
+  const civilEpoch = Date.UTC(
+    p.year,
+    p.month - 1,
+    p.day,
+    targetHours,
+    targetMinutes,
+    targetSeconds
+  );
   const probe1 = new Date(civilEpoch).toISOString();
   const offset1 = getTimezoneOffsetMinutes(probe1, timeZone);
   const realEpoch1 = civilEpoch - offset1 * 6e4;
@@ -143,15 +143,9 @@ function utcStartOfWeek(d, weekStartsOn) {
 }
 function utcEndOfWeek(d, weekStartsOn) {
   const start = utcStartOfWeek(d, weekStartsOn);
-  return new Date(Date.UTC(
-    start.getUTCFullYear(),
-    start.getUTCMonth(),
-    start.getUTCDate() + 6,
-    23,
-    59,
-    59,
-    999
-  ));
+  return new Date(
+    Date.UTC(start.getUTCFullYear(), start.getUTCMonth(), start.getUTCDate() + 6, 23, 59, 59, 999)
+  );
 }
 var DateFnsAdapter = {
   parse(value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kalyx/core",
-  "version": "1.0.0-rc.0",
+  "version": "1.0.0-rc.2",
   "description": "Kalyx core — platform-agnostic date logic, IANA timezone helpers, and the DateAdapter contract used by @kalyx/react",
   "license": "MIT",
   "author": "jiji-hoon96",
@@ -42,12 +42,21 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md",
+    "LICENSE"
   ],
   "dependencies": {
     "date-fns": "^4.0.0",
     "date-fns-tz": "^3.0.0"
   },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",
     "typecheck": "tsc --noEmit",