@kalyx/react 1.0.0-rc.3 → 1.0.0-rc.5

package/dist/index.d.cts

@@ -515,6 +515,9 @@ interface TimePickerAmPmToggleProps extends Omit<HTMLAttributes<HTMLDivElement>,
 /**
  * TimePicker.AmPmToggle — AM/PM toggle shown only in 12-hour mode.
  * Returns null in 24-hour mode.
+ *
+ * Implements the WAI-ARIA radiogroup pattern: only the checked radio is in the
+ * tab order; ArrowLeft/Right/Up/Down + Home/End move selection between radios.
  */
 declare function TimePickerAmPmToggle({ classNames, ...props }: TimePickerAmPmToggleProps): react_jsx_runtime.JSX.Element | null;
 
@@ -689,9 +692,18 @@ interface MonthPickerGridProps extends Omit<HTMLAttributes<HTMLDivElement>, 'rol
  * Unlike `DatePicker.MonthGrid` (drilldown), this component commits the month selection
  * via `ctx.selectDate`, emitting the month-start ISO string.
  *
+ * Disabled state: a month is marked unselectable when every day in it is
+ * excluded by a `before`/`after` rule on the `disabled` prop. The cell is
+ * rendered with `disabled` + `aria-disabled` + the `monthDisabled` className,
+ * and keyboard navigation skips it.
+ *
  * @example
  * ```tsx
- * <MonthPicker value={month} onChange={setMonth} displayFormat="yyyy-MM">
+ * <MonthPicker
+ *   value={month}
+ *   onChange={setMonth}
+ *   disabled={[{ before: '2026-04-01T00:00:00.000Z' }]}
+ * >
  *   <MonthPicker.Input />
  *   <MonthPicker.Popover>
  *     <MonthPicker.Grid />
@@ -753,9 +765,18 @@ interface YearPickerGridProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role
  * Unlike `DatePicker.YearGrid` (drilldown), this component commits the year selection via
  * `ctx.selectDate`, emitting the year-start ISO string (Jan 1 at UTC midnight).
  *
+ * Disabled state: a year is marked unselectable when every day in it is
+ * excluded by a `before`/`after` rule on the `disabled` prop. The cell is
+ * rendered with `disabled` + `aria-disabled` + the `yearDisabled` className,
+ * and keyboard navigation skips it.
+ *
  * @example
  * ```tsx
- * <YearPicker value={year} onChange={setYear}>
+ * <YearPicker
+ *   value={year}
+ *   onChange={setYear}
+ *   disabled={[{ before: '2024-01-01T00:00:00.000Z' }]}
+ * >
  *   <YearPicker.Input />
  *   <YearPicker.Popover>
  *     <YearPicker.Grid />

package/dist/index.d.ts

@@ -515,6 +515,9 @@ interface TimePickerAmPmToggleProps extends Omit<HTMLAttributes<HTMLDivElement>,
 /**
  * TimePicker.AmPmToggle — AM/PM toggle shown only in 12-hour mode.
  * Returns null in 24-hour mode.
+ *
+ * Implements the WAI-ARIA radiogroup pattern: only the checked radio is in the
+ * tab order; ArrowLeft/Right/Up/Down + Home/End move selection between radios.
  */
 declare function TimePickerAmPmToggle({ classNames, ...props }: TimePickerAmPmToggleProps): react_jsx_runtime.JSX.Element | null;
 
@@ -689,9 +692,18 @@ interface MonthPickerGridProps extends Omit<HTMLAttributes<HTMLDivElement>, 'rol
  * Unlike `DatePicker.MonthGrid` (drilldown), this component commits the month selection
  * via `ctx.selectDate`, emitting the month-start ISO string.
  *
+ * Disabled state: a month is marked unselectable when every day in it is
+ * excluded by a `before`/`after` rule on the `disabled` prop. The cell is
+ * rendered with `disabled` + `aria-disabled` + the `monthDisabled` className,
+ * and keyboard navigation skips it.
+ *
  * @example
  * ```tsx
- * <MonthPicker value={month} onChange={setMonth} displayFormat="yyyy-MM">
+ * <MonthPicker
+ *   value={month}
+ *   onChange={setMonth}
+ *   disabled={[{ before: '2026-04-01T00:00:00.000Z' }]}
+ * >
  *   <MonthPicker.Input />
  *   <MonthPicker.Popover>
  *     <MonthPicker.Grid />
@@ -753,9 +765,18 @@ interface YearPickerGridProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role
  * Unlike `DatePicker.YearGrid` (drilldown), this component commits the year selection via
  * `ctx.selectDate`, emitting the year-start ISO string (Jan 1 at UTC midnight).
  *
+ * Disabled state: a year is marked unselectable when every day in it is
+ * excluded by a `before`/`after` rule on the `disabled` prop. The cell is
+ * rendered with `disabled` + `aria-disabled` + the `yearDisabled` className,
+ * and keyboard navigation skips it.
+ *
  * @example
  * ```tsx
- * <YearPicker value={year} onChange={setYear}>
+ * <YearPicker
+ *   value={year}
+ *   onChange={setYear}
+ *   disabled={[{ before: '2024-01-01T00:00:00.000Z' }]}
+ * >
  *   <YearPicker.Input />
  *   <YearPicker.Popover>
  *     <YearPicker.Grid />