@servicetitan/anvil2 1.37.2 → 1.38.0

package/dist/components/Combobox/Combobox.d.ts

@@ -1,8 +1,54 @@
 import { ComboboxProps as CoreComboboxProps, ComboboxSelectProps as CoreComboboxSelectProps, ComboboxContentProps as CoreComboboxContentProps, ComboboxSearchFieldProps as CoreComboboxSearchFieldProps, ComboboxSelectTriggerProps as CoreComboboxSelectTriggerProps, ComboboxListProps as CoreComboboxListProps, ComboboxItemProps as CoreComboboxItemProps, ComboboxItemAddNewProps as CoreComboboxItemAddNewProps, ComboboxEmptyProps as CoreComboboxEmptyProps, IconProps as CoreIconProps, AvatarProps as CoreAvatarProps } from '@servicetitan/hammer-react';
 import { DataTrackingId } from '../../types/DataTrackingId';
 import { DistributiveOmit } from '../../types';
+/**
+ * Props for the Combobox component
+ * @property {Item[]} items - Array of items to display in the combobox
+ * @property {(item: Item | null) => string} itemToString - Function to convert item to string
+ * @property {(item: Item) => string | number} itemToKey - Function to get unique key for item
+ * @property {Item | null} [selectedItem] - Currently selected item
+ * @property {Item[] | null} [selectedItems] - Currently selected items for multiple selection
+ * @property {boolean} [multiple] - Enable multiple selection mode
+ * @property {boolean} [loading] - Show loading state
+ * @property {Object} [filterOptions] - Options for filtering items
+ * @property {boolean} [disableFilter] - Disable automatic filtering
+ * @property {string} [groupBy] - Property to group items by
+ * @property {(groupValue: any) => string} [groupToString] - Function to convert group value to string
+ * @property {(a: any, b: any) => number} [groupSorter] - Function to sort groups
+ * @extends DataTrackingId
+ */
 export type ComboboxProps<Item> = CoreComboboxProps<Item>;
+/**
+ * Props for the ComboboxSelect component
+ * @property {Item[]} items - Array of items to display in the select
+ * @property {(item: Item | null) => string} itemToString - Function to convert item to string
+ * @property {(item: Item) => string | number} itemToKey - Function to get unique key for item
+ * @property {Item | null} [selectedItem] - Currently selected item
+ * @property {Item[] | null} [selectedItems] - Currently selected items for multiple selection
+ * @property {boolean} [multiple] - Enable multiple selection mode
+ * @property {boolean} [loading] - Show loading state
+ * @property {string} [groupBy] - Property to group items by
+ * @property {(groupValue: any) => string} [groupToString] - Function to convert group value to string
+ * @extends DataTrackingId
+ */
 export type ComboboxSelectProps<Item> = CoreComboboxSelectProps<Item>;
+/**
+ * Props for the ComboboxContent component
+ * @property {({ items: Item[], inputValue: string }) => ReactNode} children - Function that receives items and input value and renders content
+ * @property {boolean} [disablePopover] - Whether to disable popover behavior and render inline
+ */
+export type ComboboxContentProps<Item> = CoreComboboxContentProps<Item>;
+/**
+ * Props for the ComboboxSearchField component
+ * @property {string} label - Label for the search field
+ * @property {string} [placeholder] - Placeholder text
+ * @property {string} [description] - Helper text description
+ * @property {string} [moreInfo] - Additional information text
+ * @property {boolean} [required] - Mark field as required
+ * @property {string | { icon: IconProps } | { avatar: AvatarProps }} [prefix] - Prefix content (string, icon, or avatar)
+ * @property {(item: Item) => Partial<ChipProps>} [selectedItemProps] - Allows Combobox to display custom-colored Chips
+ * @extends DataTrackingId
+ */
 export type ComboboxSearchFieldProps = DistributiveOmit<CoreComboboxSearchFieldProps, "prefix"> & DataTrackingId & {
     prefix?: string | {
         icon: DistributiveOmit<CoreIconProps, "size">;
@@ -10,6 +56,17 @@ export type ComboboxSearchFieldProps = DistributiveOmit<CoreComboboxSearchFieldP
         avatar: DistributiveOmit<CoreAvatarProps, "size">;
     };
 };
