@pisell/pisellos 2.2.314 → 2.2.316

package/lib/shared/receipt/small-ticket.js

@@ -0,0 +1,2555 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildSmallTicketData = buildSmallTicketData;
+exports.hasSmallTicketData = hasSmallTicketData;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _decimal = _interopRequireDefault(require("decimal.js"));
+var _holderRelations = require("../../modules/Order/holderRelations");
+var _pickupTiming = require("../../modules/Order/pickupTiming");
+var _templateVisibility = require("./templateVisibility");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+const DEFAULT_LOCALES = ['en', 'zh_CN'];
+
+// Attach provenance to a private copy BEFORE any locale-dependent filtering.
+// Symbols survive the existing spread-based normalization, never enter JSON,
+// and leave both the caller's snapshot and the default native contract intact.
+const RECEIPT_SOURCE = Symbol('customerReceiptSource');
+function copyReceiptSource(value, path = 'order') {
+  if (Array.isArray(value)) return value.map((item, index) => copyReceiptSource(item, `${path}/${index}`));
+  if (!value || typeof value !== 'object' || Object.getPrototypeOf(value) !== Object.prototype) return value;
+  const id = value.metadata?.unique_identification_number ?? value.product_uid ?? value.booking_uid ?? value.order_payment_id ?? value.payment_number ?? value.order_refund_id ?? value.refund_number ?? value.id;
+  const source = Object.fromEntries(Object.entries(value).map(([key, item]) => [key, copyReceiptSource(item, `${path}/${key}`)]));
+  // Retain the original occurrence even when a catalogue ID appears twice.
+  return {
+    ...source,
+    [RECEIPT_SOURCE]: `${path}${id != null ? `@${encodeURIComponent(String(id))}` : ''}`
+  };
+}
+function receiptKey(source, kind, valueKind = 'shared') {
+  const key = source?.[RECEIPT_SOURCE];
+  return typeof key === 'string' ? {
+    receipt_key: `${key}#${kind}`,
+    receipt_value_kind: valueKind
+  } : {};
+}
+function receiptSourceIndex(source, index) {
+  return source?.[RECEIPT_SOURCE] ? {
+    receipt_source_index: index
+  } : {};
+}
+function removePrivateReceiptSource(value) {
+  if (!value || typeof value !== 'object') return;
+  delete value[RECEIPT_SOURCE];
+  Object.values(value).forEach(removePrivateReceiptSource);
+}
+function receiptTimeKey(source, kind) {
+  const identity = receiptKey(source, kind);
+  return identity.receipt_key ? {
+    ...identity,
+    receipt_item_kind: 'shared'
+  } : {};
+}
+const SERVICE_TYPE_LABEL_KEYS = {
+  takeaway: 'takeAway',
+  pick_up: 'pickUp',
+  table_service: 'tableService',
+  delivery: 'delivery',
+  room_service: 'roomService',
+  dine_in: 'dineIn',
+  delivery_by_uber: 'deliveryByUber',
+  delivery_by_panda: 'deliveryByPanda',
+  delivery_by_merchant: 'deliveryByMerchant'
+};
+const LABELS = {
+  en: {
+    contactName: 'Contact name',
+    contactMobile: 'Contact Mobile',
+    email: 'email',
+    dineIn: 'Dine in',
+    takeAway: 'Takeaway',
+    delivery: 'Delivery',
+    pickUp: 'Pickup',
+    tableService: 'Table Service',
+    roomService: 'Room Service',
+    deliveryByUber: 'Uber Eats Delivery',
+    deliveryByPanda: 'HungryPanda Delivery',
+    deliveryByMerchant: 'Merchant Delivery',
+    shopService: 'Dine-in',
+    pickUpTime: 'Pick-up time',
+    asap: 'ASAP',
+    cash: 'Cash',
+    cashReceived: 'Cash received',
+    changeDue: 'Change due',
+    eftpos: 'Eftpos',
+    wallet: 'Wallet',
+    giftCard: 'Gift card',
+    pointCard: 'Point card',
+    balance: 'Balance',
+    validity: 'Validity',
+    remainingAmount: 'Remaining amount',
+    redeemPoints: 'Redeem points',
+    remainingPoints: 'Points balance',
+    entitlementRemaining: 'Remaining',
+    table: 'Table',
+    bookingId: 'Booking ID',
+    bookingDateTime: 'Date & time',
+    bookingResource: 'Resource',
+    bookingHolder: 'Holder',
+    productHolder: 'Holder',
+    orderDiscount: 'Order discount',
+    manualDiscount: 'Manual discount',
+    manualMarkup: 'Manual markup',
+    payProcessingFee: 'Pay processing fee',
+    surchargeIncluded: 'Surcharge(Included)',
+    rounding: 'Rounding',
+    gross: 'Gross',
+    tare: 'Tare',
+    handoverTime: 'Handover time',
+    refund: 'Refund'
+  },
+  zh_CN: {
+    contactName: '联系人姓名',
+    contactMobile: '联系电话',
+    email: '邮箱',
+    dineIn: '堂食',
+    takeAway: '外带',
+    delivery: '配送',
+    pickUp: '自取',
+    tableService: '送餐到桌',
+    roomService: '客房服务',
+    deliveryByUber: 'Uber 配送',
+    deliveryByPanda: '熊猫外卖配送',
+    deliveryByMerchant: '商家配送',
+    shopService: '堂食',
+    pickUpTime: '取餐时间',
+    asap: '尽快',
+    cash: '现金支付',
+    cashReceived: '收取现金',
+    changeDue: '找零',
+    eftpos: '刷卡支付',
+    wallet: '钱包支付',
+    giftCard: '礼品卡',
+    pointCard: '积分卡',
+    balance: '余额',
+    validity: '有效期',
+    remainingAmount: '剩余金额',
+    redeemPoints: '本次使用积分',
+    remainingPoints: '积分余额',
+    entitlementRemaining: '剩余次数',
+    table: '桌台',
+    bookingId: '预约编号',
+    bookingDateTime: '日期和时间',
+    bookingResource: '资源',
+    bookingHolder: '预约人',
+    productHolder: '持有人',
+    orderDiscount: '整单折扣',
+    manualDiscount: '手动折扣',
+    manualMarkup: '手动加价',
+    payProcessingFee: '支付手续费',
+    surchargeIncluded: '手续费(已含)',
+    rounding: '抹零',
+    gross: '重量',
+    tare: '去皮',
+    handoverTime: '交付时间',
+    refund: '退款'
+  },
+  zh_HK: {
+    contactName: '聯絡人姓名',
+    contactMobile: '聯絡電話',
+    email: '電郵',
+    dineIn: '堂食',
+    takeAway: '外帶',
+    delivery: '配送',
+    pickUp: '自取',
+    tableService: '送餐到桌',
+    roomService: '客房服務',
+    deliveryByUber: 'Uber 配送',
+    deliveryByPanda: '熊貓外賣配送',
+    deliveryByMerchant: '商家配送',
+    shopService: '堂食',
+    pickUpTime: '取餐時間',
+    asap: '盡快',
+    cash: '現金支付',
+    cashReceived: '收取現金',
+    changeDue: '找零',
+    eftpos: '刷卡支付',
+    wallet: '錢包支付',
+    giftCard: '禮品卡',
+    pointCard: '積分卡',
+    balance: '餘額',
+    validity: '有效期',
+    remainingAmount: '剩餘金額',
+    redeemPoints: '本次使用積分',
+    remainingPoints: '積分餘額',
+    entitlementRemaining: '剩餘次數',
+    table: '桌台',
+    bookingId: '預約編號',
+    bookingDateTime: '日期和時間',
+    bookingResource: '資源',
+    bookingHolder: '預約人',
+    productHolder: '持有人',
+    orderDiscount: '整單折扣',
+    manualDiscount: '手動折扣',
+    manualMarkup: '手動加價',
+    payProcessingFee: '支付手續費',
+    surchargeIncluded: '手續費(已含)',
+    rounding: '抹零',
+    gross: '重量',
+    tare: '去皮',
+    handoverTime: '交付時間',
+    refund: '退款'
+  },
+  ja: {
+    contactName: '連絡先名',
+    contactMobile: '連絡先電話',
+    email: 'メール',
+    dineIn: '店内飲食',
+    takeAway: 'テイクアウト',
+    delivery: '配達',
+    pickUp: '受け取り',
+    tableService: 'テーブルサービス',
+    roomService: 'ルームサービス',
+    deliveryByUber: 'Uber Eats 配達',
+    deliveryByPanda: 'HungryPanda 配達',
+    deliveryByMerchant: '店舗による配達',
+    shopService: '店内飲食',
+    pickUpTime: '受取時間',
+    asap: 'できるだけ早く',
+    cash: '現金',
+    eftpos: 'カード',
+    wallet: 'ウォレット',
+    giftCard: 'ギフトカード',
+    pointCard: 'ポイントカード',
+    balance: '残高',
+    validity: '有効期限',
+    remainingAmount: '残高',
+    redeemPoints: '利用ポイント',
+    remainingPoints: 'ポイント残高',
+    entitlementRemaining: '残り回数',
+    table: 'テーブル',
+    bookingId: '予約ID',
+    bookingDateTime: '日時',
+    bookingResource: 'リソース',
+    bookingHolder: '予約者',
+    productHolder: '利用者',
+    orderDiscount: '注文割引',
+    manualDiscount: '手動割引',
+    manualMarkup: '手動値上げ',
+    payProcessingFee: '決済手数料',
+    rounding: '端数調整',
+    gross: '総重量',
+    tare: '風袋',
+    handoverTime: '受け渡し時間',
+    refund: '返金',
+    cashReceived: 'お預かり',
+    changeDue: 'お釣り'
+  },
+  pt: {
+    contactName: 'Nome de contato',
+    contactMobile: 'Celular de contato',
+    email: 'e-mail',
+    dineIn: 'Consumo no local',
+    takeAway: 'Para levar',
+    delivery: 'Entrega',
+    pickUp: 'Recolha',
+    tableService: 'Serviço à mesa',
+    roomService: 'Serviço de quarto',
+    deliveryByUber: 'Entrega pela Uber Eats',
+    deliveryByPanda: 'Entrega pela HungryPanda',
+    deliveryByMerchant: 'Entrega pelo comerciante',
+    shopService: 'Consumo no local',
+    pickUpTime: 'Hora de recolha',
+    asap: 'Assim que possível',
+    cash: 'Dinheiro',
+    eftpos: 'Cartão',
+    wallet: 'Carteira',
+    giftCard: 'Cartão-presente',
+    pointCard: 'Cartão de pontos',
+    balance: 'Saldo',
+    validity: 'Validade',
+    remainingAmount: 'Saldo restante',
+    redeemPoints: 'Pontos utilizados',
+    remainingPoints: 'Saldo de pontos',
+    entitlementRemaining: 'Utilizações restantes',
+    table: 'Mesa',
+    bookingId: 'ID da reserva',
+    bookingDateTime: 'Data e hora',
+    bookingResource: 'Recurso',
+    bookingHolder: 'Titular',
+    productHolder: 'Titular',
+    orderDiscount: 'Desconto do pedido',
+    manualDiscount: 'Desconto manual',
+    manualMarkup: 'Acréscimo manual',
+    payProcessingFee: 'Taxa de processamento',
+    rounding: 'Arredondamento',
+    gross: 'Peso bruto',
+    tare: 'Tara',
+    handoverTime: 'Hora de entrega',
+    refund: 'Reembolso',
+    cashReceived: 'Dinheiro recebido',
+    changeDue: 'Troco'
+  }
+};
+function buildSmallTicketData(params) {
+  const order = params.includeReceiptKeys ? copyReceiptSource(params.order || {}) : params.order || {};
+  const shopInfo = params.shopInfo || {};
+  const locales = resolveLocales(shopInfo, params.locales);
+  const productMap = params.productMap || {};
+  const visibility = (0, _templateVisibility.resolveInvoiceDataVisibility)(params.templateSettings);
+  const result = locales.reduce((data, locale) => {
+    data[locale] = buildLocaleData({
+      order,
+      shopInfo,
+      locale,
+      productMap,
+      visibility
+    });
+    return data;
+  }, {});
+  if (params.includeReceiptKeys) removePrivateReceiptSource(result);
+  return result;
+}
+function hasSmallTicketData(value) {
+  return !!value && typeof value === 'object' && Object.keys(value).length > 0;
+}
+function buildLocaleData(params) {
+  const {
+    order,
+    shopInfo,
+    locale,
+    productMap,
+    visibility
+  } = params;
+  const products = buildProducts(order, locale, productMap);
+  const summary = getSummary(order);
+  const currencySymbol = getCurrencySymbol(order, shopInfo);
+  const financials = resolveReceiptFinancials(order, summary);
+  const delivery = buildDelivery(order, locale, visibility.handover);
+  return {
+    base_data: buildBaseData({
+      order,
+      shopInfo,
+      locale,
+      currencySymbol,
+      financials
+    }),
+    products,
+    fees: buildFees({
+      order,
+      shopInfo,
+      locale,
+      products,
+      summary,
+      currencySymbol,
+      financials
+    }),
+    customer: buildCustomer(order, locale, visibility.customer),
+    appointment: buildAppointment(order, locale, visibility.lineGroups.resourceTitle),
+    ...(delivery.length ? {
+      delivery
+    } : {}),
+    resources: buildResources(order, locale),
+    payment_data: buildPaymentData({
+      order,
+      locale,
+      currencySymbol
+    }),
+    wallets: visibility.card.show ? buildWallets({
+      order,
+      locale,
+      currencySymbol,
+      passTypes: visibility.card.passTypes
+    }) : [],
+    // Native printers fall back to tickets when wallets is empty. Legacy rows
+    // have no trustworthy asset tags, so they cannot bypass a card whitelist.
+    tickets: visibility.card.show && visibility.card.passTypes === null && Array.isArray(order.tickets) ? order.tickets.map(group => Array.isArray(group) ? group.map(row => row && typeof row === 'object' ? {
+      ...row,
+      ...receiptKey(row, 'ticket')
+    } : row) : group) : [],
+    source_shop: [],
+    refund_data: buildRefundData({
+      order,
+      locale,
+      currencySymbol
+    }),
+    expend_data: []
+  };
+}
+function buildBaseData(params) {
+  const {
+    order,
+    shopInfo,
+    locale,
+    currencySymbol,
+    financials
+  } = params;
+  const orderNumber = stringify(order.buzzer || order.shop_full_order_number);
+  return {
+    shop_name: stringify(shopInfo.name || order.shop_name),
+    note: stringify(order.note),
+    shop_order_number: stringify(order.shop_order_number),
+    order_number: orderNumber,
+    shop_tax_number: stringify(shopInfo.tax_number || order.shop_tax_number),
+    shop_phone: stringify(shopInfo.phone || order.shop_phone),
+    shop_address: stringify(shopInfo.receipt_address || shopInfo.address || buildShopAddress(shopInfo) || order.shop_address),
+    original_payment_status: financials.paymentStatus,
+    payment_status: financials.paymentStatus,
+    total_amount: formatMoney(financials.totalAmount, currencySymbol),
+    has_pay: formatMoney(financials.netPaymentApplied, currencySymbol),
+    amount_gap: formatCalculatedMoney(financials.amountGap ?? 0, currencySymbol),
+    is_repeat: 0,
+    buzzer: stringify(order.buzzer || order.pickup_number || order.metadata?.buzzer),
+    order_no: orderNumber,
+    order_time: formatDateTime(order.created_at || order.sales_time || new Date(), locale),
+    ...(isPresentId(order.updated_at) ? {
+      updated_at: formatDateTime(order.updated_at, locale)
+    } : {})
+  };
+}
+function buildProducts(order, locale, productMap) {
+  const products = Array.isArray(order.products) ? order.products : [];
+  const allergyByProductUid = buildProductAllergyMap(order, locale);
+  return products.map((rawProduct, sourceIndex) => {
+    const product = restoreReceiptDiscountHierarchy(rawProduct);
+    const quantity = toNumber(product.product_quantity ?? product.quantity ?? product.num ?? 1, 1);
+    const originalPrice = product.original_price ?? product.selling_price ?? product.payment_price ?? product.price ?? 0;
+    const sellingPrice = product.selling_price ?? product.payment_price ?? product.price ?? originalPrice;
+    const productTitle = resolveProductTitle({
+      product,
+      productMap,
+      locale
+    });
+    const parentProduct = resolveProductFromMap(product.product_id ?? product.id, productMap);
+    const currencySymbol = getCurrencySymbol(order, null);
+    const options = normalizeProductOptions({
+      product,
+      locale,
+      currencySymbol,
+      parentProduct
+    });
+    const combinations = normalizeProductCombinations({
+      product,
+      productMap,
+      locale,
+      currencySymbol,
+      parentProduct
+    });
+    const resolvedVariant = resolveProductVariantText({
+      product,
+      parentProduct,
+      locale
+    });
+    const productUid = firstPresentValue(product.metadata?.unique_identification_number, product.unique_identification_number);
+    const bookingUid = firstPresentValue(product.booking_uid, product.metadata?.booking_uid);
+    const extensionList = buildProductExtensionList({
+      product,
+      locale,
+      currencySymbol,
+      quantity,
+      originalPrice
+    });
+    const holderName = (0, _holderRelations.hasProductBooking)(product) ? '' : (0, _holderRelations.getProductHolderRelations)(order, product).map(relation => getLocalizedValue(relation.metadata?.name, locale).trim()).filter(Boolean).join(', ');
+    if (holderName) {
+      // 复用 Web Invoice / 原生均支持的文本扩展行，不混入金额或商品备注。
+      extensionList.push({
+        ...receiptKey(rawProduct, 'product-holder'),
+        item: `${label(locale, 'productHolder')}: ${holderName}`,
+        value: ''
+      });
+    }
+    const productNote = resolveProductNote(product, locale);
+    const allergy = isPresentId(productUid) ? allergyByProductUid.get(String(productUid).trim()) || '' : '';
+    const basePrice = resolveProductBasePrice(product);
+    const resolvedCombinations = Array.isArray(product.combinations) && product.combinations.length ? normalizeExistingCombinations(product.combinations, locale, currencySymbol) : combinations;
+    const shouldIncludeBasePrice = options.length > 0 || resolvedCombinations.length > 0 || hasProductDiscount(product, extensionList);
+    return {
+      ...receiptKey(rawProduct, 'product'),
+      ...(rawProduct[RECEIPT_SOURCE] ? {
+        receipt_source_index: sourceIndex
+      } : {}),
+      product_title: productTitle,
+      product_quantity: quantity,
+      selling_price: formatMoney(sellingPrice, currencySymbol),
+      total_selling_price: formatCalculatedMoney(new _decimal.default(toMoneyNumber(sellingPrice)).mul(quantity), currencySymbol),
+      original_price: formatMoney(originalPrice, currencySymbol),
+      ...(shouldIncludeBasePrice ? {
+        base_price: formatCalculatedMoney(basePrice ?? 0, currencySymbol)
+      } : {}),
+      total_original_price: formatMoney(new _decimal.default(toMoneyNumber(originalPrice)).mul(quantity), currencySymbol),
+      ...(options.length ? {
+        options_total_price: sumNormalizedOptionTotals(options, currencySymbol)
+      } : {}),
+      ...(resolvedCombinations.length ? {
+        package_items_total_price: sumCombinationTotals(resolvedCombinations, currencySymbol)
+      } : {}),
+      extension_list: extensionList,
+      ...(isPresentId(productUid) ? {
+        product_uid: productUid
+      } : {}),
+      ...(isPresentId(bookingUid) ? {
+        booking_uid: bookingUid
+      } : {}),
+      ...(productNote ? {
+        product_note: productNote
+      } : {}),
+      ...(allergy ? {
+        allergy
+      } : {}),
+      ...(options.length ? {
+        options
+      } : {}),
+      ...(resolvedVariant ? {
+        variant: resolvedVariant
+      } : {}),
+      ...(resolvedCombinations.length ? {
+        combinations: resolvedCombinations
+      } : {})
+    };
+  });
+}
+const RECEIPT_BUNDLE_MAP_ID_KEY = 'custom_product_bundle_map_id';
+function restoreReceiptDiscountHierarchy(source) {
+  if (!source || typeof source !== 'object' || Array.isArray(source)) {
+    return source;
+  }
+  const childKey = Array.isArray(source.combinations) && source.combinations.length ? 'combinations' : Array.isArray(source.product_bundle) && source.product_bundle.length ? 'product_bundle' : null;
+  if (!childKey) return {
+    ...source
+  };
+  const children = source[childKey].map(child => child && typeof child === 'object' && !Array.isArray(child) ? restoreReceiptDiscountHierarchy(child) : child);
+  const restored = {
+    ...source,
+    [childKey]: children
+  };
+  if (!Array.isArray(source.discount_list) || !source.discount_list.length) {
+    return restored;
+  }
+  const descendantsByMapId = new Map();
+  indexReceiptDiscountTargets(children, descendantsByMapId);
+  if (!descendantsByMapId.size) return restored;
+  const ownDiscounts = [];
+  for (const discount of source.discount_list) {
+    const mapId = getReceiptDiscountBundleMapId(discount);
+    const target = mapId ? descendantsByMapId.get(mapId) : undefined;
+    if (!target) {
+      ownDiscounts.push(discount);
+      continue;
+    }
+    const targetDiscounts = Array.isArray(target.discount_list) ? target.discount_list : [];
+    if (!targetDiscounts.some(item => isSameReceiptDiscount(item, discount))) {
+      target.discount_list = [...targetDiscounts, discount];
+    }
+  }
+  restored.discount_list = ownDiscounts;
+  return restored;
+}
+function indexReceiptDiscountTargets(nodes, targets) {
+  for (const node of nodes) {
+    if (!node || typeof node !== 'object' || Array.isArray(node)) continue;
+    const mapId = getReceiptBundleMapId(node);
+    if (mapId && !targets.has(mapId)) targets.set(mapId, node);
+    const children = Array.isArray(node.combinations) && node.combinations.length ? node.combinations : Array.isArray(node.product_bundle) ? node.product_bundle : [];
+    indexReceiptDiscountTargets(children, targets);
+  }
+}
+function normalizeReceiptId(value) {
+  if (value === undefined || value === null) return null;
+  const normalized = String(value).trim();
+  return normalized ? normalized : null;
+}
+function getReceiptBundleMapId(node) {
+  return normalizeReceiptId(node.metadata?.[RECEIPT_BUNDLE_MAP_ID_KEY] ?? node._id);
+}
+function getReceiptDiscountBundleMapId(discount) {
+  return normalizeReceiptId(discount?.metadata?.[RECEIPT_BUNDLE_MAP_ID_KEY]);
+}
+function isSameReceiptDiscount(left, right) {
+  const leftOrderDiscountId = normalizeReceiptId(left?.order_discount_id);
+  const rightOrderDiscountId = normalizeReceiptId(right?.order_discount_id);
+  if (leftOrderDiscountId && rightOrderDiscountId) {
+    return leftOrderDiscountId === rightOrderDiscountId;
+  }
+  const leftResourceId = normalizeReceiptId(left?.discount?.resource_id ?? left?.resource_id ?? left?.discount_id);
+  const rightResourceId = normalizeReceiptId(right?.discount?.resource_id ?? right?.resource_id ?? right?.discount_id);
+  if (!leftResourceId || !rightResourceId) return false;
+  return leftResourceId === rightResourceId && getReceiptDiscountBundleMapId(left) === getReceiptDiscountBundleMapId(right) && String(left?.amount ?? left?.value ?? left?.discount_amount ?? '') === String(right?.amount ?? right?.value ?? right?.discount_amount ?? '');
+}
+function resolveProductBasePrice(product) {
+  const metadata = product.metadata || {};
+  const origin = product._origin || metadata.origin || {};
+  const variantId = product.product_variant_id ?? product.variant_id;
+  const variant = Array.isArray(origin.variant) && isPresentId(variantId) ? origin.variant.find(item => isSameId(item?.id, variantId)) : undefined;
+  const isV2 = metadata.price_schema_version === 2 || metadata.price_schema_version === '2';
+  const quantity = toNumber(product.product_quantity ?? product.quantity ?? product.num ?? 1, 1);
+  const hasEntitlementPass = normalizeArray(product.discount_list).some(discount => getProductWalletDiscountType(discount) === 'entitlement_pass');
+  const hasOptions = normalizeArray(product.options).length > 0 || normalizeArray(product.product_sku?.option).length > 0;
+  const hasCombinations = normalizeArray(product.combinations).length > 0 || normalizeArray(product.product_bundle).length > 0 || normalizeArray(product.bundle).length > 0;
+  const aggregateSourcePrice = firstPresentValue(metadata.source_product_price, product.price);
+  const originalPrice = product.original_price;
+  // 部分旧 entitlement 商品把 source/price 持久化成了整行总价，但
+  // original_price 仍是单件价。仅在等式能明确证明该口径时做窄幅回退。
+  const useOriginalPriceAsLegacyUnitPrice = hasEntitlementPass && quantity > 1 && !hasOptions && !hasCombinations && isNumericAmount(aggregateSourcePrice) && isNumericAmount(originalPrice) && new _decimal.default(aggregateSourcePrice).eq(new _decimal.default(originalPrice).mul(quantity));
+  return firstPresentValue(useOriginalPriceAsLegacyUnitPrice ? originalPrice : undefined, metadata.source_product_price, variant?.price, product._origin?.price, product._origin?.base_price, !isV2 ? metadata.main_product_original_price : undefined, product.base_price, product.price);
+}
+function normalizeProductDiscounts(params) {
+  const {
+    product,
+    locale,
+    currencySymbol,
+    quantity
+  } = params;
+  const rows = normalizeArray(product.discount_list).filter(discount => {
+    const amount = discount.amount ?? discount.value ?? discount.discount_amount;
+    return isNonZero(amount);
+  }).map(discount => {
+    const title = resolveDiscountTitleWithPercent(discount, locale);
+    const amount = discount.amount ?? discount.value ?? discount.discount_amount;
+    const isMarkup = isManualMarkup(discount);
+    const isAggregatedBundleDiscount = Boolean(getReceiptDiscountBundleMapId(discount));
+    const isEntitlementPass = getProductWalletDiscountType(discount) === 'entitlement_pass';
+    const totalAmount = new _decimal.default(toMoneyNumber(amount)).mul(isAggregatedBundleDiscount || isEntitlementPass ? 1 : quantity);
+    const formattedAmount = isMarkup ? formatMoney(totalAmount.abs(), currencySymbol) : formatNegativeMoney(totalAmount, currencySymbol);
+    return {
+      ...receiptKey(discount, 'discount'),
+      item: title,
+      value: formattedAmount,
+      isMarkup
+    };
+  });
+  return rows.sort((left, right) => Number(right.isMarkup) - Number(left.isMarkup)).map(({
+    isMarkup: _isMarkup,
+    ...row
+  }) => row);
+}
+function isManualMarkup(discount) {
+  if (discount.type !== 'product') return false;
+  if (discount.discount?.discount_type === 'change_price') return true;
+  const amount = discount.amount ?? discount.value ?? discount.discount_amount;
+  return new _decimal.default(toMoneyNumber(amount)).isNegative();
+}
+function hasProductDiscount(product, extensionList = []) {
+  const hasDiscountListAmount = normalizeArray(product.discount_list).some(discount => isNonZero(discount.amount ?? discount.value ?? discount.discount_amount));
+  return hasDiscountListAmount || extensionList.some(row => /^\s*-/.test(stringify(row?.value)));
+}
+function buildProductExtensionList(params) {
+  const {
+    product,
+    locale,
+    currencySymbol,
+    quantity,
+    originalPrice
+  } = params;
+  const discountList = normalizeProductDiscounts({
+    product,
+    locale,
+    currencySymbol,
+    quantity
+  });
+  const extensionList = [...buildProductOpenWeightRows({
+    product,
+    locale,
+    currencySymbol
+  }), ...(quantity > 1 ? [{
+    ...receiptTimeKey(product, 'quantity-price'),
+    item: buildProductQuantityPriceText({
+      quantity,
+      currencySymbol,
+      price: originalPrice
+    }),
+    value: ''
+  }] : [])];
+  const productExtensionList = extensionList.length ? extensionList : normalizeArray(product.extension_list).map(row => ({
+    ...row,
+    ...receiptKey(row, 'extension')
+  }));
+  return [...productExtensionList, ...discountList];
+}
+function buildProductOpenWeightRows(params) {
+  const {
+    product,
+    locale,
+    currencySymbol
+  } = params;
+  const productSku = product.product_sku || {};
+  if (productSku.open_sold_weight != 1) return [];
+  const unit = productSku.unit ?? '';
+  const manualFlag = productSku.weight_source === 'manual' ? '(M) ' : '';
+  const hasTare = toNumber(productSku.tare_weight, 0) > 0;
+  const rows = [];
+  if (hasTare) {
+    rows.push({
+      ...receiptKey(product, 'gross'),
+      item: `${manualFlag}${label(locale, 'gross')}: ${productSku.weight ?? 0}${unit}`,
+      value: ''
+    });
+    rows.push({
+      ...receiptKey(product, 'tare'),
+      item: `${label(locale, 'tare')}: ${productSku.tare_weight}${unit}`,
+      value: ''
+    });
+  }
+  const netWeight = productSku.net_weight ?? 0;
+  const unitPrice = productSku.unit_price ?? 0;
+  const netItem = `${netWeight} ${unit} NET @ ${currencySymbol}${unitPrice}/${unit}`;
+  rows.push({
+    ...receiptTimeKey(product, 'net-weight'),
+    item: hasTare ? netItem : `${manualFlag}${netItem}`,
+    value: ''
+  });
+  return rows;
+}
+function buildProductQuantityPriceText(params) {
+  const {
+    quantity,
+    currencySymbol,
+    price
+  } = params;
+  return `${quantity} @ ${currencySymbol}${stringify(price)} EACH`;
+}
+function resolveDiscountTitleWithPercent(discount, locale) {
+  const title = resolveDiscountTitle(discount, locale);
+  if (getProductWalletDiscountType(discount) === 'entitlement_pass') {
+    return title;
+  }
+  const percentRaw = discount.discount?.percent;
+  const cardType = discount.discount?.discount_card_type ?? 'percent';
+  const percent = percentRaw !== undefined && percentRaw !== null ? Math.trunc(Number(percentRaw)) : NaN;
+  if (percentRaw === undefined || percentRaw === null) return title;
+  if (cardType !== 'percent') return title;
+  if (Number.isNaN(percent)) return title;
+  return `${title} (${percent}%)`;
+}
+function resolveDiscountTitle(discount, locale) {
+  const title = getLocalizedValue(discount.discount?.name ?? discount.discount?.title ?? discount.discount?.message ?? discount.name ?? discount.title ?? discount.message, locale);
+  if (title) return title;
+  if (discount.type === 'product') {
+    return label(locale, isManualMarkup(discount) ? 'manualMarkup' : 'manualDiscount');
+  }
+  return '';
+}
+function resolveProductTitle(params) {
+  const {
+    product,
+    productMap,
+    locale
+  } = params;
+  const ownTitle = getProductTitleSource(product, locale);
+  if (ownTitle) return ownTitle;
+  const productId = product.product_id ?? product.id;
+  const fallbackProduct = resolveProductFromMap(productId, productMap);
+  if (!fallbackProduct) return ownTitle || '';
+  return getProductTitleSource(fallbackProduct, locale);
+}
+function normalizeProductOptions(params) {
+  const {
+    product,
+    locale,
+    currencySymbol,
+    parentProduct
+  } = params;
+  const rawOptions = Array.isArray(params.options) ? params.options : Array.isArray(product.options) ? product.options : Array.isArray(product.product_sku?.option) ? product.product_sku.option : [];
+  return rawOptions.map((option, sourceIndex) => {
+    const price = option.original_price ?? option.add_price ?? option.price;
+    const quantity = toNumber(option.num ?? option.quantity ?? 1, 1);
+    const value = option.value ?? option.option ?? option.item;
+    const name = getProductTitleSource(option, locale) || resolveOptionTitleFromParentProduct({
+      option,
+      parentProduct,
+      locale
+    });
+    return {
+      ...receiptKey(option, 'option'),
+      ...receiptSourceIndex(option, sourceIndex),
+      name,
+      ...(option.num !== undefined || option.quantity !== undefined ? {
+        num: quantity
+      } : {}),
+      ...(price !== undefined && price !== null && price !== '' ? {
+        price: formatMoney(price, currencySymbol)
+      } : {}),
+      total_price: formatCalculatedMoney(new _decimal.default(toMoneyNumber(price ?? 0)).mul(quantity), currencySymbol),
+      ...(value !== undefined && value !== null && value !== '' ? {
+        value: getLocalizedValue(value, locale)
+      } : {})
+    };
+  });
+}
+function normalizeProductCombinations(params) {
+  const {
+    product,
+    productMap,
+    locale,
+    currencySymbol,
+    parentProduct
+  } = params;
+  const bundles = Array.isArray(product.product_bundle) ? product.product_bundle : [];
+  return bundles.map((bundle, sourceIndex) => {
+    const combinationsOptions = normalizeProductOptions({
+      product: {},
+      locale,
+      currencySymbol,
+      options: Array.isArray(bundle.option) ? bundle.option : [],
+      parentProduct
+    });
+    const baseTitle = resolveBundleProductTitle({
+      bundle,
+      productMap,
+      locale,
+      parentProduct
+    });
+    const productNote = resolveProductNote(bundle, locale);
+    const nestedCombinations = Array.isArray(bundle.combinations) ? normalizeExistingCombinations(bundle.combinations, locale, currencySymbol) : [];
+    const quantity = toNumber(bundle.num ?? bundle.quantity ?? 1, 1);
+    const formattedPrice = formatBundlePrice(bundle, currencySymbol);
+    const optionsTotal = sumNormalizedOptionTotals(combinationsOptions, currencySymbol);
+    const explicitBasePrice = resolveCombinationBasePrice(bundle);
+    const basePrice = isPresentId(explicitBasePrice) ? explicitBasePrice : 0;
+    const extensionList = buildProductExtensionList({
+      product: bundle,
+      locale,
+      currencySymbol,
+      quantity,
+      originalPrice: formattedPrice
+    });
+    const shouldIncludeBasePrice = combinationsOptions.length > 0 || nestedCombinations.length > 0 || hasProductDiscount(bundle, extensionList);
+    return {
+      ...receiptKey(bundle, 'combination'),
+      ...receiptSourceIndex(bundle, sourceIndex),
+      product_title: baseTitle,
+      product_quantity: quantity,
+      price: formattedPrice,
+      total_selling_price: formatCalculatedMoney(new _decimal.default(toMoneyNumber(formattedPrice)).mul(quantity), currencySymbol),
+      ...(shouldIncludeBasePrice ? {
+        base_price: formatCalculatedMoney(basePrice, currencySymbol)
+      } : {}),
+      combinations_options: combinationsOptions,
+      ...(combinationsOptions.length ? {
+        options_total_price: optionsTotal
+      } : {}),
+      ...(nestedCombinations.length ? {
+        package_items_total_price: sumCombinationTotals(nestedCombinations, currencySymbol)
+      } : {}),
+      ...(productNote ? {
+        product_note: productNote
+      } : {}),
+      ...(extensionList.length ? {
+        extension_list: extensionList
+      } : {}),
+      ...(nestedCombinations.length ? {
+        combinations: nestedCombinations
+      } : {})
+    };
+  });
+}
+function normalizeExistingCombinations(combinations, locale, currencySymbol) {
+  return combinations.map((combination, sourceIndex) => {
+    if (!combination || typeof combination !== 'object' || Array.isArray(combination)) {
+      return combination;
+    }
+    const productNote = resolveProductNote(combination, locale);
+    const rawOptions = Array.isArray(combination.combinations_options) ? combination.combinations_options : Array.isArray(combination.options) ? combination.options : [];
+    const normalizedOptions = normalizeProductOptions({
+      product: {},
+      locale,
+      currencySymbol,
+      options: rawOptions
+    });
+    const nestedCombinations = Array.isArray(combination.combinations) ? normalizeExistingCombinations(combination.combinations, locale, currencySymbol) : [];
+    const productTitle = getBundleProductTitleSource(combination, locale);
+    const snapshot = {
+      ...combination
+    };
+    delete snapshot.product_title;
+    delete snapshot.product_note;
+    delete snapshot.note;
+    delete snapshot.combinations;
+    delete snapshot.discount_list;
+    const quantity = toNumber(combination.product_quantity ?? combination.num ?? combination.quantity ?? 1, 1);
+    const unitPrice = firstPresentValue(combination.selling_price, combination.price, combination.original_price) ?? 0;
+    const optionsAmount = sumMoneyValues(normalizedOptions.map(option => option.total_price));
+    const explicitBasePrice = resolveCombinationBasePrice(combination, true);
+    const basePrice = isPresentId(explicitBasePrice) ? explicitBasePrice : 0;
+    const extensionList = buildProductExtensionList({
+      product: combination,
+      locale,
+      currencySymbol,
+      quantity,
+      originalPrice: unitPrice
+    });
+    const shouldIncludeBasePrice = normalizedOptions.length > 0 || nestedCombinations.length > 0 || hasProductDiscount(combination, extensionList);
+    return {
+      ...snapshot,
+      ...receiptKey(combination, 'combination'),
+      ...receiptSourceIndex(combination, sourceIndex),
+      ...(productTitle ? {
+        product_title: productTitle
+      } : {}),
+      product_quantity: quantity,
+      total_selling_price: formatCalculatedMoney(new _decimal.default(toMoneyNumber(unitPrice)).mul(quantity), currencySymbol),
+      ...(shouldIncludeBasePrice ? {
+        base_price: formatCalculatedMoney(basePrice, currencySymbol)
+      } : {}),
+      ...(Array.isArray(combination.combinations_options) ? {
+        combinations_options: normalizedOptions
+      } : Array.isArray(combination.options) ? {
+        options: normalizedOptions
+      } : {}),
+      ...(normalizedOptions.length ? {
+        options_total_price: formatCalculatedMoney(optionsAmount, currencySymbol)
+      } : {}),
+      ...(nestedCombinations.length ? {
+        package_items_total_price: sumCombinationTotals(nestedCombinations, currencySymbol)
+      } : {}),
+      ...(productNote ? {
+        product_note: productNote
+      } : {}),
+      ...(extensionList.length ? {
+        extension_list: extensionList
+      } : {}),
+      ...(nestedCombinations.length ? {
+        combinations: nestedCombinations
+      } : {})
+    };
+  });
+}
+function sumMoneyValues(values) {
+  return values.reduce((sum, value) => sum.plus(toMoneyNumber(value)), new _decimal.default(0));
+}
+function resolveCombinationBasePrice(combination, preferOriginalPrice = false) {
+  const fallbackPrices = preferOriginalPrice ? [combination.original_price, combination.product_price, combination.price] : [combination.price, combination.original_price, combination.product_price];
+  return firstPresentValue(combination.base_price, combination.metadata?.source_product_price, ...fallbackPrices);
+}
+function sumNormalizedOptionTotals(options, currencySymbol) {
+  return formatCalculatedMoney(sumMoneyValues(options.map(option => option.total_price)), currencySymbol);
+}
+function sumCombinationTotals(combinations, currencySymbol) {
+  return formatCalculatedMoney(sumMoneyValues(combinations.map(combination => combination.total_selling_price)), currencySymbol);
+}
+function resolveProductNote(product, locale) {
+  const productNote = getLocalizedValue(product.product_note, locale).trim();
+  if (productNote) return productNote;
+  return getLocalizedValue(product.note, locale).trim();
+}
+function buildProductAllergyMap(order, locale) {
+  const allergyByProductUid = new Map();
+  for (const note of normalizeArray(order.notes)) {
+    if (!note || typeof note !== 'object' || Array.isArray(note) || String(note.note_type || '').trim() !== 'allergy') {
+      continue;
+    }
+    const content = getLocalizedValue(note.content?.text, locale).trim();
+    if (!content) continue;
+    const relation = normalizeArray(note.note_relations).find(item => item && typeof item === 'object' && !Array.isArray(item) && item.relation_type === 'about' && item.target_type === 'order_detail' && Number(item.is_primary) === 1);
+    const productUid = String(relation?.target_uuid ?? '').trim();
+    if (!productUid || allergyByProductUid.has(productUid)) continue;
+    allergyByProductUid.set(productUid, content);
+  }
+  return allergyByProductUid;
+}
+function resolveBundleProductTitle(params) {
+  const {
+    bundle,
+    productMap,
+    locale,
+    parentProduct
+  } = params;
+  const ownTitle = getBundleProductTitleSource(bundle, locale);
+  if (ownTitle) return ownTitle;
+  const parentBundleItem = resolveBundleItemFromParentProduct({
+    bundle,
+    parentProduct
+  });
+  const parentBundleTitle = parentBundleItem ? getBundleProductTitleSource(parentBundleItem, locale) : '';
+  if (parentBundleTitle) return parentBundleTitle;
+  const productId = bundle.bundle_product_id ?? bundle._bundle_product_id ?? bundle.product_id ?? bundle.id;
+  const fallbackProduct = resolveProductFromMap(productId, productMap);
+  if (!fallbackProduct) return '';
+  return getBundleProductTitleSource(fallbackProduct, locale);
+}
+function resolveProductFromMap(productId, productMap) {
+  if (productId === undefined || productId === null || productId === '') return null;
+  return productMap[productId] || productMap[String(productId)] || null;
+}
+function resolveProductVariantText(params) {
+  const {
+    product,
+    parentProduct,
+    locale
+  } = params;
+  if (product.variant) return getLocalizedValue(product.variant, locale);
+  if (!parentProduct) return '';
+  const productVariantId = product.product_variant_id ?? product.variant_id;
+  if (!isNonZeroId(productVariantId)) return '';
+  const matchedVariant = normalizeArray(parentProduct.variant).find(variant => isSameId(variant.id, productVariantId));
+  if (!matchedVariant) return '';
+  const resolvedFromSkuKey = resolveVariantTextFromSkuKey({
+    skuKey: matchedVariant.sku_key,
+    parentProduct,
+    locale
+  });
+  if (resolvedFromSkuKey) return resolvedFromSkuKey;
+  return resolveVariantTextFromNameMap({
+    nameMap: matchedVariant.name || matchedVariant.title,
+    parentProduct,
+    locale
+  });
+}
+function resolveVariantTextFromSkuKey(params) {
+  const skuKey = stringify(params.skuKey);
+  if (!skuKey) return '';
+  return skuKey.split('_').map(item => {
+    const [groupPositionId, itemPositionId] = item.split(':');
+    return resolveVariantTextItem({
+      parentProduct: params.parentProduct,
+      groupPositionId,
+      itemPositionId,
+      locale: params.locale
+    });
+  }).filter(Boolean).join(',');
+}
+function resolveVariantTextFromNameMap(params) {
+  if (!params.nameMap || typeof params.nameMap !== 'object') return '';
+  return Object.entries(params.nameMap).map(([groupPositionId, value]) => {
+    const group = resolveVariantGroup(params.parentProduct, groupPositionId);
+    if (!group) return '';
+    const groupName = getLocalizedValue(group.name, params.locale);
+    const itemName = getLocalizedValue(value, params.locale);
+    if (!groupName || !itemName) return '';
+    return `${groupName}:${itemName}`;
+  }).filter(Boolean).join(',');
+}
+function resolveVariantTextItem(params) {
+  const group = resolveVariantGroup(params.parentProduct, params.groupPositionId);
+  const item = resolveVariantItem(group, params.itemPositionId);
+  if (!group || !item) return '';
+  const groupName = getLocalizedValue(group.name, params.locale);
+  const itemName = getLocalizedValue(item.name, params.locale);
+  if (!groupName || !itemName) return '';
+  return `${groupName}:${itemName}`;
+}
+function resolveVariantGroup(parentProduct, groupPositionId) {
+  return normalizeArray(parentProduct.variant_group).find(group => isSameId(group.position_id, groupPositionId) || isSameId(group.id, groupPositionId)) || null;
+}
+function resolveVariantItem(group, itemPositionId) {
+  if (!group) return null;
+  return normalizeArray(group.variant_item).find(item => isSameId(item.position_id, itemPositionId) || isSameId(item.id, itemPositionId)) || null;
+}
+function getProductTitleSource(source, locale) {
+  if (!source || typeof source !== 'object') return '';
+  return resolveTitleValue(source.product_title, locale) || resolveTitleValue(source.title_i18n, locale) || resolveTitleValue(source.title, locale) || resolveTitleValue(source.name_i18n, locale) || resolveTitleValue(source.name, locale);
+}
+function getBundleProductTitleSource(source, locale) {
+  if (!source || typeof source !== 'object') return '';
+  return resolveTitleValue(source.bundle_title, locale) || resolveTitleValue(source.trans_title, locale) || resolveTitleValue(source.title_i18n, locale) || resolveTitleValue(source.product_title, locale) || resolveTitleValue(source.title, locale) || resolveTitleValue(source.name, locale);
+}
+function resolveTitleValue(value, locale) {
+  if (value === undefined || value === null) return '';
+  if (typeof value !== 'object') return stringify(value);
+  const dashedLocale = locale.replace('_', '-');
+  const underscoredLocale = locale.replace('-', '_');
+  return stringify(value[locale] ?? value[dashedLocale] ?? value[underscoredLocale] ?? value.original ?? value.auto ?? '');
+}
+function resolveOptionTitleFromParentProduct(params) {
+  const {
+    option,
+    parentProduct,
+    locale
+  } = params;
+  if (!parentProduct) return '';
+  const optionItems = flattenOptionItems(parentProduct);
+  const matchedOption = optionItems.find(item => isOptionItemMatch(option, item));
+  return getProductTitleSource(matchedOption, locale);
+}
+function flattenOptionItems(parentProduct) {
+  const optionGroups = Array.isArray(parentProduct.option_group) ? parentProduct.option_group : [];
+  return optionGroups.flatMap(group => {
+    const items = normalizeArray(group.option_item || group.option_items || group.option || group.options || group.items || group.children || group.product_option_item);
+    return items.map(item => ({
+      ...item,
+      option_group_id: item.option_group_id ?? group.id ?? group.option_group_id
+    }));
+  });
+}
+function isOptionItemMatch(option, item) {
+  const optionItemId = option.option_group_item_id ?? option.product_option_item_id ?? option.id;
+  const itemId = item.option_group_item_id ?? item.product_option_item_id ?? item.id;
+  if (!isSameId(optionItemId, itemId)) return false;
+  const optionGroupId = option.option_group_id ?? option.group_id;
+  const itemGroupId = item.option_group_id ?? item.group_id;
+  if (isPresentId(optionGroupId) && isPresentId(itemGroupId)) {
+    return isSameId(optionGroupId, itemGroupId);
+  }
+  return true;
+}
+function resolveBundleItemFromParentProduct(params) {
+  const {
+    bundle,
+    parentProduct
+  } = params;
+  if (!parentProduct) return null;
+  const bundleItems = flattenBundleItems(parentProduct);
+  const bundleVariantId = bundle.bundle_variant_id ?? bundle.variant_id ?? bundle.product_variant_id;
+  if (isNonZeroId(bundleVariantId)) {
+    const matchedByVariant = bundleItems.find(item => isSameId(item.bundle_variant_id ?? item.variant_id ?? item.product_variant_id, bundleVariantId));
+    if (matchedByVariant) return matchedByVariant;
+  }
+  const bundleId = bundle.bundle_id ?? bundle.id;
+  if (isPresentId(bundleId)) {
+    const matchedByBundleId = bundleItems.find(item => isSameId(item.id ?? item.bundle_id, bundleId));
+    if (matchedByBundleId) return matchedByBundleId;
+  }
+  const bundleGroupId = bundle.bundle_group_id ?? bundle.group_id;
+  const bundleProductId = bundle.bundle_product_id ?? bundle._bundle_product_id ?? bundle.product_id;
+  if (isPresentId(bundleGroupId) && isPresentId(bundleProductId)) {
+    const matchedByGroupAndProduct = bundleItems.find(item => isSameId(item.group_id ?? item.bundle_group_id, bundleGroupId) && isSameId(item.bundle_product_id ?? item._bundle_product_id ?? item.product_id, bundleProductId));
+    if (matchedByGroupAndProduct) return matchedByGroupAndProduct;
+  }
+  if (isPresentId(bundleProductId)) {
+    return bundleItems.find(item => isSameId(item.bundle_product_id ?? item._bundle_product_id ?? item.product_id, bundleProductId)) || null;
+  }
+  return null;
+}
+function flattenBundleItems(parentProduct) {
+  const bundleGroups = Array.isArray(parentProduct.bundle_group) ? parentProduct.bundle_group : [];
+  return bundleGroups.flatMap(group => {
+    const items = Array.isArray(group.bundle_item) ? group.bundle_item : [];
+    return items.map(item => ({
+      ...item,
+      group_id: item.group_id ?? group.id ?? group.group_id
+    }));
+  });
+}
+function isNonZeroId(value) {
+  return isPresentId(value) && String(value) !== '0';
+}
+function isPresentId(value) {
+  return value !== undefined && value !== null && value !== '';
+}
+function firstPresentValue(...values) {
+  return values.find(value => isPresentId(value));
+}
+function isSameId(left, right) {
+  if (!isPresentId(left) || !isPresentId(right)) return false;
+  return String(left) === String(right);
+}
+function formatBundlePrice(bundle, currencySymbol) {
+  const value = bundle.bundle_selling_price ?? bundle.bundle_sum_price ?? bundle.price ?? 0;
+  const amount = new _decimal.default(toMoneyNumber(value));
+  // 套餐价格协议：只有 markdown 是减价；加价与商品原价都保持正数。
+  const isNegative = bundle.price_type === 'markdown';
+  if (isNegative) return `-${currencySymbol}${amount.abs().toFixed(2)}`;
+  return formatMoney(amount, currencySymbol);
+}
+function buildFees(params) {
+  const {
+    order,
+    shopInfo,
+    locale,
+    products,
+    summary,
+    currencySymbol,
+    financials
+  } = params;
+  const fees = [];
+  for (const surcharge of normalizeArray(order.surcharges || summary.surcharges)) {
+    const value = surcharge.amount ?? surcharge.value ?? surcharge.total_amount;
+    if (!isNonZero(value)) continue;
+    fees.push({
+      ...receiptKey(surcharge, 'surcharge'),
+      item: getLocalizedValue(surcharge.name || surcharge.title || surcharge.item, locale),
+      value: formatMoney(value, currencySymbol)
+    });
+  }
+  const discountAmount = firstPresentValue(order.shop_discount, summary.discount_amount, order.discount_amount);
+  if (isNonZero(discountAmount)) {
+    fees.push({
+      ...receiptKey(order, 'order-discount'),
+      item: label(locale, 'orderDiscount'),
+      value: formatNegativeMoney(discountAmount, currencySymbol)
+    });
+  }
+  const taxFee = firstPresentValue(summary.tax_fee, order.tax_fee);
+  const taxTitle = resolveTaxTitle({
+    summary,
+    order,
+    shopInfo,
+    locale
+  });
+  const isPriceIncludeTax = firstPresentValue(summary.is_price_include_tax, order.is_price_include_tax, shopInfo.is_price_include_tax);
+  const roundingAmount = firstPresentValue(summary.rounding_amount, order.rounding_amount);
+  const payProcessingFee = financials.payProcessingFee;
+  const productExpectAmount = firstPresentValue(summary.product_expect_amount, summary.product_amount, order.product_expect_amount);
+  const productOriginalAmount = firstPresentValue(summary.product_original_amount, order.product_original_amount) ?? calculateProductOriginalAmount(order);
+  const totalSavingsAmount = new _decimal.default(toMoneyNumber(productOriginalAmount)).minus(toMoneyNumber(productExpectAmount)).plus(toMoneyNumber(discountAmount));
+  const itemDiscountAmount = new _decimal.default(toMoneyNumber(productExpectAmount ?? 0)).minus(toMoneyNumber(productOriginalAmount));
+  return {
+    fees,
+    countFee: {
+      total_amount: formatMoney(firstPresentValue(summary.total_amount, order.total_amount) ?? 0, currencySymbol),
+      original_item_amount: formatMoney(productOriginalAmount, currencySymbol),
+      product_expect_amount: formatMoney(productExpectAmount ?? 0, currencySymbol),
+      item_discount_amount: formatCalculatedMoney(itemDiscountAmount, currencySymbol),
+      expect_amount: formatMoney(financials.totalAmount, currencySymbol),
+      product_quantity: toNumber(firstPresentValue(summary.product_quantity, products.reduce((sum, product) => sum + product.product_quantity, 0)), 0),
+      has_pay: formatMoney(financials.orderPaidAmount, currencySymbol),
+      payment_method: '',
+      tax_title: taxTitle,
+      total_refund_amount: formatMoney(financials.totalRefundAmount, currencySymbol),
+      customer_paid_amount: formatMoney(financials.customerPaidAmount, currencySymbol),
+      net_payment_applied: formatMoney(financials.netPaymentApplied, currencySymbol),
+      ...(isPresentId(roundingAmount) ? {
+        rounding_amount: formatCalculatedMoney(roundingAmount, currencySymbol)
+      } : {}),
+      ...(isNonZero(totalSavingsAmount) ? {
+        order_total_discount: formatMoney(totalSavingsAmount, currencySymbol)
+      } : {}),
+      ...(financials.hasPayProcessingFee ? {
+        pay_processing_fee: formatMoney(payProcessingFee, currencySymbol)
+      } : {}),
+      ...(isPresentId(taxFee) ? {
+        tax_fee: formatMoney(taxFee, currencySymbol)
+      } : {}),
+      ...(isPresentId(isPriceIncludeTax) ? {
+        is_price_include_tax: normalizeBooleanFlag(isPriceIncludeTax)
+      } : {})
+    }
+  };
+}
+function resolveReceiptFinancials(order, summary) {
+  const totalAmount = firstPresentValue(summary.expect_amount, order.expect_amount, summary.total_amount, order.total_amount) ?? 0;
+  const rawPayProcessingFee = firstPresentValue(summary.pay_service_charge_amount, order.pay_service_charge_amount);
+  const payProcessingFee = rawPayProcessingFee ?? 0;
+  const orderPaidAmount = firstPresentValue(summary.order_paid_amount, order.order_paid_amount, sumAppliedPayments(order.payments)) ?? 0;
+  const totalRefundAmount = firstPresentValue(summary.total_refund_amount, order.total_refund_amount) ?? 0;
+  const netPaymentApplied = _decimal.default.max(new _decimal.default(toMoneyNumber(orderPaidAmount)).minus(toMoneyNumber(totalRefundAmount)), 0);
+  const fallbackCustomerPaidAmount = _decimal.default.max(sumCustomerPaidPayments(order.payments), new _decimal.default(toMoneyNumber(orderPaidAmount)).plus(toMoneyNumber(payProcessingFee)));
+  const customerPaidAmount = firstPresentValue(summary.customer_paid_amount, order.customer_paid_amount, fallbackCustomerPaidAmount) ?? 0;
+  const amountGap = firstPresentValue(summary.amount_gap, order.amount_gap);
+  return {
+    totalAmount,
+    orderPaidAmount,
+    payProcessingFee,
+    customerPaidAmount,
+    totalRefundAmount,
+    netPaymentApplied,
+    amountGap,
+    paymentStatus: resolveReceiptPaymentStatus({
+      order,
+      summary
+    }),
+    hasPayProcessingFee: isPresentId(rawPayProcessingFee)
+  };
+}
+function resolveReceiptPaymentStatus(params) {
+  return [params.order.payment_status, params.summary.payment_status, params.order.original_payment_status].map(status => stringify(status).trim()).find(Boolean) || '';
+}
+function resolveTaxTitle(params) {
+  return [params.summary.tax_title, params.order.tax_title, params.shopInfo.tax_title].map(title => getLocalizedValue(title, params.locale).trim()).find(Boolean) || 'Tax';
+}
+function calculateProductOriginalAmount(order) {
+  return normalizeArray(order.products).reduce((total, product) => {
+    const quantity = toNumber(product.product_quantity ?? product.quantity ?? product.num ?? 1, 1);
+    const originalPrice = product.original_price ?? product.selling_price ?? product.payment_price ?? product.price ?? 0;
+    return total.plus(new _decimal.default(toMoneyNumber(originalPrice)).mul(quantity));
+  }, new _decimal.default(0));
+}
+function buildCustomer(order, locale, visibility) {
+  if (!visibility.show) return [];
+  const fields = [visibility.name, visibility.phone, visibility.email];
+  return [{
+    ...receiptKey(order, 'customer.contactName'),
+    item: label(locale, 'contactName'),
+    value: normalizeCustomerDisplayValue(order.customer_name || order.customer?.name || order.customer?.display_name)
+  }, {
+    ...receiptKey(order, 'customer.contactMobile'),
+    item: label(locale, 'contactMobile'),
+    value: stringify(order.phone || order.customer?.phone)
+  }, {
+    ...receiptKey(order, 'customer.email'),
+    item: label(locale, 'email'),
+    value: stringify(order.email || order.customer?.email)
+  }].filter((_row, index) => fields[index]);
+}
+function normalizeCustomerDisplayValue(value) {
+  const text = stringify(value).trim();
+  if (!text) return 'Walk-In';
+  if (text.toLowerCase() === 'select a customer') return 'Walk-In';
+  return text;
+}
+function buildDelivery(order, locale, visibility) {
+  if (!visibility.show) return [];
+  const serviceType = stringify(order.metadata?.shop_service_data?.service_type).trim();
+  const serviceTypeLabelKey = resolveServiceTypeLabelKey(serviceType);
+  if (!serviceTypeLabelKey) return [];
+  const items = visibility.method ? [{
+    ...receiptKey(order, 'service-type'),
+    item: label(locale, serviceTypeLabelKey),
+    value: '',
+    size: 2
+  }] : [];
+  if (!visibility.fulfillmentTime) return items;
+  if (serviceType === 'pick_up') {
+    const pickupTime = formatPickupBookingStart(order.bookings, locale);
+    if (pickupTime) {
+      items.push({
+        ...receiptTimeKey(order, 'pickup-time'),
+        item: pickupTime,
+        value: '',
+        size: 2
+      });
+      return items;
+    }
+  }
+  const handoverTime = firstPresentValue(order.handover_time, order.handover_at, order.pickup_time, order.pickup_at, order.scheduled_pickup_time, order.delivery_time, order.delivery_at, order.scheduled_delivery_time, order.fulfillment_time, order.fulfillment_at, order.metadata?.handover_time, order.metadata?.handover_at, order.metadata?.pickup_time, order.metadata?.pickup_at, order.metadata?.scheduled_pickup_time, order.metadata?.delivery_time, order.metadata?.delivery_at, order.metadata?.scheduled_delivery_time, order.metadata?.fulfillment_time, order.metadata?.fulfillment_at);
+  if (isPresentId(handoverTime)) {
+    items.push({
+      ...receiptKey(order, 'handover-time'),
+      item: label(locale, 'handoverTime'),
+      value: formatDateTime(handoverTime, locale)
+    });
+  }
+  return items;
+}
+function formatPickupBookingStart(bookings, locale) {
+  const booking = normalizeArray(bookings).find(_pickupTiming.isFulfillmentTimingBooking);
+  const date = stringify(booking?.start_date).trim();
+  const time = stringify(booking?.start_time).trim();
+  if (!/^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/.test(date) || !/^([01]\d|2[0-3]):[0-5]\d(?::[0-5]\d)?$/.test(time)) {
+    return '';
+  }
+
+  // Validate only the calendar date in UTC; display the stored shop-local
+  // fields verbatim so the printing device's timezone cannot shift pickup.
+  const calendarDate = new Date(`${date}T00:00:00.000Z`);
+  if (!Number.isFinite(calendarDate.getTime()) || calendarDate.toISOString().slice(0, 10) !== date) {
+    return '';
+  }
+  const [year, month, day] = date.split('-');
+  const dateText = locale === 'en' ? `${day}/${month}/${year}` : `${year}/${month}/${day}`;
+  return `${time.slice(0, 5)} ${dateText}`;
+}
+function buildAppointment(order, locale, showResourceTitle) {
+  const parentScheduleId = order.metadata?.appointment_booking_parent_schedule_id;
+  const bookings = sortBookings(normalizeArray(order.bookings).filter(booking => !(0, _pickupTiming.isFulfillmentTimingBooking)(booking) && isReceiptAppointmentBooking(booking, parentScheduleId)));
+  if (bookings.length) {
+    const allResources = normalizeArray(order.resources || order.resource_list);
+    return bookings.flatMap(booking => buildAppointmentRows({
+      booking,
+      allResources,
+      bookingCount: bookings.length,
+      locale,
+      showResourceTitle
+    }));
+  }
+  const tableName = order.table_name || order.metadata?.table_name || order.metadata?.table?.name || order.form_data?.table_name;
+  if (!tableName) return [];
+  return [{
+    ...receiptKey(order, 'table', 'text'),
+    item: label(locale, 'table'),
+    value: getLocalizedValue(tableName, locale)
+  }];
+}
+function isReceiptAppointmentBooking(booking, parentScheduleId) {
+  if (!booking || typeof booking !== 'object' || Array.isArray(booking)) {
+    return false;
+  }
+  if (isPresentId(parentScheduleId) && isSameId(booking.schedule_event_id, parentScheduleId)) {
+    return false;
+  }
+  const parentId = booking.parent_id;
+  if (parentId === undefined || parentId === null || parentId === '') {
+    return true;
+  }
+  return Number(parentId) !== 0;
+}
+function buildAppointmentRows(params) {
+  const {
+    booking,
+    allResources,
+    bookingCount,
+    locale
+  } = params;
+  const productUid = stringify(firstPresentValue(booking.product_uid, booking.metadata?.product_uid)).trim();
+  const bookingUid = stringify(firstPresentValue(booking.metadata?.unique_identification_number, booking.booking_uid)).trim();
+  const association = {
+    product_uid: productUid,
+    booking_uid: bookingUid
+  };
+  const bookingId = stringify(firstPresentValue(booking.booking_id, booking.schedule_event_id, bookingUid)).trim();
+  const bookingTime = formatBookingRange(booking, locale);
+  const resourceText = formatBookingResources(resolveBookingResourcesForReceipt(booking, allResources, bookingCount), locale, params.showResourceTitle);
+  const holder = getLocalizedValue(booking.holder?.name ?? booking.metadata?.holder?.name, locale).trim();
+  return [{
+    ...receiptKey(booking, 'booking-id'),
+    item: label(locale, 'bookingId'),
+    value: bookingId,
+    ...association
+  }, {
+    ...receiptKey(booking, 'booking-time', 'shared'),
+    item: label(locale, 'bookingDateTime'),
+    value: bookingTime,
+    ...association
+  }, {
+    ...receiptKey(booking, 'booking-resource', 'text'),
+    item: label(locale, 'bookingResource'),
+    value: resourceText,
+    ...association
+  }, {
+    ...receiptKey(booking, 'booking-holder', 'text'),
+    item: label(locale, 'bookingHolder'),
+    value: holder,
+    ...association
+  }].filter(row => Boolean(row.value));
+}
+function formatBookingRange(booking, locale) {
+  const startDate = stringify(booking.start_date);
+  const startTime = stringify(booking.start_time);
+  const endDate = stringify(booking.end_date || startDate);
+  const endTime = stringify(booking.end_time);
+  const start = firstValidBookingDate(booking.start_at, booking.start_datetime, booking.start_date_time, `${startDate} ${startTime}`.trim());
+  const end = firstValidBookingDate(booking.end_at, booking.end_datetime, booking.end_date_time, endTime ? `${endDate} ${endTime}`.trim() : '');
+  if (!start) {
+    return [startDate, startTime, endTime ? `- ${endDate} ${endTime}` : ''].filter(Boolean).join(' ');
+  }
+  const dateFormat = locale === 'en' ? 'DD/MM/YYYY' : 'YYYY/MM/DD';
+  const startText = start.format(`${dateFormat} HH:mm`);
+  if (!end) return startText;
+  return `${startText} - ${end.isSame(start, 'day') ? end.format('HH:mm') : end.format(`${dateFormat} HH:mm`)}`;
+}
+function firstValidBookingDate(...values) {
+  for (const value of values) {
+    if (!isPresentId(value)) continue;
+    const parsed = (0, _dayjs.default)(value);
+    if (parsed.isValid()) return parsed;
+  }
+  return null;
+}
+function resolveBookingResourcesForReceipt(booking, allResources, bookingCount) {
+  const embedded = normalizeArray(booking.resources).filter(resource => Boolean(resource) && typeof resource === 'object' && !Array.isArray(resource));
+  const resourceIds = new Set([booking.resource_id, booking.relation_id, ...normalizeArray(booking.resource_ids), ...normalizeArray(booking.metadata?.resource_ids)].map(value => stringify(value).trim()).filter(Boolean));
+  for (const resource of embedded) {
+    const id = stringify(resource.id ?? resource.resource_id ?? resource.relation_id).trim();
+    if (id) resourceIds.add(id);
+  }
+  if (resourceIds.size) {
+    const matched = allResources.filter(resource => resourceIds.has(stringify(resource.id ?? resource.resource_id ?? resource.relation_id).trim()));
+    if (matched.length) return matched;
+  }
+  if (embedded.length) return embedded;
+  if (bookingCount === 1 && allResources.length) return allResources;
+  return [];
+}
+function formatBookingResources(resources, locale, showResourceTitle) {
+  return resources.map(resource => [showResourceTitle ? getLocalizedValue(resource.form_title || resource.metadata?.form_name || resource.relation_form_name || resource.metadata?.relation_form_name, locale) : '', getLocalizedValue(resource.title || resource.name || resource.main_field || resource.metadata?.main_field || resource.metadata?.resource_name, locale)].filter(Boolean).join(' ')).filter(Boolean).join(', ');
+}
+function sortBookings(bookings) {
+  return bookings.map((booking, index) => ({
+    booking,
+    index
+  })).sort((left, right) => {
+    const leftStart = bookingStartTimestamp(left.booking);
+    const rightStart = bookingStartTimestamp(right.booking);
+    if (leftStart !== rightStart) return leftStart < rightStart ? -1 : 1;
+    for (const field of ['booking_id', 'schedule_event_id']) {
+      const fieldOrder = compareOptionalValues(left.booking?.[field], right.booking?.[field]);
+      if (fieldOrder !== 0) return fieldOrder;
+    }
+    const bookingUidOrder = compareOptionalValues(firstPresentValue(left.booking?.metadata?.unique_identification_number, left.booking?.booking_uid), firstPresentValue(right.booking?.metadata?.unique_identification_number, right.booking?.booking_uid));
+    return bookingUidOrder || left.index - right.index;
+  }).map(({
+    booking
+  }) => booking);
+}
+function bookingStartTimestamp(booking) {
+  const startValues = [booking?.start_at, booking?.start_datetime, booking?.booking_time, isPresentId(booking?.start_date) ? `${booking.start_date} ${stringify(booking.start_time)}`.trim() : undefined];
+  for (const startValue of startValues) {
+    if (!isPresentId(startValue)) continue;
+    const timestamp = (0, _dayjs.default)(startValue).valueOf();
+    if (Number.isFinite(timestamp)) return timestamp;
+  }
+  return Number.POSITIVE_INFINITY;
+}
+function compareOptionalValues(left, right) {
+  const hasLeft = isPresentId(left);
+  const hasRight = isPresentId(right);
+  if (!hasLeft && !hasRight) return 0;
+  if (!hasLeft) return 1;
+  if (!hasRight) return -1;
+  return String(left).localeCompare(String(right), undefined, {
+    numeric: true
+  });
+}
+function buildResources(order, locale) {
+  return normalizeArray(order.resources || order.resource_list).map(resource => ({
+    ...receiptKey(resource, 'resource', 'text'),
+    id: resource.id || resource.resource_id || '',
+    code: '',
+    title: getLocalizedValue(resource.title || resource.name, locale),
+    form_title: getLocalizedValue(resource.form_title || resource.type || '', locale)
+  }));
+}
+function buildPaymentData(params) {
+  const payments = normalizeArray(params.order.payments);
+  return payments.filter(payment => isPrintablePayment(payment)).map(payment => buildPaymentItems({
+    payment,
+    locale: params.locale,
+    currencySymbol: params.currencySymbol,
+    includeFundRecordBalance: false,
+    includeFundRecordUsage: true,
+    includePaymentAmount: true
+  }));
+}
+function buildRefundData(params) {
+  const payments = normalizeArray(params.order.payments);
+  const refunds = Array.from(normalizeArray(params.order.refunds).reduce((result, refund, index) => {
+    const identity = refundIdentity(refund, index);
+    const candidate = {
+      refund,
+      index
+    };
+    const existing = result.get(identity);
+    if (!existing || shouldPreferRefundCandidate(candidate, existing)) {
+      result.set(identity, candidate);
+    }
+    return result;
+  }, new Map()).values()).filter(({
+    refund
+  }) => isPrintableRefund(refund)).sort((left, right) => {
+    const leftTime = refundTimestamp(left.refund);
+    const rightTime = refundTimestamp(right.refund);
+    if (leftTime !== rightTime) return leftTime < rightTime ? -1 : 1;
+    return left.index - right.index;
+  });
+  return refunds.map(({
+    refund
+  }) => {
+    const payment = resolveRefundPayment(refund, payments);
+    const methodName = paymentMethodName(payment, params.locale) || label(params.locale, 'refund');
+    const amount = firstPresentValue(refund.amount, refund.refund_amount, refund.total_amount) ?? 0;
+    const items = [{
+      ...receiptKey(refund, 'refund'),
+      item: methodName,
+      value: formatNegativeMoney(amount, params.currencySymbol)
+    }];
+    const occurredAt = firstPresentValue(refund.refund_time, refund.refunded_at, refund.created_at, refund.updated_at);
+    if (isPresentId(occurredAt)) {
+      items.push({
+        ...receiptTimeKey(refund, 'refund-time'),
+        item: formatDateTime(occurredAt, params.locale),
+        value: ''
+      });
+    }
+    return items;
+  });
+}
+function refundIdentity(refund, index) {
+  if (isPresentId(refund.order_refund_id)) return `refund-id:${refund.order_refund_id}`;
+  if (isPresentId(refund.refund_number)) return `refund-number:${refund.refund_number}`;
+  return `refund-index:${index}`;
+}
+function shouldPreferRefundCandidate(candidate, existing) {
+  const candidatePrintable = isPrintableRefund(candidate.refund);
+  const existingPrintable = isPrintableRefund(existing.refund);
+  if (candidatePrintable !== existingPrintable) return candidatePrintable;
+  const candidateTime = refundFreshnessTimestamp(candidate.refund);
+  const existingTime = refundFreshnessTimestamp(existing.refund);
+  if (candidateTime !== existingTime) return candidateTime > existingTime;
+  return candidate.index > existing.index;
+}
+function refundFreshnessTimestamp(refund) {
+  const timestampValue = firstPresentValue(refund.updated_at, refund.refunded_at, refund.refund_time, refund.created_at);
+  if (!isPresentId(timestampValue)) return Number.NEGATIVE_INFINITY;
+  const timestamp = (0, _dayjs.default)(timestampValue).valueOf();
+  return Number.isFinite(timestamp) ? timestamp : Number.NEGATIVE_INFINITY;
+}
+function refundTimestamp(refund) {
+  const occurredAt = firstPresentValue(refund.refund_time, refund.refunded_at, refund.created_at, refund.updated_at);
+  if (!isPresentId(occurredAt)) return Number.POSITIVE_INFINITY;
+  const timestamp = (0, _dayjs.default)(occurredAt).valueOf();
+  return Number.isFinite(timestamp) ? timestamp : Number.POSITIVE_INFINITY;
+}
+function isPrintableRefund(refund) {
+  const status = stringify(refund.status).trim().toLowerCase();
+  if (!status) return true;
+  return !['pending', 'payment_pending', 'payment_processing', 'refund_processing', 'processing', 'failed', 'error', 'cancelled', 'canceled', 'voided'].includes(status);
+}
+function resolveRefundPayment(refund, payments) {
+  if (refund.payment && typeof refund.payment === 'object' && !Array.isArray(refund.payment)) {
+    return refund.payment;
+  }
+  const orderPaymentId = firstPresentValue(refund.order_payment_id, refund.payment_id);
+  const matchedPayment = payments.find(payment => isSameId(firstPresentValue(payment.order_payment_id, payment.id), orderPaymentId));
+  return matchedPayment || refund;
+}
+function getPaymentWalletAssetIdentity(payment) {
+  const record = getFundRecord(payment);
+  return {
+    id: firstNormalizedWalletAssetId(record?.voucher_id, payment.voucher_id),
+    codes: normalizeWalletAssetCodes(record?.code, record?.encoded)
+  };
+}
+function getProductWalletAssetTag(record) {
+  // Rules normalizes product_discount_card to type=discount_card. That
+  // ambiguous alias cannot establish the original asset tag for a whitelist.
+  for (const tag of [record.tag, record.discount?.tag]) {
+    if (typeof tag === 'string' && tag) return tag;
+  }
+  for (const type of [record.type, record.discount?.type]) {
+    if (typeof type === 'string' && type !== 'discount_card' && PRODUCT_WALLET_DISCOUNT_TYPES.has(type)) return type;
+  }
+  return undefined;
+}
+function createWalletAssetFilter(order, passTypes) {
+  if (passTypes === null) return () => true;
+  const assets = [];
+  const remember = (identity, tag) => {
+    if (typeof tag === 'string' && tag && (identity.id || identity.codes.length)) assets.push({
+      identity,
+      tag
+    });
+  };
+  for (const asset of [...normalizeArray(order.vouchers), ...normalizeArray(order.order_meta_list?.point_cards_snapshot), ...normalizeArray(order.order_meta_list?.virtual_currency_snapshot)]) {
+    if (asset && typeof asset === 'object') remember(getVoucherAssetIdentity(asset), asset.tag);
+  }
+  // Some order snapshots retain the original selected assets at the root.
+  // Only their explicit tag is authoritative; do not infer it from type.
+  for (const record of normalizeArray(order.discount_list)) {
+    if (!record || typeof record !== 'object') continue;
+    remember({
+      id: getProductWalletDiscountAssetId(record),
+      codes: getProductWalletDiscountCodes(record)
+    }, record.tag ?? record.discount?.tag);
+  }
+  const visit = product => {
+    if (!product || typeof product !== 'object') return;
+    for (const record of normalizeArray(product.discount_list)) {
+      if (!record || typeof record !== 'object') continue;
+      remember({
+        id: getProductWalletDiscountAssetId(record),
+        codes: getProductWalletDiscountCodes(record)
+      }, getProductWalletAssetTag(record));
+    }
+    for (const key of ['combinations', 'product_bundle', 'bundle']) normalizeArray(product[key]).forEach(visit);
+  };
+  normalizeArray(order.products).forEach(product => {
+    if (product && typeof product === 'object') visit(restoreReceiptDiscountHierarchy(product));
+  });
+  return (identity, tag, resolvePaymentSource = false) => {
+    const directTag = typeof tag === 'string' && tag ? tag : undefined;
+    if (directTag && !resolvePaymentSource) return passTypes.has(directTag);
+    const exactMatches = identity.id ? assets.filter(asset => asset.identity.id === identity.id) : [];
+    // A known asset ID is stronger than an unrelated code-only snapshot.
+    const matches = exactMatches.length ? exactMatches : assets.filter(asset => isSameWalletAssetIdentity(asset.identity, identity));
+    const tags = new Set(matches.map(asset => asset.tag));
+    if (!tags.size) return !!directTag && passTypes.has(directTag);
+    // A conflicting fund record is not reliable evidence for a payment's tag.
+    // It must not claim the identity ahead of the original typed asset.
+    if (tags.size !== 1 || directTag && !tags.has(directTag)) return false;
+    return passTypes.has(matches[0].tag);
+  };
+}
+function buildWallets(params) {
+  const allowAsset = createWalletAssetFilter(params.order, params.passTypes);
+  const virtualCurrencySnapshots = collectVirtualCurrencySnapshots(params.order, allowAsset);
+  const displayedWalletPayments = normalizeArray(params.order.payments).filter(payment => isPrintablePayment(payment) && !!getFundRecord(payment) && allowAsset(getPaymentWalletAssetIdentity(payment), getFundRecord(payment)?.tag, true));
+  const paymentWallets = displayedWalletPayments.map(payment => {
+    const virtualCurrencySnapshot = findVirtualCurrencySnapshotForPayment(payment, virtualCurrencySnapshots.byId);
+    return buildPaymentItems({
+      payment,
+      locale: params.locale,
+      currencySymbol: params.currencySymbol,
+      includeFundRecordBalance: true,
+      includeFundRecordUsage: false,
+      includePaymentAmount: false,
+      virtualCurrencyUnit: virtualCurrencySnapshot ? getVirtualCurrencySnapshotUnit(virtualCurrencySnapshot, params.locale) : undefined
+    });
+  });
+  const displayedWalletAssetIdentities = collectDisplayedWalletAssetIdentities(displayedWalletPayments);
+  const voucherWallets = buildVoucherAssets({
+    ...params,
+    allowAsset,
+    displayedWalletAssetIdentities
+  });
+  const productDiscountWallets = buildProductDiscountAssets({
+    ...params,
+    allowAsset,
+    displayedWalletAssetIdentities
+  });
+  return [...paymentWallets, ...voucherWallets, ...productDiscountWallets, ...buildPointCardSnapshotAssets({
+    order: params.order,
+    locale: params.locale,
+    allowAsset,
+    displayedWalletAssetIdentities
+  }), ...buildVirtualCurrencySnapshotAssets({
+    snapshots: virtualCurrencySnapshots.items,
+    order: params.order,
+    locale: params.locale,
+    allowAsset,
+    displayedWalletAssetIdentities
+  })];
+}
+function collectDisplayedWalletAssetIdentities(payments) {
+  const identities = [];
+  payments.forEach(payment => {
+    const fundRecord = getFundRecord(payment);
+    const ids = Array.from(new Set([fundRecord?.voucher_id, payment.voucher_id].map(value => normalizeWalletPassId(value)).filter(value => !!value)));
+    const codes = normalizeWalletAssetCodes(fundRecord?.code, fundRecord?.encoded);
+    if (!ids.length) {
+      registerWalletAssetIdentity(identities, {
+        id: null,
+        codes
+      });
+      return;
+    }
+    ids.forEach(id => {
+      registerWalletAssetIdentity(identities, {
+        id,
+        codes
+      });
+    });
+  });
+  return identities;
+}
+const PRODUCT_WALLET_DISCOUNT_TYPES = new Set(['good_pass', 'discount_card', 'product_discount_card', 'entitlement_pass']);
+function buildProductDiscountAssets(params) {
+  const fallbackAssetTime = firstPresentValue(params.order.updated_at, params.order.created_at);
+  return collectProductWalletDiscountAssets(params.order, params.allowAsset).flatMap(asset => {
+    if (!claimWalletAssetIdentity(params.displayedWalletAssetIdentities, {
+      id: asset.id,
+      codes: asset.codes
+    })) return [];
+    const name = getProductWalletDiscountName(asset, params.locale);
+    const assetTime = getProductWalletDiscountTime(asset) ?? fallbackAssetTime;
+    const timeRow = isPresentId(assetTime) ? {
+      ...receiptTimeKey(asset.records[0], 'asset-time'),
+      item: formatDateTime(assetTime, params.locale),
+      value: ''
+    } : null;
+    if (asset.type === 'entitlement_pass') {
+      const remaining = getProductEntitlementBalance(asset);
+      return [[{
+        ...receiptKey(asset.records[0], 'asset-name'),
+        item: name,
+        value: ''
+      }, ...(remaining ? [{
+        ...receiptKey(asset.records[0], 'entitlementRemaining'),
+        item: label(params.locale, 'entitlementRemaining'),
+        value: formatEntitlementUses(remaining, params.locale)
+      }] : []), ...(timeRow ? [timeRow] : [])]];
+    }
+    const percent = getProductWalletDiscountPercent(asset);
+    if (percent) {
+      return [[{
+        ...receiptKey(asset.records[0], 'asset-discount'),
+        item: appendPercentToVoucherName(name, percent),
+        value: formatVoucherDiscount(percent, params.locale)
+      }, ...(timeRow ? [timeRow] : [])]];
+    }
+    const balance = getProductWalletMoneyBalance(asset);
+    return [[{
+      ...receiptKey(asset.records[0], 'asset-name'),
+      item: name,
+      value: ''
+    }, ...(balance ? [{
+      ...receiptKey(asset.records[0], 'balance'),
+      item: label(params.locale, 'balance'),
+      value: formatMoney(balance, params.currencySymbol)
+    }] : []), ...(timeRow ? [timeRow] : [])]];
+  });
+}
+function collectProductWalletDiscountAssets(order, allowAsset) {
+  const assets = [];
+  const assetsById = new Map();
+  normalizeArray(order.products).forEach(rawProduct => {
+    if (!rawProduct || typeof rawProduct !== 'object') return;
+    visitProductWalletDiscounts(restoreReceiptDiscountHierarchy(rawProduct), assets, assetsById, allowAsset);
+  });
+  return assets;
+}
+function visitProductWalletDiscounts(product, assets, assetsById, allowAsset) {
+  normalizeArray(product.discount_list).forEach(record => {
+    if (!record || typeof record !== 'object' || Array.isArray(record)) return;
+    const type = getProductWalletDiscountType(record);
+    if (!type) return;
+    const id = getProductWalletDiscountAssetId(record);
+    if (!id) return;
+    const codes = getProductWalletDiscountCodes(record);
+    if (allowAsset && !allowAsset({
+      id,
+      codes
+    }, getProductWalletAssetTag(record))) return;
+    const existing = assetsById.get(id);
+    if (existing) {
+      existing.records.push(record);
+      existing.codes = Array.from(new Set([...existing.codes, ...codes]));
+      return;
+    }
+    const asset = {
+      id,
+      type,
+      codes,
+      records: [record]
+    };
+    assetsById.set(id, asset);
+    assets.push(asset);
+  });
+  for (const childKey of ['combinations', 'product_bundle', 'bundle']) {
+    normalizeArray(product[childKey]).forEach(child => {
+      if (!child || typeof child !== 'object' || Array.isArray(child)) return;
+      visitProductWalletDiscounts(child, assets, assetsById, allowAsset);
+    });
+  }
+}
+function getProductWalletDiscountType(record) {
+  for (const value of [record.tag, record.type, record.discount?.tag, record.discount?.type]) {
+    const type = stringify(value).trim().toLowerCase();
+    if (PRODUCT_WALLET_DISCOUNT_TYPES.has(type)) return type;
+  }
+  return null;
+}
+function getProductWalletDiscountAssetId(record) {
+  for (const value of [record.discount?.resource_id, record.resource_id, record.id, record.discount_id]) {
+    const id = normalizeWalletPassId(value);
+    if (id && id !== '0') return id;
+  }
+  return null;
+}
+function getProductWalletDiscountCodes(record) {
+  return normalizeWalletAssetCodes(record.code, record.encoded, record.discount?.code, record.discount?.encoded);
+}
+function getProductWalletDiscountName(asset, locale) {
+  for (const record of asset.records) {
+    for (const value of [record.discount?.title, record.discount?.name, record.discount?.message, record.product_name, record.format_title, record.title, record.name, record.message]) {
+      const name = getLocalizedValue(value, locale).trim();
+      if (name) return name;
+    }
+  }
+  return asset.codes[0] || label(locale, 'giftCard');
+}
+function getProductWalletDiscountTime(asset) {
+  for (const field of ['updated_at', 'created_at', 'collection_time']) {
+    for (const record of asset.records) {
+      const value = firstPresentValue(record[field], record.discount?.[field]);
+      if (isPresentId(value)) return value;
+    }
+  }
+  return undefined;
+}
+function getProductEntitlementBalance(asset) {
+  for (const record of asset.records) {
+    const balance = getProductDiscountEntitlementBalance(record);
+    if (balance) return balance;
+  }
+  return null;
+}
+function getProductDiscountEntitlementBalance(record) {
+  return getEntitlementBalance(record.metadata?.balance, record.balance, record.discount?.metadata?.balance, record.discount?.balance);
+}
+function getEntitlementBalance(...values) {
+  for (const value of values) {
+    if (!isNumericAmount(value)) continue;
+    const balance = new _decimal.default(value);
+    if (balance.isFinite() && balance.isInteger() && balance.gte(0)) {
+      return balance;
+    }
+  }
+  return null;
+}
+function formatEntitlementUses(value, locale) {
+  const count = value.toFixed(0);
+  switch (normalizeLocaleKey(locale)) {
+    case 'zh_CN':
+    case 'zh_HK':
+      return `${count}次`;
+    case 'ja':
+      return `${count}回`;
+    case 'pt':
+      return `${count} ${value.eq(1) ? 'utilização' : 'utilizações'}`;
+    default:
+      return `${count} ${value.eq(1) ? 'use' : 'uses'}`;
+  }
+}
+function getProductWalletDiscountPercent(asset) {
+  if (asset.type !== 'discount_card' && asset.type !== 'product_discount_card') return null;
+  for (const record of asset.records) {
+    const discountType = stringify(firstPresentValue(record.discount_card_type, record.metadata?.discount_card_type, record.discount?.discount_card_type, record.discount?.metadata?.discount_card_type)).trim().toLowerCase();
+    if (discountType && discountType !== 'percent' && discountType !== 'percentage') continue;
+    const candidates = [record.percent, record.discount?.percent];
+    if (discountType === 'percent' || discountType === 'percentage') {
+      candidates.push(record.par_value, record.discount?.par_value);
+    }
+    for (const value of candidates) {
+      if (!isNumericAmount(value)) continue;
+      const percent = new _decimal.default(value);
+      if (percent.isFinite() && percent.gt(0) && percent.lte(100)) {
+        return percent;
+      }
+    }
+  }
+  return null;
+}
+function getProductWalletMoneyBalance(asset) {
+  for (const record of asset.records) {
+    for (const value of [record.metadata?.balance, record.balance, record.discount?.metadata?.balance, record.discount?.balance]) {
+      if (!isNumericAmount(value)) continue;
+      return _decimal.default.max(new _decimal.default(value), 0);
+    }
+  }
+  for (const record of asset.records) {
+    const parValue = firstPresentValue(record.par_value, record.discount?.par_value);
+    const usedParValue = firstPresentValue(record.used_par_value, record.discount?.used_par_value);
+    if (!isNumericAmount(parValue) || !isNumericAmount(usedParValue)) continue;
+    return _decimal.default.max(new _decimal.default(parValue).minus(new _decimal.default(usedParValue)), 0);
+  }
+  return null;
+}
+function buildPointCardSnapshotAssets(params) {
+  const snapshots = params.order.order_meta_list?.point_cards_snapshot;
+  if (!Array.isArray(snapshots)) return [];
+  const snapshotTime = firstPresentValue(params.order.updated_at, params.order.created_at);
+  return snapshots.flatMap(snapshot => {
+    if (!snapshot || typeof snapshot !== 'object' || Array.isArray(snapshot)) return [];
+    const pointCard = snapshot;
+    if (stringify(pointCard.tag).trim().toLowerCase() !== 'point_card') return [];
+    const assetId = normalizeWalletPassId(pointCard.id);
+    if (!params.allowAsset(getVoucherAssetIdentity(pointCard), pointCard.tag)) return [];
+    if (!assetId || !claimWalletAssetIdentity(params.displayedWalletAssetIdentities, {
+      id: assetId,
+      codes: []
+    })) return [];
+    const rows = [{
+      ...receiptKey(pointCard, 'asset-name'),
+      item: appendMaskedCardCode(stringify(pointCard.product_name).trim() || label(params.locale, 'pointCard'), pointCard.code),
+      value: ''
+    }];
+    const remainingPoints = getPointCardSnapshotRemainingPoints(pointCard);
+    if (remainingPoints) {
+      rows.push({
+        ...receiptKey(pointCard, 'remainingPoints'),
+        item: label(params.locale, 'remainingPoints'),
+        value: trimDecimal(remainingPoints)
+      });
+    }
+    if (isPresentId(snapshotTime)) {
+      rows.push({
+        ...receiptTimeKey(pointCard, 'asset-time'),
+        item: formatDateTime(snapshotTime, params.locale),
+        value: ''
+      });
+    }
+    return [rows];
+  });
+}
+function collectVirtualCurrencySnapshots(order, allowAsset) {
+  const items = [];
+  const byId = new Map();
+  const snapshots = order.order_meta_list?.virtual_currency_snapshot;
+  if (!Array.isArray(snapshots)) return {
+    items,
+    byId
+  };
+  snapshots.forEach(snapshot => {
+    if (!snapshot || typeof snapshot !== 'object' || Array.isArray(snapshot)) return;
+    const virtualCurrency = snapshot;
+    if (stringify(virtualCurrency.tag).trim().toLowerCase() !== 'virtual_currency') return;
+    if (!allowAsset(getVoucherAssetIdentity(virtualCurrency), virtualCurrency.tag)) return;
+    const id = normalizeWalletPassId(virtualCurrency.id);
+    if (!id || byId.has(id)) return;
+    byId.set(id, virtualCurrency);
+    items.push(virtualCurrency);
+  });
+  return {
+    items,
+    byId
+  };
+}
+function findVirtualCurrencySnapshotForPayment(payment, snapshotsById) {
+  const fundRecord = getFundRecord(payment);
+  for (const value of [fundRecord?.voucher_id, payment.voucher_id]) {
+    const id = normalizeWalletPassId(value);
+    if (!id) continue;
+    const snapshot = snapshotsById.get(id);
+    if (snapshot) return snapshot;
+  }
+  return undefined;
+}
+function buildVirtualCurrencySnapshotAssets(params) {
+  const snapshotTime = firstPresentValue(params.order.updated_at, params.order.created_at);
+  return params.snapshots.flatMap(virtualCurrency => {
+    const assetId = normalizeWalletPassId(virtualCurrency.id);
+    if (!params.allowAsset(getVoucherAssetIdentity(virtualCurrency), virtualCurrency.tag)) return [];
+    if (!assetId || !claimWalletAssetIdentity(params.displayedWalletAssetIdentities, {
+      id: assetId,
+      codes: []
+    })) return [];
+    const rows = [{
+      ...receiptKey(virtualCurrency, 'asset-name'),
+      item: appendMaskedCardCode(stringify(virtualCurrency.product_name).trim(), virtualCurrency.code),
+      value: ''
+    }];
+    const balance = getVirtualCurrencySnapshotBalance(virtualCurrency);
+    if (balance) {
+      rows.push({
+        ...receiptKey(virtualCurrency, 'balance'),
+        item: label(params.locale, 'balance'),
+        value: formatVirtualCurrencyBalance(balance, getVirtualCurrencySnapshotUnit(virtualCurrency, params.locale))
+      });
+    }
+    if (isPresentId(snapshotTime)) {
+      rows.push({
+        ...receiptTimeKey(virtualCurrency, 'asset-time'),
+        item: formatDateTime(snapshotTime, params.locale),
+        value: ''
+      });
+    }
+    return [rows];
+  });
+}
+function getVirtualCurrencySnapshotBalance(snapshot) {
+  if (!isNumericAmount(snapshot.par_value) || !isNumericAmount(snapshot.used_par_value)) {
+    return null;
+  }
+  return _decimal.default.max(new _decimal.default(snapshot.par_value).minus(new _decimal.default(snapshot.used_par_value)), 0);
+}
+function getVirtualCurrencySnapshotUnit(snapshot, locale) {
+  return getNonEmptyLocalizedValue(snapshot.name, locale);
+}
+function getNonEmptyLocalizedValue(value, locale) {
+  if (value === undefined || value === null) return '';
+  if (typeof value !== 'object' || Array.isArray(value)) return stringify(value).trim();
+  const dashedLocale = locale.replace('_', '-');
+  const underscoredLocale = locale.replace('-', '_');
+  for (const candidate of [value[locale], value[dashedLocale], value[underscoredLocale], value.original, value.auto, value.default, value.en]) {
+    const text = stringify(candidate).trim();
+    if (text) return text;
+  }
+  return '';
+}
+function formatVirtualCurrencyBalance(value, unit) {
+  const amount = trimDecimal(value);
+  const normalizedUnit = unit.trim();
+  return normalizedUnit ? `${amount} ${normalizedUnit}` : amount;
+}
+function normalizeWalletPassId(value) {
+  if (typeof value === 'number') return Number.isFinite(value) ? String(value) : null;
+  if (typeof value !== 'string') return null;
+  return value.trim() || null;
+}
+function firstNormalizedWalletAssetId(...values) {
+  for (const value of values) {
+    const id = normalizeWalletPassId(value);
+    if (id) return id;
+  }
+  return null;
+}
+function normalizeWalletAssetCodes(...values) {
+  return Array.from(new Set(values.map(value => normalizeWalletPassId(value)).filter(value => !!value)));
+}
+function registerWalletAssetIdentity(identities, candidate) {
+  if (!candidate.id && !candidate.codes.length) return;
+  const existing = identities.find(identity => isSameWalletAssetIdentity(identity, candidate));
+  if (existing) {
+    mergeWalletAssetIdentity(existing, candidate);
+    return;
+  }
+  identities.push({
+    id: candidate.id,
+    codes: [...candidate.codes]
+  });
+}
+function claimWalletAssetIdentity(identities, candidate) {
+  if (!candidate.id && !candidate.codes.length) return true;
+  const existing = identities.find(identity => isSameWalletAssetIdentity(identity, candidate));
+  if (existing) {
+    mergeWalletAssetIdentity(existing, candidate);
+    return false;
+  }
+  identities.push({
+    id: candidate.id,
+    codes: [...candidate.codes]
+  });
+  return true;
+}
+function isSameWalletAssetIdentity(left, right) {
+  if (left.id && right.id) return left.id === right.id;
+  return left.codes.some(code => right.codes.includes(code));
+}
+function mergeWalletAssetIdentity(target, source) {
+  if (!target.id && source.id) target.id = source.id;
+  target.codes = Array.from(new Set([...target.codes, ...source.codes]));
+}
+function getPointCardSnapshotRemainingPoints(snapshot) {
+  if (!isNumericAmount(snapshot.par_value) || !isNumericAmount(snapshot.used_par_value)) {
+    return null;
+  }
+  return _decimal.default.max(new _decimal.default(snapshot.par_value).minus(new _decimal.default(snapshot.used_par_value)), 0);
+}
+function buildVoucherAssets(params) {
+  const fallbackAssetTime = firstPresentValue(params.order.updated_at, params.order.created_at);
+  return normalizeArray(params.order.vouchers).flatMap(voucher => {
+    if (!voucher || typeof voucher !== 'object' || Array.isArray(voucher)) return [];
+    if (!params.allowAsset(getVoucherAssetIdentity(voucher), voucher.tag)) return [];
+    if (!claimWalletAssetIdentity(params.displayedWalletAssetIdentities, getVoucherAssetIdentity(voucher))) return [];
+    const name = getVoucherAssetName(voucher, params.locale);
+    const assetTime = firstPresentValue(voucher.updated_at, voucher.created_at, voucher.collection_time, fallbackAssetTime);
+    const timeRow = isPresentId(assetTime) ? {
+      ...receiptTimeKey(voucher, 'asset-time'),
+      item: formatDateTime(assetTime, params.locale),
+      value: ''
+    } : null;
+    if (isEntitlementVoucher(voucher)) {
+      const remaining = getEntitlementBalance(voucher.metadata?.balance, voucher.balance);
+      return [[{
+        ...receiptKey(voucher, 'asset-name'),
+        item: name,
+        value: ''
+      }, ...(remaining ? [{
+        ...receiptKey(voucher, 'entitlementRemaining'),
+        item: label(params.locale, 'entitlementRemaining'),
+        value: formatEntitlementUses(remaining, params.locale)
+      }] : []), ...(timeRow ? [timeRow] : [])]];
+    }
+    if (isTicketVoucher(voucher)) {
+      const validity = getVoucherValidity(voucher, params.locale);
+      return [[{
+        ...receiptKey(voucher, 'asset-name'),
+        item: name,
+        value: ''
+      }, ...(validity ? [{
+        ...receiptKey(voucher, 'validity'),
+        item: label(params.locale, 'validity'),
+        value: validity
+      }] : [])]];
+    }
+    const percent = getVoucherDiscountPercent(voucher);
+    if (percent) {
+      return [[{
+        ...receiptKey(voucher, 'asset-discount'),
+        item: appendPercentToVoucherName(name, percent),
+        value: formatVoucherDiscount(percent, params.locale)
+      }, ...(timeRow ? [timeRow] : [])]];
+    }
+    const balance = getVoucherBalance(voucher);
+    return [[{
+      ...receiptKey(voucher, 'asset-name'),
+      item: name,
+      value: ''
+    }, {
+      ...receiptKey(voucher, 'balance'),
+      item: label(params.locale, 'balance'),
+      value: formatMoney(balance, params.currencySymbol)
+    }, ...(timeRow ? [timeRow] : [])]];
+  });
+}
+const TICKET_VOUCHER_TAGS = new Set(['ticket', 'product_package_ticket', 'appointment_ticket', 'session_ticket']);
+function isEntitlementVoucher(voucher) {
+  return [voucher.tag, voucher.type].some(value => stringify(value).trim().toLowerCase() === 'entitlement_pass');
+}
+function isTicketVoucher(voucher) {
+  return TICKET_VOUCHER_TAGS.has(stringify(voucher.tag).trim().toLowerCase());
+}
+function getVoucherValidity(voucher, locale) {
+  const availableTime = firstPresentValue(voucher.available_time, voucher.avaliable_time, voucher.metadata?.available_time, voucher.metadata?.avaliable_time);
+  const availableTimeText = formatVoucherAvailableTime(availableTime, locale);
+  if (availableTimeText) return availableTimeText;
+  const startDate = firstPresentValue(voucher.valid_from, voucher.start_at, voucher.start_date_time, voucher.start_date, voucher.metadata?.valid_from, voucher.metadata?.start_at, voucher.metadata?.start_date);
+  const endDate = firstPresentValue(voucher.valid_to, voucher.end_at, voucher.end_date_time, voucher.expire_date, voucher.end_date, voucher.expire_time, voucher.metadata?.valid_to, voucher.metadata?.end_at, voucher.metadata?.expire_date, voucher.metadata?.end_date, voucher.metadata?.expire_time);
+  return formatVoucherValidityRange(startDate, endDate, locale, {
+    startTime: voucher.start_time ?? voucher.metadata?.start_time,
+    endTime: voucher.end_time ?? voucher.metadata?.end_time
+  });
+}
+function formatVoucherAvailableTime(value, locale) {
+  if (!isPresentId(value)) return '';
+  if (Array.isArray(value)) {
+    return value.map(item => formatVoucherAvailableTime(item, locale)).filter(Boolean).join(', ');
+  }
+  if (typeof value !== 'object') return stringify(value).trim();
+  const start = firstPresentValue(value.start, value.start_at, value.start_date_time, value.start_date);
+  const end = firstPresentValue(value.end, value.end_at, value.end_date_time, value.expire_time, value.expire_date, value.end_date);
+  if (isPresentId(start) || isPresentId(end)) {
+    return formatVoucherValidityRange(start, end, locale, {
+      startTime: value.start_time,
+      endTime: value.end_time
+    });
+  }
+  return getLocalizedValue(value, locale).trim();
+}
+function formatVoucherValidityRange(startValue, endValue, locale, times = {}) {
+  const start = combineVoucherDateAndTime(startValue, times.startTime);
+  const end = combineVoucherDateAndTime(endValue, times.endTime);
+  const startPart = formatVoucherValidityDate(start, locale);
+  const endPart = formatVoucherValidityDate(end, locale);
+  if (startPart.text && endPart.text) {
+    const parsedStart = (0, _dayjs.default)(start);
+    const parsedEnd = (0, _dayjs.default)(end);
+    const sameDay = parsedStart.isValid() && parsedEnd.isValid() && parsedStart.isSame(parsedEnd, 'day');
+    if (sameDay && startPart.time && endPart.time) {
+      return `${startPart.time} - ${endPart.time} ${startPart.date}`;
+    }
+    return `${startPart.text} - ${endPart.text}`;
+  }
+  return startPart.text || endPart.text;
+}
+function combineVoucherDateAndTime(dateValue, timeValue) {
+  if (!isPresentId(dateValue) || !isPresentId(timeValue)) return dateValue;
+  const dateText = stringify(dateValue).trim();
+  if (/\d{1,2}:\d{2}/.test(dateText)) return dateValue;
+  return `${dateText} ${stringify(timeValue).trim()}`;
+}
+function formatVoucherValidityDate(value, locale) {
+  if (!isPresentId(value)) return {
+    date: '',
+    time: '',
+    text: ''
+  };
+  const source = stringify(value).trim();
+  const parsed = (0, _dayjs.default)(source);
+  if (!parsed.isValid()) return {
+    date: '',
+    time: '',
+    text: source
+  };
+  const hasTime = /\d{1,2}:\d{2}/.test(source);
+  const date = parsed.format(locale === 'en' ? 'DD/MM/YYYY' : 'YYYY/MM/DD');
+  const time = hasTime ? parsed.format(/\d{1,2}:\d{2}:\d{2}/.test(source) ? 'HH:mm:ss' : 'HH:mm') : '';
+  return {
+    date,
+    time,
+    text: time ? `${time} ${date}` : date
+  };
+}
+function getVoucherAssetIdentity(voucher) {
+  return {
+    id: firstNormalizedWalletAssetId(voucher.voucher_id, voucher.id),
+    codes: normalizeWalletAssetCodes(voucher.code, voucher.encoded)
+  };
+}
+function getVoucherAssetName(voucher, locale) {
+  return getLocalizedValue(voucher.product_name || voucher.name || voucher.title, locale) || stringify(voucher.encoded || voucher.code || label(locale, 'giftCard'));
+}
+function getVoucherDiscountPercent(voucher) {
+  const discountType = stringify(voucher.metadata?.discount_card_type || voucher.discount_card_type).toLowerCase();
+  if (discountType !== 'percent' && discountType !== 'percentage') return null;
+  const percent = new _decimal.default(toMoneyNumber(voucher.par_value));
+  if (!percent.isFinite() || percent.lte(0) || percent.gt(100)) return null;
+  return percent;
+}
+function appendPercentToVoucherName(name, percent) {
+  if (/\d+(?:\.\d+)?\s*(?:%|折)|\boff\b/i.test(name)) return name;
+  const separator = /^[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}]/u.test(name) ? '' : ' ';
+  return `${trimDecimal(percent)}%${separator}${name}`;
+}
+function formatVoucherDiscount(percent, locale) {
+  const normalizedLocale = normalizeLocaleKey(locale);
+  if (normalizedLocale === 'zh_CN' || normalizedLocale === 'zh_HK') {
+    return `${trimDecimal(percent)}% OFF`;
+  }
+  if (normalizedLocale === 'pt') return `Desconto ${trimDecimal(percent)}%`;
+  return normalizedLocale === 'en' ? `Discount ${trimDecimal(percent)}% OFF` : `${trimDecimal(percent)}% OFF`;
+}
+function getVoucherBalance(voucher) {
+  for (const value of [voucher.metadata?.balance, voucher.balance]) {
+    if (!isNumericAmount(value)) continue;
+    return _decimal.default.max(new _decimal.default(value), 0);
+  }
+  const parValue = new _decimal.default(toMoneyNumber(voucher.par_value));
+  const usedParValue = new _decimal.default(toMoneyNumber(voucher.used_par_value));
+  return _decimal.default.max(parValue.minus(usedParValue), 0);
+}
+function buildPaymentItems(params) {
+  const {
+    payment,
+    locale,
+    currencySymbol,
+    includeFundRecordBalance,
+    includeFundRecordUsage,
+    includePaymentAmount,
+    virtualCurrencyUnit
+  } = params;
+  const serviceFee = getPaymentServiceFee(payment);
+  const items = [{
+    ...receiptKey(payment, 'payment'),
+    item: paymentMethodName(payment, locale),
+    value: includePaymentAmount ? formatMoney(resolveReceiptPaymentAmount(payment, serviceFee), currencySymbol) : ''
+  }];
+  items.push(...buildCashChangePaymentItems({
+    payment,
+    locale,
+    currencySymbol
+  }));
+  if (serviceFee.gt(0)) {
+    items.push({
+      ...receiptKey(payment, 'surchargeIncluded'),
+      item: label(locale, 'surchargeIncluded'),
+      value: formatMoney(serviceFee, currencySymbol)
+    });
+  }
+  const fundRecord = getFundRecord(payment);
+  if (fundRecord) {
+    items.push(...buildFundRecordPaymentItems({
+      payment,
+      fundRecord,
+      locale,
+      currencySymbol,
+      includeBalance: includeFundRecordBalance,
+      includeUsage: includeFundRecordUsage,
+      virtualCurrencyUnit
+    }));
+  } else {
+    const remainingAmount = payment.remaining_amount ?? payment.balance ?? payment.metadata?.remaining_amount;
+    if (remainingAmount !== undefined && remainingAmount !== null) {
+      items.push({
+        ...receiptKey(payment, 'remainingAmount'),
+        item: label(locale, 'remainingAmount'),
+        value: formatMoney(remainingAmount, currencySymbol)
+      });
+    }
+  }
+  items.push({
+    ...receiptTimeKey(payment, 'payment-time'),
+    item: formatDateTime(payment.paid_at || payment.created_at || payment.updated_at || new Date(), locale),
+    value: ''
+  });
+  return items.map(item => item.receipt_key ? {
+    ...item,
+    receipt_key: `${item.receipt_key}/${includeFundRecordBalance ? 'wallet' : 'history'}`
+  } : item);
+}
+function getPaymentServiceFee(payment) {
+  return new _decimal.default(toMoneyNumber(payment.service_fee));
+}
+function resolveReceiptPaymentAmount(payment, serviceFee) {
+  const amount = new _decimal.default(toMoneyNumber(payment.amount ?? payment.origin_amount));
+  const hasAmount = payment.amount !== undefined && payment.amount !== null && payment.amount !== '';
+  const hasOriginAmount = payment.origin_amount !== undefined && payment.origin_amount !== null && payment.origin_amount !== '';
+  if (!hasAmount || !hasOriginAmount || serviceFee.lte(0)) return amount;
+  const originAmount = new _decimal.default(toMoneyNumber(payment.origin_amount));
+  return amount.eq(originAmount) ? amount.plus(serviceFee) : amount;
+}
+function buildCashChangePaymentItems(params) {
+  const {
+    payment,
+    locale,
+    currencySymbol
+  } = params;
+  if (!shouldDisplayCashChange(payment)) return [];
+  return [{
+    ...receiptKey(payment, 'cashReceived'),
+    item: label(locale, 'cashReceived'),
+    value: formatMoney(payment.metadata.actual_paid_amount, currencySymbol)
+  }, {
+    ...receiptKey(payment, 'changeDue'),
+    item: label(locale, 'changeDue'),
+    value: formatMoney(payment.metadata.change_given_amount, currencySymbol)
+  }];
+}
+function shouldDisplayCashChange(payment) {
+  if (stringify(payment.status).toLowerCase() !== 'paid') return false;
+  const paymentMethod = stringify(payment.code ?? payment.payment_method).toUpperCase();
+  if (paymentMethod !== 'CASHMANUAL') return false;
+  const actualPaidAmount = payment.metadata?.actual_paid_amount;
+  const changeGivenAmount = payment.metadata?.change_given_amount;
+  if (!isNumericAmount(actualPaidAmount) || !isNumericAmount(changeGivenAmount)) return false;
+  return new _decimal.default(changeGivenAmount).toDecimalPlaces(2).gt(0);
+}
+function isNumericAmount(value) {
+  if (typeof value === 'number') return Number.isFinite(value);
+  if (typeof value !== 'string') return false;
+  const normalized = value.trim();
+  return normalized !== '' && /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i.test(normalized);
+}
+function buildFundRecordPaymentItems(params) {
+  const {
+    payment,
+    fundRecord,
+    locale,
+    currencySymbol,
+    includeBalance,
+    includeUsage,
+    virtualCurrencyUnit
+  } = params;
+  const items = [];
+  const usingBeforeValue = fundRecord.using_before_value;
+  const usingAfterValue = fundRecord.using_after_value;
+  if (isPointCardPayment(payment) && usingBeforeValue !== undefined && usingAfterValue !== undefined) {
+    const usedPoints = new _decimal.default(toMoneyNumber(usingBeforeValue)).minus(toMoneyNumber(usingAfterValue));
+    if (includeUsage) {
+      items.push({
+        ...receiptKey(payment, 'redeemPoints'),
+        item: label(locale, 'redeemPoints'),
+        value: trimDecimal(usedPoints)
+      });
+    }
+    if (includeBalance) {
+      items.push({
+        ...receiptKey(payment, 'remainingPoints'),
+        item: label(locale, 'remainingPoints'),
+        value: trimDecimal(new _decimal.default(toMoneyNumber(usingAfterValue)))
+      });
+    }
+    return items;
+  }
+  if (includeBalance && usingAfterValue !== undefined && usingAfterValue !== null) {
+    if (virtualCurrencyUnit !== undefined) {
+      if (!isNumericAmount(usingAfterValue)) return items;
+      items.push({
+        ...receiptKey(payment, 'balance'),
+        item: label(locale, 'balance'),
+        value: formatVirtualCurrencyBalance(new _decimal.default(usingAfterValue), virtualCurrencyUnit)
+      });
+      return items;
+    }
+    items.push({
+      ...receiptKey(payment, 'balance'),
+      item: label(locale, 'balance'),
+      value: formatMoney(usingAfterValue, currencySymbol)
+    });
+  }
+  return items;
+}
+function getFundRecord(payment) {
+  const fundRecord = payment.fund_record;
+  if (!fundRecord || typeof fundRecord !== 'object' || Array.isArray(fundRecord)) return null;
+  if (!fundRecord.voucher_id && !fundRecord.code) return null;
+  return fundRecord;
+}
+function isPointCardPayment(payment) {
+  const code = stringify(payment.code || payment.payment_method).toUpperCase();
+  const type = stringify(payment.type || payment.fund_record?.tag).toLowerCase();
+  return code === 'POINTCARD' || type === 'point_card';
+}
+function maskMachineCode(code) {
+  const text = stringify(code).trim();
+  if (!text) return '';
+  if (text.length <= 6) return '*'.repeat(text.length);
+  return `${text.slice(0, 2)}****${text.slice(-4)}`;
+}
+function appendMaskedCardCode(name, code) {
+  const maskedCode = maskMachineCode(code);
+  return maskedCode ? `${name}(${maskedCode})` : name;
+}
+function trimDecimal(value) {
+  return value.toDecimalPlaces(2).toFixed(2).replace(/\.?0+$/, '');
+}
+function getFundRecordPaymentName(payment, locale) {
+  const fundRecord = getFundRecord(payment);
+  if (!fundRecord) return '';
+  const name = getLocalizedValue(fundRecord.wallet_pass_name, locale);
+  if (!name && !maskMachineCode(fundRecord.code)) return '';
+  const fallbackName = getLocalizedValue(payment.name || payment.title || payment.payment_method_name || payment.method_name || payment.code, locale);
+  return appendMaskedCardCode(name || fallbackName, fundRecord.code);
+}
+function appendMachineCodeToName(name, payment) {
+  const fundRecord = getFundRecord(payment);
+  return appendMaskedCardCode(name, fundRecord?.code);
+}
+function paymentMethodName(payment, locale) {
+  const fundRecordName = getFundRecordPaymentName(payment, locale);
+  if (fundRecordName) return fundRecordName;
+  const raw = payment.name || payment.title || payment.payment_method_name || payment.method_name;
+  if (raw) return appendMachineCodeToName(getLocalizedValue(raw, locale), payment);
+  const code = stringify(payment.code || payment.type || payment.payment_method || payment.method).toLowerCase();
+  if (code.includes('cash')) return label(locale, 'cash');
+  if (code.includes('eftpos') || code.includes('card')) return label(locale, 'eftpos');
+  if (code.includes('wallet')) return label(locale, 'wallet');
+  if (code.includes('gift')) return label(locale, 'giftCard');
+  return stringify(payment.code || payment.type || payment.payment_method || payment.method);
+}
+function getSummary(order) {
+  return order.summary && typeof order.summary === 'object' ? order.summary : order;
+}
+function getCurrencySymbol(order, shopInfo) {
+  return stringify(order.currency_symbol || shopInfo?.currency_symbol || order.shop_symbol || '$') || '$';
+}
+function resolveLocales(shopInfo, locales) {
+  const preferred = [...(locales || []), shopInfo.primary_locale, ...DEFAULT_LOCALES].filter(Boolean);
+  return Array.from(new Set(preferred.map(normalizeLocaleKey)));
+}
+function normalizeLocaleKey(locale) {
+  return locale.replace('-', '_');
+}
+function label(locale, key) {
+  return LABELS[locale]?.[key] || LABELS.en[key] || key;
+}
+function getLocalizedValue(value, locale) {
+  if (value === undefined || value === null) return '';
+  if (typeof value !== 'object') return stringify(value);
+  const dashedLocale = locale.replace('_', '-');
+  const underscoredLocale = locale.replace('-', '_');
+  return stringify(value[locale] ?? value[dashedLocale] ?? value[underscoredLocale] ?? value.original ?? value.auto ?? value.default ?? value.en ?? '');
+}
+function resolveServiceTypeLabelKey(serviceType) {
+  return SERVICE_TYPE_LABEL_KEYS[serviceType] || null;
+}
+function normalizeBooleanFlag(value) {
+  if (value === true || value === 1 || stringify(value).trim() === '1') return 1;
+  return 0;
+}
+function buildShopAddress(shopInfo) {
+  return [shopInfo.address_street, shopInfo.address_detail, shopInfo.city, shopInfo.province, shopInfo.country, shopInfo.zip].filter(Boolean).join(', ');
+}
+function formatDateTime(value, locale) {
+  const date = (0, _dayjs.default)(value);
+  if (!date.isValid()) return stringify(value);
+  if (locale === 'en') return date.format('HH:mm:ss DD/MM/YYYY');
+  return date.format('YYYY/MM/DD HH:mm:ss');
+}
+function formatMoney(value, currencySymbol) {
+  if (value instanceof _decimal.default) return `${currencySymbol}${value.toFixed(2)}`;
+  if (typeof value === 'string' && value.trim().startsWith(currencySymbol)) return value;
+  const amount = new _decimal.default(toMoneyNumber(value));
+  return `${currencySymbol}${amount.toFixed(2)}`;
+}
+function formatCalculatedMoney(value, currencySymbol) {
+  const amount = new _decimal.default(toMoneyNumber(value));
+  const sign = amount.isNegative() ? '-' : '';
+  return `${sign}${currencySymbol}${amount.abs().toFixed(2)}`;
+}
+function formatNegativeMoney(value, currencySymbol) {
+  const amount = new _decimal.default(toMoneyNumber(value)).abs();
+  return `-${currencySymbol}${amount.toFixed(2)}`;
+}
+function sumAppliedPayments(payments) {
+  return normalizeArray(payments).filter(payment => isPrintablePayment(payment)).reduce((sum, payment) => {
+    if (isPresentId(payment.origin_amount)) {
+      return sum.plus(toMoneyNumber(payment.origin_amount));
+    }
+    const amount = new _decimal.default(toMoneyNumber(payment.amount));
+    const serviceFee = _decimal.default.max(toMoneyNumber(payment.service_fee), 0);
+    return sum.plus(_decimal.default.max(amount.minus(serviceFee), 0));
+  }, new _decimal.default(0));
+}
+function sumCustomerPaidPayments(payments) {
+  return normalizeArray(payments).filter(payment => isPrintablePayment(payment)).reduce((sum, payment) => {
+    return sum.plus(toMoneyNumber(payment.amount ?? payment.origin_amount));
+  }, new _decimal.default(0));
+}
+function isPrintablePayment(payment) {
+  const status = stringify(payment.status).toLowerCase();
+  if (!status) return true;
+  return ['paid', 'success', 'succeeded', 'completed', 'partially_refunded', 'refunded'].includes(status);
+}
+function normalizeArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+function isNonZero(value) {
+  return !new _decimal.default(toMoneyNumber(value)).isZero();
+}
+function toMoneyNumber(value) {
+  if (value instanceof _decimal.default) return value.toString();
+  if (typeof value === 'number') return Number.isFinite(value) ? value : 0;
+  if (typeof value !== 'string') return 0;
+  const normalized = value.replace(/[^\d.-]/g, '');
+  return normalized || 0;
+}
+function toNumber(value, fallback) {
+  const numberValue = Number(value);
+  return Number.isFinite(numberValue) ? numberValue : fallback;
+}
+function stringify(value) {
+  if (value === undefined || value === null) return '';
+  return String(value);
+}