@tallyui/pos 3.2.0 → 3.3.0

package/dist/index.js

@@ -109,6 +109,84 @@ function useCurrencyCode() {
   return ctx.currencyCode;
 }
 
+// src/order/woocommerce-tax.ts
+import { minorUnitDigits, woocommerceTax } from "@tallyui/core";
+function woocommerceLine(amountMinor, rates, inclusive, currency, roundAtSubtotal, pricesIncludeTax = inclusive) {
+  const dp = minorUnitDigits(currency), factor = 10 ** dp;
+  const precision = woocommerceTax.getRoundingPrecision(dp);
+  const input = {
+    amount: amountMinor / factor,
+    rates: rates.map((rate) => ({ ...rate, order: rate.priority })),
+    amountIncludesTax: inclusive,
+    dp,
+    perRatePrecision: precision
+  };
+  let result = woocommerceTax.calculateTaxes(input);
+  const net = woocommerceTax.roundHalfUp(input.amount - (inclusive ? result.total : 0), precision);
+  if (inclusive && rates.length) result = woocommerceTax.calculateTaxes({ ...input, amount: net, amountIncludesTax: false });
+  const taxLines = result.taxes.map((tax2) => {
+    const rate = rates.find((rate2) => rate2.id === tax2.id);
+    return {
+      code: rate.code,
+      rateId: rate.id,
+      compound: rate.compound,
+      ratePpm: Math.round(Number(rate.rate) * 1e4),
+      taxMicros: String(Math.round(tax2.total * factor * 1e6))
+    };
+  });
+  const tax = result.taxes.reduce((sum, rate) => sum + (roundAtSubtotal ? rate.total : woocommerceTax.roundTaxTotal(rate.total, dp, pricesIncludeTax)), 0);
+  return {
+    netMinor: Math.round(woocommerceTax.roundHalfUp(net, dp) * factor),
+    netMicros: String(Math.round(net * factor * 1e6)),
+    totalMinor: Math.round(woocommerceTax.roundHalfUp(net + tax, dp) * factor),
+    taxLines,
+    taxMicros: taxLines.reduce((sum, rate) => sum + BigInt(rate.taxMicros), 0n).toString()
+  };
+}
+function woocommerceTotals(lines, fees, shipping, currency, roundAtSubtotal, inclusive) {
+  const dp = minorUnitDigits(currency), factor = 10 ** dp;
+  const net = (line) => Number(line.netMicros) / (factor * 1e6);
+  const productNet = lines.reduce((sum, line) => sum + (roundAtSubtotal ? net(line) : woocommerceTax.roundHalfUp(net(line), dp)), 0);
+  const amount = productNet + fees.reduce((sum, line) => sum + net(line), 0) + shipping.reduce((sum, line) => sum + woocommerceTax.roundHalfUp(net(line), dp), 0);
+  const taxes = (items) => woocommerceTax.roundHalfUp(items.reduce((sum, line) => line.taxLines.reduce((sum2, tax2) => sum2 + (roundAtSubtotal ? Number(tax2.taxMicros) / (factor * 1e6) : woocommerceTax.roundTaxTotal(Number(tax2.taxMicros) / (factor * 1e6), dp, inclusive)), sum), 0), woocommerceTax.getRoundingPrecision(dp));
+  const tax = woocommerceTax.roundHalfUp(taxes([...lines, ...fees]) + taxes(shipping), 6);
+  return {
+    subtotalMinor: Math.round(woocommerceTax.roundHalfUp(productNet, dp) * factor),
+    taxMinor: Math.round((roundAtSubtotal ? woocommerceTax.roundHalfUp(tax, dp) : woocommerceTax.roundTaxTotal(tax, dp, inclusive)) * factor),
+    totalMinor: Math.round(woocommerceTax.roundHalfUp(woocommerceTax.roundHalfUp(amount + tax, 6), dp) * factor)
+  };
+}
+function woocommerceTaxByRate(lines, roundAtSubtotal, taxLabels, orderTaxMinor) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const line of lines) for (const tax of line.taxLines) {
+    const key = JSON.stringify([tax.rateId, tax.code, tax.ratePpm]);
+    const row = groups.get(key) ?? {
+      code: tax.code,
+      ratePpm: tax.ratePpm,
+      label: taxLabels?.[tax.ratePpm] ?? `Tax ${tax.ratePpm / 1e4}%`,
+      netMinor: 0,
+      amountMinor: 0,
+      amount: 0,
+      inclusive: line.taxInclusive
+    };
+    const amount = Number(tax.taxMicros) / 1e6;
+    row.amount += roundAtSubtotal ? amount : woocommerceTax.roundTaxTotal(amount, 0, line.taxInclusive);
+    row.netMinor += line.netMinor;
+    groups.set(key, row);
+  }
+  const rows = [...groups.values()].map(({ amount, inclusive, ...row }) => ({
+    ...row,
+    amountMinor: woocommerceTax.roundTaxTotal(woocommerceTax.roundHalfUp(amount, 6), 0, inclusive)
+  }));
+  if (orderTaxMinor !== void 0 && rows.length) {
+    const residue = orderTaxMinor - rows.reduce((sum, row) => sum + row.amountMinor, 0);
+    const bound = Math.floor(rows.length / 2) + 1;
+    if (Math.abs(residue) > bound) throw new Error(`woocommerce tax by rate: residue ${residue} exceeds its bound ${bound} (ADR-076)`);
+    rows[rows.length - 1].amountMinor += residue;
+  }
+  return rows;
+}
+
 // src/tax/exact.ts
 var MICROS_PER_MINOR = 1000000n;
 var DEFAULT_TAX_ROUNDING = { granularity: "per_order", mode: "half_away_from_zero" };
