@classytic/pos-ui 0.2.0 → 1.2.0

package/dist/screens/ReceiptScreen.js

@@ -1,19 +1,24 @@
 "use client";
 
 import { usePosBranch } from "../runtime/branch-port.js";
-import { RECEIPT_DOM_ID } from "../hardware/web-adapter.js";
+import { formatMinor } from "../lib/money.js";
+import { RECEIPT_DOM_ID, printViaBrowserWindow } from "../hardware/web-adapter.js";
 import { useHardware } from "../hardware/context.js";
 import { usePrinterAvailability } from "../hardware/use-printer-availability.js";
 import { usePosContext } from "../state/pos-context.js";
-import { formatPaisa } from "../lib/money.js";
+import { buildReceiptPayload } from "../utils/pos-helpers.js";
 import { useCallback, useMemo } from "react";
 import { useKeyboardShortcut } from "@classytic/fluid/client/hooks";
 import { PrintableView, ResponsiveSplitLayout } from "@classytic/fluid/client/core";
+import { DEFAULT_POS_RECEIPT_CONFIG } from "@classytic/commerce-sdk/sales";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { CheckCircle2, Plus, Printer, ReceiptText } from "lucide-react";
 import { Button } from "@/components/ui/button";
+import { useEffectiveConfig, usePlatformIdentity } from "@classytic/commerce-sdk/platform";
 import { getReceiptLocale, paymentMethodLabel } from "@classytic/commerce-sdk/client";
