@pisell/pisellos 0.10.7 → 0.10.9

package/lib/modules/Order/index.js

@@ -44,6 +44,8 @@ var import_utils3 = require("../../solution/ScanOrder/utils");
 var import_manualProductDiscount = require("./utils/manualProductDiscount");
 var import_bundleDiscountHydration = require("./utils/bundleDiscountHydration");
 var import_orderCollectionIdentity = require("./utils/orderCollectionIdentity");
+var import_discountProductLineIdentity = require("./utils/discountProductLineIdentity");
+var import_virtualSettlement = require("./utils/virtualSettlement");
 var import_Discount = require("../Discount");
 var import_Rules = require("../Rules");
 var import_types2 = require("../Rules/types");
@@ -65,8 +67,7 @@ function isSameDiscountList(left, right) {
   );
 }
 function isManualProductDiscountProduct(product) {
-  var _a, _b;
-  return ((_a = product == null ? void 0 : product.metadata) == null ? void 0 : _a.is_manual_discount) === true || ((_b = product == null ? void 0 : product.metadata) == null ? void 0 : _b.is_manual_discount) === 1 || ((product == null ? void 0 : product.discount_list) || []).some((item) => (item == null ? void 0 : item.type) === "product");
+  return (0, import_manualProductDiscount.hasManualProductDiscountFlag)(product == null ? void 0 : product.metadata) || ((product == null ? void 0 : product.discount_list) || []).some((item) => (item == null ? void 0 : item.type) === "product");
 }
 var ORDER_PAYMENT_STATUS_PAID = "paid";
 var ORDER_PAYMENT_STATUS_PENDING = "payment_pending";
@@ -136,7 +137,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     this.draftPersistEnabled = true;
   }
   collectHydratedEditDiscounts(products) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
     const discountMap = /* @__PURE__ */ new Map();
     for (const product of (0, import_bundleDiscountHydration.expandHydratedProductsForDiscountCollection)(products)) {
       for (const item of (product == null ? void 0 : product.discount_list) || []) {
@@ -151,16 +152,18 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         const key = Number.isFinite(id) ? id : String(resourceId);
         const title = ((_b = item == null ? void 0 : item.discount) == null ? void 0 : _b.title) ?? {};
         const amount = Number((item == null ? void 0 : item.amount) || 0);
+        const discountCardType = (_c = item == null ? void 0 : item.discount) == null ? void 0 : _c.discount_card_type;
+        const parValue = isDiscountCard ? discountCardType === "fixed_amount" ? ((_d = item == null ? void 0 : item.discount) == null ? void 0 : _d.fixed_amount) ?? (item == null ? void 0 : item.amount) : (_e = item == null ? void 0 : item.discount) == null ? void 0 : _e.percent : "0";
         const detail = {
           amount: String((item == null ? void 0 : item.amount) ?? "0"),
           type,
           resource_id: key,
           title,
-          original_amount: String(((_c = item == null ? void 0 : item.discount) == null ? void 0 : _c.original_amount) ?? (item == null ? void 0 : item.amount) ?? "0"),
-          num: Number(((_d = item == null ? void 0 : item.metadata) == null ? void 0 : _d.num) ?? (product == null ? void 0 : product.num) ?? (product == null ? void 0 : product.product_quantity) ?? 1) || 1,
+          original_amount: String(((_f = item == null ? void 0 : item.discount) == null ? void 0 : _f.original_amount) ?? (item == null ? void 0 : item.amount) ?? "0"),
+          num: Number(((_g = item == null ? void 0 : item.metadata) == null ? void 0 : _g.num) ?? (product == null ? void 0 : product.num) ?? (product == null ? void 0 : product.product_quantity) ?? 1) || 1,
           metadata: item == null ? void 0 : item.metadata,
           discount: item == null ? void 0 : item.discount,
-          _num: Number(((_e = item == null ? void 0 : item.metadata) == null ? void 0 : _e.num) ?? (product == null ? void 0 : product.num) ?? (product == null ? void 0 : product.product_quantity) ?? 1) || 1
+          _num: Number(((_h = item == null ? void 0 : item.metadata) == null ? void 0 : _h.num) ?? (product == null ? void 0 : product.num) ?? (product == null ? void 0 : product.product_quantity) ?? 1) || 1
         };
         const existed = discountMap.get(key);
         if (existed) {
@@ -169,7 +172,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           if (!isDiscountCard) {
             existed.balance = String(Number(existed.balance || 0) + amount);
           }
-          const productIds = Array.isArray((_f = existed.limited_relation_product_data) == null ? void 0 : _f.product_ids) ? existed.limited_relation_product_data.product_ids : [];
+          const productIds = Array.isArray((_i = existed.limited_relation_product_data) == null ? void 0 : _i.product_ids) ? existed.limited_relation_product_data.product_ids : [];
           if ((product == null ? void 0 : product.product_id) !== void 0 && (product == null ? void 0 : product.product_id) !== null && !productIds.includes(product.product_id)) {
             existed.limited_relation_product_data = {
               ...existed.limited_relation_product_data || {},
@@ -192,9 +195,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           encoded: "",
           code: "",
           tag: type,
-          product_id: ((_g = item == null ? void 0 : item.discount) == null ? void 0 : _g.discount_product_id) ?? (product == null ? void 0 : product.product_id) ?? 0,
+          product_id: ((_j = item == null ? void 0 : item.discount) == null ? void 0 : _j.discount_product_id) ?? (product == null ? void 0 : product.product_id) ?? 0,
           relation_type: "",
-          par_value: String(((_h = item == null ? void 0 : item.discount) == null ? void 0 : _h.original_amount) ?? (item == null ? void 0 : item.amount) ?? "0"),
+          par_value: String(parValue ?? "0"),
           used_par_value: String((item == null ? void 0 : item.amount) ?? "0"),
           limit_status: "enable",
           limited_relation_product_data: {
@@ -224,8 +227,8 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           discount: {
             ...(item == null ? void 0 : item.discount) || {},
             resource_id: key,
-            discount_product_id: ((_i = item == null ? void 0 : item.discount) == null ? void 0 : _i.discount_product_id) ?? (product == null ? void 0 : product.product_id) ?? 0,
-            discount_calculation_mode: ((_j = item == null ? void 0 : item.discount) == null ? void 0 : _j.discount_calculation_mode) ?? "item_level"
+            discount_product_id: ((_k = item == null ? void 0 : item.discount) == null ? void 0 : _k.discount_product_id) ?? (product == null ? void 0 : product.product_id) ?? 0,
+            discount_calculation_mode: ((_l = item == null ? void 0 : item.discount) == null ? void 0 : _l.discount_calculation_mode) ?? "item_level"
           },
           applicableProductDetails: [detail],
           appliedProductDetails: [detail]
@@ -277,7 +280,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         const isPersistedBundleProduct = isPersistedProduct || Boolean(
           (bundle == null ? void 0 : bundle.order_detail_id) || (bundle == null ? void 0 : bundle.orderDetailId) || (bundle == null ? void 0 : bundle.booking_id)
         );
-        const bundleQty = new import_decimal.default(Number(qty) || 1).times(Number((bundle == null ? void 0 : bundle.num) ?? (bundle == null ? void 0 : bundle.quantity) ?? 1) || 1).toNumber();
+        const bundleQty = Number(qty) || 1;
         for (const pd of (bundle == null ? void 0 : bundle.discount_list) || []) {
           addProductDiscountAmount(pd, bundleQty, isPersistedBundleProduct);
         }
@@ -352,6 +355,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       this.store.tempOrder = null;
       this.store.summary = (0, import_utils.createEmptySummary)();
       this.store.availableWalletIds = [];
+      this.store.virtualCurrencyList = [];
       this.store.lastOrderInfo = void 0;
       this.store.syncState = void 0;
       this.store.discountList = [];
@@ -364,6 +368,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     if (!Array.isArray(this.store.availableWalletIds)) {
       this.store.availableWalletIds = [];
     }
+    if (!Array.isArray(this.store.virtualCurrencyList)) {
+      this.store.virtualCurrencyList = [];
+    }
     this.request = this.core.getPlugin("request");
     const appPlugin = this.core.getPlugin("app");
     if (!appPlugin) {
@@ -499,11 +506,13 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       with_wallet_pass_holder: 1,
       with_available_wallet_flag: 1,
       with_available_wallet_pass_flag: 1,
+      with_virtual_currency: 1,
       request_timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
       ...orderId ? { order_id: orderId } : {}
     }));
     const discountList = prepareConfigResult == null ? void 0 : prepareConfigResult.discountList;
     this.store.availableWalletIds = (prepareConfigResult == null ? void 0 : prepareConfigResult.availableWalletIds) || [];
+    this.store.virtualCurrencyList = (prepareConfigResult == null ? void 0 : prepareConfigResult.virtualCurrencyList) || [];
     if (discountList) {
       const currentDiscountList = ((_c = this.store.discount) == null ? void 0 : _c.getDiscountList()) || [];
       const currentEditDiscounts = currentDiscountList.filter((discount) => discount == null ? void 0 : discount.isEditMode);
@@ -540,6 +549,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   getAvailableWalletIds() {
     return Array.isArray(this.store.availableWalletIds) ? [...this.store.availableWalletIds] : [];
   }
+  getVirtualCurrencyList() {
+    return (0, import_lodash_es.cloneDeep)(this.store.virtualCurrencyList || []);
+  }
   async syncScannedDiscountsToOriginalDiscountList(discountList) {
     var _a, _b, _c, _d;
     const scanDiscounts = (discountList || []).filter((discount) => discount == null ? void 0 : discount.isScan);
@@ -574,6 +586,16 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   }
   async scanCode(code, customerId) {
     var _a, _b, _c, _d, _e;
+    if (this.isActiveVirtualSettlementOrder(this.store.tempOrder)) {
+      return {
+        type: "clientCalc",
+        isAvailable: false,
+        isAccepted: false,
+        discountList: [],
+        scannedDiscountList: [],
+        unavailableReason: import_types2.UnavailableReason.ProductNotApplicable
+      };
+    }
     const resultDiscountWithReason = await ((_a = this.store.discount) == null ? void 0 : _a.batchSearch(code, { customerId })) || { discountList: [], unavailableReasonKey: null };
     const { discountList: resultDiscountList, unavailableReasonKey } = resultDiscountWithReason;
     const rulesModule = this.store.rules;
@@ -651,13 +673,21 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     };
   }
   applyDiscount(options) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e;
     const tempOrder = this.store.tempOrder;
     if (!tempOrder)
       return;
+    if (this.isActiveVirtualSettlementOrder(tempOrder)) {
+      tempOrder.products = (0, import_virtualSettlement.normalizeVirtualSettlementProducts)(tempOrder.products);
+      tempOrder.discount_list = [];
+      tempOrder.shop_discount = "0.00";
+      void ((_a = this.store.discount) == null ? void 0 : _a.setDiscountList([]));
+      void ((_b = this.store.discount) == null ? void 0 : _b.setOriginalDiscountList([]));
+      return;
+    }
     this.syncLinkedBookingHoldersToProducts(tempOrder);
     delete tempOrder.discount_list;
-    const discountList = ((_a = this.store.discount) == null ? void 0 : _a.getDiscountList()) || [];
+    const discountList = ((_c = this.store.discount) == null ? void 0 : _c.getDiscountList()) || [];
     const shouldSkipDiscountCalculation = this.shouldSkipDiscountCalculation(tempOrder);
     if (shouldSkipDiscountCalculation)
       return;
@@ -669,7 +699,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       discountList,
       holders: [],
       isFormSubject: (product) => (0, import_utils.resolveIsFormSubject)(tempOrder, product),
-      orderTotalAmount: Number(((_b = this.store.summary) == null ? void 0 : _b.total_amount) || 0)
+      orderTotalAmount: Number(((_d = this.store.summary) == null ? void 0 : _d.total_amount) || 0)
     }, {
       reapplyBookingDiscountProductUids: options == null ? void 0 : options.reapplyBookingDiscountProductUids
     });
@@ -694,14 +724,15 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           };
         })
       );
