@classytic/pos-ui 0.2.0 → 1.2.0

package/LICENSE

@@ -0,0 +1,75 @@
+Classytic Source-Available License (Community & Commercial), Version 1.0
+
+Copyright (c) 2026 Classytic LLC. All rights reserved.
+
+This software is source-available, not open source. Please read this License
+before using it.
+
+1. DEFINITIONS
+   "Software" means the contents of this package and any accompanying source
+   code, object code, or documentation, in any form.
+   "Licensor" means Classytic LLC, a limited liability company organized in the
+   United States.
+   "You" means the individual or legal entity exercising rights under this
+   License.
+   "Evaluation Use" means use for evaluation, development, testing,
+   experimentation, or internal non-commercial purposes only.
+   "Production Use" means any use of the Software that is live, commercial,
+   revenue-generating, or customer-facing, or any use other than Evaluation Use.
+   "Commercial License" means a separate written agreement executed with
+   Licensor that grants Production Use rights.
+
+2. OWNERSHIP
+   The Software is licensed, not sold. Licensor retains all right, title, and
+   interest in and to the Software, including all intellectual property rights.
+   All rights not expressly granted in this License are reserved by Licensor.
+
+3. EVALUATION GRANT
+   Subject to Your compliance with this License, Licensor grants You a
+   worldwide, royalty-free, non-exclusive, non-transferable, revocable license
+   to download, install, run, and modify the Software solely for Evaluation Use.
+
+4. PRODUCTION USE REQUIRES A COMMERCIAL LICENSE
+   Production Use of the Software is NOT permitted under this License and
+   requires a Commercial License from Licensor. A Commercial License may be
+   granted at Licensor's discretion, with or without a fee, and may confer
+   perpetual, irrevocable, and transferable Production Use rights as set out in
+   that agreement. Contact licensing@classytic.com to obtain one.
+
+5. RESTRICTIONS
+   You may not:
+   (a) make any Production Use of the Software without a Commercial License;
+   (b) redistribute, resell, rent, sublicense, or otherwise make the Software
+       (in whole or in part, original or modified) available to third parties as
+       a stand-alone product, framework, library, or hosted/managed service that
+       competes with the Software or with Licensor;
+   (c) remove, obscure, or alter any copyright, license, or attribution notice.
+
+6. FEEDBACK AND CONTRIBUTIONS
+   Any feedback, suggestions, or contributions You provide relating to the
+   Software may be used by Licensor for any purpose without obligation to You.
+
+7. TERMINATION
+   This License and the Evaluation Grant terminate automatically if You breach
+   any term. Upon termination You must cease all use of the Software and destroy
+   all copies in Your possession. Rights under a Commercial License are governed
+   by that agreement's own terms and survive termination of this License to the
+   extent stated there.
+
+8. DISCLAIMER OF WARRANTY
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+
+9. LIMITATION OF LIABILITY
+   TO THE MAXIMUM EXTENT PERMITTED BY LAW, IN NO EVENT SHALL LICENSOR BE LIABLE
+   FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+   TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE
+   OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+10. GOVERNING LAW
+   This License is governed by the laws of the State of Delaware, United States,
+   without regard to its conflict-of-laws principles. (Adjust to Your LLC's state
+   of formation.)
+
+For commercial licensing, contact: licensing@classytic.com

package/dist/components/CartSidebar.d.ts

