@classytic/pos-ui 0.1.0 → 1.2.0

package/dist/shell/pos-shell.d.ts

@@ -1,8 +1,39 @@
 import { PosHardware } from "../hardware/ports.js";
+import "../hardware/index.js";
 import { PosAuthPort } from "../runtime/auth-port.js";
-import { PosRuntime } from "../runtime/config.js";
+import { PosRuntime, PosSalesCapabilities } from "../runtime/config.js";
 import { PosBranchPort } from "../runtime/branch-port.js";
+import "../runtime/index.js";
+import { PosScreen } from "../state/pos-state.js";
+import "../state/index.js";
+import { ReactNode } from "react";
 //#region src/shell/pos-shell.d.ts
+/**
+ * Where a vertical injects its own UI WITHOUT forking the shell.
+ *
+ * The shell owns the register's spine — the screen state machine, hotkeys,
+ * wake-lock, shift rehydration — which is identical everywhere. What differs
+ * per vertical is decoration and, occasionally, one whole screen: a gym wants a
+ * "Find member" action and a guest banner; a hotel wants "Charge to room".
+ * Those are slots, not forks.
+ */
+interface PosShellSlots {
+  /** Extra top-bar actions — e.g. member lookup, day pass. */
+  topBarActions?: ReactNode;
+  /** Above the active screen — e.g. the checked-in member / guest banner. */
+  aboveScreen?: ReactNode;
+  /** Below the active screen — e.g. a scanner/turnstile status strip. */
+  belowScreen?: ReactNode;
+  /** Always mounted — the host's own drawers and dialogs. */
+  overlays?: ReactNode;
+  /**
+   * Wrap or REPLACE a screen. Receives the screen key and the default node;
+   * return the default to keep it, or anything else to take it over. This is
+   * the escape hatch that makes forking unnecessary — a gym can replace only
+   * `products` and inherit every other screen's fixes.
+   */
+  renderScreen?: (screen: PosScreen, defaultNode: ReactNode) => ReactNode;
+}
 interface PosShellProps {
   /** Auth seam — host wires it to its auth client. */
   auth: PosAuthPort;
@@ -12,12 +43,14 @@ interface PosShellProps {
   runtime: PosRuntime;
   /** Hardware port; defaults to the web adapter. */
   hardware?: PosHardware;
+  /** Vertical-specific UI injected into the shell. See `PosShellSlots`. */
+  slots?: PosShellSlots;
+  /**
+   * Sales capabilities this deployment has enabled. Every flag defaults to OFF,
+   * so an existing host that omits this keeps exactly its current surface.
+   */
+  sales?: PosSalesCapabilities;
 }
-declare function PosShell({
-  auth,
-  branch,
-  runtime,
-  hardware
-}: PosShellProps): import("react").JSX.Element;
+declare function PosShell({ auth, branch, runtime, hardware, slots, sales }: PosShellProps): import("react").JSX.Element;
 //#endregion
-export { PosShell, PosShellProps };
+export { PosShell, PosShellProps, PosShellSlots };

package/dist/shell/pos-shell.js

@@ -1,7 +1,7 @@
 "use client";
 
 import { PosAuthProvider, usePosAuth } from "../runtime/auth-port.js";
-import { PosRuntimeProvider } from "../runtime/config.js";
+import { PosRuntimeProvider, PosSalesCapabilitiesProvider } from "../runtime/config.js";
 import { PosBranchProvider } from "../runtime/branch-port.js";
 import { createWebHardware } from "../hardware/web-adapter.js";
 import { HardwareProvider } from "../hardware/context.js";
@@ -31,7 +31,7 @@ import { jsx, jsxs } from "react/jsx-runtime";
 *
 * Screen flow: idle (shift open) → products → payment → receipt → products
 */
-function PosScreenRouter() {
+function PosScreenRouter({ slots }) {
 	const { state, dispatch } = usePosContext();
 	const sessionUser = usePosAuth().useSessionUser();
 	const { shift: activeShift } = usePosCurrentShift();
@@ -41,7 +41,10 @@ function PosScreenRouter() {
 	const [printerSettingsOpen, setPrinterSettingsOpen] = useState(false);
 	useWakeLock({ enabled: state.shiftOpen });
 	useEffect(() => {
-		if (state.screen === "idle" && activeShift?.state === "open" && !state.shiftOpen) dispatch({ type: "OPEN_SHIFT" });
+		if (state.screen === "idle" && activeShift?.state === "open" && !state.shiftOpen) dispatch({
+			type: "OPEN_SHIFT",
+			registerId: activeShift.registerId ?? null
+		});
 	}, [
 		state.screen,
 		state.shiftOpen,
@@ -74,26 +77,26 @@ function PosScreenRouter() {
 	const handleNewSale = useCallback(() => {
 		if (state.screen === "receipt") dispatch({ type: "NEW_SALE" });
 	}, [state.screen, dispatch]);
+	const defaultScreen = state.screen === "idle" ? /* @__PURE__ */ jsx(ShiftOpenScreen, {}) : state.screen === "products" ? /* @__PURE__ */ jsx(ProductScreen, {}) : state.screen === "payment" ? /* @__PURE__ */ jsx(PaymentScreen, {}) : state.screen === "receipt" ? /* @__PURE__ */ jsx(ReceiptScreen, {}) : state.screen === "closing" ? /* @__PURE__ */ jsx(ShiftCloseScreen, {}) : null;
+	const screenNode = slots.renderScreen ? slots.renderScreen(state.screen, defaultScreen) : defaultScreen;
 	return /* @__PURE__ */ jsxs("div", {
 		className: "flex flex-col h-screen",
 		children: [
 			state.screen !== "idle" && /* @__PURE__ */ jsx(PosTopBar, {
+				actions: slots.topBarActions,
 				userName,
 				onNewSale: state.screen === "products" ? handleNewSale : void 0,
 				onOpenHistory: () => setHistoryOpen(true),
 				onOpenHelp: () => setHelpOpen(true),
 				onOpenPrinterSettings: () => setPrinterSettingsOpen(true)
 			}),
-			/* @__PURE__ */ jsxs("div", {
+			slots.aboveScreen,
+			/* @__PURE__ */ jsx("div", {
 				className: "flex-1 min-h-0",
-				children: [
-					state.screen === "idle" && /* @__PURE__ */ jsx(ShiftOpenScreen, {}),
-					state.screen === "products" && /* @__PURE__ */ jsx(ProductScreen, {}),
-					state.screen === "payment" && /* @__PURE__ */ jsx(PaymentScreen, {}),
-					state.screen === "receipt" && /* @__PURE__ */ jsx(ReceiptScreen, {}),
-					state.screen === "closing" && /* @__PURE__ */ jsx(ShiftCloseScreen, {})
-				]
+				children: screenNode
 			}),
+			slots.belowScreen,
+			slots.overlays,
 			/* @__PURE__ */ jsx(OrderHistoryDrawer, {
 				open: historyOpen,
 				onOpenChange: setHistoryOpen
@@ -109,19 +112,23 @@ function PosScreenRouter() {
 		]
 	});
 }
-function PosShell({ auth, branch, runtime, hardware }) {
+function PosShell({ auth, branch, runtime, hardware, slots, sales }) {
+	const hw = useMemo(() => hardware ?? createWebHardware(), [hardware]);
 	return /* @__PURE__ */ jsx(PosAuthProvider, {
 		auth,
 		children: /* @__PURE__ */ jsx(PosBranchProvider, {
 			branch,
 			children: /* @__PURE__ */ jsx(PosRuntimeProvider, {
 				runtime,
-				children: /* @__PURE__ */ jsx(DensityProvider, {
-					density: "auto",
-					children: /* @__PURE__ */ jsx(HotkeyRegistryProvider, { children: /* @__PURE__ */ jsx(HardwareProvider, {
-						hardware: useMemo(() => hardware ?? createWebHardware(), [hardware]),
-						children: /* @__PURE__ */ jsx(PosProvider, { children: /* @__PURE__ */ jsx(PosScreenRouter, {}) })
-					}) })
+				children: /* @__PURE__ */ jsx(PosSalesCapabilitiesProvider, {
+					sales: sales ?? {},
+					children: /* @__PURE__ */ jsx(DensityProvider, {
+						density: "auto",
+						children: /* @__PURE__ */ jsx(HotkeyRegistryProvider, { children: /* @__PURE__ */ jsx(HardwareProvider, {
+							hardware: hw,
+							children: /* @__PURE__ */ jsx(PosProvider, { children: /* @__PURE__ */ jsx(PosScreenRouter, { slots: slots ?? {} }) })
+						}) })
+					})
 				})
 			})
 		})

package/dist/state/index.d.ts

@@ -0,0 +1,3 @@
+import { INITIAL_POS_STATE, PosAction, PosScreen, PosState, posReducer } from "./pos-state.js";
+import { PosProvider, usePosContext } from "./pos-context.js";
+export { INITIAL_POS_STATE, type PosAction, PosProvider, type PosScreen, type PosState, posReducer, usePosContext };

package/dist/state/index.js

@@ -0,0 +1,4 @@
+import { INITIAL_POS_STATE, posReducer } from "./pos-state.js";
+import { PosProvider, usePosContext } from "./pos-context.js";
+
+export { INITIAL_POS_STATE, PosProvider, posReducer, usePosContext };

package/dist/state/pos-context.d.ts

@@ -0,0 +1,13 @@
+import { PosAction, PosState } from "./pos-state.js";
+import { ReactNode } from "react";
+//#region src/state/pos-context.d.ts
+interface PosContextValue {
+  state: PosState;
+  dispatch: (action: PosAction) => void;
+}
+declare function PosProvider({ children }: {
+  children: ReactNode;
+}): import("react").JSX.Element;
+declare function usePosContext(): PosContextValue;
+//#endregion
+export { PosProvider, usePosContext };

package/dist/state/pos-state.d.ts

@@ -0,0 +1,49 @@
+import { PosReceiptData } from "@classytic/commerce-sdk/sales";
+//#region src/state/pos-state.d.ts
+type PosScreen = "idle" | "products" | "payment" | "receipt" | "closing";
+type PosAction = {
+  type: "OPEN_SHIFT";
+  registerId?: string | null;
+} | {
+  type: "GO_TO_PAYMENT";
+} | {
+  type: "GO_BACK";
+} | {
+  type: "COMPLETE_SALE";
+  receipt: PosReceiptData | null;
+} | {
+  type: "NEW_SALE";
+} | {
+  type: "CLOSE_SHIFT";
+} | {
+  type: "CONFIRM_CLOSE";
+} | {
+  type: "CANCEL_CLOSE";
+};
+interface PosState {
+  screen: PosScreen;
+  /**
+   * Last completed order receipt (for ReceiptScreen).
+   *
+   * Typed, not `unknown`. It was `unknown` and every consumer cast it back
+   * (`state.lastReceipt as PosReceiptData | null` in ReceiptScreen), which is
+   * the worst of both: no compile-time contract AND the appearance of one. The
+   * shape is the SDK's — `transformOrderToReceipt` already produces exactly it,
+   * including a `null` for an unparseable response, so the null is real state
+   * and not a placeholder.
+   */
+  lastReceipt: PosReceiptData | null;
+  /** Whether a shift is currently open */
+  shiftOpen: boolean;
+  /**
+   * Register (`@classytic/pos` Register `_id`) the open shift is bound to.
+   * Threads into `/current` scoping + POS order placement so a sale hits the
+   * right register's shift when a branch runs several. Null before open / when
+   * the branch has a single register the backend resolves implicitly.
+   */
+  activeRegisterId: string | null;
+}
+declare const INITIAL_POS_STATE: PosState;
+declare function posReducer(state: PosState, action: PosAction): PosState;
+//#endregion
+export { INITIAL_POS_STATE, PosAction, PosScreen, PosState, posReducer };

package/dist/state/pos-state.js

@@ -2,8 +2,8 @@
 const INITIAL_POS_STATE = {
 	screen: "idle",
 	lastReceipt: null,
-	lastCashReceived: null,
-	shiftOpen: false
+	shiftOpen: false,
+	activeRegisterId: null
 };
 function posReducer(state, action) {
 	switch (action.type) {
@@ -12,7 +12,8 @@ function posReducer(state, action) {
 			return {
 				...state,
 				screen: "products",
-				shiftOpen: true
+				shiftOpen: true,
+				activeRegisterId: action.registerId ?? state.activeRegisterId
 			};
 		case "GO_TO_PAYMENT":
 			if (state.screen !== "products") return state;
@@ -28,8 +29,7 @@ function posReducer(state, action) {
 			if (state.screen === "receipt") return {
 				...state,
 				screen: "products",
-				lastReceipt: null,
-				lastCashReceived: null
+				lastReceipt: null
 			};
 			return state;
 		case "COMPLETE_SALE":
@@ -44,8 +44,7 @@ function posReducer(state, action) {
 			return {
 				...state,
 				screen: "products",
-				lastReceipt: null,
-				lastCashReceived: null
+				lastReceipt: null
 			};
 		case "CLOSE_SHIFT":
 			if (!state.shiftOpen) return state;

package/dist/utils/pos-helpers.js

@@ -1,17 +1,25 @@
-import { Paisa } from "../lib/money.js";
-import { isValidPhone } from "@classytic/commerce-sdk/client";
+import { TenantMinorUnits, formatMinor, minorPerMajorUnit, minorToMoney, toMajor } from "../lib/money.js";
+import { getReceiptLocale, isValidPhone } from "@classytic/commerce-sdk/client";
 
 //#region src/utils/pos-helpers.ts
-/** Brand a paisa value read out of an unknown response. The number is
-*  expected to already be in paisa (be-prod canonical unit); this helper
-*  just re-asserts the brand after a `typeof` guard. */
-const paisaOr0 = (v) => Paisa(typeof v === "number" ? v : 0);
+/** Brand a MINOR-unit value read out of an unknown response. The number is
+*  expected to already be in minor units (the server's canonical unit — paisa
+*  on a BDT deployment); this helper just re-asserts the brand after a
+*  `typeof` guard. */
+const minorOr0 = (v) => TenantMinorUnits(typeof v === "number" ? v : 0);
 /**
-* Parse cash received input to number
+* Parse the cash-received field to a non-negative number.
+*
+* Clamps at 0 as well as guarding NaN. Negative cash is meaningless, and an
+* unclamped negative propagates into `calculateAmountDue`, which then shows MORE
+* owed than the sale total — a cashier reading "৳150 due" on a ৳100 sale. The
+* function is named for a quantity that cannot be negative, so it should not be
+* able to return one.
 */
 function parseCashReceived(value) {
 	const n = Number(value);
-	return Number.isFinite(n) ? n : 0;
+	if (!Number.isFinite(n)) return 0;
+	return n > 0 ? n : 0;
 }
 /**
 * Parse input to positive number (min 0)
@@ -35,6 +43,23 @@ function calculateCartTotals(items, discountInput) {
 		itemCount: items.length
 	};
 }
+/**
+* Points per ONE MAJOR unit, derived from the config's `pointValueMinor`
+* (minor units one point redeems for).
+*
+* ONE function because there were TWO copies of this derivation in this file —
+* `validateRedemption` and `calculateOrderTotals` — each with its own hardcoded
+* `100`. Two copies of one rate is how a redemption cap and a redemption charge
+* come to disagree, and neither would throw. The factor now comes from the
+* currency (KWD is 1000, JPY is 1), so the arithmetic is not BDT-only either.
+*
+* Returns 1 when the rate is absent or non-positive — there is no correct answer
+* without a configured rate, which is why the UI must not print a money figure
+* in that state (see `PointsRedemptionSection`).
+*/
+function pointsPerMajorUnit(pointValueMinor) {
+	return typeof pointValueMinor === "number" && pointValueMinor > 0 ? minorPerMajorUnit() / pointValueMinor : 1;
+}
 function validateRedemption(pointsToRedeem, customerPoints, orderTotal, membershipConfig) {
 	if (!membershipConfig?.enabled) return {
 		valid: false,
@@ -53,23 +78,38 @@ function validateRedemption(pointsToRedeem, customerPoints, orderTotal, membersh
 		valid: false,
 		error: `Insufficient points. Available: ${customerPoints}`
 	};
-	if (orderTotal < (config.minOrderAmount ?? 0)) return {
+	/**
+	* `minOrderAmount` is integer MINOR units (be-prod's `loyalty.membership`
+	* contract), while `orderTotal` reaching this function is MAJOR units — so the
+	* two were compared across denominations. A ৳500 minimum is `50000` paisa, and
+	* `orderTotal < 50000` is true for every realistic basket, so redemption was
+	* refused on essentially every sale while the message read "৳50000 required".
+	* Nothing threw; the cashier just saw an impossible threshold.
+	*
+	* Converted through primitives (`toMajor(minorToMoney(...))`) rather than a
+	* `/ 100`, so the factor is the CURRENCY's — KWD is 1000, JPY is 1 — and the
+	* message is formatted by the same `Intl`-backed formatter as every other
+	* amount instead of a hand-glued symbol.
+	*/
+	const minOrderMinor = config.minOrderAmount ?? 0;
+	if (orderTotal < toMajor(minorToMoney(minOrderMinor))) return {
 		valid: false,
-		error: `Minimum order of ৳${config.minOrderAmount} required`
+		error: `Minimum order of ${formatMinor(minOrderMinor)} required`
 	};
+	const pointsPerMajor = pointsPerMajorUnit(config.pointValueMinor);
 	const maxDiscount = Math.floor(orderTotal * (config.maxRedeemPercent ?? 100) / 100);
-	const requestedDiscount = Math.floor(pointsToRedeem / (config.pointsPerBdt ?? 1));
+	const requestedDiscount = Math.floor(pointsToRedeem / pointsPerMajor);
 	let actualDiscount = requestedDiscount;
 	let actualPoints = pointsToRedeem;
 	if (requestedDiscount > maxDiscount) {
 		actualDiscount = maxDiscount;
-		actualPoints = maxDiscount * (config.pointsPerBdt ?? 1);
+		actualPoints = maxDiscount * pointsPerMajor;
 	}
 	return {
 		valid: true,
 		discountAmount: actualDiscount,
 		pointsToRedeem: actualPoints,
-		maxAllowedPoints: maxDiscount * (config.pointsPerBdt ?? 1)
+		maxAllowedPoints: maxDiscount * pointsPerMajor
 	};
 }
 function calculateOrderTotals({ items, manualDiscountInput, membershipConfig, customer, pointsToRedeemInput }) {
@@ -92,7 +132,7 @@ function calculateOrderTotals({ items, manualDiscountInput, membershipConfig, cu
 			maxAllowedPoints = result.maxAllowedPoints ?? 0;
 		} else redemptionError = result.error ?? "Redemption not available";
 	}
-	if (!maxAllowedPoints && membershipConfig?.enabled && membershipConfig?.redemption?.enabled) maxAllowedPoints = Math.floor(preliminaryTotal * (membershipConfig.redemption.maxRedeemPercent ?? 100) / 100) * (membershipConfig.redemption.pointsPerBdt ?? 1);
+	if (!maxAllowedPoints && membershipConfig?.enabled && membershipConfig?.redemption?.enabled) maxAllowedPoints = Math.floor(preliminaryTotal * (membershipConfig.redemption.maxRedeemPercent ?? 100) / 100) * pointsPerMajorUnit(membershipConfig.redemption.pointValueMinor);
 	const total = Math.max(0, preliminaryTotal - redemptionDiscount);
 	return {
 		subtotal,
@@ -129,23 +169,11 @@ function calculateAmountDue(cashReceived, total) {
 function isValidBDPhone(phone) {
 	return isValidPhone(phone);
 }
-/**
-* Check if a search string looks like a phone number. `exact` uses the
-* deployment's phone pattern (locale-driven); `likely` is a loose digit-run
-* heuristic that stays country-neutral.
-*/
-function isPhoneSearch(query) {
-	const trimmed = query.trim();
-	return {
-		exact: isValidPhone(trimmed),
-		likely: /^\d{4,}$/.test(trimmed)
-	};
-}
 /** Read paisa from a Money struct `{ amount, currency }` returned by the
 *  order kernel. Falls back to a bare number for legacy shapes. */
 const moneyAmount = (m) => {
-	if (m && typeof m === "object" && "amount" in m && typeof m.amount === "number") return Paisa(m.amount);
-	return paisaOr0(m);
+	if (m && typeof m === "object" && "amount" in m && typeof m.amount === "number") return TenantMinorUnits(m.amount);
+	return minorOr0(m);
 };
 /**
 * Transform a POS order response to receipt format.
@@ -185,9 +213,18 @@ function transformOrderToReceipt(orderResponse, branchInfo) {
 	const meta = order.metadata ?? {};
 	const membership = meta.membership ?? {};
 	const vat = meta.vat ?? {};
-	const primaryPayment = (meta.payments ?? [])[0];
+	const primaryPayment = (order.tenders ?? [])[0];
+	/**
+	* Change handed back, from the placement's own record. Over-tender is modelled rather than
+	* absorbed (`tenders[].amount` is the APPLIED share and the excess is change), so the
+	* receipt can finally show it — the one place the customer actually checks it.
+	*/
+	const tenderMeta = meta.tender ?? {};
+	const changeMinor = typeof tenderMeta.changeMinor === "number" && tenderMeta.changeMinor > 0 ? tenderMeta.changeMinor : void 0;
 	const itemVatAmount = (line) => {
-		return Paisa(Number(moneyAmount(line.unitTax)) * (typeof line.quantity === "number" ? line.quantity : 1));
+		const unitTax = Number(moneyAmount(line.unitTax));
+		const qty = typeof line.quantity === "number" ? line.quantity : 1;
+		return TenantMinorUnits(unitTax * qty);
 	};
 	return {
 		orderId: String(order._id || ""),
@@ -204,7 +241,7 @@ function transformOrderToReceipt(orderResponse, branchInfo) {
 			cardId: String(membership.cardId),
 			tier: membership.tier ? String(membership.tier) : void 0,
 			pointsEarned: typeof membership.pointsEarned === "number" ? membership.pointsEarned : void 0,
-			tierDiscount: paisaOr0(membership.tierDiscountApplied)
+			tierDiscount: minorOr0(membership.tierDiscountApplied)
 		} : void 0,
 		items: lines.map((line) => {
 			const snap = line.snapshot ?? {};
@@ -225,18 +262,84 @@ function transformOrderToReceipt(orderResponse, branchInfo) {
 			applicable: !!vat.applicable,
 			rate: typeof vat.rate === "number" ? vat.rate : 0,
 			amount: moneyAmount(totals.tax),
-			taxableAmount: paisaOr0(vat.taxableAmount),
+			taxableAmount: minorOr0(vat.taxableAmount),
 			sellerBin: vat.sellerBin ? String(vat.sellerBin) : void 0,
 			pricesIncludeVat: typeof vat.pricesIncludeVat === "boolean" ? vat.pricesIncludeVat : true
 		},
 		total: moneyAmount(totals.grandTotal),
 		payment: {
+			/**
+			* The real tender method from `order.tenders[0]`. `'cash'` remains the fallback for an
+			* order with no tender at all (a comped or unpaid sale), NOT for one whose method simply
+			* lived somewhere this mapper had stopped looking.
+			*/
 			method: primaryPayment?.method ?? "cash",
 			...primaryPayment?.reference ? { reference: primaryPayment.reference } : {},
 			amount: moneyAmount(paymentState.totalCharged) || moneyAmount(totals.grandTotal)
-		}
+		},
+		/**
+		* Change, when there was any. Printing it is the point of modelling it — the customer
+		* verifies the change against the receipt at the counter.
+		*/
+		...changeMinor !== void 0 ? { changeDue: changeMinor } : {}
+	};
+}
+/**
+* `PosReceiptData` (either the fresh-checkout shape or `transformOrderToReceipt`'s
+* reprint shape — both converge on this) → the structured `ReceiptPayload` the
+* hardware port's agent/Tauri adapters need. Shared by `ReceiptScreen` (live
+* checkout) and `ReceiptReprintDialog` (historical reprint) so both paths build
+* the SAME payload shape for a real thermal printer — previously only the live
+* screen went through the printer port at all; a reprint called
+* `printDocument()` directly and could never reach a paired ESC/POS printer.
+*/
+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;
+	const showPhone = Boolean(customerPhoneRaw && !customerPhoneRaw.startsWith("pending_"));
+	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: showPhone ? customerPhoneRaw ?? void 0 : void 0,
+			loyaltyId: receipt.membership?.cardId
+		} : void 0
 	};
 }
 
 //#endregion
-export { calculateAmountDue, calculateCartTotals, calculateChange, calculateOrderTotals, isPhoneSearch, isValidBDPhone, parseCashReceived, parsePositiveNumber, transformOrderToReceipt, validateRedemption };
+export { buildReceiptPayload, calculateAmountDue, calculateCartTotals, calculateChange, calculateOrderTotals, isValidBDPhone, parseCashReceived, parsePositiveNumber, transformOrderToReceipt, validateRedemption };

package/package.json

@@ -1,6 +1,7 @@
 {
+  "license": "SEE LICENSE IN LICENSE",
   "name": "@classytic/pos-ui",
-  "version": "0.1.0",
+  "version": "1.2.0",
   "private": false,
   "type": "module",
   "description": "Point-of-sale register UI — a self-contained, full-screen state-machine app (shift → products → payment → receipt → close) with a hardware DI port (printer/drawer/scanner/terminal). Multi-surface: web, Tauri desktop, React Native. Frontend sibling of the @classytic/pos kernel. Independent of the dashboard stack (no erp-shell).",
@@ -14,12 +15,17 @@
     "build": "tsdown",
     "dev": "tsdown --watch",
     "typecheck": "tsc --noEmit",
-    "clean": "rimraf dist"
+    "clean": "rimraf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "node ../../scripts/ui-guards/run.mjs",
+    "prepublishOnly": "npm run typecheck && npm run lint && npm run build"
   },
   "peerDependencies": {
-    "@classytic/commerce-sdk": ">=0.9.0",
-    "@classytic/fluid": ">=1.7.0",
-    "@classytic/primitives": ">=0.9.0",
+    "@classytic/commerce-sdk": ">=0.14.0",
+    "@classytic/fluid": ">=1.13.0",
+    "@classytic/pos-agent": ">=0.1.0",
+    "@classytic/primitives": ">=0.23.0",
     "@tanstack/react-query": ">=5.0.0",
     "clsx": ">=2.0.0",
     "lucide-react": ">=1.0.0",
@@ -35,6 +41,9 @@
     "@classytic/fluid": {
       "optional": true
     },
+    "@classytic/pos-agent": {
+      "optional": true
+    },
     "@classytic/primitives": {
       "optional": true
     },
@@ -61,6 +70,10 @@
     }
   },
   "devDependencies": {
+    "@classytic/commerce-sdk": ">=0.14.0",
+    "@classytic/fluid": ">=1.13.0",
+    "@classytic/pos-agent": ">=0.1.0",
+    "@classytic/primitives": ">=0.23.0",
     "@tanstack/react-query": "^5.101.2",
     "@types/node": "^26.1.0",
     "@types/react": "^19.2.17",
@@ -73,7 +86,7 @@
     "rimraf": "^6.1.3",
     "sonner": "^2.0.7",
     "tailwind-merge": "^3.6.0",
-    "tsdown": "^0.22.3",
+    "tsdown": "^0.22.14",
     "typescript": "^6.0.3"
   },
   "publishConfig": {
@@ -81,12 +94,19 @@
   },
   "sideEffects": false,
   "exports": {
+    "./components": "./dist/components/index.js",
     "./hardware": "./dist/hardware/index.js",
+    "./hooks": "./dist/hooks/index.js",
     "./runtime": "./dist/runtime/index.js",
+    "./screens": "./dist/screens/index.js",
     "./shell": "./dist/shell/index.js",
+    "./state": "./dist/state/index.js",
     "./package.json": "./package.json"
   },
   "inlinedDependencies": {
-    "react-hook-form": "7.80.0"
+    "react-hook-form": "7.86.0"
+  },
+  "dependencies": {
+    "uqr": "^0.1.3"
   }
 }