+/**
+ * Props for the ComboboxSelectTrigger component
+ * @property {string} label - Label for the select trigger
+ * @property {string} [placeholder] - Placeholder text
+ * @property {string} [description] - Helper text description
+ * @property {string} [moreInfo] - Additional information text
+ * @property {boolean} [required] - Mark field as required
+ * @property {string | { icon: IconProps } | { avatar: AvatarProps }} [prefix] - Prefix content (string, icon, or avatar)
+ * @property {(item: Item) => Partial<ChipProps>} [selectedItemProps] - Allows Combobox to display custom-colored Chips
+ * @extends DataTrackingId
+ */
 export type ComboboxSelectTriggerProps = DistributiveOmit<CoreComboboxSelectTriggerProps, "prefix"> & DataTrackingId & {
     prefix?: string | {
         icon: DistributiveOmit<CoreIconProps, "size">;
@@ -17,27 +74,410 @@ export type ComboboxSelectTriggerProps = DistributiveOmit<CoreComboboxSelectTrig
         avatar: DistributiveOmit<CoreAvatarProps, "size">;
     };
 };
-export type ComboboxContentProps<Item> = CoreComboboxContentProps<Item>;
+/**
+ * Props for the ComboboxList component
+ * @property {ReactNode} children - List items to render
+ */
 export type ComboboxListProps = CoreComboboxListProps;
+/**
+ * Props for the ComboboxItem component
+ * @property {Item} item - The item to render
+ * @property {number} index - Index of the item in the list
+ * @property {ReactNode} children - Content to render for the item
+ * @property {boolean} [disabled] - Disable the item
+ * @extends DataTrackingId
+ */
 export type ComboboxItemProps<Item> = CoreComboboxItemProps<Item> & DataTrackingId;
+/**
+ * Props for the ComboboxItemAddNew component
+ * @property {(inputValue: string) => void} onSelection - Callback when "Add New" is selected
+ * @property {ReactNode} children - Content to render for the "Add New" item
+ * @property {boolean} [disabled] - Disable the "Add New" item
+ * @extends DataTrackingId
+ */
 export type ComboboxItemAddNewProps<Item> = CoreComboboxItemAddNewProps<Item> & DataTrackingId;
