@ticketboothapp/booking 1.2.122 → 1.2.124

package/src/components/booking/useAdminChangeQuotePreview.ts

@@ -0,0 +1,506 @@
+import {
+  useEffect,
+  useMemo,
+  useRef,
+  type Dispatch,
+  type MutableRefObject,
+  type SetStateAction,
+} from 'react';
+import {
+  quoteChangeBooking,
+  quoteChangeBookingAdminFeReceipt,
+  type AdminFeAuthoritativeReceipt,
+  type Availability,
+  type ItineraryDisplayStep,
+  type Product,
+  type ReturnOption,
+} from '../../lib/booking-api';
+import { roundMoney } from '../../lib/booking/change-flow-pricing';
+import { getItineraryStepLabel } from '../../lib/booking/itinerary-display';
+import type { OrderSummaryTicketLine } from '../../lib/booking/pricing';
+import { formatCurrencyAmount } from '../../lib/currency';
+import type { ChangeBookingFlowProps, ChangeFlowSelectionPreview } from './booking-flow-types';
+import { sliceAndMergeChangeQuoteForUi } from './change-booking-quote-state';
+import {
+  formatTicketLineItemsForSummary,
+  getAvailabilityOptionId,
+} from './change-booking-flow-helpers';
+import type { Currency } from './CurrencySwitcher';
+import type { AdminChangeLatestQuote } from './useAdminChangeCheckoutController';
+
+type AddOnSelection = { addOnId: string; variantId?: string; quantity?: number };
+type AdminCustomReceiptLine = { label: string; amountInput: string; amountSign?: number };
+type AdditionalAdjustment = { label: string; amount: number };
+
+interface ChangeSelectionDetailsForPreview {
+  dateChanged: boolean;
+  ticketsChanged: boolean;
+}
+
+export interface UseAdminChangeQuotePreviewParams {
+  isCustomerSelfServeChange: boolean;
+  isProviderDashboardChange: boolean;
+  hasChangeSelection: boolean;
+  hasEffectiveChangeSelection: boolean;
+  selectedAvailability: Availability | null;
+  selectedReturnOption: ReturnOption | null;
+  initialValues: ChangeBookingFlowProps['initialValues'];
+  lastName: string;
+  product: Product;
+  pickupLocationId: string | null;
+  quantities: Record<string, number>;
+  addOnSelections: AddOnSelection[];
+  adminCustomReceiptLines: AdminCustomReceiptLine[];
+  editableSummaryLineAmountInputs: Record<string, string>;
+  editableSummaryLineLabelInputs: Record<string, string>;
+  useAdminFeAuthoritativeQuote: boolean;
+  latestChangeQuote: AdminChangeLatestQuote | null;
+  setLatestChangeQuote: Dispatch<SetStateAction<AdminChangeLatestQuote | null>>;
+  changeQuoteLoading: boolean;
+  setChangeQuoteLoading: Dispatch<SetStateAction<boolean>>;
+  changeQuoteFetchError: string | null;
+  setChangeQuoteFetchError: Dispatch<SetStateAction<string | null>>;
+  lastCompletedQuoteInputsKeyRef: MutableRefObject<string | null>;
+  inFlightQuoteInputsKeyRef: MutableRefObject<string | null>;
+  changeQuoteRequestSeq: MutableRefObject<number>;
+  totalQuantity: number;
+  ticketLineItems: OrderSummaryTicketLine[];
+  computeItineraryDisplay: () => ItineraryDisplayStep[] | null;
+  changeSelectionDetails: ChangeSelectionDetailsForPreview;
+  originalReceipt: ChangeBookingFlowProps['originalReceipt'];
+  suppressSelfServeCurrencyUi: boolean;
+  selfServePricingConfirmed: boolean;
+  displayChangeFlowProposedTotalWithEditableLines: number;
+  totalPrice: number;
+  currency: Currency;
+  changeFlowClientEstimateDue: number;
+  changeFlowInitialTicketCount: number;
+  changeFlowNewBookingTotal: number;
+  effectiveSubtotalForCheckout: number;
+  effectiveTax: number;
+  adminCustomLinesAsAdditionalAdjustments: AdditionalAdjustment[];
+  adminFeAuthoritativeReceipt: AdminFeAuthoritativeReceipt;
+  isTaxIncludedInPrice: boolean;
+  t: (key: string) => string;
+  locale: string;
+  error: string;
+  onChangeFlowSelectionPreview?: ChangeBookingFlowProps['onChangeFlowSelectionPreview'];
+  onPricePreviewChange?: ChangeBookingFlowProps['onPricePreviewChange'];
+}
+
+export interface UseAdminChangeQuotePreviewResult {
+  missingRequiredReturnSelection: boolean;
+  isChangeQuoteBlocked: boolean;
+  changeFlowSubmitDisabled: boolean;
+  changeCheckoutButtonLabel: string | undefined;
+  checkoutFormError: string;
+}
+
+export function useAdminChangeQuotePreview({
+  isCustomerSelfServeChange,
+  isProviderDashboardChange,
+  hasChangeSelection,
+  hasEffectiveChangeSelection,
+  selectedAvailability,
+  selectedReturnOption,
+  initialValues,
+  lastName,
+  product,
+  pickupLocationId,
+  quantities,
+  addOnSelections,
+  adminCustomReceiptLines,
+  editableSummaryLineAmountInputs,
+  editableSummaryLineLabelInputs,
+  useAdminFeAuthoritativeQuote,
+  latestChangeQuote,
+  setLatestChangeQuote,
+  changeQuoteLoading,
+  setChangeQuoteLoading,
+  changeQuoteFetchError,
+  setChangeQuoteFetchError,
+  lastCompletedQuoteInputsKeyRef,
+  inFlightQuoteInputsKeyRef,
+  changeQuoteRequestSeq,
+  totalQuantity,
+  ticketLineItems,
+  computeItineraryDisplay,
+  changeSelectionDetails,
+  originalReceipt,
+  suppressSelfServeCurrencyUi,
+  selfServePricingConfirmed,
+  displayChangeFlowProposedTotalWithEditableLines,
+  totalPrice,
+  currency,
+  changeFlowClientEstimateDue,
+  changeFlowInitialTicketCount,
+  changeFlowNewBookingTotal,
+  effectiveSubtotalForCheckout,
+  effectiveTax,
+  adminCustomLinesAsAdditionalAdjustments,
+  adminFeAuthoritativeReceipt,
+  isTaxIncludedInPrice,
+  t,
+  locale,
+  error,
+  onChangeFlowSelectionPreview,
+  onPricePreviewChange,
+}: UseAdminChangeQuotePreviewParams): UseAdminChangeQuotePreviewResult {
+  const lastChangeFlowPreviewKeyRef = useRef<string | null>(null);
+
+  const changeFlowNeedsServerPrice =
+    isCustomerSelfServeChange &&
+    hasChangeSelection &&
+    !!initialValues?.bookingReference?.trim() &&
+    !!lastName.trim();
+
+  const isChangeQuoteBlocked = isCustomerSelfServeChange && latestChangeQuote?.canProceed === false;
+  const changeQuoteInputsKey = useMemo(() => JSON.stringify({
+    bookingReference: initialValues?.bookingReference?.trim() ?? '',
+    lastName: lastName.trim().toLowerCase(),
+    parentProductId: product.productId,
+    optionId: selectedAvailability ? getAvailabilityOptionId(selectedAvailability) : '',
+    dateTime: selectedAvailability?.dateTime ?? '',
+    availabilityId: selectedAvailability?.availabilityId ?? null,
+    pickupLocationId: pickupLocationId ?? null,
+    returnAvailabilityId: selectedReturnOption?.returnAvailabilityId ?? null,
+    quantities,
+    addOnSelections,
+    adminCustomReceiptLines,
+    editableSummaryLineAmountInputs,
+    editableSummaryLineLabelInputs,
+    useAdminFeAuthoritativeQuote,
+  }), [
+    initialValues?.bookingReference,
+    lastName,
+    product.productId,
+    selectedAvailability,
+    pickupLocationId,
+    selectedReturnOption?.returnAvailabilityId,
+    quantities,
+    addOnSelections,
+    adminCustomReceiptLines,
+    editableSummaryLineAmountInputs,
+    editableSummaryLineLabelInputs,
+    useAdminFeAuthoritativeQuote,
+  ]);
+  const destinationRequiresReturnSelection = Boolean(selectedAvailability?.returnOptions?.length);
+  const missingRequiredReturnSelection = destinationRequiresReturnSelection && !selectedReturnOption;
+
+  const changeFlowSubmitDisabled =
+    missingRequiredReturnSelection ||
+    (isCustomerSelfServeChange &&
+      changeFlowNeedsServerPrice &&
+      (changeQuoteLoading || (!latestChangeQuote && !changeQuoteFetchError)));
+
+  const changeCheckoutButtonLabel = (() => {
+    if (!hasEffectiveChangeSelection) return undefined;
+    if (isProviderDashboardChange) {
+      const est = Math.round(changeFlowClientEstimateDue * 100) / 100;
+      return est > 0
+        ? `Change booking (${formatCurrencyAmount(est, currency, locale as 'en' | 'fr')})`
+        : est < 0
+          ? `Change booking (${formatCurrencyAmount(est, currency, locale as 'en' | 'fr')})`
+          : 'Change booking (no charge)';
+    }
+    if (changeFlowNeedsServerPrice) {
+      if (changeQuoteLoading) {
+        const tr = t('booking.updatingPrice');
+        return tr !== 'booking.updatingPrice' ? tr : 'Updating price\u2026';
+      }
+      if (changeQuoteFetchError) {
+        const tr = t('booking.changeBookingRetry');
+        return tr !== 'booking.changeBookingRetry' ? tr : 'Change booking (retry)';
+      }
+      if (isChangeQuoteBlocked) {
+        const tr = t('booking.changeBookingNotAvailable');
+        return tr !== 'booking.changeBookingNotAvailable' ? tr : 'Change not available';
+      }
+      if (latestChangeQuote) {
+        const d = Math.round(changeFlowClientEstimateDue * 100) / 100;
+        return d > 0
+          ? `Change booking (${formatCurrencyAmount(d, currency, locale as 'en' | 'fr')})`
+          : d < 0
+            ? `Change booking (${formatCurrencyAmount(d, currency, locale as 'en' | 'fr')})`
+            : 'Change booking (no charge)';
+      }
+      const tr = t('booking.changeBooking');
+      return tr !== 'booking.changeBooking' ? tr : 'Change booking';
+    }
+    const est = Math.round(changeFlowClientEstimateDue * 100) / 100;
+    return est > 0
+      ? `Change booking (${formatCurrencyAmount(est, currency, locale as 'en' | 'fr')})`
+      : est < 0
+        ? `Change booking (${formatCurrencyAmount(est, currency, locale as 'en' | 'fr')})`
+        : 'Change booking (no charge)';
+  })();
+
+  const checkoutFormError =
+    (error || '') ||
+    (missingRequiredReturnSelection ? 'Please select a return time for this product.' : '') ||
+    (isCustomerSelfServeChange && isChangeQuoteBlocked ? (latestChangeQuote?.reasonIfBlocked ?? '') : '') ||
+    (isCustomerSelfServeChange ? changeQuoteFetchError ?? '' : '');
+
+  const changeFlowSelectionPreview = useMemo((): ChangeFlowSelectionPreview | null => {
+    if (!selectedAvailability || totalQuantity <= 0) return null;
+    const ticketsLine = formatTicketLineItemsForSummary(
+      ticketLineItems.map((l) => ({ category: l.category, qty: l.qty }))
+    );
+    const itinerary = computeItineraryDisplay();
+    const itinerarySteps =
+      itinerary?.map((s) => ({
+        time: s.time?.trim() || null,
+        label: getItineraryStepLabel(s),
+      })) ?? [];
+    return {
+      tourName: product.name?.trim() || '',
+      dateTime: selectedAvailability.dateTime,
+      ticketsLine,
+      itinerarySteps,
+      dateChanged: changeSelectionDetails.dateChanged,
+      ticketsChanged: changeSelectionDetails.ticketsChanged,
+      hasChangesFromInitial: hasEffectiveChangeSelection,
+      selectionTotal:
+        originalReceipt
+          ? suppressSelfServeCurrencyUi && !selfServePricingConfirmed && !useAdminFeAuthoritativeQuote
+            ? null
+            : displayChangeFlowProposedTotalWithEditableLines
+          : totalPrice,
+      selectionCurrency: currency,
+    };
+  }, [
+    selectedAvailability,
+    totalQuantity,
+    ticketLineItems,
+    computeItineraryDisplay,
+    product.name,
+    changeSelectionDetails,
+    hasEffectiveChangeSelection,
+    totalPrice,
+    currency,
+    originalReceipt,
+    displayChangeFlowProposedTotalWithEditableLines,
+    suppressSelfServeCurrencyUi,
+    selfServePricingConfirmed,
+    useAdminFeAuthoritativeQuote,
+  ]);
+
+  useEffect(() => {
+    if (!onChangeFlowSelectionPreview) return;
+    const next = changeFlowSelectionPreview;
+    const key =
+      next === null
+        ? 'null'
+        : JSON.stringify({
+            tourName: next.tourName,
+            dateTime: next.dateTime,
+            ticketsLine: next.ticketsLine,
+            itinerarySteps: next.itinerarySteps,
+            dateChanged: next.dateChanged,
+            ticketsChanged: next.ticketsChanged,
+            hasChangesFromInitial: next.hasChangesFromInitial,
+            selectionTotal: next.selectionTotal,
+            selectionCurrency: next.selectionCurrency,
+          });
+    if (key === lastChangeFlowPreviewKeyRef.current) return;
+    lastChangeFlowPreviewKeyRef.current = key;
+    onChangeFlowSelectionPreview(next);
+  }, [changeFlowSelectionPreview, onChangeFlowSelectionPreview]);
+
+  useEffect(() => {
+    if (!onPricePreviewChange) return;
+    if (!selectedAvailability || totalQuantity <= 0) {
+      onPricePreviewChange(null);
+      return;
+    }
+    if (suppressSelfServeCurrencyUi && !selfServePricingConfirmed) {
+      onPricePreviewChange(null);
+      return;
+    }
+    onPricePreviewChange({
+      subtotal: originalReceipt ? adminFeAuthoritativeReceipt.subtotal : effectiveSubtotalForCheckout,
+      tax:
+        !isTaxIncludedInPrice
+          ? originalReceipt
+            ? adminFeAuthoritativeReceipt.tax
+            : effectiveTax
+          : 0,
+      total: originalReceipt ? displayChangeFlowProposedTotalWithEditableLines : totalPrice,
+      currency,
+    });
+  }, [
+    onPricePreviewChange,
+    selectedAvailability,
+    totalQuantity,
+    effectiveSubtotalForCheckout,
+    effectiveTax,
+    displayChangeFlowProposedTotalWithEditableLines,
+    adminFeAuthoritativeReceipt.subtotal,
+    adminFeAuthoritativeReceipt.tax,
+    currency,
+    isTaxIncludedInPrice,
+    originalReceipt,
+    totalPrice,
+    suppressSelfServeCurrencyUi,
+    selfServePricingConfirmed,
+  ]);
+
+  /** Debounced server quote so CTA + amount owed match PaymentIntent; avoids free confirm when FE estimate differs. */
+  useEffect(() => {
+    if (!isCustomerSelfServeChange) {
+      setChangeQuoteLoading(false);
+      setChangeQuoteFetchError(null);
+      setLatestChangeQuote(null);
+      return;
+    }
+
+    if (
+      !hasChangeSelection ||
+      !selectedAvailability ||
+      !initialValues?.bookingReference?.trim() ||
+      !lastName.trim() ||
+      missingRequiredReturnSelection
+    ) {
+      setLatestChangeQuote(null);
+      setChangeQuoteLoading(false);
+      setChangeQuoteFetchError(null);
+      lastCompletedQuoteInputsKeyRef.current = null;
+      inFlightQuoteInputsKeyRef.current = null;
+      return;
+    }
+
+    if (
+      changeQuoteInputsKey &&
+      (inFlightQuoteInputsKeyRef.current === changeQuoteInputsKey ||
+        lastCompletedQuoteInputsKeyRef.current === changeQuoteInputsKey)
+    ) {
+      setChangeQuoteLoading(false);
+      return;
+    }
+
+    const optionId = getAvailabilityOptionId(selectedAvailability);
+    if (!optionId) {
+      setLatestChangeQuote(null);
+      setChangeQuoteLoading(false);
+      setChangeQuoteFetchError(null);
+      return;
+    }
+
+    if (changeQuoteInputsKey && lastCompletedQuoteInputsKeyRef.current !== changeQuoteInputsKey) {
+      setLatestChangeQuote(null);
+    }
+    setChangeQuoteLoading(true);
+    setChangeQuoteFetchError(null);
+    const seq = ++changeQuoteRequestSeq.current;
+    const bookingReferenceForQuote = initialValues.bookingReference.trim();
+    const timer = window.setTimeout(() => {
+      void (async () => {
+        inFlightQuoteInputsKeyRef.current = changeQuoteInputsKey;
+        const bookingItems = Object.entries(quantities)
+          .filter(([, count]) => count > 0)
+          .map(([category, count]) => ({ category, count }));
+        try {
+          const quoteRequestBase = {
+            bookingReference: bookingReferenceForQuote,
+            lastName: lastName.trim(),
+            newProductId: optionId,
+            newParentProductId: product.productId,
+            newDateTime: selectedAvailability.dateTime,
+            newAvailabilityId: selectedAvailability.availabilityId || null,
+            newPickupLocationId: pickupLocationId || null,
+            newReturnAvailabilityId: selectedReturnOption?.returnAvailabilityId ?? null,
+            newPassengerCounts: bookingItems,
+            // Omit when empty: backend treats [] as "clear all"; missing = preserve stored selections (BookingChangeIntentService).
+            ...(addOnSelections.length > 0 ? { newAddOnSelections: addOnSelections } : {}),
+            ...(adminCustomLinesAsAdditionalAdjustments.length > 0
+              ? { manualLineAdjustments: adminCustomLinesAsAdditionalAdjustments }
+              : {}),
+            clientProposedTotal: changeFlowNewBookingTotal,
+            capacitySeatCredit: {
+              enabled: true,
+              previousPassengerCount: changeFlowInitialTicketCount,
+              previousAvailabilityId: initialValues.availabilityId ?? null,
+              previousReturnAvailabilityId: initialValues.returnAvailabilityId ?? null,
+            },
+          };
+          const deterministicClientProposedTotal = useAdminFeAuthoritativeQuote
+            ? adminFeAuthoritativeReceipt.total
+            : changeFlowNewBookingTotal;
+          const deterministicAmountDue = originalReceipt
+            ? roundMoney(adminFeAuthoritativeReceipt.total - originalReceipt.total)
+            : roundMoney(changeFlowClientEstimateDue);
+          const quote = useAdminFeAuthoritativeQuote
+            ? await quoteChangeBookingAdminFeReceipt({
+                ...quoteRequestBase,
+                feReceipt: adminFeAuthoritativeReceipt,
+                feAmountDueMajorUnits: deterministicAmountDue,
+                clientProposedTotal: deterministicClientProposedTotal,
+              })
+            : await quoteChangeBooking(quoteRequestBase);
+          if (seq !== changeQuoteRequestSeq.current) return;
+          setLatestChangeQuote(
+            sliceAndMergeChangeQuoteForUi(quote, {
+              total: changeFlowNewBookingTotal,
+              subtotal: effectiveSubtotalForCheckout,
+              tax: effectiveTax,
+            }, currency).mergedQuote,
+          );
+          lastCompletedQuoteInputsKeyRef.current = changeQuoteInputsKey;
+        } catch (e) {
+          if (seq !== changeQuoteRequestSeq.current) return;
+          setLatestChangeQuote(null);
+          setChangeQuoteFetchError(e instanceof Error ? e.message : 'Failed to get price for this change');
+          lastCompletedQuoteInputsKeyRef.current = null;
+        } finally {
+          if (inFlightQuoteInputsKeyRef.current === changeQuoteInputsKey) {
+            inFlightQuoteInputsKeyRef.current = null;
+          }
+          if (seq === changeQuoteRequestSeq.current) {
+            setChangeQuoteLoading(false);
+          }
+        }
+      })();
+    }, 450);
+
+    return () => {
+      window.clearTimeout(timer);
+    };
+  }, [
+    isCustomerSelfServeChange,
+    hasChangeSelection,
+    selectedAvailability,
+    initialValues,
+    lastName,
+    missingRequiredReturnSelection,
+    pickupLocationId,
+    selectedReturnOption?.returnAvailabilityId,
+    quantities,
+    addOnSelections,
+    changeFlowInitialTicketCount,
+    changeFlowNewBookingTotal,
+    changeFlowClientEstimateDue,
+    effectiveSubtotalForCheckout,
+    effectiveTax,
+    currency,
+    adminCustomLinesAsAdditionalAdjustments,
+    adminFeAuthoritativeReceipt,
+    useAdminFeAuthoritativeQuote,
+    changeQuoteInputsKey,
+    originalReceipt,
+    product.productId,
+    setChangeQuoteLoading,
+    setChangeQuoteFetchError,
+    setLatestChangeQuote,
+    lastCompletedQuoteInputsKeyRef,
+    inFlightQuoteInputsKeyRef,
+    changeQuoteRequestSeq,
+  ]);
+
+  return {
+    missingRequiredReturnSelection,
+    isChangeQuoteBlocked,
+    changeFlowSubmitDisabled,
+    changeCheckoutButtonLabel,
+    checkoutFormError,
+  };
+}

