@tallyui/pos 3.3.0 → 3.5.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { Money, TaxRounding, StoreSettings, TallyConnector, SyncContext, StoreSettingsChoice, StoreSettingsChoices, ProductTraits, OrderCreateLine, PaymentMethodKind, CommandServerRefs, CommandWarning, CommandError, ServerCapabilities, OrderCreateEnvelope, RegisterCommandType, RegisterCommandResult, VariantSummary, TraitContext, CommandResult, AnyCommandEnvelope, CommandEnvelope, OrderCreatePayload, RegisterCommandEnvelope } from '@tallyui/core';
+import { Money, TaxRounding, StoreSettings, TallyConnector, SyncContext, StoreSettingsChoice, StoreSettingsChoices, ProductTraits, ProductCategory, TraitContext, OrderCreateLine, PaymentMethodKind, CommandServerRefs, CommandWarning, CommandError, ServerCapabilities, OrderCreateEnvelope, RegisterCommandType, RegisterCommandResult, VariantSummary, CommandResult, AnyCommandEnvelope, CommandEnvelope, OrderCreatePayload, RegisterCommandEnvelope } from '@tallyui/core';
 export { getProductStock, withStockOverlay } from '@tallyui/core';
 export { countFresh, readFresh, watchFresh } from '@tallyui/core/rxdb';
 import * as rxdb from 'rxdb';
@@ -125,6 +125,8 @@ type TaxRateMap = {
     [taxClass: string]: number;
 };
 interface TaxContext {
+    shippingTaxClass?: string;
+    taxClassSlugs?: readonly string[];
     getTaxRates?(taxClass?: string, options?: {
         shipping?: boolean;
     }): readonly WooRate[];
@@ -148,7 +150,7 @@ interface TaxProviderProps extends Pick<StoreSettings, 'taxRoundAtSubtotal' | 's
     rateCodes?: Record<string, string>;
     children: ReactNode;
 }
