@servicetitan/anvil2 1.37.2 → 1.39.0

package/dist/assets/icons/st/insurance_work_queue.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M3.072 6.72c-.48 0-.96.384-.96.96v12.48c0 1.056.864 1.92 1.92 1.92h12.48c.48 0 .96-.48.96-.96s-.48-.96-.96-.96H4.992c-.48 0-.96-.48-.96-.96V7.68c0-.576-.384-.96-.96-.96m12.883 4.723c0 .48-.393.874-.873.874h-.576v.576c0 .48-.394.873-.874.873a.877.877 0 0 1-.874-.873v-.576h-.576a.877.877 0 0 1-.873-.874c0-.48.393-.864.873-.864h.576v-.585c0-.48.394-.864.874-.864s.874.384.874.864v.585h.576c.48 0 .873.384.873.864"/><path d="M19.392 2.88H7.872c-1.056 0-1.92.864-1.92 1.92v11.52c0 1.056.864 1.92 1.92 1.92h11.52c1.056 0 1.92-.864 1.92-1.92V4.8c0-1.056-.864-1.92-1.92-1.92m-.125 6.634a.47.47 0 0 1-.355.201.5.5 0 0 1-.394-.105l-.556-.404v6.01c0 .298-.106.557-.317.768s-.461.317-.768.317h-6.5c-.297 0-.556-.106-.768-.317a1.05 1.05 0 0 1-.316-.768v-6.01l-.538.423a.56.56 0 0 1-.403.105.46.46 0 0 1-.355-.22.5.5 0 0 1-.096-.404.45.45 0 0 1 .21-.345L12.97 5.04a.8.8 0 0 1 .317-.163 1.1 1.1 0 0 1 .691 0 .9.9 0 0 1 .317.163l4.868 3.725a.44.44 0 0 1 .201.345.5.5 0 0 1-.096.404"/></svg>

package/dist/assets/icons/st/production_work_queue.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M3 6.07c-.55 0-1 .45-1 1v13c0 1.1.9 2 2 2h13c.55 0 1-.45 1-1s-.45-1-1-1H5c-.55 0-1-.45-1-1v-12c0-.55-.45-1-1-1"/><path d="M20 2.07H8c-1.1 0-2 .9-2 2v12c0 1.1.9 2 2 2h12c1.1 0 2-.9 2-2v-12c0-1.1-.9-2-2-2m-1.09 8.25c-.5.5-1.13.84-1.82.99s-1.4.09-2.06-.16l-4.49 4.49c-.13.14-.3.25-.48.32-.17.08-.37.11-.56.11-.2 0-.39-.03-.57-.11-.18-.07-.34-.18-.48-.32-.13-.14-.24-.3-.32-.48a1.5 1.5 0 0 1 0-1.13c.08-.18.19-.34.32-.48l4.47-4.47c-.52-1.32-.25-2.87.81-3.94a3.69 3.69 0 0 1 4.2-.7l-2.05 2.05c-.22.22-.22.57 0 .79l.9.9c.22.22.57.22.79 0l2.05-2.05c.66 1.37.42 3.06-.71 4.19"/></svg>

package/dist/assets/icons/st.ts

@@ -72,6 +72,7 @@ export { default as icon_gnav_tasks_active } from "./st/gnav_tasks_active.svg";
 export { default as icon_gnav_tasks_inactive } from "./st/gnav_tasks_inactive.svg";
 export { default as icon_gnav_titan_advisor_active } from "./st/gnav_titan_advisor_active.svg";
 export { default as icon_gnav_titan_advisor_inactive } from "./st/gnav_titan_advisor_inactive.svg";
+export { default as icon_insurance_work_queue } from "./st/insurance_work_queue.svg";
 export { default as icon_invoice } from "./st/invoice.svg";
 export { default as icon_job } from "./st/job.svg";
 export { default as icon_leads } from "./st/leads.svg";
@@ -82,6 +83,7 @@ export { default as icon_payment } from "./st/payment.svg";
 export { default as icon_preview_file } from "./st/preview_file.svg";
 export { default as icon_pro_tip } from "./st/pro_tip.svg";
 export { default as icon_production_manager } from "./st/production_manager.svg";
+export { default as icon_production_work_queue } from "./st/production_work_queue.svg";
 export { default as icon_project } from "./st/project.svg";
 export { default as icon_proposal } from "./st/proposal.svg";
 export { default as icon_purchase_order } from "./st/purchase_order.svg";