package/src/components/booking/useAdminChangeReceiptDerivation.ts

@@ -0,0 +1,203 @@
+import { useMemo } from 'react';
+import type { AdminFeAuthoritativeReceipt } from '../../lib/booking-api';
+import {
+  changeFlowBalanceVsOriginal,
+  normalizeNearZeroOwed,
+  reconcileTaxIncludedChangeFlowTicketLines,
+  roundMoney,
+} from '../../lib/booking/change-flow-pricing';
+import type { PriceBreakdown as PriceBreakdownData } from '../../lib/booking/pricing';
+import type { ChangeBookingFlowProps } from './booking-flow-types';
+import type { CheckoutModalLineItem } from './CheckoutModal';
+import type { Currency } from './CurrencySwitcher';
+import type { PriceSummaryLine } from './PriceSummary';
+import {
+  mapSummaryLinesToFeReceiptLineItems,
+  normalizeFeReceiptLineItemType,
+  type PricingRate,
+} from './change-booking-flow-helpers';
+import type { AdminChangeLatestQuote } from './useAdminChangeCheckoutController';
+import type { ProviderDashboardChangeBookingPayload } from './provider-dashboard-change-booking';
+
+type GetPriceBreakdown = (
+  category: string,
+  priceCAD: number,
+  baseInDisplayCurrency: number | undefined,
+  appliedAdjustments?: Array<{ type: string; id: string; name: string; changeByCurrency?: Record<string, number> }>,
+) => PriceBreakdownData | null;
+
+export interface UseAdminChangeReceiptDerivationParams {
+  isTaxIncludedInPrice: boolean;
+  originalReceipt: ChangeBookingFlowProps['originalReceipt'];
+  showProviderPricingInlineEditor: boolean;
+  editableCheckoutPriceSummaryLines: PriceSummaryLine[];
+  displayChangeFlowProposedTotalWithEditableLines: number;
+  effectivePromoDiscountAmount: number;
+  pricing: PricingRate[];
+  getPriceBreakdown: GetPriceBreakdown;
+  quantities: Record<string, number>;
+  displayChangeFlowTax: number;
+  t: (key: string) => string;
+  currency: Currency;
+  useAdminFeAuthoritativeQuote: boolean;
+  totalPrice: number;
+  unchangedReceiptAnchor: { subtotal: number; tax: number; total: number } | null;
+  isCustomerSelfServeChange: boolean;
+  latestChangeQuote: AdminChangeLatestQuote | null;
+  changeQuoteFetchError: string | null;
+  displayChangeFlowProposedTotal: number;
+  editableSummaryPreSubtotalDelta: number;
+}
+
+export function useAdminChangeReceiptDerivation({
+  isTaxIncludedInPrice,
+  originalReceipt,
+  showProviderPricingInlineEditor,
+  editableCheckoutPriceSummaryLines,
+  displayChangeFlowProposedTotalWithEditableLines,
+  effectivePromoDiscountAmount,
+  pricing,
+  getPriceBreakdown,
+  quantities,
+  displayChangeFlowTax,
+  t,
+  currency,
+  useAdminFeAuthoritativeQuote,
+  totalPrice,
+  unchangedReceiptAnchor,
+  isCustomerSelfServeChange,
+  latestChangeQuote,
+  changeQuoteFetchError,
+  displayChangeFlowProposedTotal,
+  editableSummaryPreSubtotalDelta,
+}: UseAdminChangeReceiptDerivationParams) {
+  const taxIncludedReconciledCheckoutPriceSummaryLines = useMemo(() => {
+    if (!isTaxIncludedInPrice || !originalReceipt || showProviderPricingInlineEditor) {
+      return editableCheckoutPriceSummaryLines;
+    }
+    return reconcileTaxIncludedChangeFlowTicketLines(
+      editableCheckoutPriceSummaryLines,
+      displayChangeFlowProposedTotalWithEditableLines,
+      effectivePromoDiscountAmount,
+    );
+  }, [
+    isTaxIncludedInPrice,
+    originalReceipt,
+    showProviderPricingInlineEditor,
+    editableCheckoutPriceSummaryLines,
+    displayChangeFlowProposedTotalWithEditableLines,
+    effectivePromoDiscountAmount,
+  ]);
+
+  const checkoutModalTicketLinesDisplay = useMemo((): CheckoutModalLineItem[] => {
+    return taxIncludedReconciledCheckoutPriceSummaryLines
+      .filter((l): l is Extract<PriceSummaryLine, { kind: 'ticket' }> => l.kind === 'ticket')
+      .map((line) => {
+        const rate = pricing.find((r) => r.category === line.category);
+        const breakdown = getPriceBreakdown(
+          line.category,
+          rate?.priceCAD ?? 0,
+          rate?.baseInDisplayCurrency,
+          rate?.appliedAdjustments ?? [],
+        );
+        const qty = Math.max(0, line.qty);
+        return {
+          line: {
+            category: line.category,
+            qty,
+            itemTotal: line.itemTotal,
+            pricePerUnit: qty > 0 ? roundMoney(line.itemTotal / qty) : 0,
+          },
+          breakdown,
+        };
+      });
+  }, [taxIncludedReconciledCheckoutPriceSummaryLines, pricing, getPriceBreakdown]);
+
+  const adminFeAuthoritativeReceipt = useMemo((): AdminFeAuthoritativeReceipt => {
+    const hasTaxLine = taxIncludedReconciledCheckoutPriceSummaryLines.some(
+      (line) => line.kind === 'line' && String(line.type ?? '').toUpperCase() === 'TAX',
+    );
+    const lineItems = mapSummaryLinesToFeReceiptLineItems(
+      taxIncludedReconciledCheckoutPriceSummaryLines,
+      quantities,
+    );
+    if (!hasTaxLine && Math.abs(displayChangeFlowTax) >= 0.0005) {
+      lineItems.push({
+        label: t('booking.tax') !== 'booking.tax' ? t('booking.tax') : 'Taxes and fees',
+        amount: roundMoney(displayChangeFlowTax),
+        type: 'TAX',
+      });
+    }
+    const tax = roundMoney(displayChangeFlowTax);
+    const expectedTotal = roundMoney(displayChangeFlowProposedTotalWithEditableLines);
+    const subtotal = roundMoney(expectedTotal - tax);
+    return {
+      subtotal,
+      tax,
+      total: expectedTotal,
+      currency,
+      lineItems,
+    };
+  }, [
+    taxIncludedReconciledCheckoutPriceSummaryLines,
+    quantities,
+    displayChangeFlowTax,
+    displayChangeFlowProposedTotalWithEditableLines,
+    currency,
+    t,
+  ]);
+
+  const providerApplyAuthoritativeReceipt = useMemo(():
+    | ProviderDashboardChangeBookingPayload['authoritativeReceipt']
+    | undefined => {
+    if (!useAdminFeAuthoritativeQuote) return undefined;
+    return {
+      subtotalBeforeTax: adminFeAuthoritativeReceipt.subtotal,
+      taxAmount: adminFeAuthoritativeReceipt.tax,
+      totalAmount: adminFeAuthoritativeReceipt.total,
+      currency: adminFeAuthoritativeReceipt.currency ?? currency,
+      lineItems: adminFeAuthoritativeReceipt.lineItems.map((line) => ({
+        type: normalizeFeReceiptLineItemType(line.type) || 'FEE',
+        label: String(line.label || 'Adjustment'),
+        amount: Number(line.amount) || 0,
+        ...(line.quantity != null ? { quantity: Number(line.quantity) || 0 } : {}),
+      })),
+    };
+  }, [adminFeAuthoritativeReceipt, currency, useAdminFeAuthoritativeQuote]);
+
+  const changeFlowClientEstimateDueBase = (() => {
+    if (!originalReceipt) return totalPrice;
+    if (unchangedReceiptAnchor) return 0;
+    if (isCustomerSelfServeChange && latestChangeQuote != null && !changeQuoteFetchError) {
+      const pq = latestChangeQuote.quotePreviousTotalCents;
+      const nq = latestChangeQuote.quoteNewTotalCents;
+      if (pq != null && nq != null) {
+        return normalizeNearZeroOwed(roundMoney((nq - pq) / 100));
+      }
+      if (latestChangeQuote.serverDisplay != null) {
+        return normalizeNearZeroOwed(
+          roundMoney(latestChangeQuote.serverDisplay.total - originalReceipt.total),
+        );
+      }
+      return normalizeNearZeroOwed(latestChangeQuote.priceDiff);
+    }
+    return changeFlowBalanceVsOriginal({
+      newTotal: displayChangeFlowProposedTotal,
+      originalReceiptTotal: originalReceipt.total,
+      audience: 'admin',
+    });
+  })();
+  const changeFlowClientEstimateDue = normalizeNearZeroOwed(
+    roundMoney(changeFlowClientEstimateDueBase + editableSummaryPreSubtotalDelta),
+  );
+  const changeFlowAmountDue = normalizeNearZeroOwed(changeFlowClientEstimateDue);
+
+  return {
+    taxIncludedReconciledCheckoutPriceSummaryLines,
+    checkoutModalTicketLinesDisplay,
+    adminFeAuthoritativeReceipt,
+    providerApplyAuthoritativeReceipt,
+    changeFlowClientEstimateDue,
+    changeFlowAmountDue,
+  };
+}