@forgebuild/hotal-ui 0.23.203 → 0.23.205

package/dist/index.d.ts

@@ -421,10 +421,32 @@ export interface SpaBookingPayload {
 	email: string;
 	phone: string;
 	notes: string;
+	/** The PaymentIntent confirmed on the Details step -- only present when
+	 *  payment is enabled (stripePublishableKey + createPaymentIntent). Verify
+	 *  its status and amount server-side before booking, and refund/cancel it
+	 *  if the booking is then rejected. */
+	stripePaymentIntentId?: string;
 }
 
 export type SpaBookingResult = { ok: true } | { ok: false; error?: string };
 
+/** The slot a spa PaymentIntent is created for -- the host prices it. */
+export interface SpaPaymentIntentRequest {
+	treatmentId: string;
+	date: string;
+	time: string;
+	therapistId?: string;
+}
+
+export interface SpaPaymentIntentResult {
+	clientSecret: string;
+	paymentIntentId: string;
+	/** The intent's amount (Stripe integer units) and currency, shown as
+	 *  "£X due now" above the card form. Omit either to show no amount. */
+	amount?: number;
+	currency?: string;
+}
+
 export interface SpaBookingWidgetStrings {
 	chooseServiceLabel: string;
 	loadingServices: string;
@@ -440,6 +462,7 @@ export interface SpaBookingWidgetStrings {
 	therapistFilterLabel: string;
 	anyTherapistLabel: string;
 	staffRowLabel: string;
+	bookedAtLabel: string;
 	totalLabel: string;
 	continueLabel: string;
 	changeServiceLabel: string;
@@ -462,6 +485,13 @@ export interface SpaBookingWidgetStrings {
 	memberRateLabel: string;
 	membersOnlyLabel: string;
 	membersOnlyHint: string;
+	paymentLabel: string;
+	paymentDueLabel: string;
+	paymentHint: string;
+	paymentUnavailable: string;
+	paymentNotReady: string;
+	paymentFailed: string;
+	confirmPayLabel: string;
 }
 
 export interface SpaBookingWidgetElement extends HTMLElement {
@@ -475,6 +505,9 @@ export interface SpaBookingWidgetElement extends HTMLElement {
 	 *  a free service (e.g. a consultation call) where showing "£0.00"
 	 *  throughout would read oddly. */
 	hidePrice?: boolean;
+	/** Hides only prices that are exactly 0 (a free service in the list, and
+	 *  its summary/total), leaving every other price visible. */
+	hideZeroPrice?: boolean;
 	/** Skips the "Details" (name/email/phone/notes) step -- for editing an
 	 *  existing booking (a reschedule) rather than collecting a new guest's
 	 *  contact info. "Continue" on the datetime step submits directly using
@@ -485,9 +518,13 @@ export interface SpaBookingWidgetElement extends HTMLElement {
 	 *  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. */
+	/** BCP 47 locale (e.g. "fr-FR") used to format month/weekday names,
+	 *  dates and prices; defaults to the browser's own locale. */
 	locale?: string;
+	/** ISO 4217 code (e.g. "EUR") every price is formatted in, using
+	 *  `locale`. Default "GBP". The payment step's "due now" label uses the
+	 *  PaymentIntent's own currency instead. */
+	currency?: 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. */
@@ -523,6 +560,16 @@ export interface SpaBookingWidgetElement extends HTMLElement {
 	 *  undefined on "Any therapist" or when fetchTherapists was never provided. */
 	fetchAvailability?: (fromISO: string, toISO: string, treatmentId: string, therapistId?: string) => Promise<SpaAvailabilityDay[]>;
 	submitBooking?: (payload: SpaBookingPayload) => Promise<SpaBookingResult>;
+	/** Optional payment: with both this and stripePublishableKey set, the
+	 *  Details step shows a Stripe Payment Element and confirms it before
+	 *  submitBooking (which then gets stripePaymentIntentId). The host's
+	 *  intent decides full charge, deposit, or manual-capture hold. Called
+	 *  on entering Details, and again if the visitor picks a different slot
+	 *  before paying. Unused in skipDetailsStep mode. JS property only. */
+	createPaymentIntent?: (req: SpaPaymentIntentRequest) => Promise<SpaPaymentIntentResult>;
+	stripePublishableKey?: string;
+	/** Stripe Elements `appearance` object. JS property only. */
+	stripeAppearance?: Record<string, unknown>;
 }
 
 export interface ReservationCancelPayload {

package/package.json

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