+/**
+ * Props for the ComboboxEmpty component
+ * @property {ReactNode} children - Content to render when no items are available
+ */
 export type ComboboxEmptyProps = CoreComboboxEmptyProps;
 export declare const ComboboxElement: <Item = any>(props: ComboboxProps<Item>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * ComboboxSelect component for selecting items from a predefined list.
+ *
+ * Features:
+ * - Single and multiple item selection from predefined options
+ * - Dropdown-style selection interface
+ * - Grouping support with custom group labels and sorting
+ * - Loading states with spinner indicators
+ * - Disabled and read-only states
+ * - Customizable popover behavior and positioning
+ * - Full accessibility support with ARIA attributes
+ * - Keyboard navigation support
+ * - Layout utility props for positioning and spacing
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <Combobox.Select
+ *   items={items}
+ *   itemToString={(item) => item.name}
+ *   onChange={setSelectedItem}
+ * >
+ *   <Combobox.SelectTrigger label="Select an item" />
+ *   <Combobox.Content>
+ *     {({ items }) => (
+ *       <Combobox.List>
+ *         {items.map((item, i) => (
+ *           <Combobox.Item key={item.id} item={item} index={i}>
+ *             {item.name}
+ *           </Combobox.Item>
+ *         ))}
+ *       </Combobox.List>
+ *     )}
+ *   </Combobox.Content>
+ * </Combobox.Select>
+ */
 export declare const ComboboxSelect: <Item = any>(props: ComboboxSelectProps<Item>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * ComboboxContent component for rendering the content area of a combobox.
+ *
+ * Features:
+ * - Supports both popover and inline rendering modes
+ * - Provides render props pattern for flexible content rendering
+ * - Handles grouped items with proper ARIA labels
+ * - Integrates with combobox state management
+ * - Supports custom styling and layout
+ * - Manages focus and blur events for popover behavior
+ *
+ * @example
+ * <Combobox.Content>
+ *   {({ items }) => (
+ *     <Combobox.List>
+ *       {items.map((item, index) => (
+ *         <Combobox.Item key={item.id} item={item} index={index}>
+ *           {item.name}
+ *         </Combobox.Item>
+ *       ))}
+ *     </Combobox.List>
+ *   )}
+ * </Combobox.Content>
+ */
+export declare const ComboboxContent: <Item = any>(props: ComboboxContentProps<Item>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * ComboboxSearchField component for the search input field.
+ *
+ * Features:
+ * - Search input with clear button functionality
+ * - Supports multiple selection with chip display
+ * - Handles keyboard navigation and accessibility
+ * - Integrates with combobox state management
+ * - Supports custom styling and layout
+ * - Manages focus and blur events
+ * - Enhanced prefix support for icons and avatars
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <Combobox.SearchField
+ *   label="Search users"
+ *   placeholder="Type to search..."
+ *   prefix={{ icon: { svg: SearchIcon } }}
+ * />
+ */
 export declare const ComboboxSearchField: ({ prefix: prefixProp, ...props }: ComboboxSearchFieldProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * ComboboxSelectTrigger component for the select trigger field.
+ *
+ * Features:
+ * - Select input with dropdown trigger
+ * - Supports single selection display
+ * - Handles keyboard navigation and accessibility
+ * - Integrates with combobox state management
+ * - Supports custom styling and layout
+ * - Manages focus and blur events
+ * - Enhanced prefix support for icons and avatars
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <Combobox.SelectTrigger
+ *   label="Select user"
+ *   placeholder="Choose a user..."
+ *   prefix={{ avatar: { name: "User" } }}
+ * />
+ */
 export declare const ComboboxSelectTrigger: ({ prefix: prefixProp, ...props }: ComboboxSelectTriggerProps) => import("react/jsx-runtime").JSX.Element;
-export declare const ComboboxContent: <Item = any>(props: ComboboxContentProps<Item>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * ComboboxList component for rendering the list of items.
+ *
+ * Features:
+ * - Renders list of items with proper accessibility
+ * - Supports both single and multiple selection modes
+ * - Loading state with spinner
+ * - Empty state handling
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <Combobox.List>
+ *   {items.map((item, i) => (
+ *     <Combobox.Item key={item.id} item={item} index={i}>
+ *       {item.name}
+ *     </Combobox.Item>
+ *   ))}
+ * </Combobox.List>
+ */
 export declare const ComboboxList: <Item = any>(props: ComboboxListProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * ComboboxItem component for rendering individual items in the list.
+ *
+ * Features:
+ * - Individual item rendering with proper accessibility
+ * - Support for disabled state
+ * - Custom content rendering
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <Combobox.Item item={item} index={index}>
+ *   <Flex direction="column">
+ *     <Text>{item.name}</Text>
+ *     <Text size="small" subdued>{item.description}</Text>
+ *   </Flex>
+ * </Combobox.Item>
+ */
 export declare const ComboboxItem: <Item = any>(props: ComboboxItemProps<Item>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * ComboboxItemAddNew component for rendering an "Add New" option.
+ *
+ * Features:
+ * - "Add New" option that appears when no exact match is found
+ * - Customizable content rendering
+ * - Callback when selected
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <Combobox.ItemAddNew onSelection={(inputValue) => addNewItem(inputValue)}>
+ *   Add "{inputValue}" as new item
+ * </Combobox.ItemAddNew>
+ */
 export declare const ComboboxItemAddNew: <Item = any>(props: ComboboxItemAddNewProps<Item>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * ComboboxEmpty component for rendering content when no items are available.
+ *
+ * Features:
+ * - Renders content when list is empty
+ * - Customizable empty state message
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <Combobox.Empty>
+ *   <Text>No items found. Try adjusting your search.</Text>
+ * </Combobox.Empty>
+ */
 export declare const ComboboxEmpty: <Item = any>(props: ComboboxEmptyProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Combobox component for selecting items with search and filtering capabilities.
+ *
+ * Features:
+ * - Single and multiple item selection
+ * - Search and filtering with configurable options
+ * - Optional "Add New" item functionality
+ * - Grouping support with custom group labels and sorting
+ * - Loading states with spinner indicators
+ * - Disabled and read-only states
+ * - Customizable popover behavior and positioning
+ * - Full accessibility support with ARIA attributes
+ * - Keyboard navigation support
+ * - Layout utility props for positioning and spacing
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <Combobox
+ *   items={items}
+ *   itemToString={(item) => item.name}
+ *   onChange={setSelectedItem}
+ *   filterOptions={{ keys: ["name"] }}
+ * >
+ *   <Combobox.SearchField label="Select an item" />
+ *   <Combobox.Content>
+ *     {({ items }) => (
+ *       <Combobox.List>
+ *         {items.map((item, i) => (
+ *           <Combobox.Item key={item.id} item={item} index={i}>
+ *             {item.name}
+ *           </Combobox.Item>
+ *         ))}
+ *       </Combobox.List>
+ *     )}
+ *   </Combobox.Content>
+ * </Combobox>
+ */
 export declare const Combobox: (<Item = any>(props: ComboboxProps<Item>) => import("react/jsx-runtime").JSX.Element) & {
+    /**
+     * ComboboxSelect component for selecting items from a predefined list.
+     *
+     * Features:
+     * - Single and multiple item selection from predefined options
+     * - Dropdown-style selection interface
+     * - Grouping support with custom group labels and sorting
+     * - Loading states with spinner indicators
+     * - Disabled and read-only states
+     * - Customizable popover behavior and positioning
+     * - Full accessibility support with ARIA attributes
+     * - Keyboard navigation support
+     * - Layout utility props for positioning and spacing
+     * - Automatic tracking ID generation for analytics
+     *
+     * @example
+     * <Combobox.Select
+     *   items={items}
+     *   itemToString={(item) => item.name}
+     *   onChange={setSelectedItem}
+     * >
+     *   <Combobox.SelectTrigger label="Select an item" />
+     *   <Combobox.Content>
+     *     {({ items }) => (
+     *       <Combobox.List>
+     *         {items.map((item, i) => (
+     *           <Combobox.Item key={item.id} item={item} index={i}>
+     *             {item.name}
+     *           </Combobox.Item>
+     *         ))}
+     *       </Combobox.List>
+     *     )}
+     *   </Combobox.Content>
+     * </Combobox.Select>
+     */
     Select: <Item = any>(props: ComboboxSelectProps<Item>) => import("react/jsx-runtime").JSX.Element;
+    /**
+     * ComboboxSearchField component for the search input field.
+     *
+     * Features:
+     * - Search input with clear button functionality
+     * - Supports multiple selection with chip display
+     * - Handles keyboard navigation and accessibility
+     * - Integrates with combobox state management
+     * - Supports custom styling and layout
+     * - Manages focus and blur events
+     * - Enhanced prefix support for icons and avatars
+     * - Automatic tracking ID generation for analytics
+     *
+     * @example
+     * <Combobox.SearchField
+     *   label="Search users"
+     *   placeholder="Type to search..."
+     *   prefix={{ icon: { svg: SearchIcon } }}
+     * />
+     */
     SearchField: ({ prefix: prefixProp, ...props }: ComboboxSearchFieldProps) => import("react/jsx-runtime").JSX.Element;
+    /**
+     * ComboboxSelectTrigger component for the select trigger field.
+     *
+     * Features:
+     * - Select input with dropdown trigger
+     * - Supports single selection display
+     * - Handles keyboard navigation and accessibility
+     * - Integrates with combobox state management
+     * - Supports custom styling and layout
+     * - Manages focus and blur events
+     * - Enhanced prefix support for icons and avatars
+     * - Automatic tracking ID generation for analytics
+     *
+     * @example
+     * <Combobox.SelectTrigger
+     *   label="Select user"
+     *   placeholder="Choose a user..."
+     *   prefix={{ avatar: { name: "User" } }}
+     * />
+     */
     SelectTrigger: ({ prefix: prefixProp, ...props }: ComboboxSelectTriggerProps) => import("react/jsx-runtime").JSX.Element;
+    /**
+     * ComboboxContent component for rendering the content area of a combobox.
+     *
+     * Features:
+     * - Supports both popover and inline rendering modes
+     * - Provides render props pattern for flexible content rendering
+     * - Handles grouped items with proper ARIA labels
+     * - Integrates with combobox state management
+     * - Supports custom styling and layout
+     * - Manages focus and blur events for popover behavior
+     *
+     * @example
+     * <Combobox.Content>
+     *   {({ items }) => (
+     *     <Combobox.List>
+     *       {items.map((item, index) => (
+     *         <Combobox.Item key={item.id} item={item} index={index}>
+     *           {item.name}
+     *         </Combobox.Item>
+     *       ))}
+     *     </Combobox.List>
+     *   )}
+     * </Combobox.Content>
+     */
     Content: <Item = any>(props: ComboboxContentProps<Item>) => import("react/jsx-runtime").JSX.Element;
+    /**
+     * ComboboxList component for rendering the list of items.
+     *
+     * Features:
+     * - Renders list of items with proper accessibility
+     * - Supports both single and multiple selection modes
+     * - Loading state with spinner
+     * - Empty state handling
+     * - Automatic tracking ID generation for analytics
+     *
+     * @example
+     * <Combobox.List>
+     *   {items.map((item, i) => (
+     *     <Combobox.Item key={item.id} item={item} index={i}>
+     *       {item.name}
+     *     </Combobox.Item>
+     *   ))}
+     * </Combobox.List>
+     */
     List: <Item = any>(props: ComboboxListProps) => import("react/jsx-runtime").JSX.Element;
+    /**
+     * ComboboxItem component for rendering individual items in the list.
+     *
+     * Features:
+     * - Individual item rendering with proper accessibility
+     * - Support for disabled state
+     * - Custom content rendering
+     * - Automatic tracking ID generation for analytics
+     *
+     * @example
+     * <Combobox.Item item={item} index={index}>
+     *   <Flex direction="column">
+     *     <Text>{item.name}</Text>
+     *     <Text size="small" subdued>{item.description}</Text>
+     *   </Flex>
+     * </Combobox.Item>
+     */
     Item: <Item = any>(props: ComboboxItemProps<Item>) => import("react/jsx-runtime").JSX.Element;
+    /**
+     * ComboboxItemAddNew component for rendering an "Add New" option.
+     *
+     * Features:
+     * - "Add New" option that appears when no exact match is found
+     * - Customizable content rendering
+     * - Callback when selected
+     * - Automatic tracking ID generation for analytics
+     *
+     * @example
+     * <Combobox.ItemAddNew onSelection={(inputValue) => addNewItem(inputValue)}>
+     *   Add "{inputValue}" as new item
+     * </Combobox.ItemAddNew>
+     */
     ItemAddNew: <Item = any>(props: ComboboxItemAddNewProps<Item>) => import("react/jsx-runtime").JSX.Element;
+    /**
+     * ComboboxEmpty component for rendering content when no items are available.
+     *
+     * Features:
+     * - Renders content when list is empty
+     * - Customizable empty state message
+     * - Automatic tracking ID generation for analytics
+     *
+     * @example
+     * <Combobox.Empty>
+     *   <Text>No items found. Try adjusting your search.</Text>
+     * </Combobox.Empty>
+     */
     Empty: <Item = any>(props: ComboboxEmptyProps) => import("react/jsx-runtime").JSX.Element;
 };

package/dist/components/DateField/DateField.d.ts

@@ -1,7 +1,72 @@
 import { DateFieldProps as CoreDateFieldProps, DateSelect as CoreDateSelect, DateRangeSelect as CoreDateRangeSelect } from '@servicetitan/hammer-react';
+/**
+ * Props for the DateField component
+ * @property {string} label - Label for the date field
+ * @property {string} [placeholder] - Placeholder text for the input
+ * @property {string} [description] - Helper text description
+ * @property {string} [moreInfo] - Additional information text
+ * @property {string} [format] - Date format (MM/dd/yyyy or dd/MM/yyyy)
+ * @property {boolean} [range] - Enable date range selection mode
+ * @property {Date} [minDate] - Minimum selectable date
+ * @property {Date} [maxDate] - Maximum selectable date
+ * @property {Date[]} [unavailableDates] - Dates that cannot be selected
+ * @property {Locale} [locale] - Locale for date formatting
+ * @property {IanaZone} [defaultTimeZone] - Default timezone for date operations
+ * @property {boolean} [openCalendar] - Whether to open calendar on mount
+ * @property {boolean} [disableHint] - Whether to disable the format hint
+ * @property {string} [value] - Controlled value for the date field
+ * @property {string} [defaultValue] - Default value for the date field
+ * @property {(event: ChangeEvent<HTMLInputElement>, data: DateSelect | DateRangeSelect) => void} [onChange] - Callback when date selection changes
+ * @extends DataTrackingId
+ */
 export type DateFieldProps = CoreDateFieldProps & {
     ["data-tracking-id"]?: string;
 };
+/**
+ * Data structure for a single date selection
+ * @property {string} value - The formatted date string value
+ * @property {string | null | undefined} date - The ISO date string or null if invalid
+ * @property {boolean} isValid - Whether the date is valid according to constraints
+ */
 export type DateSelect = CoreDateSelect;
+/**
+ * Data structure for a date range selection
+ * @property {DateSelect} [start] - The start date selection
+ * @property {DateSelect} [end] - The end date selection
+ * @property {string} value - The combined formatted range string
+ */
 export type DateRangeSelect = CoreDateRangeSelect;
+/**
+ * DateField component for selecting dates with calendar popup and input validation
+ *
+ * Features:
+ * - Single date and date range selection modes
+ * - Calendar popup with keyboard navigation
+ * - Input mask validation with format hints
+ * - Configurable date formats (MM/dd/yyyy, dd/MM/yyyy)
+ * - Min/max date constraints and unavailable dates
+ * - Locale and timezone support
+ * - Accessibility with ARIA attributes
+ * - Keyboard navigation and focus management
+ * - Popover and legacy fallback modes
+ * - Automatic tracking ID generation for analytics
+ *
+ * @param props - The component props
+ * @param ref - Forwarded ref to the input element
+ * @returns A date field component with calendar integration
+ *
+ * @example
+ * <DateField
+ *   label="Select Date"
+ *   format="MM/dd/yyyy"
+ *   onChange={(event, data) => console.log(data.date)}
+ * />
+ *
+ * @example
+ * <DateField
+ *   label="Date Range"
+ *   range={true}
+ *   onChange={(event, data) => console.log(data.start?.date, data.end?.date)}
+ * />
+ */
 export declare const DateField: import('react').ForwardRefExoticComponent<DateFieldProps & import('react').RefAttributes<HTMLInputElement>>;

package/dist/components/DaysOfTheWeek/DaysOfTheWeek.d.ts

@@ -1,7 +1,45 @@
 import { DaysOfTheWeekProps as CoreDaysOfTheWeekProps } from '@servicetitan/hammer-react';
-export type DaysOfTheWeekProps = CoreDaysOfTheWeekProps & {
-    ["data-tracking-id"]?: string;
-};
-export declare const DaysOfTheWeek: import('react').ForwardRefExoticComponent<CoreDaysOfTheWeekProps & {
-    "data-tracking-id"?: string;
-} & import('react').RefAttributes<HTMLDivElement>>;
+import { DataTrackingId } from '../../types/DataTrackingId';
+/**
+ * Props for the DaysOfTheWeek component
+ * @property {number[]} [selectedDays] - The selected days (1-7, where 1 is Monday and 7 is Sunday)
+ * @property {(selectedDays: number[]) => void} [onChange] - Callback fired when the selection changes
+ * @property {boolean | number[]} [disabled] - Whether the component is disabled. Can be a boolean to disable all days, or an array of day numbers (1-7) to disable specific days
+ * @property {number} [firstDay] - The first day of the week (1-7, where 1 is Monday and 7 is Sunday)
+ * @default 1
+ * @property {ReactElement | string} [hint] - Hint text or element to display above the component
+ * @property {string} [id] - ID for the component
+ * @property {ReactElement | string} [description] - Description text or element to display below the component
+ * @property {ReactElement | string} [errorMessage] - Error message to display when there is an error
+ * @property {AriaAttributes['aria-live']} [errorAriaLive] - aria-live for the error message
+ * @default assertive
+ * @property {LabelProps['children']} [label] - Label text or element
+ * @property {boolean} [required] - Whether the field is required
+ * @property {LabelProps['moreInfo']} [moreInfo] - Additional info to display in a tooltip next to the label
+ * @property {Omit<LabelProps, 'children' | 'moreInfo' | 'required' | 'id' | 'htmlFor'>} [labelProps] - Additional props to pass to the Label component
+ * @extends DataTrackingId
+ */
+export type DaysOfTheWeekProps = CoreDaysOfTheWeekProps & DataTrackingId;
+/**
+ * DaysOfTheWeek component for selecting multiple days of the week.
+ *
+ * Features:
+ * - Displays days of the week as toggleable buttons
+ * - Supports custom first day of the week (Monday-Sunday)
+ * - Individual day selection and deselection
+ * - Optional label, hint, description, and error messaging
+ * - Full accessibility support with ARIA attributes
+ * - Tooltips showing full day names on hover
+ * - Responsive design with flexible layout
+ * - Support for disabling specific days or the entire component
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <DaysOfTheWeek
+ *   selectedDays={[2, 4, 6]}
+ *   onChange={(days) => console.log('Selected days:', days)}
+ *   label="Working Days"
+ *   firstDay={1}
+ * />
+ */
+export declare const DaysOfTheWeek: import('react').ForwardRefExoticComponent<CoreDaysOfTheWeekProps & DataTrackingId & import('react').RefAttributes<HTMLDivElement>>;