@forgebuild/hotal-ui 0.23.80 → 0.23.88

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 {
@@ -1365,15 +1413,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 +1443,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 +1490,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 +1582,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.88",
   "description": "Reusable Svelte UI components for booking and reservation experiences.",
   "type": "module",
   "license": "MIT",