@@ -0,0 +1,56 @@
+import { UsePosCartReturn } from "../hooks/usePosCart.js";
+import { UsePosCustomerReturn } from "../hooks/usePosCustomer.js";
+//#region src/components/CartSidebar.d.ts
+interface CartSidebarProps {
+  cart: UsePosCartReturn;
+  customer: UsePosCustomerReturn;
+  /**
+   * `loyalty.membership` config. `pointValueMinor` is integer MINOR units per
+   * point (loyalty 0.6.0); the legacy `pointsPerBdt` it replaced was the
+   * RECIPROCAL quantity and the server no longer emits it.
+   */
+  membership: {
+    enabled?: boolean;
+    redemption?: {
+      enabled?: boolean;
+      minRedeemPoints?: number;
+      pointValueMinor?: number;
+    };
+  } | null | undefined;
+  orderTotals: {
+    subtotal: number;
+    manualDiscount: number;
+    tierDiscount: number;
+    tierName: string | null;
+    redemptionDiscount: number;
+    total: number;
+    pointsToEarn: number;
+    pointsRedeemed: number;
+    redemptionError: string | null;
+    maxAllowedPoints: number;
+  };
+  discountAuth: {
+    isAuthorized: boolean;
+    authorizedBy: {
+      name: string;
+    } | null;
+    clearAuth: () => void;
+  };
+  onCheckout: () => void;
+  onRequestDiscountAuth: () => void;
+  onClearDiscountAuth: () => void;
+  /** Park-current-sale handler (F6). Disabled when cart is empty or
+   *  the parked-orders store is full. */
+  onParkSale?: () => void;
+  /** Open the parked-sales drawer (F7). Always available so the cashier
+   *  can review/restore pending holds. */
+  onOpenParked?: () => void;
+  /** Number of currently-parked sales — drives the badge on the
+   *  "Parked" button so the cashier knows there are slots to revisit. */
+  parkedCount?: number;
+  /** Whether the parked-orders store has room for one more (≤ MAX). */
+  canPark?: boolean;
+}
+declare function CartSidebar({ cart, customer, membership, orderTotals, discountAuth, onCheckout, onRequestDiscountAuth, onClearDiscountAuth, onParkSale, onOpenParked, parkedCount, canPark }: CartSidebarProps): import("react").JSX.Element;
+//#endregion
+export { CartSidebar };

package/dist/components/CartSidebar.js

@@ -1,6 +1,6 @@
 "use client";
 
-import { formatBdt } from "../lib/money.js";
+import { formatMajor } from "../lib/money.js";
 import { getReadableTextColor, getTierColor } from "../lib/loyalty.js";
 import { CartItems } from "../dashboard/components/cart/CartItems.js";
 import { CartSummary } from "../dashboard/components/cart/CartSummary.js";
@@ -63,7 +63,7 @@ function CartSidebar({ cart, customer, membership, orderTotals, discountAuth, on
 		pointsBalance: customer.selectedCustomer?.membership?.points?.current ?? 0,
 		minRedeemPoints: membership?.redemption?.minRedeemPoints ?? 0,
 		maxRedeemPoints: Math.min(orderTotals.maxAllowedPoints, customer.selectedCustomer?.membership?.points?.current ?? 0),
-		pointsPerBdt: membership?.redemption?.pointsPerBdt ?? 1,
+		pointValueMinor: membership?.redemption?.pointValueMinor,
 		estimatedDiscount: orderTotals.redemptionDiscount,
 		error: orderTotals.redemptionError
 	}), [
@@ -100,11 +100,11 @@ function CartSidebar({ cart, customer, membership, orderTotals, discountAuth, on
 							onClick: onOpenParked,
 							"aria-label": `Parked sales (${parkedCount})`,
 							children: [
-								/* @__PURE__ */ jsx(Inbox, { className: "h-3.5 w-3.5 mr-1" }),
+								/* @__PURE__ */ jsx(Inbox, { className: "h-3.5 w-3.5 me-1" }),
 								"Parked",
 								parkedCount > 0 && /* @__PURE__ */ jsx(Badge, {
 									variant: "secondary",
-									className: "ml-1.5 h-4 px-1.5 text-[10px]",
+									className: "ms-1.5 h-4 px-1.5 text-[10px]",
 									children: parkedCount
 								})
 							]
@@ -116,14 +116,14 @@ function CartSidebar({ cart, customer, membership, orderTotals, discountAuth, on
 							onClick: onParkSale,
 							disabled: !canPark,
 							title: canPark ? "Park sale (F6)" : "Max 5 parked — resume one first",
-							children: [/* @__PURE__ */ jsx(PauseCircle, { className: "h-3.5 w-3.5 mr-1" }), "Park"]
+							children: [/* @__PURE__ */ jsx(PauseCircle, { className: "h-3.5 w-3.5 me-1" }), "Park"]
 						}),
 						!isEmpty && /* @__PURE__ */ jsxs(Button, {
 							variant: "ghost",
 							size: "sm",
 							className: "h-7 text-xs text-destructive",
 							onClick: cart.clearCart,
-							children: [/* @__PURE__ */ jsx(Trash2, { className: "h-3.5 w-3.5 mr-1" }), "Clear"]
+							children: [/* @__PURE__ */ jsx(Trash2, { className: "h-3.5 w-3.5 me-1" }), "Clear"]
 						})
 					]
 				})]
