@voyantjs/bookings-ui 0.107.0 → 0.108.0

package/dist/journey/components/side-panel.d.ts

@@ -1,4 +1,5 @@
-import type { SidePanelState } from "../types.js";
+import { useBookingsUiMessagesOrDefault } from "../../i18n/index.js";
+import type { JourneyStep, SidePanelState } from "../types.js";
 /**
  * Right-rail summary panel. Shows what's being booked, an
  * accordion-per-step recap of the user's input, and the live
@@ -6,7 +7,11 @@ import type { SidePanelState } from "../types.js";
  * expanded by default; users can click any step to peek at what
  * they've filled in elsewhere.
  */
-export declare function PriceSidePanel({ pricing, isQuoting, invalidReason, entitySummary, currentStep, steps, draft, className, }: SidePanelState & {
+export declare function PriceSidePanel({ pricing, isQuoting, invalidReason, entitySummary, currentStep, steps, shape, draft, className, pricingExtras, }: SidePanelState & {
     className?: string;
+    /** Operator-only price controls (override + voucher) rendered with the
+     *  pricing, where they're most in context. */
+    pricingExtras?: React.ReactNode;
 }): React.ReactElement;
+export declare function stepHeadline(step: JourneyStep, draft: NonNullable<SidePanelState["draft"]>, messages: ReturnType<typeof useBookingsUiMessagesOrDefault>): string;
 //# sourceMappingURL=side-panel.d.ts.map

package/dist/journey/components/side-panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"side-panel.d.ts","sourceRoot":"","sources":["../../../src/journey/components/side-panel.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAqC,cAAc,EAAE,MAAM,aAAa,CAAA;AAEpF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,SAAS,EACT,aAAa,EACb,aAAa,EACb,WAAW,EACX,KAAK,EACL,KAAK,EACL,SAAS,GACV,EAAE,cAAc,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CAuD9D"}
+{"version":3,"file":"side-panel.d.ts","sourceRoot":"","sources":["../../../src/journey/components/side-panel.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAiB,8BAA8B,EAAE,MAAM,qBAAqB,CAAA;AACnF,OAAO,KAAK,EAAwB,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEpF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,SAAS,EACT,aAAa,EACb,aAAa,EACb,WAAW,EACX,KAAK,EACL,KAAK,EACL,KAAK,EACL,SAAS,EACT,aAAa,GACd,EAAE,cAAc,GAAG;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;kDAC8C;IAC9C,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAChC,GAAG,KAAK,CAAC,YAAY,CA2FrB;AAoFD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,EAC3C,QAAQ,EAAE,UAAU,CAAC,OAAO,8BAA8B,CAAC,GAC1D,MAAM,CAgER"}

package/dist/journey/components/side-panel.js

@@ -11,22 +11,44 @@ import { formatMessage, useBookingsUiMessagesOrDefault } from "../../i18n/index.
  * expanded by default; users can click any step to peek at what
  * they've filled in elsewhere.
  */
-export function PriceSidePanel({ pricing, isQuoting, invalidReason, entitySummary, currentStep, steps, draft, className, }) {
+export function PriceSidePanel({ pricing, isQuoting, invalidReason, entitySummary, currentStep, steps, shape, draft, className, pricingExtras, }) {
     const messages = useBookingsUiMessagesOrDefault();
-    return (_jsxs(Card, { className: className, children: [entitySummary ? _jsx(EntityHeader, { summary: entitySummary }) : null, _jsxs(CardContent, { className: "space-y-4", children: [steps && steps.length > 0 && currentStep && draft ? (_jsx(StepRecap, { steps: steps, currentStep: currentStep, draft: draft })) : null, isQuoting && !pricing ? (_jsxs("div", { className: "space-y-2", children: [_jsx(Skeleton, { className: "h-4 w-24" }), _jsx(Skeleton, { className: "h-4 w-32" }), _jsx(Skeleton, { className: "h-4 w-20" })] })) : null, invalidReason ? _jsx("p", { className: "text-destructive text-sm", children: invalidReason }) : null, pricing ? (_jsxs("div", { className: "space-y-2 border-t pt-4", children: [_jsx("ul", { className: "space-y-1 text-sm", children: pricing.lines.map((line) => (_jsxs("li", { className: "flex justify-between", children: [_jsxs("span", { children: [line.label, line.quantity ? (_jsxs("span", { className: "text-muted-foreground", children: [" \u00D7 ", line.quantity] })) : null] }), _jsx("span", { children: formatMoney(line.totalAmount, pricing.currency) })] }, `${line.kind}-${line.label}-${line.totalAmount}`))) }), pricing.taxes.length > 0 ? (_jsx("ul", { className: "space-y-1 border-t pt-2 text-sm text-muted-foreground", children: pricing.taxes.map((tax) => (_jsxs("li", { className: "flex justify-between", children: [_jsx("span", { children: tax.label }), _jsx("span", { children: formatMoney(tax.amount, pricing.currency) })] }, tax.code))) })) : null, _jsxs("div", { className: "flex justify-between border-t pt-2 font-medium", children: [_jsx("span", { children: messages.bookingJourney.sidePanel.total }), _jsx("span", { children: formatMoney(pricing.total, pricing.currency) })] })] })) : null] })] }));
-}
-function EntityHeader({ summary }) {
-    const messages = useBookingsUiMessagesOrDefault();
-    return (_jsxs("div", { className: "overflow-hidden rounded-t-xl", children: [summary.heroImageUrl ? (_jsx("img", { src: summary.heroImageUrl, alt: summary.name, className: "aspect-video w-full object-cover" })) : null, _jsxs("div", { className: "space-y-1 px-6 pt-4 pb-2", children: [_jsx("div", { className: "text-muted-foreground text-xs uppercase tracking-wide", children: messages.bookingJourney.sidePanel.youAreBooking }), _jsx("div", { className: "font-semibold leading-tight", children: summary.name }), summary.subtitle ? (_jsx("div", { className: "text-muted-foreground text-sm", children: summary.subtitle })) : null, summary.whenLabel || summary.locationLabel ? (_jsx("div", { className: "text-muted-foreground text-xs", children: [summary.whenLabel, summary.locationLabel].filter(Boolean).join(" · ") })) : null] })] }));
+    // Only surface pricing once the user has configured what actually drives
+    // the price — otherwise the quote's baseline shows a misleading total
+    // (e.g. a per-pax "from" price before any room is picked). Room products
+    // (an `option-units` sub-step) require a room selection; everything else
+    // requires at least one traveler.
+    const configuredPax = draft?.configure?.pax
+        ? Object.values(draft.configure.pax).reduce((sum, n) => sum + (n ?? 0), 0)
+        : 0;
+    const isRoomProduct = (shape?.configureSubSteps ?? []).some((s) => s.kind === "option-units");
+    const roomsPicked = (draft?.configure?.optionSelections?.length ?? 0) > 0;
+    const showPricing = isRoomProduct ? roomsPicked : configuredPax > 0;
+    const pricingHint = isRoomProduct
+        ? messages.bookingJourney.sidePanel.pricingHintRooms
+        : messages.bookingJourney.sidePanel.pricingHint;
+    // Departure shows directly under the product title — it's the most-glanced
+    // fact, so it doesn't belong buried in the recap accordion.
+    const departureText = draft ? stepHeadline("departure", draft, messages) : "";
+    return (_jsxs(Card, { className: className, children: [entitySummary?.heroImageUrl ? (_jsx("img", { src: entitySummary.heroImageUrl, alt: entitySummary.name, className: "aspect-video w-full object-cover" })) : null, entitySummary ? (_jsx(EntityHeader, { summary: entitySummary, departureText: departureText })) : null, _jsxs(CardContent, { className: "space-y-4", children: [steps && steps.length > 0 && currentStep && draft ? (_jsx(StepRecap, { steps: steps, currentStep: currentStep, draft: draft })) : null, invalidReason ? _jsx("p", { className: "text-destructive text-sm", children: invalidReason }) : null, !showPricing ? (_jsx("p", { className: "border-t pt-4 text-muted-foreground text-sm", children: pricingHint })) : isQuoting && !pricing ? (_jsxs("div", { className: "space-y-2 border-t pt-4", children: [_jsx(Skeleton, { className: "h-4 w-24" }), _jsx(Skeleton, { className: "h-4 w-32" }), _jsx(Skeleton, { className: "h-4 w-20" })] })) : null, showPricing && pricing ? (_jsxs("div", { className: "space-y-2 border-t pt-4", children: [_jsx("ul", { className: "space-y-1 text-sm", children: pricing.lines.map((line) => (_jsxs("li", { className: "flex justify-between", children: [_jsxs("span", { children: [line.label, line.quantity ? (_jsxs("span", { className: "text-muted-foreground", children: [" \u00D7 ", line.quantity] })) : null] }), _jsx("span", { children: formatMoney(line.totalAmount, pricing.currency) })] }, `${line.kind}-${line.label}-${line.totalAmount}`))) }), pricing.taxes.length > 0 ? (_jsx("ul", { className: "space-y-1 border-t pt-2 text-sm text-muted-foreground", children: pricing.taxes.map((tax) => (_jsxs("li", { className: "flex justify-between", children: [_jsxs("span", { children: [tax.label, tax.rate > 0 ? ` (${formatTaxRate(tax.rate)})` : ""] }), _jsx("span", { children: formatMoney(tax.amount, pricing.currency) })] }, tax.code))) })) : null, _jsxs("div", { className: "flex justify-between border-t pt-2 font-medium", children: [_jsx("span", { children: messages.bookingJourney.sidePanel.total }), _jsx("span", { children: formatMoney(pricing.total, pricing.currency) })] })] })) : null, pricingExtras ? _jsx("div", { className: "border-t pt-4", children: pricingExtras }) : null] })] }));
+}
+function EntityHeader({ summary, departureText, }) {
+    // Text block only — the hero image is rendered as a direct Card child above.
+    return (_jsxs("div", { className: "space-y-1 px-6 pt-4 pb-2", children: [_jsx("div", { className: "font-semibold leading-tight", children: summary.name }), departureText ? _jsx("div", { className: "text-muted-foreground text-sm", children: departureText }) : null, summary.subtitle ? (_jsx("div", { className: "text-muted-foreground text-sm", children: summary.subtitle })) : null, summary.whenLabel || summary.locationLabel ? (_jsx("div", { className: "text-muted-foreground text-xs", children: [summary.whenLabel, summary.locationLabel].filter(Boolean).join(" · ") })) : null] }));
 }
 function StepRecap({ steps, currentStep, draft, }) {
     const messages = useBookingsUiMessagesOrDefault();
     if (!draft)
         return null;
+    // Departure shows in the header; payment + documents aren't worth a recap
+    // row — so the accordion covers the substantive in-between steps only.
+    const recapSteps = steps.filter((step) => step !== "departure" && step !== "payment" && step !== "documents");
+    if (recapSteps.length === 0)
+        return null;
     // Default-open the current step. Uncontrolled — users can toggle
     // freely. Re-mounts when currentStep changes (key) so the
     // newly-active step opens automatically as the user advances.
-    return (_jsx(Accordion, { defaultValue: [currentStep], multiple: true, children: steps.map((step) => (_jsxs(AccordionItem, { value: step, children: [_jsx(AccordionTrigger, { className: "py-3", children: _jsxs("div", { className: "flex flex-1 flex-col text-left", children: [_jsx("span", { className: step === currentStep ? "font-semibold" : "text-muted-foreground font-medium", children: stepLabel(step, messages) }), _jsx(StepSummaryLine, { step: step, draft: draft })] }) }), _jsx(AccordionContent, { children: _jsx(StepDetails, { step: step, draft: draft }) })] }, step))) }, currentStep));
+    return (_jsx(Accordion, { defaultValue: [currentStep], multiple: true, children: recapSteps.map((step) => (_jsxs(AccordionItem, { value: step, children: [_jsx(AccordionTrigger, { className: "py-3", children: _jsxs("div", { className: "flex flex-1 flex-col text-left", children: [_jsx("span", { className: step === currentStep ? "font-semibold" : "text-muted-foreground font-medium", children: stepLabel(step, messages) }), _jsx(StepSummaryLine, { step: step, draft: draft })] }) }), _jsx(AccordionContent, { children: _jsx(StepDetails, { step: step, draft: draft }) })] }, step))) }, currentStep));
 }
 function StepSummaryLine({ step, draft, }) {
     const messages = useBookingsUiMessagesOrDefault();
@@ -35,17 +57,24 @@ function StepSummaryLine({ step, draft, }) {
         return null;
     return _jsx("span", { className: "text-muted-foreground text-xs", children: text });
 }
-function stepHeadline(step, draft, messages) {
+export function stepHeadline(step, draft, messages) {
     switch (step) {
-        case "configure": {
-            const total = paxTotal(draft);
-            const slot = draft.configure?.departureSlotId ?? draft.configure?.departureDate ?? undefined;
+        case "departure": {
             const range = draft.configure?.dateRange;
-            const when = range?.checkIn && range?.checkOut ? `${range.checkIn} → ${range.checkOut}` : slot;
-            const guestLabel = total === 1
-                ? messages.bookingJourney.sidePanel.guestSingular
-                : messages.bookingJourney.sidePanel.guestPlural;
-            return when ? `${total} ${guestLabel} · ${when}` : `${total} ${guestLabel}`;
+            if (range?.checkIn && range?.checkOut)
+                return `${range.checkIn} → ${range.checkOut}`;
+            // Never surface the raw slot id — show the departure date.
+            return draft.configure?.departureDate
+                ? formatConfigureDate(draft.configure.departureDate)
+                : "";
+        }
+        case "options": {
+            const rooms = (draft.configure?.optionSelections ?? []).reduce((sum, s) => sum + (s.quantity ?? 0), 0);
+            if (rooms <= 0)
+                return "";
+            return `${rooms} ${rooms === 1
+                ? messages.bookingJourney.sidePanel.roomSingular
+                : messages.bookingJourney.sidePanel.roomPlural}`;
         }
         case "billing": {
             const c = draft.billing.contact;
@@ -94,8 +123,10 @@ function stepHeadline(step, draft, messages) {
 function StepDetails({ step, draft, }) {
     const messages = useBookingsUiMessagesOrDefault();
     switch (step) {
-        case "configure":
-            return _jsx(ConfigureDetails, { draft: draft });
+        case "departure":
+            return _jsx(DepartureDetails, { draft: draft });
+        case "options":
+            return _jsx(OptionsDetails, { draft: draft });
         case "billing":
             return _jsx(BillingDetails, { draft: draft });
         case "travelers":
@@ -112,11 +143,17 @@ function StepDetails({ step, draft, }) {
             return null;
     }
 }
-function ConfigureDetails({ draft, }) {
+function DepartureDetails({ draft, }) {
     const messages = useBookingsUiMessagesOrDefault();
     const cfg = draft.configure ?? {};
     const range = cfg.dateRange;
-    return (_jsxs("dl", { className: "space-y-1 text-xs", children: [_jsx(Row, { label: messages.bookingJourney.sidePanel.adults, value: String(cfg.pax?.adult ?? 0) }), (cfg.pax?.child ?? 0) > 0 ? (_jsx(Row, { label: messages.bookingJourney.sidePanel.children, value: String(cfg.pax.child) })) : null, (cfg.pax?.infant ?? 0) > 0 ? (_jsx(Row, { label: messages.bookingJourney.sidePanel.infants, value: String(cfg.pax.infant) })) : null, cfg.departureSlotId ? (_jsx(Row, { label: messages.bookingJourney.sidePanel.departure, value: cfg.departureSlotId })) : null, cfg.departureDate ? (_jsx(Row, { label: messages.bookingJourney.sidePanel.date, value: cfg.departureDate })) : null, range?.checkIn ? (_jsx(Row, { label: messages.bookingJourney.sidePanel.checkIn, value: range.checkIn })) : null, range?.checkOut ? (_jsx(Row, { label: messages.bookingJourney.sidePanel.checkOut, value: range.checkOut })) : null, cfg.cabinCategoryId ? (_jsx(Row, { label: messages.bookingJourney.sidePanel.cabin, value: cfg.cabinCategoryId })) : null] }));
+    return (_jsxs("dl", { className: "space-y-1 text-xs", children: [cfg.departureDate ? (_jsx(Row, { label: messages.bookingJourney.sidePanel.departure, value: formatConfigureDate(cfg.departureDate) })) : null, range?.checkIn ? (_jsx(Row, { label: messages.bookingJourney.sidePanel.checkIn, value: range.checkIn })) : null, range?.checkOut ? (_jsx(Row, { label: messages.bookingJourney.sidePanel.checkOut, value: range.checkOut })) : null] }));
+}
+function OptionsDetails({ draft, }) {
+    const messages = useBookingsUiMessagesOrDefault();
+    const cfg = draft.configure ?? {};
+    const selections = (cfg.optionSelections ?? []).filter((s) => (s.quantity ?? 0) > 0);
+    return (_jsxs("dl", { className: "space-y-1 text-xs", children: [selections.map((selection) => (_jsx(Row, { label: selection.optionUnitName ?? selection.optionName ?? selection.optionId, value: `× ${selection.quantity}` }, selection.optionUnitId ?? selection.optionId))), cfg.cabinCategoryId ? (_jsx(Row, { label: messages.bookingJourney.sidePanel.cabin, value: cfg.cabinCategoryId })) : null] }));
 }
 function BillingDetails({ draft, }) {
     const messages = useBookingsUiMessagesOrDefault();
@@ -181,10 +218,6 @@ function stepLabel(step, messages) {
         return messages.bookingJourney.steps.billingAndContact;
     return messages.bookingJourney.steps[step];
 }
-function paxTotal(draft) {
-    const pax = draft.configure?.pax ?? {};
-    return (pax.adult ?? 0) + (pax.child ?? 0) + (pax.infant ?? 0);
-}
 function formatMoney(cents, currency) {
     try {
         return new Intl.NumberFormat(undefined, { style: "currency", currency }).format(cents / 100);
@@ -193,3 +226,19 @@ function formatMoney(cents, currency) {
         return `${(cents / 100).toFixed(2)} ${currency}`;
     }
 }
+/** Tax rate is stored as a fraction (0.19 → "19%"). Trim trailing zeros. */
+function formatTaxRate(rate) {
+    return `${Number((rate * 100).toFixed(2))}%`;
+}
+/** Format an ISO date (YYYY-MM-DD or full ISO) for the recap, falling back
+ *  to the raw value when unparseable. Never surfaces a raw slot id. */
+function formatConfigureDate(iso) {
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime()))
+        return iso;
+    return new Intl.DateTimeFormat(undefined, {
+        year: "numeric",
+        month: "short",
+        day: "numeric",
+    }).format(date);
+}

package/dist/journey/index.d.ts

@@ -10,9 +10,9 @@
  */
 export { BookingJourney } from "./components/booking-journey.js";
 export { type ContractAcceptance, ContractPreviewDialog, type ContractPreviewDialogProps, } from "./components/contract-preview-dialog.js";
-export { AccommodationStep, AddonsStep, BillingStep, ConfigureStep, PaymentStep, ReviewStep, TravelersStep, } from "./components/journey-steps.js";
+export { AccommodationStep, AddonsStep, BillingStep, DepartureStep, OptionsStep, PaymentStep, ReviewStep, TravelersStep, } from "./components/journey-steps.js";
 export { PriceSidePanel } from "./components/side-panel.js";
 export { StepHeader } from "./components/step-header.js";
 export { type Draft, emptyDraft, patchBilling, patchConfigure, patchPaxCount, setAccommodation, setAddons, setPayment, setTravelers, totalPax, } from "./lib/draft-state.js";
-export { type BookingEntitySummary, type BookingJourneyCheckoutContext, type BookingJourneyProps, type BookingJourneyTransitionGuard, type BookingJourneyTransitionGuardContext, type BookingJourneyTransitionGuardResult, type ContractAcceptanceEvent, JOURNEY_STEP_ORDER, type JourneyHeaderState, type JourneyStep, type JourneySurface, type LeadContactPickerProps, type PaymentProviderCapabilities, type PaymentProviderStepRenderProps, type SidePanelState, type TravelerContactPickerProps, } from "./types.js";
+export { type BillingExtrasContext, type BookingEntitySummary, type BookingJourneyCheckoutContext, type BookingJourneyProps, type BookingJourneyTransitionGuard, type BookingJourneyTransitionGuardContext, type BookingJourneyTransitionGuardResult, type ContractAcceptanceEvent, type DeparturePickerProps, JOURNEY_STEP_ORDER, type JourneyHeaderState, type JourneyOptionSelection, type JourneyStep, type JourneySurface, type LeadContactPickerProps, type PaymentProviderCapabilities, type PaymentProviderStepRenderProps, type SidePanelState, type TravelerContactPickerProps, type UnitsPickerProps, type VoucherPickerProps, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/journey/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/journey/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAChE,OAAO,EACL,KAAK,kBAAkB,EACvB,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAA;AAChD,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,EACL,KAAK,KAAK,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,YAAY,EACZ,QAAQ,GACT,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EAClC,KAAK,oCAAoC,EACzC,KAAK,mCAAmC,EACxC,KAAK,uBAAuB,EAC5B,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,cAAc,EACnB,KAAK,0BAA0B,GAChC,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/journey/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAChE,OAAO,EACL,KAAK,kBAAkB,EACvB,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAA;AAChD,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,EACL,KAAK,KAAK,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,YAAY,EACZ,QAAQ,GACT,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EAClC,KAAK,oCAAoC,EACzC,KAAK,mCAAmC,EACxC,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,cAAc,EACnB,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAA"}

package/dist/journey/index.js

@@ -10,7 +10,7 @@
  */
 export { BookingJourney } from "./components/booking-journey.js";
 export { ContractPreviewDialog, } from "./components/contract-preview-dialog.js";
-export { AccommodationStep, AddonsStep, BillingStep, ConfigureStep, PaymentStep, ReviewStep, TravelersStep, } from "./components/journey-steps.js";
+export { AccommodationStep, AddonsStep, BillingStep, DepartureStep, OptionsStep, PaymentStep, ReviewStep, TravelersStep, } from "./components/journey-steps.js";
 export { PriceSidePanel } from "./components/side-panel.js";
 export { StepHeader } from "./components/step-header.js";
 export { emptyDraft, patchBilling, patchConfigure, patchPaxCount, setAccommodation, setAddons, setPayment, setTravelers, totalPax, } from "./lib/draft-state.js";

package/dist/journey/lib/pax-band-dependencies.d.ts

@@ -0,0 +1,27 @@
+import type { PaxBandDependency } from "@voyantjs/catalog/booking-engine";
+/**
+ * A pax-band occupancy rule that the picked traveler counts violate.
+ * Carries resolved band labels + the rule kind so the UI can render a
+ * localized message without re-resolving codes.
+ */
+export interface PaxBandDependencyViolation {
+    type: PaxBandDependency["type"];
+    dependentCode: string;
+    masterCode: string;
+    dependentLabel: string;
+    masterLabel: string;
+    /** The numeric limit for `limits_per_master` / `limits_sum`. */
+    limit?: number;
+}
+/**
+ * Evaluate the product's cross-band occupancy rules against the picked
+ * pax counts. Returns one violation per broken rule (empty when valid).
+ *
+ * Rules only fire when at least one dependent is picked — an empty
+ * booking never violates "Child requires Adult".
+ */
+export declare function evaluatePaxBandDependencies(pax: Record<string, number> | undefined, dependencies: ReadonlyArray<PaxBandDependency> | undefined, bands: ReadonlyArray<{
+    code: string;
+    label: string;
+}>): PaxBandDependencyViolation[];
+//# sourceMappingURL=pax-band-dependencies.d.ts.map

package/dist/journey/lib/pax-band-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pax-band-dependencies.d.ts","sourceRoot":"","sources":["../../../src/journey/lib/pax-band-dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AAEzE;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACvC,YAAY,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,SAAS,EAC1D,KAAK,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GACpD,0BAA0B,EAAE,CAwC9B"}

package/dist/journey/lib/pax-band-dependencies.js

@@ -0,0 +1,50 @@
+/**
+ * Evaluate the product's cross-band occupancy rules against the picked
+ * pax counts. Returns one violation per broken rule (empty when valid).
+ *
+ * Rules only fire when at least one dependent is picked — an empty
+ * booking never violates "Child requires Adult".
+ */
+export function evaluatePaxBandDependencies(pax, dependencies, bands) {
+    if (!dependencies || dependencies.length === 0)
+        return [];
+    const counts = pax ?? {};
+    const labelByCode = new Map(bands.map((b) => [b.code, b.label]));
+    const label = (code) => labelByCode.get(code) ?? code;
+    const violations = [];
+    for (const dep of dependencies) {
+        const dependent = counts[dep.dependentCode] ?? 0;
+        const master = counts[dep.masterCode] ?? 0;
+        // No dependents picked → nothing to enforce.
+        if (dependent <= 0)
+            continue;
+        const base = {
+            type: dep.type,
+            dependentCode: dep.dependentCode,
+            masterCode: dep.masterCode,
+            dependentLabel: label(dep.dependentCode),
+            masterLabel: label(dep.masterCode),
+        };
+        switch (dep.type) {
+            case "requires":
+                if (master <= 0)
+                    violations.push(base);
+                break;
+            case "excludes":
+                if (master > 0)
+                    violations.push(base);
+                break;
+            case "limits_per_master":
+                if (dep.maxPerMaster != null && dependent > master * dep.maxPerMaster) {
+                    violations.push({ ...base, limit: dep.maxPerMaster });
+                }
+                break;
+            case "limits_sum":
+                if (dep.maxDependentSum != null && dependent > dep.maxDependentSum) {
+                    violations.push({ ...base, limit: dep.maxDependentSum });
+                }
+                break;
+        }
+    }
+    return violations;
+}

package/dist/journey/lib/payment-schedule.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Convert between the `PaymentScheduleSection` editor value
+ * (`{ mode, installments }`) and the booking draft's `paymentSchedules` rows.
+ *
+ * The row shape is derived from `Draft` so it always matches the engine
+ * contract. Paid-installment metadata (date / method / reference) is encoded
+ * as JSON in the row `notes` — the SAME format the owned create-sheet uses —
+ * so a schedule round-trips losslessly through the draft (and both flows write
+ * an identical wire shape).
+ */
+import { type PaymentScheduleValue } from "../../components/payment-schedule-section.js";
+import type { Draft } from "./draft-state.js";
+type PaymentScheduleRow = NonNullable<Draft["paymentSchedules"]>[number];
+/** Editor value → draft rows. Returns `[]` when nothing is schedulable yet. */
+export declare function paymentScheduleValueToRows(value: PaymentScheduleValue, currency: string, totalAmountCents: number | null): PaymentScheduleRow[];
+/** Draft rows → editor value (re-init on step remount; preserves paid metadata). */
+export declare function rowsToPaymentScheduleValue(rows: PaymentScheduleRow[] | undefined, departureDate: string | null): PaymentScheduleValue;
+export {};
+//# sourceMappingURL=payment-schedule.d.ts.map

package/dist/journey/lib/payment-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-schedule.d.ts","sourceRoot":"","sources":["../../../src/journey/lib/payment-schedule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,8CAA8C,CAAA;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAE7C,KAAK,kBAAkB,GAAG,WAAW,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAmBxE,+EAA+E;AAC/E,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAC9B,kBAAkB,EAAE,CA8BtB;AAED,oFAAoF;AACpF,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,kBAAkB,EAAE,GAAG,SAAS,EACtC,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,oBAAoB,CA8BtB"}

package/dist/journey/lib/payment-schedule.js

@@ -0,0 +1,90 @@
+/**
+ * Convert between the `PaymentScheduleSection` editor value
+ * (`{ mode, installments }`) and the booking draft's `paymentSchedules` rows.
+ *
+ * The row shape is derived from `Draft` so it always matches the engine
+ * contract. Paid-installment metadata (date / method / reference) is encoded
+ * as JSON in the row `notes` — the SAME format the owned create-sheet uses —
+ * so a schedule round-trips losslessly through the draft (and both flows write
+ * an identical wire shape).
+ */
+import { createInstallment, createPaymentScheduleValue, } from "../../components/payment-schedule-section.js";
+function paidNotes(installment) {
+    if (!installment.alreadyPaid)
+        return null;
+    return JSON.stringify({
+        alreadyPaid: true,
+        paymentDate: installment.paymentDate,
+        paymentMethod: installment.paymentMethod,
+        paymentReference: installment.paymentReference.trim() || null,
+    });
+}
+/** Editor value → draft rows. Returns `[]` when nothing is schedulable yet. */
+export function paymentScheduleValueToRows(value, currency, totalAmountCents) {
+    if (!currency)
+        return [];
+    if (value.mode === "full") {
+        const inst = value.installments[0];
+        if (!inst?.dueDate || totalAmountCents === null)
+            return [];
+        return [
+            {
+                scheduleType: "balance",
+                status: inst.alreadyPaid ? "paid" : "due",
+                dueDate: inst.dueDate,
+                currency,
+                amountCents: totalAmountCents,
+                notes: paidNotes(inst),
+            },
+        ];
+    }
+    // split — N installments; first defaults to `due`, the rest to `pending`.
+    const rows = [];
+    for (const [idx, inst] of value.installments.entries()) {
+        if (!inst.dueDate || inst.amountCents == null)
+            continue;
+        rows.push({
+            scheduleType: "installment",
+            status: inst.alreadyPaid ? "paid" : idx === 0 ? "due" : "pending",
+            dueDate: inst.dueDate,
+            currency,
+            amountCents: inst.amountCents,
+            notes: paidNotes(inst),
+        });
+    }
+    return rows;
+}
+/** Draft rows → editor value (re-init on step remount; preserves paid metadata). */
+export function rowsToPaymentScheduleValue(rows, departureDate) {
+    if (!rows || rows.length === 0)
+        return createPaymentScheduleValue(departureDate);
+    const installments = rows.map((row) => {
+        let alreadyPaid = row.status === "paid";
+        let paymentDate = null;
+        let paymentMethod = "bank_transfer";
+        let paymentReference = "";
+        if (row.notes) {
+            try {
+                const meta = JSON.parse(row.notes);
+                if (meta.alreadyPaid) {
+                    alreadyPaid = true;
+                    paymentDate = meta.paymentDate ?? null;
+                    paymentMethod = meta.paymentMethod ?? "bank_transfer";
+                    paymentReference = meta.paymentReference ?? "";
+                }
+            }
+            catch {
+                // `notes` wasn't our JSON payload (e.g. a free-text note) — ignore.
+            }
+        }
+        return createInstallment({
+            amountCents: row.amountCents,
+            dueDate: row.dueDate,
+            alreadyPaid,
+            paymentDate,
+            paymentMethod,
+            paymentReference,
+        });
+    });
+    return { mode: rows.length > 1 ? "split" : "full", installments };
+}

package/dist/journey/types.d.ts

@@ -8,27 +8,45 @@
  */
 import type { BookingDraftShape, BookingDraftV1, BookResponseV1, PricingBreakdownV1 } from "@voyantjs/catalog/booking-engine";
 import type { ReactNode } from "react";
-export type JourneyStep = "configure" | "billing" | "travelers" | "accommodation" | "addons" | "payment" | "review";
+export type JourneyStep = "departure" | "billing" | "travelers" | "options" | "accommodation" | "addons" | "payment" | "documents" | "review";
 export declare const JOURNEY_STEP_ORDER: ReadonlyArray<JourneyStep>;
 export interface JourneySurface {
     /** Operator-side or storefront — drives default slot behavior. */
     kind: "admin" | "public";
 }
 export interface LeadContactPickerProps {
-    /** Apply a picked contact to the draft's billing fields. Email is
-     *  optional because CRM-backed people may not have one stored —
-     *  the billing form will surface it as empty for the operator to
-     *  fill in. */
+    /** Current buyer type — the picker should search PEOPLE for B2C and
+     *  ORGANIZATIONS for B2B. */
+    buyerType: "B2C" | "B2B";
+    /** Apply a picked lead to the draft's billing fields. A PARTIAL — only
+     *  the provided fields are merged, so separate CRM lookups (person/org
+     *  record, then its address) can each fill their slice without clobbering
+     *  the others. B2C fills the person; B2B fills companyName/taxId; both
+     *  fill the billing address from the CRM record. */
     apply: (contact: {
-        firstName: string;
-        lastName: string;
+        firstName?: string;
+        lastName?: string;
         email?: string;
         phone?: string;
         personId?: string;
+        organizationId?: string;
+        companyName?: string;
+        taxId?: string;
+        address?: {
+            line1?: string;
+            line2?: string;
+            city?: string;
+            postal?: string;
+            country?: string;
+        };
     }) => void;
 }
 export interface TravelerContactPickerProps {
     rowIndex: number;
+    /** The CRM person currently linked to this traveler row, if any. The
+     *  picker should reflect it in its combobox — so e.g. "Copy from billing"
+     *  (which links the billing person) shows that person as selected. */
+    selectedPersonId?: string;
     /** Apply a picked contact to the traveler at `rowIndex`. */
     apply: (contact: {
         firstName: string;
@@ -38,6 +56,94 @@ export interface TravelerContactPickerProps {
         personId?: string;
     }) => void;
 }
+/**
+ * Context handed to `renderBillingExtras` — the picked lead + the departure —
+ * so a template can run lead-aware checks (e.g. "this customer already booked
+ * this departure") next to the billing block.
+ */
+export interface BillingExtrasContext {
+    buyerType: "B2C" | "B2B";
+    personId?: string;
+    organizationId?: string;
+    productId: string;
+    departureSlotId?: string;
+    departureDate?: string;
+}
+/**
+ * Props for the injectable voucher picker. The operator surface wires an async
+ * combobox (search the admin vouchers list) so staff pick a voucher without
+ * knowing the exact code; the storefront keeps the customer code-entry form.
+ */
+export interface VoucherPickerProps {
+    /** Currently-linked voucher redemption on the draft, if any. */
+    value: {
+        voucherId?: string;
+        amountCents?: number;
+    };
+    /** Apply a picked voucher's full remaining balance — or clear with `null`. */
+    onApply: (picked: {
+        voucherId: string;
+        amountCents: number;
+    } | null) => void;
+    /** Booking currency + payable total, to display/cap the redemption. */
+    currency?: string;
+    amountCents?: number;
+}
+/**
+ * Props for the injectable departure picker rendered in the Configure
+ * step for a `"departure"` sub-step. The template wires this with a
+ * scheduled-departures source (e.g. operator availability) so the
+ * operator picks a real departure rather than typing a free date.
+ *
+ * The picker owns its own data-loading and should fall back to a free
+ * date when the product has no scheduled departures — the journey just
+ * stores whatever it reports via `onChange`.
+ */
+export interface DeparturePickerProps {
+    /** The owned product whose departures to load. */
+    productId: string;
+    /** Selected product option, used to filter departures (null = any). */
+    optionId: string | null;
+    /** Currently-picked scheduled departure id, or null. */
+    slotId: string | null;
+    /** Currently-entered departure date (free-date fallback), or null. */
+    departureDate: string | null;
+    /** Currently-entered departure time (free-date fallback), or null. */
+    departureTime: string | null;
+    /** Report a change — any omitted field is left unchanged on the draft. */
+    onChange: (next: {
+        slotId?: string | null;
+        departureDate?: string | null;
+        departureTime?: string | null;
+    }) => void;
+}
+/** A picked inventory unit (room) selection on the draft's configure. */
+export interface JourneyOptionSelection {
+    optionId: string;
+    optionName?: string;
+    optionUnitId?: string;
+    optionUnitName?: string;
+    quantity: number;
+}
+/**
+ * Props for the injectable units (rooms) picker rendered in the Configure
+ * step for an `"option-units"` sub-step. The template wires it to an
+ * inventory source (operator availability) so the operator picks room
+ * quantities for the chosen option + departure; the journey stores the
+ * result on `configure.optionSelections`.
+ */
+export interface UnitsPickerProps {
+    /** The owned product whose units to load. */
+    productId: string;
+    /** Currently-selected product option (drives which units show), or null. */
+    optionId: string | null;
+    /** Currently-picked departure slot (drives per-slot availability), or null. */
+    slotId: string | null;
+    /** Current unit selections on the draft. */
+    selections: ReadonlyArray<JourneyOptionSelection>;
+    /** Report the new full set of unit selections. */
+    onChange: (selections: JourneyOptionSelection[]) => void;
+}
 /**
  * Capabilities supplied by the template — checkout-ui's PaymentStep
  * consumes these to render the right provider widget. Each flag is
@@ -102,6 +208,16 @@ export interface BookingJourneyProps {
     sourceRef?: string;
     /** Surface — drives audience defaults and slot wiring. */
     surface?: "admin" | "public";
+    /**
+     * Layout of the booking flow.
+     *  - `"wizard"` — one step at a time with Back/Next (the guided
+     *    storefront flow).
+     *  - `"stacked"` — every section rendered as a block on a single
+     *    scrollable page, nothing hidden (the operator flow — an admin
+     *    can see travelers while editing options, and jump around freely).
+     * Defaults to `"stacked"` on the admin surface and `"wizard"` on
+     * public, keeping the two processes deliberately separate. */
+    layout?: "wizard" | "stacked";
     /** Stable draft id — caller persists in URL or session storage so
      *  the journey survives page refresh. */
     draftId: string;
@@ -134,6 +250,21 @@ export interface BookingJourneyProps {
     /** Operator: pulls from CRM. Storefront: bare inline form. */
     renderLeadContactPicker?: (props: LeadContactPickerProps) => ReactNode;
     renderTravelerContactPicker?: (props: TravelerContactPickerProps) => ReactNode;
+    /** Operator-only voucher picker (async search). When omitted, the voucher
+     *  control falls back to the customer code-entry form. */
+    renderVoucherPicker?: (props: VoucherPickerProps) => ReactNode;
+    /**
+     * Renders the Configure step's `"departure"` sub-step. Operator
+     * surfaces wire this to a scheduled-departure picker (availability);
+     * when omitted, the journey renders a free date/time fallback.
+     */
+    renderDeparturePicker?: (props: DeparturePickerProps) => ReactNode;
+    /**
+     * Renders the Configure step's `"option-units"` sub-step (room/unit
+     * quantity selection). Operator surfaces wire this to an inventory
+     * units picker; when omitted, the sub-step renders nothing.
+     */
+    renderUnitsPicker?: (props: UnitsPickerProps) => ReactNode;
     /** Hook for the actual payment-provider widget — checkout-ui's
      *  PaymentStep is the canonical implementation. When omitted, the
      *  shell renders a "Hold only — no card collected" stub. */
@@ -149,7 +280,9 @@ export interface BookingJourneyProps {
      *  template wants to inject a custom block (e.g. coupon code
      *  banner, marketing opt-in). */
     renderConfigureExtras?: () => ReactNode;
-    renderBillingExtras?: () => ReactNode;
+    /** Billing extras — receives the picked lead + departure so a template can,
+     *  e.g., warn that this customer already has a booking on this departure. */
+    renderBillingExtras?: (ctx: BillingExtrasContext) => ReactNode;
     renderReviewExtras?: () => ReactNode;
     /** Fired on successful commit — typically a navigation. */
     onCommitted?: (result: BookResponseV1) => void;