@metron-labs/quote-react 0.1.42 → 0.1.44

package/dist/app/QuickQuote.js

@@ -17,7 +17,7 @@ const SAVED_QUOTE_KEY = "metron-quick-quote";
 export default function QuickQuote(props) {
     return (_jsx(CartProvider, { children: _jsx(QuickQuoteInner, { ...props }) }));
 }
-function QuickQuoteInner({ fullPage = false, hideHeader = false, internal = false, }) {
+function QuickQuoteInner({ fullPage = false, hideHeader = false, internal = false }) {
     const [stage, setStage] = useState("entry");
     const [entryMode, setEntryMode] = useState(null);
     const [error, setError] = useState("");
@@ -52,7 +52,27 @@ function QuickQuoteInner({ fullPage = false, hideHeader = false, internal = fals
         void fetch(apiUrl("/api/catalogue/resolve-conversions"), {
             method: "POST",
             headers: { "Content-Type": "application/json", ...clientHeaders() },
-            body: JSON.stringify({ lines: unresolved.map((item) => ({ line_id: item.lineId, product_id: item.productId, requested_description: item.requestedDescription ?? item.description, requested_qty: item.qty, requested_uom: item.unit || null, selected_description: item.description, selected_uoi: item.uoi, selected_uoi_count: item.uoiCount, linked_context: item.linkedContext ?? [], selected_conversion: { sales_uom_normalised: item.salesUomNormalised, conversion_type: item.conversionType, sales_unit_size: item.salesUnitSize, sales_unit_size_uom: item.salesUnitSizeUom, coverage_qty: item.coverageQty, coverage_uom: item.coverageUom } })) }),
+            body: JSON.stringify({
+                lines: unresolved.map((item) => ({
+                    line_id: item.lineId,
+                    product_id: item.productId,
+                    requested_description: item.requestedDescription ?? item.description,
+                    requested_qty: item.qty,
+                    requested_uom: item.unit || null,
+                    selected_description: item.description,
+                    selected_uoi: item.uoi,
+                    selected_uoi_count: item.uoiCount,
+                    linked_context: item.linkedContext ?? [],
+                    selected_conversion: {
+                        sales_uom_normalised: item.salesUomNormalised,
+                        conversion_type: item.conversionType,
+                        sales_unit_size: item.salesUnitSize,
+                        sales_unit_size_uom: item.salesUnitSizeUom,
+                        coverage_qty: item.coverageQty,
+                        coverage_uom: item.coverageUom,
+                    },
+                })),
+            }),
         })
             .then((response) => (response.ok ? readJson(response) : null))
             .then((payload) => {
@@ -146,8 +166,11 @@ function QuickQuoteInner({ fullPage = false, hideHeader = false, internal = fals
             const hash = window.location.hash;
             if (hash === "#quote-request")
                 setStage("basket");
-            else if (hash === "#matched-products" && scheduleResult)
+            else if (hash === "#matched-products" && scheduleResult) {
+                // Opening an entry tab after browser-back clears the mode; results only render in schedule mode.
+                setEntryMode("schedule");
                 setStage("results");
+            }
             else
                 setStage("entry");
             // Turbo's popstate listener (registered before ours, so it can't be pre-empted) stamps its
@@ -236,6 +259,10 @@ function QuickQuoteInner({ fullPage = false, hideHeader = false, internal = fals
             const lines = job.result.lineItems.length;
             const matched = job.result.results.filter((result) => result.candidates.length > 0).length;
             track("results_shown", { lines, matched, unmatched: lines - matched });
+            // A new schedule is a new quote. Browser-back to the entry screen only swaps the
+            // screen, so the previous quote's basket is still here - drop it.
+            clearCart();
+            setCartSeeded(false);
             setScheduleReviewGateComplete(false);
             setScheduleResult(job.result);
             writeQuoteHistory("results");
@@ -250,7 +277,7 @@ function QuickQuoteInner({ fullPage = false, hideHeader = false, internal = fals
             schedulePollCancelRef.current?.();
             schedulePollCancelRef.current = null;
         }
-    }, [writeQuoteHistory, track]);
+    }, [writeQuoteHistory, track, clearCart]);
     // Entry-page "paste your line items" shortcut: skip the upload step entirely,
     // wrap the pasted text as a .txt — verbatim, so the copy archived in blob storage reads
     // exactly as pasted — and feed it straight into the same match pipeline.
@@ -267,5 +294,10 @@ function QuickQuoteInner({ fullPage = false, hideHeader = false, internal = fals
         setEntryMode("schedule");
         await runScheduleMatch(file);
     }, [runScheduleMatch]);
-    return (_jsx(TrackContext.Provider, { value: track, children: _jsx("div", { ref: rootRef, className: `app-wrapper${fullPage ? "" : " app-wrapper--embedded"}${hideHeader ? " app-wrapper--no-header" : ""}${!fullPage && stage === "processing" ? " app-wrapper--loading" : ""}`, style: getQuoteConfig().theme, children: _jsxs("main", { className: "main-content", children: [error && (_jsxs("div", { className: "error-box", role: "alert", children: [_jsx("strong", { children: "Error:" }), " ", error] })), stage === "entry" && (_jsx(EntryStage, { onPasteSchedule: handlePasteSchedule, onUploadSchedule: handleUploadSchedule, onEntryModeChange: setEntryMode })), stage === "results" && entryMode === "schedule" && scheduleResult && (_jsx(ScheduleResultsStage, { scheduleResult: scheduleResult, onStartOver: resetToEntry, cart: cart, onAddToCart: addToCart, onRemoveFromCart: removeFromCart, onGoToBasket: goToBasket, cartSeeded: cartSeeded, onCartSeeded: () => setCartSeeded(true), reviewGateComplete: scheduleReviewGateComplete, onReviewGateComplete: () => setScheduleReviewGateComplete(true), internal: internal })), stage === "basket" && (_jsx(BasketStage, { cart: cart, onUpdateQty: updateCartQty, onUpdateSellUnits: updateCartSellUnits, onRemove: removeFromCart, onBack: backToResults, onStartNewQuote: resetToEntry, internal: internal }))] }) }) }));
+    return (_jsx(TrackContext.Provider, { value: track, children: _jsx("div", { ref: rootRef, className: `app-wrapper${fullPage ? "" : " app-wrapper--embedded"}${hideHeader ? " app-wrapper--no-header" : ""}${!fullPage && stage === "processing" ? " app-wrapper--loading" : ""}`, style: getQuoteConfig().theme, children: _jsxs("main", { className: "main-content", children: [error && (_jsxs("div", { className: "error-box", role: "alert", children: [_jsx("strong", { children: "Error:" }), " ", error] })), stage === "entry" && _jsx(EntryStage, { onPasteSchedule: handlePasteSchedule, onUploadSchedule: handleUploadSchedule, onEntryModeChange: setEntryMode }), stage === "results" && entryMode === "schedule" && scheduleResult && (_jsx(ScheduleResultsStage, { scheduleResult: scheduleResult, onStartOver: resetToEntry, cart: cart, onAddToCart: addToCart, onRemoveFromCart: removeFromCart, onGoToBasket: goToBasket, cartSeeded: cartSeeded, onCartSeeded: () => setCartSeeded(true), reviewGateComplete: scheduleReviewGateComplete, onReviewGateComplete: () => setScheduleReviewGateComplete(true), internal: internal })), stage === "basket" && (_jsx(BasketStage, { cart: cart, onUpdateQty: updateCartQty, onUpdateSellUnits: updateCartSellUnits, onRemove: removeFromCart, onBack: backToResults, onStartNewQuote: resetToEntry, onQuoteRequested: () => {
+                            setScheduleResult(null);
+                            setScheduleReviewGateComplete(false);
+                            setCartSeeded(false);
+                            clearCart();
+                        }, internal: internal }))] }) }) }));
 }

package/dist/app/stages/BasketStage.d.ts

@@ -8,7 +8,9 @@ interface BasketStageProps {
     onBack: () => void;
     /** Clears the basket and returns to the start, from the quote-request confirmation page. */
     onStartNewQuote: () => void;
+    /** Called once the quote request is sent; the confirmation stays up whatever it clears. */
+    onQuoteRequested?: () => void;
     internal?: boolean;
 }
-export default function BasketStage({ cart, onUpdateQty, onUpdateSellUnits, onResolveConversions, onRemove, onBack, onStartNewQuote, internal }: BasketStageProps): import("react").JSX.Element;
+export default function BasketStage({ cart, onUpdateQty, onUpdateSellUnits, onResolveConversions, onRemove, onBack, onStartNewQuote, onQuoteRequested, internal }: BasketStageProps): import("react").JSX.Element;
 export {};

package/dist/app/stages/BasketStage.js

@@ -9,6 +9,7 @@ import { getCartSubtotal, getPricingBreakdown } from "../../util/pricing";
 import { exportBasketExcel } from "../../util/exportScheduleExcel";
 import { renderDisplayUnit, unitDisplayText } from "../components/UnitDisplay";
 import { clientHeaders, getBoqClientId, readJson } from "../../lib/api/boqClient";
+import { MAX_ORDER_QTY } from "../../lib/boq/inputLimits";
 // ponytail: flat UK VAT rate, matching fmtCurrency's GBP-only assumption elsewhere in this app.
 const VAT_RATE = 0.2;
 const PAGE_SIZE = 10;
@@ -36,7 +37,7 @@ function TrashIcon() {
 function ChevronIcon() {
     return (_jsx("svg", { width: "8", height: "5", viewBox: "0 0 8 5", fill: "none", children: _jsx("path", { d: "M1 4L4 1L7 4", stroke: "currentColor", strokeWidth: "1.4", strokeLinecap: "round", strokeLinejoin: "round" }) }));
 }
-export default function BasketStage({ cart, onUpdateQty, onUpdateSellUnits, onResolveConversions, onRemove, onBack, onStartNewQuote, internal = false }) {
+export default function BasketStage({ cart, onUpdateQty, onUpdateSellUnits, onResolveConversions, onRemove, onBack, onStartNewQuote, onQuoteRequested, internal = false }) {
     // Both widgets can render a basket on the same page, so element ids are made unique.
     const uid = useId();
     const qzaBasketLayout = !internal && getBoqClientId() === "QZA6-MRA4";
@@ -128,11 +129,11 @@ export default function BasketStage({ cart, onUpdateQty, onUpdateSellUnits, onRe
     function commitRequestedQty(lineId, raw) {
         const n = parseFloat(raw);
         if (!isNaN(n) && n >= 0)
-            onUpdateQty(lineId, n);
+            onUpdateQty(lineId, Math.min(n, MAX_ORDER_QTY));
         clearQtyDraft(lineId);
     }
     function stepRequestedQty(lineId, current, delta) {
-        onUpdateQty(lineId, Math.max(0, current + delta));
+        onUpdateQty(lineId, Math.min(MAX_ORDER_QTY, Math.max(0, current + delta)));
         clearQtyDraft(lineId);
     }
     function clearSellUnitsDraft(lineId) {
@@ -145,11 +146,11 @@ export default function BasketStage({ cart, onUpdateQty, onUpdateSellUnits, onRe
     function commitSellUnits(lineId, raw) {
         const n = parseFloat(raw);
         if (!isNaN(n) && n >= 0)
-            onUpdateSellUnits(lineId, n);
+            onUpdateSellUnits(lineId, Math.min(n, MAX_ORDER_QTY));
         clearSellUnitsDraft(lineId);
     }
     function stepSellUnits(lineId, current, delta) {
-        onUpdateSellUnits(lineId, Math.max(0, current + delta));
+        onUpdateSellUnits(lineId, Math.min(MAX_ORDER_QTY, Math.max(0, current + delta)));
         clearSellUnitsDraft(lineId);
     }
     // Sends the basket to the merchant as a quote request (POST /v1/quote-requests). Success only
@@ -195,6 +196,7 @@ export default function BasketStage({ cart, onUpdateQty, onUpdateSellUnits, onRe
             }
             track("quote_requested", { items: pricedItems.length, total: Math.round(total * 100) / 100 });
             setQuoteRequestSent(true);
+            onQuoteRequested?.();
             window.scrollTo(0, 0);
         }
         catch {
@@ -228,11 +230,15 @@ export default function BasketStage({ cart, onUpdateQty, onUpdateSellUnits, onRe
     if (quoteRequestSent) {
         return (_jsx("div", { className: "wizard-step entry-stage", children: _jsxs("div", { className: "quote-request-sent", role: "status", children: [_jsx("div", { className: "quote-request-sent-icon", "aria-hidden": "true", children: _jsx("svg", { width: "40", height: "40", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("polyline", { points: "5 12.5 10 17.5 19 7" }) }) }), _jsx("h1", { children: "Quote requested" }), _jsxs("p", { children: ["You're all done. We'll email your sharper price to ", _jsx("strong", { children: reference.trim() }), ", usually within one working day."] }), _jsx("button", { type: "button", className: "cta-btn", onClick: onStartNewQuote, children: _jsx("span", { children: "Start a new quote" }) }), _jsx("p", { className: "quote-request-sent-note", children: "Nothing is charged until you approve the quote." })] }) }));
     }
+    // A customer's empty basket gets the same full-page treatment as the confirmation above.
+    if (!internal && items.length === 0) {
+        return (_jsx("div", { className: "wizard-step entry-stage", children: _jsxs("div", { className: "quote-request-sent", children: [_jsx("div", { className: "quote-request-sent-icon", "aria-hidden": "true", children: _jsxs("svg", { width: "40", height: "40", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { d: "M3 9h18l-2 11H5z" }), _jsx("path", { d: "M8 9l4-6 4 6" })] }) }), _jsx("h1", { children: qzaBasketLayout ? "Your quote request is empty" : "Your basket is empty" }), _jsx("p", { children: qzaBasketLayout ? "Start again with your list to build your quote." : "Start again with your list to fill your basket." }), _jsx("button", { type: "button", className: "cta-btn", onClick: onStartNewQuote, children: _jsx("span", { children: "Back to start" }) })] }) }));
+    }
     return (_jsx("div", { className: `wizard-step entry-stage${qzaBasketLayout ? " basket-layout--qza6-mra4" : ""}`, children: _jsxs("div", { className: `quick-order-card${internal ? "" : " quick-order-card--customer"}`, children: [_jsxs("div", { className: `quick-order-hero${internal ? "" : " quick-order-hero--customer"}`, children: [internal && _jsx("div", { className: "quick-order-eyebrow", children: "Construction Services" }), _jsxs("div", { className: "basket-hero-copy", children: [qzaBasketLayout && (_jsxs("button", { type: "button", className: "cta-btn cta-btn-secondary basket-hero-back", onClick: onBack, children: [_jsx(BackArrow, {}), _jsx("span", { children: "Back to results" })] })), _jsxs("div", { className: "quick-order-hero-title-row", children: [_jsx("h1", { children: internal ? "Your Selection" : qzaBasketLayout ? "Request a quote" : "Your Basket" }), internal && (_jsxs("span", { className: "summary-chip summary-chip--scope", children: [_jsx("strong", { children: items.length }), " ", items.length === 1 ? "item" : "items"] }))] }), _jsx("p", { children: internal
                                         ? "Review the items you've added before exporting them for review."
                                         : qzaBasketLayout
                                             ? "Check your items & quantities below, and we'll do our best to beat list prices."
-                                            : "Review your quantities and order summary before you buy." })] })] }), _jsx("div", { className: "quick-order-panel", style: { paddingTop: 16 }, children: items.length === 0 ? (_jsxs("div", { className: "quick-order-history-empty", children: [_jsx("div", { className: "basket-empty-icon", "aria-hidden": "true", children: internal ? "📋" : "🧺" }), _jsx("p", { children: internal ? "Your selection is empty." : qzaBasketLayout ? "Your quote request is empty." : "Your basket is empty." }), _jsx("p", { className: "basket-empty-hint", children: qzaBasketLayout ? "Go back to your results and add items for your quote." : "Go back to your results and add quoted items." }), _jsx("div", { className: "btn-row", style: { marginTop: 20, justifyContent: "center" }, children: _jsx("button", { className: "cta-btn", style: { width: "auto", maxWidth: 280 }, onClick: onBack, "aria-label": "Back to results", children: _jsx("span", { children: "Back to Results" }) }) })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: "basket-layout", children: [_jsxs("div", { className: "basket-main", children: [_jsx("div", { className: "basket-list", "aria-label": internal ? "Selection items" : qzaBasketLayout ? "Quote request items" : "Basket items", children: pagedItems.map(({ item, pricing }) => {
+                                            : "Review your quantities and order summary before you buy." })] })] }), _jsx("div", { className: "quick-order-panel", style: { paddingTop: 16 }, children: items.length === 0 ? (_jsxs("div", { className: "quick-order-history-empty", children: [_jsx("div", { className: "basket-empty-icon", "aria-hidden": "true", children: "\uD83D\uDCCB" }), _jsx("p", { children: "Your selection is empty." }), _jsx("p", { className: "basket-empty-hint", children: "Go back to your results and add quoted items." }), _jsx("div", { className: "btn-row", style: { marginTop: 20, justifyContent: "center" }, children: _jsx("button", { className: "cta-btn", style: { width: "auto", maxWidth: 280 }, onClick: onBack, "aria-label": "Back to results", children: _jsx("span", { children: "Back to Results" }) }) })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: "basket-layout", children: [_jsxs("div", { className: "basket-main", children: [_jsx("div", { className: "basket-list", "aria-label": internal ? "Selection items" : qzaBasketLayout ? "Quote request items" : "Basket items", children: pagedItems.map(({ item, pricing }) => {
                                                     const requestedQtyValue = qtyDrafts[item.lineId] ?? String(pricing.requestedAmount);
                                                     const requestedLocked = pricing.requestedUnit === pricing.sellUnit || pricing.costingMode === "review";
                                                     const rawDiffersFromOrder = pricing.requiredSellUnits == null || pricing.requestedAmount !== pricing.requiredSellUnits || pricing.requestedUnit !== pricing.sellUnit;
@@ -252,7 +258,7 @@ export default function BasketStage({ cart, onUpdateQty, onUpdateSellUnits, onRe
                                                                                                     if (e.key === "Enter")
                                                                                                         e.target.blur();
                                                                                                 }, "aria-label": `${item.description} order quantity` }), _jsxs("div", { className: "basket-qty-arrows", children: [_jsx("button", { type: "button", className: "basket-qty-arrow", onClick: () => stepSellUnits(item.lineId, parseFloat(sellUnitsDrafts[item.lineId] ?? String(pricing.requiredSellUnits ?? "0")) || 0, 1), "aria-label": `Increase ${item.description} order quantity`, children: _jsx(ChevronIcon, {}) }), _jsx("button", { type: "button", className: "basket-qty-arrow basket-qty-arrow--down", onClick: () => stepSellUnits(item.lineId, parseFloat(sellUnitsDrafts[item.lineId] ?? String(pricing.requiredSellUnits ?? "0")) || 0, -1), "aria-label": `Decrease ${item.description} order quantity`, children: _jsx(ChevronIcon, {}) })] })] }), _jsx("span", { className: "basket-metric-unit", children: renderDisplayUnit(pricing.sellUnit, parseFloat(sellUnitsDrafts[item.lineId] ?? String(pricing.requiredSellUnits ?? "0")) || 0) })] })] }), _jsxs("div", { className: "basket-stat basket-stat--total", children: [_jsx("span", { className: "basket-stat-label", children: "Total" }), _jsxs("div", { className: "basket-stat-value", children: [_jsx("strong", { children: pricing.lineTotal != null ? fmtCurrency(pricing.lineTotal) : "-" }), pricing.lineTotal != null && _jsx("span", { className: "basket-metric-unit", children: "ex. VAT" })] })] })] })] }, item.lineId));
-                                                }) }), totalPages > 1 && (_jsxs("div", { className: "results-pagination", children: [_jsxs("span", { className: "results-pagination-count", children: ["Showing ", (currentPage - 1) * PAGE_SIZE + 1, "\u2013", Math.min(currentPage * PAGE_SIZE, pricedItems.length), " of ", pricedItems.length] }), _jsxs("div", { className: "results-pagination-controls", children: [_jsx("button", { type: "button", className: "bom-toolbar-btn", onClick: () => setPage(currentPage - 1), disabled: currentPage === 1, children: "Previous" }), _jsxs("span", { className: "results-pagination-page", children: ["Page ", currentPage, " of ", totalPages] }), _jsx("button", { type: "button", className: "bom-toolbar-btn", onClick: () => setPage(currentPage + 1), disabled: currentPage === totalPages, children: "Next" })] })] }))] }), _jsxs("aside", { className: "basket-sidebar", children: [_jsx("div", { className: "basket-sidebar-title", children: qzaBasketLayout ? "Quote request summary" : "Order summary" }), _jsxs("div", { className: "basket-sidebar-row", children: [_jsx("span", { children: qzaBasketLayout ? "List price (ex. VAT)" : "Subtotal (ex. VAT)" }), _jsx("span", { children: fmtCurrency(subtotal) })] }), _jsxs("div", { className: "basket-sidebar-row", children: [_jsx("span", { children: qzaBasketLayout ? "VAT (20%)" : "VAT (20%)" }), _jsx("span", { children: fmtCurrency(vat) })] }), _jsxs("div", { className: "basket-sidebar-row basket-sidebar-row--total", children: [_jsx("span", { children: qzaBasketLayout ? "List price (inc. VAT)" : "Total" }), _jsx("span", { children: fmtCurrency(total) })] }), !qzaBasketLayout && (_jsx("div", { className: "basket-summary-waste", children: _jsxs("div", { className: "basket-waste-control", children: [_jsxs("label", { className: "basket-global-waste", children: [_jsx("input", { type: "checkbox", checked: wasteEnabled, onChange: (e) => setWasteEnabled(e.target.checked) }), _jsx("span", { children: "Add waste factor" })] }), _jsxs("label", { className: "basket-global-waste-percent", children: [_jsx("input", { type: "number", inputMode: "decimal", min: "0", step: "0.1", value: wastePercent, onChange: (e) => setWastePercent(e.target.value), disabled: !wasteEnabled, "aria-label": "Waste factor percent" }), _jsx("span", { children: "%" })] })] }) })), _jsx("label", { htmlFor: `${uid}-basket-reference`, className: "basket-sidebar-label", children: qzaBasketLayout ? "Enter email for your sharper quote" : "Your reference (optional)" }), _jsx("input", { id: `${uid}-basket-reference`, type: qzaBasketLayout ? "email" : "text", className: "basket-sidebar-input", value: reference, onChange: (e) => {
+                                                }) }), totalPages > 1 && (_jsxs("div", { className: "results-pagination", children: [_jsxs("span", { className: "results-pagination-count", children: ["Showing ", (currentPage - 1) * PAGE_SIZE + 1, "\u2013", Math.min(currentPage * PAGE_SIZE, pricedItems.length), " of ", pricedItems.length] }), _jsxs("div", { className: "results-pagination-controls", children: [_jsx("button", { type: "button", className: "bom-toolbar-btn", onClick: () => setPage(currentPage - 1), disabled: currentPage === 1, children: "Previous" }), _jsxs("span", { className: "results-pagination-page", children: ["Page ", currentPage, " of ", totalPages] }), _jsx("button", { type: "button", className: "bom-toolbar-btn", onClick: () => setPage(currentPage + 1), disabled: currentPage === totalPages, children: "Next" })] })] }))] }), _jsxs("aside", { className: "basket-sidebar", children: [_jsx("div", { className: "basket-sidebar-title", children: qzaBasketLayout ? "Quote request summary" : "Order summary" }), _jsxs("div", { className: "basket-sidebar-row", children: [_jsx("span", { children: qzaBasketLayout ? "List price (ex. VAT)" : "Subtotal (ex. VAT)" }), _jsx("span", { children: fmtCurrency(subtotal) })] }), _jsxs("div", { className: "basket-sidebar-row", children: [_jsx("span", { children: qzaBasketLayout ? "VAT (20%)" : "VAT (20%)" }), _jsx("span", { children: fmtCurrency(vat) })] }), _jsxs("div", { className: "basket-sidebar-row basket-sidebar-row--total", children: [_jsx("span", { children: qzaBasketLayout ? "List price (inc. VAT)" : "Total" }), _jsx("span", { children: fmtCurrency(total) })] }), !qzaBasketLayout && (_jsx("div", { className: "basket-summary-waste", children: _jsxs("div", { className: "basket-waste-control", children: [_jsxs("label", { className: "basket-global-waste", children: [_jsx("input", { type: "checkbox", checked: wasteEnabled, onChange: (e) => setWasteEnabled(e.target.checked) }), _jsx("span", { children: "Add waste factor" })] }), _jsxs("label", { className: "basket-global-waste-percent", children: [_jsx("input", { type: "number", inputMode: "decimal", min: "0", step: "0.1", value: wastePercent, onChange: (e) => setWastePercent(e.target.value), disabled: !wasteEnabled, "aria-label": "Waste factor percent" }), _jsx("span", { children: "%" })] })] }) })), _jsx("label", { htmlFor: `${uid}-basket-reference`, className: "basket-sidebar-label", children: qzaBasketLayout ? "Enter email for your sharper quote" : "Your reference (optional)" }), _jsx("input", { id: `${uid}-basket-reference`, type: qzaBasketLayout ? "email" : "text", className: "basket-sidebar-input", value: reference, onChange: (e) => {
                                                     setReference(e.target.value);
                                                     if (qzaBasketLayout)
                                                         setQuoteContactError("");

package/dist/app/stages/EntryStage.js

@@ -8,6 +8,7 @@ import CloseIcon from "../../components/CloseIcon";
 import { clientHeaders, readJson } from "../../lib/api/boqClient";
 import { FILE_EXTENSIONS, isPhotoFile, shrinkPhoto, validateLines, validateUploadFile } from "../../lib/boq/inputLimits";
 import { ProcessingContent } from "./ProcessingStage";
+import { useEscapeKey } from "../../lib/useEscapeKey";
 const UPLOAD_ACCEPT = [...FILE_EXTENSIONS.schedule, ...FILE_EXTENSIONS.photo].join(",");
 const STEPS = {
     paste: [
@@ -53,6 +54,8 @@ export default function EntryStage({ onPasteSchedule, onUploadSchedule, onEntryM
         setActiveTab(null);
         onEntryModeChange(null);
     };
+    // Like the close button, but not mid-match, where the modal is showing progress.
+    useEscapeKey(Boolean(activeTab) && !matching, closeWorkflow);
     const applyUploadFile = (files) => {
         if (!files?.length)
             return;

package/dist/app/stages/ScheduleResultsStage.js

@@ -12,6 +12,7 @@ import { productImageSrc } from "../../lib/productImage";
 import { candidateToCartItem } from "../../lib/boq/toCartItem";
 import { apiHeaders, getBoqClientId, readJson } from "../../lib/api/boqClient";
 import { exportScheduleExcel } from "../../util/exportScheduleExcel";
+import { useEscapeKey } from "../../lib/useEscapeKey";
 import { getCartSubtotal, getPricingBreakdown } from "../../util/pricing";
 const NO_SELECTION = "__none__";
 const PAGE_SIZE = 24;
@@ -486,6 +487,10 @@ export default function ScheduleResultsStage({ scheduleResult, onStartOver, cart
         setSelectedReviewId(null);
         setReviewFlowActive(false);
     };
+    // Escape does what each dialog's own close or cancel does. The review gate has neither - it's
+    // a required step - so Escape leaves it open.
+    useEscapeKey(confirmStartOver, () => setConfirmStartOver(false));
+    useEscapeKey(Boolean(activeReviewRow) && !confirmStartOver, () => closeReview());
     const completeReviewAndReturnToGate = (lineId) => {
         setReviewedReviewIds((ids) => new Set(ids).add(lineId));
         if (pendingReviewRows.some((row) => row.item.line_id !== lineId)) {