@kalyx/core 1.0.0-rc.4 → 1.0.0-rc.7

package/CHANGELOG.md

@@ -1,5 +1,58 @@
 # @kalyx/core
 
+## 1.0.0-rc.7
+
+### Minor Changes
+
+- 0eca2e8: Two new `DatePicker.Calendar` / `RangePicker.Calendar` props plus an ISO-week utility:
+  - **`showWeekNumber`** — render an ISO 8601 week-number column (1–53) on the left of the grid. The column uses `<th scope="row" aria-hidden="true">` so it doesn't participate in the WAI-ARIA grid data region; keyboard navigation across date cells is unchanged. New className slots: `weekNumberHeader`, `weekNumber`.
+  - **`fixedWeeks`** — when true, always render 6 rows (42 cells) regardless of the month. Useful for popover layouts that need a stable height across month navigation.
+
+  Both also accepted on `CalendarOptions` (the `getCalendarDays` core util gains `fixedWeeks`).
+
+  New core export: **`getISOWeekNumber(iso)`** — pure UTC computation, no date-fns dep. Anchored to the Thursday of the week (so the same week always returns the same number regardless of `weekStartsOn`).
+
+  ```tsx
+  <DatePicker value={date} onChange={setDate}>
+    <DatePicker.Input />
+    <DatePicker.Popover>
+      <DatePicker.Calendar showWeekNumber fixedWeeks />
+    </DatePicker.Popover>
+  </DatePicker>
+  ```
+
+  Bundle impact: +0.46 KB ESM gzip (13.96 → 14.42 KB). Still well under the 15 KB ceiling.
+
+- d62c84e: `DisabledRule` gains a programmatic `filter` variant — pass any predicate `(iso: ISODateString) => boolean` to disable arbitrary days that don't fit the declarative `before` / `after` / `dayOfWeek` / `date` rules.
+
+  ```tsx
+  const holidays = new Set(['2026-01-01T00:00:00.000Z', '2026-12-25T00:00:00.000Z']);
+
+  <DatePicker
+    disabled={[
+      { dayOfWeek: [0, 6] }, // weekends
+      { filter: (iso) => holidays.has(iso) }, // holidays
+    ]}
+  >
+    …
+  </DatePicker>;
+  ```
+
+  The new variant slots into the existing `isDateDisabled` evaluation (short-circuits on first match) and works with keyboard-navigation disabled-skip in `DatePicker.Calendar` / `RangePicker.Calendar` with no further changes. Equivalent to `react-datepicker`'s `filterDate` prop and MUI X DatePicker's `shouldDisableDate`. Bundle impact: 0 KB (still 13.96 KB ESM gzip).
+
+## 1.0.0-rc.6
+
+### Patch Changes
+
+- abc56ac: Security: pin transitive `fast-uri` to `>=3.1.2` and `@babel/plugin-transform-modules-systemjs` to `>=7.29.4` via `pnpm.overrides`.
+
+  Resolves three Code Scanning alerts on `pnpm-lock.yaml`:
+  - `fast-uri@3.1.0` — [GHSA-v39h-62p7-jpjc](https://osv.dev/GHSA-v39h-62p7-jpjc) (CVE-2026-6322), first patched in `3.1.2`.
+  - `fast-uri@3.1.0` — [GHSA-q3j6-qgpj-74h6](https://osv.dev/GHSA-q3j6-qgpj-74h6) (CVE-2026-6321), first patched in `3.1.1`.
+  - `@babel/plugin-transform-modules-systemjs@7.29.0` — [GHSA-fv7c-fp4j-7gwp](https://osv.dev/GHSA-fv7c-fp4j-7gwp) (CVE-2026-44728), first patched in `7.29.4` on the 7.x line.
+
+  All three packages are transitive build-time dependencies (ajv → fast-uri, Babel preset-env → systemjs plugin); no public API impact.
+
 ## 1.0.0-rc.4
 
 ### Patch Changes

package/dist/index.cjs

@@ -34,6 +34,7 @@ __export(index_exports, {
   generateHours: () => generateHours,
   generateMinutes: () => generateMinutes,
   getCalendarDays: () => getCalendarDays,
+  getISOWeekNumber: () => getISOWeekNumber,
   getMonthName: () => getMonthName,
   getTime: () => getTime,
   getTimeInTimezone: () => getTimeInTimezone,
@@ -309,7 +310,8 @@ function getCalendarDays(monthISO, adapter, options = {}) {
     disabled = [],
     range,
     rangeHover,
-    timezone
+    timezone,
+    fixedWeeks = false
   } = options;
   const todayISO = today ?? adapter.today(timezone);
   const monthStart = adapter.startOfMonth(monthISO);
@@ -339,12 +341,20 @@ function getCalendarDays(monthISO, adapter, options = {}) {
       current = adapter.addDays(current, 1);
     }
     weeks.push(days);
-    if (!adapter.isSameMonth(current, monthISO) && week >= 3) {
+    if (!fixedWeeks && !adapter.isSameMonth(current, monthISO) && week >= 3) {
       break;
     }
   }
   return weeks;
 }
+function getISOWeekNumber(iso) {
+  const d = new Date(iso);
+  const utc = new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
+  const isoDay = utc.getUTCDay() || 7;
+  utc.setUTCDate(utc.getUTCDate() + 4 - isoDay);
+  const yearStart = new Date(Date.UTC(utc.getUTCFullYear(), 0, 1));
+  return Math.ceil(((utc.getTime() - yearStart.getTime()) / 864e5 + 1) / 7);
+}
 function normalizeRangeForDisplay(range, hover, adapter, _timezone) {
   if (!range) return { start: null, end: null };
   const { start, end } = range;
@@ -388,6 +398,8 @@ function isDateDisabled(iso, rules, adapter) {
       if (adapter.isAfter(iso, rule.after)) return true;
     } else if ("dayOfWeek" in rule) {
       if (rule.dayOfWeek.includes(adapter.getDay(iso))) return true;
+    } else if ("filter" in rule) {
+      if (rule.filter(iso)) return true;
     }
   }
   return false;
@@ -609,6 +621,7 @@ var DEFAULT_DATETIMEPICKER_LABELS = {
   generateHours,
   generateMinutes,
   getCalendarDays,
+  getISOWeekNumber,
   getMonthName,
   getTime,
   getTimeInTimezone,

package/dist/index.d.cts

@@ -15,7 +15,8 @@ type ISODateString = string;
  *   { before: '2026-01-01T00:00:00.000Z' }, // disable before Jan 1
  *   { after: '2026-12-31T00:00:00.000Z' },  // disable after Dec 31
  *   { date: '2026-06-15T00:00:00.000Z' },   // disable a specific date
- *   { dayOfWeek: [0, 6] },                   // disable weekends
+ *   { dayOfWeek: [0, 6] },                  // disable weekends
+ *   { filter: (iso) => holidays.has(iso) }, // programmatic filter
  * ];
  * ```
  */
@@ -27,6 +28,8 @@ type DisabledRule = {
     after: ISODateString;
 } | {
     dayOfWeek: number[];
+} | {
+    filter: (iso: ISODateString) => boolean;
 };
 /** Date range (RangePicker) */
 interface DateRange {
@@ -108,6 +111,12 @@ interface CalendarOptions {
      * midnight form while the grid iterates in UTC.
      */
     timezone?: string;
+    /**
+     * Always emit exactly six weeks (42 days). The default (`false`) emits 4–6 weeks
+     * depending on the month, breaking after the last week containing a current-month day.
+     * Setting `true` is useful for layouts that need a fixed-height grid.
+     */
+    fixedWeeks?: boolean;
 }
 
 /**
@@ -146,6 +155,16 @@ declare const DateFnsAdapter: DateAdapter;
  * ```
  */
 declare function getCalendarDays(monthISO: string, adapter: DateAdapter, options?: CalendarOptions): CalendarGrid;
+/**
+ * Returns the ISO 8601 week number (1-53) of the given date. ISO weeks start on Monday;
+ * week 1 is the week containing the year's first Thursday. The computation works in UTC
+ * to match the calendar grid's iteration semantics.
+ *
+ * @example
+ * getISOWeekNumber('2026-01-01T00:00:00.000Z'); // 1 (Jan 1 2026 is a Thursday → ISO week 1)
+ * getISOWeekNumber('2026-12-31T00:00:00.000Z'); // 53
+ */
+declare function getISOWeekNumber(iso: ISODateString): number;
 /**
  * Checks whether the given date matches any disable rule.
  */
@@ -397,4 +416,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, 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, 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 };

package/dist/index.d.ts

@@ -15,7 +15,8 @@ type ISODateString = string;
  *   { before: '2026-01-01T00:00:00.000Z' }, // disable before Jan 1
  *   { after: '2026-12-31T00:00:00.000Z' },  // disable after Dec 31
  *   { date: '2026-06-15T00:00:00.000Z' },   // disable a specific date
- *   { dayOfWeek: [0, 6] },                   // disable weekends
+ *   { dayOfWeek: [0, 6] },                  // disable weekends
+ *   { filter: (iso) => holidays.has(iso) }, // programmatic filter
  * ];
  * ```
  */
@@ -27,6 +28,8 @@ type DisabledRule = {
     after: ISODateString;
 } | {
     dayOfWeek: number[];
+} | {
+    filter: (iso: ISODateString) => boolean;
 };
 /** Date range (RangePicker) */
 interface DateRange {
@@ -108,6 +111,12 @@ interface CalendarOptions {
      * midnight form while the grid iterates in UTC.
      */
     timezone?: string;
+    /**
+     * Always emit exactly six weeks (42 days). The default (`false`) emits 4–6 weeks
+     * depending on the month, breaking after the last week containing a current-month day.
+     * Setting `true` is useful for layouts that need a fixed-height grid.
+     */
+    fixedWeeks?: boolean;
 }
 
 /**
@@ -146,6 +155,16 @@ declare const DateFnsAdapter: DateAdapter;
  * ```
  */
 declare function getCalendarDays(monthISO: string, adapter: DateAdapter, options?: CalendarOptions): CalendarGrid;
+/**
+ * Returns the ISO 8601 week number (1-53) of the given date. ISO weeks start on Monday;
+ * week 1 is the week containing the year's first Thursday. The computation works in UTC
+ * to match the calendar grid's iteration semantics.
+ *
+ * @example
+ * getISOWeekNumber('2026-01-01T00:00:00.000Z'); // 1 (Jan 1 2026 is a Thursday → ISO week 1)
+ * getISOWeekNumber('2026-12-31T00:00:00.000Z'); // 53
+ */
+declare function getISOWeekNumber(iso: ISODateString): number;
 /**
  * Checks whether the given date matches any disable rule.
  */
@@ -397,4 +416,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, 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, 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 };

package/dist/index.js

@@ -259,7 +259,8 @@ function getCalendarDays(monthISO, adapter, options = {}) {
     disabled = [],
     range,
     rangeHover,
-    timezone
+    timezone,
+    fixedWeeks = false
   } = options;
   const todayISO = today ?? adapter.today(timezone);
   const monthStart = adapter.startOfMonth(monthISO);
@@ -289,12 +290,20 @@ function getCalendarDays(monthISO, adapter, options = {}) {
       current = adapter.addDays(current, 1);
     }
     weeks.push(days);
-    if (!adapter.isSameMonth(current, monthISO) && week >= 3) {
+    if (!fixedWeeks && !adapter.isSameMonth(current, monthISO) && week >= 3) {
       break;
     }
   }
   return weeks;
 }