package/dist/components/Alert/Alert.d.ts

@@ -1,6 +1,43 @@
 import { AlertProps as CoreAlertProps } from '@servicetitan/hammer-react';
 import { DataTrackingId } from '../../types/DataTrackingId';
+/**
+ * Props for the Alert component
+ * @property {string} title - The title text displayed in the alert
+ * @property {Status} [status] - The visual style of the alert (info, success, warning, danger)
+ * @extends ComponentPropsWithoutRef<"div">
+ * @extends LayoutUtilProps
+ * @extends OnCloseProps
+ * @extends DataTrackingId
+ */
 export type AlertProps = CoreAlertProps & DataTrackingId;
+/**
+ * Alert component for displaying important messages to users.
+ *
+ * Features:
+ * - Supports different visual styles (info, success, warning, danger)
+ * - Optional close button for dismissible alerts
+ * - Customizable title and content
+ * - Accessible with proper ARIA roles
+ * - Includes status-specific icons
+ * - Supports layout utilities for positioning and spacing
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <Alert
+ *   title="System Update"
+ *   onClose={() => console.log('Alert closed')}
+ * >
+ *   The system will be updated tonight.
+ * </Alert>
+ *
+ * @example
+ * <Alert
+ *   status="success"
+ *   title="Operation Complete"
+ * >
+ *   Your changes have been saved successfully.
+ * </Alert>
+ */
 export declare const Alert: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('@servicetitan/hammer-react').LayoutUtilProps & import('@servicetitan/hammer-react').OnCloseProps & {
     status?: import('@servicetitan/hammer-react').Status;
     title: string;

package/dist/components/Announcement/Announcement.d.ts

@@ -1,6 +1,43 @@
 import { AnnouncementProps as CoreAnnouncementProps } from '@servicetitan/hammer-react';
 import { DataTrackingId } from '../../types/DataTrackingId';
+/**
+ * Props for the Announcement component
+ * @property {string} title - The title text displayed in the announcement
+ * @property {Status} [status] - The visual style of the announcement (info, success, warning, danger)
+ * @extends ComponentPropsWithoutRef<"div">
+ * @extends Omit<LayoutUtilProps, "flex" | "flexBasis" | "flexGrow" | "flexShrink">
+ * @extends OnCloseProps
+ * @extends DataTrackingId
+ */
 export type AnnouncementProps = CoreAnnouncementProps & DataTrackingId;
+/**
+ * Announcement component for displaying important messages to users.
+ *
+ * Features:
+ * - Supports different visual styles (info, success, warning, danger)
+ * - Optional close button for dismissible announcements
+ * - Customizable title and content
+ * - Accessible with proper ARIA roles
+ * - Includes status-specific icons
+ * - Supports layout utilities for positioning and spacing
+ * - Includes data tracking capabilities
+ *
+ * @example
+ * <Announcement
+ *   title="New Feature"
+ *   onClose={() => console.log('Announcement closed')}
+ * >
+ *   Check out our latest feature!
+ * </Announcement>
+ *
+ * @example
+ * <Announcement
+ *   status="warning"
+ *   title="Maintenance Notice"
+ * >
+ *   Scheduled maintenance will begin in 30 minutes.
+ * </Announcement>
+ */
 export declare const Announcement: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & Omit<import('@servicetitan/hammer-react').LayoutUtilProps, "flex" | "flexGrow" | "flexShrink" | "flexBasis"> & import('@servicetitan/hammer-react').OnCloseProps & {
     status?: import('@servicetitan/hammer-react').Status;
     title: string;

package/dist/components/Avatar/Avatar.d.ts

@@ -1,10 +1,83 @@
 import { AvatarProps as CoreAvatarProps, AvatarGroupProps as CoreAvatarGroupProps } from '@servicetitan/hammer-react';
+/**
+ * Props for the Avatar component
+ * @property {string} name - Full name used for alt text and screen reader
+ * @property {string} [color] - Custom color of the Avatar
+ * @property {string} [image] - Image source to be used for Avatar
+ * @property {"small" | "medium" | "large"} [size] - Size of the Avatar
+ * @property {"online" | "offline"} [status] - Online status of the Avatar
+ * @extends ComponentPropsWithoutRef<"span">
+ * @extends Omit<AvatarBaseProps, "initials">
+ * @extends Omit<LayoutUtilProps, "flex" | "flexBasis" | "flexGrow" | "flexShrink">
+ * @extends DataTrackingId
+ */
 export type AvatarProps = CoreAvatarProps;
+/**
+ * Props for the AvatarGroup component
+ * @property {number} [max] - Maximum number of avatars to display before truncating
+ * @extends LayoutUtilProps
+ * @extends ComponentPropsWithoutRef<"span">
+ * @extends DataTrackingId
+ */
 export type AvatarGroupProps = CoreAvatarGroupProps;
+/**
+ * AvatarGroup component for displaying multiple avatars in a group.
+ *
+ * Features:
+ * - Displays multiple avatars in a stacked layout
+ * - Handles overflow with a count indicator
+ * - Maintains consistent sizing across all avatars
+ * - Supports custom styling and layout
+ * - Automatically adjusts z-index for proper stacking
+ * - Fully accessible with screen reader support
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <Avatar.Group max={3}>
+ *   <Avatar name="John Doe" />
+ *   <Avatar name="Jane Smith" />
+ *   <Avatar name="Bob Johnson" />
+ *   <Avatar name="Alice Brown" />
+ * </Avatar.Group>
+ */
 export declare const AvatarGroup: import('react').ForwardRefExoticComponent<import('@servicetitan/hammer-react').LayoutUtilProps & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & {
     max?: number;
 } & import('react').RefAttributes<HTMLSpanElement>>;
+/**
+ * Avatar component for displaying user avatars with initials or images.
+ *
+ * Features:
+ * - Displays user initials when no image is provided
+ * - Supports custom colors and sizes
+ * - Shows online/offline status
+ * - Fully accessible with screen reader support
+ * - Automatic image fallback handling
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <Avatar name="John Doe" size="medium" status="online" />
+ */
 export declare const Avatar: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & Omit<import('@servicetitan/hammer-react/dist/components/Avatar/AvatarBase').AvatarBaseProps, "initials"> & Omit<import('@servicetitan/hammer-react').LayoutUtilProps, "flex" | "flexGrow" | "flexShrink" | "flexBasis"> & import('react').RefAttributes<HTMLSpanElement>> & {
+    /**
+     * AvatarGroup component for displaying multiple avatars in a group.
+     *
+     * Features:
+     * - Displays multiple avatars in a stacked layout
+     * - Handles overflow with a count indicator
+     * - Maintains consistent sizing across all avatars
+     * - Supports custom styling and layout
+     * - Automatically adjusts z-index for proper stacking
+     * - Fully accessible with screen reader support
+     * - Automatic tracking ID generation for analytics
+     *
+     * @example
+     * <Avatar.Group max={3}>
+     *   <Avatar name="John Doe" />
+     *   <Avatar name="Jane Smith" />
+     *   <Avatar name="Bob Johnson" />
+     *   <Avatar name="Alice Brown" />
+     * </Avatar.Group>
+     */
     Group: import('react').ForwardRefExoticComponent<import('@servicetitan/hammer-react').LayoutUtilProps & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & {
         max?: number;
     } & import('react').RefAttributes<HTMLSpanElement>>;

package/dist/components/Badge/Badge.d.ts

@@ -1,5 +1,32 @@
 import { BadgeProps as CoreBadgeProps } from '@servicetitan/hammer-react';
+/**
+ * Props for the Badge component
+ * @property {Object} [offset] - Optional offset configuration for badge positioning
+ * @property {string} [offset.x] - Horizontal offset from the default position
+ * @property {string} [offset.y] - Vertical offset from the default position
+ * @extends ComponentPropsWithoutRef<"sup">
+ * @extends Omit<LayoutUtilProps, "flex" | "flexBasis" | "flexGrow" | "flexShrink">
+ * @extends DataTrackingId
+ */
 export type BadgeProps = CoreBadgeProps;
+/**
+ * Badge component for displaying small status indicators or counts.
+ *
+ * Features:
+ * - Positioned as a superscript element
+ * - Customizable offset positioning
+ * - Screen reader support with aria-label
+ * - Empty state styling when no content
+ * - Supports layout utilities for positioning
+ * - Accessible with proper ARIA roles
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <Button>
+ *   Notifications
+ *   <Badge aria-label="3 new messages">3</Badge>
+ * </Button>
+ */
 export declare const Badge: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & Omit<import('@servicetitan/hammer-react').LayoutUtilProps, "flex" | "flexGrow" | "flexShrink" | "flexBasis"> & {
     offset?: {
         x?: string;

package/dist/components/Breadcrumbs/Breadcrumbs.d.ts

@@ -1,12 +1,51 @@
 import { BreadcrumbsLinkProps as CoreBreadcrumbsLinkProps, BreadcrumbsProps as CoreBreadcrumbsProps } from '@servicetitan/hammer-react';
+/**
+ * Props for the Breadcrumbs component
+ * @property {ReactElement<BreadcrumbsLinkProps> | ReactElement<BreadcrumbsLinkProps>[]} children - Breadcrumb links to display. The last child will be rendered as non-clickable text.
+ * @extends ComponentPropsWithoutRef<"nav">
+ * @extends LayoutUtilProps
+ */
 export type BreadcrumbsProps = CoreBreadcrumbsProps;
 export type BreadcrumbsLinkProps = CoreBreadcrumbsLinkProps;
 export declare const BreadcrumbsElement: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & import('@servicetitan/hammer-react').LayoutUtilProps & {
     children: import('react').ReactElement<CoreBreadcrumbsLinkProps> | import('react').ReactElement<CoreBreadcrumbsLinkProps>[];
 } & import('react').RefAttributes<HTMLScriptElement>>;
 export declare const BreadcrumbsLink: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref"> & import('@servicetitan/hammer-react').LayoutUtilProps & import('react').RefAttributes<HTMLAnchorElement>>;
+/**
+ * Breadcrumbs component for displaying navigation hierarchy.
+ *
+ * Features:
+ * - Displays a series of navigation links with chevron separators
+ * - Automatically renders the last item as non-clickable text
+ * - Includes proper ARIA labeling for accessibility
+ * - Supports layout utilities for positioning and spacing
+ * - Uses chevron icons as visual separators between links
+ * - Responsive design with flexbox layout
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <Breadcrumbs>
+ *   <Breadcrumbs.Link href="/home">Home</Breadcrumbs.Link>
+ *   <Breadcrumbs.Link href="/products">Products</Breadcrumbs.Link>
+ *   <Breadcrumbs.Link href="/electronics">Electronics</Breadcrumbs.Link>
+ * </Breadcrumbs>
+ */
 export declare const Breadcrumbs: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & import('@servicetitan/hammer-react').LayoutUtilProps & {
     children: import('react').ReactElement<CoreBreadcrumbsLinkProps> | import('react').ReactElement<CoreBreadcrumbsLinkProps>[];
 } & import('react').RefAttributes<HTMLScriptElement>> & {
+    /**
+     * BreadcrumbsLink component for individual breadcrumb navigation items.
+     *
+     * Features:
+     * - Renders as a clickable link with secondary appearance
+     * - Supports all standard anchor element props
+     * - Includes layout utilities for positioning and spacing
+     * - Uses small text size for consistent styling
+     * - Fully accessible with proper focus management
+     * - Automatic tracking ID generation for analytics
+     *
+     * @example
+     * <Breadcrumbs.Link href="/dashboard">Dashboard</Breadcrumbs.Link>
+     */
     Link: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref"> & import('@servicetitan/hammer-react').LayoutUtilProps & import('react').RefAttributes<HTMLAnchorElement>>;
 };

package/dist/components/Button/Button.d.ts

@@ -1,4 +1,32 @@
 import { ButtonProps as CoreButtonProps } from '@servicetitan/hammer-react';
 import { DataTrackingId } from '../../types/DataTrackingId';
+/**
+ * Props for the Button component
+ * @property {ButtonAppearance} [appearance] - The visual variant of the button
+ * @property {"small" | "medium" | "large"} [size] - The size of the button
+ * @property {boolean} [loading] - The loading state of the button
+ * @property {IconProps["svg"] | { after: IconProps["svg"] } | { before: IconProps["svg"] }} [icon] - The icons of the button
+ * @extends CoreButtonProps
+ * @extends DataTrackingId
+ */
 export type ButtonProps = CoreButtonProps & DataTrackingId;
+/**
+ * Button component for triggering actions and user interactions.
+ *
+ * Features:
+ * - Multiple visual appearances (primary, secondary, ghost, danger variants)
+ * - Three size options (small, medium, large)
+ * - Loading state with spinner animation
+ * - Icon support (before, after, or icon-only)
+ * - Full accessibility support with ARIA attributes
+ * - Supports layout utilities for positioning and spacing
+ * - Automatic disabled state when loading
+ * - Flexible content with text and/or icons
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <Button appearance="primary" size="medium" onClick={() => console.log('clicked')}>
+ *   Click Me
+ * </Button>
+ */
 export declare const Button: import('react').ForwardRefExoticComponent<ButtonProps & import('react').RefAttributes<HTMLButtonElement>>;

package/dist/components/ButtonCompound/ButtonCompound.d.ts

@@ -1,6 +1,30 @@
 import { ButtonCompoundProps as CoreButtonCompoundProps } from '@servicetitan/hammer-react';
 import { DataTrackingId } from '../../types/DataTrackingId';
+/**
+ * Props for the ButtonCompound component
+ * @property {"pill" | "circular" | "rounded"} [shape] - The shape of the compound button
+ * @extends CoreButtonCompoundProps
+ * @extends DataTrackingId
+ */
 export type ButtonCompoundProps = CoreButtonCompoundProps & DataTrackingId;
+/**
+ * ButtonCompound component for creating compound button layouts.
+ *
+ * Features:
+ * - Three shape options (pill, circular, rounded)
+ * - Transparent background for compound layouts
+ * - Supports layout utilities for positioning and spacing
+ * - Full accessibility support with proper ARIA attributes
+ * - Flexible content support
+ * - Consistent styling with other button components
+ * - Hover and active state management
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <ButtonCompound shape="circular">
+ *   <Avatar name="John Doe" />
+ * </ButtonCompound>
+ */
 export declare const ButtonCompound: import('react').ForwardRefExoticComponent<import('@servicetitan/hammer-react').LayoutUtilProps & Omit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & {
     shape?: "pill" | "circular" | "rounded";
 } & DataTrackingId & import('react').RefAttributes<HTMLButtonElement>>;

package/dist/components/ButtonLink/ButtonLink.d.ts

@@ -1,6 +1,36 @@
 import { ButtonLinkProps as CoreButtonLinkProps } from '@servicetitan/hammer-react';
 import { DataTrackingId } from '../../types/DataTrackingId';
+/**
+ * Props for the ButtonLink component
+ * @property {ButtonAppearance} [appearance] - The visual variant of the button link
+ * @property {"small" | "medium" | "large"} [size] - The size of the button link
+ * @property {IconProps["svg"] | { after: IconProps["svg"] } | { before: IconProps["svg"] }} [icon] - The icons of the button link
+ * @property {boolean} [loading] - The loading state of the button link
+ * @extends CoreButtonLinkProps
+ * @extends DataTrackingId
+ */
 export type ButtonLinkProps = CoreButtonLinkProps & DataTrackingId;
+/**
+ * ButtonLink component for creating clickable links that look like buttons.
+ *
+ * Features:
+ * - Multiple visual appearances (primary, secondary, ghost, danger variants)
+ * - Three size options (small, medium, large)
+ * - Loading state with spinner animation
+ * - Icon support (before, after, or icon-only)
+ * - Full accessibility support with proper ARIA attributes
+ * - Supports layout utilities for positioning and spacing
+ * - Keyboard navigation support (Space and Enter keys)
+ * - Automatic disabled state when loading
+ * - Prevents navigation when disabled or loading
+ * - Flexible content with text and/or icons
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <ButtonLink href="/dashboard" appearance="primary" size="medium">
+ *   Go to Dashboard
+ * </ButtonLink>
+ */
 export declare const ButtonLink: import('react').ForwardRefExoticComponent<import('@servicetitan/hammer-react').LayoutUtilProps & Omit<import('react').DetailedHTMLProps<import('react').AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref"> & {
     disabled?: boolean;
     appearance?: import('@servicetitan/hammer-react').ButtonAppearance;

package/dist/components/ButtonToggle/ButtonToggle.d.ts

@@ -1,6 +1,38 @@
 import { ButtonToggleProps as CoreButtonToggleProps } from '@servicetitan/hammer-react';
 import { DataTrackingId } from '../../types/DataTrackingId';
+/**
+ * Props for the ButtonToggle component
+ * @property {boolean} [defaultChecked] - The default pressed(selected) state of the toggle button
+ * @property {boolean} [checked] - The controlled pressed(selected) state of the toggle button
+ * @property {string} [value] - The value of the toggle button
+ * @property {(e: MouseEvent<HTMLButtonElement> | KeyboardEvent<HTMLButtonElement>, state: ButtonToggleState) => void} [onChange] - Callback for when pressed(selected) changes
+ * @extends CoreButtonToggleProps
+ * @extends DataTrackingId
+ */
 export type ButtonToggleProps = CoreButtonToggleProps & DataTrackingId;
+/**
+ * ButtonToggle component for creating toggleable button states.
+ *
+ * Features:
+ * - Supports both controlled and uncontrolled state management
+ * - Toggle state with pressed/selected visual feedback
+ * - Full accessibility support with aria-pressed attribute
+ * - Callback support for state changes
+ * - Supports layout utilities for positioning and spacing
+ * - Inherits all button features except appearance and loading
+ * - Flexible content with text and/or icons
+ * - Keyboard interaction support
+ * - Value association for form-like behavior
+ * - Automatic tracking ID generation for analytics
+ *
+ * @example
+ * <ButtonToggle
+ *   defaultChecked={false}
+ *   onChange={(e, state) => console.log('Toggle state:', state.pressed)}
+ * >
+ *   Toggle Me
+ * </ButtonToggle>
+ */
 export declare const ButtonToggle: import('react').ForwardRefExoticComponent<Omit<import('@servicetitan/hammer-react').ButtonProps, "appearance" | "loading"> & {
     defaultChecked?: boolean;
     checked?: boolean;

package/dist/components/Calendar/Calendar.d.ts

@@ -1,4 +1,20 @@
 import { CalendarProps as CoreCalendarProps, CalendarContextProps as CoreCalendarContextProps, CalendarNowProps as CoreCalendarNowProps, CalendarMonthProps as CoreCalendarMonthProps, CalendarNextProps as CoreCalendarNextProps, CalendarPrevProps as CoreCalendarPrevProps, CalendarMonthButtonProps as CoreCalendarMonthButtonProps, CalendarYearButtonProps as CoreCalendarYearButtonProps } from '@servicetitan/hammer-react';
+/**
+ * Props for the Calendar component
+ * @property {string} [value] - The selected date value for controlled mode
+ * @property {{ start?: string; end?: string }} [defaultValue] - The default date value for uncontrolled mode
+ * @property {string | null} [focusedDate] - The focused date for determining current month/year view
+ * @property {string | null} [defaultFocusedDate] - The default focused date
+ * @property {string} [minDate] - The minimum selectable date
+ * @property {string} [maxDate] - The maximum selectable date
+ * @property {string[]} [unavailableDates] - Dates that are not selectable (deprecated)
+ * @property {{ daysOfWeek?: number[]; dates?: string[] }} [unavailable] - Unavailable dates and days of week
+ * @property {Locale} [locale] - The locale for date formatting
+ * @property {IanaZone} [defaultTimeZone] - The timezone for date calculations
+ * @property {"Sunday" | "Monday"} [startDay] - The day to start the week on
+ * @property {boolean} [range] - Whether to enable date range selection
+ * @property {(data: { value: CalendarValue | CalendarRangeValue }) => void} [onSelection] - Selection change handler
+ */
 export type CalendarProps = CoreCalendarProps;
 export type CalendarContextProps = CoreCalendarContextProps;
 export type CalendarNowProps = CoreCalendarNowProps;
@@ -15,13 +31,111 @@ export declare const CalendarNext: import('react').ForwardRefExoticComponent<imp
 export declare const CalendarPrev: import('react').ForwardRefExoticComponent<import('@servicetitan/hammer-react').ButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
 export declare const CalendarMonthButton: import('react').ForwardRefExoticComponent<CoreCalendarMonthButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
 export declare const CalendarYearButton: import('react').ForwardRefExoticComponent<CoreCalendarYearButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
+/**
+ * Calendar component for viewing and selecting a date or range of dates.
+ *
+ * Features:
+ * - Single date and date range selection modes
+ * - Month and year navigation with header buttons
+ * - Configurable start day (Sunday or Monday)
+ * - Date range restrictions with min/max dates
+ * - Unavailable dates and days of week support
+ * - Locale and timezone customization
+ * - Full accessibility support with ARIA attributes
+ * - Keyboard navigation support
+ * - Responsive design with automatic width detection
+ * - Month and year selection views
+ * - Today button for quick navigation
+ * - Data tracking integration for analytics
+ *
+ * @example
+ * <Calendar
+ *   value="2024-01-15"
+ *   onSelection={({ value }) => console.log('Selected:', value)}
+ *   minDate="2024-01-01"
+ *   maxDate="2024-12-31"
+ * />
+ */
 export declare const Calendar: import('react').ForwardRefExoticComponent<CoreCalendarProps & import('react').RefAttributes<HTMLDivElement>> & {
+    /**
+     * Calendar.Now component for navigating to today's date.
+     *
+     * Features:
+     * - Quick navigation to current date
+     * - Accessible button with proper ARIA labels
+     * - Integrates with calendar context
+     * - Data tracking integration for analytics
+     *
+     * @example
+     * <Calendar.Now />
+     */
     Now: import('react').ForwardRefExoticComponent<{
         onClick?: (e: import('react').MouseEvent<HTMLButtonElement>, date: string | null) => void;
     } & Omit<import('@servicetitan/hammer-react').ButtonProps, "onClick"> & import('react').RefAttributes<HTMLButtonElement>>;
+    /**
+     * Calendar.Month component for displaying the month grid.
+     *
+     * Features:
+     * - Displays calendar days in a table format
+     * - Handles day selection and navigation
+     * - Supports range selection mode
+     * - Accessible with proper ARIA attributes
+     * - Data tracking integration for analytics
+     *
+     * @example
+     * <Calendar.Month />
+     */
     Month: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').TableHTMLAttributes<HTMLTableElement>, HTMLTableElement>, "ref"> & import('react').RefAttributes<HTMLTableElement>>;
+    /**
+     * Calendar.Next component for navigating to the next month.
+     *
+     * Features:
+     * - Navigation to next month
+     * - Accessible button with proper ARIA labels
+     * - Integrates with calendar context
+     * - Data tracking integration for analytics
+     *
+     * @example
+     * <Calendar.Next />
+     */
     Next: import('react').ForwardRefExoticComponent<import('@servicetitan/hammer-react').ButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
+    /**
+     * Calendar.Prev component for navigating to the previous month.
+     *
+     * Features:
+     * - Navigation to previous month
+     * - Accessible button with proper ARIA labels
+     * - Integrates with calendar context
+     * - Data tracking integration for analytics
+     *
+     * @example
+     * <Calendar.Prev />
+     */
     Prev: import('react').ForwardRefExoticComponent<import('@servicetitan/hammer-react').ButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
+    /**
+     * Calendar.MonthButton component for switching to month selection view.
+     *
+     * Features:
+     * - Switches calendar to month selection mode
+     * - Accessible button with proper ARIA labels
+     * - Integrates with calendar context
+     * - Data tracking integration for analytics
+     *
+     * @example
+     * <Calendar.MonthButton />
+     */
     MonthButton: import('react').ForwardRefExoticComponent<CoreCalendarMonthButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
+    /**
+     * Calendar.YearButton component for switching to year selection view.
+     *
+     * Features:
+     * - Switches calendar to year selection mode
+     * - Accessible button with proper ARIA labels
+     * - Integrates with calendar context
+     * - Data tracking integration for analytics
+     *
+     * @example
+     * <Calendar.YearButton />
+     */
     YearButton: import('react').ForwardRefExoticComponent<CoreCalendarYearButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
 };

package/dist/components/Card/Card.d.ts

@@ -1,5 +1,29 @@
 import { CardProps as CoreCardProps } from '@servicetitan/hammer-react';
+/**
+ * Props for the Card component
+ * @property {"strong" | "stronger"} [background] - The background variant of the card
+ * @property {"0" | "xsmall" | "small" | "medium" | "large"} [padding] - The padding size of the card
+ * @extends CoreCardProps
+ */
 export type CardProps = CoreCardProps;
+/**
+ * Card component for displaying content in a contained, elevated container.
+ *
+ * Features:
+ * - Configurable padding sizes (0, xsmall, small, medium, large)
+ * - Background variants (strong, stronger) for visual emphasis
+ * - Responsive design with automatic layout utilities
+ * - Consistent border radius and styling
+ * - Support for all standard div props
+ * - Layout utility props for positioning and spacing
+ * - Data tracking integration for analytics
+ *
+ * @example
+ * <Card padding="large" background="strong">
+ *   <h2>Card Title</h2>
+ *   <p>Card content goes here</p>
+ * </Card>
+ */
 export declare const Card: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('@servicetitan/hammer-react').LayoutUtilProps & {
     background?: "strong" | "stronger";
     padding?: Extract<import('@servicetitan/hammer-react').Size, "0" | "xsmall" | "small" | "medium" | "large">;