-      this.repairDuplicateProductLineIdentities(tempOrder);
+      (0, import_discountProductLineIdentity.ensureUniqueProductLineUids)(tempOrder);
+      (0, import_discountProductLineIdentity.consolidateDiscountFreeProductLines)(tempOrder);
     }
     if (result == null ? void 0 : result.discountList) {
       OrderModule.populateSavedAmounts(
         result.productList || tempOrder.products,
         result.discountList
       );
-      (_c = this.store.discount) == null ? void 0 : _c.setDiscountList(result.discountList);
+      (_e = this.store.discount) == null ? void 0 : _e.setDiscountList(result.discountList);
     }
     this.hasActiveCustomerBoundDiscount = (tempOrder.products || []).some(
       (product) => this.productHasCustomerBoundDiscount(product)
@@ -761,6 +792,10 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     if (!tempOrder) {
       return;
     }
+    if (this.isActiveVirtualSettlementOrder(tempOrder)) {
+      tempOrder.products = (0, import_virtualSettlement.normalizeVirtualSettlementProducts)(tempOrder.products);
+      return;
+    }
     const strategyConfigs = (_b = (_a = this.promotionEvaluator).getStrategyConfigs) == null ? void 0 : _b.call(_a);
     if (Array.isArray(strategyConfigs) && strategyConfigs.length === 0) {
       return;
@@ -917,6 +952,52 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       cacheKey: ["tempOrder"]
     });
   }
