@hotelcard/ui 1.0.0-rc.0

package/dist/index.d.ts

@@ -0,0 +1,1799 @@
+import { ButtonHTMLAttributes } from 'react';
+import { default as default_2 } from 'react';
+import { ForwardRefExoticComponent } from 'react';
+import { ReactNode } from 'react';
+import { RefAttributes } from 'react';
+
+export declare const Badge: default_2.FC<BadgeProps>;
+
+export declare interface BadgeProps {
+    /**
+     * The color of the badge
+     * @default 'primary'
+     */
+    color?: 'primary' | 'secondary' | 'neutral' | 'success' | 'warning';
+    /**
+     * The size of the badge
+     * @default 'large'
+     */
+    size?: 'small' | 'large';
+    /**
+     * The style variant of the badge
+     * @default 'heavy'
+     */
+    style?: 'heavy' | 'light';
+    /**
+     * Whether to display an icon (not implemented yet)
+     */
+    icon?: boolean;
+    /**
+     * The content to display inside the badge
+     */
+    children: ReactNode;
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+}
+
+export declare const Block: React.FC<BlockProps>;
+
+export declare interface BlockProps {
+    /**
+     * Type of block to render
+     * @default 'icon'
+     */
+    variant?: 'icon' | 'image';
+    /**
+     * Icon or image to display (depending on variant)
+     */
+    visual?: ReactNode;
+    /**
+     * Label/title text
+     */
+    label: string;
+    /**
+     * Description text (for icon variant)
+     */
+    description?: string;
+    /**
+     * Style variant for icon blocks
+     * @default 'primary'
+     */
+    style?: 'primary' | 'secondary';
+    /**
+     * Click handler
+     */
+    onClick?: () => void;
+    /**
+     * Whether to show arrow (for image variant)
+     * @default true
+     */
+    showArrow?: boolean;
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+}
+
+/**
+ * Responsive breakpoint constants
+ * These match the design token breakpoints in tokens.json
+ */
+export declare const BREAKPOINTS: {
+    readonly mobile: 767;
+    readonly tablet: 1023;
+    readonly desktop: 1024;
+};
+
+export declare const Button: ForwardRefExoticComponent<ButtonProps & RefAttributes<HTMLButtonElement>>;
+
+export declare interface ButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children'> {
+    /**
+     * The visual style variant of the button
+     * @default 'primary'
+     */
+    variant?: 'primary' | 'secondary' | 'link';
+    /**
+     * The size of the button
+     * @default 'medium'
+     */
+    size?: 'small' | 'medium';
+    /**
+     * Icon to display on the left side of the button text
+     */
+    leftIcon?: ReactNode;
+    /**
+     * Icon to display on the right side of the button text
+     */
+    rightIcon?: ReactNode;
+    /**
+     * The content to display inside the button
+     */
+    children?: ReactNode;
+    /**
+     * Whether the button is disabled
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Whether the button should be icon-only (no text, just icon)
+     * @default false
+     */
+    iconOnly?: boolean;
+}
+
+export declare const Card: React.FC<CardProps>;
+
+export declare interface CardProps {
+    /** Image URL for the card */
+    image?: string;
+    /** Alt text for accessibility */
+    imageAlt?: string;
+    /** Main label/title text */
+    label?: string;
+    /** Price text */
+    price?: string;
+    /** Rating value (1-5) */
+    stars?: number;
+    /** Superior hotel indicator */
+    isSuperior?: boolean;
+    /** Badge configuration */
+    badge?: {
+        text: string;
+        variant?: 'primary' | 'secondary';
+    };
+    title?: string;
+    location?: string;
+    onClick?: () => void;
+    /** Additional CSS classes */
+    className?: string;
+    /** Card size variant */
+    variant?: 'desktop' | 'mobile';
+    /** Rating */
+    hasRating?: boolean;
+    /** Padding */
+    withPadding?: boolean;
+    /** height */
+    withHeight?: boolean;
+    /** Rating Comments */
+    isRatingComments?: boolean;
+    /**
+     * Optional usage context to conditionally apply styles or behavior
+     * based on where the Card is used (e.g., 'hotel-deals')
+     */
+    context?: 'hotel-deals' | string;
+}
+
+export declare const Checkbox: React.FC<CheckboxProps>;
+
+export declare interface CheckboxProps {
+    label?: string;
+    checked?: boolean;
+    defaultChecked?: boolean;
+    onChange?: (checked: boolean) => void;
+    disabled?: boolean;
+    error?: boolean;
+    name?: string;
+    id?: string;
+    className?: string;
+    size?: 'small' | 'medium';
+}
+
+/**
+ * Chip Component
+ *
+ * A removable filter chip component matching Figma specs (689-7141)
+ *
+ * Features:
+ * - Two sizes: small (for filter rows), medium (default)
+ * - Three states: idle, active, disabled
+ * - Optional count badge
+ * - Optional removable (X icon)
+ */
+export declare const Chip: default_2.FC<ChipProps>;
+
+export declare interface ChipProps {
+    /** The label text displayed in the chip */
+    label: string;
+    /** Optional count/number displayed in a badge (for filter chips) */
+    count?: number | string;
+    /** Size variant */
+    size?: ChipSize;
+    /** State variant */
+    state?: ChipState;
+    /** Whether the chip is removable (shows X icon) */
+    removable?: boolean;
+    /** Click handler for the chip (used for selection/toggle) */
+    onClick?: () => void;
+    /** Handler called when remove button is clicked */
+    onRemove?: () => void;
+    /** Additional className for custom styling */
+    className?: string;
+    /** Disable the chip */
+    disabled?: boolean;
+}
+
+declare type ChipSize = 'small' | 'medium';
+
+declare type ChipState = 'idle' | 'active' | 'disabled';
+
+declare interface DateOption {
+    value: string;
+    label: string;
+}
+
+export declare const Divider: React.FC<DividerProps>;
+
+export declare interface DividerProps {
+    /**
+     * Optional label to display in the middle of the divider
+     */
+    label?: ReactNode;
+    /**
+     * Orientation of the divider
+     * @default 'horizontal'
+     */
+    orientation?: 'horizontal' | 'vertical';
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+    variant?: string;
+}
+
+export declare const Dropdown: default_2.FC<DropdownProps_2>;
+
+export declare interface DropdownProps {
+}
+
+declare interface DropdownProps_2 {
+    options?: DateOption[];
+    disabled?: boolean;
+    error?: boolean;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    className?: string;
+    name?: string;
+    id?: string;
+}
+
+/**
+ * HotelCardSkeleton - Loading placeholder for hotel cards
+ *
+ * Displays a shimmer animation while hotel data is loading.
+ * Matches the layout of HotelCard component.
+ */
+export declare const HotelCardSkeleton: default_2.FC;
+
+/**
+ * HotelCardUIProvider - Configure shared UI components
+ *
+ * Wrap your app with this provider to configure locale, currency, and responsive mode
+ * for all @hotelcard/ui components.
+ *
+ * @example
+ * ```tsx
+ * import { HotelCardUIProvider } from '@hotelcard/ui';
+ *
+ * <HotelCardUIProvider locale="de" currency="CHF">
+ *   <App />
+ * </HotelCardUIProvider>
+ * ```
+ */
+export declare const HotelCardUIProvider: default_2.FC<HotelCardUIProviderProps>;
+
+export declare interface HotelCardUIProviderProps {
+    /** Current locale */
+    locale?: Locale;
+    /** Currency code */
+    currency?: string;
+    /** Whether running on desktop */
+    isDesktop?: boolean;
+    /** Base URL for API calls (e.g., 'https://hotelcard.ch') */
+    apiBaseUrl?: string;
+    /** Optional custom translation function (overrides internal translations) */
+    t?: TranslateFunction;
+    children: ReactNode;
+}
+
+export declare const Input: default_2.FC<InputProps>;
+
+export declare interface InputProps {
+    label?: string;
+    placeholder?: string;
+    helper?: string;
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    onFocus?: () => void;
+    onBlur?: () => void;
+    type?: 'text' | 'email' | 'password' | 'tel' | 'number' | 'search' | 'url' | 'date';
+    error?: boolean;
+    disabled?: boolean;
+    leftIcon?: React.ReactNode;
+    rightIcon?: React.ReactNode;
+    prefix?: string;
+    className?: string;
+    inputClassName?: string;
+    name?: string;
+    id?: string;
+    required?: boolean;
+    autoComplete?: string;
+    autoFocus?: boolean;
+    readOnly?: boolean;
+    variant?: 'default' | 'phone' | 'dropdown';
+    phonePrefix?: string;
+    onPhonePrefixChange?: (value: string) => void;
+    onPhonePrefixBlur?: () => void;
+    options?: Array<{
+        value: string;
+        label: string;
+        icon?: React.ReactNode;
+    }>;
+    onSelect?: (value: string) => void;
+    dropdownOpen?: boolean;
+    onDropdownToggle?: (open: boolean) => void;
+    wrapperClassName?: string;
+    inputProps?: React.InputHTMLAttributes<HTMLInputElement>;
+}
+
+export declare type Locale = keyof typeof translations;
+
+/**
+ * Pin Component
+ *
+ * Map marker pin with price or hotel icon variants.
+ * Used for displaying hotel markers on maps.
+ *
+ * @example
+ * // Price pin (default)
+ * <Pin price={150} currency="CHF" showFavorite />
+ *
+ * // Viewed price pin (secondary style)
+ * <Pin price={150} viewed showFavorite />
+ *
+ * // Hotel pin (for clusters)
+ * <Pin variant="hotel" />
+ */
+export declare const Pin: default_2.ForwardRefExoticComponent<PinProps & default_2.RefAttributes<HTMLButtonElement>>;
+
+export declare interface PinProps {
+    /**
+     * Pin variant
+     * - 'price': Shows currency and price with optional favorite icon
+     * - 'hotel': Shows house icon only (for cluster markers)
+     */
+    variant?: 'price' | 'hotel';
+    /**
+     * Whether the hotel has been viewed (changes to secondary/outline style)
+     */
+    viewed?: boolean;
+    /**
+     * Currency code to display (only for price variant)
+     * @default 'CHF'
+     */
+    currency?: string;
+    /**
+     * Price to display (only for price variant)
+     */
+    price?: number | string;
+    /**
+     * Whether to show the favorite (heart) icon (only for price variant)
+     */
+    showFavorite?: boolean;
+    /**
+     * Whether the pin is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Click handler
+     */
+    onClick?: () => void;
+    /**
+     * Additional class name
+     */
+    className?: string;
+}
+
+export declare const RadioButton: default_2.FC<RadioButtonProps>;
+
+export declare interface RadioButtonProps {
+    /**
+     * Whether the radio button is checked
+     */
+    checked: boolean;
+    /**
+     * Callback fired when the radio button state changes
+     */
+    onChange: (checked: boolean) => void;
+    /**
+     * The id attribute of the radio button (used to associate the label via htmlFor)
+     */
+    id?: string;
+    /**
+     * The name attribute of the radio button (for grouping)
+     */
+    name?: string;
+    /**
+     * The value attribute of the radio button
+     */
+    value?: string;
+    /**
+     * Whether the radio button is disabled
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+    /**
+     * Label text for the radio button
+     */
+    label?: string;
+    /**
+     * Autocomplete attribute
+     */
+    autoComplete?: string;
+}
+
+export declare const Rating: React.FC<RatingProps>;
+
+export declare interface RatingProps {
+    /**
+     * Rating variant
+     * @default 'stars'
+     */
+    variant?: 'block' | 'result' | 'stars';
+    /**
+     * Rating value (0-5)
+     */
+    value: number;
+    /**
+     * Maximum rating value
+     * @default 5
+     */
+    maxValue?: number;
+    /**
+     * Show numeric value
+     * @default false
+     */
+    showValue?: boolean;
+    /**
+     * Name/title text (for block variant)
+     */
+    name?: string;
+    /**
+     * Date text (for block variant)
+     */
+    date?: string;
+    /**
+     * Quote text (for block variant)
+     */
+    quote?: string;
+    /**
+     * Size of the rating
+     * @default 'medium'
+     */
+    size?: 'small' | 'medium' | 'large';
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+}
+
+export declare interface ResponsiveState {
+    /** True when screen width >= 1024px (desktop only, excludes tablet) */
+    isDesktop: boolean;
+    /** True when screen width < 768px */
+    isMobile: boolean;
+    /** True when screen width is between 768px and 1023px */
+    isTablet: boolean;
+    /** True when screen width >= 1024px (same as isDesktop) */
+    isLargeDesktop: boolean;
+    /** Current window width in pixels */
+    width: number;
+}
+
+/** Translation function type */
+export declare type TranslateFunction = (key: string, optionsOrFallback?: TranslateOptions | string, fallback?: string) => string;
+
+/** Translation options for interpolation */
+export declare interface TranslateOptions {
+    [key: string]: string | number;
+}
+
+declare const translations: {
+    readonly de: {
+        button: {
+            order: string;
+            "order-navigation": string;
+            "order-hc": string;
+            "my-account": string;
+            search: string;
+            "back-to-top": string;
+        };
+        link: {
+            "member-benefits": string;
+            "view-all-hotels": string;
+            "search-by-map": string;
+            "search-by-region": string;
+            "search-by-experience": string;
+            "travel-inspiration": string;
+            "booking-tips-and-tricks": string;
+            home: string;
+            "all-hotel-deals": string;
+            "search-results": string;
+        };
+        general: {
+            "signed-out": string;
+            "room-price": string;
+            guarantee: string;
+            contact: string;
+            "breakfast-included": string;
+            "free-cancellation": string;
+            "suggested-destinations": string;
+            "when-months": string;
+            "hotel-deals-found": string;
+            "no-results": string;
+            "unavailable-for-selected-days": string;
+            "cant-accommodate-all": string;
+            "reset-destination": string;
+        };
+        label: {
+            "price-from": string;
+            "price-for": string;
+            "per-room-night": string;
+            new: string;
+            anytime: string;
+            anywhere: string;
+            dates: string;
+            flexible: string;
+            where: string;
+            when: string;
+            who: string;
+            nearby: string;
+            hotels: string;
+            filter: string;
+            sort: string;
+            map: string;
+            rating: string;
+            "rating-excellent": string;
+            "rating-very-good": string;
+            "rating-good": string;
+            "rating-fair": string;
+            "rating-none": string;
+            clear: string;
+            months: string;
+        };
+        product: {
+            "6m": string;
+            "1y": string;
+            "2y": string;
+            "3y": string;
+            "price-6m": string;
+            "price-6m-disc": string;
+            "price-1y": string;
+            "price-1y-disc": string;
+            "price-2y": string;
+            "price-2y-disc": string;
+            "price-3y": string;
+            "price-3y-disc": string;
+            "price-gift": string;
+            "price-gift-disc": string;
+            "1y-chc": string;
+            "price-1y-chc": string;
+            "price-1y-disc-chc": string;
+        };
+        subheadline: {
+            "your-hc": string;
+            "popular-hotels": string;
+            "no-results": string;
+            "sort-by": string;
+        };
+        form: {
+            guests: string;
+            guest: string;
+            adults: string;
+            children: string;
+            pet: string;
+            "age-of-child": string;
+            age: string;
+            "age-error": string;
+        };
+        filter: {
+            filters: string;
+            destination: string;
+            experience: string;
+            "show-all": string;
+            price: string;
+            discount: string;
+            services: string;
+            meals: string;
+            "hotel-category": string;
+            reviews: string;
+            mobility: string;
+            "wellness-spa": string;
+            "price-high-low": string;
+            "price-low-high": string;
+            "best-rating": string;
+            "most-popular": string;
+            "newest-hotels": string;
+            relevance: string;
+            selected: string;
+            "clear-all": string;
+            options: string;
+            "hotellerie-suisse": string;
+            trustyou: string;
+            "select-all": string;
+            reset: string;
+            "breakfast-included": string;
+            "min-price": string;
+            "max-price": string;
+            "show-less": string;
+        };
+        headline: {
+            "no-results": string;
+        };
+        meta_title: string;
+        meta_description: string;
+        title: string;
+        common: {
+            close: string;
+        };
+        loading: string;
+        retry: string;
+        close_map: string;
+        seo: {
+            default_title: string;
+            location_title: string;
+            region_title: string;
+            experience_title: string;
+            default_description: string;
+            location_description: string;
+        };
+        modal: {
+            close_search: string;
+            placeholder_anywhere: string;
+            recent_searches: string;
+            remove_recent: string;
+            all_destinations: string;
+        };
+        map: {
+            open_search: string;
+            open_filters: string;
+            switch_to_list: string;
+            zoom_in: string;
+            zoom_out: string;
+            no_location_data: string;
+            hotels_missing_coordinates: string;
+            no_hotels_in_area: string;
+        };
+        view: {
+            list: string;
+        };
+        breadcrumb: {
+            properties_found: string;
+            properties_found_location: string;
+        };
+        aria: {
+            search_results_breadcrumb: string;
+            close: string;
+            previous_image: string;
+            next_image: string;
+            add_to_favorites: string;
+            remove_from_favorites: string;
+            list_view: string;
+            map_view: string;
+        };
+        breadcrumb_nav: {
+            home: string;
+        };
+        guest_selector: {
+            decrease_adults: string;
+            increase_adults: string;
+            decrease_children: string;
+            increase_children: string;
+            decrease_infants: string;
+            increase_infants: string;
+            toggle_infants: string;
+        };
+        search_form: {
+            location_placeholder: string;
+            distance_any: string;
+            distance_5: string;
+            distance_10: string;
+            distance_20: string;
+            distance_30: string;
+            distance_50: string;
+            searching: string;
+            reset_filters: string;
+        };
+        dropdown: {
+            hotels: string;
+            cities: string;
+            regions: string;
+            countries: string;
+            "no-results": string;
+        };
+        filters: {
+            show_filters: string;
+            open_filters: string;
+            filter_by: string;
+            hotel_rating: string;
+            show_results: string;
+            apply_filters: string;
+            close_filters: string;
+            view_in_map: string;
+            popular_filters: string;
+            destinations: string;
+            options_title: string;
+            options: {
+                instant_booking: string;
+                pets_allowed: string;
+                free_cancellation: string;
+            };
+            category: {
+                footer_prefix: string;
+            };
+            show_less: string;
+            selected: string;
+            clear_all: string;
+        };
+        date_selector: {
+            apply: string;
+            months_selected: string;
+        };
+        star_rating: {
+            "5_stars": string;
+            "4_stars": string;
+            "3_stars": string;
+            "2_stars": string;
+            not_classified: string;
+            swiss_lodge: string;
+        };
+        results: {
+            hotels_found: string;
+            load_more: string;
+            loading: string;
+            end_of_results: string;
+            no_results: string;
+            try_different_search: string;
+            unavailable_banner_title: string;
+            unavailable_banner_description: string;
+        };
+        no_results: {
+            title: string;
+            subtitle: string;
+            description: string;
+            description_with_filters: string;
+            clear_filters: string;
+        };
+        errors: {
+            search_failed: string;
+            load_more_failed: string;
+        };
+        error: {
+            title: string;
+            description: string;
+            retry: string;
+        };
+        pagination: {
+            label: string;
+            previous: string;
+            previous_short: string;
+            next: string;
+            next_short: string;
+            page: string;
+        };
+        hotel_card: {
+            rating: string;
+            price_from: string;
+            not_available: string;
+        };
+        badges: {
+            new: string;
+        };
+        booking: {
+            countdown_days: string;
+            card_directions: string;
+            card_message_from_hotel: string;
+            card_more_about_booking: string;
+            card_book_again: string;
+            countdown_add_to_calendar: string;
+            status_confirmed: string;
+            status_completed: string;
+            status_cancelled: string;
+            details_check_in: string;
+            details_check_out: string;
+            details_guests: string;
+            details_room: string;
+            details_breakfast: string;
+            details_cancellation: string;
+            details_cancel_booking: string;
+            details_booked: string;
+            details_room_price: string;
+            details_saved_with_hotelcard: string;
+            details_total_cost: string;
+        };
+        membership: {
+            valid_thru: string;
+        };
+    };
+    readonly en: {
+        button: {
+            order: string;
+            "order-navigation": string;
+            "order-hc": string;
+            "my-account": string;
+            search: string;
+            "back-to-top": string;
+        };
+        link: {
+            "member-benefits": string;
+            "view-all-hotels": string;
+            "search-by-map": string;
+            "search-by-region": string;
+            "search-by-experience": string;
+            "travel-inspiration": string;
+            "booking-tips-and-tricks": string;
+            home: string;
+            "all-hotel-deals": string;
+            "search-results": string;
+        };
+        general: {
+            "signed-out": string;
+            "room-price": string;
+            guarantee: string;
+            contact: string;
+            "breakfast-included": string;
+            "free-cancellation": string;
+            "suggested-destinations": string;
+            "when-months": string;
+            "hotel-deals-found": string;
+            "no-results": string;
+            "unavailable-for-selected-days": string;
+            "cant-accommodate-all": string;
+            "reset-destination": string;
+        };
+        label: {
+            "price-from": string;
+            "price-for": string;
+            "per-room-night": string;
+            new: string;
+            anytime: string;
+            anywhere: string;
+            dates: string;
+            flexible: string;
+            where: string;
+            when: string;
+            who: string;
+            nearby: string;
+            hotels: string;
+            filter: string;
+            sort: string;
+            map: string;
+            rating: string;
+            "rating-excellent": string;
+            "rating-very-good": string;
+            "rating-good": string;
+            "rating-fair": string;
+            "rating-none": string;
+            clear: string;
+            months: string;
+        };
+        product: {
+            "6m": string;
+            "1y": string;
+            "2y": string;
+            "3y": string;
+            "price-6m": string;
+            "price-6m-disc": string;
+            "price-1y": string;
+            "price-1y-disc": string;
+            "price-2y": string;
+            "price-2y-disc": string;
+            "price-3y": string;
+            "price-3y-disc": string;
+            "price-gift": string;
+            "price-gift-disc": string;
+            "1y-chc": string;
+            "price-1y-chc": string;
+            "price-1y-disc-chc": string;
+        };
+        subheadline: {
+            "your-hc": string;
+            "popular-hotels": string;
+            "no-results": string;
+            "sort-by": string;
+        };
+        form: {
+            guests: string;
+            guest: string;
+            adults: string;
+            children: string;
+            pet: string;
+            "age-of-child": string;
+            age: string;
+            "age-error": string;
+        };
+        filter: {
+            filters: string;
+            destination: string;
+            experience: string;
+            "show-all": string;
+            price: string;
+            discount: string;
+            services: string;
+            meals: string;
+            "hotel-category": string;
+            reviews: string;
+            mobility: string;
+            "wellness-spa": string;
+            "price-high-low": string;
+            "price-low-high": string;
+            "best-rating": string;
+            "most-popular": string;
+            "newest-hotels": string;
+            relevance: string;
+            selected: string;
+            "clear-all": string;
+            options: string;
+            "hotellerie-suisse": string;
+            trustyou: string;
+            "select-all": string;
+            reset: string;
+            "breakfast-included": string;
+            "min-price": string;
+            "max-price": string;
+            "show-less": string;
+        };
+        headline: {
+            "no-results": string;
+        };
+        meta_title: string;
+        meta_description: string;
+        title: string;
+        common: {
+            close: string;
+        };
+        loading: string;
+        retry: string;
+        close_map: string;
+        seo: {
+            default_title: string;
+            location_title: string;
+            region_title: string;
+            experience_title: string;
+            default_description: string;
+            location_description: string;
+        };
+        modal: {
+            close_search: string;
+            placeholder_anywhere: string;
+            recent_searches: string;
+            remove_recent: string;
+            all_destinations: string;
+        };
+        map: {
+            open_search: string;
+            open_filters: string;
+            switch_to_list: string;
+            zoom_in: string;
+            zoom_out: string;
+            no_location_data: string;
+            hotels_missing_coordinates: string;
+            no_hotels_in_area: string;
+        };
+        view: {
+            list: string;
+        };
+        breadcrumb: {
+            properties_found: string;
+            properties_found_location: string;
+        };
+        aria: {
+            search_results_breadcrumb: string;
+            close: string;
+            previous_image: string;
+            next_image: string;
+            add_to_favorites: string;
+            remove_from_favorites: string;
+            list_view: string;
+            map_view: string;
+        };
+        breadcrumb_nav: {
+            home: string;
+        };
+        guest_selector: {
+            adults_description: string;
+            children_description: string;
+            infants_description: string;
+            decrease_adults: string;
+            increase_adults: string;
+            decrease_children: string;
+            increase_children: string;
+            decrease_infants: string;
+            increase_infants: string;
+            toggle_infants: string;
+        };
+        search_form: {
+            location_placeholder: string;
+            distance_any: string;
+            distance_5: string;
+            distance_10: string;
+            distance_20: string;
+            distance_30: string;
+            distance_50: string;
+            searching: string;
+            reset_filters: string;
+        };
+        dropdown: {
+            hotels: string;
+            cities: string;
+            regions: string;
+            countries: string;
+            "no-results": string;
+        };
+        filters: {
+            show_filters: string;
+            open_filters: string;
+            filter_by: string;
+            hotel_rating: string;
+            show_results: string;
+            apply_filters: string;
+            close_filters: string;
+            view_in_map: string;
+            popular_filters: string;
+            show_less: string;
+            selected: string;
+            clear_all: string;
+            options: {
+                instant_booking: string;
+                pets_allowed: string;
+                free_cancellation: string;
+            };
+        };
+        date_selector: {
+            apply: string;
+            months_selected: string;
+        };
+        star_rating: {
+            "5_stars": string;
+            "4_stars": string;
+            "3_stars": string;
+            "2_stars": string;
+            not_classified: string;
+            swiss_lodge: string;
+        };
+        results: {
+            hotels_found: string;
+            load_more: string;
+            loading: string;
+            end_of_results: string;
+            no_results: string;
+            try_different_search: string;
+            unavailable_banner_title: string;
+            unavailable_banner_description: string;
+        };
+        errors: {
+            search_failed: string;
+            load_more_failed: string;
+        };
+        error: {
+            title: string;
+            description: string;
+            retry: string;
+        };
+        no_results: {
+            title: string;
+            description: string;
+            description_with_filters: string;
+            clear_filters: string;
+        };
+        pagination: {
+            label: string;
+            previous: string;
+            previous_short: string;
+            next: string;
+            next_short: string;
+            page: string;
+        };
+        hotel_card: {
+            rating: string;
+            price_from: string;
+            not_available: string;
+        };
+        badges: {
+            new: string;
+        };
+        clear_location: string;
+        clear_date: string;
+        clear_guests: string;
+        booking: {
+            countdown_days: string;
+            card_directions: string;
+            card_message_from_hotel: string;
+            card_more_about_booking: string;
+            card_book_again: string;
+            countdown_add_to_calendar: string;
+            status_confirmed: string;
+            status_completed: string;
+            status_cancelled: string;
+            details_check_in: string;
+            details_check_out: string;
+            details_guests: string;
+            details_room: string;
+            details_breakfast: string;
+            details_cancellation: string;
+            details_cancel_booking: string;
+            details_booked: string;
+            details_room_price: string;
+            details_saved_with_hotelcard: string;
+            details_total_cost: string;
+        };
+        membership: {
+            valid_thru: string;
+        };
+    };
+    readonly fr: {
+        button: {
+            order: string;
+            "order-navigation": string;
+            "order-hc": string;
+            "my-account": string;
+            search: string;
+            "back-to-top": string;
+        };
+        link: {
+            "member-benefits": string;
+            "view-all-hotels": string;
+            "search-by-map": string;
+            "search-by-region": string;
+            "search-by-experience": string;
+            "travel-inspiration": string;
+            "booking-tips-and-tricks": string;
+            home: string;
+            "all-hotel-deals": string;
+            "search-results": string;
+        };
+        general: {
+            "signed-out": string;
+            "room-price": string;
+            guarantee: string;
+            contact: string;
+            "breakfast-included": string;
+            "free-cancellation": string;
+            "suggested-destinations": string;
+            "when-months": string;
+            "hotel-deals-found": string;
+            "no-results": string;
+            "unavailable-for-selected-days": string;
+            "cant-accommodate-all": string;
+            "reset-destination": string;
+        };
+        label: {
+            "price-from": string;
+            "price-for": string;
+            "per-room-night": string;
+            new: string;
+            anytime: string;
+            anywhere: string;
+            dates: string;
+            flexible: string;
+            where: string;
+            when: string;
+            who: string;
+            nearby: string;
+            hotels: string;
+            filter: string;
+            sort: string;
+            map: string;
+            rating: string;
+            "rating-excellent": string;
+            "rating-very-good": string;
+            "rating-good": string;
+            "rating-fair": string;
+            "rating-none": string;
+            clear: string;
+            months: string;
+        };
+        product: {
+            "6m": string;
+            "1y": string;
+            "2y": string;
+            "3y": string;
+            "price-6m": string;
+            "price-6m-disc": string;
+            "price-1y": string;
+            "price-1y-disc": string;
+            "price-2y": string;
+            "price-2y-disc": string;
+            "price-3y": string;
+            "price-3y-disc": string;
+            "price-gift": string;
+            "price-gift-disc": string;
+            "1y-chc": string;
+            "price-1y-chc": string;
+            "price-1y-disc-chc": string;
+        };
+        subheadline: {
+            "your-hc": string;
+            "popular-hotels": string;
+            "no-results": string;
+            "sort-by": string;
+        };
+        form: {
+            guests: string;
+            guest: string;
+            adults: string;
+            children: string;
+            pet: string;
+            "age-of-child": string;
+            age: string;
+            "age-error": string;
+        };
+        filter: {
+            filters: string;
+            destination: string;
+            experience: string;
+            "show-all": string;
+            price: string;
+            discount: string;
+            services: string;
+            meals: string;
+            "hotel-category": string;
+            reviews: string;
+            mobility: string;
+            "wellness-spa": string;
+            "price-high-low": string;
+            "price-low-high": string;
+            "best-rating": string;
+            "most-popular": string;
+            "newest-hotels": string;
+            relevance: string;
+            selected: string;
+            "clear-all": string;
+            options: string;
+            "hotellerie-suisse": string;
+            trustyou: string;
+            "select-all": string;
+            reset: string;
+            "breakfast-included": string;
+            "min-price": string;
+            "max-price": string;
+            "show-less": string;
+        };
+        headline: {
+            "no-results": string;
+        };
+        meta_title: string;
+        meta_description: string;
+        title: string;
+        common: {
+            close: string;
+        };
+        loading: string;
+        retry: string;
+        close_map: string;
+        seo: {
+            default_title: string;
+            location_title: string;
+            region_title: string;
+            experience_title: string;
+            default_description: string;
+            location_description: string;
+        };
+        modal: {
+            close_search: string;
+            placeholder_anywhere: string;
+            recent_searches: string;
+            remove_recent: string;
+            all_destinations: string;
+        };
+        map: {
+            open_search: string;
+            open_filters: string;
+            switch_to_list: string;
+            zoom_in: string;
+            zoom_out: string;
+            no_location_data: string;
+            hotels_missing_coordinates: string;
+            no_hotels_in_area: string;
+        };
+        view: {
+            list: string;
+        };
+        breadcrumb: {
+            properties_found: string;
+            properties_found_location: string;
+        };
+        aria: {
+            search_results_breadcrumb: string;
+            close: string;
+            previous_image: string;
+            next_image: string;
+            add_to_favorites: string;
+            remove_from_favorites: string;
+            list_view: string;
+            map_view: string;
+        };
+        breadcrumb_nav: {
+            home: string;
+        };
+        guest_selector: {
+            decrease_adults: string;
+            increase_adults: string;
+            decrease_children: string;
+            increase_children: string;
+            decrease_infants: string;
+            increase_infants: string;
+            toggle_infants: string;
+        };
+        search_form: {
+            location_placeholder: string;
+            distance_any: string;
+            distance_5: string;
+            distance_10: string;
+            distance_20: string;
+            distance_30: string;
+            distance_50: string;
+            searching: string;
+            reset_filters: string;
+        };
+        dropdown: {
+            hotels: string;
+            cities: string;
+            regions: string;
+            countries: string;
+            "no-results": string;
+        };
+        filters: {
+            show_filters: string;
+            open_filters: string;
+            filter_by: string;
+            hotel_rating: string;
+            show_results: string;
+            apply_filters: string;
+            close_filters: string;
+            view_in_map: string;
+            popular_filters: string;
+            destinations: string;
+            options_title: string;
+            options: {
+                instant_booking: string;
+                pets_allowed: string;
+                free_cancellation: string;
+            };
+            category: {
+                footer_prefix: string;
+            };
+            show_less: string;
+            selected: string;
+            clear_all: string;
+        };
+        date_selector: {
+            apply: string;
+            months_selected: string;
+        };
+        star_rating: {
+            "5_stars": string;
+            "4_stars": string;
+            "3_stars": string;
+            "2_stars": string;
+            not_classified: string;
+            swiss_lodge: string;
+        };
+        results: {
+            hotels_found: string;
+            load_more: string;
+            loading: string;
+            end_of_results: string;
+            no_results: string;
+            try_different_search: string;
+            unavailable_banner_title: string;
+            unavailable_banner_description: string;
+        };
+        no_results: {
+            title: string;
+            subtitle: string;
+            description: string;
+            description_with_filters: string;
+            clear_filters: string;
+        };
+        errors: {
+            search_failed: string;
+            load_more_failed: string;
+        };
+        error: {
+            title: string;
+            description: string;
+            retry: string;
+        };
+        pagination: {
+            label: string;
+            previous: string;
+            previous_short: string;
+            next: string;
+            next_short: string;
+            page: string;
+        };
+        hotel_card: {
+            rating: string;
+            price_from: string;
+            not_available: string;
+        };
+        badges: {
+            new: string;
+        };
+        booking: {
+            countdown_days: string;
+            card_directions: string;
+            card_message_from_hotel: string;
+            card_more_about_booking: string;
+            card_book_again: string;
+            countdown_add_to_calendar: string;
+            status_confirmed: string;
+            status_completed: string;
+            status_cancelled: string;
+            details_check_in: string;
+            details_check_out: string;
+            details_guests: string;
+            details_room: string;
+            details_breakfast: string;
+            details_cancellation: string;
+            details_cancel_booking: string;
+            details_booked: string;
+            details_room_price: string;
+            details_saved_with_hotelcard: string;
+            details_total_cost: string;
+        };
+        membership: {
+            valid_thru: string;
+        };
+    };
+    readonly it: {
+        button: {
+            order: string;
+            "order-navigation": string;
+            "order-hc": string;
+            "my-account": string;
+            search: string;
+            "back-to-top": string;
+        };
+        link: {
+            "member-benefits": string;
+            "view-all-hotels": string;
+            "search-by-map": string;
+            "search-by-region": string;
+            "search-by-experience": string;
+            "travel-inspiration": string;
+            "booking-tips-and-tricks": string;
+            home: string;
+            "all-hotel-deals": string;
+            "search-results": string;
+        };
+        general: {
+            "signed-out": string;
+            "room-price": string;
+            guarantee: string;
+            contact: string;
+            "breakfast-included": string;
+            "free-cancellation": string;
+            "suggested-destinations": string;
+            "when-months": string;
+            "hotel-deals-found": string;
+            "no-results": string;
+            "unavailable-for-selected-days": string;
+            "cant-accommodate-all": string;
+            "reset-destination": string;
+        };
+        label: {
+            "price-from": string;
+            "price-for": string;
+            "per-room-night": string;
+            new: string;
+            anytime: string;
+            anywhere: string;
+            dates: string;
+            flexible: string;
+            where: string;
+            when: string;
+            who: string;
+            nearby: string;
+            hotels: string;
+            filter: string;
+            sort: string;
+            map: string;
+            rating: string;
+            "rating-excellent": string;
+            "rating-very-good": string;
+            "rating-good": string;
+            "rating-fair": string;
+            "rating-none": string;
+            clear: string;
+            months: string;
+        };
+        product: {
+            "6m": string;
+            "1y": string;
+            "2y": string;
+            "3y": string;
+            "price-6m": string;
+            "price-6m-disc": string;
+            "price-1y": string;
+            "price-1y-disc": string;
+            "price-2y": string;
+            "price-2y-disc": string;
+            "price-3y": string;
+            "price-3y-disc": string;
+            "price-gift": string;
+            "price-gift-disc": string;
+            "1y-chc": string;
+            "price-1y-chc": string;
+            "price-1y-disc-chc": string;
+        };
+        subheadline: {
+            "your-hc": string;
+            "popular-hotels": string;
+            "no-results": string;
+            "sort-by": string;
+        };
+        form: {
+            guests: string;
+            guest: string;
+            adults: string;
+            children: string;
+            pet: string;
+            "age-of-child": string;
+            age: string;
+            "age-error": string;
+        };
+        filter: {
+            filters: string;
+            destination: string;
+            experience: string;
+            "show-all": string;
+            price: string;
+            discount: string;
+            services: string;
+            meals: string;
+            "hotel-category": string;
+            reviews: string;
+            mobility: string;
+            "wellness-spa": string;
+            "price-high-low": string;
+            "price-low-high": string;
+            "best-rating": string;
+            "most-popular": string;
+            "newest-hotels": string;
+            relevance: string;
+            selected: string;
+            "clear-all": string;
+            options: string;
+            "hotellerie-suisse": string;
+            trustyou: string;
+            "select-all": string;
+            reset: string;
+            "breakfast-included": string;
+            "min-price": string;
+            "max-price": string;
+            "show-less": string;
+        };
+        headline: {
+            "no-results": string;
+        };
+        meta_title: string;
+        meta_description: string;
+        title: string;
+        common: {
+            close: string;
+        };
+        loading: string;
+        retry: string;
+        close_map: string;
+        seo: {
+            default_title: string;
+            location_title: string;
+            region_title: string;
+            experience_title: string;
+            default_description: string;
+            location_description: string;
+        };
+        modal: {
+            close_search: string;
+            placeholder_anywhere: string;
+            recent_searches: string;
+            remove_recent: string;
+            all_destinations: string;
+        };
+        map: {
+            open_search: string;
+            open_filters: string;
+            switch_to_list: string;
+            zoom_in: string;
+            zoom_out: string;
+            no_location_data: string;
+            hotels_missing_coordinates: string;
+            no_hotels_in_area: string;
+        };
+        view: {
+            list: string;
+        };
+        breadcrumb: {
+            properties_found: string;
+            properties_found_location: string;
+        };
+        aria: {
+            search_results_breadcrumb: string;
+            close: string;
+            previous_image: string;
+            next_image: string;
+            add_to_favorites: string;
+            remove_from_favorites: string;
+            list_view: string;
+            map_view: string;
+        };
+        breadcrumb_nav: {
+            home: string;
+        };
+        guest_selector: {
+            decrease_adults: string;
+            increase_adults: string;
+            decrease_children: string;
+            increase_children: string;
+            decrease_infants: string;
+            increase_infants: string;
+            toggle_infants: string;
+        };
+        search_form: {
+            location_placeholder: string;
+            distance_any: string;
+            distance_5: string;
+            distance_10: string;
+            distance_20: string;
+            distance_30: string;
+            distance_50: string;
+            searching: string;
+            reset_filters: string;
+        };
+        dropdown: {
+            hotels: string;
+            cities: string;
+            regions: string;
+            countries: string;
+            "no-results": string;
+        };
+        filters: {
+            show_filters: string;
+            open_filters: string;
+            filter_by: string;
+            hotel_rating: string;
+            show_results: string;
+            apply_filters: string;
+            close_filters: string;
+            view_in_map: string;
+            popular_filters: string;
+            destinations: string;
+            options_title: string;
+            options: {
+                instant_booking: string;
+                pets_allowed: string;
+                free_cancellation: string;
+            };
+            category: {
+                footer_prefix: string;
+            };
+            show_less: string;
+            selected: string;
+            clear_all: string;
+        };
+        date_selector: {
+            apply: string;
+            months_selected: string;
+        };
+        star_rating: {
+            "5_stars": string;
+            "4_stars": string;
+            "3_stars": string;
+            "2_stars": string;
+            not_classified: string;
+            swiss_lodge: string;
+        };
+        results: {
+            hotels_found: string;
+            load_more: string;
+            loading: string;
+            end_of_results: string;
+            no_results: string;
+            try_different_search: string;
+            unavailable_banner_title: string;
+            unavailable_banner_description: string;
+        };
+        no_results: {
+            title: string;
+            subtitle: string;
+            description: string;
+            description_with_filters: string;
+            clear_filters: string;
+        };
+        errors: {
+            search_failed: string;
+            load_more_failed: string;
+        };
+        error: {
+            title: string;
+            description: string;
+            retry: string;
+        };
+        pagination: {
+            label: string;
+            previous: string;
+            previous_short: string;
+            next: string;
+            next_short: string;
+            page: string;
+        };
+        hotel_card: {
+            rating: string;
+            price_from: string;
+            not_available: string;
+        };
+        badges: {
+            new: string;
+        };
+        booking: {
+            countdown_days: string;
+            card_directions: string;
+            card_message_from_hotel: string;
+            card_more_about_booking: string;
+            card_book_again: string;
+            countdown_add_to_calendar: string;
+            status_confirmed: string;
+            status_completed: string;
+            status_cancelled: string;
+            details_check_in: string;
+            details_check_out: string;
+            details_guests: string;
+            details_room: string;
+            details_breakfast: string;
+            details_cancellation: string;
+            details_cancel_booking: string;
+            details_booked: string;
+            details_room_price: string;
+            details_saved_with_hotelcard: string;
+            details_total_cost: string;
+        };
+        membership: {
+            valid_thru: string;
+        };
+    };
+};
+
+export declare interface UIContextValue {
+    /** Current locale (e.g., 'de', 'en', 'fr', 'it') */
+    locale: Locale;
+    /** Currency code (e.g., 'CHF', 'EUR') */
+    currency: string;
+    /** Whether the app is running on desktop (default: false for mobile-first) */
+    isDesktop: boolean;
+    /** Base URL for API calls (e.g., 'https://hotelcard.ch') */
+    apiBaseUrl: string;
+    /** Translation function - looks up keys from internal translations */
+    t: TranslateFunction;
+}
+
+export declare function useDebounce<T extends (...args: any[]) => any>(callback: T, delay: number): (...args: Parameters<T>) => void;
+
+export declare const useResponsive: () => ResponsiveState;
+
+/**
+ * Hook to access UI context values
+ * Returns locale, currency, and isDesktop
+ */
+export declare const useUIContext: () => UIContextValue;
+
+export declare const VERSION = "0.1.0";
+
+export { }