@forgebuild/hotal-ui 0.23.80 → 0.23.136

package/dist/index.d.ts

@@ -249,10 +249,36 @@ export interface EventInquiryPayload {
 	eventType: string;
 	format: string;
 	message: string;
+	/** The order found via showOrderLookup, or null when the lookup is
+	 *  hidden / nothing was looked up. */
+	orderReference: string | null;
+	/** Ticked lines from that order (empty when none) -- the host decides
+	 *  what an enquiry with items on it means, e.g. a return request. */
+	returnItems: { orderItemId: string; quantity: number }[];
 }
 
 export type SubmitInquiryResult = { ok: true } | { ok: false; error?: string };
 
+export interface ReturnableOrderItem {
+	/** The order line's own id -- echoed back as returnItems[].orderItemId. */
+	id: string;
+	name: string;
+	/** e.g. "Grey — L"; omitted for a plain item. */
+	variant?: string;
+	/** Quantity that can come back -- the cap on the stepper. */
+	quantity: number;
+	/** Unit price; null hides the price. */
+	price: number | null;
+	image?: string;
+}
+
+export interface ReturnableOrder {
+	reference: string;
+	items: ReturnableOrderItem[];
+}
+
+export type LookupOrderResult = { ok: true; order: ReturnableOrder } | { ok: false; error?: string };
+
 export interface EventContactFormStrings {
 	nameLabel: string;
 	namePlaceholder: string;
@@ -281,6 +307,18 @@ export interface EventContactFormStrings {
 	notWiredError: string;
 	genericSubmitError: string;
 	successMessage: string;
+	orderLabel: string;
+	orderPlaceholder: string;
+	findOrderLabel: string;
+	findingOrderLabel: string;
+	clearOrderLabel: string;
+	orderEmailFirstError: string;
+	orderLookupError: string;
+	returnItemsLabel: string;
+	/** `{count}` is replaced with the quantity bought. */
+	boughtLabel: string;
+	decreaseReturnAriaLabel: string;
+	increaseReturnAriaLabel: string;
 }
 
 export interface EventContactFormElement extends HTMLElement {
@@ -328,8 +366,18 @@ export interface EventContactFormElement extends HTMLElement {
 	/** 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;
+	/** Adds an "Order number" input with a Find button (shops: return or
+	 *  exchange enquiries). Finding an order via `lookupOrder` lists its lines
+	 *  as a tick list under the input; ticked lines go out on the payload as
+	 *  returnItems. Default false. */
+	showOrderLookup?: boolean;
+	/** ISO 4217 for the looked-up lines' unit prices. Default 'USD'. */
+	currency?: string;
 	strings?: Partial<EventContactFormStrings>;
 	submitInquiry?: (payload: EventInquiryPayload) => Promise<SubmitInquiryResult>;
+	/** Resolves an order number + the email typed in the form to its returnable
+	 *  lines. Only used when showOrderLookup is true. */
+	lookupOrder?: (reference: string, email: string) => Promise<LookupOrderResult>;
 }
 
 export interface SpaTreatment {
@@ -795,6 +843,16 @@ export interface VenueCarouselSlide {
 	label?: string;
 	tag?: string;
 	description?: string;
+	/** A second, real <a href> action alongside the reserve button --
+	 *  omitted (not rendered) when unset. */
+	bookUrl?: string;
+	/** An optional street-sign-style badge over the top corner of this
+	 *  slide's photo. Omitted (not rendered) when unset. */
+	badge?: {
+		title: string;
+		code: string;
+		caption?: string;
+	};
 }
 
 export interface VenueCarouselSlideEventDetail {
@@ -806,6 +864,8 @@ export interface VenueCarouselElement extends HTMLElement {
 	slides?: VenueCarouselSlide[];
 	activeIndex?: number;
 	reserveLabel?: string;
+	/** Only rendered for slides that set their own bookUrl. */
+	bookLabel?: string;
 	previousLabel?: string;
 	nextLabel?: string;
 }
@@ -1365,15 +1425,24 @@ export interface AiChatWidgetElement extends HTMLElement {
 	phone?: string;
 }
 
-/** One purchasable option within a variant group -- a real, distinct
+/** One purchasable combination within a variant group -- a real, distinct
  *  catalogue item (own id, own price, own stock on the host's backend), just
- *  presented as a pill under the group's single card instead of a separate
- *  card of its own. */
+ *  presented as a pill (or a pill pair, one per axis) under the group's
+ *  single card instead of a separate card of its own. */
 export interface ProshopVariant {
 	id: string;
-	/** e.g. "Blue", "Small" -- shown on the pill. */
-	label: string;
+	/** First axis value, e.g. a color: "Blue". */
+	option1: string;
+	/** Second, independent axis value, e.g. a size: "Small". Omit when this
+	 *  group only varies along one axis -- the second pill row never renders
+	 *  unless at least one variant sets this. */
+	option2?: string;
 	price: number | null;
+	/** Swaps the card's photo when this variant becomes selected -- e.g. a
+	 *  different photo per color. Omit on a variant that doesn't change the
+	 *  photo (e.g. a size-only difference): the card falls back to the group
+	 *  item's own `image` whenever the selected variant has none of its own. */
+	image?: string | null;
 }
 
 export interface ProshopItem {
@@ -1386,14 +1455,19 @@ export interface ProshopItem {
 	/** When set, the photo + name link here (e.g. a product detail page).
 	 *  Omit for a catalogue with no such page -- the card stays static. */
 	href?: string | null;
-	/** Renders this card as a variant group: a pill per entry (e.g. colors or
-	 *  sizes) beneath the description, switching which real item id/price the
-	 *  qty stepper and cart operate on. `id`/`price` above are only the
-	 *  initial (first-variant) display values. Each entry is a genuinely
-	 *  separate catalogue item, so per-variant stock still works with no
-	 *  other change -- the host just supplies N real items grouped under one
-	 *  display card instead of N separate cards. */
+	/** Renders this card as a variant group: one pill row per axis (e.g.
+	 *  color, and independently size) beneath the description, switching
+	 *  which real item id/price the qty stepper and cart operate on.
+	 *  `id`/`price` above are only the initial (first-variant) display
+	 *  values. Each entry is a genuinely separate catalogue item, so per-
+	 *  variant stock still works with no other change -- the host just
+	 *  supplies N real items grouped under one display card instead of N
+	 *  separate cards. */
 	variants?: ProshopVariant[];
+	/** Header shown above each pill row, e.g. ["Color", "Size"]. Purely
+	 *  cosmetic -- omit for no header, or supply just the first to label
+	 *  only a single-axis group. */
+	variantAxisLabels?: [string, string?];
 }
 
 export interface ProshopCartItem {
@@ -1428,6 +1502,14 @@ export interface ProshopCatalogueElement extends HTMLElement {
 	 *  Reactive, not mount-only -- reassign it (a new array) after mount to
 	 *  re-sync quantities a host changed elsewhere, e.g. a checkout sidebar. */
 	initial?: { id: string; quantity: number }[];
+	/** Adds a leading tab (before every real category) that shows every item
+	 *  across all categories in one grid, and becomes the default active tab.
+	 *  Omit (default false) to keep the default of the first real category
+	 *  with no all-items tab. */
+	showAllTab?: boolean;
+	/** Label for the all-items tab. Only used when `showAllTab` is true.
+	 *  Default: `'All'`. */
+	allTabLabel?: string;
 }
 
 export interface InstagramFeedPost {
@@ -1512,6 +1594,7 @@ declare global {
 		reservationchange: CustomEvent<{ date: string; guests: number; time: string }>;
 		'booking-confirmed': CustomEvent<{ date: string; time: string; guests: number }>;
 		'inquiry-submitted': CustomEvent<EventInquiryPayload>;
+		'order-found': CustomEvent<{ reference: string }>;
 		'booking-submitted': CustomEvent<SpaBookingPayload>;
 		'cancel-requested': CustomEvent<ReservationCancelPayload>;
 		'cancel-confirmed': CustomEvent<{ token: string }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgebuild/hotal-ui",
-  "version": "0.23.80",
+  "version": "0.23.136",
   "description": "Reusable Svelte UI components for booking and reservation experiences.",
   "type": "module",
   "license": "MIT",
@@ -27,7 +27,8 @@
     "ai": "^7.0.91",
     "gsap": "^3.15.0",
     "libphonenumber-js": "^1.12.41",
-    "svelte": "^5.56.8"
+    "svelte": "^5.56.8",
+    "swiper": "^14.2.0"
   },
   "devDependencies": {
     "@sveltejs/vite-plugin-svelte": "^7.2.0",