@kalyx/core 1.0.0-rc.11 → 1.0.0-rc.13

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @kalyx/core
 
+## 1.0.0-rc.13
+
+### Major Changes
+
+- 5b6c37f: Extract `@kalyx/adapter-date-fns` and make `@kalyx/core` neutral
+
+  Step 1 + 2 of the four-step adapter-extraction plan (see `.claude/skills/adapter-extraction.md`). After this change, `@kalyx/core` no longer depends on `date-fns` or `date-fns-tz`; it ships only the platform-agnostic date logic (`getCalendarDays`, `isDateDisabled`, timezone helpers, labels, the `DateAdapter` contract). The DateFnsAdapter implementation now lives in its own publishable package so dayjs / luxon / Temporal adapters can be added later without forcing every Kalyx user to bundle two date libraries.
+
+  ### What changed
+  - **`@kalyx/core`** — `DateFnsAdapter` is no longer exported and `date-fns` / `date-fns-tz` are no longer listed as dependencies. `utils/timezone.ts` was the lone leak and uses native `new Date(string)` now (every caller already routes through `normalizeISO` or `DateAdapter.parse`, so the input subset is fully spec-defined).
+  - **`@kalyx/adapter-date-fns`** — new package with the full `DateFnsAdapter` implementation moved verbatim. Same UTC semantics, same timezone-aware paths, same 35 adapter tests.
+  - **`@kalyx/react`** — imports `DateFnsAdapter` from `@kalyx/adapter-date-fns` now. The default adapter is still wired up automatically — anyone using `import { DatePicker } from '@kalyx/react'` keeps the previous behaviour with zero changes. The adapter package is a direct dependency so consumers installing just `@kalyx/react` continue to get a working default.
+
+  ### Migration
+
+  If you imported `DateFnsAdapter` directly from `@kalyx/core`:
+
+  ```diff
+  - import { DateFnsAdapter } from '@kalyx/core';
+  + import { DateFnsAdapter } from '@kalyx/adapter-date-fns';
+  ```
+
+  `@kalyx/react` consumers don't need to change anything — the adapter is still re-exported from `@kalyx/react`.
+
+  ### Next (separate PR)
+
+  The `/headless` entry point (`@kalyx/react/headless`) that lets dayjs/luxon users tree-shake date-fns out is a follow-up. The component Roots still default to the date-fns adapter inline; the entry split requires moving that fallback out of each Root and into the entry boundary.
+
+## 1.0.0-rc.12
+
+### Patch Changes
+
+- 0556886: fix(core): validate inputs to `to12Hour` and `to24Hour`
+
+  `to12Hour(hours24)` and `to24Hour(hours12, period)` are public exports from `@kalyx/core` but had no input validation. The previous silent arithmetic mapped invalid inputs onto plausible-looking but wrong outputs and hid caller bugs:
+  - `to12Hour(24)` returned `{ hours12: 12, period: 'PM' }` (because `24 % 12 = 0` → mapped to 12)
+  - `to12Hour(-1)` returned `{ hours12: -1, period: 'AM' }`
+  - `to24Hour(13, 'PM')` returned `25`
+  - `to24Hour(0, 'AM')` returned `0` (but `0` is not a valid 12-hour clock value — midnight is `12 AM`)
+
+  Both functions now throw `RangeError` with a clear message when the input is outside its valid integer range (`[0, 23]` for `to12Hour`, `[1, 12]` for `to24Hour`). `Number.isInteger` guards non-integers and `NaN`. No `@kalyx/react` callers ever passed invalid values, so the internal contracts are unchanged; only direct `@kalyx/core` users who relied on the silent-wrong behaviour see the new exception.
+
 ## 1.0.0-rc.11
 
 ### Minor Changes

package/dist/index.cjs