-declare function TaxProvider({ ratesPpm, pricesIncludeTax, rounding, rateCodes, taxRates, children }: TaxProviderProps): react_jsx_runtime.JSX.Element;
+declare function TaxProvider({ ratesPpm, pricesIncludeTax, rounding, rateCodes, taxRates, shippingTaxClass, taxClassSlugs, children }: TaxProviderProps): react_jsx_runtime.JSX.Element;
 declare function useTax(): TaxContext;
 
 type StoreSettingsResolution = {
@@ -616,6 +618,53 @@ declare function buildReceiptData(order: SentOrder, config: ReceiptConfig): Rece
  */
 declare function searchProducts<Doc>(docs: Doc[], term: string, traits: ProductTraits<Doc>): Doc[];
 
+/** The product's categories: `getCategories`, else `getCategoryNames` with each name as its id. */
+declare function productCategories<Doc>(doc: Doc, traits: ProductTraits<Doc>): ProductCategory[];
+/** Every category across `docs`, once per id (the first name seen wins), sorted by name (natural, case-insensitive), ties by id. */
+declare function listCategories<Doc>(docs: readonly Doc[], traits: ProductTraits<Doc>): ProductCategory[];
+/** Whether `doc` is in the category with this id. */
+declare function inCategory<Doc>(doc: Doc, categoryId: string, traits: ProductTraits<Doc>): boolean;
+
+/** A sort on one field: ascending or descending. */
+interface ProductSort {
+    field: string;
+    dir: 'asc' | 'desc';
+}
+type ProductSortValue = string | number | undefined;
+/** The fields productSortValue knows, in the default column order. */
+declare const PRODUCT_SORT_FIELDS: readonly ["name", "sku", "barcode", "price", "stock", "category"];
+declare function productSortValue<Doc>(doc: Doc, field: string, traits: ProductTraits<Doc>, context?: TraitContext): ProductSortValue;
+declare function sortProducts<Doc>(docs: Doc[], sort: ProductSort | null | undefined, valueOf: (doc: Doc, field: string) => ProductSortValue): Doc[];
+
+type CatalogueView = 'grid' | 'table';
+type CatalogueGridColumns = 'auto' | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+interface CatalogueViewState {
+    view: CatalogueView;
+    gridColumns: CatalogueGridColumns;
+    sort: ProductSort | null;
+    categoryId: string | null;
+}
+declare const DEFAULT_CATALOGUE_VIEW_STATE: CatalogueViewState;
+type CatalogueViewAction = {
+    type: 'setView';
+    view: CatalogueView;
+} | {
+    type: 'setGridColumns';
+    gridColumns: CatalogueGridColumns;
+} | {
+    type: 'setSort';
+    sort: ProductSort | null;
+} | {
+    type: 'setCategory';
+    categoryId: string | null;
+} | {
+    type: 'replace';
+    state: CatalogueViewState;
+};
+declare function catalogueViewReducer(state: CatalogueViewState, action: CatalogueViewAction): CatalogueViewState;
+declare function normalizeCatalogueViewState(raw: unknown, defaults?: CatalogueViewState): CatalogueViewState;
+declare function resolveGridColumns(gridColumns: CatalogueGridColumns, containerWidth: number): number;
+
 /** The `stock_levels` collection as a live map of key to stock value. */
 declare function stockOverlay$(collection: RxCollection): Observable<Map<string, unknown>>;
 /**
@@ -1957,6 +2006,9 @@ declare function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
     stage: SaleStage;
     error: string | null;
     idle: boolean;
+    /** The store's capabilities as passed in: a component offers fees, shipping and custom lines
+     * only when `orderCreate >= 5`, and their tax status and class only as `lineTax` allows. */
+    capabilities: ServerCapabilities | undefined;
     /** A completion is pending (see `complete()`): the sale is locked, and the UI offers Retry. */
     saving: boolean;
     /** The failed save's order is confirmed stored (see `isStored`): the UI also offers Continue (`continueSale()`). */
@@ -2444,4 +2496,4 @@ declare function planLegs(plan: TenderPlan, rowsSinceFrom: {
     };
 };
 
-export { type Actor, type AddLineInput, type AppliedDiscount, type BackendNotFound, type BasketLine, CartError, type CashMovement, type CashMovementCollection, type CatalogueEntry, type ChargeInput, type ChargeLine, type Closure, type ClosureCollection, type ClosureContext, type ClosureScope, type CommandTransport, type Correction, CurrencyProvider, type CurrencyProviderProps, type CustomerSummary, DISCOUNTS_UNSUPPORTED, type Discount, type DisplayLine, type DisplayTotals, type FeeLine, type FinalizeOptions, type HttpTransportOptions, type LedgerRow, type LineItem, type LineTaxLine, type LogEntry, type LogLevel, type LogSink, type Logger, MAX_TENDER_MINOR, MICROS_PER_MINOR, type Movement$1 as Movement, type MovementType, type Order, type OrderBuilder, type OrderBuilderOptions, OrderContentMismatchError, type OrderManager, type OrderManagerOptions, type OrderOutbox, type OrderOutboxOptions, type OrderTaxTotals, type OrderTransportContext, type OutboxState, type ParkedOrderSummary, type Payment, type PaymentMethod, type PaymentTransport, type PlanLeg, type PosOrder, type PosOrderLine, type PosOrderLocalWarning, PosOrderOpenClosedError, type PosOrderPayment, type PosOrderServerFailures, type PosOrderSyncStatus, type RateTaxLine, type ReceiptConfig, type ReceiptData, type ReceiptLineItem, type RecordedFigures, RegisterApprovalRequiredError, type RegisterBucket, RegisterCloseIncompleteError, type RegisterCommand, type RegisterCommandCollection, type RegisterCounters, type RegisterDocument, type RegisterFact, type RegisterHost, RegisterIdInvalidError, RegisterMovementAmountError, RegisterMovementReasonError, RegisterMovementStrandedError, type RegisterOutbox, type RegisterOutboxOptions, type RegisterSession, RegisterSessionAlreadyOpenError, RegisterSessionClosedError, type RegisterSessionCollection, RegisterSessionRequiredError, type RegisterStore, RegisterTenderInProgressError, type Repository, type ResolveStoreSettingsOptions, SALE_SAVING, type SaleStage, type SentOrder, type ShippingLine, type SplitTab, type StoreSettingsResolution, type StoreSettingsState, TAX_ROUNDING_MIXED_NOTE, type TaxContext, type TaxLineInput, TaxProvider, type TaxProviderProps, type TaxRateMap, type TenderAction, type TenderKey, type TenderLineId, type TenderPlan, type TenderState, type TenderView, type TransportOutcome, UnsupportedOrderVersionError, type UseOrderOutboxOptions, type UseOrderOutboxResult, type UseRegisterOutboxOptions, type UseRegisterOutboxResult, type UseRegisterSessionOptions, activePlan, addEntryToCart, addPosOrderCollection, advancePerpetual, allocateOrderDiscount, appliedMinor, backToSelling, bindRegister, buildClosureDocument, buildReceiptData, buildXReportDocument, callbackSink, cashMovementSchema, catalogueEntries, changeMinor, clampClosureScope, closeNeedsApproval, closeSession, closureCommand, closureSchema, computeOrderTax, consoleSink, countVariance, createBackendNotFound, createHttpCommandTransport, createLogger, createOrderBuilder, createOrderManager, createOrderOutbox, createRegisterOutbox, createRepository, denominationTotal, denominations, deriveExpected, deriveSettled, ensureRegister, evenSplitShareMinor, exportCsv, finalizeOrder, findEntryByCode, formatClosureDate, getBoundRegisterId, getDeviceId, initTenderState, initialTenderState, isServerDecimal, labelKeys, minorToDecimal, mintClosureNumber, mintUuid, movementCommand, movementFieldError, needsAttention, nextSaleCounter, normalizeAmount, observeRegister$, openSession, openSessionSelector, orderDraftSchema, outboxLogger, overThreshold, parkedOrderSummaries$, parseMinor, planLegs, posOrderCollection, posOrderSchema, posOrdersLogger, quickTenderedAmounts, ratePpmFromPercent, readBoundRegister, readRegister, reconcileRegisterCommands, recordMovement, recordRegisterFact, registerCommandCollection, registerCommandSchema, registerCommandsLogger, registerFactsLogger, registerSessionCollection, registerSessionSchema, requireOpenSession, resolveStoreSettings, restoreOrderDraft, roundMicrosToMinor, saleLogger, sameSale, searchProducts, selectClosureRows, sessionOpenCommand, sessionTransitionCommand, stampSession, startCounting, stockOverlay$, stockOverlayAsOf$, taxFiguresForBasket, taxLinesByRate, taxLogger, taxMicros, taxProviderProps, tenderReducer, toOrderCreateEnvelope, unbindRegister, useCurrencyCode, useCurrencyFormatter, useOrderOutbox, useParkedSales, useRegisterOutbox, useRegisterSession, useSale, useStoreSettings, useTax, uuidv7, validAmount, varianceText, variantPriceLabel, voidMovement, withPricingContext, writeClosure, writeOrderDraft };
+export { type Actor, type AddLineInput, type AppliedDiscount, type BackendNotFound, type BasketLine, CartError, type CashMovement, type CashMovementCollection, type CatalogueEntry, type CatalogueGridColumns, type CatalogueView, type CatalogueViewAction, type CatalogueViewState, type ChargeInput, type ChargeLine, type Closure, type ClosureCollection, type ClosureContext, type ClosureScope, type CommandTransport, type Correction, CurrencyProvider, type CurrencyProviderProps, type CustomerSummary, DEFAULT_CATALOGUE_VIEW_STATE, DISCOUNTS_UNSUPPORTED, type Discount, type DisplayLine, type DisplayTotals, type FeeLine, type FinalizeOptions, type HttpTransportOptions, type LedgerRow, type LineItem, type LineTaxLine, type LogEntry, type LogLevel, type LogSink, type Logger, MAX_TENDER_MINOR, MICROS_PER_MINOR, type Movement$1 as Movement, type MovementType, type Order, type OrderBuilder, type OrderBuilderOptions, OrderContentMismatchError, type OrderManager, type OrderManagerOptions, type OrderOutbox, type OrderOutboxOptions, type OrderTaxTotals, type OrderTransportContext, type OutboxState, PRODUCT_SORT_FIELDS, type ParkedOrderSummary, type Payment, type PaymentMethod, type PaymentTransport, type PlanLeg, type PosOrder, type PosOrderLine, type PosOrderLocalWarning, PosOrderOpenClosedError, type PosOrderPayment, type PosOrderServerFailures, type PosOrderSyncStatus, type ProductSort, type ProductSortValue, type RateTaxLine, type ReceiptConfig, type ReceiptData, type ReceiptLineItem, type RecordedFigures, RegisterApprovalRequiredError, type RegisterBucket, RegisterCloseIncompleteError, type RegisterCommand, type RegisterCommandCollection, type RegisterCounters, type RegisterDocument, type RegisterFact, type RegisterHost, RegisterIdInvalidError, RegisterMovementAmountError, RegisterMovementReasonError, RegisterMovementStrandedError, type RegisterOutbox, type RegisterOutboxOptions, type RegisterSession, RegisterSessionAlreadyOpenError, RegisterSessionClosedError, type RegisterSessionCollection, RegisterSessionRequiredError, type RegisterStore, RegisterTenderInProgressError, type Repository, type ResolveStoreSettingsOptions, SALE_SAVING, type SaleStage, type SentOrder, type ShippingLine, type SplitTab, type StoreSettingsResolution, type StoreSettingsState, TAX_ROUNDING_MIXED_NOTE, type TaxContext, type TaxLineInput, TaxProvider, type TaxProviderProps, type TaxRateMap, type TenderAction, type TenderKey, type TenderLineId, type TenderPlan, type TenderState, type TenderView, type TransportOutcome, UnsupportedOrderVersionError, type UseOrderOutboxOptions, type UseOrderOutboxResult, type UseRegisterOutboxOptions, type UseRegisterOutboxResult, type UseRegisterSessionOptions, activePlan, addEntryToCart, addPosOrderCollection, advancePerpetual, allocateOrderDiscount, appliedMinor, backToSelling, bindRegister, buildClosureDocument, buildReceiptData, buildXReportDocument, callbackSink, cashMovementSchema, catalogueEntries, catalogueViewReducer, changeMinor, clampClosureScope, closeNeedsApproval, closeSession, closureCommand, closureSchema, computeOrderTax, consoleSink, countVariance, createBackendNotFound, createHttpCommandTransport, createLogger, createOrderBuilder, createOrderManager, createOrderOutbox, createRegisterOutbox, createRepository, denominationTotal, denominations, deriveExpected, deriveSettled, ensureRegister, evenSplitShareMinor, exportCsv, finalizeOrder, findEntryByCode, formatClosureDate, getBoundRegisterId, getDeviceId, inCategory, initTenderState, initialTenderState, isServerDecimal, labelKeys, listCategories, minorToDecimal, mintClosureNumber, mintUuid, movementCommand, movementFieldError, needsAttention, nextSaleCounter, normalizeAmount, normalizeCatalogueViewState, observeRegister$, openSession, openSessionSelector, orderDraftSchema, outboxLogger, overThreshold, parkedOrderSummaries$, parseMinor, planLegs, posOrderCollection, posOrderSchema, posOrdersLogger, productCategories, productSortValue, quickTenderedAmounts, ratePpmFromPercent, readBoundRegister, readRegister, reconcileRegisterCommands, recordMovement, recordRegisterFact, registerCommandCollection, registerCommandSchema, registerCommandsLogger, registerFactsLogger, registerSessionCollection, registerSessionSchema, requireOpenSession, resolveGridColumns, resolveStoreSettings, restoreOrderDraft, roundMicrosToMinor, saleLogger, sameSale, searchProducts, selectClosureRows, sessionOpenCommand, sessionTransitionCommand, sortProducts, stampSession, startCounting, stockOverlay$, stockOverlayAsOf$, taxFiguresForBasket, taxLinesByRate, taxLogger, taxMicros, taxProviderProps, tenderReducer, toOrderCreateEnvelope, unbindRegister, useCurrencyCode, useCurrencyFormatter, useOrderOutbox, useParkedSales, useRegisterOutbox, useRegisterSession, useSale, useStoreSettings, useTax, uuidv7, validAmount, varianceText, variantPriceLabel, voidMovement, withPricingContext, writeClosure, writeOrderDraft };

package/dist/index.js

@@ -327,7 +327,7 @@ import { woocommerceTax as woocommerceTax2 } from "@tallyui/core";
 import { jsx as jsx2 } from "react/jsx-runtime";
 var taxLogger = createLogger("tax");
 var TaxCtx = createContext2(null);
-function TaxProvider({ ratesPpm, pricesIncludeTax, rounding, rateCodes, taxRates, children }) {
+function TaxProvider({ ratesPpm, pricesIncludeTax, rounding, rateCodes, taxRates, shippingTaxClass, taxClassSlugs, children }) {
   const value = useMemo2(
     () => {
       if (Object.values(ratesPpm).some((rate) => !Number.isSafeInteger(rate) || rate < 0)) {
@@ -350,10 +350,12 @@ function TaxProvider({ ratesPpm, pricesIncludeTax, rounding, rateCodes, taxRates
           return rateCodes && Object.hasOwn(rateCodes, key) ? rateCodes[key] : void 0;
         },
         pricesIncludeTax,
-        ...rounding ? { rounding } : {}
+        ...rounding ? { rounding } : {},
+        ...shippingTaxClass !== void 0 ? { shippingTaxClass } : {},
+        ...taxClassSlugs !== void 0 ? { taxClassSlugs } : {}
       };
     },
-    [ratesPpm, pricesIncludeTax, rounding, rateCodes, taxRates]
+    [ratesPpm, pricesIncludeTax, rounding, rateCodes, taxRates, shippingTaxClass, taxClassSlugs]
   );
   return /* @__PURE__ */ jsx2(TaxCtx.Provider, { value, children });
 }
@@ -554,7 +556,7 @@ function createRepository(collection) {
 
 // src/order/order-builder.ts
 import { BehaviorSubject } from "rxjs";
-import { resolvePrice } from "@tallyui/core";
+import { resolvePrice, woocommerceTax as woocommerceTax3 } from "@tallyui/core";
 
 // src/order/allocate-order-discount.ts
 function allocateOrderDiscount(lineAmountsMinor, totalMinor) {
@@ -682,6 +684,7 @@ function createOrderBuilder(options) {
     });
     const shares = allocateOrderDiscount(lineAmounts, recalcedOrderDiscounts.reduce((sum, d) => sum + d.amountMinor, 0));
     const lines = lineItems.map((li, index) => recalculateLine(li, shares[index]));
+    if (woo) shipping = shipping.map((charge) => ({ ...charge, ...recalculateCharge(charge.id, charge, true) }));
     const wooTotals = woo ? woocommerceTotals(lines, fees, shipping, currency, woo.roundAtSubtotal, taxContext.pricesIncludeTax) : void 0;
     const { subtotalMinor } = wooTotals ?? sumLines(lines, taxContext.rounding);
     const charges = [...fees, ...shipping];
@@ -799,7 +802,18 @@ function createOrderBuilder(options) {
     if (!input.name.trim()) throw new RangeError("Name must not be empty");
     const taxStatus = input.taxStatus ?? "taxable";
     if (woo) {
-      const line2 = wooLine(input.amountMinor, input.taxClass, taxContext.pricesIncludeTax, taxStatus === "none", shipping2);
+      const taxClass = shipping2 ? taxContext.shippingTaxClass === void 0 || taxContext.shippingTaxClass === "inherit" ? woocommerceTax3.resolveInheritedShippingTaxClass(lineItems.map((line3) => ({
+        tax_class: line3.taxClass,
+        taxable: line3.taxStatus !== "none"
+      })), taxContext.taxClassSlugs ?? []) : taxContext.shippingTaxClass : input.taxClass;
+      const untaxed = shipping2 ? taxClass === woocommerceTax3.NO_SHIPPING_TAX : taxStatus === "none";
+      const line2 = wooLine(
+        input.amountMinor,
+        taxClass === woocommerceTax3.NO_SHIPPING_TAX ? void 0 : taxClass,
+        taxContext.pricesIncludeTax,
+        untaxed,
+        shipping2
+      );
       return {
         id: id2,
         name: input.name,
@@ -1440,6 +1454,110 @@ function searchProducts(docs, term, traits) {
   });
 }
 
+// src/product/categories.ts
+function productCategories(doc, traits) {
+  return traits.getCategories ? traits.getCategories(doc) : traits.getCategoryNames(doc).map((name) => ({ id: name, name }));
+}
+function listCategories(docs, traits) {
+  const categories = /* @__PURE__ */ new Map();
+  for (const doc of docs) {
+    for (const category of productCategories(doc, traits)) {
+      if (!categories.has(category.id)) categories.set(category.id, category);
+    }
+  }
+  return [...categories.values()].sort((a, b) => a.name.localeCompare(b.name, void 0, { numeric: true, sensitivity: "base" }) || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+}
+function inCategory(doc, categoryId, traits) {
+  return productCategories(doc, traits).some((category) => category.id === categoryId);
+}
+
+// src/product/catalogue-view-state.ts
+var DEFAULT_CATALOGUE_VIEW_STATE = Object.freeze({
+  view: "grid",
+  gridColumns: "auto",
+  sort: null,
+  categoryId: null
+});
+function catalogueViewReducer(state, action) {
+  switch (action.type) {
+    case "setView":
+      return state.view === action.view ? state : { ...state, view: action.view };
+    case "setGridColumns":
+      return state.gridColumns === action.gridColumns ? state : { ...state, gridColumns: action.gridColumns };
+    case "setCategory":
+      return state.categoryId === action.categoryId ? state : { ...state, categoryId: action.categoryId };
+    case "setSort":
+      return state.sort?.field === action.sort?.field && state.sort?.dir === action.sort?.dir ? state : { ...state, sort: action.sort };
+    case "replace":
+      return action.state;
+  }
+}
+function normalizeCatalogueViewState(raw, defaults = DEFAULT_CATALOGUE_VIEW_STATE) {
+  if (typeof raw !== "object" || raw === null) return defaults;
+  try {
+    const { view, gridColumns, sort, categoryId } = raw;
+    const candidate = sort;
+    return {
+      categoryId: categoryId === null || typeof categoryId === "string" && categoryId.length > 0 ? categoryId : defaults.categoryId,
+      view: view === "grid" || view === "table" ? view : defaults.view,
+      gridColumns: gridColumns === "auto" || typeof gridColumns === "number" && Number.isInteger(gridColumns) && gridColumns >= 2 && gridColumns <= 8 ? gridColumns : defaults.gridColumns,
+      sort: sort === null ? null : typeof candidate === "object" && candidate && typeof candidate.field === "string" && candidate.field.length > 0 && (candidate.dir === "asc" || candidate.dir === "desc") ? { field: candidate.field, dir: candidate.dir } : defaults.sort
+    };
+  } catch {
+    return defaults;
+  }
+}
+var MIN_TILE_WIDTH = 160;
+function resolveGridColumns(gridColumns, containerWidth) {
+  return gridColumns === "auto" ? Math.max(2, Math.min(6, Math.floor((containerWidth - 8) / (MIN_TILE_WIDTH + 8)))) : gridColumns;
+}
+
+// src/product/sort-products.ts
+import { resolvePrice as resolvePrice2, resolvePriceRange } from "@tallyui/core";
+var PRODUCT_SORT_FIELDS = ["name", "sku", "barcode", "price", "stock", "category"];
+function productSortValue(doc, field, traits, context) {
+  let value;
+  switch (field) {
+    case "name":
+      value = traits.getName(doc);
+      break;
+    case "sku":
+      value = traits.getSku(doc);
+      break;
+    case "barcode":
+      value = traits.getBarcode(doc);
+      break;
+    case "price": {
+      const variants = traits.getVariants?.(doc, context);
+      value = variants && variants.length >= 2 ? resolvePriceRange(variants, context?.currency)?.min.amount : resolvePrice2(traits.getPrices(doc, context), context?.currency)?.current.amount;
+      break;
+    }
+    case "stock":
+      value = traits.getStock(doc).quantity;
+      break;
+    case "category":
+      value = traits.getCategoryNames(doc).join(", ");
+      break;
+    default:
+      return void 0;
+  }
+  return value === "" ? void 0 : value;
+}
+function sortProducts(docs, sort, valueOf) {
+  if (!sort) return docs;
+  return docs.map((doc, index) => ({ doc, index, value: valueOf(doc, sort.field) })).sort((a, b) => {
+    const aMissing = a.value === void 0 || a.value === "";
+    const bMissing = b.value === void 0 || b.value === "";
+    if (aMissing || bMissing) {
+      return aMissing === bMissing ? a.index - b.index : aMissing ? 1 : -1;
+    }
+    const av = a.value;
+    const bv = b.value;
+    const comparison = typeof av === "number" ? typeof bv === "number" ? av - bv : -1 : typeof bv === "number" ? 1 : av.localeCompare(bv, void 0, { numeric: true, sensitivity: "base" });
+    return (sort.dir === "desc" ? -comparison : comparison) || a.index - b.index;
+  }).map(({ doc }) => doc);
+}
+
 // src/product/stock.ts
 import { map as map3 } from "rxjs";
 import { STOCK_LEVELS_LAST_PASS } from "@tallyui/core";
@@ -2882,7 +3000,8 @@ async function writeClosure({
     const rounding = recorded.granularity === "custom" ? DEFAULT_TAX_ROUNDING : recorded;
     roundings.add(rounding.granularity === "woocommerce" ? `woocommerce ${rounding.roundAtSubtotal}` : `${rounding.granularity} ${rounding.mode}`);
     const lines = order.lines.map((line) => ({ ...line, taxInclusive: line.taxInclusive ?? order.pricesIncludeTax }));
-    for (const { ratePpm, netMinor, amountMinor } of taxLinesByRate(lines, order.taxMinor, void 0, order.taxRounding)) {
+    const taxedLines = [...lines, ...[...order.fees ?? [], ...order.shipping ?? []].map((charge) => ({ ...charge, taxInclusive: order.pricesIncludeTax }))];
+    for (const { ratePpm, netMinor, amountMinor } of taxLinesByRate(taxedLines, order.taxMinor, void 0, order.taxRounding)) {
       const existing2 = taxRates.get(String(ratePpm));
       taxRates.set(String(ratePpm), {
         ratePpm,
@@ -3890,7 +4009,7 @@ function useRegisterSession(options) {
 }
 
 // src/sale/cart.ts
-import { resolvePrice as resolvePrice2 } from "@tallyui/core";
+import { resolvePrice as resolvePrice3 } from "@tallyui/core";
 var CartError = class extends Error {
 };
 function addEntryToCart(builder, entry, traits, currency) {
@@ -3901,7 +4020,7 @@ function addEntryToCart(builder, entry, traits, currency) {
     return existing.id;
   }
   const name = traits.getName(product) + (traits.getVariantCount(product) > 1 ? ` \xB7 ${variant.title}` : "");
-  const unitPrice = resolvePrice2(variant.prices, currency)?.current;
+  const unitPrice = resolvePrice3(variant.prices, currency)?.current;
   if (!unitPrice) throw new CartError(`No ${currency} price for ${name}`);
   return builder.addLine({
     productId: traits.getId(product),
@@ -4079,6 +4198,9 @@ function useSale(settings, opts) {
     stage,
     error,
     idle: idle3,
+    /** The store's capabilities as passed in: a component offers fees, shipping and custom lines
+     * only when `orderCreate >= 5`, and their tax status and class only as `lineTax` allows. */
+    capabilities: opts.capabilities,
     /** A completion is pending (see `complete()`): the sale is locked, and the UI offers Retry. */
     saving,
     /** The failed save's order is confirmed stored (see `isStored`): the UI also offers Continue (`continueSale()`). */
@@ -4406,7 +4528,7 @@ function useSale(settings, opts) {
 }
 
 // src/sale/catalogue.ts
-import { findVariantByCode, formatMoney as formatMoney2, resolvePrice as resolvePrice3 } from "@tallyui/core";
+import { findVariantByCode, formatMoney as formatMoney2, resolvePrice as resolvePrice4 } from "@tallyui/core";
 function catalogueEntries(products, traits, context) {
   return products.flatMap((product) => {
     const variants = traits.getVariants ? traits.getVariants(product, context) : traits.hasVariants(product) ? [] : [{
@@ -4424,7 +4546,7 @@ function findEntryByCode(entries, code) {
   return variant ? entries.find((entry) => entry.variant === variant) : void 0;
 }
 function variantPriceLabel(variant, currency, locale) {
-  const price = resolvePrice3(variant.prices, currency);
+  const price = resolvePrice4(variant.prices, currency);
   return price ? formatMoney2(price.current, locale) : void 0;
 }
 
@@ -5588,10 +5710,12 @@ function planLegs(plan, rowsSinceFrom, balanceMinor) {
 export {
   CartError,
   CurrencyProvider,
+  DEFAULT_CATALOGUE_VIEW_STATE,
   DISCOUNTS_UNSUPPORTED,
   MAX_TENDER_MINOR,
   MICROS_PER_MINOR,
   OrderContentMismatchError,
+  PRODUCT_SORT_FIELDS,
   PosOrderOpenClosedError,
   RegisterApprovalRequiredError,
   RegisterCloseIncompleteError,
@@ -5621,6 +5745,7 @@ export {
   callbackSink,
   cashMovementSchema,
   catalogueEntries,
+  catalogueViewReducer,
   changeMinor,
   clampClosureScope,
   closeNeedsApproval,
@@ -5652,10 +5777,12 @@ export {
   getBoundRegisterId,
   getDeviceId,
   getProductStock,
+  inCategory,
   initTenderState,
   initialTenderState,
   isServerDecimal,
   labelKeys,
+  listCategories,
   minorToDecimal,
   mintClosureNumber,
   mintUuid,
@@ -5664,6 +5791,7 @@ export {
   needsAttention,
   nextSaleCounter,
   normalizeAmount,
+  normalizeCatalogueViewState,
   observeRegister$,
   openSession,
   openSessionSelector,
@@ -5676,6 +5804,8 @@ export {
   posOrderCollection,
   posOrderSchema,
   posOrdersLogger,
+  productCategories,
+  productSortValue,
   quickTenderedAmounts,
   ratePpmFromPercent,
   readBoundRegister,
@@ -5691,6 +5821,7 @@ export {
   registerSessionCollection,
   registerSessionSchema,
   requireOpenSession,
+  resolveGridColumns,
   resolveStoreSettings,
   restoreOrderDraft,
   roundMicrosToMinor,
@@ -5700,6 +5831,7 @@ export {
   selectClosureRows,
   sessionOpenCommand,
   sessionTransitionCommand,
+  sortProducts,
   stampSession,
   startCounting,
   stockOverlay$,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tallyui/pos",
-  "version": "3.3.0",
+  "version": "3.5.0",
   "type": "module",
   "description": "Shared POS business logic for Tally UI — tax, orders, payments, discounts, receipts",
   "main": "./dist/index.js",
@@ -27,20 +27,20 @@
     "directory": "packages/pos"
   },
   "peerDependencies": {
-    "@tallyui/core": "^3.3.0",
+    "@tallyui/core": "^3.5.0",
     "react": ">=18",
     "rxdb": "~17.5.0",
     "rxjs": ">=7"
   },
   "devDependencies": {
-    "@tallyui/core": "3.3.0",
+    "@tallyui/core": "3.5.0",
     "@types/react": ">=18",
     "react": "^19.2.4",
     "rxdb": "17.5.0",
     "rxjs": "7.8.2",
-    "@tallyui/connector-medusa": "3.3.0",
-    "@tallyui/connector-woocommerce": "3.3.0",
-    "@tallyui/database": "3.3.0"
+    "@tallyui/connector-medusa": "3.5.0",
+    "@tallyui/connector-woocommerce": "3.5.0",
+    "@tallyui/database": "3.5.0"
   },
   "scripts": {
     "build": "tsup",

package/src/index.ts

@@ -55,7 +55,7 @@ export { buildReceiptData } from './receipt';
 export type { ReceiptData, ReceiptLineItem, ReceiptConfig } from './receipt';
 
 // Product
-export { searchProducts, withStockOverlay, getProductStock, stockOverlay$, stockOverlayAsOf$ } from './product';
+export { searchProducts, sortProducts, productSortValue, PRODUCT_SORT_FIELDS, type ProductSort, type ProductSortValue, catalogueViewReducer, normalizeCatalogueViewState, resolveGridColumns, DEFAULT_CATALOGUE_VIEW_STATE, type CatalogueView, type CatalogueGridColumns, type CatalogueViewState, type CatalogueViewAction, withStockOverlay, getProductStock, stockOverlay$, stockOverlayAsOf$, productCategories, listCategories, inCategory } from './product';
 
 // Sale
 export { useSale, DISCOUNTS_UNSUPPORTED, SALE_SAVING, saleLogger, addEntryToCart, CartError, catalogueEntries, findEntryByCode, variantPriceLabel } from './sale';

package/src/order/order-builder.ts

@@ -1,5 +1,5 @@
 import { BehaviorSubject, type Observable } from 'rxjs';
-import { resolvePrice, type ProductTraits, type TaxRounding } from '@tallyui/core';
+import { resolvePrice, woocommerceTax, type ProductTraits, type TaxRounding } from '@tallyui/core';
 import type { TaxContext } from '../tax/types';
 import { taxMicros, roundMicrosToMinor, roundedTaxByRate } from '../tax/exact';
 import { taxLogger } from '../tax/tax-provider';
@@ -188,6 +188,7 @@ export function createOrderBuilder(options: OrderBuilderOptions): OrderBuilder {
     const shares = allocateOrderDiscount(lineAmounts, recalcedOrderDiscounts.reduce((sum, d) => sum + d.amountMinor, 0));
     const lines = lineItems.map((li, index) => recalculateLine(li, shares[index]));
 
+    if (woo) shipping = shipping.map((charge) => ({ ...charge, ...recalculateCharge(charge.id, charge, true) }));
     const wooTotals = woo ? woocommerceTotals(lines, fees, shipping, currency, woo.roundAtSubtotal, taxContext.pricesIncludeTax) : undefined;
     const { subtotalMinor } = wooTotals ?? sumLines(lines, taxContext.rounding);
     const charges = [...fees, ...shipping];
@@ -310,7 +311,16 @@ export function createOrderBuilder(options: OrderBuilderOptions): OrderBuilder {
     if (!input.name.trim()) throw new RangeError('Name must not be empty');
     const taxStatus = input.taxStatus ?? 'taxable';
     if (woo) {
-      const line = wooLine(input.amountMinor, input.taxClass, taxContext.pricesIncludeTax, taxStatus === 'none', shipping);
+      const taxClass = shipping
+        ? taxContext.shippingTaxClass === undefined || taxContext.shippingTaxClass === 'inherit'
+          ? woocommerceTax.resolveInheritedShippingTaxClass(lineItems.map((line) => ({
+            tax_class: line.taxClass, taxable: line.taxStatus !== 'none',
+          })), taxContext.taxClassSlugs ?? [])
+          : taxContext.shippingTaxClass
+        : input.taxClass;
+      const untaxed = shipping ? taxClass === woocommerceTax.NO_SHIPPING_TAX : taxStatus === 'none';
+      const line = wooLine(input.amountMinor, taxClass === woocommerceTax.NO_SHIPPING_TAX ? undefined : taxClass,
+        taxContext.pricesIncludeTax, untaxed, shipping);
       return { id, name: input.name, amountMinor: input.amountMinor, taxClass: input.taxClass, taxStatus,
         ...line };
     }

package/src/product/catalogue-view-state.ts

@@ -0,0 +1,60 @@
+import type { ProductSort } from './sort-products';
+
+export type CatalogueView = 'grid' | 'table';
+export type CatalogueGridColumns = 'auto' | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+export interface CatalogueViewState {
+  view: CatalogueView;
+  gridColumns: CatalogueGridColumns;
+  sort: ProductSort | null;
+  categoryId: string | null;
+}
+export const DEFAULT_CATALOGUE_VIEW_STATE: CatalogueViewState = Object.freeze({
+  view: 'grid', gridColumns: 'auto', sort: null, categoryId: null,
+});
+
+export type CatalogueViewAction =
+  | { type: 'setView'; view: CatalogueView }
+  | { type: 'setGridColumns'; gridColumns: CatalogueGridColumns }
+  | { type: 'setSort'; sort: ProductSort | null }
+  | { type: 'setCategory'; categoryId: string | null }
+  | { type: 'replace'; state: CatalogueViewState };
+
+export function catalogueViewReducer(state: CatalogueViewState, action: CatalogueViewAction): CatalogueViewState {
+  switch (action.type) {
+    case 'setView': return state.view === action.view ? state : { ...state, view: action.view };
+    case 'setGridColumns': return state.gridColumns === action.gridColumns ? state : { ...state, gridColumns: action.gridColumns };
+    case 'setCategory': return state.categoryId === action.categoryId ? state : { ...state, categoryId: action.categoryId };
+    case 'setSort': return state.sort?.field === action.sort?.field && state.sort?.dir === action.sort?.dir
+      ? state : { ...state, sort: action.sort };
+    case 'replace': return action.state;
+  }
+}
+
+export function normalizeCatalogueViewState(raw: unknown, defaults: CatalogueViewState = DEFAULT_CATALOGUE_VIEW_STATE): CatalogueViewState {
+  if (typeof raw !== 'object' || raw === null) return defaults;
+  try {
+    const { view, gridColumns, sort, categoryId } = raw as Record<string, unknown>;
+    const candidate = sort as Partial<ProductSort> | null;
+    return {
+      categoryId: categoryId === null || (typeof categoryId === 'string' && categoryId.length > 0)
+        ? categoryId : defaults.categoryId,
+      view: view === 'grid' || view === 'table' ? view : defaults.view,
+      gridColumns: gridColumns === 'auto' || (typeof gridColumns === 'number' && Number.isInteger(gridColumns)
+        && gridColumns >= 2 && gridColumns <= 8) ? gridColumns as CatalogueGridColumns : defaults.gridColumns,
+      sort: sort === null ? null : typeof candidate === 'object' && candidate
+        && typeof candidate.field === 'string' && candidate.field.length > 0
+        && (candidate.dir === 'asc' || candidate.dir === 'desc')
+        ? { field: candidate.field, dir: candidate.dir } : defaults.sort,
+    };
+  } catch {
+    return defaults;
+  }
+}
+
+// Keep product names readable and touch targets at least 160 px wide where two columns fit.
+const MIN_TILE_WIDTH = 160;
+export function resolveGridColumns(gridColumns: CatalogueGridColumns, containerWidth: number): number {
+  // ProductGrid has 4 px padding on each side of the content and each cell: 160 px tile + 8.
+  return gridColumns === 'auto'
+    ? Math.max(2, Math.min(6, Math.floor((containerWidth - 8) / (MIN_TILE_WIDTH + 8)))) : gridColumns;
+}

package/src/product/categories.ts

@@ -0,0 +1,26 @@
+import type { ProductCategory, ProductTraits } from '@tallyui/core';
+
+/** The product's categories: `getCategories`, else `getCategoryNames` with each name as its id. */
+export function productCategories<Doc>(doc: Doc, traits: ProductTraits<Doc>): ProductCategory[] {
+  return traits.getCategories
+    ? traits.getCategories(doc)
+    : traits.getCategoryNames(doc).map((name) => ({ id: name, name }));
+}
+
+/** Every category across `docs`, once per id (the first name seen wins), sorted by name (natural, case-insensitive), ties by id. */
+export function listCategories<Doc>(docs: readonly Doc[], traits: ProductTraits<Doc>): ProductCategory[] {
+  const categories = new Map<string, ProductCategory>();
+  for (const doc of docs) {
+    for (const category of productCategories(doc, traits)) {
+      if (!categories.has(category.id)) categories.set(category.id, category);
+    }
+  }
+  return [...categories.values()].sort((a, b) =>
+    a.name.localeCompare(b.name, undefined, { numeric: true, sensitivity: 'base' })
+    || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+}
+
+/** Whether `doc` is in the category with this id. */
+export function inCategory<Doc>(doc: Doc, categoryId: string, traits: ProductTraits<Doc>): boolean {
+  return productCategories(doc, traits).some((category) => category.id === categoryId);
+}

package/src/product/index.ts

@@ -1,2 +1,5 @@
 export { searchProducts } from './search-products';
+export { productCategories, listCategories, inCategory } from './categories';
+export { catalogueViewReducer, normalizeCatalogueViewState, resolveGridColumns, DEFAULT_CATALOGUE_VIEW_STATE, type CatalogueView, type CatalogueGridColumns, type CatalogueViewState, type CatalogueViewAction } from './catalogue-view-state';
+export { sortProducts, productSortValue, PRODUCT_SORT_FIELDS, type ProductSort, type ProductSortValue } from './sort-products';
 export { withStockOverlay, getProductStock, stockOverlay$, stockOverlayAsOf$ } from './stock';

package/src/product/sort-products.ts

@@ -0,0 +1,51 @@
+import { resolvePrice, resolvePriceRange, type ProductTraits, type TraitContext } from '@tallyui/core';
+
+/** A sort on one field: ascending or descending. */
+export interface ProductSort { field: string; dir: 'asc' | 'desc' }
+export type ProductSortValue = string | number | undefined;
+/** The fields productSortValue knows, in the default column order. */
+export const PRODUCT_SORT_FIELDS = ['name', 'sku', 'barcode', 'price', 'stock', 'category'] as const;
+
+export function productSortValue<Doc>(
+  doc: Doc, field: string, traits: ProductTraits<Doc>, context?: TraitContext,
+): ProductSortValue {
+  let value: ProductSortValue;
+  switch (field) {
+    case 'name': value = traits.getName(doc); break;
+    case 'sku': value = traits.getSku(doc); break;
+    case 'barcode': value = traits.getBarcode(doc); break;
+    case 'price': {
+      const variants = traits.getVariants?.(doc, context);
+      value = variants && variants.length >= 2
+        ? resolvePriceRange(variants, context?.currency)?.min.amount
+        : resolvePrice(traits.getPrices(doc, context), context?.currency)?.current.amount;
+      break;
+    }
+    case 'stock': value = traits.getStock(doc).quantity; break;
+    case 'category': value = traits.getCategoryNames(doc).join(', '); break;
+    default: return undefined;
+  }
+  return value === '' ? undefined : value;
+}
+
+export function sortProducts<Doc>(
+  docs: Doc[], sort: ProductSort | null | undefined,
+  valueOf: (doc: Doc, field: string) => ProductSortValue,
+): Doc[] {
+  if (!sort) return docs;
+  return docs.map((doc, index) => ({ doc, index, value: valueOf(doc, sort.field) }))
+    .sort((a, b) => {
+      const aMissing = a.value === undefined || a.value === '';
+      const bMissing = b.value === undefined || b.value === '';
+      if (aMissing || bMissing) {
+        return aMissing === bMissing ? a.index - b.index : aMissing ? 1 : -1;
+      }
+      const av = a.value!;
+      const bv = b.value!;
+      const comparison = typeof av === 'number'
+        ? (typeof bv === 'number' ? av - bv : -1)
+        : (typeof bv === 'number' ? 1 : av.localeCompare(bv, undefined, { numeric: true, sensitivity: 'base' }));
+      return (sort.dir === 'desc' ? -comparison : comparison) || a.index - b.index;
+    })
+    .map(({ doc }) => doc);
+}

package/src/register/session-store.ts

@@ -484,7 +484,9 @@ export async function writeClosure({
     const rounding = recorded.granularity === 'custom' ? DEFAULT_TAX_ROUNDING : recorded;
     roundings.add(rounding.granularity === 'woocommerce' ? `woocommerce ${rounding.roundAtSubtotal}` : `${rounding.granularity} ${rounding.mode}`);
     const lines = order.lines.map((line) => ({ ...line, taxInclusive: line.taxInclusive ?? order.pricesIncludeTax }));
-    for (const { ratePpm, netMinor, amountMinor } of taxLinesByRate(lines, order.taxMinor, undefined, order.taxRounding)) {
+    const taxedLines = [...lines, ...[...(order.fees ?? []), ...(order.shipping ?? [])]
+      .map((charge) => ({ ...charge, taxInclusive: order.pricesIncludeTax }))];
+    for (const { ratePpm, netMinor, amountMinor } of taxLinesByRate(taxedLines, order.taxMinor, undefined, order.taxRounding)) {
       const existing = taxRates.get(String(ratePpm));
       taxRates.set(String(ratePpm), {
         ratePpm,

package/src/sale/use-sale.ts

@@ -249,6 +249,9 @@ export function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
 
   const result = {
     order, stage, error, idle,
+    /** The store's capabilities as passed in: a component offers fees, shipping and custom lines
+     * only when `orderCreate >= 5`, and their tax status and class only as `lineTax` allows. */
+    capabilities: opts.capabilities,
     /** A completion is pending (see `complete()`): the sale is locked, and the UI offers Retry. */
     saving,
     /** The failed save's order is confirmed stored (see `isStored`): the UI also offers Continue (`continueSale()`). */

package/src/tax/tax-provider.tsx

@@ -19,7 +19,7 @@ export interface TaxProviderProps extends Pick<StoreSettings, 'taxRoundAtSubtota
   children: ReactNode;
 }
 
-export function TaxProvider({ ratesPpm, pricesIncludeTax, rounding, rateCodes, taxRates, children }: TaxProviderProps) {
+export function TaxProvider({ ratesPpm, pricesIncludeTax, rounding, rateCodes, taxRates, shippingTaxClass, taxClassSlugs, children }: TaxProviderProps) {
   const value = useMemo<TaxContext>(
     () => {
       if (Object.values(ratesPpm).some((rate) => !Number.isSafeInteger(rate) || rate < 0)) {
@@ -45,9 +45,11 @@ export function TaxProvider({ ratesPpm, pricesIncludeTax, rounding, rateCodes, t
         },
         pricesIncludeTax,
         ...(rounding ? { rounding } : {}),
+        ...(shippingTaxClass !== undefined ? { shippingTaxClass } : {}),
+        ...(taxClassSlugs !== undefined ? { taxClassSlugs } : {}),
       };
     },
-    [ratesPpm, pricesIncludeTax, rounding, rateCodes, taxRates],
+    [ratesPpm, pricesIncludeTax, rounding, rateCodes, taxRates, shippingTaxClass, taxClassSlugs],
   );
 
   return <TaxCtx.Provider value={value}>{children}</TaxCtx.Provider>;

package/src/tax/types.ts

@@ -9,6 +9,8 @@ export type TaxRateMap = {
 };
 
 export interface TaxContext {
+  shippingTaxClass?: string;
+  taxClassSlugs?: readonly string[];
   getTaxRates?(taxClass?: string, options?: { shipping?: boolean }): readonly WooRate[];
   /** Tax rate for a tax class as integer parts per million (19% = 190000); the default class when omitted or unknown. */
   getTaxRatePpm(taxClass?: string): number;