@tallyui/pos 3.3.0 → 3.4.0

package/dist/index.d.ts

@@ -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 = {
@@ -1957,6 +1959,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()`). */

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,
@@ -2882,7 +2896,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,
@@ -4079,6 +4094,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()`). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tallyui/pos",
-  "version": "3.3.0",
+  "version": "3.4.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.4.0",
     "react": ">=18",
     "rxdb": "~17.5.0",
     "rxjs": ">=7"
   },
   "devDependencies": {
-    "@tallyui/core": "3.3.0",
+    "@tallyui/core": "3.4.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.4.0",
+    "@tallyui/connector-woocommerce": "3.4.0",
+    "@tallyui/database": "3.4.0"
   },
   "scripts": {
     "build": "tsup",

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/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;