+  /**
+   * 终止当前模块实例的 sessionStorage 订单恢复会话。
+   *
+   * 支付跳转等终态场景需要同时删除当前 cacheId 的 tempOrder 快照，并关闭
+   * 本实例后续异步任务的再次写入；新模块实例初始化时会按 otherParams 重新启用。
+   */
+  clearSessionStoragePersistedTempOrder() {
+    var _a;
+    this.sessionStorageRestoreRecord = null;
+    if (!this.sessionStoragePersistEnabled)
+      return;
+    this.sessionStoragePersistEnabled = false;
+    if (!this.cacheId || !this.fatherModule || !((_a = this.window) == null ? void 0 : _a.sessionStorage)) {
+      return;
+    }
+    const sessionStorage = this.window.sessionStorage;
+    const rawCacheData = sessionStorage.getItem(this.fatherModule);
+    if (!rawCacheData)
+      return;
+    let parsedCacheData;
+    try {
+      parsedCacheData = JSON.parse(rawCacheData);
+    } catch {
+      return;
+    }
+    if (!parsedCacheData || typeof parsedCacheData !== "object" || Array.isArray(parsedCacheData)) {
+      return;
+    }
+    const cacheRoot = parsedCacheData;
+    const cacheBucket = cacheRoot[this.cacheId];
+    if (!cacheBucket || typeof cacheBucket !== "object" || Array.isArray(cacheBucket)) {
+      return;
+    }
+    const moduleBucket = cacheBucket[this.name];
+    if (!moduleBucket || typeof moduleBucket !== "object" || Array.isArray(moduleBucket)) {
+      return;
+    }
+    delete moduleBucket.tempOrder;
+    if (Object.keys(moduleBucket).length === 0) {
+      delete cacheBucket[this.name];
+    }
+    if (Object.keys(cacheBucket).length === 0) {
+      delete cacheRoot[this.cacheId];
+    }
+    sessionStorage.setItem(this.fatherModule, JSON.stringify(cacheRoot));
+  }
   consumeSessionStorageRestore() {
     const record = this.sessionStorageRestoreRecord;
     this.sessionStorageRestoreRecord = null;
@@ -1121,7 +1202,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       paidAmount: netPaidAmount
     });
     const isOrderFullyPaid = orderExpectedAmount.lte(0) ? true : netPaidAmount.gte(orderExpectedAmount);
-    const paymentStage = this.isDepositOrder(tempOrder, depositAmount) && !isDepositFullyPaid ? "deposit" : "normal";
+    const paymentStage = this.isDepositOrder(tempOrder, depositAmount) && !isDepositFullyPaid && !this.hasPaidNormalPayment(paymentList) ? "deposit" : "normal";
     return {
       isFullyPaid: isOrderFullyPaid,
       isOrderFullyPaid,
@@ -1142,12 +1223,22 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       return sum.plus(this.calculatePaymentGapAmount(paymentRecord));
     }, new import_decimal.default(0));
   }
+  hasPaidNormalPayment(payments) {
+    return (payments || []).some((payment) => {
+      const paymentRecord = payment;
+      if (!isPaidPaymentRecord(paymentRecord))
+        return false;
+      return paymentRecord.order_payment_type !== "deposit" && paymentRecord.type !== "deposit";
+    });
+  }
   resolveNextOrderPaymentType(tempOrder) {
     const depositAmount = new import_decimal.default(tempOrder.deposit_amount || "0.00");
     if (!this.isDepositOrder(tempOrder, depositAmount))
       return "normal";
     if (depositAmount.lte(0))
       return "normal";
+    if (this.hasPaidNormalPayment(tempOrder.payments || []))
+      return "normal";
     const depositPaidAmount = this.calculateDepositPaidAmount(tempOrder.payments || []);
     return depositPaidAmount.lt(depositAmount) ? "deposit" : "normal";
   }
@@ -1445,24 +1536,28 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     }
   }
   calculateSummaryAmountGap(params) {
-    const { tempOrder, summary, orderPaidAmount } = params;
+    const { tempOrder, summary, orderPaidAmount, payments } = params;
     const refundAmount = this.getSummaryRefundAmount(summary);
     const netOrderPaidAmount = import_decimal.default.max(orderPaidAmount.minus(refundAmount), 0);
     const targetAmount = this.calculatePaymentTargetAmount(
       tempOrder,
       summary,
-      netOrderPaidAmount
+      netOrderPaidAmount,
+      payments
     );
     return targetAmount.minus(netOrderPaidAmount).toFixed(2);
   }
   getSummaryRefundAmount(summary) {
     return import_decimal.default.max(new import_decimal.default((summary == null ? void 0 : summary.total_refund_amount) || 0), 0);
   }
-  calculatePaymentTargetAmount(tempOrder, summary, paidAmount = new import_decimal.default(0)) {
+  calculatePaymentTargetAmount(tempOrder, summary, paidAmount = new import_decimal.default(0), payments = tempOrder.payments || []) {
     const depositAmount = this.getDepositAmount(tempOrder, summary);
     if (!this.isDepositOrder(tempOrder, depositAmount)) {
       return this.getOrderExpectedAmount(summary);
     }
+    if (this.hasPaidNormalPayment(payments)) {
+      return this.getOrderExpectedAmount(summary);
+    }
     if (this.isDepositCovered({ tempOrder, summary, paidAmount })) {
       return this.getOrderExpectedAmount(summary);
     }
@@ -1642,19 +1737,21 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     return snapshot;
   }
   isSnapshotPayableAmountUnchanged(tempOrder, snapshot, snapshotSummary) {
-    const currentPaidPaymentSummary = this.calculatePaidPaymentSummary(tempOrder.payments || []);
+    const currentPayments = tempOrder.payments || [];
+    const currentPaidPaymentSummary = this.calculatePaidPaymentSummary(currentPayments);
     const currentAmountGap = this.calculateSummaryAmountGap({
       tempOrder,
       summary: snapshotSummary,
-      orderPaidAmount: currentPaidPaymentSummary.gapPaidAmount
+      orderPaidAmount: currentPaidPaymentSummary.gapPaidAmount,
+      payments: currentPayments
     });
-    const snapshotPaidPaymentSummary = this.calculatePaidPaymentSummary(
-      Array.isArray(snapshot.payments) ? snapshot.payments : []
-    );
+    const snapshotPayments = Array.isArray(snapshot.payments) ? snapshot.payments : [];
+    const snapshotPaidPaymentSummary = this.calculatePaidPaymentSummary(snapshotPayments);
     const snapshotAmountGap = this.calculateSummaryAmountGap({
       tempOrder,
       summary: snapshotSummary,
-      orderPaidAmount: snapshotPaidPaymentSummary.gapPaidAmount
+      orderPaidAmount: snapshotPaidPaymentSummary.gapPaidAmount,
+      payments: snapshotPayments
     });
     return currentAmountGap === snapshotAmountGap;
   }
@@ -1696,6 +1793,12 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const isPayableAmountUnchanged = this.isSnapshotPayableAmountUnchanged(tempOrder, snapshot, summary);
     if (!isPayableAmountUnchanged)
       return null;
+    const currentPaidPaymentSummary = this.calculatePaidPaymentSummary(tempOrder.payments || []);
+    summary.amount_gap = this.calculateSummaryAmountGap({
+      tempOrder,
+      summary,
+      orderPaidAmount: currentPaidPaymentSummary.gapPaidAmount
+    });
     if (Array.isArray(snapshot.products)) {
       tempOrder.products = (0, import_lodash_es.cloneDeep)(snapshot.products);
     }
@@ -1920,8 +2023,12 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   }
   sanitizeTempOrderProducts(tempOrder) {
     tempOrder.products = (tempOrder.products || []).map(
-      (product) => this.sanitizeOrderProductForTempOrder(product)
+      (product) => this.sanitizeOrderProductForTempOrder(
+        this.normalizeVirtualSettlementProductIfEnabled(product)
+      )
     );
+    this.syncTempOrderSettlementState(tempOrder);
+    (0, import_discountProductLineIdentity.ensureUniqueProductLineUids)(tempOrder);
   }
   ensureExtend(tempOrder) {
     if (!tempOrder._extend || typeof tempOrder._extend !== "object") {
@@ -2264,6 +2371,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       products: summaryProducts,
       isPriceIncludeTax: tempOrder.is_price_include_tax,
       shopDiscount: tempOrder.shop_discount,
+      virtualSettlementMode: this.shouldUseVirtualSettlementSummary(tempOrder),
       ...((_a = this.otherParams) == null ? void 0 : _a.channel) ? { channel: this.otherParams.channel } : {}
     });
     if (shouldFullRecalculateFromSnapshot) {
@@ -2553,6 +2661,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const nextCustomerId = tempOrder.customer_id ?? null;
     if (String(previousCustomerId ?? "") !== String(nextCustomerId ?? "")) {
       this.store.availableWalletIds = [];
+      this.store.virtualCurrencyList = [];
       (0, import_utils.clearTempOrderHolderAssignments)(tempOrder);
       this.clearCustomerBoundDiscounts(tempOrder);
       this.applyDiscount();
@@ -2593,7 +2702,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     if (tempOrder._extend)
       delete tempOrder._extend.customerSnapshot;
     this.store.availableWalletIds = [];
+    this.store.virtualCurrencyList = [];
     this.clearCustomerBoundDiscounts(tempOrder);
+    this.applyDiscount();
     this.persistTempOrder();
     this.saveDraftInBackground();
     this.core.effects.emit(import_types.OrderHooks.OnOrderCustomerChange, null);
@@ -2899,21 +3010,29 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       devicePrefix
     });
   }