+function getISOWeekNumber(iso) {
+  const d = new Date(iso);
+  const utc = new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
+  const isoDay = utc.getUTCDay() || 7;
+  utc.setUTCDate(utc.getUTCDate() + 4 - isoDay);
+  const yearStart = new Date(Date.UTC(utc.getUTCFullYear(), 0, 1));
+  return Math.ceil(((utc.getTime() - yearStart.getTime()) / 864e5 + 1) / 7);
+}
 function normalizeRangeForDisplay(range, hover, adapter, _timezone) {
   if (!range) return { start: null, end: null };
   const { start, end } = range;
@@ -338,6 +347,8 @@ function isDateDisabled(iso, rules, adapter) {
       if (adapter.isAfter(iso, rule.after)) return true;
     } else if ("dayOfWeek" in rule) {
       if (rule.dayOfWeek.includes(adapter.getDay(iso))) return true;
+    } else if ("filter" in rule) {
+      if (rule.filter(iso)) return true;
     }
   }
   return false;
@@ -558,6 +569,7 @@ export {
   generateHours,
   generateMinutes,
   getCalendarDays,
+  getISOWeekNumber,
   getMonthName,
   getTime,
   getTimeInTimezone,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kalyx/core",
-  "version": "1.0.0-rc.4",
+  "version": "1.0.0-rc.7",
   "description": "Kalyx core — platform-agnostic date logic, IANA timezone helpers, and the DateAdapter contract used by @kalyx/react",
   "license": "MIT",
   "author": "jiji-hoon96",