@landtrustinc/design-system 1.1.3 → 1.1.4-beta.2

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import * as _emotion_utils from '@emotion/utils';
+import * as _emotion_react from '@emotion/react';
+import { Interpolation, Theme } from '@emotion/react';
 import * as _emotion_react_jsx_runtime from '@emotion/react/jsx-runtime';
 import * as React$1 from 'react';
 import React__default, { HTMLAttributes, FC, PropsWithChildren, SVGProps, ReactNode } from 'react';
@@ -6,11 +7,9 @@ import * as _emotion_styled from '@emotion/styled';
 import * as csstype from 'csstype';
 import * as styled_system from 'styled-system';
 import { BorderProps, SpaceProps, ColorProps, FlexboxProps, GridProps as GridProps$1, LayoutProps, PositionProps, TypographyProps, WidthProps } from 'styled-system';
-import * as _emotion_react from '@emotion/react';
-import { Interpolation, Theme } from '@emotion/react';
 
-declare const globalStyles: _emotion_utils.SerializedStyles;
-declare const GlobalStyle: _emotion_utils.SerializedStyles;
+declare const globalStyles: _emotion_react.SerializedStyles;
+declare const GlobalStyle: _emotion_react.SerializedStyles;
 
 declare const screens: {
     sm: string;
@@ -524,32 +523,60 @@ declare namespace styles {
   export { styles_ThemeTokens as ThemeTokens, styles_borderRadius as borderRadius, styles_boxShadow as boxShadow, styles_colors as colors, styles_fontSizes as fontSizes, styles_fontWeights as fontWeights, styles_fonts as fonts, styles_headingSizes as headingSizes, styles_lineHeights as lineHeights, styles_media as media, styles_opacity as opacity, styles_screens as screens, styles_sizes as sizes, styles_space as space, styles_textShadow as textShadow, styles_transition as transition, styles_zIndex as zIndex };
 }
 
-type Props$f = {
+type AIResponseProps = {
+    /**
+     * Optional title for the AI response
+     */
     title?: string;
+    /**
+     * Whether to show disclaimer text
+     */
     showDisclaimer?: boolean;
+    /**
+     * Whether to show helpful feedback question
+     */
     showHelpfulQuestion?: boolean;
+    /**
+     * Additional CSS class names
+     */
     className?: string;
+    /**
+     * Content to display in the response
+     */
     children?: React__default.ReactNode;
+    /**
+     * Callback when user clicks "Yes" for helpful feedback
+     */
     onHelpfulYes?: () => void;
+    /**
+     * Callback when user clicks "No" for helpful feedback
+     */
     onHelpfulNo?: () => void;
+    /**
+     * Visual variant of the response
+     */
     variant?: 'default' | 'error';
+    /**
+     * Callback for retry button in error state
+     */
     onErrorRetry?: () => void;
+    /**
+     * Debounce time for helpful feedback in milliseconds
+     */
     helpfulDebounceMs?: number;
 };
-declare const AIResponse: ({ title, showDisclaimer, showHelpfulQuestion, className, children, onHelpfulYes, onHelpfulNo, variant, onErrorRetry, helpfulDebounceMs, }: Props$f) => _emotion_react_jsx_runtime.JSX.Element;
+declare const AIResponse: ({ title, showDisclaimer, showHelpfulQuestion, className, children, onHelpfulYes, onHelpfulNo, variant, onErrorRetry, helpfulDebounceMs, }: AIResponseProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type AvailabilityChipVariant = 'primary' | 'error' | 'action' | 'warning';
-type AvailabilityChipProps$1 = HTMLAttributes<HTMLSpanElement> & {
-    /** The visual variant of the chip */
-    variant: AvailabilityChipVariant;
-    /** Optional custom className */
-    className?: string;
-};
 
 type AvailabilityChipProps = HTMLAttributes<HTMLSpanElement> & {
-    /** The visual variant of the chip */
+    /**
+     * Visual variant of the chip
+     */
     variant: AvailabilityChipVariant;
-    /** Optional custom className */
+    /**
+     * Additional CSS class names
+     */
     className?: string;
 };
 declare const AvailabilityChip: FC<PropsWithChildren<AvailabilityChipProps>>;
@@ -568,10 +595,10 @@ declare const Box: _emotion_styled.StyledComponent<{
     className?: string | undefined;
 }, React$1.DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
 
-type Props$e = BoxProps & {
+type Props = BoxProps & {
     isFullWidth?: boolean;
 };
-declare const Container: ({ children, className, isFullWidth, ...props }: Props$e) => _emotion_react_jsx_runtime.JSX.Element;
+declare const Container: ({ children, className, isFullWidth, ...props }: Props) => _emotion_react_jsx_runtime.JSX.Element;
 
 declare const SvgAiMagic: (props: SVGProps<SVGSVGElement>) => _emotion_react_jsx_runtime.JSX.Element;
 
@@ -966,7 +993,7 @@ declare namespace Icons {
 }
 
 type IconVariantTypes$1 = keyof typeof Icons;
-type Props$d = {
+type IconProps = {
     variant: IconVariantTypes$1;
     size?: keyof typeof space;
     className?: string;
@@ -974,149 +1001,323 @@ type Props$d = {
     onClick?: () => void;
     fill?: string;
 };
-declare const Icon: ({ variant, size, className, setAutoHeight, fill, ...rest }: Props$d) => _emotion_react_jsx_runtime.JSX.Element;
+declare const Icon: ({ variant, size, className, setAutoHeight, fill, ...rest }: IconProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type ButtonVariants = 'primary' | 'secondary' | 'tertiary' | 'plus' | 'simple' | 'text' | 'topo';
 
 type ButtonAndAnchorProps = React__default.HTMLProps<HTMLButtonElement> & React__default.HTMLProps<HTMLAnchorElement>;
-type Props$c = Omit<ButtonAndAnchorProps, 'size' | 'as' | 'onClick'> & {
+type ButtonProps = {
+    /**
+     * Element type to render as (button, a, etc.)
+     */
     as?: React__default.ElementType;
+    /**
+     * Visual style variant of the button
+     */
     variant?: ButtonVariants;
+    /**
+     * Whether the button should take full width
+     */
     fullWidth?: boolean;
+    /**
+     * Whether to show loading state
+     */
     isLoading?: boolean;
+    /**
+     * Whether the button is disabled
+     */
     disabled?: boolean;
+    /**
+     * Button content
+     */
     children?: React__default.ReactNode;
+    /**
+     * Button type attribute
+     */
     type?: 'submit' | 'button';
+    /**
+     * Size variant of the button
+     */
     size?: 'xs' | 'base' | 'sm' | 'lg';
+    /**
+     * Additional CSS class names
+     */
     className?: string;
+    /**
+     * Custom styles for the button label
+     */
     labelStyleOverrides?: Interpolation<Theme>;
+    /**
+     * Click event handler
+     */
     onClick?: React__default.MouseEventHandler<HTMLElement>;
+    /**
+     * Icon element to display in the button
+     */
     icon?: React__default.ReactElement<React__default.ComponentProps<typeof Icon>>;
-};
-declare const Button: React__default.ForwardRefExoticComponent<Omit<Props$c, "ref"> & React__default.RefAttributes<HTMLElement>>;
-
-type Variant = 'sent' | 'received';
-type Props$b = {
-    variant?: Variant;
+} & Omit<ButtonAndAnchorProps, 'size' | 'as' | 'onClick'>;
+declare const Button: React__default.ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & React__default.RefAttributes<HTMLElement>>;
+
+type MessageBubbleVariant = 'sent' | 'received';
+
+type MessageBubbleProps = {
+    /**
+     * Visual variant of the message bubble
+     */
+    variant?: MessageBubbleVariant;
+    /**
+     * Optional timestamp to display
+     */
     timestamp?: string;
+    /**
+     * Additional CSS class names
+     */
     className?: string;
+    /**
+     * Content to display in the message bubble
+     */
     children?: React__default.ReactNode;
 };
-declare const MessageBubble: ({ variant, timestamp, className, children, }: Props$b) => _emotion_react_jsx_runtime.JSX.Element;
+declare const MessageBubble: ({ variant, timestamp, className, children, }: MessageBubbleProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type ChatWidgetMessage = React__default.ReactElement<React__default.ComponentProps<typeof AIResponse>, typeof AIResponse> | React__default.ReactElement<React__default.ComponentProps<typeof MessageBubble>, typeof MessageBubble>;
-type Props$a = {
+type ChatWidgetProps = {
+    /**
+     * Title displayed in the chat widget header
+     */
     title: string;
+    /**
+     * Array of messages to display
+     */
     messages: ChatWidgetMessage[];
+    /**
+     * Callback when user submits a message
+     */
     onSubmit: (value: string) => void;
+    /**
+     * Placeholder text for the input field
+     */
     placeholder?: string;
+    /**
+     * Whether the chat widget is disabled
+     */
     disabled?: boolean;
+    /**
+     * Additional CSS class names
+     */
     className?: string;
+    /**
+     * ARIA label for accessibility
+     */
     ariaLabel?: string;
+    /**
+     * Width of the chat panel
+     */
     panelWidth?: number | string;
+    /**
+     * Whether the widget is expanded (controlled)
+     */
     expanded?: boolean;
+    /**
+     * Default expanded state (uncontrolled)
+     */
     defaultExpanded?: boolean;
+    /**
+     * Callback when expanded state changes
+     */
     onExpandedChange?: (expanded: boolean) => void;
+    /**
+     * Whether to show thinking indicator
+     */
     isThinking?: boolean;
+    /**
+     * Messages to show when chat is empty
+     */
     emptyState?: ChatWidgetMessage[];
+    /**
+     * Additional props for the container
+     */
     containerProps?: BoxProps;
 };
-declare const ChatWidget: ({ title, messages, onSubmit, placeholder, disabled, className, ariaLabel, panelWidth, expanded, defaultExpanded, onExpandedChange, isThinking, emptyState, containerProps, }: Props$a) => _emotion_react_jsx_runtime.JSX.Element;
+declare const ChatWidget: ({ title, messages, onSubmit, placeholder, disabled, className, ariaLabel, panelWidth, expanded, defaultExpanded, onExpandedChange, isThinking, emptyState, containerProps, }: ChatWidgetProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type DividerProps = React__default.HTMLAttributes<HTMLHRElement> & SpaceProps & {
+    /**
+     * Additional CSS class names
+     */
     className?: string;
 };
 declare const Divider: React__default.FC<DividerProps>;
 
-type Props$9 = {
+type FieldNoteCardProps = {
+    /**
+     * URL of the background image
+     */
     backgroundImage: string;
+    /**
+     * Title text displayed on the card
+     */
     title: string;
+    /**
+     * Text displayed on the action button
+     */
     buttonLabel: string;
+    /**
+     * Callback when the card or button is clicked
+     */
     onClick?: () => void;
+    /**
+     * Additional CSS class names
+     */
     className?: string;
 };
-declare const FieldNoteCard: ({ backgroundImage, title, buttonLabel, onClick, className, ...rest }: Props$9) => _emotion_react_jsx_runtime.JSX.Element;
+declare const FieldNoteCard: ({ backgroundImage, title, buttonLabel, onClick, className, ...rest }: FieldNoteCardProps) => _emotion_react_jsx_runtime.JSX.Element;
+
+interface FormFieldProps {
+    /**
+     * Field label
+     */
+    label?: string;
+    /**
+     * Whether to hide the label visually
+     */
+    hideLabel?: boolean;
+    /**
+     * Whether the field is required
+     */
+    required?: boolean;
+    /**
+     * Error message
+     */
+    error?: string;
+    /**
+     * Success message
+     */
+    success?: string;
+    /**
+     * Help text
+     */
+    helpText?: string;
+    /**
+     * Field ID for accessibility
+     */
+    htmlFor?: string;
+    /**
+     * Children components
+     */
+    children: ReactNode;
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+}
+declare const FormField: React__default.FC<FormFieldProps>;
 
 type InputSize = 'sm' | 'md' | 'lg';
 type InputVariant = 'default' | 'error' | 'success';
+
 interface BaseInputProps {
-    /** Size variant of the input */
+    /**
+     * Size variant of the input
+     */
     size?: InputSize;
-    /** Visual variant of the input */
+    /**
+     * Visual variant of the input
+     */
     variant?: InputVariant;
-    /** Whether the input is disabled */
+    /**
+     * Whether the input is disabled
+     */
     disabled?: boolean;
-    /** Whether the input is required */
+    /**
+     * Whether the input is required
+     */
     required?: boolean;
-    /** Whether the input is read-only */
+    /**
+     * Whether the input is read-only
+     */
     readOnly?: boolean;
-    /** Help text displayed below the input */
+    /**
+     * Help text displayed below the input
+     */
     helpText?: string;
-    /** Error message displayed below the input */
+    /**
+     * Error message displayed below the input
+     */
     error?: string;
-    /** Success message displayed below the input */
+    /**
+     * Success message displayed below the input
+     */
     success?: string;
-    /** Label text for the input */
+    /**
+     * Label text for the input
+     */
     label?: string;
-    /** Whether to hide the label visually (for accessibility) */
+    /**
+     * Whether to hide the label visually (for accessibility)
+     */
     hideLabel?: boolean;
-    /** Icon to display at the start of the input */
+    /**
+     * Icon to display at the start of the input
+     */
     startIcon?: ReactNode;
-    /** Icon to display at the end of the input */
+    /**
+     * Icon to display at the end of the input
+     */
     endIcon?: ReactNode;
-    /** Additional className */
+    /**
+     * Additional CSS class names
+     */
     className?: string;
-    /** Placeholder text */
+    /**
+     * Placeholder text
+     */
     placeholder?: string;
 }
-interface InputProps extends BaseInputProps, Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size'> {
-    /** Input type */
+interface InputProps extends BaseInputProps, Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'size'> {
+    /**
+     * Input type
+     */
     type?: 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
 }
+declare const Input: React__default.ForwardRefExoticComponent<InputProps & React__default.RefAttributes<HTMLInputElement>>;
+
 interface SelectOption {
+    /**
+     * Option value
+     */
     value: string | number;
+    /**
+     * Option label text
+     */
     label: string;
+    /**
+     * Whether the option is disabled
+     */
     disabled?: boolean;
 }
-interface SelectProps extends BaseInputProps, Omit<React.SelectHTMLAttributes<HTMLSelectElement>, 'size'> {
-    /** Select options */
+interface SelectProps extends BaseInputProps, Omit<React__default.SelectHTMLAttributes<HTMLSelectElement>, 'size'> {
+    /**
+     * Select options
+     */
     options: SelectOption[];
-    /** Placeholder option text */
+    /**
+     * Placeholder option text
+     */
     placeholderOption?: string;
 }
-interface TextareaProps extends BaseInputProps, Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, 'size'> {
-    /** Number of visible text lines */
+declare const Select: React__default.ForwardRefExoticComponent<SelectProps & React__default.RefAttributes<HTMLSelectElement>>;
+
+interface TextareaProps extends BaseInputProps, Omit<React__default.TextareaHTMLAttributes<HTMLTextAreaElement>, 'size'> {
+    /**
+     * Number of visible text lines
+     */
     rows?: number;
-    /** Whether the textarea can be resized */
+    /**
+     * Whether the textarea can be resized
+     */
     resize?: 'none' | 'both' | 'horizontal' | 'vertical';
 }
-interface FormFieldProps {
-    /** Field label */
-    label?: string;
-    /** Whether to hide the label visually */
-    hideLabel?: boolean;
-    /** Whether the field is required */
-    required?: boolean;
-    /** Error message */
-    error?: string;
-    /** Success message */
-    success?: string;
-    /** Help text */
-    helpText?: string;
-    /** Field ID for accessibility */
-    htmlFor?: string;
-    /** Children components */
-    children: ReactNode;
-    /** Additional className */
-    className?: string;
-}
-
-declare const FormField: React__default.FC<FormFieldProps>;
-
-declare const Input: React__default.ForwardRefExoticComponent<InputProps & React__default.RefAttributes<HTMLInputElement>>;
-
-declare const Select: React__default.ForwardRefExoticComponent<SelectProps & React__default.RefAttributes<HTMLSelectElement>>;
-
 type ExtraProps = {
     autoExpand?: boolean;
     maxHeight?: number | string;
@@ -1128,6 +1329,7 @@ type ExtraProps = {
 };
 declare const TextArea: React__default.ForwardRefExoticComponent<TextareaProps & ExtraProps & React__default.RefAttributes<HTMLTextAreaElement>>;
 
+type GridBreakpoint = 'sm' | 'md' | 'lg' | 'xl';
 type ResponsiveValue<T> = T | {
     sm?: T;
     md?: T;
@@ -1135,56 +1337,101 @@ type ResponsiveValue<T> = T | {
     xl?: T;
     _?: T;
 };
+
+interface ColumnProps extends BoxProps {
+    /**
+     * Column span at different breakpoints
+     */
+    span?: ResponsiveValue<number | 'auto'>;
+    /**
+     * Column start position
+     */
+    start?: ResponsiveValue<number>;
+    /**
+     * Column end position
+     */
+    end?: ResponsiveValue<number>;
+    /**
+     * Row position
+     */
+    row?: ResponsiveValue<number>;
+    /**
+     * Row span
+     */
+    rowSpan?: ResponsiveValue<number>;
+    /**
+     * Grid area name
+     */
+    area?: string;
+    /**
+     * Column children
+     */
+    children: ReactNode;
+}
+declare const Column: ({ span, start, end, row, rowSpan, area, children, ...props }: ColumnProps) => _emotion_react_jsx_runtime.JSX.Element;
+
 interface GridProps extends Omit<BoxProps, 'display'> {
-    /** Number of columns at different breakpoints */
+    /**
+     * Number of columns at different breakpoints
+     */
     columns?: ResponsiveValue<number>;
-    /** Gap between grid items using space tokens */
+    /**
+     * Gap between grid items using space tokens
+     */
     gap?: ResponsiveValue<keyof typeof space>;
-    /** Row gap between grid items using space tokens */
+    /**
+     * Row gap between grid items using space tokens
+     */
     rowGap?: ResponsiveValue<keyof typeof space>;
-    /** Column gap between grid items using space tokens */
+    /**
+     * Column gap between grid items using space tokens
+     */
     columnGap?: ResponsiveValue<keyof typeof space>;
-    /** Size of auto-generated rows */
+    /**
+     * Size of auto-generated rows
+     */
     autoRows?: string;
-    /** Size of auto-generated columns */
+    /**
+     * Size of auto-generated columns
+     */
     autoColumns?: string;
-    /** Grid template areas for named layouts */
+    /**
+     * Grid template areas for named layouts
+     */
     templateAreas?: ResponsiveValue<string>;
-    /** Align items in the grid */
+    /**
+     * Align items in the grid
+     */
     alignItems?: ResponsiveValue<'start' | 'end' | 'center' | 'stretch'>;
-    /** Justify items in the grid */
+    /**
+     * Justify items in the grid
+     */
     justifyItems?: ResponsiveValue<'start' | 'end' | 'center' | 'stretch'>;
-    /** Justify content in the grid */
+    /**
+     * Justify content in the grid
+     */
     justifyContent?: ResponsiveValue<'start' | 'end' | 'center' | 'stretch' | 'space-between' | 'space-around' | 'space-evenly'>;
+    /**
+     * Grid children
+     */
     children: ReactNode;
 }
-interface ColumnProps extends BoxProps {
-    /** Column span at different breakpoints */
-    span?: ResponsiveValue<number | 'auto'>;
-    /** Column start position */
-    start?: ResponsiveValue<number>;
-    /** Column end position */
-    end?: ResponsiveValue<number>;
-    /** Row position */
-    row?: ResponsiveValue<number>;
-    /** Row span */
-    rowSpan?: ResponsiveValue<number>;
-    /** Grid area name */
-    area?: string;
-    children: ReactNode;
-}
+declare const Grid: ({ columns, gap, rowGap, columnGap, autoRows, autoColumns, templateAreas, alignItems, justifyItems, justifyContent, children, ...props }: GridProps) => _emotion_react_jsx_runtime.JSX.Element;
+
 interface GridContainerProps extends HTMLAttributes<HTMLDivElement> {
-    /** Maximum width constraint */
+    /**
+     * Maximum width constraint
+     */
     maxWidth?: 'sm' | 'md' | 'lg' | 'xl' | 'content' | 'wide' | 'full' | string;
+    /**
+     * Container children
+     */
     children: ReactNode;
+    /**
+     * Additional CSS class names
+     */
     className?: string;
 }
-type GridBreakpoint = 'sm' | 'md' | 'lg' | 'xl';
-
-declare const Column: ({ span, start, end, row, rowSpan, area, children, ...props }: ColumnProps) => _emotion_react_jsx_runtime.JSX.Element;
-
-declare const Grid: ({ columns, gap, rowGap, columnGap, autoRows, autoColumns, templateAreas, alignItems, justifyItems, justifyContent, children, ...props }: GridProps) => _emotion_react_jsx_runtime.JSX.Element;
-
 declare const GridContainer: ({ maxWidth, children, className, ...props }: GridContainerProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 /**
@@ -1208,96 +1455,235 @@ declare const LayoutTokens: {
     };
 };
 
-type Props$8 = {
+type HuntCardProps = {
+    /**
+     * URL of the background image
+     */
     backgroundImage: string;
+    /**
+     * Title text displayed on the card
+     */
     title: string;
+    /**
+     * Text displayed on the action button
+     */
     buttonLabel: string;
+    /**
+     * Callback when the card or button is clicked
+     */
     onClick?: () => void;
+    /**
+     * Additional CSS class names
+     */
     className?: string;
 };
-declare const HuntCard: ({ backgroundImage, title, buttonLabel, onClick, className, ...rest }: Props$8) => _emotion_react_jsx_runtime.JSX.Element;
+declare const HuntCard: ({ backgroundImage, title, buttonLabel, onClick, className, ...rest }: HuntCardProps) => _emotion_react_jsx_runtime.JSX.Element;
 
-type Props$7 = {
+type IconLabelProps = {
+    /**
+     * Icon variant to display
+     */
     variant: IconVariantTypes$1;
+    /**
+     * Text label to display next to the icon
+     */
     label: string;
+    /**
+     * Size of the icon
+     */
     iconSize?: keyof typeof space;
+    /**
+     * Additional CSS class names
+     */
     className?: string;
 };
-declare const IconLabel: ({ variant, label, iconSize, className, ...rest }: Props$7) => _emotion_react_jsx_runtime.JSX.Element;
+declare const IconLabel: ({ variant, label, iconSize, className, ...rest }: IconLabelProps) => _emotion_react_jsx_runtime.JSX.Element;
 
-type Props$6 = {
-    /** Called when the user submits text. Receives the submitted string. */
+type ListingChatProps = {
+    /**
+     * Called when the user submits text
+     */
     onSubmit: (value: string) => void;
-    /** Placeholder text for the input area */
+    /**
+     * Placeholder text for the input area
+     */
     placeholder?: string;
-    /** Optional className */
+    /**
+     * Additional CSS class names
+     */
     className?: string;
-    /** Optional label next to the AIMagic icon */
+    /**
+     * Optional label next to the AI Magic icon
+     */
     title?: string;
-    /** Suggested tags the user can click to submit quickly */
+    /**
+     * Array of suggested tags/questions to display as chips
+     */
     tags?: string[];
-    /** Disable the input and submit button */
+    /**
+     * Whether the input is disabled
+     */
     disabled?: boolean;
 };
-declare const ListingChat: ({ onSubmit, placeholder, className, title, tags, disabled, ...rest }: Props$6) => _emotion_react_jsx_runtime.JSX.Element;
+declare const ListingChat: ({ onSubmit, placeholder, className, title, tags, disabled, ...rest }: ListingChatProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type LogoVariant = 'standard' | 'plus';
 type LogoTheme = 'light' | 'dark';
-type Props$5 = {
+
+type LogoProps = {
+    /**
+     * Logo variant ('standard' or 'plus')
+     */
     variant: LogoVariant;
+    /**
+     * Color theme ('light' or 'dark')
+     */
     theme?: LogoTheme;
+    /**
+     * Size of the logo using space tokens
+     */
     size?: keyof typeof space;
+    /**
+     * Additional CSS class names
+     */
     className?: string;
+    /**
+     * Click event handler
+     */
     onClick?: () => void;
 };
-declare const Logo: ({ variant, theme, size, className, ...rest }: Props$5) => _emotion_react_jsx_runtime.JSX.Element;
+declare const Logo: ({ variant, theme, size, className, ...rest }: LogoProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type NavLink = {
+    /**
+     * Text label for the navigation link
+     */
     label: string;
+    /**
+     * URL or path for the navigation link
+     */
     href: string;
+    /**
+     * Optional click handler
+     */
     onClick?: () => void;
 };
-type Props$4 = {
+type NavigationProps = {
+    /**
+     * Callback when the mobile menu is toggled
+     */
     onMenuToggle?: () => void;
+    /**
+     * Additional CSS class names
+     */
     className?: string;
+    /**
+     * Logo variant
+     */
     logoVariant?: 'standard' | 'plus';
+    /**
+     * Logo theme
+     */
     logoTheme?: 'light' | 'dark';
+    /**
+     * Array of navigation links
+     */
     navLinks?: NavLink[];
+    /**
+     * Callback when the avatar is clicked
+     */
     onAvatarClick?: () => void;
 };
-declare const Navigation: ({ onMenuToggle, className, logoVariant, logoTheme, navLinks, onAvatarClick, ...rest }: Props$4) => _emotion_react_jsx_runtime.JSX.Element;
+declare const Navigation: ({ onMenuToggle, className, logoVariant, logoTheme, navLinks, onAvatarClick, ...rest }: NavigationProps) => _emotion_react_jsx_runtime.JSX.Element;
 
-type Props$3 = {
+type PackageCardProps = {
+    /**
+     * Array of image URLs to display
+     */
     images: string[];
+    /**
+     * Main title of the package
+     */
     title: string;
+    /**
+     * Subtitle or description
+     */
     subtitle: string;
+    /**
+     * Starting price text
+     */
     startingPrice: string;
+    /**
+     * Number of trips remaining
+     */
     tripsLeft?: number;
+    /**
+     * Whether the package is favorited
+     */
     isFavorited?: boolean;
+    /**
+     * Callback when favorite button is clicked
+     */
     onFavoriteClick?: () => void;
+    /**
+     * Callback when card is clicked
+     */
     onClick?: () => void;
+    /**
+     * Additional CSS class names
+     */
     className?: string;
+    /**
+     * Number of days for the package
+     */
     days?: number;
+    /**
+     * Number of guests
+     */
     guests?: number;
+    /**
+     * Whether lodging is included
+     */
     hasLodging?: boolean;
+    /**
+     * Optional badge element to display
+     */
+    badge?: React__default.ReactNode;
+    /**
+     * Availability status text
+     */
+    availability?: string;
 };
-declare const PackageCard: ({ images, title, subtitle, startingPrice, tripsLeft, isFavorited, onFavoriteClick, onClick, className, days, guests, hasLodging, ...rest }: Props$3) => _emotion_react_jsx_runtime.JSX.Element;
+declare const PackageCard: ({ images, title, subtitle, startingPrice, tripsLeft, isFavorited, onFavoriteClick, onClick, className, days, guests, hasLodging, ...rest }: PackageCardProps) => _emotion_react_jsx_runtime.JSX.Element;
 
-type Props$2 = {
+type SpinnerProps = {
+    /**
+     * Size of the spinner using space tokens
+     */
     size?: keyof typeof space;
+    /**
+     * Additional CSS class names
+     */
     className?: string;
+    /**
+     * Fill color for the spinner
+     */
     fill?: string;
 };
-declare const Spinner: ({ size, className, fill }: Props$2) => _emotion_react_jsx_runtime.JSX.Element;
+declare const Spinner: ({ size, className, fill }: SpinnerProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 type TagChipVariant = 'primary' | 'success' | 'warning' | 'error';
+
 type TagChipProps = HTMLAttributes<HTMLSpanElement> & {
-    /** The visual variant of the chip */
+    /**
+     * Visual variant of the chip
+     */
     variant?: TagChipVariant;
-    /** Optional custom className */
+    /**
+     * Additional CSS class names
+     */
     className?: string;
 };
-
 declare const TagChip: FC<PropsWithChildren<TagChipProps>>;
 
 type THeadingSize = 'xl' | 'lg' | 'md' | 'sm' | 'xs' | '2xs';
@@ -1306,74 +1692,146 @@ type TFontWeight = 'normal' | 'semibold' | 'bold' | 'extrabold';
 type TTextAlign = 'left' | 'center' | 'right' | 'justify' | 'start' | 'end';
 type TTextWrap = 'pretty' | 'balance' | 'nowrap' | 'wrap' | 'stable';
 
-type Props$1 = HTMLAttributes<HTMLElement> & {
+type HeadingProps = HTMLAttributes<HTMLElement> & {
+    /**
+     * Size variant of the heading
+     */
     size?: THeadingSize;
-    /** DOM element name that will be rendered */
+    /**
+     * DOM element name to render as
+     */
     as?: string;
-    /** Optional custom className */
+    /**
+     * Additional CSS class names
+     */
     className?: string;
-    /** Optional prop to set the uppercase */
+    /**
+     * Whether to transform text to uppercase
+     */
     uppercase?: boolean;
-    /** Optional prop to set the font weight */
+    /**
+     * Font weight of the heading
+     */
     fontWeight?: TFontWeight;
-    /** Optional prop to set the text align */
+    /**
+     * Text alignment
+     */
     textAlign?: TTextAlign;
-    /** Optional prop to set the text wrap */
+    /**
+     * Text wrapping behavior
+     */
     textWrap?: TTextWrap;
-    /** Color token (e.g., "gray.100") or CSS color value */
+    /**
+     * Color token or CSS color value
+     */
     color?: string;
 };
-declare const Heading: FC<PropsWithChildren<Props$1>>;
+declare const Heading: FC<PropsWithChildren<HeadingProps>>;
 
-type Props = HTMLAttributes<HTMLElement> & {
+type TextProps = HTMLAttributes<HTMLElement> & {
+    /**
+     * Size variant of the text
+     */
     size?: TTextSize;
-    /** DOM element name that will be rendered */
+    /**
+     * DOM element name to render as
+     */
     as?: string;
-    /** Optional custom className */
+    /**
+     * Additional CSS class names
+     */
     className?: string;
-    /** Optional prop to set the font weight */
+    /**
+     * Font weight of the text
+     */
     fontWeight?: TFontWeight;
-    /** Optional prop to set the uppercase */
+    /**
+     * Whether to transform text to uppercase
+     */
     uppercase?: boolean;
-    /** Optional prop to set the text align */
+    /**
+     * Text alignment
+     */
     textAlign?: TTextAlign;
-    /** Optional prop to set the text wrap */
+    /**
+     * Text wrapping behavior
+     */
     textWrap?: TTextWrap;
-    /** Color token (e.g., "gray.100") or CSS color value */
+    /**
+     * Color token or CSS color value
+     */
     color?: string;
 };
-declare const Text: FC<PropsWithChildren<Props>>;
+declare const Text: FC<PropsWithChildren<TextProps>>;
 
 type IconVariantTypes = Parameters<typeof Icon>[0]['variant'];
 type WidgetProps = {
+    /**
+     * ARIA label for accessibility
+     */
     ariaLabel: string;
+    /**
+     * Icon to display when widget is collapsed
+     */
     icon?: IconVariantTypes;
+    /**
+     * Icon to display when widget is expanded
+     */
     expandedIcon?: IconVariantTypes;
+    /**
+     * Default expanded state (uncontrolled)
+     */
     defaultExpanded?: boolean;
+    /**
+     * Expanded state (controlled)
+     */
     expanded?: boolean;
+    /**
+     * Callback when expanded state changes
+     */
     onExpandedChange?: (expanded: boolean) => void;
+    /**
+     * Width of the widget panel (defaults to 480)
+     */
     panelWidth?: number | string;
+    /**
+     * Additional CSS class names
+     */
     className?: string;
+    /**
+     * Widget content
+     */
     children?: React__default.ReactNode;
+    /**
+     * Additional props for the container
+     */
     containerProps?: BoxProps;
 };
-declare const WidgetTrigger: React__default.FC<{
+type WidgetTriggerProps = {
+    /**
+     * Additional CSS class names
+     */
     className?: string;
-}>;
-declare const WidgetPanel: React__default.FC<{
+};
+type WidgetPanelProps = {
+    /**
+     * Additional CSS class names
+     */
     className?: string;
-    style?: React__default.CSSProperties;
+    /**
+     * Content to display within the widget panel
+     */
     children?: React__default.ReactNode;
+};
+declare const WidgetTrigger: React__default.FC<WidgetTriggerProps>;
+declare const WidgetPanel: React__default.FC<WidgetPanelProps & {
+    style?: React__default.CSSProperties;
 }>;
 declare const Widget: React__default.FC<WidgetProps> & {
-    Trigger: React__default.FC<{
-        className?: string | undefined;
-    }>;
-    Panel: React__default.FC<{
-        className?: string | undefined;
+    Trigger: React__default.FC<WidgetTriggerProps>;
+    Panel: React__default.FC<WidgetPanelProps & {
         style?: React__default.CSSProperties | undefined;
-        children?: React__default.ReactNode;
     }>;
 };
 
-export { AIResponse, AvailabilityChip, type AvailabilityChipProps$1 as AvailabilityChipProps, type AvailabilityChipVariant, type BaseInputProps, Box, type BoxProps, Button, type ButtonVariants, ChatWidget, type ChatWidgetMessage, Column, type ColumnProps, Container, Divider, FieldNoteCard, FormField, type FormFieldProps, GlobalStyle, Grid, type GridBreakpoint, GridContainer, type GridContainerProps, type GridProps, Heading, HuntCard, Icon, IconLabel, type IconVariantTypes$1 as IconVariantTypes, Input, type InputProps, type InputSize, type InputVariant, LayoutTokens, ListingChat, Logo, type LogoTheme, type LogoVariant, MessageBubble, Navigation, PackageCard, type ResponsiveValue, Select, type SelectOption, type SelectProps, Spinner, TagChip, type TagChipProps, Text, TextArea, type TextareaProps, ThemeTokens, Widget, WidgetPanel, WidgetTrigger, globalStyles, styles };
+export { AIResponse, type AIResponseProps, AvailabilityChip, type AvailabilityChipProps, type AvailabilityChipVariant, type BaseInputProps, Box, type BoxProps, Button, type ButtonProps, type ButtonVariants, ChatWidget, type ChatWidgetMessage, type ChatWidgetProps, Column, type ColumnProps, Container, Divider, type DividerProps, FieldNoteCard, type FieldNoteCardProps, FormField, type FormFieldProps, GlobalStyle, Grid, type GridBreakpoint, GridContainer, type GridContainerProps, type GridProps, Heading, type HeadingProps, HuntCard, type HuntCardProps, Icon, IconLabel, type IconLabelProps, type IconProps, type IconVariantTypes$1 as IconVariantTypes, Input, type InputProps, type InputSize, type InputVariant, LayoutTokens, ListingChat, type ListingChatProps, Logo, type LogoProps, type LogoTheme, type LogoVariant, MessageBubble, type MessageBubbleProps, type NavLink, Navigation, type NavigationProps, PackageCard, type PackageCardProps, type ResponsiveValue, Select, type SelectOption, type SelectProps, Spinner, type SpinnerProps, type TFontWeight, type THeadingSize, type TTextAlign, type TTextSize, type TTextWrap, TagChip, type TagChipProps, type TagChipVariant, Text, TextArea, type TextProps, type TextareaProps, ThemeTokens, Widget, WidgetPanel, type WidgetPanelProps, type WidgetProps, WidgetTrigger, type WidgetTriggerProps, globalStyles, styles };