@@ -211,6 +289,7 @@ function roundedTaxByRate(lines, rounding) {
   return { baseMinor: Number(baseMinor), taxMinor: rows.reduce((sum, row) => sum + row.amountMinor, 0), rates: rows };
 }
 function taxLinesByRate(lines, orderTaxMinor, taxLabels, rounding) {
+  if (rounding?.granularity === "woocommerce" && lines.every((line) => line.netMicros !== void 0)) return woocommerceTaxByRate(lines, rounding.roundAtSubtotal, taxLabels, orderTaxMinor);
   const label = (ratePpm) => taxLabels?.[ratePpm] ?? `Tax ${ratePpm / 1e4}%`;
   const rounded = roundedTaxByRate(lines, rounding);
   if (rounded) return rounded.rates.map(({ code, ratePpm, netMinor, amountMinor }) => ({ label: label(ratePpm), code, ratePpm, netMinor, amountMinor }));
@@ -244,10 +323,11 @@ function taxLinesByRate(lines, orderTaxMinor, taxLabels, rounding) {
 
 // src/tax/tax-provider.tsx
 import { createContext as createContext2, useContext as useContext2, useMemo as useMemo2 } from "react";
+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, children }) {
+function TaxProvider({ ratesPpm, pricesIncludeTax, rounding, rateCodes, taxRates, children }) {
   const value = useMemo2(
     () => {
       if (Object.values(ratesPpm).some((rate) => !Number.isSafeInteger(rate) || rate < 0)) {
@@ -255,6 +335,7 @@ function TaxProvider({ ratesPpm, pricesIncludeTax, rounding, rateCodes, children
       }
       const unknown = /* @__PURE__ */ new Set();
       return {
+        ...taxRates ? { getTaxRates: (taxClass, options) => (taxRates[woocommerceTax2.normalizeTaxClass(taxClass)] ?? []).filter((rate) => !options?.shipping || rate.shipping) } : {},
         getTaxRatePpm: (taxClass) => {
           if (taxClass !== void 0 && Object.hasOwn(ratesPpm, taxClass)) return ratesPpm[taxClass];
           if (taxClass !== void 0 && !unknown.has(taxClass)) {
@@ -272,7 +353,7 @@ function TaxProvider({ ratesPpm, pricesIncludeTax, rounding, rateCodes, children
         ...rounding ? { rounding } : {}
       };
     },
-    [ratesPpm, pricesIncludeTax, rounding, rateCodes]
+    [ratesPpm, pricesIncludeTax, rounding, rateCodes, taxRates]
   );
   return /* @__PURE__ */ jsx2(TaxCtx.Provider, { value, children });
 }
@@ -319,7 +400,16 @@ function withPricingContext(context, settings) {
 }
 function taxProviderProps(settings) {
   const rounding = settings.taxRounding?.granularity === "custom" ? void 0 : settings.taxRounding;
-  return { ratesPpm: settings.taxRatesPpm, pricesIncludeTax: settings.pricesIncludeTax, ...rounding && { rounding }, ...settings.taxRateCodes && { rateCodes: settings.taxRateCodes } };
+  return {
+    ratesPpm: settings.taxRatesPpm,
+    pricesIncludeTax: settings.pricesIncludeTax,
+    ...rounding && { rounding },
+    ...settings.taxRateCodes && { rateCodes: settings.taxRateCodes },
+    ...settings.taxRates && { taxRates: settings.taxRates },
+    ...settings.taxRoundAtSubtotal !== void 0 && { taxRoundAtSubtotal: settings.taxRoundAtSubtotal },
+    ...settings.shippingTaxClass !== void 0 && { shippingTaxClass: settings.shippingTaxClass },
+    ...settings.taxClassSlugs && { taxClassSlugs: settings.taxClassSlugs }
+  };
 }
 
 // src/store-settings/use-store-settings.ts
@@ -522,7 +612,16 @@ function createOrderBuilder(options) {
   const { taxContext } = options;
   const currency = options.currency.toUpperCase();
   const orderId = options.id ?? uid();
+  const woo = taxContext.rounding?.granularity === "woocommerce" && taxContext.getTaxRates ? taxContext.rounding : void 0;
+  const wooLine = (amount, taxClass, inclusive, untaxed = false, shipping2 = false) => woocommerceLine(amount, untaxed ? [] : taxContext.getTaxRates(taxClass, { shipping: shipping2 }), inclusive, currency, woo.roundAtSubtotal, taxContext.pricesIncludeTax);
+  const displayAmount = (line, amount) => {
+    if (!woo || line.taxInclusive === taxContext.pricesIncludeTax) return toDisplayMode(line, amount, taxContext.pricesIncludeTax);
+    const item = wooLine(amount, line.taxClass, line.taxInclusive, line.taxStatus === "none");
+    return taxContext.pricesIncludeTax ? item.totalMinor : item.netMinor;
+  };
   let lineItems = [];
+  let fees = [];
+  let shipping = [];
   let orderDiscounts = [];
   let payments = [];
   let customer = null;
@@ -540,6 +639,13 @@ function createOrderBuilder(options) {
     const lineDiscountMinor = Math.min(grossMinor, recalcedDiscounts.reduce((sum, d) => sum + d.amountMinor, 0));
     const discountMinor = lineDiscountMinor + orderDiscountMinor;
     const netMinor = grossMinor - discountMinor;
+    if (woo) return {
+      ...line,
+      discounts: recalcedDiscounts,
+      discountMinor,
+      orderDiscountMinor,
+      ...wooLine(netMinor, line.taxClass, line.taxInclusive, line.taxStatus === "none")
+    };
     const combinedRate = line.taxLines.reduce((sum, tax) => sum + tax.ratePpm, 0);
     const inclusiveTax = line.taxInclusive ? taxMicros(netMinor, combinedRate, true) : 0n;
     let allocatedTax = 0n;
@@ -566,7 +672,7 @@ function createOrderBuilder(options) {
     return Math.max(0, Math.min(discount.value, base));
   }
   function buildOrder() {
-    const lineAmounts = lineItems.map((li) => li.netMinor);
+    const lineAmounts = lineItems.map((li) => woo ? li.unitPriceMinor * li.quantity - li.discountMinor : li.netMinor);
     const base = lineAmounts.reduce((sum, amount) => sum + Math.max(0, amount), 0);
     let remaining = base;
     const recalcedOrderDiscounts = orderDiscounts.map((d) => {
@@ -576,8 +682,16 @@ 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]));
-    const { subtotalMinor, taxMinor, totalMinor } = sumLines(lines, taxContext.rounding);
-    if (taxContext.rounding?.granularity === "per_rate_group_items" && lines.some((li) => li.taxInclusive) && !perRateGroupWarned.has(taxContext)) {
+    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];
+    const taxedLines = [...lines, ...charges.map((charge) => ({
+      ...charge,
+      taxInclusive: taxContext.pricesIncludeTax,
+      taxMicros: charge.taxLines.reduce((sum, tax) => sum + BigInt(tax.taxMicros), 0n).toString()
+    }))];
+    const { taxMinor, totalMinor } = wooTotals ?? sumLines(taxedLines, taxContext.rounding);
+    if (taxContext.rounding?.granularity === "per_rate_group_items" && taxedLines.some((li) => li.taxInclusive) && !perRateGroupWarned.has(taxContext)) {
       perRateGroupWarned.add(taxContext);
       taxLogger.warn("per_rate_group_items with inclusive lines: using per_order figures until the display has a rounding row (#287, #310)");
     }
@@ -588,11 +702,11 @@ function createOrderBuilder(options) {
       const discounts = returned ? [] : li.discounts.map((d) => ({
         discountId: d.id,
         ...d.label !== void 0 ? { label: d.label } : {},
-        amountMinor: toDisplayMode(li, d.amountMinor, taxInclusive)
+        amountMinor: displayAmount(li, d.amountMinor)
       }));
-      const shareMinor = toDisplayMode(li, li.orderDiscountMinor, taxInclusive);
-      const remainingMinor = toDisplayMode(li, li.netMinor, taxInclusive);
-      const amountMinor = li.taxInclusive === taxInclusive && !returned ? li.unitPriceMinor * li.quantity : discounts.reduce((sum, d) => sum + d.amountMinor, remainingMinor + shareMinor);
+      const shareMinor = displayAmount(li, li.orderDiscountMinor);
+      const remainingMinor = woo ? taxInclusive ? li.totalMinor : li.netMinor : toDisplayMode(li, li.netMinor, taxInclusive);
+      const amountMinor = !woo && li.taxInclusive === taxInclusive && !returned ? li.unitPriceMinor * li.quantity : discounts.reduce((sum, d) => sum + d.amountMinor, remainingMinor + shareMinor);
       return { line: { lineId: li.id, amountMinor, discounts }, shareMinor, remainingMinor, returned };
     });
     const displayLines = figures.map((f) => f.line);
@@ -601,8 +715,17 @@ function createOrderBuilder(options) {
       (sum, line) => line.discounts.reduce((lineSum, d) => lineSum + d.amountMinor, sum),
       orderDiscountDisplay
     );
-    const displaySubtotal = (taxInclusive ? totalMinor : totalMinor - taxMinor) + displayDiscount;
-    const residue = displaySubtotal - displayLines.reduce((sum, line) => sum + line.amountMinor, 0);
+    const chargeRows = (items) => items.map(({ id: id2, name, amountMinor, netMinor, totalMinor: totalMinor2 }) => ({ id: id2, name, amountMinor: woo ? taxInclusive ? totalMinor2 : netMinor : amountMinor }));
+    const displayFees = chargeRows(fees), displayShipping = chargeRows(shipping);
+    let displaySubtotal = (taxInclusive ? totalMinor : totalMinor - taxMinor) + displayDiscount - [...displayFees, ...displayShipping].reduce((sum, charge) => sum + charge.amountMinor, 0);
+    let residue = displaySubtotal - displayLines.reduce((sum, line) => sum + line.amountMinor, 0);
+    if (woo) {
+      const charge = displayShipping.at(-1) ?? displayFees.at(-1);
+      const last = charge ?? displayLines.at(-1);
+      if (last) last.amountMinor += residue;
+      if (charge) displaySubtotal -= residue;
+      residue = displaySubtotal - displayLines.reduce((sum, line) => sum + line.amountMinor, 0);
+    }
     const converted = lines.flatMap((li, index) => li.taxInclusive === taxInclusive ? [] : [index]);
     const conversions = converted.reduce((count, index) => count + [
       lines[index].netMinor,
@@ -622,7 +745,7 @@ function createOrderBuilder(options) {
     if (displayDiscount < 0) throw new Error(`Display discount ${displayDiscount} is negative (ADR-063)`);
     for (const { line, shareMinor, returned } of figures) {
       if (returned && line.discounts.length > 0) throw new Error(`Return line ${line.lineId} shows discount rows (ADR-063)`);
-      if (returned) continue;
+      if (returned || woo) continue;
       const rows = line.discounts.reduce((sum, d) => sum + d.amountMinor, 0);
       if (shareMinor < 0 || line.discounts.some((d) => d.amountMinor < 0) || line.amountMinor < rows + shareMinor) {
         throw new Error(`Display line ${line.lineId} shows ${line.amountMinor}, less than its rows ${rows} and share ${shareMinor} (ADR-063)`);
@@ -635,7 +758,9 @@ function createOrderBuilder(options) {
       taxMinor,
       totalMinor,
       lines: displayLines,
-      orderDiscountMinor: orderDiscountDisplay
+      orderDiscountMinor: orderDiscountDisplay,
+      ...fees.length ? { fees: displayFees } : {},
+      ...shipping.length ? { shipping: displayShipping } : {}
     };
     const paidMinor = payments.reduce((sum, p) => sum + p.amountMinor, 0);
     const balanceDueMinor = Math.max(0, totalMinor - paidMinor);
@@ -644,6 +769,8 @@ function createOrderBuilder(options) {
       id: orderId,
       status: "draft",
       lineItems: lines,
+      ...fees.length ? { fees: [...fees] } : {},
+      ...shipping.length ? { shipping: [...shipping] } : {},
       discounts: recalcedOrderDiscounts,
       payments: [...payments],
       customer,
@@ -666,17 +793,64 @@ function createOrderBuilder(options) {
   function emit() {
     subject.next(buildOrder());
   }
+  function recalculateCharge(id2, input, shipping2 = false) {
+    if (!Number.isInteger(input.amountMinor)) throw new RangeError("Amount must be integer minor units");
+    if (input.amountMinor < 0) throw new RangeError("Amount must be >= 0");
+    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);
+      return {
+        id: id2,
+        name: input.name,
+        amountMinor: input.amountMinor,
+        taxClass: input.taxClass,
+        taxStatus,
+        ...line2
+      };
+    }
+    const code = taxContext.getTaxRateCode?.(input.taxClass);
+    const line = recalculateLine({
+      id: id2,
+      productId: id2,
+      name: input.name,
+      sku: "",
+      unitPriceMinor: input.amountMinor,
+      quantity: 1,
+      taxLines: [{
+        ...code !== void 0 ? { code } : {},
+        ratePpm: taxStatus === "none" ? 0 : taxContext.getTaxRatePpm(input.taxClass),
+        taxMicros: "0"
+      }],
+      discounts: [],
+      discountMinor: 0,
+      orderDiscountMinor: 0,
+      netMinor: 0,
+      taxMicros: "0",
+      taxInclusive: taxContext.pricesIncludeTax
+    });
+    return {
+      id: id2,
+      name: input.name,
+      amountMinor: input.amountMinor,
+      taxClass: input.taxClass,
+      taxStatus,
+      taxLines: line.taxLines,
+      netMinor: line.netMinor,
+      taxMicros: line.taxMicros
+    };
+  }
   function addLine(input) {
     const { productId, variantId, unitPrice } = input;
     const quantity = input.quantity ?? 1;
     if (unitPrice.currency !== currency) throw new RangeError("Line currency must match " + currency);
     if (!Number.isInteger(unitPrice.amount)) throw new RangeError("Price must be integer minor units");
     if (!Number.isInteger(quantity) || quantity < 1) throw new RangeError("Quantity must be an integer >= 1");
-    const code = input.taxRates ? void 0 : taxContext.getTaxRateCode?.(input.taxClass);
-    const taxRates = input.taxRates ?? [{ ...code !== void 0 ? { code } : {}, ratePpm: taxContext.getTaxRatePpm(input.taxClass) }];
+    const code = woo || input.taxRates ? void 0 : taxContext.getTaxRateCode?.(input.taxClass);
+    const taxRates = woo ? wooLine(unitPrice.amount * quantity, input.taxClass, unitPrice.taxInclusive ?? taxContext.pricesIncludeTax, input.taxStatus === "none").taxLines : input.taxStatus === "none" ? [{ ...code !== void 0 ? { code } : {}, ratePpm: 0 }] : input.taxRates ?? [{ ...code !== void 0 ? { code } : {}, ratePpm: taxContext.getTaxRatePpm(input.taxClass) }];
     const taxInclusive = unitPrice.taxInclusive ?? taxContext.pricesIncludeTax;
     const existing = lineItems.find(
-      (li) => li.productId === productId && li.variantId === variantId && li.taxInclusive === taxInclusive && li.unitPriceMinor === unitPrice.amount && li.taxLines.length === taxRates.length && li.taxLines.every((tax, index) => tax.code === taxRates[index].code && tax.ratePpm === taxRates[index].ratePpm)
+      (li) => !input.custom && !li.custom && li.productId === productId && li.variantId === variantId && li.taxInclusive === taxInclusive && (!woo || li.taxClass === input.taxClass && li.taxStatus === "none" === (input.taxStatus === "none")) && li.unitPriceMinor === unitPrice.amount && li.taxLines.length === taxRates.length && li.taxLines.every((tax, index) => tax.code === taxRates[index].code && tax.ratePpm === taxRates[index].ratePpm)
     );
     if (existing) {
       lineItems = lineItems.map(
@@ -688,7 +862,10 @@ function createOrderBuilder(options) {
     const lineId = uid();
     const line = {
       id: lineId,
+      ...(input.custom ? input.taxClass !== void 0 : woo) ? { taxClass: input.taxClass } : {},
       productId,
+      ...input.custom ? { custom: true } : {},
+      ...input.taxStatus === "none" ? { taxStatus: "none" } : {},
       variantId,
       name: input.name,
       sku: input.sku ?? "",
@@ -716,6 +893,43 @@ function createOrderBuilder(options) {
   return {
     order$: subject.asObservable(),
     addLine,
+    addFee(input) {
+      const fee = recalculateCharge(uid(), input);
+      fees = [...fees, fee];
+      emit();
+      return fee.id;
+    },
+    updateFee(id2, patch) {
+      const fee = fees.find((entry) => entry.id === id2);
+      if (!fee) throw new Error(`Unknown fee ${id2}`);
+      const updated = recalculateCharge(id2, { ...fee, ...patch });
+      fees = fees.map((entry) => entry.id === id2 ? updated : entry);
+      emit();
+    },
+    removeFee(id2) {
+      if (!fees.some((entry) => entry.id === id2)) throw new Error(`Unknown fee ${id2}`);
+      fees = fees.filter((entry) => entry.id !== id2);
+      emit();
+    },
+    addShipping(input) {
+      const charge = { ...recalculateCharge(uid(), input, true), methodId: input.methodId };
+      shipping = [...shipping, charge];
+      emit();
+      return charge.id;
+    },
+    updateShipping(id2, patch) {
+      const charge = shipping.find((entry) => entry.id === id2);
+      if (!charge) throw new Error(`Unknown shipping ${id2}`);
+      const input = { ...charge, ...patch };
+      const updated = { ...recalculateCharge(id2, input, true), methodId: input.methodId };
+      shipping = shipping.map((entry) => entry.id === id2 ? updated : entry);
+      emit();
+    },
+    removeShipping(id2) {
+      if (!shipping.some((entry) => entry.id === id2)) throw new Error(`Unknown shipping ${id2}`);
+      shipping = shipping.filter((entry) => entry.id !== id2);
+      emit();
+    },
     addProduct(doc, traits, opts) {
       const productId = traits.getId(doc);
       if (!traits.isSellable(doc)) throw new Error("addProduct: this product isn't sold in this store's channel");
@@ -732,7 +946,8 @@ function createOrderBuilder(options) {
         imageUrl: traits.getImageUrl(doc),
         unitPrice,
         quantity: opts?.quantity,
-        taxClass: traits.getTaxClass?.(doc, opts?.variantId)
+        taxClass: traits.getTaxClass?.(doc, opts?.variantId),
+        ...traits.getTaxStatus?.(doc, opts?.variantId) === "none" ? { taxStatus: "none" } : {}
       });
     },
     updateQuantity(lineId, quantity) {
@@ -811,6 +1026,8 @@ function createOrderBuilder(options) {
     },
     clear() {
       lineItems = [];
+      fees = [];
+      shipping = [];
       orderDiscounts = [];
       payments = [];
       customer = null;
@@ -877,20 +1094,23 @@ function netDiscountMinor(line, pricesIncludeTax) {
   return roundMicrosToMinor(BigInt(line.discountMinor) * MICROS_PER_MINOR - taxBefore + taxAfter);
 }
 function contentVersion(order) {
+  if (order.fees?.length || order.shipping?.length || order.lines.some((line) => line.custom)) return 5;
   return order.display && order.taxByRate ? 3 : order.lines.reduce((sum, line) => sum + line.discountMinor, 0) > 0 ? 2 : 1;
 }
 function toOrderCreateEnvelope(order, deviceId, attempt2 = 1, options) {
   const grossMinor = order.lines.reduce((sum, line) => sum + line.discountMinor, 0);
   const content = contentVersion(order);
   const cap = options?.maxVersion === void 0 ? order.sentVersion : Math.min(options.maxVersion, order.sentVersion ?? options.maxVersion);
+  if (content === 5 && cap !== void 0 && cap < 5) throw new UnsupportedOrderVersionError(5, cap);
   if (grossMinor > 0 && cap !== void 0 && cap < 2) throw new UnsupportedOrderVersionError(2, cap);
   const version = content === 3 && cap !== void 0 && cap >= 4 ? 4 : Math.min(content, cap ?? content);
-  const lineDiscounts = order.lines.map((line) => version === 4 ? netDiscountMinor(line, order.pricesIncludeTax) : line.discountMinor);
+  const lineDiscounts = order.lines.map((line) => version >= 4 ? netDiscountMinor(line, order.pricesIncludeTax) : line.discountMinor);
   const discountMinor = lineDiscounts.reduce((sum, discount) => sum + discount, 0);
   const email = order.customer?.email;
   const id2 = order.customer?.id;
   const customerId = typeof id2 === "string" && id2.length > 0 && id2.length <= 64 ? id2 : void 0;
   const sessionId = order.sessionId ?? order.lateSessionId;
+  const { fees: _fees, shipping: _shipping, ...storedDisplay } = { ...order.display };
   return {
     id: order.commandId,
     type: "order.create",
@@ -905,13 +1125,30 @@ function toOrderCreateEnvelope(order, deviceId, attempt2 = 1, options) {
       pricesIncludeTax: order.pricesIncludeTax,
       lines: order.lines.map((line, i) => ({
         clientLineId: line.id,
-        variantId: line.variantId ?? line.productId,
+        ...line.custom ? { custom: { ...line.custom } } : { variantId: line.variantId ?? line.productId },
         title: line.name,
         quantity: line.quantity,
         unitPriceMinor: line.unitPriceMinor,
         ...line.taxInclusive !== void 0 ? { taxInclusive: line.taxInclusive } : {},
         ...lineDiscounts[i] > 0 ? { discountMinor: lineDiscounts[i] } : {}
       })),
+      ...version === 5 && order.fees?.length ? { fees: order.fees.map((fee) => ({
+        clientFeeId: fee.id,
+        name: fee.name,
+        amountMinor: fee.amountMinor,
+        taxStatus: fee.taxStatus,
+        ...fee.taxClass !== void 0 ? { taxClass: fee.taxClass } : {},
+        taxMinor: roundMicrosToMinor(BigInt(fee.taxMicros))
+      })) } : {},
+      ...version === 5 && order.shipping?.length ? { shipping: order.shipping.map((charge) => ({
+        clientShippingId: charge.id,
+        name: charge.name,
+        ...charge.methodId !== void 0 ? { methodId: charge.methodId } : {},
+        amountMinor: charge.amountMinor,
+        taxStatus: charge.taxStatus,
+        ...charge.taxClass !== void 0 ? { taxClass: charge.taxClass } : {},
+        taxMinor: roundMicrosToMinor(BigInt(charge.taxMicros))
+      })) } : {},
       payments: order.payments.map((payment) => ({
         clientPaymentId: payment.id,
         method: payment.method,
@@ -925,11 +1162,16 @@ function toOrderCreateEnvelope(order, deviceId, attempt2 = 1, options) {
       taxMinor: order.taxMinor,
       totalMinor: order.totalMinor,
       ...version >= 3 ? {
-        display: { ...order.display, lines: order.display.lines.map(({ lineId, amountMinor, discounts }) => ({
-          clientLineId: lineId,
-          amountMinor,
-          discounts
-        })) },
+        display: {
+          ...storedDisplay,
+          lines: order.display.lines.map(({ lineId, amountMinor, discounts }) => ({
+            clientLineId: lineId,
+            amountMinor,
+            discounts
+          })),
+          ...version === 5 && order.display.fees ? { fees: order.display.fees.map(({ id: id3, amountMinor }) => ({ clientFeeId: id3, amountMinor })) } : {},
+          ...version === 5 && order.display.shipping ? { shipping: order.display.shipping.map(({ id: id3, amountMinor }) => ({ clientShippingId: id3, amountMinor })) } : {}
+        },
         taxByRate: order.taxByRate.map(({ ratePpm, code, netMinor, amountMinor, grossMinor: grossMinor2 }) => ({
           ratePpm,
           ...code !== void 0 ? { code } : {},
@@ -988,6 +1230,9 @@ function restoreOrderDraft(saved, options) {
   for (const line of saved.lineItems) {
     const lineId = builder.addLine({
       productId: line.productId,
+      custom: line.custom,
+      taxStatus: line.taxStatus,
+      ...taxContext.rounding?.granularity === "woocommerce" ? { taxClass: line.taxClass } : {},
       variantId: line.variantId,
       name: line.name,
       sku: line.sku,
@@ -1005,6 +1250,8 @@ function restoreOrderDraft(saved, options) {
       });
     }
   }
+  for (const fee of saved.fees ?? []) builder.addFee(fee);
+  for (const charge of saved.shipping ?? []) builder.addShipping(charge);
   for (const discount of saved.discounts) {
     builder.applyOrderDiscount({
       type: discount.type,
@@ -1105,7 +1352,11 @@ function useParkedSales(drafts) {
 
 // src/receipt/build-receipt-data.ts
 function buildReceiptData(order, config) {
-  const taxLines = taxLinesByRate(order.lineItems, order.taxMinor, config.taxLabels, order.taxRounding).map(
+  const taxedLines = [...order.lineItems.map((line) => order.taxRounding?.granularity === "woocommerce" && line.netMicros !== void 0 ? { ...line, taxInclusive: order.pricesIncludeTax } : line), ...[...order.fees ?? [], ...order.shipping ?? []].map((charge) => ({
+    ...charge,
+    taxInclusive: order.pricesIncludeTax
+  }))];
+  const taxLines = taxLinesByRate(taxedLines, order.taxMinor, config.taxLabels, order.taxRounding).map(
     ({ label: label2, code, ratePpm, amountMinor }) => ({ label: label2, code, ratePpm, amountMinor })
   );
   let taxSoFar = order.lineItems.reduce(
@@ -1113,6 +1364,7 @@ function buildReceiptData(order, config) {
     0n
   );
   const lineTotals = order.lineItems.map((li) => {
+    if (order.taxRounding?.granularity === "woocommerce" && li.netMicros !== void 0) return order.pricesIncludeTax ? li.totalMinor : li.netMinor;
     if (!li.priceTaxModeConverted) return li.netMinor;
     const share = roundMicrosToMinor(taxSoFar + BigInt(li.taxMicros)) - roundMicrosToMinor(taxSoFar);
     taxSoFar += BigInt(li.taxMicros);
@@ -1145,6 +1397,8 @@ function buildReceiptData(order, config) {
       label: label(d),
       amountMinor: d.amountMinor
     })),
+    fees: (order.display.fees ?? []).map(({ name, amountMinor }) => ({ name, amountMinor })),
+    shipping: (order.display.shipping ?? []).map(({ name, amountMinor }) => ({ name, amountMinor })),
     orderDiscountMinor: order.display.orderDiscountMinor,
     totals: {
       taxInclusive: order.display.taxInclusive,
@@ -1254,7 +1508,7 @@ function uuidv7(now, randomBytes) {
 }
 
 // src/pos-order/finalize.ts
-import { minorUnitDigits } from "@tallyui/core";
+import { minorUnitDigits as minorUnitDigits2 } from "@tallyui/core";
 
 // src/outbox/logger.ts
 var outboxLogger = createLogger("outbox");
@@ -1269,8 +1523,12 @@ function withSentForm(order, posOrder) {
     ...order,
     customer,
     lineItems: order.lineItems.map((line, i) => ({ ...line, name: posOrder.lines[i].name })),
+    ...order.fees ? { fees: order.fees.map((fee, i) => ({ ...fee, name: posOrder.fees[i].name })) } : {},
+    ...order.shipping ? { shipping: order.shipping.map((charge, i) => ({ ...charge, name: posOrder.shipping[i].name })) } : {},
     display: posOrder.display ? {
       ...order.display,
+      ...order.display.fees ? { fees: order.display.fees.map((row, i) => ({ ...row, name: posOrder.display.fees[i].name })) } : {},
+      ...order.display.shipping ? { shipping: order.display.shipping.map((row, i) => ({ ...row, name: posOrder.display.shipping[i].name })) } : {},
       lines: order.display.lines.map((line, i) => ({
         ...line,
         discounts: line.discounts.map((discount, j) => ({ ...discount, label: posOrder.display.lines[i].discounts[j].label }))
@@ -1283,7 +1541,15 @@ function freezeSentForm(order) {
   const lines = order.lines.map((line) => {
     const name = cutText(line.name, PAYLOAD_STRING_MAX);
     changed ||= name !== line.name;
-    return { ...line, name };
+    const custom = line.custom && { ...line.custom, name: cutText(line.custom.name, PAYLOAD_STRING_MAX) };
+    changed ||= custom !== void 0 && custom.name !== line.custom.name;
+    return { ...line, name, ...custom ? { custom } : {} };
+  });
+  const charges = { fees: order.fees, shipping: order.shipping };
+  for (const field of ["fees", "shipping"]) if (charges[field]) charges[field] = charges[field].map((charge) => {
+    const name = cutText(charge.name, PAYLOAD_STRING_MAX);
+    changed ||= name !== charge.name;
+    return { ...charge, name };
   });
   const display = order.display && { ...order.display, lines: order.display.lines.map((line) => ({
     ...line,
@@ -1294,6 +1560,11 @@ function freezeSentForm(order) {
       return { ...discount, label };
     })
   })) };
+  for (const field of ["fees", "shipping"]) if (display?.[field]) display[field] = display[field].map((row) => {
+    const name = cutText(row.name, PAYLOAD_STRING_MAX);
+    changed ||= name !== row.name;
+    return { ...row, name };
+  });
   const payments = order.payments.map((payment) => {
     if (payment.reference === void 0) return payment;
     const reference = cutText(payment.reference, PAYLOAD_STRING_MAX);
@@ -1309,7 +1580,16 @@ function freezeSentForm(order) {
       if (!localWarnings.some((warning) => warning.code === "customer_omitted" && warning.field === field)) localWarnings.push({ code: "customer_omitted", field });
     }
   }
-  return changed ? { ...order, lines, payments, customer, ...display ? { display } : {}, ...localWarnings.length ? { localWarnings } : {} } : order;
+  return changed ? {
+    ...order,
+    lines,
+    payments,
+    customer,
+    ...charges.fees ? { fees: charges.fees } : {},
+    ...charges.shipping ? { shipping: charges.shipping } : {},
+    ...display ? { display } : {},
+    ...localWarnings.length ? { localWarnings } : {}
+  } : order;
 }
 function referenceError(label, value) {
   const reason = referenceReason(value);
@@ -1321,6 +1601,9 @@ function referenceReason(value) {
   return value.includes("\0") ? "nul" : null;
 }
 function finalizeOrder(order, options = {}) {
+  if ((order.fees?.length || order.shipping?.length || order.lineItems.some((line) => line.custom)) && (options.capabilities?.orderCreate ?? 1) < 5) {
+    throw new Error("finalize: fees, shipping and custom lines need the store to accept order.create version 5; update the store's TallyUI plugin");
+  }
   if (!order.lineItems.length) throw new Error("finalize: no lines");
   if (order.discountMinor < 0 || order.lineItems.some((line) => line.discountMinor < 0) || order.discounts.some((d) => d.amountMinor < 0)) {
     throw new Error("finalize: negative discount");
@@ -1362,15 +1645,25 @@ function finalizeOrder(order, options = {}) {
     id: newId(),
     productId: line.productId,
     ...line.variantId !== void 0 ? { variantId: line.variantId } : {},
+    ...line.custom ? { custom: {
+      name: line.name,
+      ...line.sku ? { sku: line.sku } : {},
+      ...line.taxClass !== void 0 ? { taxClass: line.taxClass } : {},
+      taxStatus: line.taxStatus ?? "taxable"
+    } } : {},
+    ...line.taxStatus !== void 0 ? { taxStatus: line.taxStatus } : {},
     name: line.name,
     sku: line.sku,
     quantity: line.quantity,
     unitPriceMinor: line.unitPriceMinor,
     discountMinor: line.discountMinor,
     netMinor: line.netMinor,
+    ...order.taxRounding?.granularity === "woocommerce" ? { netMicros: line.netMicros } : {},
     taxLines: line.taxLines.map((tax) => ({ ...tax })),
     ...line.priceTaxModeConverted ? { taxInclusive: line.taxInclusive } : {}
   }));
+  const fees = order.fees?.map((charge) => ({ ...charge, id: newId(), taxLines: charge.taxLines.map((tax) => ({ ...tax })) }));
+  const shipping = order.shipping?.map((charge) => ({ ...charge, id: newId(), taxLines: charge.taxLines.map((tax) => ({ ...tax })) }));
   const payments = order.payments.map((payment) => ({
     id: newId(),
     method: payment.method,
@@ -1408,8 +1701,10 @@ function finalizeOrder(order, options = {}) {
     }
     display = {
       currency: order.currency,
-      exponent: minorUnitDigits(order.currency),
+      exponent: minorUnitDigits2(order.currency),
       ...order.display,
+      ...fees?.length ? { fees: order.display.fees.map((row, i) => ({ ...row, id: fees[i].id })) } : {},
+      ...shipping?.length ? { shipping: order.display.shipping.map((row, i) => ({ ...row, id: shipping[i].id })) } : {},
       lines: order.display.lines.map((line, i) => ({
         lineId: lines[i].id,
         amountMinor: line.amountMinor,
@@ -1420,7 +1715,8 @@ function finalizeOrder(order, options = {}) {
         }))
       }))
     };
-    taxByRate = taxLinesByRate(order.lineItems, order.taxMinor, void 0, order.taxRounding).map(({ ratePpm, code, netMinor, amountMinor }) => ({
+    const taxedLines = [...order.lineItems, ...[...order.fees ?? [], ...order.shipping ?? []].map((charge) => ({ ...charge, taxInclusive: order.pricesIncludeTax }))];
+    taxByRate = taxLinesByRate(taxedLines, order.taxMinor, void 0, order.taxRounding).map(({ ratePpm, code, netMinor, amountMinor }) => ({
       ratePpm,
       ...code !== void 0 ? { code } : {},
       netMinor,
@@ -1435,7 +1731,7 @@ function finalizeOrder(order, options = {}) {
     }
   }
   const rounding = order.taxRounding ?? DEFAULT_TAX_ROUNDING;
-  const taxRounding = rounding.granularity === "custom" ? { granularity: "custom" } : { granularity: rounding.granularity, mode: rounding.mode };
+  const taxRounding = rounding.granularity === "custom" ? { granularity: "custom" } : rounding.granularity === "woocommerce" ? { granularity: "woocommerce", roundAtSubtotal: rounding.roundAtSubtotal } : { granularity: rounding.granularity, mode: rounding.mode };
   const now = (options.now ?? /* @__PURE__ */ new Date()).toISOString();
   return freezeSentForm({
     id: id2,
@@ -1448,6 +1744,8 @@ function finalizeOrder(order, options = {}) {
     pricesIncludeTax: order.pricesIncludeTax,
     lines,
     payments,
+    ...fees?.length ? { fees } : {},
+    ...shipping?.length ? { shipping } : {},
     subtotalMinor: order.subtotalMinor,
     discountMinor: order.discountMinor,
     taxMinor: order.taxMinor,
@@ -1470,7 +1768,7 @@ function finalizeOrder(order, options = {}) {
 import { addRxPlugin } from "rxdb";
 import { RxDBMigrationSchemaPlugin } from "rxdb/plugins/migration-schema";
 var posOrderSchema = {
-  version: 7,
+  version: 8,
   primaryKey: "id",
   type: "object",
   additionalProperties: false,
@@ -1500,9 +1798,17 @@ var posOrderSchema = {
         name: { type: "string" },
         sku: { type: "string" },
         quantity: { type: "integer" },
+        taxStatus: { type: "string", enum: ["taxable", "none"] },
+        custom: { type: "object", additionalProperties: false, properties: {
+          name: { type: "string", minLength: 1, maxLength: 255 },
+          sku: { type: "string", maxLength: 64 },
+          taxClass: { type: "string", maxLength: 64 },
+          taxStatus: { type: "string", enum: ["taxable", "none"] }
+        }, required: ["name", "taxStatus"] },
         unitPriceMinor: { type: "integer" },
         discountMinor: { type: "integer" },
         netMinor: { type: "integer" },
+        netMicros: { type: "string", pattern: "^-?[0-9]{1,24}$", maxLength: 25 },
         taxLines: { type: "array", items: {
           type: "object",
           properties: { code: { type: "string" }, ratePpm: { type: "integer" }, taxMicros: { type: "string" } },
@@ -1511,6 +1817,43 @@ var posOrderSchema = {
       },
       required: ["id", "productId", "name", "sku", "quantity", "unitPriceMinor", "discountMinor", "netMinor", "taxLines"]
     } },
+    fees: { type: "array", items: { type: "object", additionalProperties: false, properties: {
+      id: { type: "string", maxLength: 36 },
+      name: { type: "string", minLength: 1, maxLength: 255 },
+      amountMinor: { type: "integer", minimum: 0 },
+      taxClass: { type: "string", maxLength: 64 },
+      taxStatus: { type: "string", enum: ["taxable", "none"] },
+      netMinor: { type: "integer" },
+      taxMicros: { type: "string" },
+      netMicros: { type: "string", pattern: "^-?[0-9]{1,24}$", maxLength: 25 },
+      totalMinor: { type: "integer" },
+      taxLines: { type: "array", items: { type: "object", additionalProperties: false, properties: {
+        code: { type: "string", maxLength: 255 },
+        ratePpm: { type: "integer" },
+        taxMicros: { type: "string" },
+        rateId: { type: "integer" },
+        compound: { type: "boolean" }
+      }, required: ["ratePpm", "taxMicros"] } }
+    }, required: ["id", "name", "amountMinor", "taxStatus", "taxLines", "netMinor", "taxMicros"] } },
+    shipping: { type: "array", items: { type: "object", additionalProperties: false, properties: {
+      id: { type: "string", maxLength: 36 },
+      name: { type: "string", minLength: 1, maxLength: 255 },
+      methodId: { type: "string", maxLength: 64 },
+      amountMinor: { type: "integer", minimum: 0 },
+      taxClass: { type: "string", maxLength: 64 },
+      taxStatus: { type: "string", enum: ["taxable", "none"] },
+      netMinor: { type: "integer" },
+      taxMicros: { type: "string" },
+      netMicros: { type: "string", pattern: "^-?[0-9]{1,24}$", maxLength: 25 },
+      totalMinor: { type: "integer" },
+      taxLines: { type: "array", items: { type: "object", additionalProperties: false, properties: {
+        code: { type: "string", maxLength: 255 },
+        ratePpm: { type: "integer" },
+        taxMicros: { type: "string" },
+        rateId: { type: "integer" },
+        compound: { type: "boolean" }
+      }, required: ["ratePpm", "taxMicros"] } }
+    }, required: ["id", "name", "amountMinor", "taxStatus", "taxLines", "netMinor", "taxMicros"] } },
     payments: { type: "array", items: {
       type: "object",
       properties: {
@@ -1548,11 +1891,12 @@ var posOrderSchema = {
     }, required: ["since", "reason", "isolated"] },
     lateSessionId: { type: "string" },
     taxRounding: { type: "object", additionalProperties: false, properties: {
-      granularity: { type: "string", enum: ["per_order", "per_line_items", "per_rate_group_items", "custom"] },
+      granularity: { type: "string", enum: ["per_order", "per_line_items", "per_rate_group_items", "custom", "woocommerce"] },
+      roundAtSubtotal: { type: "boolean" },
       mode: { type: "string", enum: ["half_away_from_zero", "half_up"] }
     }, required: ["granularity"] },
-    sentVersion: { type: "integer", minimum: 1, maximum: 4 },
-    downgradedFrom: { type: "integer", minimum: 1, maximum: 4 },
+    sentVersion: { type: "integer", minimum: 1, maximum: 5 },
+    downgradedFrom: { type: "integer", minimum: 1, maximum: 5 },
     // The nested objects are closed too: loosening a schema later is free, tightening one costs a migration.
     display: { type: "object", additionalProperties: false, properties: {
       currency: { type: "string" },
@@ -1563,6 +1907,16 @@ var posOrderSchema = {
       taxMinor: { type: "integer" },
       totalMinor: { type: "integer" },
       orderDiscountMinor: { type: "integer" },
+      fees: { type: "array", items: { type: "object", additionalProperties: false, properties: {
+        id: { type: "string", maxLength: 36 },
+        name: { type: "string", minLength: 1, maxLength: 255 },
+        amountMinor: { type: "integer" }
+      }, required: ["id", "name", "amountMinor"] } },
+      shipping: { type: "array", items: { type: "object", additionalProperties: false, properties: {
+        id: { type: "string", maxLength: 36 },
+        name: { type: "string", minLength: 1, maxLength: 255 },
+        amountMinor: { type: "integer" }
+      }, required: ["id", "name", "amountMinor"] } },
       lines: { type: "array", items: {
         type: "object",
         additionalProperties: false,
@@ -1625,7 +1979,7 @@ function posOrderCollection() {
   };
   return {
     schema: posOrderSchema,
-    migrationStrategies: { 1: identity2, 2: identity2, 3: identity2, 4: identity2, 5: recordSent, 6: recordRounding, 7: identity2 }
+    migrationStrategies: { 1: identity2, 2: identity2, 3: identity2, 4: identity2, 5: recordSent, 6: recordRounding, 7: identity2, 8: identity2 }
   };
 }
 
@@ -2525,8 +2879,8 @@ async function writeClosure({
   const roundings = /* @__PURE__ */ new Set();
   for (const order of bound) {
     const recorded = order.taxRounding ?? DEFAULT_TAX_ROUNDING;
-    const { granularity, mode } = recorded.granularity === "custom" ? DEFAULT_TAX_ROUNDING : recorded;
-    roundings.add(`${granularity} ${mode}`);
+    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 existing2 = taxRates.get(String(ratePpm));
@@ -2895,7 +3249,7 @@ function envelope(row, context, xreport = false) {
   });
   return {
     closure: {
-      has_sales: row.period_sales_total != null || row.period_refunds_total != null || Number(breakdowns.transaction_count) > 0,
+      has_sales: Number(breakdowns.transaction_count ?? 0) > 0 || Number(row.period_sales_total || 0) !== 0 || Number(row.period_refunds_total || 0) !== 0,
       has_perpetual: row.perpetual_sales_total != null || row.perpetual_refunds_total != null,
       ...Object.fromEntries(
         ["payment_methods", "tax_rates", "movements"].map((key) => [`has_${key}`, Object.keys(breakdowns[key] ?? {}).length > 0])
@@ -3556,7 +3910,8 @@ function addEntryToCart(builder, entry, traits, currency) {
     sku: variant.sku ?? "",
     imageUrl: traits.getImageUrl?.(product),
     unitPrice,
-    taxClass: traits.getTaxClass?.(product, variant.id)
+    taxClass: traits.getTaxClass?.(product, variant.id),
+    ...traits.getTaxStatus?.(product, variant.id) === "none" ? { taxStatus: "none" } : {}
   });
 }
 
@@ -3628,10 +3983,10 @@ function useSale(settings, opts) {
     const subscription = rendered.order$.subscribe(setOrder);
     return () => subscription.unsubscribe();
   }, [rendered]);
-  const idle3 = stage.kind === "cart" && !order.lineItems.length;
+  const idle3 = stage.kind === "cart" && !order.lineItems.length && !order.fees?.length && !order.shipping?.length;
   useLayoutEffect(() => {
     const live = builderNow.current.getSnapshot();
-    const liveIdle = stageNow.current.kind === "cart" && !live.lineItems.length && !inFlight.current && !pending.current;
+    const liveIdle = stageNow.current.kind === "cart" && !live.lineItems.length && !live.fees?.length && !live.shipping?.length && !inFlight.current && !pending.current;
     if (liveIdle && (madeWith.current.taxContext !== taxContext || madeWith.current.currency !== settings.currency)) resetSale(live.customer ?? null);
   });
   useEffect4(() => () => {
@@ -3754,6 +4109,85 @@ function useSale(settings, opts) {
     setQuantity(lineId, quantity) {
       if (!locked()) builderNow.current.updateQuantity(lineId, quantity);
     },
+    /** ADR-075: adds a fee; returns its id or the builder's refusal. */
+    addFee(input) {
+      if (locked()) return SALE_SAVING;
+      try {
+        return { id: builderNow.current.addFee(input) };
+      } catch (error2) {
+        if (error2 instanceof Error) return error2.message;
+        throw error2;
+      }
+    },
+    /** ADR-075: updates a fee; returns a refusal or null. */
+    updateFee(id2, patch) {
+      if (locked()) return SALE_SAVING;
+      try {
+        builderNow.current.updateFee(id2, patch);
+        return null;
+      } catch (error2) {
+        if (error2 instanceof Error) return error2.message;
+        throw error2;
+      }
+    },
+    /** ADR-075: removes a fee; returns a refusal or null. */
+    removeFee(id2) {
+      if (locked()) return SALE_SAVING;
+      try {
+        builderNow.current.removeFee(id2);
+        return null;
+      } catch (error2) {
+        if (error2 instanceof Error) return error2.message;
+        throw error2;
+      }
+    },
+    /** ADR-075: adds shipping; returns its id or the builder's refusal. */
+    addShipping(input) {
+      if (locked()) return SALE_SAVING;
+      try {
+        return { id: builderNow.current.addShipping(input) };
+      } catch (error2) {
+        if (error2 instanceof Error) return error2.message;
+        throw error2;
+      }
+    },
+    /** ADR-075: updates shipping; returns a refusal or null. */
+    updateShipping(id2, patch) {
+      if (locked()) return SALE_SAVING;
+      try {
+        builderNow.current.updateShipping(id2, patch);
+        return null;
+      } catch (error2) {
+        if (error2 instanceof Error) return error2.message;
+        throw error2;
+      }
+    },
+    /** ADR-075: removes shipping; returns a refusal or null. */
+    removeShipping(id2) {
+      if (locked()) return SALE_SAVING;
+      try {
+        builderNow.current.removeShipping(id2);
+        return null;
+      } catch (error2) {
+        if (error2 instanceof Error) return error2.message;
+        throw error2;
+      }
+    },
+    /** ADR-075: adds a distinct custom product line; returns its id or the builder's refusal. */
+    addCustomLine(input) {
+      if (locked()) return SALE_SAVING;
+      try {
+        return { id: builderNow.current.addLine({
+          ...input,
+          custom: true,
+          productId: `custom:${uuidv7()}`,
+          unitPrice: { amount: input.priceMinor, currency: madeWith.current.currency.toUpperCase() }
+        }) };
+      } catch (error2) {
+        if (error2 instanceof Error) return error2.message;
+        throw error2;
+      }
+    },
     /** Sets a line's unit price in minor units of its own tax mode, recomputing discounts and tax; returns a refusal or null. */
     setUnitPrice(lineId, amountMinor) {
       if (locked()) return SALE_SAVING;
@@ -3921,7 +4355,7 @@ function useSale(settings, opts) {
       if (stageNow.current.kind !== "cart") return "Finish or cancel the payment before parking the sale";
       const builder = builderNow.current;
       const snapshot = builder.getSnapshot();
-      if (!snapshot.lineItems.length) return "There is nothing to park";
+      if (!snapshot.lineItems.length && !snapshot.fees?.length && !snapshot.shipping?.length) return "There is nothing to park";
       await writeOrderDraft(opts.drafts, snapshot);
       if (builderNow.current !== builder || builder.getSnapshot() !== snapshot) return "The sale changed while it was being parked; park it again";
       resetSale(null);
@@ -3933,7 +4367,7 @@ function useSale(settings, opts) {
       if (!opts.drafts) throw new Error("useSale: resume() needs the drafts option");
       const live = builderNow.current;
       const liveSnapshot = live.getSnapshot();
-      if (stageNow.current.kind !== "cart" || liveSnapshot.lineItems.length) return "Park or clear the current sale first";
+      if (stageNow.current.kind !== "cart" || liveSnapshot.lineItems.length || liveSnapshot.fees?.length || liveSnapshot.shipping?.length) return "Park or clear the current sale first";
       const doc = await opts.drafts.findOne(draftId).exec();
       if (!doc) return "That parked sale is no longer there";
       const saved = JSON.parse(doc.toJSON().data);
@@ -4267,6 +4701,7 @@ function createOrderOutbox(options) {
       const serverMax = firstSend && validMax(await Promise.resolve().then(() => options.getMaxOrderCreateVersion?.()).catch((cause) => {
         outboxLogger.warn("Failed to read capabilities", { cause });
       })) || 3;
+      const localOrders = /* @__PURE__ */ new Map();
       const batch = await Promise.all(orders.map(async (order) => {
         const frozen = freezeSentForm(order);
         const attempt2 = (attempts.get(order.commandId) ?? 0) + 1;
@@ -4276,14 +4711,15 @@ function createOrderOutbox(options) {
           envelope2 = toOrderCreateEnvelope(frozen, deviceId, attempt2, { maxVersion: order.sentVersion ?? serverMax });
         } catch (cause) {
           if (!(cause instanceof UnsupportedOrderVersionError)) throw cause;
-          envelope2 = toOrderCreateEnvelope(frozen, deviceId, attempt2, { maxVersion: 3 });
+          envelope2 = toOrderCreateEnvelope(frozen, deviceId, attempt2, { maxVersion: cause.needed === 5 ? 5 : 3 });
         }
         if (frozen !== order || order.sentVersion === void 0) {
           await (await collection.findOne(order.id).exec())?.incrementalModify((data) => ({ ...freezeSentForm(data), sentVersion: data.sentVersion ?? envelope2.version }));
         }
+        localOrders.set(envelope2.id, frozen);
         return envelope2;
       }));
-      let outcome = await transport.send(batch);
+      let outcome = await transport.send(batch, { local: { orders: localOrders } });
       backendNotFound.record(outcome, now());
       if (outcome.kind !== "retry" || outcome.reason !== "network") {
         const at2 = now();