@@ -24,7 +24,6 @@ __export(index_exports, {
   DEFAULT_DATETIMEPICKER_LABELS: () => DEFAULT_DATETIMEPICKER_LABELS,
   DEFAULT_RANGEPICKER_LABELS: () => DEFAULT_RANGEPICKER_LABELS,
   DEFAULT_TIMEPICKER_LABELS: () => DEFAULT_TIMEPICKER_LABELS,
-  DateFnsAdapter: () => DateFnsAdapter,
   civilMidnightFromUtcDay: () => civilMidnightFromUtcDay,
   formatFullDate: () => formatFullDate,
   formatInTimezone: () => formatInTimezone,
@@ -57,249 +56,6 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/adapters/date-fns.ts
-var import_date_fns2 = require("date-fns");
-
-// src/utils/timezone.ts
-var import_date_fns = require("date-fns");
-var formatterCache = /* @__PURE__ */ new Map();
-function getCachedPartsFormatter(timeZone) {
-  const key = `parts:${timeZone}`;
-  let fmt = formatterCache.get(key);
-  if (!fmt) {
-    fmt = new Intl.DateTimeFormat("en-US", {
-      timeZone,
-      year: "numeric",
-      month: "2-digit",
-      day: "2-digit",
-      hour: "2-digit",
-      minute: "2-digit",
-      second: "2-digit",
-      hourCycle: "h23"
-    });
-    formatterCache.set(key, fmt);
-  }
-  return fmt;
-}
-function partsInTimezone(utc, timeZone) {
-  const dtf = getCachedPartsFormatter(timeZone);
-  const parts = Object.fromEntries(dtf.formatToParts(utc).map((p) => [p.type, p.value]));
-  return {
-    year: Number(parts.year),
-    month: Number(parts.month),
-    day: Number(parts.day),
-    // Some locales/engines return '24' instead of '0' at midnight
-    hour: parts.hour === "24" ? 0 : Number(parts.hour),
-    minute: Number(parts.minute),
-    second: Number(parts.second)
-  };
-}
-function formatInTimezone(iso, formatStr, timeZone) {
-  const p = partsInTimezone((0, import_date_fns.parseISO)(iso), timeZone);
-  const tokens = {
-    yyyy: String(p.year),
-    MM: String(p.month).padStart(2, "0"),
-    dd: String(p.day).padStart(2, "0"),
-    HH: String(p.hour).padStart(2, "0"),
-    mm: String(p.minute).padStart(2, "0"),
-    ss: String(p.second).padStart(2, "0")
-  };
-  let result = formatStr;
-  for (const [token, value] of Object.entries(tokens).sort((a, b) => b[0].length - a[0].length)) {
-    result = result.split(token).join(value);
-  }
-  return result;
-}
-function getTimezoneOffsetMinutes(iso, timeZone) {
-  const utc = (0, import_date_fns.parseISO)(iso);
-  const p = partsInTimezone(utc, timeZone);
-  const asUtcEpoch = Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second);
-  return Math.round((asUtcEpoch - utc.getTime()) / 6e4);
-}
-function startOfDayInTimezone(iso, timeZone) {
-  const utc = (0, import_date_fns.parseISO)(iso);
-  const p = partsInTimezone(utc, timeZone);
-  const civilMidnightUtc = Date.UTC(p.year, p.month - 1, p.day, 0, 0, 0);
-  const midnightProbe = new Date(civilMidnightUtc).toISOString();
-  const offsetMinutes = getTimezoneOffsetMinutes(midnightProbe, timeZone);
-  return new Date(civilMidnightUtc - offsetMinutes * 6e4).toISOString();
-}
-function isSameDayInTimezone(a, b, timeZone) {
-  const pa = partsInTimezone((0, import_date_fns.parseISO)(a), timeZone);
-  const pb = partsInTimezone((0, import_date_fns.parseISO)(b), timeZone);
-  return pa.year === pb.year && pa.month === pb.month && pa.day === pb.day;
-}
-function todayInTimezone(timeZone) {
-  return startOfDayInTimezone((/* @__PURE__ */ new Date()).toISOString(), 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();
-  return startOfDayInTimezone(probe, timeZone);
-}
-function getTimeInTimezone(iso, timeZone) {
-  const p = partsInTimezone((0, import_date_fns.parseISO)(iso), timeZone);
-  return { hours: p.hour, minutes: p.minute, seconds: p.second };
-}
-function setTimeInTimezone(iso, partial, timeZone) {
-  const p = partsInTimezone((0, import_date_fns.parseISO)(iso), 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 probe1 = new Date(civilEpoch).toISOString();
-  const offset1 = getTimezoneOffsetMinutes(probe1, timeZone);
-  const realEpoch1 = civilEpoch - offset1 * 6e4;
-  const probe2 = new Date(realEpoch1).toISOString();
-  const offset2 = getTimezoneOffsetMinutes(probe2, timeZone);
-  const realEpoch2 = civilEpoch - offset2 * 6e4;
-  return new Date(realEpoch2).toISOString();
-}
-
-// src/adapters/date-fns.ts
-function toDate(iso) {
-  return (0, import_date_fns2.parseISO)(iso);
-}
-function toISO(date) {
-  return date.toISOString();
-}
-function normalize(value) {
-  if (/^\d{4}-\d{2}-\d{2}$/.test(value)) {
-    return `${value}T00:00:00.000Z`;
-  }
-  return value;
-}
-function utcStartOfDay(d) {
-  return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
-}
-function utcStartOfMonth(d) {
-  return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), 1));
-}
-function utcEndOfMonth(d) {
-  return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth() + 1, 0, 23, 59, 59, 999));
-}
-function utcStartOfWeek(d, weekStartsOn) {
-  const day = d.getUTCDay();
-  const diff = (day - weekStartsOn + 7) % 7;
-  return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate() - diff));
-}
-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)
-  );
-}
-var DateFnsAdapter = {
-  parse(value) {
-    if (!value) return "";
-    return normalize(value);
-  },
-  format(iso, formatStr, timezone) {
-    if (timezone) {
-      return formatInTimezone(iso, formatStr, timezone);
-    }
-    const d = toDate(iso);
-    const tokens = {
-      yyyy: String(d.getUTCFullYear()),
-      MM: String(d.getUTCMonth() + 1).padStart(2, "0"),
-      dd: String(d.getUTCDate()).padStart(2, "0"),
-      HH: String(d.getUTCHours()).padStart(2, "0"),
-      mm: String(d.getUTCMinutes()).padStart(2, "0"),
-      ss: String(d.getUTCSeconds()).padStart(2, "0"),
-      M: String(d.getUTCMonth() + 1),
-      d: String(d.getUTCDate())
-    };
-    let result = formatStr;
-    for (const [token, value] of Object.entries(tokens).sort((a, b) => b[0].length - a[0].length)) {
-      result = result.split(token).join(value);
-    }
-    return result;
-  },
-  addDays(iso, n) {
-    return toISO((0, import_date_fns2.addDays)(toDate(iso), n));
-  },
-  addMonths(iso, n) {
-    return toISO((0, import_date_fns2.addMonths)(toDate(iso), n));
-  },
-  addYears(iso, n) {
-    return toISO((0, import_date_fns2.addYears)(toDate(iso), n));
-  },
-  isBefore(a, b) {
-    return (0, import_date_fns2.isBefore)(toDate(a), toDate(b));
-  },
-  isAfter(a, b) {
-    return (0, import_date_fns2.isAfter)(toDate(a), toDate(b));
-  },
-  isSameDay(a, b, timezone) {
-    if (!a || !b) return false;
-    if (timezone) {
-      return isSameDayInTimezone(a, b, timezone);
-    }
-    const da = toDate(a);
-    const db = toDate(b);
-    return da.getUTCFullYear() === db.getUTCFullYear() && da.getUTCMonth() === db.getUTCMonth() && da.getUTCDate() === db.getUTCDate();
-  },
-  isSameMonth(a, b) {
-    const da = toDate(a);
-    const db = toDate(b);
-    return da.getUTCFullYear() === db.getUTCFullYear() && da.getUTCMonth() === db.getUTCMonth();
-  },
-  startOfDay(iso, timezone) {
-    if (timezone) {
-      return startOfDayInTimezone(iso, timezone);
-    }
-    return toISO(utcStartOfDay(toDate(iso)));
-  },
-  startOfMonth(iso) {
-    return toISO(utcStartOfMonth(toDate(iso)));
-  },
-  endOfMonth(iso) {
-    return toISO(utcEndOfMonth(toDate(iso)));
-  },
-  startOfWeek(iso, weekStartsOn = 0) {
-    return toISO(utcStartOfWeek(toDate(iso), weekStartsOn));
-  },
-  endOfWeek(iso, weekStartsOn = 0) {
-    return toISO(utcEndOfWeek(toDate(iso), weekStartsOn));
-  },
-  now() {
-    return (/* @__PURE__ */ new Date()).toISOString();
-  },
-  today(timezone) {
-    if (timezone) {
-      return todayInTimezone(timezone);
-    }
-    return toISO(utcStartOfDay(/* @__PURE__ */ new Date()));
-  },
-  isValid(value) {
-    if (!value) return false;
-    const normalized = normalize(value);
-    const date = (0, import_date_fns2.parseISO)(normalized);
-    return (0, import_date_fns2.isValid)(date);
-  },
-  getYear(iso) {
-    return toDate(iso).getUTCFullYear();
-  },
-  getMonth(iso) {
-    return toDate(iso).getUTCMonth();
-  },
-  getDate(iso) {
-    return toDate(iso).getUTCDate();
-  },
-  getDay(iso) {
-    return toDate(iso).getUTCDay();
-  }
-};
-
 // src/utils/calendar.ts
 function getCalendarDays(monthISO, adapter, options = {}) {
   const {
@@ -477,12 +233,18 @@ function formatTimeString(time, withSeconds = false) {
   return `${hh}:${mm}`;
 }
 function to12Hour(hours24) {
+  if (!Number.isInteger(hours24) || hours24 < 0 || hours24 > 23) {
+    throw new RangeError(`[to12Hour] hours24 must be an integer in [0, 23], got ${hours24}`);
+  }
   const period = hours24 >= 12 ? "PM" : "AM";
   let hours12 = hours24 % 12;
   if (hours12 === 0) hours12 = 12;
   return { hours12, period };
 }
 function to24Hour(hours12, period) {
+  if (!Number.isInteger(hours12) || hours12 < 1 || hours12 > 12) {
+    throw new RangeError(`[to24Hour] hours12 must be an integer in [1, 12], got ${hours12}`);
+  }
   if (period === "AM") {
     return hours12 === 12 ? 0 : hours12;
   }
@@ -522,13 +284,13 @@ function formatTimeFromISO(iso, format) {
 }
 
 // src/utils/locale.ts
-var formatterCache2 = /* @__PURE__ */ new Map();
+var formatterCache = /* @__PURE__ */ new Map();
 function getCachedFormatter(locale, options) {
   const key = `${locale}:${JSON.stringify(options)}`;
-  let fmt = formatterCache2.get(key);
+  let fmt = formatterCache.get(key);
   if (!fmt) {
     fmt = new Intl.DateTimeFormat(locale, options);
-    formatterCache2.set(key, fmt);
+    formatterCache.set(key, fmt);
   }
   return fmt;
 }
@@ -573,6 +335,110 @@ function formatFullDate(iso, locale = "en-US") {
   }).format(date);
 }
 
+// src/utils/timezone.ts
+var formatterCache2 = /* @__PURE__ */ new Map();
+function getCachedPartsFormatter(timeZone) {
+  const key = `parts:${timeZone}`;
+  let fmt = formatterCache2.get(key);
+  if (!fmt) {
+    fmt = new Intl.DateTimeFormat("en-US", {
+      timeZone,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit",
+      hourCycle: "h23"
+    });
+    formatterCache2.set(key, fmt);
+  }
+  return fmt;
+}
+function partsInTimezone(utc, timeZone) {
+  const dtf = getCachedPartsFormatter(timeZone);
+  const parts = Object.fromEntries(dtf.formatToParts(utc).map((p) => [p.type, p.value]));
+  return {
+    year: Number(parts.year),
+    month: Number(parts.month),
+    day: Number(parts.day),
+    // Some locales/engines return '24' instead of '0' at midnight
+    hour: parts.hour === "24" ? 0 : Number(parts.hour),
+    minute: Number(parts.minute),
+    second: Number(parts.second)
+  };
+}
+function formatInTimezone(iso, formatStr, timeZone) {
+  const p = partsInTimezone(new Date(iso), timeZone);
+  const tokens = {
+    yyyy: String(p.year),
+    MM: String(p.month).padStart(2, "0"),
+    dd: String(p.day).padStart(2, "0"),
+    HH: String(p.hour).padStart(2, "0"),
+    mm: String(p.minute).padStart(2, "0"),
+    ss: String(p.second).padStart(2, "0")
+  };
+  let result = formatStr;
+  for (const [token, value] of Object.entries(tokens).sort((a, b) => b[0].length - a[0].length)) {
+    result = result.split(token).join(value);
+  }
+  return result;
+}
+function getTimezoneOffsetMinutes(iso, timeZone) {
+  const utc = new Date(iso);
+  const p = partsInTimezone(utc, timeZone);
+  const asUtcEpoch = Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second);
+  return Math.round((asUtcEpoch - utc.getTime()) / 6e4);
+}
+function startOfDayInTimezone(iso, timeZone) {
+  const utc = new Date(iso);
+  const p = partsInTimezone(utc, timeZone);
+  const civilMidnightUtc = Date.UTC(p.year, p.month - 1, p.day, 0, 0, 0);
+  const midnightProbe = new Date(civilMidnightUtc).toISOString();
+  const offsetMinutes = getTimezoneOffsetMinutes(midnightProbe, timeZone);
+  return new Date(civilMidnightUtc - offsetMinutes * 6e4).toISOString();
+}
+function isSameDayInTimezone(a, b, timeZone) {
+  const pa = partsInTimezone(new Date(a), timeZone);
+  const pb = partsInTimezone(new Date(b), timeZone);
+  return pa.year === pb.year && pa.month === pb.month && pa.day === pb.day;
+}
+function todayInTimezone(timeZone) {
+  return startOfDayInTimezone((/* @__PURE__ */ new Date()).toISOString(), timeZone);
+}
+function civilMidnightFromUtcDay(gridUtcIso, timeZone) {
+  const utc = new Date(gridUtcIso);
+  const probe = new Date(
+    Date.UTC(utc.getUTCFullYear(), utc.getUTCMonth(), utc.getUTCDate(), 12, 0, 0)
+  ).toISOString();
+  return startOfDayInTimezone(probe, timeZone);
+}
+function getTimeInTimezone(iso, timeZone) {
+  const p = partsInTimezone(new Date(iso), timeZone);
+  return { hours: p.hour, minutes: p.minute, seconds: p.second };
+}
+function setTimeInTimezone(iso, partial, timeZone) {
+  const p = partsInTimezone(new Date(iso), 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 probe1 = new Date(civilEpoch).toISOString();
+  const offset1 = getTimezoneOffsetMinutes(probe1, timeZone);
+  const realEpoch1 = civilEpoch - offset1 * 6e4;
+  const probe2 = new Date(realEpoch1).toISOString();
+  const offset2 = getTimezoneOffsetMinutes(probe2, timeZone);
+  const realEpoch2 = civilEpoch - offset2 * 6e4;
+  return new Date(realEpoch2).toISOString();
+}
+
 // src/utils/labels.ts
 var DEFAULT_DATEPICKER_LABELS = {
   triggerOpen: "Open calendar",
@@ -613,7 +479,6 @@ var DEFAULT_DATETIMEPICKER_LABELS = {
   DEFAULT_DATETIMEPICKER_LABELS,
   DEFAULT_RANGEPICKER_LABELS,
   DEFAULT_TIMEPICKER_LABELS,
-  DateFnsAdapter,
   civilMidnightFromUtcDay,
   formatFullDate,
   formatInTimezone,

package/dist/index.d.cts

@@ -119,21 +119,6 @@ interface CalendarOptions {
     fixedWeeks?: boolean;
 }
 
-/**
- * DateAdapter implementation backed by date-fns.
- * All operations run in UTC to avoid timezone interference.
- *
- * @example
- * ```ts
- * import { DateFnsAdapter } from '@kalyx/core';
- *
- * DateFnsAdapter.format('2026-01-15T00:00:00.000Z', 'yyyy-MM-dd'); // "2026-01-15"
- * DateFnsAdapter.addDays('2026-01-15T00:00:00.000Z', 7);           // "2026-01-22T..."
- * DateFnsAdapter.isSameDay('2026-01-15T00:00:00.000Z', '2026-01-15T23:59:59.000Z'); // true
- * ```
- */
-declare const DateFnsAdapter: DateAdapter;
-
 /**
  * Builds the calendar grid for the given month.
  * Returns a 2D array (`CalendarGrid`) organized by week.
@@ -218,7 +203,13 @@ declare function parseTimeString(input: string): TimeValue | null;
 declare function formatTimeString(time: TimeValue, withSeconds?: boolean): string;
 /**
  * Converts a 24-hour value to 12-hour form.
- * 0 → 12 AM, 12 → 12 PM
+ *
+ * - `0` → `{ hours12: 12, period: 'AM' }` (midnight)
+ * - `12` → `{ hours12: 12, period: 'PM' }` (noon)
+ *
+ * Throws if `hours24` isn't an integer in `[0, 23]`. The previous silent
+ * modulo behaviour mapped invalid inputs (e.g. `24`, `25`, `-1`) onto
+ * arbitrary valid-looking outputs, which masked caller bugs.
  */
 declare function to12Hour(hours24: number): {
     hours12: number;
@@ -226,6 +217,10 @@ declare function to12Hour(hours24: number): {
 };
 /**
  * Converts a 12-hour value to 24-hour form.
+ *
+ * Throws if `hours12` isn't an integer in `[1, 12]`. The previous silent
+ * arithmetic produced out-of-range outputs (e.g. `to24Hour(13, 'PM')` → `25`).
+ * `period` is constrained at the type level to `'AM' | 'PM'`.
  */
 declare function to24Hour(hours12: number, period: 'AM' | 'PM'): number;
 /**
@@ -432,4 +427,4 @@ declare const DEFAULT_RANGEPICKER_LABELS: RangePickerLabels;
 declare const DEFAULT_TIMEPICKER_LABELS: TimePickerLabels;
 declare const DEFAULT_DATETIMEPICKER_LABELS: DateTimePickerLabels;
 
-export { type CalendarDay, type CalendarGrid, type CalendarOptions, type CalendarWeek, DEFAULT_DATEPICKER_LABELS, DEFAULT_DATETIMEPICKER_LABELS, DEFAULT_RANGEPICKER_LABELS, DEFAULT_TIMEPICKER_LABELS, type DateAdapter, DateFnsAdapter, type DatePickerLabels, type DateRange, type DateTimePickerLabels, type DisabledRule, type ISODateString, type RangePickerLabels, type TimePickerLabels, type TimeValue, type WeekStartsOn, type WeekdayInfo, civilMidnightFromUtcDay, formatFullDate, formatInTimezone, formatMonthYear, formatTimeFromISO, formatTimeString, generateHours, generateMinutes, getCalendarDays, getISOWeekNumber, getMonthName, getTime, getTimeInTimezone, getTimezoneOffsetMinutes, getWeekdayNames, isDateDisabled, isSameDayInTimezone, isSameTime, maxDate, minDate, normalizeISO, parseInputValue, parseTimeString, setTime, setTimeInTimezone, startOfDayInTimezone, to12Hour, to24Hour, todayInTimezone };
+export { type CalendarDay, type CalendarGrid, type CalendarOptions, type CalendarWeek, DEFAULT_DATEPICKER_LABELS, DEFAULT_DATETIMEPICKER_LABELS, DEFAULT_RANGEPICKER_LABELS, DEFAULT_TIMEPICKER_LABELS, type DateAdapter, type DatePickerLabels, type DateRange, type DateTimePickerLabels, type DisabledRule, type ISODateString, type RangePickerLabels, type TimePickerLabels, type TimeValue, type WeekStartsOn, type WeekdayInfo, civilMidnightFromUtcDay, formatFullDate, formatInTimezone, formatMonthYear, formatTimeFromISO, formatTimeString, generateHours, generateMinutes, getCalendarDays, getISOWeekNumber, getMonthName, getTime, getTimeInTimezone, getTimezoneOffsetMinutes, getWeekdayNames, isDateDisabled, isSameDayInTimezone, isSameTime, maxDate, minDate, normalizeISO, parseInputValue, parseTimeString, setTime, setTimeInTimezone, startOfDayInTimezone, to12Hour, to24Hour, todayInTimezone };

package/dist/index.d.ts

@@ -119,21 +119,6 @@ interface CalendarOptions {
     fixedWeeks?: boolean;
 }
 
-/**
- * DateAdapter implementation backed by date-fns.
- * All operations run in UTC to avoid timezone interference.
- *
- * @example
- * ```ts
- * import { DateFnsAdapter } from '@kalyx/core';
- *
- * DateFnsAdapter.format('2026-01-15T00:00:00.000Z', 'yyyy-MM-dd'); // "2026-01-15"
- * DateFnsAdapter.addDays('2026-01-15T00:00:00.000Z', 7);           // "2026-01-22T..."
- * DateFnsAdapter.isSameDay('2026-01-15T00:00:00.000Z', '2026-01-15T23:59:59.000Z'); // true
- * ```
- */
-declare const DateFnsAdapter: DateAdapter;
-
 /**
  * Builds the calendar grid for the given month.
  * Returns a 2D array (`CalendarGrid`) organized by week.
@@ -218,7 +203,13 @@ declare function parseTimeString(input: string): TimeValue | null;
 declare function formatTimeString(time: TimeValue, withSeconds?: boolean): string;
 /**
  * Converts a 24-hour value to 12-hour form.
- * 0 → 12 AM, 12 → 12 PM
+ *
+ * - `0` → `{ hours12: 12, period: 'AM' }` (midnight)
+ * - `12` → `{ hours12: 12, period: 'PM' }` (noon)
+ *
+ * Throws if `hours24` isn't an integer in `[0, 23]`. The previous silent
+ * modulo behaviour mapped invalid inputs (e.g. `24`, `25`, `-1`) onto
+ * arbitrary valid-looking outputs, which masked caller bugs.
  */
 declare function to12Hour(hours24: number): {
     hours12: number;
@@ -226,6 +217,10 @@ declare function to12Hour(hours24: number): {
 };
 /**
  * Converts a 12-hour value to 24-hour form.
+ *
+ * Throws if `hours12` isn't an integer in `[1, 12]`. The previous silent
+ * arithmetic produced out-of-range outputs (e.g. `to24Hour(13, 'PM')` → `25`).
+ * `period` is constrained at the type level to `'AM' | 'PM'`.
  */
 declare function to24Hour(hours12: number, period: 'AM' | 'PM'): number;
 /**
@@ -432,4 +427,4 @@ declare const DEFAULT_RANGEPICKER_LABELS: RangePickerLabels;
 declare const DEFAULT_TIMEPICKER_LABELS: TimePickerLabels;
 declare const DEFAULT_DATETIMEPICKER_LABELS: DateTimePickerLabels;
 
-export { type CalendarDay, type CalendarGrid, type CalendarOptions, type CalendarWeek, DEFAULT_DATEPICKER_LABELS, DEFAULT_DATETIMEPICKER_LABELS, DEFAULT_RANGEPICKER_LABELS, DEFAULT_TIMEPICKER_LABELS, type DateAdapter, DateFnsAdapter, type DatePickerLabels, type DateRange, type DateTimePickerLabels, type DisabledRule, type ISODateString, type RangePickerLabels, type TimePickerLabels, type TimeValue, type WeekStartsOn, type WeekdayInfo, civilMidnightFromUtcDay, formatFullDate, formatInTimezone, formatMonthYear, formatTimeFromISO, formatTimeString, generateHours, generateMinutes, getCalendarDays, getISOWeekNumber, getMonthName, getTime, getTimeInTimezone, getTimezoneOffsetMinutes, getWeekdayNames, isDateDisabled, isSameDayInTimezone, isSameTime, maxDate, minDate, normalizeISO, parseInputValue, parseTimeString, setTime, setTimeInTimezone, startOfDayInTimezone, to12Hour, to24Hour, todayInTimezone };
+export { type CalendarDay, type CalendarGrid, type CalendarOptions, type CalendarWeek, DEFAULT_DATEPICKER_LABELS, DEFAULT_DATETIMEPICKER_LABELS, DEFAULT_RANGEPICKER_LABELS, DEFAULT_TIMEPICKER_LABELS, type DateAdapter, type DatePickerLabels, type DateRange, type DateTimePickerLabels, type DisabledRule, type ISODateString, type RangePickerLabels, type TimePickerLabels, type TimeValue, type WeekStartsOn, type WeekdayInfo, civilMidnightFromUtcDay, formatFullDate, formatInTimezone, formatMonthYear, formatTimeFromISO, formatTimeString, generateHours, generateMinutes, getCalendarDays, getISOWeekNumber, getMonthName, getTime, getTimeInTimezone, getTimezoneOffsetMinutes, getWeekdayNames, isDateDisabled, isSameDayInTimezone, isSameTime, maxDate, minDate, normalizeISO, parseInputValue, parseTimeString, setTime, setTimeInTimezone, startOfDayInTimezone, to12Hour, to24Hour, todayInTimezone };

package/dist/index.js

@@ -1,254 +1,3 @@
-// src/adapters/date-fns.ts
-import {
-  parseISO as parseISO2,
-  addDays as dfAddDays,
-  addMonths as dfAddMonths,
-  addYears as dfAddYears,
-  isBefore as dfIsBefore,
-  isAfter as dfIsAfter,
-  isValid as dfIsValid
-} from "date-fns";
-
-// src/utils/timezone.ts
-import { parseISO } from "date-fns";
-var formatterCache = /* @__PURE__ */ new Map();
-function getCachedPartsFormatter(timeZone) {
-  const key = `parts:${timeZone}`;
-  let fmt = formatterCache.get(key);
-  if (!fmt) {
-    fmt = new Intl.DateTimeFormat("en-US", {
-      timeZone,
-      year: "numeric",
-      month: "2-digit",
-      day: "2-digit",
-      hour: "2-digit",
-      minute: "2-digit",
-      second: "2-digit",
-      hourCycle: "h23"
-    });
-    formatterCache.set(key, fmt);
-  }
-  return fmt;
-}
-function partsInTimezone(utc, timeZone) {
-  const dtf = getCachedPartsFormatter(timeZone);
-  const parts = Object.fromEntries(dtf.formatToParts(utc).map((p) => [p.type, p.value]));
-  return {
-    year: Number(parts.year),
-    month: Number(parts.month),
-    day: Number(parts.day),
-    // Some locales/engines return '24' instead of '0' at midnight
-    hour: parts.hour === "24" ? 0 : Number(parts.hour),
-    minute: Number(parts.minute),
-    second: Number(parts.second)
-  };
-}
-function formatInTimezone(iso, formatStr, timeZone) {
-  const p = partsInTimezone(parseISO(iso), timeZone);
-  const tokens = {
-    yyyy: String(p.year),
-    MM: String(p.month).padStart(2, "0"),
-    dd: String(p.day).padStart(2, "0"),
-    HH: String(p.hour).padStart(2, "0"),
-    mm: String(p.minute).padStart(2, "0"),
-    ss: String(p.second).padStart(2, "0")
-  };
-  let result = formatStr;
-  for (const [token, value] of Object.entries(tokens).sort((a, b) => b[0].length - a[0].length)) {
-    result = result.split(token).join(value);
-  }
-  return result;
-}
-function getTimezoneOffsetMinutes(iso, timeZone) {
-  const utc = parseISO(iso);
-  const p = partsInTimezone(utc, timeZone);
-  const asUtcEpoch = Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second);
-  return Math.round((asUtcEpoch - utc.getTime()) / 6e4);
-}
-function startOfDayInTimezone(iso, timeZone) {
-  const utc = parseISO(iso);
-  const p = partsInTimezone(utc, timeZone);
-  const civilMidnightUtc = Date.UTC(p.year, p.month - 1, p.day, 0, 0, 0);
-  const midnightProbe = new Date(civilMidnightUtc).toISOString();
-  const offsetMinutes = getTimezoneOffsetMinutes(midnightProbe, timeZone);
-  return new Date(civilMidnightUtc - offsetMinutes * 6e4).toISOString();
-}
-function isSameDayInTimezone(a, b, timeZone) {
-  const pa = partsInTimezone(parseISO(a), timeZone);
-  const pb = partsInTimezone(parseISO(b), timeZone);
-  return pa.year === pb.year && pa.month === pb.month && pa.day === pb.day;
-}
-function todayInTimezone(timeZone) {
-  return startOfDayInTimezone((/* @__PURE__ */ new Date()).toISOString(), 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();
-  return startOfDayInTimezone(probe, timeZone);
-}
-function getTimeInTimezone(iso, timeZone) {
-  const p = partsInTimezone(parseISO(iso), timeZone);
-  return { hours: p.hour, minutes: p.minute, seconds: p.second };
-}
-function setTimeInTimezone(iso, partial, timeZone) {
-  const p = partsInTimezone(parseISO(iso), 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 probe1 = new Date(civilEpoch).toISOString();
-  const offset1 = getTimezoneOffsetMinutes(probe1, timeZone);
-  const realEpoch1 = civilEpoch - offset1 * 6e4;
-  const probe2 = new Date(realEpoch1).toISOString();
-  const offset2 = getTimezoneOffsetMinutes(probe2, timeZone);
-  const realEpoch2 = civilEpoch - offset2 * 6e4;
-  return new Date(realEpoch2).toISOString();
-}
-
-// src/adapters/date-fns.ts
-function toDate(iso) {
-  return parseISO2(iso);
-}
-function toISO(date) {
-  return date.toISOString();
-}
-function normalize(value) {
-  if (/^\d{4}-\d{2}-\d{2}$/.test(value)) {
-    return `${value}T00:00:00.000Z`;
-  }
-  return value;
-}
-function utcStartOfDay(d) {
-  return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
-}
-function utcStartOfMonth(d) {
-  return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), 1));
-}
-function utcEndOfMonth(d) {
-  return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth() + 1, 0, 23, 59, 59, 999));
-}
-function utcStartOfWeek(d, weekStartsOn) {
-  const day = d.getUTCDay();
-  const diff = (day - weekStartsOn + 7) % 7;
-  return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate() - diff));
-}
-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)
-  );
-}
-var DateFnsAdapter = {
-  parse(value) {
-    if (!value) return "";
-    return normalize(value);
-  },
-  format(iso, formatStr, timezone) {
-    if (timezone) {
-      return formatInTimezone(iso, formatStr, timezone);
-    }
-    const d = toDate(iso);
-    const tokens = {
-      yyyy: String(d.getUTCFullYear()),
-      MM: String(d.getUTCMonth() + 1).padStart(2, "0"),
-      dd: String(d.getUTCDate()).padStart(2, "0"),
-      HH: String(d.getUTCHours()).padStart(2, "0"),
-      mm: String(d.getUTCMinutes()).padStart(2, "0"),
-      ss: String(d.getUTCSeconds()).padStart(2, "0"),
-      M: String(d.getUTCMonth() + 1),
-      d: String(d.getUTCDate())
-    };
-    let result = formatStr;
-    for (const [token, value] of Object.entries(tokens).sort((a, b) => b[0].length - a[0].length)) {
-      result = result.split(token).join(value);
-    }
-    return result;
-  },
-  addDays(iso, n) {
-    return toISO(dfAddDays(toDate(iso), n));
-  },
-  addMonths(iso, n) {
-    return toISO(dfAddMonths(toDate(iso), n));
-  },
-  addYears(iso, n) {
-    return toISO(dfAddYears(toDate(iso), n));
-  },
-  isBefore(a, b) {
-    return dfIsBefore(toDate(a), toDate(b));
-  },
-  isAfter(a, b) {
-    return dfIsAfter(toDate(a), toDate(b));
-  },
-  isSameDay(a, b, timezone) {
-    if (!a || !b) return false;
-    if (timezone) {
-      return isSameDayInTimezone(a, b, timezone);
-    }
-    const da = toDate(a);
-    const db = toDate(b);
-    return da.getUTCFullYear() === db.getUTCFullYear() && da.getUTCMonth() === db.getUTCMonth() && da.getUTCDate() === db.getUTCDate();
-  },
-  isSameMonth(a, b) {
-    const da = toDate(a);
-    const db = toDate(b);
-    return da.getUTCFullYear() === db.getUTCFullYear() && da.getUTCMonth() === db.getUTCMonth();
-  },
-  startOfDay(iso, timezone) {
-    if (timezone) {
-      return startOfDayInTimezone(iso, timezone);
-    }
-    return toISO(utcStartOfDay(toDate(iso)));
-  },
-  startOfMonth(iso) {
-    return toISO(utcStartOfMonth(toDate(iso)));
-  },
-  endOfMonth(iso) {
-    return toISO(utcEndOfMonth(toDate(iso)));
-  },
-  startOfWeek(iso, weekStartsOn = 0) {
-    return toISO(utcStartOfWeek(toDate(iso), weekStartsOn));
-  },
-  endOfWeek(iso, weekStartsOn = 0) {
-    return toISO(utcEndOfWeek(toDate(iso), weekStartsOn));
-  },
-  now() {
-    return (/* @__PURE__ */ new Date()).toISOString();
-  },
-  today(timezone) {
-    if (timezone) {
-      return todayInTimezone(timezone);
-    }
-    return toISO(utcStartOfDay(/* @__PURE__ */ new Date()));
-  },
-  isValid(value) {
-    if (!value) return false;
-    const normalized = normalize(value);
-    const date = parseISO2(normalized);
-    return dfIsValid(date);
-  },
-  getYear(iso) {
-    return toDate(iso).getUTCFullYear();
-  },
-  getMonth(iso) {
-    return toDate(iso).getUTCMonth();
-  },
-  getDate(iso) {
-    return toDate(iso).getUTCDate();
-  },
-  getDay(iso) {
-    return toDate(iso).getUTCDay();
-  }
-};
-
 // src/utils/calendar.ts
 function getCalendarDays(monthISO, adapter, options = {}) {
   const {
@@ -426,12 +175,18 @@ function formatTimeString(time, withSeconds = false) {
   return `${hh}:${mm}`;
 }
 function to12Hour(hours24) {
+  if (!Number.isInteger(hours24) || hours24 < 0 || hours24 > 23) {
+    throw new RangeError(`[to12Hour] hours24 must be an integer in [0, 23], got ${hours24}`);
+  }
   const period = hours24 >= 12 ? "PM" : "AM";
   let hours12 = hours24 % 12;
   if (hours12 === 0) hours12 = 12;
   return { hours12, period };
 }
 function to24Hour(hours12, period) {
+  if (!Number.isInteger(hours12) || hours12 < 1 || hours12 > 12) {
+    throw new RangeError(`[to24Hour] hours12 must be an integer in [1, 12], got ${hours12}`);
+  }
   if (period === "AM") {
     return hours12 === 12 ? 0 : hours12;
   }
@@ -471,13 +226,13 @@ function formatTimeFromISO(iso, format) {
 }
 
 // src/utils/locale.ts
-var formatterCache2 = /* @__PURE__ */ new Map();
+var formatterCache = /* @__PURE__ */ new Map();
 function getCachedFormatter(locale, options) {
   const key = `${locale}:${JSON.stringify(options)}`;
-  let fmt = formatterCache2.get(key);
+  let fmt = formatterCache.get(key);
   if (!fmt) {
     fmt = new Intl.DateTimeFormat(locale, options);
-    formatterCache2.set(key, fmt);
+    formatterCache.set(key, fmt);
   }
   return fmt;
 }
@@ -522,6 +277,110 @@ function formatFullDate(iso, locale = "en-US") {
   }).format(date);
 }
 
+// src/utils/timezone.ts
+var formatterCache2 = /* @__PURE__ */ new Map();
+function getCachedPartsFormatter(timeZone) {
+  const key = `parts:${timeZone}`;
+  let fmt = formatterCache2.get(key);
+  if (!fmt) {
+    fmt = new Intl.DateTimeFormat("en-US", {
+      timeZone,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit",
+      hourCycle: "h23"
+    });
+    formatterCache2.set(key, fmt);
+  }
+  return fmt;
+}
+function partsInTimezone(utc, timeZone) {
+  const dtf = getCachedPartsFormatter(timeZone);
+  const parts = Object.fromEntries(dtf.formatToParts(utc).map((p) => [p.type, p.value]));
+  return {
+    year: Number(parts.year),
+    month: Number(parts.month),
+    day: Number(parts.day),
+    // Some locales/engines return '24' instead of '0' at midnight
+    hour: parts.hour === "24" ? 0 : Number(parts.hour),
+    minute: Number(parts.minute),
+    second: Number(parts.second)
+  };
+}
+function formatInTimezone(iso, formatStr, timeZone) {
+  const p = partsInTimezone(new Date(iso), timeZone);
+  const tokens = {
+    yyyy: String(p.year),
+    MM: String(p.month).padStart(2, "0"),
+    dd: String(p.day).padStart(2, "0"),
+    HH: String(p.hour).padStart(2, "0"),
+    mm: String(p.minute).padStart(2, "0"),
+    ss: String(p.second).padStart(2, "0")
+  };
+  let result = formatStr;
+  for (const [token, value] of Object.entries(tokens).sort((a, b) => b[0].length - a[0].length)) {
+    result = result.split(token).join(value);
+  }
+  return result;
+}
+function getTimezoneOffsetMinutes(iso, timeZone) {
+  const utc = new Date(iso);
+  const p = partsInTimezone(utc, timeZone);
+  const asUtcEpoch = Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second);
+  return Math.round((asUtcEpoch - utc.getTime()) / 6e4);
+}
+function startOfDayInTimezone(iso, timeZone) {
+  const utc = new Date(iso);
+  const p = partsInTimezone(utc, timeZone);
+  const civilMidnightUtc = Date.UTC(p.year, p.month - 1, p.day, 0, 0, 0);
+  const midnightProbe = new Date(civilMidnightUtc).toISOString();
+  const offsetMinutes = getTimezoneOffsetMinutes(midnightProbe, timeZone);
+  return new Date(civilMidnightUtc - offsetMinutes * 6e4).toISOString();
+}
+function isSameDayInTimezone(a, b, timeZone) {
+  const pa = partsInTimezone(new Date(a), timeZone);
+  const pb = partsInTimezone(new Date(b), timeZone);
+  return pa.year === pb.year && pa.month === pb.month && pa.day === pb.day;
+}
+function todayInTimezone(timeZone) {
+  return startOfDayInTimezone((/* @__PURE__ */ new Date()).toISOString(), timeZone);
+}
+function civilMidnightFromUtcDay(gridUtcIso, timeZone) {
+  const utc = new Date(gridUtcIso);
+  const probe = new Date(
+    Date.UTC(utc.getUTCFullYear(), utc.getUTCMonth(), utc.getUTCDate(), 12, 0, 0)
+  ).toISOString();
+  return startOfDayInTimezone(probe, timeZone);
+}
+function getTimeInTimezone(iso, timeZone) {
+  const p = partsInTimezone(new Date(iso), timeZone);
+  return { hours: p.hour, minutes: p.minute, seconds: p.second };
+}
+function setTimeInTimezone(iso, partial, timeZone) {
+  const p = partsInTimezone(new Date(iso), 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 probe1 = new Date(civilEpoch).toISOString();
+  const offset1 = getTimezoneOffsetMinutes(probe1, timeZone);
+  const realEpoch1 = civilEpoch - offset1 * 6e4;
+  const probe2 = new Date(realEpoch1).toISOString();
+  const offset2 = getTimezoneOffsetMinutes(probe2, timeZone);
+  const realEpoch2 = civilEpoch - offset2 * 6e4;
+  return new Date(realEpoch2).toISOString();
+}
+
 // src/utils/labels.ts
 var DEFAULT_DATEPICKER_LABELS = {
   triggerOpen: "Open calendar",
@@ -561,7 +420,6 @@ export {
   DEFAULT_DATETIMEPICKER_LABELS,
   DEFAULT_RANGEPICKER_LABELS,
   DEFAULT_TIMEPICKER_LABELS,
-  DateFnsAdapter,
   civilMidnightFromUtcDay,
   formatFullDate,
   formatInTimezone,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kalyx/core",
-  "version": "1.0.0-rc.11",
+  "version": "1.0.0-rc.13",
   "description": "Kalyx core — platform-agnostic date logic, IANA timezone helpers, and the DateAdapter contract used by @kalyx/react",
   "license": "MIT",
   "author": "jiji-hoon96",
@@ -22,7 +22,7 @@
     "dst",
     "iso8601",
     "utc",
-    "date-fns"
+    "adapter"
   ],
   "type": "module",
   "sideEffects": false,
@@ -46,9 +46,8 @@
     "CHANGELOG.md",
     "LICENSE"
   ],
-  "dependencies": {
-    "date-fns": "^4.0.0",
-    "date-fns-tz": "^3.0.0"
+  "devDependencies": {
+    "@kalyx/adapter-date-fns": "1.0.0-rc.1"
   },
   "engines": {
     "node": ">=20.0.0"