@ceed/ads 1.30.0 → 1.31.0

package/dist/components/inputs/Calendar.md

@@ -165,9 +165,7 @@ Disable weekends, past dates, and limit selection to one week ahead by combining
 <Calendar shouldDisableDate={date => [0, 6].includes(date.getDay()) || date.getTime() >= new Date().getTime() + 7 * 24 * 60 * 60 * 1000} disablePast />
 ```
 
-## Common Use Cases
-
-### Embedded Calendar Widget
+## Embedded Calendar Widget
 
 ```tsx
 import { Calendar } from '@ceed/ads';
@@ -193,7 +191,7 @@ function CalendarWidget() {
 }
 ```
 
-### Booking Calendar with Disabled Dates
+## Booking Calendar with Disabled Dates
 
 ```tsx
 function BookingCalendar({ blockedDates }) {
@@ -217,7 +215,7 @@ function BookingCalendar({ blockedDates }) {
 }
 ```
 
-### Date Range Selector with Summary
+## Date Range Selector with Summary
 
 ```tsx
 function DateRangeSelector({ onRangeSelect }) {
@@ -304,6 +302,28 @@ const shouldDisableDate = useCallback((date: Date) => {
 
 5. **Provide surrounding context when using Calendar directly.** Add a heading or label to explain the calendar's purpose, since Calendar itself has no built-in label.
 
+## Props and Customization
+
+### Key Props
+
+| Prop                | Type                                        | Default            | Description                                                            |
+| ------------------- | ------------------------------------------- | ------------------ | ---------------------------------------------------------------------- |
+| `value`             | `[Date, Date \| undefined]`                 | -                  | Selected date(s) for controlled mode. Single date: `[date, undefined]` |
+| `defaultValue`      | `[Date, Date \| undefined]`                 | -                  | Initial date(s) for uncontrolled mode                                  |
+| `onChange`          | `(date: [Date, Date \| undefined]) => void` | -                  | Callback when date selection changes                                   |
+| `view`              | `'month' \| 'day'`                          | `'day'`            | Active calendar view                                                   |
+| `views`             | `('month' \| 'day')[]`                      | `['month', 'day']` | Available views for navigation                                         |
+| `onViewChange`      | `(view: 'month' \| 'day') => void`          | -                  | Callback when view changes                                             |
+| `onMonthChange`     | `(newMonth: Date) => void`                  | -                  | Callback when the displayed month changes                              |
+| `rangeSelection`    | `boolean`                                   | `false`            | Enable date range selection (two dates)                                |
+| `locale`            | `string`                                    | `'default'`        | Locale for month/day names (BCP 47 format)                             |
+| `minDate`           | `Date`                                      | -                  | Minimum selectable date                                                |
+| `maxDate`           | `Date`                                      | -                  | Maximum selectable date                                                |
+| `disableFuture`     | `boolean`                                   | `false`            | Disable all future dates                                               |
+| `disablePast`       | `boolean`                                   | `false`            | Disable all past dates                                                 |
+| `shouldDisableDate` | `(date: Date) => boolean`                   | -                  | Custom function to disable specific dates                              |
+| `slots`             | `{ day?, monthButton?, yearButton? }`       | -                  | Custom component slots for calendar elements                           |
+
 ## Accessibility
 
 - **Keyboard navigation**: Arrow keys navigate between days, Page Up/Down switches months, Home/End jumps to start/end of the week, and Enter/Space selects the focused date.