@voyantjs/bookings-ui 0.20.0 → 0.21.0

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

@@ -0,0 +1,172 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Accordion, AccordionContent, AccordionItem, AccordionTrigger, } from "@voyantjs/ui/components/accordion";
+import { Card, CardContent } from "@voyantjs/ui/components/card";
+import { Skeleton } from "@voyantjs/ui/components/skeleton";
+/**
+ * Right-rail summary panel. Shows what's being booked, an
+ * accordion-per-step recap of the user's input, and the live
+ * pricing breakdown at the bottom. The current step's accordion is
+ * 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, }) {
+    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: "Total" }), _jsx("span", { children: formatMoney(pricing.total, pricing.currency) })] })] })) : null] })] }));
+}
+function EntityHeader({ summary }) {
+    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: "You're booking" }), _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] })] }));
+}
+function StepRecap({ steps, currentStep, draft, }) {
+    if (!draft)
+        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: STEP_LABELS[step] }), _jsx(StepSummaryLine, { step: step, draft: draft })] }) }), _jsx(AccordionContent, { children: _jsx(StepDetails, { step: step, draft: draft }) })] }, step))) }, currentStep));
+}
+function StepSummaryLine({ step, draft, }) {
+    const text = stepHeadline(step, draft);
+    if (!text)
+        return null;
+    return _jsx("span", { className: "text-muted-foreground text-xs", children: text });
+}
+function stepHeadline(step, draft) {
+    switch (step) {
+        case "configure": {
+            const total = paxTotal(draft);
+            const slot = draft.configure?.departureSlotId ?? draft.configure?.departureDate ?? undefined;
+            const range = draft.configure?.dateRange;
+            const when = range?.checkIn && range?.checkOut ? `${range.checkIn} → ${range.checkOut}` : slot;
+            return when ? `${total} ${total === 1 ? "guest" : "guests"} · ${when}` : `${total} guests`;
+        }
+        case "billing": {
+            const c = draft.billing.contact;
+            const name = [c.firstName, c.lastName].filter(Boolean).join(" ").trim();
+            return name || c.email || "Not set";
+        }
+        case "travelers": {
+            const filled = draft.travelers.filter((t) => t.firstName && t.lastName).length;
+            return `${filled} of ${draft.travelers.length} filled`;
+        }
+        case "accommodation": {
+            const rooms = draft.accommodation?.rooms ?? [];
+            if (rooms.length === 0)
+                return "";
+            return `${rooms.length} room${rooms.length === 1 ? "" : "s"}`;
+        }
+        case "addons": {
+            const addons = draft.addons ?? [];
+            if (addons.length === 0)
+                return "None";
+            return `${addons.length} add-on${addons.length === 1 ? "" : "s"}`;
+        }
+        case "payment": {
+            const intent = draft.payment.intent;
+            if (intent === "card")
+                return "Card";
+            if (intent === "hold")
+                return "Hold";
+            if (intent === "ticket_on_credit")
+                return "On credit";
+            return "";
+        }
+        case "review":
+            return "Confirm and book";
+        default:
+            return "";
+    }
+}
+function StepDetails({ step, draft, }) {
+    switch (step) {
+        case "configure":
+            return _jsx(ConfigureDetails, { draft: draft });
+        case "billing":
+            return _jsx(BillingDetails, { draft: draft });
+        case "travelers":
+            return _jsx(TravelersDetails, { draft: draft });
+        case "accommodation":
+            return _jsx(AccommodationDetails, { draft: draft });
+        case "addons":
+            return _jsx(AddonsDetails, { draft: draft });
+        case "payment":
+            return _jsx(PaymentDetails, { draft: draft });
+        case "review":
+            return (_jsx("p", { className: "text-muted-foreground text-xs", children: "Review your details and confirm to book." }));
+        default:
+            return null;
+    }
+}
+function ConfigureDetails({ draft, }) {
+    const cfg = draft.configure ?? {};
+    const range = cfg.dateRange;
+    return (_jsxs("dl", { className: "space-y-1 text-xs", children: [_jsx(Row, { label: "Adults", value: String(cfg.pax?.adult ?? 0) }), (cfg.pax?.child ?? 0) > 0 ? _jsx(Row, { label: "Children", value: String(cfg.pax.child) }) : null, (cfg.pax?.infant ?? 0) > 0 ? _jsx(Row, { label: "Infants", value: String(cfg.pax.infant) }) : null, cfg.departureSlotId ? _jsx(Row, { label: "Departure", value: cfg.departureSlotId }) : null, cfg.departureDate ? _jsx(Row, { label: "Date", value: cfg.departureDate }) : null, range?.checkIn ? _jsx(Row, { label: "Check-in", value: range.checkIn }) : null, range?.checkOut ? _jsx(Row, { label: "Check-out", value: range.checkOut }) : null, cfg.cabinCategoryId ? _jsx(Row, { label: "Cabin", value: cfg.cabinCategoryId }) : null] }));
+}
+function BillingDetails({ draft, }) {
+    const c = draft.billing.contact;
+    const a = draft.billing.address;
+    const addressLine = [a.line1, a.line2, a.city, a.postal, a.country].filter(Boolean).join(", ");
+    return (_jsxs("dl", { className: "space-y-1 text-xs", children: [_jsx(Row, { label: "Name", value: [c.firstName, c.lastName].filter(Boolean).join(" ") || "—" }), _jsx(Row, { label: "Email", value: c.email || "—" }), c.phone ? _jsx(Row, { label: "Phone", value: c.phone }) : null, _jsx(Row, { label: "Buyer", value: draft.billing.buyerType === "B2B" ? "Company" : "Individual" }), draft.billing.company?.name ? (_jsx(Row, { label: "Company", value: draft.billing.company.name })) : null, draft.billing.company?.vatId ? (_jsx(Row, { label: "VAT", value: draft.billing.company.vatId })) : null, addressLine ? _jsx(Row, { label: "Address", value: addressLine }) : null] }));
+}
+function TravelersDetails({ draft, }) {
+    if (draft.travelers.length === 0) {
+        return _jsx("p", { className: "text-muted-foreground text-xs", children: "No travelers yet." });
+    }
+    return (_jsx("ul", { className: "space-y-3 text-xs", children: draft.travelers.map((t, i) => {
+            const key = t.rowId ?? `t-${i}`;
+            const name = [t.firstName, t.lastName].filter(Boolean).join(" ").trim();
+            const docType = t.documents?.documentType;
+            const docNum = t.documents?.documentNumber;
+            const docExpiry = t.documents?.documentExpiry;
+            const docLine = [docType, docNum, docExpiry ? `exp ${docExpiry}` : null]
+                .filter(Boolean)
+                .join(" · ");
+            return (_jsxs("li", { className: "space-y-0.5", children: [_jsxs("div", { className: "flex justify-between gap-2", children: [_jsxs("span", { className: "text-muted-foreground", children: ["Traveler ", i + 1] }), _jsx("span", { className: "truncate font-medium", children: name || "—" })] }), t.email ? _jsx("div", { className: "text-muted-foreground truncate", children: t.email }) : null, t.phone ? _jsx("div", { className: "text-muted-foreground", children: t.phone }) : null, t.dateOfBirth ? (_jsxs("div", { className: "text-muted-foreground", children: ["DOB ", t.dateOfBirth] })) : null, docLine ? _jsx("div", { className: "text-muted-foreground", children: docLine }) : null] }, key));
+        }) }));
+}
+function AccommodationDetails({ draft, }) {
+    const rooms = draft.accommodation?.rooms ?? [];
+    if (rooms.length === 0) {
+        return _jsx("p", { className: "text-muted-foreground text-xs", children: "Not selected." });
+    }
+    return (_jsx("ul", { className: "space-y-1 text-xs", children: rooms.map((r) => (_jsxs("li", { className: "flex justify-between gap-2", children: [_jsx("span", { className: "truncate", children: r.optionUnitId }), _jsxs("span", { className: "text-muted-foreground", children: ["\u00D7 ", r.quantity, r.ratePlanId ? ` · ${r.ratePlanId}` : ""] })] }, `${r.optionUnitId}-${r.ratePlanId ?? ""}-${r.quantity}`))) }));
+}
+function AddonsDetails({ draft, }) {
+    const addons = draft.addons ?? [];
+    if (addons.length === 0) {
+        return _jsx("p", { className: "text-muted-foreground text-xs", children: "No add-ons selected." });
+    }
+    return (_jsx("ul", { className: "space-y-1 text-xs", children: addons.map((a) => (_jsxs("li", { className: "flex justify-between gap-2", children: [_jsx("span", { className: "truncate", children: a.extraId }), _jsxs("span", { className: "text-muted-foreground", children: ["\u00D7 ", a.quantity] })] }, `${a.extraId}-${a.quantity}`))) }));
+}
+function PaymentDetails({ draft, }) {
+    const intent = draft.payment.intent;
+    const label = intent === "card"
+        ? "Pay by card"
+        : intent === "ticket_on_credit"
+            ? "Ticket on credit"
+            : "Hold (no charge yet)";
+    return (_jsxs("dl", { className: "space-y-1 text-xs", children: [_jsx(Row, { label: "Method", value: label }), draft.payment.schedule ? (_jsx(Row, { label: "Schedule", value: String(draft.payment.schedule) })) : null] }));
+}
+function Row({ label, value }) {
+    return (_jsxs("div", { className: "flex justify-between gap-2", children: [_jsx("dt", { className: "text-muted-foreground", children: label }), _jsx("dd", { className: "truncate text-right", children: value })] }));
+}
+const STEP_LABELS = {
+    configure: "Configure",
+    billing: "Billing & contact",
+    travelers: "Travelers",
+    accommodation: "Accommodation",
+    addons: "Add-ons",
+    payment: "Payment",
+    review: "Review",
+};
+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);
+    }
+    catch {
+        return `${(cents / 100).toFixed(2)} ${currency}`;
+    }
+}

package/dist/journey/components/step-header.d.ts

@@ -0,0 +1,7 @@
+import type { JourneyHeaderState, JourneyStep } from "../types.js";
+interface StepHeaderProps extends JourneyHeaderState {
+    onJumpTo: (step: JourneyStep) => void;
+}
+export declare function StepHeader({ current, visited, steps, onJumpTo, }: StepHeaderProps): React.ReactElement;
+export {};
+//# sourceMappingURL=step-header.d.ts.map

package/dist/journey/components/step-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-header.d.ts","sourceRoot":"","sources":["../../../src/journey/components/step-header.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAElE,UAAU,eAAgB,SAAQ,kBAAkB;IAClD,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAA;CACtC;AAED,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,OAAO,EACP,KAAK,EACL,QAAQ,GACT,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAuBtC"}

package/dist/journey/components/step-header.js

@@ -0,0 +1,28 @@
+"use client";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Button } from "@voyantjs/ui/components/button";
+export function StepHeader({ current, visited, steps, onJumpTo, }) {
+    return (_jsx("ol", { className: "flex flex-wrap gap-2", children: steps.map((step, idx) => {
+            const isCurrent = step === current;
+            const isVisited = visited.includes(step);
+            return (_jsx("li", { children: _jsxs(Button, { type: "button", variant: isCurrent ? "default" : isVisited ? "outline" : "ghost", size: "sm", disabled: !isVisited && !isCurrent, onClick: () => onJumpTo(step), children: [_jsxs("span", { className: "mr-1 font-mono text-xs", children: [idx + 1, "."] }), labelForStep(step)] }) }, step));
+        }) }));
+}
+function labelForStep(step) {
+    switch (step) {
+        case "configure":
+            return "Configure";
+        case "billing":
+            return "Billing";
+        case "travelers":
+            return "Travelers";
+        case "accommodation":
+            return "Accommodation";
+        case "addons":
+            return "Add-ons";
+        case "payment":
+            return "Payment";
+        case "review":
+            return "Review";
+    }
+}

package/dist/journey/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `@voyantjs/bookings-ui/journey` — the unified booking journey shell.
+ *
+ * Per `docs/architecture/booking-journey-architecture.md`.
+ *
+ * Single shell, slot-injected. Operator and storefront consume the
+ * same `<BookingJourney />` and inject surface-specific behavior
+ * (CRM picker, payment provider widget, B2B vs B2C defaults, post-
+ * commit handoff) via render-prop slots.
+ */
+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 { 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 ContractAcceptanceEvent, JOURNEY_STEP_ORDER, type JourneyHeaderState, type JourneyStep, type JourneySurface, type LeadContactPickerProps, type PaymentProviderCapabilities, type PaymentProviderStepRenderProps, type SidePanelState, type TravelerContactPickerProps, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,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"}

package/dist/journey/index.js

@@ -0,0 +1,17 @@
+/**
+ * `@voyantjs/bookings-ui/journey` — the unified booking journey shell.
+ *
+ * Per `docs/architecture/booking-journey-architecture.md`.
+ *
+ * Single shell, slot-injected. Operator and storefront consume the
+ * same `<BookingJourney />` and inject surface-specific behavior
+ * (CRM picker, payment provider widget, B2B vs B2C defaults, post-
+ * commit handoff) via render-prop slots.
+ */
+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 { 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";
+export { JOURNEY_STEP_ORDER, } from "./types.js";

package/dist/journey/lib/draft-state.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Local draft-state reducers + initialization helpers.
+ *
+ * The journey holds the draft as a single useState at the root and
+ * passes immutable views down to step components, which call the
+ * supplied setter to apply patches. Per
+ * booking-journey-architecture §4.
+ */
+import type { BookingDraftV1 } from "@voyantjs/catalog/booking-engine";
+export type Draft = BookingDraftV1;
+export interface DraftEntityIdentity {
+    module: string;
+    id: string;
+    /**
+     * Source kind. Empty string on the storefront before the engine's
+     * server-side resolver fills it in; operator-side wiring sets
+     * the real kind upfront.
+     */
+    sourceKind: string;
+    sourceConnectionId?: string;
+    sourceRef?: string;
+}
+export declare function emptyDraft(entity: DraftEntityIdentity, defaults?: {
+    buyerType?: "B2C" | "B2B";
+}): Draft;
+export declare function patchConfigure(draft: Draft, patch: Partial<Draft["configure"]>): Draft;
+export declare function patchBilling(draft: Draft, patch: Partial<Draft["billing"]>): Draft;
+export declare function patchPaxCount(draft: Draft, band: string, count: number): Draft;
+export declare function setTravelers(draft: Draft, travelers: Draft["travelers"]): Draft;
+export declare function setAccommodation(draft: Draft, accommodation: Draft["accommodation"]): Draft;
+export declare function setAddons(draft: Draft, addons: Draft["addons"]): Draft;
+export declare function setPayment(draft: Draft, payment: Draft["payment"]): Draft;
+export declare function totalPax(draft: Draft): number;
+//# sourceMappingURL=draft-state.d.ts.map

package/dist/journey/lib/draft-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-state.d.ts","sourceRoot":"","sources":["../../../src/journey/lib/draft-state.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAEtE,MAAM,MAAM,KAAK,GAAG,cAAc,CAAA;AAElC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,GAAE;IAAE,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;CAAO,GAC3C,KAAK,CAaP;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,KAAK,CAEtF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,CAElF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAK9E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,KAAK,CAE/E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,KAAK,CAE3F;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,CAEtE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAEzE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAM7C"}

package/dist/journey/lib/draft-state.js

@@ -0,0 +1,54 @@
+/**
+ * Local draft-state reducers + initialization helpers.
+ *
+ * The journey holds the draft as a single useState at the root and
+ * passes immutable views down to step components, which call the
+ * supplied setter to apply patches. Per
+ * booking-journey-architecture §4.
+ */
+export function emptyDraft(entity, defaults = {}) {
+    return {
+        entity,
+        configure: { pax: {} },
+        billing: {
+            buyerType: defaults.buyerType ?? "B2C",
+            contact: { firstName: "", lastName: "", email: "" },
+            address: {},
+        },
+        travelers: [],
+        addons: [],
+        payment: { intent: "hold" },
+    };
+}
+export function patchConfigure(draft, patch) {
+    return { ...draft, configure: { ...draft.configure, ...patch } };
+}
+export function patchBilling(draft, patch) {
+    return { ...draft, billing: { ...draft.billing, ...patch } };
+}
+export function patchPaxCount(draft, band, count) {
+    const safeCount = Number.isFinite(count) && count >= 0 ? Math.floor(count) : 0;
+    return patchConfigure(draft, {
+        pax: { ...draft.configure.pax, [band]: safeCount },
+    });
+}
+export function setTravelers(draft, travelers) {
+    return { ...draft, travelers };
+}
+export function setAccommodation(draft, accommodation) {
+    return { ...draft, accommodation };
+}
+export function setAddons(draft, addons) {
+    return { ...draft, addons };
+}
+export function setPayment(draft, payment) {
+    return { ...draft, payment };
+}
+export function totalPax(draft) {
+    let total = 0;
+    for (const v of Object.values(draft.configure.pax ?? {})) {
+        if (typeof v === "number")
+            total += v;
+    }
+    return total;
+}

package/dist/journey/types.d.ts

@@ -0,0 +1,248 @@
+/**
+ * Shell-side types for `<BookingJourney />`. These complement the
+ * engine contracts in `@voyantjs/catalog/booking-engine/contracts`
+ * with React-specific slots and event shapes that don't belong on
+ * the wire.
+ *
+ * Per booking-journey-architecture §8.1.
+ */
+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 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. */
+    apply: (contact: {
+        firstName: string;
+        lastName: string;
+        email?: string;
+        phone?: string;
+        personId?: string;
+    }) => void;
+}
+export interface TravelerContactPickerProps {
+    rowIndex: number;
+    /** Apply a picked contact to the traveler at `rowIndex`. */
+    apply: (contact: {
+        firstName: string;
+        lastName: string;
+        email?: string;
+        phone?: string;
+        personId?: string;
+    }) => void;
+}
+/**
+ * Capabilities supplied by the template — checkout-ui's PaymentStep
+ * consumes these to render the right provider widget. Each flag is
+ * an independent on/off switch the operator configures per
+ * deployment / supplier:
+ *
+ * - `acceptsCard` — Stripe / Netopia / generic card flow. The
+ *   `renderPaymentProviderStep` slot supplies the actual widget.
+ * - `acceptsBankTransfer` — operator emails the buyer bank details;
+ *   booking is created with status "awaiting_payment". Inventory
+ *   hold is still placed so capacity is reserved.
+ * - `acceptsHold` — staff/agent-only soft-hold path; useful when an
+ *   operator is brokering for an end customer.
+ * - `acceptsTicketOnCredit` — agency credit account.
+ * - `acceptsInquiry` — lead-only flow: NO inventory hold, NO charge.
+ *   The "booking" is recorded as an inquiry for the operator to
+ *   manually follow up on. Right for tour operators where a quote
+ *   conversation precedes booking.
+ */
+export interface PaymentProviderCapabilities {
+    acceptsCard: boolean;
+    acceptsHold: boolean;
+    acceptsBankTransfer?: boolean;
+    acceptsTicketOnCredit: boolean;
+    acceptsInquiry?: boolean;
+    /** Free-form provider-specific config (e.g. Netopia merchant id,
+     *  Stripe publishable key, bank-transfer instructions). */
+    config?: Record<string, unknown>;
+}
+export interface PaymentProviderStepRenderProps {
+    intent: BookingDraftV1["payment"]["intent"];
+    schedule: BookingDraftV1["payment"]["schedule"];
+    capabilities: PaymentProviderCapabilities;
+}
+export interface BookingJourneyProps {
+    /** What to book. */
+    entityModule: string;
+    entityId: string;
+    /**
+     * Source pointer fields. Optional on the public surface — the
+     * engine resolves provenance server-side from
+     * `(entityModule, entityId)` via the catalog plane's
+     * sourced-entry lookup. Operator surfaces should still pass
+     * `sourceKind` explicitly when known.
+     */
+    sourceKind?: string;
+    sourceConnectionId?: string;
+    sourceRef?: string;
+    /** Surface — drives audience defaults and slot wiring. */
+    surface?: "admin" | "public";
+    /** Stable draft id — caller persists in URL or session storage so
+     *  the journey survives page refresh. */
+    draftId: string;
+    /** Default buyer type — operator: B2B, storefront: B2C. */
+    defaultBuyerType?: "B2C" | "B2B";
+    /** Initial fallback shape — rendered before the first quote
+     *  resolves. The engine returns a more specific shape on the
+     *  first quote response. */
+    fallbackShape?: BookingDraftShape;
+    /**
+     * Pre-locked configure state. When set, the journey skips the
+     * Configure step entirely — Configure already happened on the
+     * product detail page. Mirrors the BookingDraft's `configure`
+     * shape (loosely typed so storefront callers can pass a
+     * vertical-specific subset without fighting the contract).
+     */
+    initialConfigure?: Record<string, unknown>;
+    /** Pre-locked accommodation slice (room/rate picks made on the
+     *  detail page). Loosely typed for the same reason. */
+    initialAccommodation?: Record<string, unknown>;
+    /**
+     * When true, the wizard hides Configure regardless of descriptor
+     * flags. Use for storefront flows where the product detail page
+     * already collected those choices.
+     */
+    hideConfigure?: boolean;
+    /** Per-payment-provider capabilities — passed through to the
+     *  Payment step's provider widget. */
+    paymentCapabilities?: PaymentProviderCapabilities;
+    /** Operator: pulls from CRM. Storefront: bare inline form. */
+    renderLeadContactPicker?: (props: LeadContactPickerProps) => ReactNode;
+    renderTravelerContactPicker?: (props: TravelerContactPickerProps) => 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. */
+    renderPaymentProviderStep?: (props: PaymentProviderStepRenderProps) => ReactNode;
+    /** Optional pre/post-step extension slots — useful when a
+     *  template wants to inject a custom block (e.g. coupon code
+     *  banner, marketing opt-in). */
+    renderConfigureExtras?: () => ReactNode;
+    renderBillingExtras?: () => ReactNode;
+    renderReviewExtras?: () => ReactNode;
+    /** Fired on successful commit — typically a navigation. */
+    onCommitted?: (result: BookResponseV1) => void;
+    /** Fired when the user explicitly abandons the journey via the
+     *  shell's cancel button. */
+    onCancelled?: () => void;
+    /** Optional class names. */
+    className?: string;
+    sidePanelClassName?: string;
+    /**
+     * Optional summary of the entity being booked — surfaces in the
+     * side panel so the customer keeps context while filling out the
+     * journey. Shape is loose because each vertical carries different
+     * fields (cruises have ports, hospitality has check-in/out, etc.).
+     */
+    entitySummary?: BookingEntitySummary;
+    /**
+     * Contract preview integration. When `templateSlug` is set, the
+     * Review step's "Continue to checkout" button opens the contract
+     * preview dialog with the rendered template instead of committing
+     * directly. The journey then surfaces the acceptance back to the
+     * caller via `onContractAccepted` so the storefront can call its
+     * own `/checkout/start` endpoint.
+     *
+     * - `previewUrl` — absolute URL of the public render endpoint.
+     * - `resolveVariables` — maps the draft to the template's variable
+     *   schema. The storefront supplies a default mapper that covers
+     *   passenger / billing / room / dates.
+     * - `marketingLabel` — when set, an additional opt-in checkbox is
+     *   rendered in the dialog. Marketing consent is optional and is
+     *   passed through `onContractAccepted` so the caller can decide
+     *   what to do with it.
+     */
+    contract?: {
+        templateSlug: string;
+        previewUrl: string;
+        acceptLanguage?: string;
+        resolveVariables: (input: {
+            draft: BookingDraftV1;
+            pricing: PricingBreakdownV1 | null;
+        }) => Record<string, unknown>;
+        marketingLabel?: ReactNode;
+        termsLabel?: ReactNode;
+    };
+    /**
+     * Fired when the user accepts the contract in the preview dialog.
+     * The caller persists the acceptance + dispatches the checkout
+     * workflow. Receives the rendered HTML so it can be stored
+     * verbatim for the audit trail.
+     */
+    /**
+     * Called when the user clicks Confirm on the Review step. Receives
+     * the rendered contract acceptance when the contract dialog was
+     * shown; receives `null` when the journey skipped the dialog
+     * (no template configured — the storefront still wants to drive
+     * the post-confirm /checkout/start flow).
+     */
+    onContractAccepted?: (acceptance: ContractAcceptanceEvent | null, context: BookingJourneyCheckoutContext) => void | Promise<void>;
+}
+export interface BookingJourneyCheckoutContext {
+    draft: BookingDraftV1;
+    pricing: PricingBreakdownV1 | null;
+    quoteId?: string;
+}
+export interface ContractAcceptanceEvent {
+    templateId: string;
+    templateSlug: string;
+    templateName: string;
+    acceptedTerms: true;
+    acceptedMarketing: boolean;
+    acceptedAt: string;
+    renderedHtml: string;
+}
+/**
+ * Caller-provided context for the side-panel summary. Keep it
+ * vertical-agnostic — the panel renders whatever subset is present.
+ */
+export interface BookingEntitySummary {
+    /** Headline name — e.g. product / cruise / hotel name. */
+    name: string;
+    /** Optional second line — e.g. "Iceland · 1 day", "7 nights · Mediterranean". */
+    subtitle?: string;
+    /** Optional hero image — small thumbnail at the top of the panel. */
+    heroImageUrl?: string;
+    /** Vertical badge — drives the "What you're booking" header copy. */
+    vertical?: "products" | "cruises" | "hospitality" | string;
+    /** Optional ISO date or formatted date — e.g. "Tue, May 5, 2026". */
+    whenLabel?: string;
+    /** Optional location label — e.g. "Reykjavík", "Mediterranean", "Bucharest". */
+    locationLabel?: string;
+    /** ISO start date (YYYY-MM-DD or full ISO) — used by the contract
+     *  preview when the draft only carries a slot id. */
+    startDate?: string;
+    /** ISO end date — paired with `startDate` for ranges and contract
+     *  variables like `departure.end_date`. */
+    endDate?: string;
+    /** Free-form destination / route string — surfaced as
+     *  `product.destination` in contract variables. */
+    destination?: string;
+}
+export interface JourneyHeaderState {
+    current: JourneyStep;
+    visited: ReadonlyArray<JourneyStep>;
+    steps: ReadonlyArray<JourneyStep>;
+    shape: BookingDraftShape;
+}
+export interface SidePanelState {
+    pricing: PricingBreakdownV1 | null;
+    isQuoting: boolean;
+    invalidReason?: string;
+    entitySummary?: BookingEntitySummary;
+    currentStep?: JourneyStep;
+    steps?: ReadonlyArray<JourneyStep>;
+    shape?: BookingDraftShape;
+    draft?: BookingDraftV1;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/journey/types.ts"],"names":[],"mappings":"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"}

package/dist/journey/types.js

@@ -0,0 +1,17 @@
+/**
+ * Shell-side types for `<BookingJourney />`. These complement the
+ * engine contracts in `@voyantjs/catalog/booking-engine/contracts`
+ * with React-specific slots and event shapes that don't belong on
+ * the wire.
+ *
+ * Per booking-journey-architecture §8.1.
+ */
+export const JOURNEY_STEP_ORDER = [
+    "configure",
+    "billing",
+    "travelers",
+    "accommodation",
+    "addons",
+    "payment",
+    "review",
+];