-import { DocumentFooter, DocumentHeader, DocumentLineTable, DocumentPage, DocumentParty, DocumentSummary } from "@classytic/fluid/document";
+import { toast } from "sonner";
+import { DocumentFooter, DocumentHeader, DocumentLineTable, DocumentPage, DocumentParty, DocumentQR, DocumentSummary } from "@classytic/fluid/document";
+import { renderSVG } from "uqr";
 
 //#region src/screens/ReceiptScreen.tsx
 /**
@@ -38,51 +43,18 @@ import { DocumentFooter, DocumentHeader, DocumentLineTable, DocumentPage, Docume
 function isShownPhone(phone) {
 	return Boolean(phone && !phone.startsWith("pending_"));
 }
-function buildReceiptPayload(receipt, branchName, branchPhone) {
-	const items = receipt.items ?? [];
-	const customerName = receipt.customer?.name?.trim() ?? "";
-	const showCustomer = customerName.length > 0 && customerName !== "Walk-in Customer";
-	const customerPhoneRaw = receipt.customer?.phone ?? null;
-	return {
-		branch: {
-			name: branchName,
-			phone: branchPhone
-		},
-		shift: {
-			id: "",
-			cashierId: "",
-			cashierName: receipt.cashier ?? ""
-		},
-		order: {
-			number: String(receipt.orderNumber ?? ""),
-			placedAt: receipt.date ? new Date(receipt.date) : /* @__PURE__ */ new Date(),
-			lines: items.map((item) => ({
-				name: item.name,
-				variant: item.variant,
-				qty: item.quantity,
-				unitPrice: item.unitPrice ?? 0,
-				total: item.total,
-				taxRate: item.vatRate,
-				taxAmount: item.vatAmount
-			})),
-			subtotal: receipt.subtotal ?? 0,
-			tax: receipt.vat?.amount ?? 0,
-			discount: receipt.discount,
-			deliveryFee: receipt.deliveryCharge,
-			grandTotal: receipt.total ?? 0,
-			currency: getReceiptLocale().currency
-		},
-		payments: receipt.payment ? [{
-			method: receipt.payment.method,
-			amount: receipt.payment.amount ?? receipt.total ?? 0,
-			reference: receipt.payment.reference
-		}] : [],
-		customer: showCustomer ? {
-			name: customerName,
-			phone: isShownPhone(customerPhoneRaw) ? customerPhoneRaw : void 0,
-			loyaltyId: receipt.membership?.cardId
-		} : void 0
-	};
+/** Flatten a branch address to a single presentational line for the letterhead. */
+function formatAddressLine(a) {
+	if (!a) return void 0;
+	const parts = [
+		a.line1,
+		a.line2,
+		a.city,
+		a.state,
+		a.postalCode,
+		a.country
+	].filter(Boolean);
+	return parts.length ? parts.join(", ") : void 0;
 }
 function buildDocumentLines(receipt) {
 	return (receipt.items ?? []).map((item, idx) => {
@@ -100,10 +72,10 @@ function buildDocumentLines(receipt) {
 			taxAmount: item.vatAmount ?? 0,
 			lineTotal: item.total,
 			formatted: {
-				unitPrice: formatPaisa(item.unitPrice ?? 0),
-				subtotal: formatPaisa(subtotal),
-				taxAmount: formatPaisa(item.vatAmount ?? 0),
-				lineTotal: formatPaisa(item.total)
+				unitPrice: formatMinor(item.unitPrice ?? 0),
+				subtotal: formatMinor(subtotal),
+				taxAmount: formatMinor(item.vatAmount ?? 0),
+				lineTotal: formatMinor(item.total)
 			}
 		};
 	});
@@ -114,19 +86,47 @@ function ReceiptScreen() {
 	const hardware = useHardware();
 	const { available: printerAvailable, checking: printerChecking } = usePrinterAvailability();
 	const receipt = state.lastReceipt;
-	const branchName = selectedBranch?.name || receipt?.branch?.name || "Store";
+	const { identity } = usePlatformIdentity();
+	const { effective: receiptCfgEff } = useEffectiveConfig("pos.receipt", { branchId: selectedBranch?.id });
+	const rcfg = receiptCfgEff?.value ?? DEFAULT_POS_RECEIPT_CONFIG;
 	const branchPhone = selectedBranch?.phone || receipt?.branch?.phone;
+	const companyLogo = identity?.company.logoUrl;
+	const companyName = identity?.branch?.name || selectedBranch?.name || receipt?.branch?.name || identity?.company.name || "Store";
+	const companyAddress = formatAddressLine(identity?.branch?.address);
+	const companyContact = identity?.branch?.phone || branchPhone || identity?.company.supportPhone;
 	const lines = useMemo(() => receipt ? buildDocumentLines(receipt) : [], [receipt]);
+	const orderRef = receipt?.orderNumber != null ? String(receipt.orderNumber) : "";
+	const qrSvg = useMemo(() => {
+		if (!rcfg.showQr || !orderRef) return null;
+		const value = rcfg.qrUrlTemplate ? rcfg.qrUrlTemplate.replace("{orderNumber}", orderRef) : orderRef;
+		try {
+			return renderSVG(value);
+		} catch {
+			return null;
+		}
+	}, [
+		rcfg.showQr,
+		rcfg.qrUrlTemplate,
+		orderRef
+	]);
 	const handlePrint = useCallback(() => {
 		if (!receipt) return;
-		hardware.printer.print(buildReceiptPayload(receipt, branchName, branchPhone)).catch((err) => {
+		hardware.printer.print(buildReceiptPayload(receipt, companyName, companyContact)).then((outcome) => {
+			if (outcome === "confirmed") return;
+			toast.error(outcome === "unknown" ? "Printer status unknown — it may have already printed." : "Couldn't reach the printer.", { action: {
+				label: "Print via browser",
+				onClick: () => {
+					printViaBrowserWindow();
+				}
+			} });
+		}).catch((err) => {
 			console.warn("[pos] print failed", err);
 		});
 	}, [
 		hardware.printer,
 		receipt,
-		branchName,
-		branchPhone
+		companyName,
+		companyContact
 	]);
 	const handleNewSale = useCallback(() => {
 		dispatch({ type: "NEW_SALE" });
@@ -149,7 +149,7 @@ function ReceiptScreen() {
 			}), /* @__PURE__ */ jsxs(Button, {
 				className: "mt-4",
 				onClick: handleNewSale,
-				children: [/* @__PURE__ */ jsx(Plus, { className: "h-4 w-4 mr-2" }), "New Sale"]
+				children: [/* @__PURE__ */ jsx(Plus, { className: "h-4 w-4 me-2" }), "New Sale"]
 			})]
 		})
 	});
@@ -159,7 +159,7 @@ function ReceiptScreen() {
 	const locale = getReceiptLocale();
 	const summaryExtra = receipt.payment ? [{
 		label: `Paid (${paymentMethodLabel(receipt.payment.method)})`,
-		value: formatPaisa(receipt.payment.amount ?? receipt.total ?? 0),
+		value: formatMinor(receipt.payment.amount ?? receipt.total ?? 0),
 		muted: true,
 		separator: true
 	}] : [];
@@ -197,7 +197,7 @@ function ReceiptScreen() {
 							}),
 							/* @__PURE__ */ jsx("p", {
 								className: "text-3xl font-bold tabular-nums mt-2",
-								children: formatPaisa(receipt.total || 0)
+								children: formatMinor(receipt.total || 0)
 							})
 						]
 					}),