@@ -195,7 +195,7 @@ function CartSidebar({ cart, customer, membership, orderTotals, discountAuth, on
 						pointsBalance: redemption.pointsBalance,
 						minRedeemPoints: redemption.minRedeemPoints,
 						maxRedeemPoints: redemption.maxRedeemPoints,
-						pointsPerBdt: redemption.pointsPerBdt,
+						pointValueMinor: redemption.pointValueMinor,
 						estimatedDiscount: redemption.estimatedDiscount,
 						error: redemption.error,
 						value: cart.pointsToRedeemInput,
@@ -208,10 +208,11 @@ function CartSidebar({ cart, customer, membership, orderTotals, discountAuth, on
 			}),
 			!isEmpty && /* @__PURE__ */ jsx("div", {
 				className: "px-4 py-3 border-t bg-card",
-				children: /* @__PURE__ */ jsxs(Button, {
+				children: /* @__PURE__ */ jsx(Button, {
 					className: "w-full h-12 text-base font-semibold",
 					onClick: onCheckout,
-					children: ["Checkout ", formatBdt(orderTotals.total)]
+					disabled: !cart.ready,
+					children: cart.ready ? `Checkout ${formatMajor(orderTotals.total)}` : "Preparing register…"
 				})
 			})
 		]

package/dist/components/PosTopBar.d.ts

@@ -0,0 +1,19 @@
+//#region src/components/PosTopBar.d.ts
+interface PosTopBarProps {
+  userName?: string;
+  /**
+   * Host-supplied actions rendered before the built-in ones — a gym's
+   * "Find member" / "Day pass", a hotel's "Charge to room". Keeps a vertical
+   * out of this component's business.
+   */
+  actions?: import("react").ReactNode;
+  onNewSale?: () => void;
+  onOpenHistory?: () => void;
+  /** Open the keyboard-shortcuts help dialog (also bound to `?`). */
+  onOpenHelp?: () => void;
+  /** Open the printer-settings dialog (host/port + test connection). */
+  onOpenPrinterSettings?: () => void;
+}
+declare function PosTopBar({ userName, actions, onNewSale, onOpenHistory, onOpenHelp, onOpenPrinterSettings }: PosTopBarProps): import("react").JSX.Element;
+//#endregion
+export { PosTopBar, PosTopBarProps };

package/dist/components/PosTopBar.js

@@ -32,7 +32,7 @@ function useClock() {
 	}, []);
 	return time;
 }
-function PosTopBar({ userName, onNewSale, onOpenHistory, onOpenHelp, onOpenPrinterSettings }) {
+function PosTopBar({ userName, actions, onNewSale, onOpenHistory, onOpenHelp, onOpenPrinterSettings }) {
 	const selectedBranch = usePosBranch();
 	const { onNavigate } = usePosRuntime();
 	const { state, dispatch } = usePosContext();
@@ -105,15 +105,15 @@ function PosTopBar({ userName, onNewSale, onOpenHistory, onOpenHelp, onOpenPrint
 					})
 				]
 			}),
-			/* @__PURE__ */ jsx("div", {
+			/* @__PURE__ */ jsxs("div", {
 				className: "flex-1 flex items-center justify-center gap-1 px-4",
-				children: state.screen === "products" && onNewSale && /* @__PURE__ */ jsxs(Button, {
+				children: [actions, state.screen === "products" && onNewSale && /* @__PURE__ */ jsxs(Button, {
 					variant: "ghost",
 					size: "sm",
 					onClick: onNewSale,
 					className: "h-8 text-xs gap-1",
 					children: [/* @__PURE__ */ jsx(Plus, { className: "h-3.5 w-3.5" }), "New Sale"]
-				})
+				})]
 			}),
 			/* @__PURE__ */ jsxs("div", {
 				className: "flex items-center gap-3 shrink-0",

package/dist/components/PrinterSettingsDialog.d.ts

@@ -0,0 +1,8 @@
+//#region src/components/PrinterSettingsDialog.d.ts
+interface PrinterSettingsDialogProps {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+}
+declare function PrinterSettingsDialog({ open, onOpenChange }: PrinterSettingsDialogProps): import("react").JSX.Element;
+//#endregion
+export { PrinterSettingsDialog };