@forgebuild/hotal-ui 0.23.15 → 0.23.19

package/dist/index.d.ts

@@ -1,1099 +1,1191 @@
-export interface ReservationBarStrings {
-	dateLabel: string;
-	guestsLabel: string;
-	timeLabel: string;
-	guestSingular: string;
-	guestPlural: string;
-	reserveLabel: string;
-	previousMonth: string;
-	nextMonth: string;
-	selectGuestsAriaLabel: string;
-	selectTimeAriaLabel: string;
-}
-
-export interface ReservationBarElement extends HTMLElement {
-	minGuests?: number;
-	maxGuests?: number;
-	defaultGuests?: number;
-	timeSlots?: string[];
-	defaultTime?: string;
-	showReserveButton?: boolean;
-	reserveHref?: string;
-	syncWithUrl?: boolean;
-	closedWeekdays?: number[];
-	locale?: string;
-	strings?: Partial<ReservationBarStrings>;
-	fetchAvailableDates?: (partySize: number) => Promise<string[]>;
-}
-
-export interface BookingSlot {
-	time: string;
-	availableTables: number;
-}
-
-export interface PaymentIntentResult {
-	clientSecret: string;
-	paymentIntentId: string;
-	amountCents: number;
-}
-
-export interface BookingDetails {
-	date: string;
-	startTime: string;
-	timeDisplay: string;
-	partySize: number;
-	contactName: string;
-	contactEmail?: string;
-	contactPhone?: string;
-	notes?: string;
-	customFieldValues?: Record<string, string>;
-	stripePaymentIntentId?: string;
-	clerkUserId?: string;
-}
-
-export type BookResult = { ok: true } | { ok: false; status: number; message: string };
-
-export interface BookingFlowCustomField {
-	key: string;
-	label: string;
-	options: string[];
-}
-
-export interface BookingFlowStrings {
-	pickDateEmpty: string;
-	errorEmpty: string;
-	noSlotsEmpty: string;
-	previousMonth: string;
-	nextMonth: string;
-	availableTimes: string;
-	nameLabel: string;
-	emailLabel: string;
-	phoneLabel: string;
-	selectOption: string;
-	paymentMethod: string;
-	holdSuffix: string;
-	paymentHint: string;
-	paymentUnavailable: string;
-	notesLabel: string;
-	cancellationPolicy: string;
-	confirmButton: string;
-	processingButton: string;
-	paymentNotReady: string;
-	cardHoldFailed: string;
-	confirmedTitle: string;
-	dateLabel: string;
-	timeLabel: string;
-	partySizeLabel: string;
-	guestSingular: string;
-	guestPlural: string;
-}
-
-export interface BookingFlowElement extends HTMLElement {
-	date?: string;
-	guests?: number;
-	preferredTime?: string;
-	closedWeekdays?: number[];
-	customFields?: BookingFlowCustomField[];
-	/** BCP 47 locale (e.g. "fr-FR") for date/month/weekday formatting and the
-	 *  payment hold amount; defaults to the browser's own locale. */
-	locale?: string;
-	/** ISO 4217 currency code (e.g. "EUR") for the payment hold amount label. */
-	currency?: string;
-	/** UI copy overrides; unset keys fall back to English defaults. */
-	strings?: Partial<BookingFlowStrings>;
-	fetchAvailableDates?: (partySize: number) => Promise<string[]>;
-	searchSlots?: (date: string, guests: number) => Promise<BookingSlot[]>;
-	createPaymentIntent?: (date: string, guests: number) => Promise<PaymentIntentResult>;
-	book?: (details: BookingDetails) => Promise<BookResult>;
-	stripePublishableKey?: string;
-	stripeAppearance?: Record<string, unknown>;
-}
-
-export interface MenuItem {
-	name: string;
-	description?: string;
-	price?: string;
-	tagline?: string;
-	group?: string;
-	country?: string;
-	allergens?: string[];
-}
-
-export interface MenuCategory {
-	label: string;
-	items: MenuItem[];
-}
-
-export interface MenuInfoItem {
-	label: string;
-	value: string;
-}
-
-export interface Allergen {
-	id: string;
-	label: string;
-	icon: string;
-}
-
-export interface MenuSectionElement extends HTMLElement {
-	title?: string;
-	eyebrow?: string;
-	categories?: MenuCategory[];
-	info?: MenuInfoItem[];
-	allergens?: Allergen[];
-	pdfUrl?: string;
-	pdfLabel?: string;
-	topFlourishSrc?: string;
-	tailFlourishSrc?: string;
-	headingCircleColor?: string;
-	headingAlign?: 'center' | 'left';
-	layout?: 'stacked' | 'split';
-	variant?: 'default' | 'panel';
-	openInNewTabLabel?: string;
-	closeAriaLabel?: string;
-	groupFilter?: boolean;
-	countryFilter?: boolean;
-	groupFilterAllLabel?: string;
-	countryFilterAllLabel?: string;
-}
-
-export interface EventInquiry {
-	id: string;
-	name: string;
-	email: string;
-	phone?: string | null;
-	restaurant_id?: string | null;
-	event_date: string;
-	guests?: number | null;
-	event_type?: string | null;
-	format?: string | null;
-	message?: string | null;
-	status: string;
-	created_at: string;
-	/** Avatar of whoever sent the most recent reply, if any -- shown on
-	 *  the list item in place of the "contacted" status badge. */
-	lastReplyAvatarUrl?: string | null;
-	/** Name used for the avatar's alt text / tooltip. */
-	lastReplyByName?: string | null;
-}
-
-export interface EventInquiryRestaurantRef {
-	id: string;
-	name: string;
-}
-
-export interface EventInquiriesFeedElement extends HTMLElement {
-	heading?: string;
-	channelName?: string;
-	ablyAuthUrl?: string;
-	/** Fetches one page of inquiry history, newest-first; Ably only delivers
-	 *  events published after the subscription starts, so history has to
-	 *  come from a REST call. Omit `cursor` for the first page; each
-	 *  subsequent call passes the `created_at` of the oldest loaded inquiry
-	 *  so only the next page is fetched. Return fewer than `limit` items to
-	 *  signal there's nothing older left. */
-	fetchInquiries?: (params: { cursor?: string; limit: number }) => Promise<EventInquiry[]>;
-	/** Resolves restaurant_id -> display name; the inquiry payload only
-	 *  carries the id, since the source event is property-wide across
-	 *  restaurants. */
-	restaurants?: EventInquiryRestaurantRef[];
-	maxItems?: number;
-	/** Set false to stop fetching further pages once the first one loads --
-	 *  disables the scroll-to-bottom sentinel entirely rather than swapping
-	 *  in a manual button. Default true. */
-	autoLoadMore?: boolean;
-	emptyLabel?: string;
-	/** Set false to hide the guest email address on list items. Must be set
-	 *  as a JS property to get false -- Boolean-typed custom-element
-	 *  attributes are presence-based. Default true. */
-	showEmail?: boolean;
-}
-
-export interface EventInquiryPayload {
-	name: string;
-	email: string;
-	phone: string;
-	/** Null when requireDate is false and no date was picked. */
-	date: string | null;
-	guests: number;
-	eventType: string;
-	format: string;
-	message: string;
-}
-
-export type SubmitInquiryResult = { ok: true } | { ok: false; error?: string };
-
-export interface EventContactFormStrings {
-	nameLabel: string;
-	namePlaceholder: string;
-	emailLabel: string;
-	emailPlaceholder: string;
-	emailInvalidTitle: string;
-	phoneLabel: string;
-	phonePlaceholder: string;
-	eventTypeLabel: string;
-	selectOption: string;
-	guestsLabel: string;
-	guestsMinimumHint: string;
-	decreaseGuestsAriaLabel: string;
-	increaseGuestsAriaLabel: string;
-	eventFormatLabel: string;
-	seatedDinner: string;
-	cocktailReception: string;
-	selectDateLabel: string;
-	previousMonth: string;
-	nextMonth: string;
-	selectDateError: string;
-	messageLabel: string;
-	messagePlaceholder: string;
-	sendingLabel: string;
-	sendLabel: string;
-	notWiredError: string;
-	genericSubmitError: string;
-	successMessage: string;
-}
-
-export interface EventContactFormElement extends HTMLElement {
-	heading?: string;
-	tagline?: string;
-	description?: string;
-	eventTypes?: string[];
-	minGuests?: number;
-	/** Whether a date must be picked before the form can submit. Default true,
-	 *  matching this component's original wedding/event-venue behavior. Set
-	 *  false for venues that also take undated general enquiries (e.g. "do you
-	 *  do X?") -- the calendar stays visible so a preferred date can still be
-	 *  given, but payload.date is null when none is picked. Must be set as a
-	 *  JS property to get false -- Boolean-typed custom-element attributes are
-	 *  presence-based, so `require-date="false"` as a plain HTML attribute is
-	 *  still truthy. */
-	requireDate?: boolean;
-	/** Whether the Event Format (Seated Dinner / Cocktail Reception) toggle is
-	 *  shown. Default true. Set false for venues this distinction doesn't apply
-	 *  to (e.g. a barbershop's group booking) -- payload.format is then always
-	 *  ''. The two format values themselves are not configurable: they're a
-	 *  fixed pair, not a general-purpose field. Must be set as a JS property to
-	 *  get false, same as requireDate above. */
-	showFormat?: boolean;
-	/** Whether the Event Type / Occasion field is shown at all. Default true.
-	 *  Unlike showFormat, there is no way to make this field optional-but-visible
-	 *  -- it's always been unvalidated (never blocked submit), so the only
-	 *  meaningful states are "shown" and "not shown". When false, payload.eventType
-	 *  is always ''. Must be set as a JS property to get false, same as above. */
-	showEventType?: boolean;
-	/** Whether the Guests stepper (and, if shown, the Event Format toggle nested
-	 *  inside it) is shown at all. Default true. When false, payload.guests is
-	 *  always minGuests (the stepper never gets a chance to change it) and
-	 *  showFormat has no effect, since its toggle lives inside this block. Must
-	 *  be set as a JS property to get false, same as above. */
-	showGuests?: boolean;
-	/** Whether the date calendar is shown at all. Default true. Distinct from
-	 *  requireDate, which only controls whether a visible calendar is mandatory
-	 *  -- this removes the field entirely. Forces requireDate's effect off
-	 *  regardless of its own value (a hidden field can't be required), so
-	 *  payload.date is always null when this is false. Must be set as a JS
-	 *  property to get false, same as above. */
-	showDate?: boolean;
-	submitNote?: string;
-	/** BCP 47 locale (e.g. "fr-FR") used to format month/weekday names in the
-	 *  calendar; defaults to the browser's own locale. */
-	locale?: string;
-	strings?: Partial<EventContactFormStrings>;
-	submitInquiry?: (payload: EventInquiryPayload) => Promise<SubmitInquiryResult>;
-}
-
-export interface ReservationCancelPayload {
-	reservationId: string;
-	restaurantSlug?: string;
-}
-export type CancelActionResult = { ok: true } | { ok: false; status?: number };
-
-export interface ReservationCancelStrings {
-	cancelReservation: string;
-	requestSuccess: string;
-	noEmailOnFile: string;
-	requestError: string;
-	dialogEyebrow: string;
-	dialogBody: string;
-	nevermind: string;
-	continueLabel: string;
-	confirmSuccess: string;
-	expiresIn: string;
-	confirmButton: string;
-	confirmError: string;
-	resendSuccess: string;
-	linkExpired: string;
-	resendButton: string;
-	resendError: string;
-}
-
-export interface ReservationCancelElement extends HTMLElement {
-	mode?: 'request' | 'confirm';
-	reservationId?: string;
-	restaurantSlug?: string;
-	token?: string;
-	expiresAt?: number;
-	initiallyExpired?: boolean;
-	strings?: Partial<ReservationCancelStrings>;
-	requestCancel?: (payload: ReservationCancelPayload) => Promise<CancelActionResult>;
-	confirmCancel?: (payload: { token: string }) => Promise<CancelActionResult>;
-}
-
-export interface LiveReservation {
-	id: string;
-	restaurant_id?: string | null;
-	reservation_date: string;
-	start_time: string;
-	party_size: number;
-	status: string;
-	contact_name: string;
-	contact_email?: string | null;
-	contact_phone?: string | null;
-	table_number?: string | null;
-	location?: string | null;
-	created_at: string;
-}
-
-export interface LiveReservationRestaurantRef {
-	id: string;
-	name: string;
-}
-
-export interface LiveReservationsFeedDateFilterEventDetail {
-	filterDateFrom?: string;
-	filterDateTo?: string;
-}
-
-export interface LiveReservationsFeedElement extends HTMLElement {
-	heading?: string;
-	channelName?: string;
-	ablyAuthUrl?: string;
-	/** Fetches one page of reservation history, newest-first; Ably only
-	 *  delivers events published after the subscription starts, so history
-	 *  has to come from a REST call. Omit `cursor` for the first page; each
-	 *  subsequent call passes the `created_at` of the oldest loaded
-	 *  reservation so only the next page is fetched. Return fewer than
-	 *  `limit` items to signal there's nothing older left. */
-	fetchReservations?: (params: {
-		cursor?: string;
-		limit: number;
-		filterDateFrom?: string;
-		filterDateTo?: string;
-	}) => Promise<LiveReservation[]>;
-	restaurants?: LiveReservationRestaurantRef[];
-	maxItems?: number;
-	/** Set false to stop fetching further pages once the first one loads --
-	 *  disables the scroll-to-bottom sentinel entirely rather than swapping
-	 *  in a manual button. Default true. */
-	autoLoadMore?: boolean;
-	emptyLabel?: string;
-	/** Set false to hide the guest email address on list items. Must be set
-	 *  as a JS property to get false -- Boolean-typed custom-element
-	 *  attributes are presence-based. Default true. */
-	showEmail?: boolean;
-	/** Restricts the feed to reservations booked for this date range
-	 *  (inclusive, 'YYYY-MM-DD'), filtering by reservation_date -- not
-	 *  created_at, which stays reserved for pagination. Either bound can be
-	 *  set alone for an open-ended range. Passed through to
-	 *  fetchReservations so the host can scope the query server-side;
-	 *  changing either value triggers a full refetch. Also guards live
-	 *  new-reservation / reservation-status-changed events. */
-	filterDateFrom?: string;
-	filterDateTo?: string;
-	/** Set true to render a built-in from/to date picker in the header,
-	 *  seeded from filterDateFrom/filterDateTo and driving the same
-	 *  filtering -- for host pages that don't want to build their own
-	 *  filter UI. Leave false (default) to filter purely via the props.
-	 *  Each input's min/max is cross-constrained by the other's current
-	 *  value so an inverted range can't be picked. Picking a date emits
-	 *  `date-filter-change` with the new range. */
-	showDateFilter?: boolean;
-}
-
-export interface LiveRoomBooking {
-	id: string;
-	first_name: string;
-	last_name: string;
-	email?: string | null;
-	phone?: string | null;
-	room_number?: string | null;
-	room_type_name?: string | null;
-	check_in: string;
-	check_out: string;
-	guests: number;
-	total_price?: string | number | null;
-	status: string;
-	created_at: string;
-}
-
-export interface LiveRoomBookingsFeedElement extends HTMLElement {
-	heading?: string;
-	channelName?: string;
-	ablyAuthUrl?: string;
-	/** Fetches one page of booking history, newest-first; Ably only
-	 *  delivers events published after the subscription starts, so history
-	 *  has to come from a REST call. Omit `cursor` for the first page; each
-	 *  subsequent call passes the `created_at` of the oldest loaded
-	 *  booking so only the next page is fetched. Return fewer than
-	 *  `limit` items to signal there's nothing older left. */
-	fetchBookings?: (params: { cursor?: string; limit: number }) => Promise<LiveRoomBooking[]>;
-	maxItems?: number;
-	/** Set false to stop fetching further pages once the first one loads --
-	 *  disables the scroll-to-bottom sentinel entirely rather than swapping
-	 *  in a manual button. Default true. */
-	autoLoadMore?: boolean;
-	emptyLabel?: string;
-	/** Set false to hide the guest email address on list items. Must be set
-	 *  as a JS property to get false -- Boolean-typed custom-element
-	 *  attributes are presence-based. Default true. */
-	showEmail?: boolean;
-	/** Symbol prefixed to total_price ('€', '$', ...); the PMS payload
-	 *  carries no currency of its own. Default empty (bare amount). */
-	currency?: string;
-}
-
-export interface LiveSpaBooking {
-	id: string;
-	first_name: string;
-	last_name: string;
-	email?: string | null;
-	phone?: string | null;
-	treatment_name?: string | null;
-	therapist_name?: string | null;
-	start_time: string;
-	duration_minutes: number;
-	price?: string | number | null;
-	status: string;
-	created_at: string;
-}
-
-export interface LiveSpaBookingsFeedElement extends HTMLElement {
-	heading?: string;
-	channelName?: string;
-	ablyAuthUrl?: string;
-	/** Fetches one page of booking history, newest-first; Ably only
-	 *  delivers events published after the subscription starts, so history
-	 *  has to come from a REST call. Omit `cursor` for the first page; each
-	 *  subsequent call passes the `created_at` of the oldest loaded
-	 *  booking so only the next page is fetched. Return fewer than
-	 *  `limit` items to signal there's nothing older left. */
-	fetchBookings?: (params: { cursor?: string; limit: number }) => Promise<LiveSpaBooking[]>;
-	maxItems?: number;
-	/** Set false to stop fetching further pages once the first one loads --
-	 *  disables the scroll-to-bottom sentinel entirely rather than swapping
-	 *  in a manual button. Default true. */
-	autoLoadMore?: boolean;
-	emptyLabel?: string;
-	/** Set false to hide the guest email address on list items. Must be set
-	 *  as a JS property to get false -- Boolean-typed custom-element
-	 *  attributes are presence-based. Default true. */
-	showEmail?: boolean;
-	/** Symbol prefixed to price ('€', '$', ...); the payload carries no
-	 *  currency of its own. Default empty (bare amount). */
-	currency?: string;
-}
-
-export interface GolfShopItem {
-	id?: string;
-	item_id?: string;
-	item_name: string;
-	quantity: number;
-	unit_price?: string | number;
-	total?: string | number;
-	variant?: string | null;
-}
-
-export interface GolfBooking {
-	id: string;
-	first_name: string;
-	last_name: string;
-	email?: string | null;
-	phone?: string | null;
-	course_name?: string | null;
-	tee_time: string;
-	players: number;
-	holes?: number | null;
-	price?: string | number | null;
-	/** Pro-shop purchases attached to the booking; omit or leave empty for a
-	 *  plain tee-time booking with nothing purchased alongside it. */
-	items?: GolfShopItem[];
-	status: string;
-	created_at: string;
-}
-
-export interface LiveGolfBookingsFeedElement extends HTMLElement {
-	heading?: string;
-	channelName?: string;
-	ablyAuthUrl?: string;
-	/** Fetches one page of booking history, newest-first; Ably only
-	 *  delivers events published after the subscription starts, so history
-	 *  has to come from a REST call. Omit `cursor` for the first page; each
-	 *  subsequent call passes the `created_at` of the oldest loaded
-	 *  booking so only the next page is fetched. Return fewer than
-	 *  `limit` items to signal there's nothing older left. */
-	fetchBookings?: (params: { cursor?: string; limit: number }) => Promise<GolfBooking[]>;
-	maxItems?: number;
-	/** Set false to stop fetching further pages once the first one loads --
-	 *  disables the scroll-to-bottom sentinel entirely rather than swapping
-	 *  in a manual button. Default true. */
-	autoLoadMore?: boolean;
-	emptyLabel?: string;
-	/** Set false to hide the guest email address on list items. Must be set
-	 *  as a JS property to get false -- Boolean-typed custom-element
-	 *  attributes are presence-based. Default true. */
-	showEmail?: boolean;
-	/** Symbol prefixed to price ('€', '$', ...); the payload carries no
-	 *  currency of its own. Default empty (bare amount). */
-	currency?: string;
-}
-
-export interface DiningOrderItem {
-	id?: string;
-	item_id?: string;
-	item_name: string;
-	quantity: number;
-	unit_price?: string | number;
-	total?: string | number;
-	variant?: string | null;
-}
-
-export interface DiningOrder {
-	id: string;
-	restaurant_id: string;
-	booking_id?: string | null;
-	table_id?: string | null;
-	/** Joined from restaurant_table by OTA; absent on older payloads. */
-	table_number?: string | null;
-	guest_id?: string | null;
-	status: string;
-	notes?: string | null;
-	scheduled_for?: string | null;
-	total_price: string | number;
-	created_at: string;
-	items: DiningOrderItem[];
-}
-
-export interface DiningOrderBookingRef {
-	id: string;
-	room_number?: string | null;
-	guest_name?: string | null;
-}
-
-export interface LiveDiningOrdersFeedElement extends HTMLElement {
-	heading?: string;
-	channelName?: string;
-	ablyAuthUrl?: string;
-	/** Fetches one page of order history, newest-first; Ably only delivers
-	 *  events published after the subscription starts, so history has to
-	 *  come from a REST call. Omit `cursor` for the first page; each
-	 *  subsequent call passes the `created_at` of the oldest loaded order so
-	 *  only the next page is fetched. Return fewer than `limit` items to
-	 *  signal there's nothing older left. */
-	fetchOrders?: (params: { cursor?: string; limit: number }) => Promise<DiningOrder[]>;
-	/** Resolves booking_id -> room/guest, since the order payload carries
-	 *  only the id. */
-	bookings?: DiningOrderBookingRef[];
-	maxItems?: number;
-	/** Set false to stop fetching further pages once the first one loads --
-	 *  disables the scroll-to-bottom sentinel entirely rather than swapping
-	 *  in a manual button. Default true. */
-	autoLoadMore?: boolean;
-	emptyLabel?: string;
-	/** Symbol prefixed to money amounts ('€', '$', ...); the payload carries
-	 *  no currency of its own. Default empty (bare amount). */
-	currency?: string;
-	/** Restricts the feed to one booking's orders -- `fetchOrders` should
-	 *  already be scoped server-side; this only filters the live `new-order`
-	 *  events, which otherwise arrive unfiltered off the channel. */
-	filterBookingId?: string;
-}
-
-export interface VenueCarouselSlide {
-	key: string;
-	src: string;
-	label?: string;
-	tag?: string;
-	description?: string;
-}
-
-export interface VenueCarouselSlideEventDetail {
-	index: number;
-	key: string;
-}
-
-export interface VenueCarouselElement extends HTMLElement {
-	slides?: VenueCarouselSlide[];
-	activeIndex?: number;
-	reserveLabel?: string;
-	previousLabel?: string;
-	nextLabel?: string;
-}
-
-export interface RoomGridRoom {
-	slug: string;
-	name: string;
-	description?: string;
-	/** Nightly from-price as a number; formatted internally. */
-	price?: number;
-	/** Resolved image URL — the component is backend-agnostic. */
-	image?: string;
-	/** Filter-tab grouping, e.g. "Beach Front". */
-	tag?: string;
-	/** Card CTA destination. */
-	href?: string;
-}
-
-export interface RoomGridDatesEventDetail {
-	checkIn: string;
-	checkOut: string;
-}
-
-export interface RoomGridRoomEventDetail {
-	slug: string;
-}
-
-export interface RoomGridFilterTab {
-	label: string;
-	slug: string;
-}
-
-export interface RoomGridElement extends HTMLElement {
-	rooms?: RoomGridRoom[];
-	filterTabs?: RoomGridFilterTab[];
-	checkIn?: string;
-	checkOut?: string;
-	currency?: string;
-	allLabel?: string;
-	variant?: 'grid' | 'rows';
-}
-
-export interface AvailabilityDay {
-	date: string;
-	available_rooms?: string | number;
-	min_rate?: string | number;
-}
-
-export interface AvailabilityCalendarElement extends HTMLElement {
-	checkIn?: string;
-	checkOut?: string;
-	horizonMonths?: number;
-	fetchAvailability?: (fromISO: string, toISO: string) => Promise<AvailabilityDay[]>;
-}
-
-export interface BookingCardReserveDetail {
-	checkIn: string;
-	checkOut: string;
-	guests: number;
-}
-
-export interface BookingCardElement extends HTMLElement {
-	price?: number;
-	maxGuests?: number;
-	currency?: string;
-	resortFeeRate?: number;
-	ratingText?: string;
-	finePrint?: string;
-	conciergeTitle?: string;
-	conciergeSub?: string;
-	conciergeCtaLabel?: string;
-	conciergeCtaHref?: string;
-	checkIn?: string;
-	checkOut?: string;
-	guests?: number;
-	horizonMonths?: number;
-	fetchAvailability?: (fromISO: string, toISO: string) => Promise<AvailabilityDay[]>;
-}
-
-export interface IslandMapPin {
-	label: string;
-	sub?: string;
-	lat: number;
-	lng: number;
-	/** Key for highlightPin()/unhighlightPin() — e.g. a room slug. */
-	slug?: string;
-}
-
-export interface IslandMapElement extends HTMLElement {
-	pins?: IslandMapPin[];
-	/** "lat,lng" */
-	center?: string;
-	zoom?: number;
-	mapId?: string;
-	/** Used only when no Google Maps loader is already present on the page. */
-	apiKey?: string;
-	colorScheme?: 'DARK' | 'LIGHT' | 'FOLLOW_SYSTEM';
-	fitPins?: boolean;
-	fitPadding?: number;
-	panY?: number;
-	interactionLock?: boolean;
-	pinsVisible?: boolean;
-	highlightPin?: (slug: string) => void;
-	unhighlightPin?: (slug: string) => void;
-}
-
-export interface FloorPlanRoom {
-	id: string;
-	type?: string;
-	label?: string;
-	x: number;
-	y: number;
-	w: number;
-	h: number;
-	sqm?: string | number;
-	imgUrl?: string;
-}
-
-export interface FloorPlanItem {
-	id: string;
-	asset: string;
-	x: number;
-	y: number;
-	w: number;
-	h: number;
-}
-
-export interface FloorPlan {
-	rooms?: FloorPlanRoom[];
-	items?: FloorPlanItem[];
-	w?: number;
-	h?: number;
-}
-
-export interface FloorPlanZoneEventDetail {
-	img?: string;
-	label?: string;
-	type?: string;
-}
-
-export interface FloorPlanHeroElement extends HTMLElement {
-	plan?: FloorPlan;
-	bgUrl?: string;
-	assetBase?: string;
-	label?: string;
-	closeLabel?: string;
-	open?: () => void;
-	close?: () => void;
-	toggle?: () => void;
-}
-
-export interface StaySearchRoom {
-	roomTypeId: string;
-	name: string;
-	description?: string;
-	image?: string;
-	href?: string;
-}
-
-export interface StaySearchResult {
-	room_type_id: string;
-	name?: string;
-	description?: string;
-	from_rate?: string | number;
-	min_available?: string | number;
-}
-
-export interface StaySearchElement extends HTMLElement {
-	rooms?: StaySearchRoom[];
-	checkIn?: string;
-	checkOut?: string;
-	guests?: number;
-	currency?: string;
-	appendDatesToHref?: boolean;
-	searchStays?: (checkIn: string, checkOut: string, guests: number) => Promise<StaySearchResult[]>;
-}
-
-export interface DiningTeaserVenue {
-	key: string;
-	name: string;
-	tag?: string;
-	image: string;
-}
-
-export interface DiningTeaserVenueEventDetail {
-	index: number;
-	key: string;
-}
-
-export interface DiningTeaserElement extends HTMLElement {
-	venues?: DiningTeaserVenue[];
-	heading?: string;
-	headingAccent?: string;
-	body?: string;
-	ctaLabel?: string;
-	ctaHref?: string;
-	imageLabel?: string;
-	activeIndex?: number;
-}
-
-export interface BookingCheckoutLocation {
-	iso2: string;
-	countryName: string;
-	dialCode: string;
-}
-
-export interface BookingCheckoutPrefill {
-	firstName?: string;
-	lastName?: string;
-	email?: string;
-}
-
-export interface BookingCheckoutResolvedLocation {
-	countryName: string;
-	iso2?: string;
-	dialCode?: string;
-}
-
-export interface BookingCheckoutPayload {
-	paymentIntentId: string;
-	bookingFor: 'myself' | 'other';
-	contactName: string;
-	contactEmail: string;
-	contactPhone: string;
-	country: string;
-	countryIso2: string;
-	requests?: string;
-	booker?: { name: string; email: string; phone: string };
-}
-
-export type BookingCheckoutResult = { ok: true; ref?: string } | { ok: false; message: string };
-
-export interface BookingCheckoutElement extends HTMLElement {
-	total?: number;
-	currency?: string;
-	clientSecret?: string;
-	stripePublishableKey?: string;
-	stripeAppearance?: Record<string, unknown>;
-	cancellationPolicy?: string;
-	locations?: BookingCheckoutLocation[];
-	defaultPhoneCode?: string;
-	allowBookingForOther?: boolean;
-	termsHref?: string;
-	prefill?: BookingCheckoutPrefill;
-	resolveInitialLocation?: () => Promise<BookingCheckoutResolvedLocation | null>;
-	beforeSubmit?: () => Promise<void>;
-	submitBooking?: (payload: BookingCheckoutPayload) => Promise<BookingCheckoutResult>;
-	strings?: Record<string, string>;
-}
-
-export interface ConfirmationCardElement extends HTMLElement {
-	eyebrow?: string;
-	heading?: string;
-	body?: string;
-	reference?: string;
-	referenceLabel?: string;
-	primaryLabel?: string;
-	primaryHref?: string;
-	secondaryLabel?: string;
-	secondaryHref?: string;
-	notePrefix?: string;
-	noteLinkLabel?: string;
-	noteLinkHref?: string;
-	noteSuffix?: string;
-}
-
-export interface ExtraItem {
-	id: string;
-	name: string;
-	slug?: string;
-	description?: string;
-	category?: string;
-	image?: string;
-	imageEmail?: string;
-	price: number | null;
-}
-
-export interface ExtrasCatalogueSelection {
-	id: string;
-	name: string;
-	price: number | null;
-	quantity: number;
-	imageEmail?: string;
-}
-
-export interface ExtrasCatalogueChangeEventDetail {
-	items: ExtrasCatalogueSelection[];
-	total: number;
-}
-
-export interface ExtrasCatalogueElement extends HTMLElement {
-	extras?: ExtraItem[];
-	currency?: string;
-	categories?: string[];
-	fallbackCategory?: string;
-	initial?: { id: string; quantity: number }[];
-}
-
-export interface BookingProgressStep {
-	label: string;
-	href?: string;
-}
-
-export interface BookingProgressBarElement extends HTMLElement {
-	steps?: BookingProgressStep[];
-	activeStep?: number;
-	secureLabel?: string;
-	logoHref?: string;
-}
-
-export interface BookingSummaryExtraItem {
-	name: string;
-	price: number;
-	quantity: number;
-}
-
-export interface BookingSummaryElement extends HTMLElement {
-	resortName?: string;
-	logoSrc?: string;
-	checkIn?: string;
-	checkOut?: string;
-	roomImage?: string | null;
-	roomName?: string;
-	roomEmptyLabel?: string;
-	guests?: number;
-	nightlyRate?: number;
-	currency?: string;
-	totalLabel?: string;
-	/** String pseudo-boolean, not a real Boolean-typed attribute: pass the
-	 *  literal attribute value "false" to hide the rate line -- any other
-	 *  value, including bare attribute presence, renders it. */
-	showRate?: string;
-	extrasLabel?: string;
-	extrasItems?: BookingSummaryExtraItem[];
-	continueHref?: string;
-	continueLabelSelected?: string;
-	continueLabelEmpty?: string;
-	needHelpHref?: string;
-}
-
-export interface SearchableSelectOption {
-	value: string;
-	label: string;
-	/** Passed through untouched on the `change` event -- e.g. an ISO2 code alongside a country name. */
-	meta?: unknown;
-}
-
-export interface SearchableSelectChangeEventDetail {
-	value: string;
-	label: string;
-	meta?: unknown;
-}
-
-export interface SearchableSelectElement extends HTMLElement {
-	options?: SearchableSelectOption[];
-	value?: string;
-	placeholder?: string;
-	variant?: 'phone' | 'country' | '';
-	searchPlaceholder?: string;
-}
-
-export interface BookingConfirmedElement extends HTMLElement {
-	heading?: string;
-	detail?: string;
-	note?: string;
-	doneLabel?: string;
-	secondaryLabel?: string;
-	secondaryHref?: string;
-}
-
-export interface RestaurantOrderMenuItem {
-	id: string;
-	name: string;
-	description?: string;
-	category: string;
-	price: number | string;
-	allergens?: string[];
-	variants?: string[];
-}
-
-export interface RestaurantOrderCartItem {
-	item_id: string;
-	quantity: number;
-	variant?: string;
-}
-
-export interface RestaurantOrderPlaceParams {
-	items: RestaurantOrderCartItem[];
-	scheduledFor: string | null;
-}
-
-export interface RestaurantOrderPlaceResult {
-	ok: boolean;
-	error?: string;
-	order?: unknown;
-}
-
-export interface RestaurantOrderPlacedEventDetail {
-	items: RestaurantOrderCartItem[];
-	total: number;
-	scheduledFor: string | null;
-	order: unknown;
-}
-
-export interface RestaurantOrderFormElement extends HTMLElement {
-	items?: RestaurantOrderMenuItem[];
-	categoryOrder?: string[];
-	categoryLabels?: Record<string, string>;
-	currency?: string;
-	iconFor?: (tag: string) => string | undefined;
-	checkIn?: string;
-	checkOut?: string;
-	placeOrder?: (params: RestaurantOrderPlaceParams) => Promise<RestaurantOrderPlaceResult>;
-}
-
-declare global {
-	interface HTMLElementTagNameMap {
-		'reservation-bar': ReservationBarElement;
-		'booking-flow': BookingFlowElement;
-		'menu-section': MenuSectionElement;
-		'event-inquiries-feed': EventInquiriesFeedElement;
-		'event-contact-form': EventContactFormElement;
-		'reservation-cancel': ReservationCancelElement;
-		'live-reservations-feed': LiveReservationsFeedElement;
-		'live-room-bookings-feed': LiveRoomBookingsFeedElement;
-		'live-spa-bookings-feed': LiveSpaBookingsFeedElement;
-		'live-golf-bookings-feed': LiveGolfBookingsFeedElement;
-		'live-dining-orders-feed': LiveDiningOrdersFeedElement;
-		'venue-carousel': VenueCarouselElement;
-		'room-grid': RoomGridElement;
-		'island-map': IslandMapElement;
-		'floor-plan-hero': FloorPlanHeroElement;
-		'stay-search': StaySearchElement;
-		'availability-calendar': AvailabilityCalendarElement;
-		'booking-card': BookingCardElement;
-		'dining-teaser': DiningTeaserElement;
-		'booking-checkout': BookingCheckoutElement;
-		'confirmation-card': ConfirmationCardElement;
-		'extras-catalogue': ExtrasCatalogueElement;
-		'booking-progress-bar': BookingProgressBarElement;
-		'booking-summary': BookingSummaryElement;
-		'searchable-select': SearchableSelectElement;
-		'booking-confirmed': BookingConfirmedElement;
-		'restaurant-order-form': RestaurantOrderFormElement;
-	}
-
-	interface HTMLElementEventMap {
-		reservationchange: CustomEvent<{ date: string; guests: number; time: string }>;
-		'booking-confirmed': CustomEvent<{ date: string; time: string; guests: number }>;
-		'inquiry-submitted': CustomEvent<EventInquiryPayload>;
-		'cancel-requested': CustomEvent<ReservationCancelPayload>;
-		'cancel-confirmed': CustomEvent<{ token: string }>;
-		'slide-change': CustomEvent<VenueCarouselSlideEventDetail>;
-		'slide-reserve': CustomEvent<VenueCarouselSlideEventDetail>;
-		'dates-change': CustomEvent<RoomGridDatesEventDetail>;
-		'room-hover': CustomEvent<RoomGridRoomEventDetail>;
-		'room-leave': CustomEvent<RoomGridRoomEventDetail>;
-		'zone-hover': CustomEvent<FloorPlanZoneEventDetail>;
-		'zone-leave': CustomEvent<FloorPlanZoneEventDetail>;
-		'venue-change': CustomEvent<DiningTeaserVenueEventDetail>;
-		'checkout-confirmed': CustomEvent<{ ref?: string }>;
-		ready: CustomEvent<undefined>;
-		'extras-change': CustomEvent<ExtrasCatalogueChangeEventDetail>;
-		'order-placed': CustomEvent<RestaurantOrderPlacedEventDetail>;
-		'date-filter-change': CustomEvent<LiveReservationsFeedDateFilterEventDetail>;
-		// Not declared here: `searchable-select` dispatches a CustomEvent named
-		// literally "change" (SearchableSelectChangeEventDetail, above). Adding
-		// it to this global map would override the native `change: Event` type
-		// for every element in any consuming codebase (<input>, <select>, ...).
-		// Cast at the listener instead: `(e as CustomEvent<SearchableSelectChangeEventDetail>).detail`.
-	}
-}
+export interface ReservationBarStrings {
+	dateLabel: string;
+	guestsLabel: string;
+	timeLabel: string;
+	guestSingular: string;
+	guestPlural: string;
+	reserveLabel: string;
+	previousMonth: string;
+	nextMonth: string;
+	selectGuestsAriaLabel: string;
+	selectTimeAriaLabel: string;
+}
+
+export interface ReservationBarElement extends HTMLElement {
+	minGuests?: number;
+	maxGuests?: number;
+	defaultGuests?: number;
+	timeSlots?: string[];
+	defaultTime?: string;
+	showReserveButton?: boolean;
+	reserveHref?: string;
+	applyOnSelect?: boolean;
+	syncWithUrl?: boolean;
+	closedWeekdays?: number[];
+	locale?: string;
+	strings?: Partial<ReservationBarStrings>;
+	fetchAvailableDates?: (partySize: number) => Promise<string[]>;
+}
+
+export interface BookingSlot {
+	time: string;
+	availableTables: number;
+}
+
+export interface PaymentIntentResult {
+	clientSecret: string;
+	paymentIntentId: string;
+	amountCents: number;
+}
+
+export interface BookingDetails {
+	date: string;
+	startTime: string;
+	timeDisplay: string;
+	partySize: number;
+	contactName: string;
+	contactEmail?: string;
+	contactPhone?: string;
+	notes?: string;
+	customFieldValues?: Record<string, string>;
+	stripePaymentIntentId?: string;
+	clerkUserId?: string;
+}
+
+export type BookResult = { ok: true } | { ok: false; status: number; message: string };
+
+export interface BookingFlowCustomField {
+	key: string;
+	label: string;
+	options: string[];
+}
+
+export interface BookingFlowStrings {
+	pickDateEmpty: string;
+	errorEmpty: string;
+	noSlotsEmpty: string;
+	previousMonth: string;
+	nextMonth: string;
+	availableTimes: string;
+	nameLabel: string;
+	emailLabel: string;
+	phoneLabel: string;
+	selectOption: string;
+	paymentMethod: string;
+	holdSuffix: string;
+	paymentHint: string;
+	paymentUnavailable: string;
+	notesLabel: string;
+	cancellationPolicy: string;
+	confirmButton: string;
+	processingButton: string;
+	paymentNotReady: string;
+	cardHoldFailed: string;
+	confirmedTitle: string;
+	dateLabel: string;
+	timeLabel: string;
+	partySizeLabel: string;
+	guestSingular: string;
+	guestPlural: string;
+}
+
+export interface BookingFlowElement extends HTMLElement {
+	date?: string;
+	guests?: number;
+	preferredTime?: string;
+	closedWeekdays?: number[];
+	customFields?: BookingFlowCustomField[];
+	/** BCP 47 locale (e.g. "fr-FR") for date/month/weekday formatting and the
+	 *  payment hold amount; defaults to the browser's own locale. */
+	locale?: string;
+	/** ISO 4217 currency code (e.g. "EUR") for the payment hold amount label. */
+	currency?: string;
+	/** UI copy overrides; unset keys fall back to English defaults. */
+	strings?: Partial<BookingFlowStrings>;
+	fetchAvailableDates?: (partySize: number) => Promise<string[]>;
+	searchSlots?: (date: string, guests: number) => Promise<BookingSlot[]>;
+	createPaymentIntent?: (date: string, guests: number) => Promise<PaymentIntentResult>;
+	book?: (details: BookingDetails) => Promise<BookResult>;
+	stripePublishableKey?: string;
+	stripeAppearance?: Record<string, unknown>;
+}
+
+export interface MenuItem {
+	name: string;
+	description?: string;
+	price?: string;
+	tagline?: string;
+	group?: string;
+	country?: string;
+	allergens?: string[];
+}
+
+export interface MenuCategory {
+	label: string;
+	items: MenuItem[];
+}
+
+export interface MenuInfoItem {
+	label: string;
+	value: string;
+}
+
+export interface Allergen {
+	id: string;
+	label: string;
+	icon: string;
+}
+
+export interface MenuSectionElement extends HTMLElement {
+	title?: string;
+	eyebrow?: string;
+	categories?: MenuCategory[];
+	info?: MenuInfoItem[];
+	allergens?: Allergen[];
+	pdfUrl?: string;
+	pdfLabel?: string;
+	topFlourishSrc?: string;
+	tailFlourishSrc?: string;
+	headingCircleColor?: string;
+	headingAlign?: 'center' | 'left';
+	layout?: 'stacked' | 'split';
+	variant?: 'default' | 'panel';
+	openInNewTabLabel?: string;
+	closeAriaLabel?: string;
+	groupFilter?: boolean;
+	countryFilter?: boolean;
+	groupFilterAllLabel?: string;
+	countryFilterAllLabel?: string;
+}
+
+export interface EventInquiry {
+	id: string;
+	name: string;
+	email: string;
+	phone?: string | null;
+	restaurant_id?: string | null;
+	event_date: string;
+	guests?: number | null;
+	event_type?: string | null;
+	format?: string | null;
+	message?: string | null;
+	status: string;
+	created_at: string;
+	/** Avatar of whoever sent the most recent reply, if any -- shown on
+	 *  the list item in place of the "contacted" status badge. */
+	lastReplyAvatarUrl?: string | null;
+	/** Name used for the avatar's alt text / tooltip. */
+	lastReplyByName?: string | null;
+}
+
+export interface EventInquiryRestaurantRef {
+	id: string;
+	name: string;
+}
+
+export interface EventInquiriesFeedElement extends HTMLElement {
+	heading?: string;
+	channelName?: string;
+	ablyAuthUrl?: string;
+	/** Fetches one page of inquiry history, newest-first; Ably only delivers
+	 *  events published after the subscription starts, so history has to
+	 *  come from a REST call. Omit `cursor` for the first page; each
+	 *  subsequent call passes the `created_at` of the oldest loaded inquiry
+	 *  so only the next page is fetched. Return fewer than `limit` items to
+	 *  signal there's nothing older left. */
+	fetchInquiries?: (params: { cursor?: string; limit: number }) => Promise<EventInquiry[]>;
+	/** Resolves restaurant_id -> display name; the inquiry payload only
+	 *  carries the id, since the source event is property-wide across
+	 *  restaurants. */
+	restaurants?: EventInquiryRestaurantRef[];
+	maxItems?: number;
+	/** Set false to stop fetching further pages once the first one loads --
+	 *  disables the scroll-to-bottom sentinel entirely rather than swapping
+	 *  in a manual button. Default true. */
+	autoLoadMore?: boolean;
+	emptyLabel?: string;
+	/** Set false to hide the guest email address on list items. Must be set
+	 *  as a JS property to get false -- Boolean-typed custom-element
+	 *  attributes are presence-based. Default true. */
+	showEmail?: boolean;
+}
+
+export interface EventInquiryPayload {
+	name: string;
+	email: string;
+	phone: string;
+	/** Null when requireDate is false and no date was picked. */
+	date: string | null;
+	guests: number;
+	eventType: string;
+	format: string;
+	message: string;
+}
+
+export type SubmitInquiryResult = { ok: true } | { ok: false; error?: string };
+
+export interface EventContactFormStrings {
+	nameLabel: string;
+	namePlaceholder: string;
+	emailLabel: string;
+	emailPlaceholder: string;
+	emailInvalidTitle: string;
+	phoneLabel: string;
+	phonePlaceholder: string;
+	eventTypeLabel: string;
+	selectOption: string;
+	guestsLabel: string;
+	guestsMinimumHint: string;
+	decreaseGuestsAriaLabel: string;
+	increaseGuestsAriaLabel: string;
+	eventFormatLabel: string;
+	seatedDinner: string;
+	cocktailReception: string;
+	selectDateLabel: string;
+	previousMonth: string;
+	nextMonth: string;
+	selectDateError: string;
+	messageLabel: string;
+	messagePlaceholder: string;
+	sendingLabel: string;
+	sendLabel: string;
+	notWiredError: string;
+	genericSubmitError: string;
+	successMessage: string;
+}
+
+export interface EventContactFormElement extends HTMLElement {
+	heading?: string;
+	tagline?: string;
+	description?: string;
+	eventTypes?: string[];
+	minGuests?: number;
+	/** Whether a date must be picked before the form can submit. Default true,
+	 *  matching this component's original wedding/event-venue behavior. Set
+	 *  false for venues that also take undated general enquiries (e.g. "do you
+	 *  do X?") -- the calendar stays visible so a preferred date can still be
+	 *  given, but payload.date is null when none is picked. Must be set as a
+	 *  JS property to get false -- Boolean-typed custom-element attributes are
+	 *  presence-based, so `require-date="false"` as a plain HTML attribute is
+	 *  still truthy. */
+	requireDate?: boolean;
+	/** Whether the Event Format (Seated Dinner / Cocktail Reception) toggle is
+	 *  shown. Default true. Set false for venues this distinction doesn't apply
+	 *  to (e.g. a barbershop's group booking) -- payload.format is then always
+	 *  ''. The two format values themselves are not configurable: they're a
+	 *  fixed pair, not a general-purpose field. Must be set as a JS property to
+	 *  get false, same as requireDate above. */
+	showFormat?: boolean;
+	/** Whether the Event Type / Occasion field is shown at all. Default true.
+	 *  Unlike showFormat, there is no way to make this field optional-but-visible
+	 *  -- it's always been unvalidated (never blocked submit), so the only
+	 *  meaningful states are "shown" and "not shown". When false, payload.eventType
+	 *  is always ''. Must be set as a JS property to get false, same as above. */
+	showEventType?: boolean;
+	/** Whether the Guests stepper (and, if shown, the Event Format toggle nested
+	 *  inside it) is shown at all. Default true. When false, payload.guests is
+	 *  always minGuests (the stepper never gets a chance to change it) and
+	 *  showFormat has no effect, since its toggle lives inside this block. Must
+	 *  be set as a JS property to get false, same as above. */
+	showGuests?: boolean;
+	/** Whether the date calendar is shown at all. Default true. Distinct from
+	 *  requireDate, which only controls whether a visible calendar is mandatory
+	 *  -- this removes the field entirely. Forces requireDate's effect off
+	 *  regardless of its own value (a hidden field can't be required), so
+	 *  payload.date is always null when this is false. Must be set as a JS
+	 *  property to get false, same as above. */
+	showDate?: boolean;
+	submitNote?: string;
+	/** BCP 47 locale (e.g. "fr-FR") used to format month/weekday names in the
+	 *  calendar; defaults to the browser's own locale. */
+	locale?: string;
+	strings?: Partial<EventContactFormStrings>;
+	submitInquiry?: (payload: EventInquiryPayload) => Promise<SubmitInquiryResult>;
+}
+
+export interface SpaTreatment {
+	id: string;
+	name: string;
+	durationMins: number;
+	price: number;
+}
+
+export interface SpaAvailabilityDay {
+	date: string;
+	slots: { time: string }[];
+}
+
+export interface SpaBookingPayload {
+	treatmentId: string;
+	date: string;
+	time: string;
+	name: string;
+	email: string;
+	phone: string;
+	notes: string;
+}
+
+export type SpaBookingResult = { ok: true } | { ok: false; error?: string };
+
+export interface SpaBookingWidgetStrings {
+	chooseServiceLabel: string;
+	loadingServices: string;
+	loadServicesError: string;
+	previousMonth: string;
+	nextMonth: string;
+	morningLabel: string;
+	afternoonLabel: string;
+	eveningLabel: string;
+	pickDayHint: string;
+	noSlotsForDay: string;
+	staffRowLabel: string;
+	totalLabel: string;
+	continueLabel: string;
+	changeServiceLabel: string;
+	backLabel: string;
+	nameLabel: string;
+	namePlaceholder: string;
+	emailLabel: string;
+	emailPlaceholder: string;
+	emailInvalidTitle: string;
+	phoneLabel: string;
+	phonePlaceholder: string;
+	notesLabel: string;
+	notesPlaceholder: string;
+	confirmingLabel: string;
+	confirmLabel: string;
+	notWiredError: string;
+	genericSubmitError: string;
+	successMessage: string;
+}
+
+export interface SpaBookingWidgetElement extends HTMLElement {
+	heading?: string;
+	tagline?: string;
+	description?: string;
+	/** Shown as a "Staff" row in the summary panel once a service is picked.
+	 *  Purely presentational -- there is no staff picker. Omit to hide the row. */
+	staffLabel?: string;
+	/** JS `Date#getDay()` values (0 = Sunday) to gray out on the calendar,
+	 *  e.g. `[2]` for a Tuesday closure. Visual hint only -- fetchAvailability
+	 *  is the real source of truth for what's bookable. */
+	closedWeekdays?: number[];
+	/** BCP 47 locale (e.g. "fr-FR") used to format month/weekday names;
+	 *  defaults to the browser's own locale. */
+	locale?: string;
+	/** Jumps straight to the calendar step, pre-selected to whichever
+	 *  treatment's name matches this, once treatments have loaded. Re-fires on
+	 *  every change, even mid-flow on a different service or step. */
+	initialTreatmentTitle?: string;
+	/** Pre-fills the matching contact-details field once a (truthy) value is
+	 *  available, but only while that field is still empty -- never overwrites
+	 *  something the visitor already typed. Applied once per field, no re-fire
+	 *  on later changes (unlike initialTreatmentTitle). */
+	initialName?: string;
+	initialEmail?: string;
+	initialPhone?: string;
+	strings?: Partial<SpaBookingWidgetStrings>;
+	fetchTreatments?: () => Promise<SpaTreatment[]>;
+	/** Host-provided loader for one calendar month at a time:
+	 *  (fromISO, toISO, treatmentId) => per-day bookable start times. */
+	fetchAvailability?: (fromISO: string, toISO: string, treatmentId: string) => Promise<SpaAvailabilityDay[]>;
+	submitBooking?: (payload: SpaBookingPayload) => Promise<SpaBookingResult>;
+}
+
+export interface ReservationCancelPayload {
+	reservationId: string;
+	restaurantSlug?: string;
+}
+export type CancelActionResult = { ok: true } | { ok: false; status?: number };
+
+export interface ReservationCancelStrings {
+	cancelReservation: string;
+	requestSuccess: string;
+	noEmailOnFile: string;
+	requestError: string;
+	dialogEyebrow: string;
+	dialogBody: string;
+	nevermind: string;
+	continueLabel: string;
+	confirmSuccess: string;
+	expiresIn: string;
+	confirmButton: string;
+	confirmError: string;
+	resendSuccess: string;
+	linkExpired: string;
+	resendButton: string;
+	resendError: string;
+}
+
+export interface ReservationCancelElement extends HTMLElement {
+	mode?: 'request' | 'confirm';
+	reservationId?: string;
+	restaurantSlug?: string;
+	token?: string;
+	expiresAt?: number;
+	initiallyExpired?: boolean;
+	strings?: Partial<ReservationCancelStrings>;
+	requestCancel?: (payload: ReservationCancelPayload) => Promise<CancelActionResult>;
+	confirmCancel?: (payload: { token: string }) => Promise<CancelActionResult>;
+}
+
+export interface LiveReservation {
+	id: string;
+	restaurant_id?: string | null;
+	reservation_date: string;
+	start_time: string;
+	party_size: number;
+	status: string;
+	contact_name: string;
+	contact_email?: string | null;
+	contact_phone?: string | null;
+	table_number?: string | null;
+	location?: string | null;
+	created_at: string;
+}
+
+export interface LiveReservationRestaurantRef {
+	id: string;
+	name: string;
+}
+
+export interface LiveReservationsFeedDateFilterEventDetail {
+	filterDateFrom?: string;
+	filterDateTo?: string;
+}
+
+export interface LiveReservationsFeedElement extends HTMLElement {
+	heading?: string;
+	channelName?: string;
+	ablyAuthUrl?: string;
+	/** Fetches one page of reservation history, newest-first; Ably only
+	 *  delivers events published after the subscription starts, so history
+	 *  has to come from a REST call. Omit `cursor` for the first page; each
+	 *  subsequent call passes the `created_at` of the oldest loaded
+	 *  reservation so only the next page is fetched. Return fewer than
+	 *  `limit` items to signal there's nothing older left. */
+	fetchReservations?: (params: {
+		cursor?: string;
+		limit: number;
+		filterDateFrom?: string;
+		filterDateTo?: string;
+	}) => Promise<LiveReservation[]>;
+	restaurants?: LiveReservationRestaurantRef[];
+	maxItems?: number;
+	/** Set false to stop fetching further pages once the first one loads --
+	 *  disables the scroll-to-bottom sentinel entirely rather than swapping
+	 *  in a manual button. Default true. */
+	autoLoadMore?: boolean;
+	emptyLabel?: string;
+	/** Set false to hide the guest email address on list items. Must be set
+	 *  as a JS property to get false -- Boolean-typed custom-element
+	 *  attributes are presence-based. Default true. */
+	showEmail?: boolean;
+	/** Restricts the feed to reservations booked for this date range
+	 *  (inclusive, 'YYYY-MM-DD'), filtering by reservation_date -- not
+	 *  created_at, which stays reserved for pagination. Either bound can be
+	 *  set alone for an open-ended range. Passed through to
+	 *  fetchReservations so the host can scope the query server-side;
+	 *  changing either value triggers a full refetch. Also guards live
+	 *  new-reservation / reservation-status-changed events. */
+	filterDateFrom?: string;
+	filterDateTo?: string;
+	/** Set true to render a built-in from/to date picker in the header,
+	 *  seeded from filterDateFrom/filterDateTo and driving the same
+	 *  filtering -- for host pages that don't want to build their own
+	 *  filter UI. Leave false (default) to filter purely via the props.
+	 *  Each input's min/max is cross-constrained by the other's current
+	 *  value so an inverted range can't be picked. Picking a date emits
+	 *  `date-filter-change` with the new range. */
+	showDateFilter?: boolean;
+}
+
+export interface LiveRoomBooking {
+	id: string;
+	first_name: string;
+	last_name: string;
+	email?: string | null;
+	phone?: string | null;
+	room_number?: string | null;
+	room_type_name?: string | null;
+	check_in: string;
+	check_out: string;
+	guests: number;
+	total_price?: string | number | null;
+	status: string;
+	created_at: string;
+}
+
+export interface LiveRoomBookingsFeedElement extends HTMLElement {
+	heading?: string;
+	channelName?: string;
+	ablyAuthUrl?: string;
+	/** Fetches one page of booking history, newest-first; Ably only
+	 *  delivers events published after the subscription starts, so history
+	 *  has to come from a REST call. Omit `cursor` for the first page; each
+	 *  subsequent call passes the `created_at` of the oldest loaded
+	 *  booking so only the next page is fetched. Return fewer than
+	 *  `limit` items to signal there's nothing older left. */
+	fetchBookings?: (params: { cursor?: string; limit: number }) => Promise<LiveRoomBooking[]>;
+	maxItems?: number;
+	/** Set false to stop fetching further pages once the first one loads --
+	 *  disables the scroll-to-bottom sentinel entirely rather than swapping
+	 *  in a manual button. Default true. */
+	autoLoadMore?: boolean;
+	emptyLabel?: string;
+	/** Set false to hide the guest email address on list items. Must be set
+	 *  as a JS property to get false -- Boolean-typed custom-element
+	 *  attributes are presence-based. Default true. */
+	showEmail?: boolean;
+	/** Symbol prefixed to total_price ('€', '$', ...); the PMS payload
+	 *  carries no currency of its own. Default empty (bare amount). */
+	currency?: string;
+}
+
+export interface LiveSpaBooking {
+	id: string;
+	first_name: string;
+	last_name: string;
+	email?: string | null;
+	phone?: string | null;
+	treatment_name?: string | null;
+	therapist_name?: string | null;
+	start_time: string;
+	duration_minutes: number;
+	price?: string | number | null;
+	status: string;
+	created_at: string;
+}
+
+export interface LiveSpaBookingsFeedElement extends HTMLElement {
+	heading?: string;
+	channelName?: string;
+	ablyAuthUrl?: string;
+	/** Fetches one page of booking history, newest-first; Ably only
+	 *  delivers events published after the subscription starts, so history
+	 *  has to come from a REST call. Omit `cursor` for the first page; each
+	 *  subsequent call passes the `created_at` of the oldest loaded
+	 *  booking so only the next page is fetched. Return fewer than
+	 *  `limit` items to signal there's nothing older left. */
+	fetchBookings?: (params: { cursor?: string; limit: number }) => Promise<LiveSpaBooking[]>;
+	maxItems?: number;
+	/** Set false to stop fetching further pages once the first one loads --
+	 *  disables the scroll-to-bottom sentinel entirely rather than swapping
+	 *  in a manual button. Default true. */
+	autoLoadMore?: boolean;
+	emptyLabel?: string;
+	/** Set false to hide the guest email address on list items. Must be set
+	 *  as a JS property to get false -- Boolean-typed custom-element
+	 *  attributes are presence-based. Default true. */
+	showEmail?: boolean;
+	/** Symbol prefixed to price ('€', '$', ...); the payload carries no
+	 *  currency of its own. Default empty (bare amount). */
+	currency?: string;
+}
+
+export interface GolfShopItem {
+	id?: string;
+	item_id?: string;
+	item_name: string;
+	quantity: number;
+	unit_price?: string | number;
+	total?: string | number;
+	variant?: string | null;
+}
+
+export interface GolfBooking {
+	id: string;
+	first_name: string;
+	last_name: string;
+	email?: string | null;
+	phone?: string | null;
+	course_name?: string | null;
+	tee_time: string;
+	players: number;
+	holes?: number | null;
+	price?: string | number | null;
+	/** Pro-shop purchases attached to the booking; omit or leave empty for a
+	 *  plain tee-time booking with nothing purchased alongside it. */
+	items?: GolfShopItem[];
+	status: string;
+	created_at: string;
+}
+
+export interface LiveGolfBookingsFeedElement extends HTMLElement {
+	heading?: string;
+	channelName?: string;
+	ablyAuthUrl?: string;
+	/** Fetches one page of booking history, newest-first; Ably only
+	 *  delivers events published after the subscription starts, so history
+	 *  has to come from a REST call. Omit `cursor` for the first page; each
+	 *  subsequent call passes the `created_at` of the oldest loaded
+	 *  booking so only the next page is fetched. Return fewer than
+	 *  `limit` items to signal there's nothing older left. */
+	fetchBookings?: (params: { cursor?: string; limit: number }) => Promise<GolfBooking[]>;
+	maxItems?: number;
+	/** Set false to stop fetching further pages once the first one loads --
+	 *  disables the scroll-to-bottom sentinel entirely rather than swapping
+	 *  in a manual button. Default true. */
+	autoLoadMore?: boolean;
+	emptyLabel?: string;
+	/** Set false to hide the guest email address on list items. Must be set
+	 *  as a JS property to get false -- Boolean-typed custom-element
+	 *  attributes are presence-based. Default true. */
+	showEmail?: boolean;
+	/** Symbol prefixed to price ('€', '$', ...); the payload carries no
+	 *  currency of its own. Default empty (bare amount). */
+	currency?: string;
+}
+
+export interface DiningOrderItem {
+	id?: string;
+	item_id?: string;
+	item_name: string;
+	quantity: number;
+	unit_price?: string | number;
+	total?: string | number;
+	variant?: string | null;
+}
+
+export interface DiningOrder {
+	id: string;
+	restaurant_id: string;
+	booking_id?: string | null;
+	table_id?: string | null;
+	/** Joined from restaurant_table by OTA; absent on older payloads. */
+	table_number?: string | null;
+	guest_id?: string | null;
+	status: string;
+	notes?: string | null;
+	scheduled_for?: string | null;
+	total_price: string | number;
+	created_at: string;
+	items: DiningOrderItem[];
+}
+
+export interface DiningOrderBookingRef {
+	id: string;
+	room_number?: string | null;
+	guest_name?: string | null;
+}
+
+export interface LiveDiningOrdersFeedElement extends HTMLElement {
+	heading?: string;
+	channelName?: string;
+	ablyAuthUrl?: string;
+	/** Fetches one page of order history, newest-first; Ably only delivers
+	 *  events published after the subscription starts, so history has to
+	 *  come from a REST call. Omit `cursor` for the first page; each
+	 *  subsequent call passes the `created_at` of the oldest loaded order so
+	 *  only the next page is fetched. Return fewer than `limit` items to
+	 *  signal there's nothing older left. */
+	fetchOrders?: (params: { cursor?: string; limit: number }) => Promise<DiningOrder[]>;
+	/** Resolves booking_id -> room/guest, since the order payload carries
+	 *  only the id. */
+	bookings?: DiningOrderBookingRef[];
+	maxItems?: number;
+	/** Set false to stop fetching further pages once the first one loads --
+	 *  disables the scroll-to-bottom sentinel entirely rather than swapping
+	 *  in a manual button. Default true. */
+	autoLoadMore?: boolean;
+	emptyLabel?: string;
+	/** Symbol prefixed to money amounts ('€', '$', ...); the payload carries
+	 *  no currency of its own. Default empty (bare amount). */
+	currency?: string;
+	/** Restricts the feed to one booking's orders -- `fetchOrders` should
+	 *  already be scoped server-side; this only filters the live `new-order`
+	 *  events, which otherwise arrive unfiltered off the channel. */
+	filterBookingId?: string;
+}
+
+export interface VenueCarouselSlide {
+	key: string;
+	src: string;
+	label?: string;
+	tag?: string;
+	description?: string;
+}
+
+export interface VenueCarouselSlideEventDetail {
+	index: number;
+	key: string;
+}
+
+export interface VenueCarouselElement extends HTMLElement {
+	slides?: VenueCarouselSlide[];
+	activeIndex?: number;
+	reserveLabel?: string;
+	previousLabel?: string;
+	nextLabel?: string;
+}
+
+export interface RoomGridRoom {
+	slug: string;
+	name: string;
+	description?: string;
+	/** Nightly from-price as a number; formatted internally. */
+	price?: number;
+	/** Resolved image URL — the component is backend-agnostic. */
+	image?: string;
+	/** Filter-tab grouping, e.g. "Beach Front". */
+	tag?: string;
+	/** Card CTA destination. */
+	href?: string;
+}
+
+export interface RoomGridDatesEventDetail {
+	checkIn: string;
+	checkOut: string;
+}
+
+export interface RoomGridRoomEventDetail {
+	slug: string;
+}
+
+export interface RoomGridFilterTab {
+	label: string;
+	slug: string;
+}
+
+export interface RoomGridElement extends HTMLElement {
+	rooms?: RoomGridRoom[];
+	filterTabs?: RoomGridFilterTab[];
+	checkIn?: string;
+	checkOut?: string;
+	currency?: string;
+	allLabel?: string;
+	variant?: 'grid' | 'rows';
+}
+
+export interface AvailabilityDay {
+	date: string;
+	available_rooms?: string | number;
+	min_rate?: string | number;
+}
+
+export interface AvailabilityCalendarElement extends HTMLElement {
+	checkIn?: string;
+	checkOut?: string;
+	horizonMonths?: number;
+	fetchAvailability?: (fromISO: string, toISO: string) => Promise<AvailabilityDay[]>;
+}
+
+export interface BookingCardReserveDetail {
+	checkIn: string;
+	checkOut: string;
+	guests: number;
+}
+
+export interface BookingCardElement extends HTMLElement {
+	price?: number;
+	maxGuests?: number;
+	currency?: string;
+	resortFeeRate?: number;
+	ratingText?: string;
+	finePrint?: string;
+	conciergeTitle?: string;
+	conciergeSub?: string;
+	conciergeCtaLabel?: string;
+	conciergeCtaHref?: string;
+	checkIn?: string;
+	checkOut?: string;
+	guests?: number;
+	horizonMonths?: number;
+	fetchAvailability?: (fromISO: string, toISO: string) => Promise<AvailabilityDay[]>;
+}
+
+export interface IslandMapPin {
+	label: string;
+	sub?: string;
+	lat: number;
+	lng: number;
+	/** Key for highlightPin()/unhighlightPin() — e.g. a room slug. */
+	slug?: string;
+}
+
+export interface IslandMapElement extends HTMLElement {
+	pins?: IslandMapPin[];
+	/** "lat,lng" */
+	center?: string;
+	zoom?: number;
+	mapId?: string;
+	/** Used only when no Google Maps loader is already present on the page. */
+	apiKey?: string;
+	colorScheme?: 'DARK' | 'LIGHT' | 'FOLLOW_SYSTEM';
+	fitPins?: boolean;
+	fitPadding?: number;
+	panY?: number;
+	interactionLock?: boolean;
+	pinsVisible?: boolean;
+	highlightPin?: (slug: string) => void;
+	unhighlightPin?: (slug: string) => void;
+}
+
+export interface FloorPlanRoom {
+	id: string;
+	type?: string;
+	label?: string;
+	x: number;
+	y: number;
+	w: number;
+	h: number;
+	sqm?: string | number;
+	imgUrl?: string;
+}
+
+export interface FloorPlanItem {
+	id: string;
+	asset: string;
+	x: number;
+	y: number;
+	w: number;
+	h: number;
+}
+
+export interface FloorPlan {
+	rooms?: FloorPlanRoom[];
+	items?: FloorPlanItem[];
+	w?: number;
+	h?: number;
+}
+
+export interface FloorPlanZoneEventDetail {
+	img?: string;
+	label?: string;
+	type?: string;
+}
+
+export interface FloorPlanHeroElement extends HTMLElement {
+	plan?: FloorPlan;
+	bgUrl?: string;
+	assetBase?: string;
+	label?: string;
+	closeLabel?: string;
+	open?: () => void;
+	close?: () => void;
+	toggle?: () => void;
+}
+
+export interface StaySearchRoom {
+	roomTypeId: string;
+	name: string;
+	description?: string;
+	image?: string;
+	href?: string;
+}
+
+export interface StaySearchResult {
+	room_type_id: string;
+	name?: string;
+	description?: string;
+	from_rate?: string | number;
+	min_available?: string | number;
+}
+
+export interface StaySearchElement extends HTMLElement {
+	rooms?: StaySearchRoom[];
+	checkIn?: string;
+	checkOut?: string;
+	guests?: number;
+	currency?: string;
+	appendDatesToHref?: boolean;
+	searchStays?: (checkIn: string, checkOut: string, guests: number) => Promise<StaySearchResult[]>;
+}
+
+export interface DiningTeaserVenue {
+	key: string;
+	name: string;
+	tag?: string;
+	image: string;
+}
+
+export interface DiningTeaserVenueEventDetail {
+	index: number;
+	key: string;
+}
+
+export interface DiningTeaserElement extends HTMLElement {
+	venues?: DiningTeaserVenue[];
+	heading?: string;
+	headingAccent?: string;
+	body?: string;
+	ctaLabel?: string;
+	ctaHref?: string;
+	imageLabel?: string;
+	activeIndex?: number;
+}
+
+export interface BookingCheckoutLocation {
+	iso2: string;
+	countryName: string;
+	dialCode: string;
+}
+
+export interface BookingCheckoutPrefill {
+	firstName?: string;
+	lastName?: string;
+	email?: string;
+}
+
+export interface BookingCheckoutResolvedLocation {
+	countryName: string;
+	iso2?: string;
+	dialCode?: string;
+}
+
+export interface BookingCheckoutPayload {
+	paymentIntentId: string;
+	bookingFor: 'myself' | 'other';
+	contactName: string;
+	contactEmail: string;
+	contactPhone: string;
+	country: string;
+	countryIso2: string;
+	requests?: string;
+	booker?: { name: string; email: string; phone: string };
+}
+
+export type BookingCheckoutResult = { ok: true; ref?: string } | { ok: false; message: string };
+
+export interface BookingCheckoutElement extends HTMLElement {
+	total?: number;
+	currency?: string;
+	clientSecret?: string;
+	stripePublishableKey?: string;
+	stripeAppearance?: Record<string, unknown>;
+	cancellationPolicy?: string;
+	locations?: BookingCheckoutLocation[];
+	defaultPhoneCode?: string;
+	allowBookingForOther?: boolean;
+	termsHref?: string;
+	prefill?: BookingCheckoutPrefill;
+	resolveInitialLocation?: () => Promise<BookingCheckoutResolvedLocation | null>;
+	beforeSubmit?: () => Promise<void>;
+	submitBooking?: (payload: BookingCheckoutPayload) => Promise<BookingCheckoutResult>;
+	strings?: Record<string, string>;
+}
+
+export interface ConfirmationCardElement extends HTMLElement {
+	eyebrow?: string;
+	heading?: string;
+	body?: string;
+	reference?: string;
+	referenceLabel?: string;
+	primaryLabel?: string;
+	primaryHref?: string;
+	secondaryLabel?: string;
+	secondaryHref?: string;
+	notePrefix?: string;
+	noteLinkLabel?: string;
+	noteLinkHref?: string;
+	noteSuffix?: string;
+}
+
+export interface ExtraItem {
+	id: string;
+	name: string;
+	slug?: string;
+	description?: string;
+	category?: string;
+	image?: string;
+	imageEmail?: string;
+	price: number | null;
+}
+
+export interface ExtrasCatalogueSelection {
+	id: string;
+	name: string;
+	price: number | null;
+	quantity: number;
+	imageEmail?: string;
+}
+
+export interface ExtrasCatalogueChangeEventDetail {
+	items: ExtrasCatalogueSelection[];
+	total: number;
+}
+
+export interface ExtrasCatalogueElement extends HTMLElement {
+	extras?: ExtraItem[];
+	currency?: string;
+	categories?: string[];
+	fallbackCategory?: string;
+	initial?: { id: string; quantity: number }[];
+}
+
+export interface BookingProgressStep {
+	label: string;
+	href?: string;
+}
+
+export interface BookingProgressBarElement extends HTMLElement {
+	steps?: BookingProgressStep[];
+	activeStep?: number;
+	secureLabel?: string;
+	logoHref?: string;
+}
+
+export interface BookingSummaryExtraItem {
+	name: string;
+	price: number;
+	quantity: number;
+}
+
+export interface BookingSummaryElement extends HTMLElement {
+	resortName?: string;
+	logoSrc?: string;
+	checkIn?: string;
+	checkOut?: string;
+	roomImage?: string | null;
+	roomName?: string;
+	roomEmptyLabel?: string;
+	guests?: number;
+	nightlyRate?: number;
+	currency?: string;
+	totalLabel?: string;
+	/** String pseudo-boolean, not a real Boolean-typed attribute: pass the
+	 *  literal attribute value "false" to hide the rate line -- any other
+	 *  value, including bare attribute presence, renders it. */
+	showRate?: string;
+	extrasLabel?: string;
+	extrasItems?: BookingSummaryExtraItem[];
+	continueHref?: string;
+	continueLabelSelected?: string;
+	continueLabelEmpty?: string;
+	needHelpHref?: string;
+}
+
+export interface SearchableSelectOption {
+	value: string;
+	label: string;
+	/** Passed through untouched on the `change` event -- e.g. an ISO2 code alongside a country name. */
+	meta?: unknown;
+}
+
+export interface SearchableSelectChangeEventDetail {
+	value: string;
+	label: string;
+	meta?: unknown;
+}
+
+export interface SearchableSelectElement extends HTMLElement {
+	options?: SearchableSelectOption[];
+	value?: string;
+	placeholder?: string;
+	variant?: 'phone' | 'country' | '';
+	searchPlaceholder?: string;
+}
+
+export interface BookingConfirmedElement extends HTMLElement {
+	heading?: string;
+	detail?: string;
+	note?: string;
+	doneLabel?: string;
+	secondaryLabel?: string;
+	secondaryHref?: string;
+}
+
+export interface RestaurantOrderMenuItem {
+	id: string;
+	name: string;
+	description?: string;
+	category: string;
+	price: number | string;
+	allergens?: string[];
+	variants?: string[];
+}
+
+export interface RestaurantOrderCartItem {
+	item_id: string;
+	quantity: number;
+	variant?: string;
+}
+
+export interface RestaurantOrderPlaceParams {
+	items: RestaurantOrderCartItem[];
+	scheduledFor: string | null;
+}
+
+export interface RestaurantOrderPlaceResult {
+	ok: boolean;
+	error?: string;
+	order?: unknown;
+}
+
+export interface RestaurantOrderPlacedEventDetail {
+	items: RestaurantOrderCartItem[];
+	total: number;
+	scheduledFor: string | null;
+	order: unknown;
+}
+
+export interface RestaurantOrderFormElement extends HTMLElement {
+	items?: RestaurantOrderMenuItem[];
+	categoryOrder?: string[];
+	categoryLabels?: Record<string, string>;
+	currency?: string;
+	iconFor?: (tag: string) => string | undefined;
+	checkIn?: string;
+	checkOut?: string;
+	placeOrder?: (params: RestaurantOrderPlaceParams) => Promise<RestaurantOrderPlaceResult>;
+}
+
+declare global {
+	interface HTMLElementTagNameMap {
+		'reservation-bar': ReservationBarElement;
+		'booking-flow': BookingFlowElement;
+		'menu-section': MenuSectionElement;
+		'event-inquiries-feed': EventInquiriesFeedElement;
+		'event-contact-form': EventContactFormElement;
+		'spa-booking-widget': SpaBookingWidgetElement;
+		'reservation-cancel': ReservationCancelElement;
+		'live-reservations-feed': LiveReservationsFeedElement;
+		'live-room-bookings-feed': LiveRoomBookingsFeedElement;
+		'live-spa-bookings-feed': LiveSpaBookingsFeedElement;
+		'live-golf-bookings-feed': LiveGolfBookingsFeedElement;
+		'live-dining-orders-feed': LiveDiningOrdersFeedElement;
+		'venue-carousel': VenueCarouselElement;
+		'room-grid': RoomGridElement;
+		'island-map': IslandMapElement;
+		'floor-plan-hero': FloorPlanHeroElement;
+		'stay-search': StaySearchElement;
+		'availability-calendar': AvailabilityCalendarElement;
+		'booking-card': BookingCardElement;
+		'dining-teaser': DiningTeaserElement;
+		'booking-checkout': BookingCheckoutElement;
+		'confirmation-card': ConfirmationCardElement;
+		'extras-catalogue': ExtrasCatalogueElement;
+		'booking-progress-bar': BookingProgressBarElement;
+		'booking-summary': BookingSummaryElement;
+		'searchable-select': SearchableSelectElement;
+		'booking-confirmed': BookingConfirmedElement;
+		'restaurant-order-form': RestaurantOrderFormElement;
+	}
+
+	interface HTMLElementEventMap {
+		reservationchange: CustomEvent<{ date: string; guests: number; time: string }>;
+		'booking-confirmed': CustomEvent<{ date: string; time: string; guests: number }>;
+		'inquiry-submitted': CustomEvent<EventInquiryPayload>;
+		'booking-submitted': CustomEvent<SpaBookingPayload>;
+		'cancel-requested': CustomEvent<ReservationCancelPayload>;
+		'cancel-confirmed': CustomEvent<{ token: string }>;
+		'slide-change': CustomEvent<VenueCarouselSlideEventDetail>;
+		'slide-reserve': CustomEvent<VenueCarouselSlideEventDetail>;
+		'dates-change': CustomEvent<RoomGridDatesEventDetail>;
+		'room-hover': CustomEvent<RoomGridRoomEventDetail>;
+		'room-leave': CustomEvent<RoomGridRoomEventDetail>;
+		'zone-hover': CustomEvent<FloorPlanZoneEventDetail>;
+		'zone-leave': CustomEvent<FloorPlanZoneEventDetail>;
+		'venue-change': CustomEvent<DiningTeaserVenueEventDetail>;
+		'checkout-confirmed': CustomEvent<{ ref?: string }>;
+		ready: CustomEvent<undefined>;
+		'extras-change': CustomEvent<ExtrasCatalogueChangeEventDetail>;
+		'order-placed': CustomEvent<RestaurantOrderPlacedEventDetail>;
+		'date-filter-change': CustomEvent<LiveReservationsFeedDateFilterEventDetail>;
+		// Not declared here: `searchable-select` dispatches a CustomEvent named
+		// literally "change" (SearchableSelectChangeEventDetail, above). Adding
+		// it to this global map would override the native `change: Event` type
+		// for every element in any consuming codebase (<input>, <select>, ...).
+		// Cast at the listener instead: `(e as CustomEvent<SearchableSelectChangeEventDetail>).detail`.
+	}
+}