-  async shouldMergeProductToOrder(params) {
+  normalizeShouldMergeProductResult(result) {
+    if (typeof result === "boolean")
+      return result;
+    if (result && typeof result === "object" && typeof result.shouldMerge === "boolean") {
+      return result.shouldMerge;
+    }
+    return true;
+  }
+  shouldMergeProductToOrder(params) {
     var _a;
     const onBeforeMergeProductToOrder = (_a = this.orderHooks) == null ? void 0 : _a.onBeforeMergeProductToOrder;
     if (!onBeforeMergeProductToOrder)
       return true;
-    const result = await onBeforeMergeProductToOrder({
+    const result = onBeforeMergeProductToOrder({
       ...params,
       defaultShouldMerge: true
     });
-    if (typeof result === "boolean")
-      return result;
-    if (result && typeof result === "object" && typeof result.shouldMerge === "boolean") {
-      return result.shouldMerge;
+    if (result && typeof result === "object" && typeof result.then === "function") {
+      return Promise.resolve(result).then(
+        (resolved) => this.normalizeShouldMergeProductResult(resolved)
+      );
     }
-    return true;
+    return this.normalizeShouldMergeProductResult(result);
   }
   hasOrderProductLineNote(product) {
     return typeof (product == null ? void 0 : product.note) === "string" && product.note.trim().length > 0;
@@ -2929,6 +3048,101 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const bookingUid = (product == null ? void 0 : product.booking_uid) ?? ((_a = product == null ? void 0 : product.metadata) == null ? void 0 : _a.booking_uid);
     return bookingUid !== void 0 && bookingUid !== null && String(bookingUid) !== "";
   }
+  isMultiCurrencySettlementEnabled() {
+    var _a;
+    return ((_a = this.otherParams) == null ? void 0 : _a.enableMultiCurrencySettlement) === true;
+  }
+  isActiveVirtualSettlementOrder(tempOrder) {
+    return this.isMultiCurrencySettlementEnabled() && (0, import_virtualSettlement.isVirtualSettlementOrder)(tempOrder);
+  }
+  shouldUseVirtualSettlementSummary(tempOrder) {
+    var _a, _b;
+    return this.isActiveVirtualSettlementOrder(tempOrder) || ((_b = (_a = tempOrder == null ? void 0 : tempOrder.metadata) == null ? void 0 : _a.currency_settlement_config) == null ? void 0 : _b.settlement_type) === "virtual_currency";
+  }
+  normalizeVirtualSettlementProductIfEnabled(product) {
+    return this.isMultiCurrencySettlementEnabled() ? (0, import_virtualSettlement.normalizeVirtualSettlementOrderProduct)(product) : product;
+  }
+  assertAndLockProductSettlement(tempOrder, product) {
+    if (!this.isMultiCurrencySettlementEnabled())
+      return;
+    const currentKey = (0, import_virtualSettlement.getTempOrderSettlementKey)(tempOrder);
+    const incomingKey = (0, import_virtualSettlement.getSettlementKey)(
+      (0, import_virtualSettlement.getSelectedSettlementSnapshot)(product)
+    ) || "legal_currency";
+    if (currentKey && currentKey !== incomingKey) {
+      throw new import_virtualSettlement.OrderSettlementConflictError(currentKey, incomingKey);
+    }
+    const snapshot = (0, import_virtualSettlement.getSelectedSettlementSnapshot)(product);
+    if ((snapshot == null ? void 0 : snapshot.settlement_type) === "virtual_currency" && tempOrder.customer_id && Number(tempOrder.customer_id) !== 1) {
+      const currencyProductId = Number(snapshot.currency_product_id);
+      const asset = (this.store.virtualCurrencyList || []).find(
+        (item) => Number(item == null ? void 0 : item.product_id) === currencyProductId
+      );
+      if (!asset) {
+        throw new import_virtualSettlement.VirtualCurrencyAssetNotFoundError(currencyProductId);
+      }
+      const existedAmount = tempOrder.products.reduce(
+        (sum, item) => sum.plus(
+          new import_decimal.default(item.selling_price || 0).times(item.num || 1)
+        ),
+        new import_decimal.default(0)
+      );
+      const requiredAmount = existedAmount.plus(
+        new import_decimal.default(snapshot.price || 0).times(product.num || 1)
+      );
+      const balance = new import_decimal.default(asset.balance || 0);
+      if (balance.lt(requiredAmount)) {
+        throw new import_virtualSettlement.VirtualCurrencyBalanceError(
+          balance.toFixed(2),
+          requiredAmount.toFixed(2)
+        );
+      }
+    }
+    (0, import_virtualSettlement.applyTempOrderSettlementState)(
+      tempOrder,
+      snapshot || {
+        settlement_type: "legal_currency",
+        price: product.selling_price ?? product.original_price ?? product.payment_price ?? 0,
+        unit_label: tempOrder.currency_code,
+        symbol: tempOrder.currency_symbol,
+        amount_format: tempOrder.currency_format
+      }
+    );
+  }
+  syncTempOrderSettlementState(tempOrder) {
+    if (!this.isMultiCurrencySettlementEnabled())
+      return;
+    tempOrder.metadata = tempOrder.metadata || {};
+    if (!tempOrder.products.length) {
+      (0, import_virtualSettlement.releaseTempOrderSettlementState)(tempOrder);
+      return;
+    }
+    const snapshot = (0, import_virtualSettlement.getTempOrderSettlementSnapshot)(tempOrder);
+    if (snapshot) {
+      (0, import_virtualSettlement.applyTempOrderSettlementState)(tempOrder, snapshot);
+      return;
+    }
+    tempOrder.metadata.cart_settlement_key = "legal_currency";
+  }
+  prepareVirtualSettlementTempOrder(tempOrder) {
+    if (!this.isMultiCurrencySettlementEnabled())
+      return;
+    this.syncTempOrderSettlementState(tempOrder);
+    if (!this.isActiveVirtualSettlementOrder(tempOrder))
+      return;
+    tempOrder.products = (0, import_virtualSettlement.normalizeVirtualSettlementProducts)(tempOrder.products);
+    tempOrder.discount_list = [];
+    tempOrder.shop_discount = "0.00";
+    tempOrder.surcharge_fee = "0.00";
+    tempOrder.surcharges = [];
+    const virtualOrder = tempOrder;
+    virtualOrder.discount_amount = "0.00";
+    virtualOrder.product_tax_fee = "0.00";
+    virtualOrder.tax_fee = "0.00";
+    virtualOrder.shipping_fee = "0.00";
+    virtualOrder.shipping_tax_fee = "0.00";
+    virtualOrder.tip_fee = "0.00";
+  }
   // ─── TempOrder: 商品 CRUD ───
   /**
    * 预约商品加车后的统一收尾：促销、折扣、summary 重算与持久化（批量拆行时只调用一次）。
@@ -2938,13 +3152,15 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    */
   async finalizeProductOrderMutation(tempOrder, options) {
     this.syncTempOrderHolderFromBookings(tempOrder);
-    if (!(options == null ? void 0 : options.skipEditDiscountConfigRefresh)) {
+    this.prepareVirtualSettlementTempOrder(tempOrder);
+    const isVirtualSettlement = this.isActiveVirtualSettlementOrder(tempOrder);
+    if (!(options == null ? void 0 : options.skipEditDiscountConfigRefresh) && !isVirtualSettlement) {
       await this.ensureEditDiscountConfigForProductChange(tempOrder);
     }
-    if (!(options == null ? void 0 : options.skipDiscountRecalculation)) {
+    if (!(options == null ? void 0 : options.skipDiscountRecalculation) && !isVirtualSettlement) {
       await this.applyPromotion();
     }
-    if (!(options == null ? void 0 : options.skipDiscountRecalculation)) {
+    if (!(options == null ? void 0 : options.skipDiscountRecalculation) && !isVirtualSettlement) {
       this.applyDiscount();
     }
     this.sanitizeTempOrderProducts(tempOrder);
@@ -2956,21 +3172,34 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * 带 booking 且 num>1 时由 `addProductToOrder` 拆成多次本方法调用（每次 num=1）。
    *
    * @example
-   * await this.appendProductLineToTempOrder(tempOrder, { product_id: 1, num: 1 }, booking);
+   * const pending = this.appendProductLineToTempOrder(
+   *   tempOrder,
+   *   { product_id: 1, num: 1 },
+   *   booking,
+   * );
+   * if (pending) await pending;
    */
-  async appendProductLineToTempOrder(tempOrder, product, booking) {
-    var _a, _b;
+  appendProductLineToTempOrder(tempOrder, product, booking, options) {
+    var _a, _b, _c, _d, _e, _f;
     const linked = booking ? this.createLinkedProductAndBooking({ product, booking }) : null;
     const productToAdd = (linked == null ? void 0 : linked.product) || product;
+    this.assertAndLockProductSettlement(tempOrder, productToAdd);
     const incomingFingerprint = (0, import_utils3.buildProductLineFingerprint)(
       (0, import_utils.getProductSkuOptions)(productToAdd),
       productToAdd.product_bundle
     );
-    const normalizedIncoming = (0, import_utils.mergeOrderProductDisplayFields)(
-      productToAdd,
-      (0, import_utils3.normalizeOrderProduct)(productToAdd)
+    const normalizedIncoming = this.normalizeVirtualSettlementProductIfEnabled(
+      (0, import_utils.mergeOrderProductDisplayFields)(
+        productToAdd,
+        (0, import_utils3.normalizeOrderProduct)(productToAdd)
+      )
     );
-    const incomingBookingUid = productToAdd.booking_uid ?? ((_a = productToAdd.metadata) == null ? void 0 : _a.booking_uid);
+    const isWeighingProduct = Number(((_a = normalizedIncoming.product_sku) == null ? void 0 : _a.open_sold_weight) || 0) === 1;
+    const netWeight = Number((_b = normalizedIncoming.product_sku) == null ? void 0 : _b.net_weight);
+    if (isWeighingProduct && (!Number.isFinite(netWeight) || netWeight <= 0)) {
+      throw new Error("[Order] 称重商品净重必须大于 0");
+    }
+    const incomingBookingUid = productToAdd.booking_uid ?? ((_c = productToAdd.metadata) == null ? void 0 : _c.booking_uid);
     if (incomingBookingUid !== void 0 && incomingBookingUid !== null && String(incomingBookingUid) !== "") {
       normalizedIncoming.booking_uid = String(incomingBookingUid);
       normalizedIncoming.metadata = {
@@ -2985,14 +3214,18 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       normalizedIncoming
     );
     const hasIncomingProductNote = this.hasOrderProductLineNote(normalizedIncoming);
+    const hasIncomingManualProductDiscount = isManualProductDiscountProduct(normalizedIncoming);
     const hasIncomingBookingUid = this.hasLinkedBookingUid(productToAdd) || this.hasLinkedBookingUid(normalizedIncoming);
-    const shouldForceNewLine = !!booking || hasIncomingProductNote || hasIncomingBookingUid;
+    const isIncomingCustomItem = ((_e = (_d = productToAdd.metadata) == null ? void 0 : _d.origin) == null ? void 0 : _e.isCustomItem) === true || ((_f = productToAdd._origin) == null ? void 0 : _f.isCustomItem) === true;
+    const shouldForceNewLine = !!booking || hasIncomingProductNote || hasIncomingManualProductDiscount || hasIncomingBookingUid || isIncomingCustomItem || isWeighingProduct;
     const matchedIndex = hasIncomingGoodPass || shouldForceNewLine ? -1 : tempOrder.products.findIndex((item) => {
       var _a2;
       if (this.hasGoodPassDiscount(item))
         return false;
       if (this.hasOrderProductLineNote(item))
         return false;
+      if (isManualProductDiscountProduct(item))
+        return false;
       if (item.order_detail_id !== void 0 && item.order_detail_id !== null)
         return false;
       if ((_a2 = item.metadata) == null ? void 0 : _a2.is_edit_for_runtime)
@@ -3012,7 +3245,92 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       (0, import_utils.getProductSkuOptions)(matchedProduct),
       matchedProduct.product_bundle
     ) : "";
-    const shouldMerge = matchedProduct ? await this.shouldMergeProductToOrder({
+    const commitProductLine = (shouldMerge2) => {
+      var _a2;
+      if (matchedIndex === -1 || !matchedProduct || !shouldMerge2) {
+        this.captureProductRuntime(
+          tempOrder,
+          productToAdd,
+          normalizedIncoming
+        );
+        if (linked) {
+          normalizedIncoming.booking_uid = linked.bookingUid;
+          normalizedIncoming.metadata = {
+            ...normalizedIncoming.metadata || {},
+            booking_uid: linked.bookingUid
+          };
+        }
+        const insertAtIndex = options == null ? void 0 : options.insertAtIndex;
+        if (Number.isInteger(insertAtIndex) && Number(insertAtIndex) >= 0 && Number(insertAtIndex) < tempOrder.products.length) {
+          tempOrder.products = [
+            ...tempOrder.products.slice(0, insertAtIndex),
+            normalizedIncoming,
+            ...tempOrder.products.slice(insertAtIndex)
+          ];
+        } else {
+          tempOrder.products = [...tempOrder.products, normalizedIncoming];
+        }
+      } else {
+        const targetProduct = matchedProduct;
+        const targetUid = (_a2 = targetProduct.metadata) == null ? void 0 : _a2.unique_identification_number;
+        const normalizedProduct = this.normalizeVirtualSettlementProductIfEnabled(
+          (0, import_utils.mergeOrderProductDisplayFields)(
+            targetProduct,
+            (0, import_utils3.normalizeOrderProduct)({
+              ...productToAdd,
+              metadata: {
+                ...productToAdd.metadata || {},
+                unique_identification_number: targetUid
+              }
+            })
+          )
+        );
+        normalizedProduct.discount_list = (0, import_utils.normalizeOrderProductDiscountList)(
+          normalizedProduct.discount_list
+        );
+        const nextNum = (0, import_utils3.getSafeProductNum)(targetProduct.num + normalizedProduct.num);
+        tempOrder.products[matchedIndex] = {
+          ...targetProduct,
+          ...normalizedProduct,
+          discount_list: normalizedProduct.discount_list,
+          metadata: {
+            ...targetProduct.metadata || {},
+            ...normalizedProduct.metadata || {},
+            unique_identification_number: targetUid
+          },
+          product_sku: {
+            ...targetProduct.product_sku || { option: [] },
+            ...normalizedProduct.product_sku || { option: [] },
+            option: (0, import_utils.getProductSkuOptions)(normalizedProduct)
+          },
+          note: targetProduct.note,
+          order_detail_id: targetProduct.order_detail_id,
+          num: nextNum
+        };
+        this.captureProductRuntime(
+          tempOrder,
+          productToAdd,
+          tempOrder.products[matchedIndex],
+          targetUid
+        );
+        if (matchedIndex !== tempOrder.products.length - 1) {
+          const mergedProduct = tempOrder.products[matchedIndex];
+          tempOrder.products = [
+            ...tempOrder.products.slice(0, matchedIndex),
+            ...tempOrder.products.slice(matchedIndex + 1),
+            mergedProduct
+          ];
+        }
+      }
+      if (linked) {
+        tempOrder.bookings = [...tempOrder.bookings || [], linked.booking];
+      }
+    };
+    if (!matchedProduct) {
+      commitProductLine(false);
+      return;
+    }
+    const shouldMerge = this.shouldMergeProductToOrder({
       incomingProduct: productToAdd,
       normalizedIncoming,
       matchedProduct,
@@ -3021,83 +3339,11 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       existedFingerprint,
       tempOrder,
       booking
-    }) : false;
-    if (matchedIndex === -1 || !matchedProduct || !shouldMerge) {
-      this.captureProductRuntime(
-        tempOrder,
-        productToAdd,
-        normalizedIncoming
-      );
-      if (linked) {
-        normalizedIncoming.booking_uid = linked.bookingUid;
-        normalizedIncoming.metadata = {
-          ...normalizedIncoming.metadata || {},
-          booking_uid: linked.bookingUid
-        };
-      }
-      tempOrder.products = [...tempOrder.products, normalizedIncoming];
-    } else {
-      const targetProduct = matchedProduct;
-      const targetUid = (_b = targetProduct.metadata) == null ? void 0 : _b.unique_identification_number;
-      const normalizedProduct = (0, import_utils.mergeOrderProductDisplayFields)(
-        targetProduct,
-        (0, import_utils3.normalizeOrderProduct)({
-          ...productToAdd,
-          metadata: {
-            ...productToAdd.metadata || {},
-            unique_identification_number: targetUid
-          }
-        })
-      );
-      normalizedProduct.discount_list = (0, import_utils.normalizeOrderProductDiscountList)(
-        normalizedProduct.discount_list
-      );
-      const nextNum = (0, import_utils3.getSafeProductNum)(targetProduct.num + normalizedProduct.num);
-      const targetIsManualProductDiscount = isManualProductDiscountProduct(targetProduct);
-      const nextDiscountList = targetIsManualProductDiscount ? (0, import_utils.normalizeOrderProductDiscountList)(
-        (0, import_manualProductDiscount.syncManualProductDiscountProductNum)(
-          targetProduct.discount_list,
-          nextNum
-        )
-      ) : normalizedProduct.discount_list;
-      tempOrder.products[matchedIndex] = {
-        ...targetProduct,
-        ...normalizedProduct,
-        discount_list: nextDiscountList,
-        metadata: {
-          ...targetProduct.metadata || {},
-          ...normalizedProduct.metadata || {},
-          unique_identification_number: targetUid
-        },
-        product_sku: {
-          ...targetProduct.product_sku || { option: [] },
-          ...normalizedProduct.product_sku || { option: [] },
-          option: (0, import_utils.getProductSkuOptions)(normalizedProduct)
-        },
-        ...targetIsManualProductDiscount ? {
-          selling_price: targetProduct.selling_price,
-          original_price: targetProduct.original_price,
-          payment_price: targetProduct.payment_price,
-          metadata: {
-            ...normalizedProduct.metadata || {},
-            ...targetProduct.metadata || {},
-            unique_identification_number: targetUid
-          }
-        } : {},
-        note: targetProduct.note,
-        order_detail_id: targetProduct.order_detail_id,
-        num: nextNum
-      };
-      this.captureProductRuntime(
-        tempOrder,
-        productToAdd,
-        tempOrder.products[matchedIndex],
-        targetUid
-      );
-    }
-    if (linked) {
-      tempOrder.bookings = [...tempOrder.bookings || [], linked.booking];
+    });
+    if (shouldMerge && typeof shouldMerge === "object" && typeof shouldMerge.then === "function") {
+      return Promise.resolve(shouldMerge).then(commitProductLine);
     }
+    commitProductLine(shouldMerge);
   }
   /**
    * 添加商品行。带 booking 时强制独立行；num>1 时拆成多条 num=1 的 product+booking（对齐 BookingByStep / ticketBooking addService）。
@@ -3106,8 +3352,15 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * await order.addProductToOrder({ product_id: 1, num: 3 }, { start_time: '10:00' });
    * // → tempOrder.products 新增 3 行，每行 num=1，bookings 3 条
    */
-  async addProductToOrder(product, booking) {
+  async addProductToOrder(product, booking, options) {
     const tempOrder = this.ensureTempOrder();
+    const insertAfterProductUid = options == null ? void 0 : options.insertAfterProductUid;
+    const anchorIndex = booking && insertAfterProductUid ? tempOrder.products.findIndex((line) => {
+      var _a;
+      const uid = ((_a = line.metadata) == null ? void 0 : _a.unique_identification_number) || line.unique_identification_number;
+      return uid !== void 0 && uid !== null && String(uid) === String(insertAfterProductUid);
+    }) : -1;
+    let insertAtIndex = anchorIndex >= 0 ? anchorIndex + 1 : void 0;
     if (booking) {
       const productRecord = product;
       const splitCount = (0, import_utils3.getSafeProductNum)(
@@ -3118,17 +3371,29 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           const singleLine = (0, import_lodash_es.cloneDeep)(productRecord);
           singleLine.num = 1;
           delete singleLine.product_quantity;
-          await this.appendProductLineToTempOrder(
+          const appendResult2 = this.appendProductLineToTempOrder(
             tempOrder,
             singleLine,
-            (0, import_lodash_es.cloneDeep)(booking)
+            (0, import_lodash_es.cloneDeep)(booking),
+            { insertAtIndex }
           );
+          if (appendResult2)
+            await appendResult2;
+          if (insertAtIndex !== void 0)
+            insertAtIndex += 1;
         }
         await this.finalizeProductOrderMutation(tempOrder);
         return tempOrder.products;
       }
     }
-    await this.appendProductLineToTempOrder(tempOrder, product, booking);
+    const appendResult = this.appendProductLineToTempOrder(
+      tempOrder,
+      product,
+      booking,
+      { insertAtIndex }
+    );
+    if (appendResult)
+      await appendResult;
     await this.finalizeProductOrderMutation(tempOrder);
     this.logInfo("addProductToOrder success", {
       product_id: product.product_id,
@@ -3163,16 +3428,24 @@ var OrderModule = class extends import_BaseModule.BaseModule {
             const singleLine = (0, import_lodash_es.cloneDeep)(productRecord);
             singleLine.num = 1;
             delete singleLine.product_quantity;
-            await this.appendProductLineToTempOrder(
+            const appendResult2 = this.appendProductLineToTempOrder(
               tempOrder,
               singleLine,
               (0, import_lodash_es.cloneDeep)(booking)
             );
+            if (appendResult2)
+              await appendResult2;
           }
           continue;
         }
       }
-      await this.appendProductLineToTempOrder(tempOrder, product, booking);
+      const appendResult = this.appendProductLineToTempOrder(
+        tempOrder,
+        product,
+        booking
+      );
+      if (appendResult)
+        await appendResult;
     }
     await this.finalizeProductOrderMutation(tempOrder, options);
     this.logInfo("addProductsToOrder success", {
@@ -3403,9 +3676,11 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       delete nextProduct.metadata.main_product_original_price;
       delete nextProduct.metadata.price_schema_version;
     }
-    let normalizedProduct = (0, import_utils.mergeOrderProductDisplayFields)(
-      nextProduct,
-      (0, import_utils3.normalizeOrderProduct)(nextProduct)
+    let normalizedProduct = this.normalizeVirtualSettlementProductIfEnabled(
+      (0, import_utils.mergeOrderProductDisplayFields)(
+        nextProduct,
+        (0, import_utils3.normalizeOrderProduct)(nextProduct)
+      )
     );
     normalizedProduct.discount_list = (0, import_utils.normalizeOrderProductDiscountList)(
       normalizedProduct.discount_list
@@ -3536,20 +3811,49 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       throw new Error("[Order] 目标商品不存在，无法更新数量");
     }
     const targetProduct = tempOrder.products[productIndex];
-    const normalizedProduct = (0, import_utils3.normalizeOrderProduct)({
-      ...targetProduct,
-      num: (0, import_utils3.getSafeProductNum)(num),
-      metadata: {
-        ...targetProduct.metadata || {},
-        unique_identification_number: ((_a = targetProduct.metadata) == null ? void 0 : _a.unique_identification_number) || unique_identification_number
-      }
-    });
+    const normalizedProduct = this.normalizeVirtualSettlementProductIfEnabled(
+      (0, import_utils3.normalizeOrderProduct)({
+        ...targetProduct,
+        num: (0, import_utils3.getSafeProductNum)(num),
+        metadata: {
+          ...targetProduct.metadata || {},
+          unique_identification_number: ((_a = targetProduct.metadata) == null ? void 0 : _a.unique_identification_number) || unique_identification_number
+        }
+      })
+    );
     normalizedProduct.discount_list = (0, import_utils.normalizeOrderProductDiscountList)(
       normalizedProduct.discount_list
     );
+    const settlementSnapshot = (0, import_virtualSettlement.getSelectedSettlementSnapshot)(normalizedProduct);
+    if (this.isMultiCurrencySettlementEnabled() && (settlementSnapshot == null ? void 0 : settlementSnapshot.settlement_type) === "virtual_currency" && tempOrder.customer_id && Number(tempOrder.customer_id) !== 1) {
+      const currencyProductId = Number(settlementSnapshot.currency_product_id);
+      const asset = (this.store.virtualCurrencyList || []).find(
+        (item) => Number(item == null ? void 0 : item.product_id) === currencyProductId
+      );
+      if (!asset) {
+        throw new import_virtualSettlement.VirtualCurrencyAssetNotFoundError(currencyProductId);
+      }
+      const requiredAmount = tempOrder.products.reduce((sum, item, index) => {
+        const current = index === productIndex ? normalizedProduct : item;
+        const currentSnapshot = (0, import_virtualSettlement.getSelectedSettlementSnapshot)(current);
+        return sum.plus(
+          new import_decimal.default((currentSnapshot == null ? void 0 : currentSnapshot.price) || current.selling_price || 0).times(current.num || 1)
+        );
+      }, new import_decimal.default(0));
+      const balance = new import_decimal.default(asset.balance || 0);
+      if (balance.lt(requiredAmount)) {
+        throw new import_virtualSettlement.VirtualCurrencyBalanceError(
+          balance.toFixed(2),
+          requiredAmount.toFixed(2)
+        );
+      }
+    }
     tempOrder.products[productIndex] = normalizedProduct;
-    await this.applyPromotion();
-    this.applyDiscount();
+    this.prepareVirtualSettlementTempOrder(tempOrder);
+    if (!this.isActiveVirtualSettlementOrder(tempOrder)) {
+      await this.applyPromotion();
+      this.applyDiscount();
+    }
     this.sanitizeTempOrderProducts(tempOrder);
     await this.recalculateSummary({ createIfMissing: true });
     this.persistTempOrder();
@@ -3610,7 +3914,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * @example
    * await order.removeProductsFromOrder([identityA, identityB]);
    */
-  async removeProductsFromOrder(identities) {
+  async removeProductsFromOrder(identities, options) {
     var _a, _b, _c, _d;
     const tempOrder = this.ensureTempOrder();
     this.repairDuplicateProductLineIdentities(tempOrder);
@@ -3619,6 +3923,13 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     }
     const productsBeforeRemove = tempOrder.products || [];
     const bookingsBeforeRemove = tempOrder.bookings || [];
+    const preserveDisplayPosition = options == null ? void 0 : options.preserveDisplayPosition;
+    const anchorIndex = preserveDisplayPosition ? productsBeforeRemove.findIndex((item) => {
+      var _a2;
+      const uid = ((_a2 = item.metadata) == null ? void 0 : _a2.unique_identification_number) || item.unique_identification_number;
+      return uid !== void 0 && uid !== null && String(uid) === String(preserveDisplayPosition.anchorProductUid);
+    }) : -1;
+    const productsAfterAnchor = anchorIndex >= 0 ? productsBeforeRemove.slice(anchorIndex + 1) : [];
     const matchedProducts = productsBeforeRemove.filter((item) => {
       return identities.some((identity) => (0, import_utils3.isIdentityMatch)(item, identity));
     });
@@ -3659,14 +3970,37 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         return !(isAddTimeProduct && lineBookingUid !== void 0 && lineBookingUid !== null && linkedBookingUidsToRemove.has(String(lineBookingUid)));
       });
     }
+    if (preserveDisplayPosition && anchorIndex >= 0) {
+      const remainingProductIndex = tempOrder.products.findIndex((item) => {
+        var _a2;
+        const uid = ((_a2 = item.metadata) == null ? void 0 : _a2.unique_identification_number) || item.unique_identification_number;
+        return uid !== void 0 && uid !== null && String(uid) === String(preserveDisplayPosition.remainingProductUid);
+      });
+      if (remainingProductIndex >= 0) {
+        const remainingProduct = tempOrder.products[remainingProductIndex];
+        const nextProduct = productsAfterAnchor.find(
+          (item) => tempOrder.products.includes(item)
+        );
+        const productsWithoutRemaining = [
+          ...tempOrder.products.slice(0, remainingProductIndex),
+          ...tempOrder.products.slice(remainingProductIndex + 1)
+        ];
+        const nextProductIndex = nextProduct ? productsWithoutRemaining.indexOf(nextProduct) : -1;
+        tempOrder.products = nextProductIndex >= 0 ? [
+          ...productsWithoutRemaining.slice(0, nextProductIndex),
+          remainingProduct,
+          ...productsWithoutRemaining.slice(nextProductIndex)
+        ] : [...productsWithoutRemaining, remainingProduct];
+      }
+    }
     await this.finalizeAfterProductsMutation(tempOrder);
     this.logInfo("removeProductsFromOrder success", {
       identities
     });
     return tempOrder.products;
   }
-  async removeProductFromOrder(identity) {
-    return this.removeProductsFromOrder([identity]);
+  async removeProductFromOrder(identity, options) {
+    return this.removeProductsFromOrder([identity], options);
   }
   /**
    * 仅清空购物车行（products / bookings），不重置整单。
@@ -3676,6 +4010,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const tempOrder = this.ensureTempOrder();
     tempOrder.products = [];
     tempOrder.bookings = [];
+    (0, import_virtualSettlement.releaseTempOrderSettlementState)(tempOrder);
     this.syncTempOrderHolderFromBookings(tempOrder);
     if (tempOrder._extend && typeof tempOrder._extend === "object") {
       tempOrder._extend = {
@@ -3691,6 +4026,37 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     this.logInfo("clearOrderCartLines success", {});
     return tempOrder;
   }
+  /**
+   * 切换购物车结算单位时清理所有会影响新币种的订单状态，但保留当前客户。
+   */
+  async clearOrderForSettlementSwitch() {
+    var _a, _b;
+    const tempOrder = this.ensureTempOrder();
+    tempOrder.products = [];
+    tempOrder.bookings = [];
+    tempOrder.discount_list = [];
+    tempOrder.payments = [];
+    tempOrder.refunds = [];
+    tempOrder.shop_discount = "0.00";
+    tempOrder.surcharges = [];
+    (0, import_virtualSettlement.releaseTempOrderSettlementState)(tempOrder);
+    this.syncTempOrderHolderFromBookings(tempOrder);
+    if (tempOrder._extend && typeof tempOrder._extend === "object") {
+      tempOrder._extend = {
+        ...tempOrder._extend,
+        productsByUid: {}
+      };
+    }
+    await ((_a = this.store.discount) == null ? void 0 : _a.setDiscountList([]));
+    await ((_b = this.store.discount) == null ? void 0 : _b.setOriginalDiscountList([]));
+    this.hasActiveCustomerBoundDiscount = false;
+    this.lastUnfulfilledPromotions = [];
+    this.lastGiftActions = null;
+    await this.recalculateSummary({ createIfMissing: true });
+    this.persistTempOrder();
+    this.logInfo("clearOrderForSettlementSwitch success", {});
+    return tempOrder;
+  }
   // ─── TempOrder: 提交 ───
   buildCurrentSubmitPayloadForLocalPrint(params) {
     var _a, _b, _c;
@@ -3781,6 +4147,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   async runSubmitTempOrder(params) {
     var _a, _b, _c, _d, _e;
     const tempOrder = this.ensureTempOrder();
+    this.prepareVirtualSettlementTempOrder(tempOrder);
     const shouldConfirmPendingVoucherPayments = (params == null ? void 0 : params.confirmPendingVoucherPayments) !== false;
     const hasPaymentOverride = (params == null ? void 0 : params.payments) !== void 0;
     const preparedPaymentOverride = hasPaymentOverride ? this.prepareVoucherPaymentsForSubmit(
@@ -4741,8 +5108,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     delete row[`product_${"option"}_item`];
     if (!Array.isArray(row.product_bundle))
       row.product_bundle = [];
-    if (!row.metadata || typeof row.metadata !== "object")
-      row.metadata = {};
+    row.metadata = row.metadata && typeof row.metadata === "object" ? { ...row.metadata } : {};
+    delete row.bundle_edit;
+    delete row.metadata.bundle_edit;
     if (row.booking_uid && !row.metadata.booking_uid) {
       row.metadata.booking_uid = row.booking_uid;
     }
@@ -4770,7 +5138,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     if (result.metadata)
       delete result.metadata.price_schema_version;
     const restored = (0, import_bundleDiscountHydration.restoreHydratedBundleDiscounts)(result, import_utils.normalizeOrderProductDiscountList);
-    return this.sanitizeOrderProductForTempOrder(restored);
+    return this.sanitizeOrderProductForTempOrder(
+      this.normalizeVirtualSettlementProductIfEnabled(restored)
+    );
   }
   getLastOrderInfo() {
     var _a;