@tallyui/components 3.5.3 → 3.7.0

package/dist/index.d.ts

@@ -8,7 +8,7 @@ import { VariantProps } from 'class-variance-authority';
 import { SvgProps } from 'react-native-svg';
 import { Separator as Separator$1, Label as Label$1, Tabs as Tabs$1, Dialog as Dialog$1, AlertDialog as AlertDialog$1, Select as Select$1, Combobox as Combobox$1, DropdownMenu as DropdownMenu$1, ContextMenu as ContextMenu$1, Popover as Popover$1, Tooltip as Tooltip$1, HoverCard as HoverCard$1, Accordion as Accordion$1, Collapsible as Collapsible$1, Checkbox as Checkbox$1, Switch as Switch$1, RadioGroup as RadioGroup$1, Toggle as Toggle$1, ToggleGroup as ToggleGroup$1, Progress as Progress$1, Slider as Slider$1, Image } from '@tallyui/primitives';
 export { TextClassContext } from '@tallyui/primitives';
-import { CatalogueView, ProductSortValue, ProductSort, useRegisterSession, MovementType, useSale, AppliedDiscount, Discount, CatalogueEntry, CatalogueViewState, SentOrder, PosOrder, OutboxState, ParkedOrderSummary } from '@tallyui/pos';
+import { CatalogueView, ProductSortValue, ProductSort, useRegisterSession, RegisterSession, MovementType, useSale, AppliedDiscount, Discount, CatalogueEntry, CatalogueViewState, SentOrder, PosOrder, OutboxState, ParkedOrderSummary } from '@tallyui/pos';
 import { ProductTraits, TraitContext, Money, CustomerTraits, Customer, CustomerInput, ProductCategory, SyncNotice, StoreSettingsChoices, StoreSettingsChoice } from '@tallyui/core';
 
 declare const textVariants: (props?: ({
@@ -1093,6 +1093,7 @@ declare function RegisterBar({ register, registerId, online, registerName, multi
  * register name (`multiRegister` decides whether that's shown at all) and the status pill.
  * Copy is plain English (no i18n keys, ADR-064's neutral-copy rule).
  */
+
 type RegisterBarPill = 'Choose a register' | 'Close not finished' | 'Offline' | 'Approval needed' | 'Counting' | 'Overdue' | 'Register closed';
 /**
  * Priority, matching WCPOS's ordering: choosing a register outranks everything (LEDGER 48);
@@ -1104,7 +1105,8 @@ declare function describeRegisterBarPill({ registerId, online, sessionStatus, ov
     /** The register this till is bound to, or `null` when it isn't bound yet. */
     registerId: string | null;
     online: boolean;
-    sessionStatus?: 'open' | 'counting' | 'closed' | null;
+    /** `conflict` and `superseded` (ADR-078 decision 9) get no pill of their own yet; step 3b decides theirs. */
+    sessionStatus?: RegisterSession['status'] | null;
     overdue?: boolean;
     approvalRequired?: boolean;
     /** The store uses register sessions at all (`useRegisterSession`'s `enabled`). */
@@ -1411,7 +1413,7 @@ declare function Catalogue<Doc>({ products, traits, currency, onSelect, statusTe
 
 /** `store`/`taxLabel`/`topInset`/`formatDate` replace the app's Medusa settings, hard-coded VAT (default matches
  * TV6a's `Cart`), outbox strip and date util, so `Receipt` stays platform-neutral (ADR-052). */
-declare function Receipt({ order, posOrder, store, cashier, registerId, newSale, taxLabel, topInset, formatDate }: {
+declare function Receipt({ order, posOrder, store, cashier, registerId, registerName, newSale, taxLabel, topInset, formatDate, footerSlot }: {
     order: SentOrder;
     store: {
         name: string;
@@ -1420,12 +1422,16 @@ declare function Receipt({ order, posOrder, store, cashier, registerId, newSale,
     cashier: string;
     registerId: string;
     newSale: () => void;
+    /** The register's name, printed as `Register: <name>`; the id is never printed. */
+    registerName?: string;
     /** The finalized order (useSale's receipt stage has it). With it the receipt prints its reference and time, the
      * same as Orders; without it (a preview before finalize) the sale id is marked as a draft. */
     posOrder?: PosOrder;
     taxLabel?: (ratePpm: number) => string;
     topInset?: number;
     formatDate?: (iso: string) => string;
+    /** Prints after the Change row and above the on-screen buttons (e.g. an app's register/software block). */
+    footerSlot?: ReactNode;
 }): react_jsx_runtime.JSX.Element;
 
 /** The order reference a visitor sees on the receipt and in Orders (front desk ruling, 2026-10-06): the finalized

package/dist/index.js

@@ -5021,17 +5021,20 @@ function Receipt({
   store,
   cashier,
   registerId,
+  registerName,
   newSale,
   taxLabel = (ratePpm) => `Tax ${ratePpm / 1e4}%`,
   topInset = 0,
-  formatDate = defaultFormatDate
+  formatDate = defaultFormatDate,
+  footerSlot
 }) {
   useEffect6(injectPrintStyle, []);
   const receipt = buildReceiptData3(order, {
     storeName: store.name,
     storeAddress: store.address,
     cashier,
-    register: registerId
+    register: registerId,
+    registerName
   });
   const money = (amount) => formatMoney16({ amount, currency: receipt.currency }) ?? "";
   const row = (label, amount, bold = false, key) => /* @__PURE__ */ jsxs56(View63, { accessibilityLabel: `${label}: ${amount}`, className: "flex-row justify-between gap-4", children: [
@@ -5052,6 +5055,10 @@ function Receipt({
         "Cashier: ",
         receipt.header.cashier
       ] }),
+      receipt.register.name ? /* @__PURE__ */ jsxs56(Text41, { testID: "receipt-register", className: "text-muted-foreground", children: [
+        "Register: ",
+        receipt.register.name
+      ] }) : null,
       receipt.header.customer && /* @__PURE__ */ jsxs56(Text41, { className: "text-muted-foreground", children: [
         "Customer: ",
         receipt.header.customer
@@ -5078,6 +5085,7 @@ function Receipt({
         index
       )),
       row("Change", money(receipt.changeDueMinor)),
+      footerSlot ? /* @__PURE__ */ jsx98(View63, { testID: "receipt-footer", className: "mt-3 items-center border-t border-dashed border-border pt-3", children: footerSlot }) : null,
       /* @__PURE__ */ jsxs56(View63, { dataSet: { print: "hide" }, className: "flex-row gap-4", children: [
         /* @__PURE__ */ jsx98(Pressable33, { accessibilityRole: "button", onPress: () => {
           if (typeof window !== "undefined" && typeof window.print === "function") window.print();
@@ -5277,7 +5285,7 @@ function OrdersList({ orders, onRetry, formatDate = defaultFormatDate2, footer,
               setRetryingIds(new Set(retrying.current));
             }
           }, className: "rounded-md bg-primary px-4 py-2", children: /* @__PURE__ */ jsx100(Text43, { className: "text-center font-semibold text-primary-foreground", children: "Retry" }) }) : null,
-          knownWarnings(order.warnings).map((warning, index) => /* @__PURE__ */ jsx100(View65, { className: "border-l-4 border-warning pl-2", children: /* @__PURE__ */ jsx100(Text43, { className: "text-foreground", children: warning.code === "insufficient_stock" ? `${warning.quantity} sold without stock: ${order.lines.find((line) => line.variantId === warning.variantId)?.name}` : warning.code === "tax_rate_mismatch" ? `Tax at ${(warning.ratePpm / 1e4).toLocaleString(void 0, { maximumFractionDigits: 4 })}%: store ${formatMoney17({ amount: warning.serverMinor, currency: order.currency })} vs POS ${formatMoney17({ amount: warning.expectedMinor, currency: order.currency })}` : warning.code === "customer_ignored" ? `The online store didn't recognise the customer on this sale, so it was saved as a guest sale. Customer id: ${warning.customerId}.` : warning.code === "figures_mismatch" ? `The online store worked out different figures for this sale. ${warning.fields.map(({ field, tillMinor, serverMinor }) => `${FIGURE_LABELS.get(field) ?? field}: till ${formatMoney17({ amount: tillMinor, currency: order.currency })}, store ${formatMoney17({ amount: serverMinor, currency: order.currency })}.`).join(" ")}` : warning.bridgeMinor !== void 0 ? `Store calculated ${formatMoney17({ amount: warning.serverMinor, currency: order.currency })}; a rounding line of ${warning.bridgeMinor > 0 ? "+" : ""}${formatMoney17({ amount: warning.bridgeMinor, currency: order.currency })} brought it to ${formatMoney17({ amount: warning.expectedMinor, currency: order.currency })}` : `Store total ${formatMoney17({ amount: warning.serverMinor, currency: order.currency })} vs POS ${formatMoney17({ amount: warning.expectedMinor, currency: order.currency })}` }) }, index))
+          knownWarnings(order.warnings).filter((warning) => warning.code !== "register_session_unknown").map((warning, index) => /* @__PURE__ */ jsx100(View65, { className: "border-l-4 border-warning pl-2", children: /* @__PURE__ */ jsx100(Text43, { className: "text-foreground", children: warning.code === "insufficient_stock" ? `${warning.quantity} sold without stock: ${order.lines.find((line) => line.variantId === warning.variantId)?.name}` : warning.code === "tax_rate_mismatch" ? `Tax at ${(warning.ratePpm / 1e4).toLocaleString(void 0, { maximumFractionDigits: 4 })}%: store ${formatMoney17({ amount: warning.serverMinor, currency: order.currency })} vs POS ${formatMoney17({ amount: warning.expectedMinor, currency: order.currency })}` : warning.code === "customer_ignored" ? `The online store didn't recognise the customer on this sale, so it was saved as a guest sale. Customer id: ${warning.customerId}.` : warning.code === "figures_mismatch" ? `The online store worked out different figures for this sale. ${warning.fields.map(({ field, tillMinor, serverMinor }) => `${FIGURE_LABELS.get(field) ?? field}: till ${formatMoney17({ amount: tillMinor, currency: order.currency })}, store ${formatMoney17({ amount: serverMinor, currency: order.currency })}.`).join(" ")}` : warning.bridgeMinor !== void 0 ? `Store calculated ${formatMoney17({ amount: warning.serverMinor, currency: order.currency })}; a rounding line of ${warning.bridgeMinor > 0 ? "+" : ""}${formatMoney17({ amount: warning.bridgeMinor, currency: order.currency })} brought it to ${formatMoney17({ amount: warning.expectedMinor, currency: order.currency })}` : `Store total ${formatMoney17({ amount: warning.serverMinor, currency: order.currency })} vs POS ${formatMoney17({ amount: warning.expectedMinor, currency: order.currency })}` }) }, index))
         ] }, order.id);
       })
     ] }, section.title)),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tallyui/components",
-  "version": "3.5.3",
+  "version": "3.7.0",
   "type": "module",
   "description": "Universal POS UI components for Tally UI",
   "main": "./dist/index.js",
@@ -27,22 +27,22 @@
     "directory": "packages/components"
   },
   "peerDependencies": {
-    "@tallyui/core": "^3.5.3",
-    "@tallyui/primitives": "^3.5.3",
-    "@tallyui/theme": "^3.5.3",
+    "@tallyui/core": "^3.7.0",
+    "@tallyui/primitives": "^3.7.0",
+    "@tallyui/theme": "^3.7.0",
     "react": ">=18",
     "react-native": ">=0.74",
     "react-native-svg": ">=15"
   },
   "dependencies": {
     "class-variance-authority": "^0.7.1",
-    "@tallyui/pos": "3.5.3"
+    "@tallyui/pos": "3.7.0"
   },
   "devDependencies": {
-    "@tallyui/connector-medusa": "3.5.3",
-    "@tallyui/connector-vendure": "3.5.3",
-    "@tallyui/connector-woocommerce": "3.5.3",
-    "@tallyui/mock-api": "3.5.3",
+    "@tallyui/connector-medusa": "3.7.0",
+    "@tallyui/connector-vendure": "3.7.0",
+    "@tallyui/connector-woocommerce": "3.7.0",
+    "@tallyui/mock-api": "3.7.0",
     "@types/react": ">=18",
     "react": "^19.2.4",
     "react-native-svg": "15.12.1",

package/src/register/register-bar.helpers.ts

@@ -11,6 +11,8 @@
  * Copy is plain English (no i18n keys, ADR-064's neutral-copy rule).
  */
 
+import type { RegisterSession } from '@tallyui/pos';
+
 export type RegisterBarPill =
   | 'Choose a register'
   | 'Close not finished'
@@ -38,7 +40,8 @@ export function describeRegisterBarPill({
   /** The register this till is bound to, or `null` when it isn't bound yet. */
   registerId: string | null;
   online: boolean;
-  sessionStatus?: 'open' | 'counting' | 'closed' | null;
+  /** `conflict` and `superseded` (ADR-078 decision 9) get no pill of their own yet; step 3b decides theirs. */
+  sessionStatus?: RegisterSession['status'] | null;
   overdue?: boolean;
   approvalRequired?: boolean;
   /** The store uses register sessions at all (`useRegisterSession`'s `enabled`). */

package/src/sale/orders-list.tsx

@@ -105,7 +105,7 @@ export function OrdersList({ orders, onRetry, formatDate = defaultFormatDate, fo
               }} className="rounded-md bg-primary px-4 py-2">
                 <Text className="text-center font-semibold text-primary-foreground">Retry</Text>
               </Pressable> : null}
-            {knownWarnings(order.warnings).map((warning, index) => <View key={index} className="border-l-4 border-warning pl-2"><Text className="text-foreground">
+            {knownWarnings(order.warnings).filter((warning) => warning.code !== 'register_session_unknown').map((warning, index) => <View key={index} className="border-l-4 border-warning pl-2"><Text className="text-foreground">
               {warning.code === 'insufficient_stock'
                 ? `${warning.quantity} sold without stock: ${order.lines.find((line) => line.variantId === warning.variantId)?.name}`
                 : warning.code === 'tax_rate_mismatch'

package/src/sale/receipt.tsx

@@ -1,4 +1,4 @@
-import { useEffect } from 'react';
+import { useEffect, type ReactNode } from 'react';
 import { Pressable, Text, View } from 'react-native';
 import { formatMoney } from '@tallyui/core';
 import { buildReceiptData, type SentOrder } from '@tallyui/pos';
@@ -11,17 +11,21 @@ const defaultFormatDate = (iso: string) => new Intl.DateTimeFormat(undefined, {
 
 /** `store`/`taxLabel`/`topInset`/`formatDate` replace the app's Medusa settings, hard-coded VAT (default matches
  * TV6a's `Cart`), outbox strip and date util, so `Receipt` stays platform-neutral (ADR-052). */
-export function Receipt({ order, posOrder, store, cashier, registerId, newSale, taxLabel = (ratePpm: number) => `Tax ${ratePpm / 10000}%`,
-  topInset = 0, formatDate = defaultFormatDate }: {
+export function Receipt({ order, posOrder, store, cashier, registerId, registerName, newSale, taxLabel = (ratePpm: number) => `Tax ${ratePpm / 10000}%`,
+  topInset = 0, formatDate = defaultFormatDate, footerSlot }: {
   order: SentOrder; store: { name: string; address?: string }; cashier: string; registerId: string; newSale: () => void;
+  /** The register's name, printed as `Register: <name>`; the id is never printed. */
+  registerName?: string;
   /** The finalized order (useSale's receipt stage has it). With it the receipt prints its reference and time, the
    * same as Orders; without it (a preview before finalize) the sale id is marked as a draft. */
   posOrder?: PosOrder;
   taxLabel?: (ratePpm: number) => string; topInset?: number; formatDate?: (iso: string) => string;
+  /** Prints after the Change row and above the on-screen buttons (e.g. an app's register/software block). */
+  footerSlot?: ReactNode;
 }) {
   useEffect(injectPrintStyle, []);
   const receipt = buildReceiptData(order, {
-    storeName: store.name, storeAddress: store.address, cashier, register: registerId,
+    storeName: store.name, storeAddress: store.address, cashier, register: registerId, registerName,
   });
   const money = (amount: number) => formatMoney({ amount, currency: receipt.currency }) ?? '';
   const row = (label: string, amount: string, bold = false, key?: number) => <View key={key} accessibilityLabel={`${label}: ${amount}`} className="flex-row justify-between gap-4">
@@ -40,6 +44,7 @@ export function Receipt({ order, posOrder, store, cashier, registerId, newSale,
     <Text testID="receipt-order" className="text-foreground">{posOrder ? `Order ${orderReference(posOrder)}` : `Order ${receipt.header.orderNumber.slice(-8)} (draft)`}</Text>
     <Text className="text-muted-foreground">{formatDate(posOrder?.createdAt ?? receipt.header.date)}</Text>
     <Text className="text-muted-foreground">Cashier: {receipt.header.cashier}</Text>
+    {receipt.register.name ? <Text testID="receipt-register" className="text-muted-foreground">Register: {receipt.register.name}</Text> : null}
     {receipt.header.customer && <Text className="text-muted-foreground">Customer: {receipt.header.customer}</Text>}
     {receipt.lineItems.map((line, index) => <View key={index}>
       <Text className="text-foreground">{line.name}</Text>
@@ -61,6 +66,7 @@ export function Receipt({ order, posOrder, store, cashier, registerId, newSale,
     {receipt.payments.map((payment, index) => row(payment.method === 'cash' ? 'Cash tendered' : 'Card terminal',
       money(payment.amountMinor) + (payment.reference ? ` · ${payment.reference}` : ''), false, index))}
     {row('Change', money(receipt.changeDueMinor))}
+    {footerSlot ? <View testID="receipt-footer" className="mt-3 items-center border-t border-dashed border-border pt-3">{footerSlot}</View> : null}
     <View dataSet={{ print: 'hide' }} className="flex-row gap-4">
       <Pressable accessibilityRole="button" onPress={() => { if (typeof window !== 'undefined' && typeof window.print === 'function') window.print(); }} className="rounded-md border border-border bg-card px-4 py-3">
         <Text className="text-center text-foreground">Print receipt</Text>