@@ -209,13 +209,13 @@ function ReceiptScreen() {
 							onClick: handlePrint,
 							disabled: !printerAvailable && !printerChecking,
 							title: printerChecking ? "Checking printer..." : printerAvailable ? "Print receipt (Ctrl+P)" : "No printer reachable — set POS_PRINTER_HOST or check network",
-							children: [/* @__PURE__ */ jsx(Printer, { className: "h-5 w-5 mr-2" }), "Print Receipt"]
+							children: [/* @__PURE__ */ jsx(Printer, { className: "h-5 w-5 me-2" }), "Print Receipt"]
 						}), /* @__PURE__ */ jsxs(Button, {
 							size: "lg",
 							variant: "outline",
 							className: "h-14 text-lg",
 							onClick: handleNewSale,
-							children: [/* @__PURE__ */ jsx(Plus, { className: "h-5 w-5 mr-2" }), "New Sale (F2)"]
+							children: [/* @__PURE__ */ jsx(Plus, { className: "h-5 w-5 me-2" }), "New Sale (F2)"]
 						})]
 					}),
 					/* @__PURE__ */ jsx("p", {
@@ -237,13 +237,23 @@ function ReceiptScreen() {
 						size: "receipt",
 						children: [
 							/* @__PURE__ */ jsx(DocumentHeader, {
-								companyName: branchName,
-								companyContact: branchPhone,
-								...receipt.vat?.sellerBin ? { companyTaxId: `${locale.taxIdLabel}: ${receipt.vat.sellerBin}` } : {},
+								...companyLogo && rcfg.showLogo ? { logo: companyLogo } : {},
+								companyName,
+								...companyAddress ? { companyAddress } : {},
+								...companyContact ? { companyContact } : {},
+								...receipt.vat?.sellerBin ? { companyTaxId: `${locale.taxIdLabel}: ${receipt.vat.sellerBin}` } : identity?.company.taxId ? { companyTaxId: `${locale.taxIdLabel}: ${identity.company.taxId}` } : {},
 								documentTitle: "Receipt",
 								documentNumber: receipt.orderNumber,
 								date: receipt.date ?? ""
 							}),
+							rcfg.headerMessage && /* @__PURE__ */ jsx("p", {
+								className: "whitespace-pre-line text-center text-xs text-muted-foreground",
+								children: rcfg.headerMessage
+							}),
+							rcfg.showCashier && receipt.cashier && /* @__PURE__ */ jsxs("p", {
+								className: "text-xs text-muted-foreground",
+								children: ["Served by: ", receipt.cashier]
+							}),
 							showCustomer && /* @__PURE__ */ jsx(DocumentParty, {
 								billTo: {
 									name: customerName,
@@ -254,7 +264,7 @@ function ReceiptScreen() {
 							}),
 							/* @__PURE__ */ jsx(DocumentLineTable, {
 								lines,
-								columns: [
+								columns: rcfg.basicReceipt ? ["description", "quantity"] : [
 									"description",
 									"quantity",
 									"lineTotal"
@@ -262,19 +272,33 @@ function ReceiptScreen() {
 								showSequence: false,
 								compact: true
 							}),
-							/* @__PURE__ */ jsx(DocumentSummary, {
-								subtotal: formatPaisa(receipt.subtotal ?? 0),
-								...receipt.discount && receipt.discount > 0 ? { discount: formatPaisa(receipt.discount) } : {},
-								...receipt.vat?.amount && receipt.vat.amount > 0 ? { tax: formatPaisa(receipt.vat.amount) } : {},
-								total: formatPaisa(receipt.total ?? 0),
+							!rcfg.basicReceipt && /* @__PURE__ */ jsx(DocumentSummary, {
+								subtotal: formatMinor(receipt.subtotal ?? 0),
+								...receipt.discount && receipt.discount > 0 ? { discount: formatMinor(receipt.discount) } : {},
+								...receipt.vat?.amount && receipt.vat.amount > 0 ? { tax: formatMinor(receipt.vat.amount) } : {},
+								total: formatMinor(receipt.total ?? 0),
 								extraRows: summaryExtra,
 								currency: locale.currency,
 								labels: { tax: locale.taxLabel },
 								width: "w-full"
 							}),
-							/* @__PURE__ */ jsx(DocumentFooter, { notes: /* @__PURE__ */ jsx("p", {
+							qrSvg && /* @__PURE__ */ jsx("div", {
+								className: "mt-3 flex justify-center",
+								children: /* @__PURE__ */ jsx(DocumentQR, {
+									size: "w-28",
+									label: rcfg.qrUrlTemplate ? "Scan for your invoice" : `Order ${orderRef}`,
+									children: /* @__PURE__ */ jsx("span", {
+										className: "block w-full [&>svg]:h-full [&>svg]:w-full",
+										dangerouslySetInnerHTML: { __html: qrSvg }
+									})
+								})
+							}),
+							/* @__PURE__ */ jsx(DocumentFooter, { notes: /* @__PURE__ */ jsxs("div", {
 								className: "text-center",
-								children: locale.thankYouText
+								children: [/* @__PURE__ */ jsx("p", { children: locale.thankYouText }), rcfg.footerMessage && /* @__PURE__ */ jsx("p", {
+									className: "mt-1 whitespace-pre-line text-muted-foreground",
+									children: rcfg.footerMessage
+								})]
 							}) })
 						]
 					})

package/dist/screens/ShiftCloseScreen.d.ts

@@ -0,0 +1,4 @@
+//#region src/screens/ShiftCloseScreen.d.ts
+declare function ShiftCloseScreen(): import("react").JSX.Element;
+//#endregion
+export { ShiftCloseScreen };

package/dist/screens/ShiftCloseScreen.js

@@ -1,8 +1,8 @@
 "use client";
 
 import { usePosAuth } from "../runtime/auth-port.js";
+import { formatMinor, majorToMinor } from "../lib/money.js";
 import { usePosContext } from "../state/pos-context.js";
-import { formatPaisa } from "../lib/money.js";
 import { useManagerAuth } from "../hooks/useManagerAuth.js";
 import { ManagerAuthDialog } from "../dashboard/components/ManagerAuthDialog.js";
 import { useCallback, useMemo, useState } from "react";
@@ -10,6 +10,7 @@ import { useBlindCloseShift, useCloseShift, usePosCurrentShift } from "@classyti
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { AlertCircle, AlertTriangle, ArrowLeft, CheckCircle2, ClipboardList, ShieldCheck } from "lucide-react";
 import { Button } from "@/components/ui/button";
+import { presentError } from "@classytic/fluid/error-contract";
 import { Input } from "@/components/ui/input";
 import { Label } from "@/components/ui/label";
 import { Numpad } from "@classytic/fluid/numpad";
@@ -62,7 +63,7 @@ function ShiftCloseScreen() {
 	const expectedCash = shift?.expectedCash ?? liveExpectedCash;
 	const salesCount = shift?.salesCount ?? 0;
 	const salesTotal = shift?.salesTotal ?? 0;
-	const actualCash = Math.round((parseFloat(closingCash) || 0) * 100);
+	const actualCash = majorToMinor(parseFloat(closingCash) || 0);
 	const difference = closingCash ? actualCash - expectedCash : 0;
 	const varianceAbs = Math.abs(difference);
 	const policy = shift?.policySnapshot;
@@ -124,9 +125,9 @@ function ShiftCloseScreen() {
 			});
 			dispatch({ type: "CONFIRM_CLOSE" });
 		} catch (err) {
-			const msg = err.message || "Failed to close register";
-			setSubmitError(msg);
-			if (msg.toLowerCase().includes("variance")) setAuthDialogOpen(true);
+			const { message } = presentError(err, "The register was not closed. Try again.");
+			setSubmitError(message);
+			if ((err instanceof Error ? err.message : "").toLowerCase().includes("variance")) setAuthDialogOpen(true);
 		}
 	}, [
 		shift,
@@ -157,6 +158,8 @@ function ShiftCloseScreen() {
 		supervisorReady,
 		handleSubmit
 	]);
+	const closeMutationErr = closeErr ?? blindErr;
+	const closeFailure = closeMutationErr ? presentError(closeMutationErr, "The register was not closed. Try again.") : null;
 	return /* @__PURE__ */ jsxs("div", {
 		className: "flex items-center justify-center h-full bg-muted/30",
 		children: [/* @__PURE__ */ jsxs("div", {
@@ -169,12 +172,12 @@ function ShiftCloseScreen() {
 							variant: "ghost",
 							size: "sm",
 							onClick: handleCancel,
-							children: [/* @__PURE__ */ jsx(ArrowLeft, { className: "h-4 w-4 mr-1" }), "Cancel"]
+							children: [/* @__PURE__ */ jsx(ArrowLeft, { className: "h-4 w-4 me-1" }), "Cancel"]
 						}),
 						/* @__PURE__ */ jsxs("h1", {
 							className: "text-xl font-bold flex items-center gap-2",
 							children: [/* @__PURE__ */ jsx(ClipboardList, { className: "h-5 w-5" }), /* @__PURE__ */ jsxs("span", { children: ["Closing Shift", shift?.openedAt ? /* @__PURE__ */ jsxs("span", {
-								className: "text-sm font-medium text-muted-foreground ml-2",
+								className: "text-sm font-medium text-muted-foreground ms-2",
 								children: [
 									"· opened",
 									" ",
@@ -208,7 +211,7 @@ function ShiftCloseScreen() {
 								children: "Revenue"
 							}), /* @__PURE__ */ jsx("p", {
 								className: "text-lg font-bold tabular-nums",
-								children: formatPaisa(salesTotal)
+								children: formatMinor(salesTotal)
 							})]
 						}),
 						/* @__PURE__ */ jsxs("div", {
@@ -218,7 +221,7 @@ function ShiftCloseScreen() {
 								children: "Expected Cash"
 							}), /* @__PURE__ */ jsx("p", {
 								className: "text-lg font-bold tabular-nums",
-								children: formatPaisa(expectedCash)
+								children: formatMinor(expectedCash)
 							})]
 						})
 					]
@@ -245,7 +248,7 @@ function ShiftCloseScreen() {
 								children: "Counted"
 							}), /* @__PURE__ */ jsx("p", {
 								className: "text-3xl font-bold tabular-nums mt-1",
-								children: closingCash ? formatPaisa(actualCash) : "—"
+								children: closingCash ? formatMinor(actualCash) : "—"
 							})]
 						}),
 						/* @__PURE__ */ jsx(Numpad, {
@@ -268,7 +271,7 @@ function ShiftCloseScreen() {
 						})]
 					}), /* @__PURE__ */ jsxs("p", {
 						className: "text-2xl font-bold tabular-nums",
-						children: [difference >= 0 ? "+" : "", formatPaisa(difference)]
+						children: [difference >= 0 ? "+" : "", formatMinor(difference)]
 					})]
 				}),
 				overrideRequired && !cashierIsSupervisor && !blindCloseRequired && /* @__PURE__ */ jsx("div", {
@@ -284,7 +287,7 @@ function ShiftCloseScreen() {
 								className: "text-xs text-amber-800 dark:text-amber-200 mt-0.5",
 								children: [
 									"Variance exceeds the branch threshold",
-									policy ? ` (${formatPaisa(policy.varianceThresholdAbs)} or ${policy.varianceThresholdPct}%)` : "",
+									policy ? ` (${formatMinor(policy.varianceThresholdAbs)} or ${policy.varianceThresholdPct}%)` : "",
 									". A supervisor must authenticate before closing."
 								]
 							})]
@@ -295,7 +298,7 @@ function ShiftCloseScreen() {
 						className: "w-full bg-amber-600 hover:bg-amber-700 text-white",
 						onClick: () => setAuthDialogOpen(true),
 						disabled: isPending,
-						children: [/* @__PURE__ */ jsx(ShieldCheck, { className: "h-4 w-4 mr-2" }), "Get supervisor authorization"]
+						children: [/* @__PURE__ */ jsx(ShieldCheck, { className: "h-4 w-4 me-2" }), "Get supervisor authorization"]
 					})] }) : /* @__PURE__ */ jsxs(Fragment, { children: [
 						/* @__PURE__ */ jsxs("div", {
 							className: "flex items-start gap-2",
@@ -340,9 +343,9 @@ function ShiftCloseScreen() {
 						})
 					] })
 				}),
-				(submitError || closeErr || blindErr) && /* @__PURE__ */ jsxs("div", {
+				(submitError || closeFailure) && /* @__PURE__ */ jsxs("div", {
 					className: "flex items-start gap-2 rounded-md border border-red-200 bg-red-50 p-3 text-sm text-red-800 dark:border-red-800 dark:bg-red-950 dark:text-red-200",
-					children: [/* @__PURE__ */ jsx(AlertCircle, { className: "h-4 w-4 shrink-0 mt-0.5" }), /* @__PURE__ */ jsx("span", { children: submitError || closeErr?.message || blindErr?.message })]
+					children: [/* @__PURE__ */ jsx(AlertCircle, { className: "h-4 w-4 shrink-0 mt-0.5" }), /* @__PURE__ */ jsx("span", { children: submitError ?? closeFailure?.message })]
 				}),
 				blindCloseRequired && /* @__PURE__ */ jsx("p", {
 					className: "text-xs text-center text-muted-foreground",

package/dist/screens/ShiftOpenScreen.d.ts

@@ -0,0 +1,4 @@
+//#region src/screens/ShiftOpenScreen.d.ts
+declare function ShiftOpenScreen(): import("react").JSX.Element;
+//#endregion
+export { ShiftOpenScreen };

package/dist/screens/ShiftOpenScreen.js

@@ -3,13 +3,14 @@
 import { usePosAuth } from "../runtime/auth-port.js";
 import { usePosRuntime } from "../runtime/config.js";
 import { usePosBranch } from "../runtime/branch-port.js";
+import { formatMajor, formatMinor, majorToMinor } from "../lib/money.js";
 import { usePosContext } from "../state/pos-context.js";
-import { formatBdt, formatPaisa } from "../lib/money.js";
-import { useCallback, useMemo, useState } from "react";
-import { useOpenShift, usePosCurrentShift } from "@classytic/commerce-sdk/sales";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useOpenShift, usePosCurrentShift, useRegisters } from "@classytic/commerce-sdk/sales";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { AlertCircle, DollarSign, LayoutDashboard, LogOut, Store } from "lucide-react";
+import { AlertCircle, DollarSign, LayoutDashboard, LogOut, Monitor, Store } from "lucide-react";
 import { Button } from "@/components/ui/button";
+import { presentError } from "@classytic/fluid/error-contract";
 import { Numpad } from "@classytic/fluid/numpad";
 
 //#region src/screens/ShiftOpenScreen.tsx
@@ -19,6 +20,17 @@ import { Numpad } from "@classytic/fluid/numpad";
 * Wired to backend via `useOpenShift`. On success the POS state machine
 * dispatches OPEN_SHIFT and the pos-shell fast-forwards to products.
 */
+/**
+* The one open-shift refusal whose server message names an internal id
+* ("An active shift already exists for scope 'ynAb…'") — verified against
+* `ActiveShiftAlreadyOpenError` in `@classytic/pos`. Every other POS shift code
+* carries a message a cashier can act on, so it is left to fall through.
+*/
+const SHIFT_OPEN_ERRORS = { ACTIVE_SHIFT_ALREADY_OPEN: {
+	title: "A register is already open",
+	message: "Close the open shift before starting a new one.",
+	retryable: false
+} };
 function ShiftOpenScreen() {
 	const { dispatch } = usePosContext();
 	const branch = usePosBranch();
@@ -26,32 +38,53 @@ function ShiftOpenScreen() {
 	const { onNavigate } = usePosRuntime();
 	const { shift: existingShift, isLoading: isLoadingShift } = usePosCurrentShift();
 	const { openShift, isPending, error } = useOpenShift();
+	const { items: registers = [], isLoading: isLoadingRegisters } = useRegisters();
 	const [openingCash, setOpeningCash] = useState("");
 	const [submitError, setSubmitError] = useState(null);
+	const [selectedRegisterId, setSelectedRegisterId] = useState(null);
+	const activeRegisters = useMemo(() => registers.filter((r) => r.isActive), [registers]);
+	const needsRegisterChoice = activeRegisters.length > 1;
+	useEffect(() => {
+		if (activeRegisters.length === 1 && !selectedRegisterId) setSelectedRegisterId(activeRegisters[0]?._id ?? null);
+	}, [activeRegisters, selectedRegisterId]);
+	const canOpen = !needsRegisterChoice || !!selectedRegisterId;
 	const userName = sessionUser?.name || "Cashier";
 	const branchName = branch?.name || "POS Terminal";
 	const requiredFloat = existingShift?.policySnapshot?.requiredOpeningFloat ?? null;
 	const submitLabel = useMemo(() => {
 		if (isPending) return "Opening…";
-		if (requiredFloat !== null) return `Open with ${formatPaisa(requiredFloat)}`;
+		if (requiredFloat !== null) return `Open with ${formatMinor(requiredFloat)}`;
 		return "Open Register";
 	}, [isPending, requiredFloat]);
 	const handleOpenShift = useCallback(async () => {
 		setSubmitError(null);
-		const amount = Math.round((parseFloat(openingCash) || 0) * 100);
+		if (needsRegisterChoice && !selectedRegisterId) {
+			setSubmitError("Select a register to open");
+			return;
+		}
+		const amount = majorToMinor(parseFloat(openingCash) || 0);
 		try {
-			await openShift({ openingCash: amount });
-			dispatch({ type: "OPEN_SHIFT" });
+			const openedRegisterId = (await openShift({
+				openingCash: amount,
+				...selectedRegisterId ? { registerId: selectedRegisterId } : {}
+			}))?.data?.registerId ?? selectedRegisterId ?? null;
+			dispatch({
+				type: "OPEN_SHIFT",
+				registerId: openedRegisterId
+			});
 		} catch (err) {
-			const msg = err.message || "Failed to open register";
-			setSubmitError(msg);
+			const { message } = presentError(err, "The register was not opened. Try again.", { codeMap: SHIFT_OPEN_ERRORS });
+			setSubmitError(message);
 		}
 	}, [
 		openingCash,
 		openShift,
-		dispatch
+		dispatch,
+		needsRegisterChoice,
+		selectedRegisterId
 	]);
-	if (isLoadingShift) return /* @__PURE__ */ jsx("div", {
+	const openFailure = error ? presentError(error, "The register was not opened. Try again.", { codeMap: SHIFT_OPEN_ERRORS }) : null;
+	if (isLoadingShift || isLoadingRegisters) return /* @__PURE__ */ jsx("div", {
 		className: "flex items-center justify-center h-full",
 		children: /* @__PURE__ */ jsx("div", {
 			className: "text-muted-foreground text-sm",
@@ -114,6 +147,29 @@ function ShiftOpenScreen() {
 							})
 						]
 					}),
+					needsRegisterChoice && /* @__PURE__ */ jsxs("div", {
+						className: "space-y-2",
+						children: [/* @__PURE__ */ jsxs("label", {
+							className: "text-sm font-medium flex items-center gap-2",
+							children: [/* @__PURE__ */ jsx(Monitor, { className: "h-4 w-4" }), "Select Register"]
+						}), /* @__PURE__ */ jsx("div", {
+							className: "grid grid-cols-2 gap-2",
+							children: activeRegisters.map((r) => /* @__PURE__ */ jsxs("button", {
+								type: "button",
+								onClick: () => {
+									setSelectedRegisterId(r._id);
+								},
+								className: `rounded-lg border p-3 text-start transition-colors ${selectedRegisterId === r._id ? "border-primary bg-primary/10 ring-1 ring-primary" : "border-border hover:bg-muted"}`,
+								children: [/* @__PURE__ */ jsx("div", {
+									className: "font-medium text-sm truncate",
+									children: r.name
+								}), /* @__PURE__ */ jsx("div", {
+									className: "text-xs text-muted-foreground",
+									children: r.code
+								})]
+							}, r._id))
+						})]
+					}),
 					/* @__PURE__ */ jsxs("div", {
 						className: "space-y-2",
 						children: [
@@ -123,15 +179,15 @@ function ShiftOpenScreen() {
 									/* @__PURE__ */ jsx(DollarSign, { className: "h-4 w-4" }),
 									"Starting Cash in Drawer",
 									requiredFloat !== null && /* @__PURE__ */ jsxs("span", {
-										className: "ml-auto text-xs text-muted-foreground",
-										children: ["Required: ", formatPaisa(requiredFloat)]
+										className: "ms-auto text-xs text-muted-foreground",
+										children: ["Required: ", formatMinor(requiredFloat)]
 									})
 								]
 							}),
 							/* @__PURE__ */ jsx(Numpad, {
 								value: openingCash,
 								onChange: setOpeningCash,
-								onSubmit: isPending ? void 0 : handleOpenShift,
+								onSubmit: isPending || !canOpen ? void 0 : handleOpenShift,
 								submitLabel,
 								quickAdd: [
 									1e3,
@@ -144,13 +200,13 @@ function ShiftOpenScreen() {
 							}),
 							openingCash && !submitError && /* @__PURE__ */ jsxs("p", {
 								className: "text-center text-sm text-muted-foreground",
-								children: ["Opening with ", formatBdt(parseFloat(openingCash) || 0)]
+								children: ["Opening with ", formatMajor(parseFloat(openingCash) || 0)]
 							})
 						]
 					}),
-					(submitError || error) && /* @__PURE__ */ jsxs("div", {
+					(submitError || openFailure) && /* @__PURE__ */ jsxs("div", {
 						className: "flex items-start gap-2 rounded-md border border-red-200 bg-red-50 p-3 text-sm text-red-800 dark:border-red-800 dark:bg-red-950 dark:text-red-200",
-						children: [/* @__PURE__ */ jsx(AlertCircle, { className: "h-4 w-4 shrink-0 mt-0.5" }), /* @__PURE__ */ jsx("span", { children: submitError || error?.message })]
+						children: [/* @__PURE__ */ jsx(AlertCircle, { className: "h-4 w-4 shrink-0 mt-0.5" }), /* @__PURE__ */ jsx("span", { children: submitError ?? openFailure?.message })]
 					}),
 					requiredFloat === null && /* @__PURE__ */ jsx("div", {
 						className: "text-center",
@@ -158,7 +214,7 @@ function ShiftOpenScreen() {
 							variant: "ghost",
 							size: "sm",
 							className: "text-xs text-muted-foreground",
-							disabled: isPending,
+							disabled: isPending || !canOpen,
 							onClick: () => {
 								setOpeningCash("0");
 								handleOpenShift();

package/dist/screens/index.d.ts

@@ -0,0 +1,8 @@
+import { OrderHistoryDrawer } from "./OrderHistoryDrawer.js";
+import { ParkedOrdersDrawer } from "./ParkedOrdersDrawer.js";
+import { PaymentScreen } from "./PaymentScreen.js";
+import { ProductScreen } from "./ProductScreen.js";
+import { ReceiptScreen } from "./ReceiptScreen.js";
+import { ShiftCloseScreen } from "./ShiftCloseScreen.js";
+import { ShiftOpenScreen } from "./ShiftOpenScreen.js";
+export { OrderHistoryDrawer, ParkedOrdersDrawer, PaymentScreen, ProductScreen, ReceiptScreen, ShiftCloseScreen, ShiftOpenScreen };

package/dist/screens/index.js

@@ -0,0 +1,9 @@
+import { ParkedOrdersDrawer } from "./ParkedOrdersDrawer.js";
+import { ProductScreen } from "./ProductScreen.js";
+import { PaymentScreen } from "./PaymentScreen.js";
+import { ReceiptScreen } from "./ReceiptScreen.js";
+import { ShiftOpenScreen } from "./ShiftOpenScreen.js";
+import { ShiftCloseScreen } from "./ShiftCloseScreen.js";
+import { OrderHistoryDrawer } from "./OrderHistoryDrawer.js";
+
+export { OrderHistoryDrawer, ParkedOrdersDrawer, PaymentScreen, ProductScreen, ReceiptScreen, ShiftCloseScreen, ShiftOpenScreen };

package/dist/shell/index.d.ts

@@ -1,8 +1,10 @@
 import { PosHardware } from "../hardware/ports.js";
 import { createWebHardware } from "../hardware/web-adapter.js";
 import { createTauriHardware } from "../hardware/tauri-adapter.js";
+import "../hardware/index.js";
 import { PosAuthPort, PosSessionUser } from "../runtime/auth-port.js";
 import { PosRuntime } from "../runtime/config.js";
 import { PosBranch, PosBranchPort } from "../runtime/branch-port.js";
+import "../runtime/index.js";
 import { PosShell, PosShellProps } from "./pos-shell.js";
 export { type PosAuthPort, type PosBranch, type PosBranchPort, type PosHardware, type PosRuntime, type PosSessionUser, PosShell, type PosShellProps, createTauriHardware, createWebHardware };