@forgebuild/hotal-ui 0.23.14 → 0.23.18

package/dist/index.d.ts

@@ -19,6 +19,7 @@ export interface ReservationBarElement extends HTMLElement {
 	defaultTime?: string;
 	showReserveButton?: boolean;
 	reserveHref?: string;
+	applyOnSelect?: boolean;
 	syncWithUrl?: boolean;
 	closedWeekdays?: number[];
 	locale?: string;
@@ -275,6 +276,25 @@ export interface EventContactFormElement extends HTMLElement {
 	 *  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. */
@@ -283,6 +303,95 @@ export interface EventContactFormElement extends HTMLElement {
 	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;
@@ -1028,6 +1137,7 @@ declare global {
 		'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;
@@ -1056,6 +1166,7 @@ declare global {
 		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>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgebuild/hotal-ui",
-  "version": "0.23.14",
+  "version": "0.23.18",
   "description": "Reusable Svelte UI components for booking and reservation experiences.",
   "type": "module",
   "license": "MIT",