@pisell/pisellos 2.1.78 → 2.1.80

package/dist/modules/Cart/types.d.ts

@@ -146,6 +146,8 @@ export interface CartItem {
     _optionsOrigin?: any[];
     /** 操作系统提示 */
     osWarnTips?: string[];
+    /** 金额差值 */
+    totalDifference?: number;
 }
 /**
  * 购物车状态接口

package/dist/modules/Cart/utils/cartProduct.js

@@ -13,6 +13,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 import Decimal from 'decimal.js';
 import { isNormalProduct } from "../../Product/utils";
 import { getDiscountAmount } from "../../../solution/ShopDiscount/utils";
+import { calcDiscountListDifference } from "../../Summary/utils";
 
 /**
  * @title 处理组合商品
@@ -69,6 +70,11 @@ export var formatProductToCartItem = function formatProductToCartItem(params) {
       num: num,
       discounts: discounts
     });
+    cartItem.totalDifference = getTotalDifference({
+      product: product,
+      bundle: bundle,
+      discounts: discounts
+    });
     cartItem.summaryTotal = cartItem.total * (num || 1);
     cartItem.origin_total = getProductOriginTotalPrice({
       product: product,
@@ -218,6 +224,19 @@ export var getProductTotalPrice = function getProductTotalPrice(params) {
   }
   return Math.max(0, price);
 };
+var getTotalDifference = function getTotalDifference(params) {
+  var bundle = params.bundle,
+    discounts = params.discounts;
+  var bundleDiscountList = [];
+  if (bundle !== null && bundle !== void 0 && bundle.length) {
+    bundle.forEach(function (currentValue) {
+      bundleDiscountList.push.apply(bundleDiscountList, _toConsumableArray((currentValue === null || currentValue === void 0 ? void 0 : currentValue.discount_list) || []));
+    });
+  }
+  var allDiscounts = [].concat(_toConsumableArray(discounts || []), bundleDiscountList);
+  var productDiscountProductDiscountDifference = calcDiscountListDifference(allDiscounts);
+  return productDiscountProductDiscountDifference || 0;
+};
 
 /**
  * 获取商品原始总价
@@ -304,7 +323,8 @@ export var formatBundle = function formatBundle(bundle) {
       options: formatOptions(item === null || item === void 0 ? void 0 : item.option),
       _bundle_product_id: item._bundle_product_id,
       discount_list: item.discount_list,
-      originBundleItem: item.originBundleItem || item
+      originBundleItem: item.originBundleItem || item,
+      is_charge_tax: item === null || item === void 0 ? void 0 : item.is_charge_tax
     };
   });
 };

package/dist/modules/Rules/index.js

@@ -694,7 +694,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
         // 收集该折扣卡适用的商品（排除被其他专属折扣卡占用的商品）
         var applicableProducts = [];
         sortedFlattenedList.forEach(function (flatItem) {
-          var _flatItem$parentProdu2, _product$price, _ref5, _flatItem$original_pr;
+          var _flatItem$parentProdu2, _flatItem$parentProdu3, _product$price, _ref5, _flatItem$original_pr;
           // 🔥 检查该商品是否被其他专属折扣卡占用
           var occupyingDiscountId = occupiedItems.get(flatItem._id);
           if (occupyingDiscountId !== undefined && occupyingDiscountId !== discount.id) {
@@ -718,7 +718,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           }
 
           // 对于 bundle 子商品，quantity 需要乘以主商品的购买数量
-          var quantity = flatItem.type === 'main' ? product.quantity || 1 : (product.num || 1) * (((_flatItem$parentProdu2 = flatItem.parentProduct) === null || _flatItem$parentProdu2 === void 0 ? void 0 : _flatItem$parentProdu2.quantity) || 1);
+          var quantity = flatItem.type === 'main' ? product.num || product.quantity || 1 : (product.num || product.quantity || 1) * (((_flatItem$parentProdu2 = flatItem.parentProduct) === null || _flatItem$parentProdu2 === void 0 ? void 0 : _flatItem$parentProdu2.num) || ((_flatItem$parentProdu3 = flatItem.parentProduct) === null || _flatItem$parentProdu3 === void 0 ? void 0 : _flatItem$parentProdu3.quantity) || 1);
 
           // 对于主商品：使用 price
           // 对于子商品：优先使用 flatItem.original_price，否则使用 flatItem.price
@@ -733,8 +733,8 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
 
           // 子商品需要传递主商品数量
           if (flatItem.type === 'bundle') {
-            var _flatItem$parentProdu3;
-            productData.parentQuantity = ((_flatItem$parentProdu3 = flatItem.parentProduct) === null || _flatItem$parentProdu3 === void 0 ? void 0 : _flatItem$parentProdu3.quantity) || 1;
+            var _flatItem$parentProdu4;
+            productData.parentQuantity = ((_flatItem$parentProdu4 = flatItem.parentProduct) === null || _flatItem$parentProdu4 === void 0 ? void 0 : _flatItem$parentProdu4.quantity) || 1;
           }
           applicableProducts.push(productData);
         });
@@ -761,7 +761,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           product = flatItem.product;
           originProduct = flatItem.originProduct;
         } else {
-          var _flatItem$parentProdu4;
+          var _flatItem$parentProdu5;
           // bundle子商品：构造虚拟商品对象
           product = {
             _id: flatItem._id,
@@ -773,7 +773,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             origin_total: flatItem.origin_total,
             booking_id: flatItem.booking_id,
             discount_list: flatItem.discount_list || [],
-            startDate: (_flatItem$parentProdu4 = flatItem.parentProduct) === null || _flatItem$parentProdu4 === void 0 ? void 0 : _flatItem$parentProdu4.startDate
+            startDate: (_flatItem$parentProdu5 = flatItem.parentProduct) === null || _flatItem$parentProdu5 === void 0 ? void 0 : _flatItem$parentProdu5.startDate
           };
           originProduct = flatItem.originProduct;
         }
@@ -851,7 +851,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           product = flatItem.product;
           originProduct = flatItem.originProduct;
         } else {
-          var _flatItem$bundleItem5, _flatItem$bundleItem6, _flatItem$bundleItem7, _flatItem$parentProdu5;
+          var _flatItem$bundleItem5, _flatItem$bundleItem6, _flatItem$bundleItem7, _flatItem$parentProdu6;
           // bundle子商品
           product = {
             _id: flatItem._id,
@@ -864,7 +864,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             origin_total: flatItem === null || flatItem === void 0 || (_flatItem$bundleItem6 = flatItem.bundleItem) === null || _flatItem$bundleItem6 === void 0 ? void 0 : _flatItem$bundleItem6.original_price,
             booking_id: flatItem.booking_id,
             discount_list: (flatItem === null || flatItem === void 0 || (_flatItem$bundleItem7 = flatItem.bundleItem) === null || _flatItem$bundleItem7 === void 0 ? void 0 : _flatItem$bundleItem7.discount_list) || [],
-            startDate: (_flatItem$parentProdu5 = flatItem.parentProduct) === null || _flatItem$parentProdu5 === void 0 ? void 0 : _flatItem$parentProdu5.startDate
+            startDate: (_flatItem$parentProdu6 = flatItem.parentProduct) === null || _flatItem$parentProdu6 === void 0 ? void 0 : _flatItem$parentProdu6.startDate
           };
           originProduct = flatItem.originProduct;
         }
@@ -976,11 +976,11 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           }
           // bundle子商品：检查自己的 discount_list 或父主商品的 discount_list
           if (flatItem.type === 'bundle') {
-            var _product$discount_lis7, _flatItem$parentProdu6;
+            var _product$discount_lis7, _flatItem$parentProdu7;
             if ((_product$discount_lis7 = product.discount_list) !== null && _product$discount_lis7 !== void 0 && _product$discount_lis7.some(function (item) {
               var _item$discount2;
               return ((_item$discount2 = item.discount) === null || _item$discount2 === void 0 ? void 0 : _item$discount2.resource_id) === options.discountId;
-            }) || (_flatItem$parentProdu6 = flatItem.parentProduct) !== null && _flatItem$parentProdu6 !== void 0 && (_flatItem$parentProdu6 = _flatItem$parentProdu6.discount_list) !== null && _flatItem$parentProdu6 !== void 0 && _flatItem$parentProdu6.some(function (item) {
+            }) || (_flatItem$parentProdu7 = flatItem.parentProduct) !== null && _flatItem$parentProdu7 !== void 0 && (_flatItem$parentProdu7 = _flatItem$parentProdu7.discount_list) !== null && _flatItem$parentProdu7 !== void 0 && _flatItem$parentProdu7.some(function (item) {
               var _item$discount3;
               return ((_item$discount3 = item.discount) === null || _item$discount3 === void 0 ? void 0 : _item$discount3.resource_id) === options.discountId;
             })) {
@@ -1002,14 +1002,14 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           }
           // bundle子商品：检查自己的 discount_list 或父主商品的 discount_list
           if (flatItem.type === 'bundle') {
-            var _product$discount_lis9, _flatItem$parentProdu7;
+            var _product$discount_lis9, _flatItem$parentProdu8;
             if ((_product$discount_lis9 = product.discount_list) !== null && _product$discount_lis9 !== void 0 && _product$discount_lis9.some(function (item) {
               var _options$selectedList2;
               return options === null || options === void 0 || (_options$selectedList2 = options.selectedList) === null || _options$selectedList2 === void 0 ? void 0 : _options$selectedList2.some(function (n) {
                 var _item$discount5;
                 return n.discountId === ((_item$discount5 = item.discount) === null || _item$discount5 === void 0 ? void 0 : _item$discount5.resource_id);
               });
-            }) || (_flatItem$parentProdu7 = flatItem.parentProduct) !== null && _flatItem$parentProdu7 !== void 0 && (_flatItem$parentProdu7 = _flatItem$parentProdu7.discount_list) !== null && _flatItem$parentProdu7 !== void 0 && _flatItem$parentProdu7.some(function (item) {
+            }) || (_flatItem$parentProdu8 = flatItem.parentProduct) !== null && _flatItem$parentProdu8 !== void 0 && (_flatItem$parentProdu8 = _flatItem$parentProdu8.discount_list) !== null && _flatItem$parentProdu8 !== void 0 && _flatItem$parentProdu8.some(function (item) {
               var _options$selectedList3;
               return options === null || options === void 0 || (_options$selectedList3 = options.selectedList) === null || _options$selectedList3 === void 0 ? void 0 : _options$selectedList3.some(function (n) {
                 var _item$discount6;
@@ -1265,7 +1265,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
               }));
             }
           } else {
-            var _selectedDiscount3$me, _selectedDiscount3$me2, _flatItem$parentProdu8;
+            var _selectedDiscount3$me, _selectedDiscount3$me2, _flatItem$parentProdu9;
             // 折扣卡：不拆分数量，直接应用
             var _selectedDiscount3 = selectedDiscountCard || applicableDiscounts[0];
             usedDiscounts.set(_selectedDiscount3.id, true);
@@ -1311,7 +1311,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
               }, _productDiscountDifference !== undefined && {
                 product_discount_difference: _productDiscountDifference
               }),
-              _num: (product.num || 1) * ((flatItem === null || flatItem === void 0 || (_flatItem$parentProdu8 = flatItem.parentProduct) === null || _flatItem$parentProdu8 === void 0 ? void 0 : _flatItem$parentProdu8.num) || 1)
+              _num: (product.num || 1) * ((flatItem === null || flatItem === void 0 || (_flatItem$parentProdu9 = flatItem.parentProduct) === null || _flatItem$parentProdu9 === void 0 ? void 0 : _flatItem$parentProdu9.num) || 1)
             };
 
             // 记录实际应用的折扣

package/dist/modules/Summary/index.d.ts

@@ -13,6 +13,7 @@ export declare class SummaryModule extends BaseModule implements Module, ISummar
     private fatherModule;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
+    getSurchargeList(): Promise<void>;
     getSummary(cartItems: CartItem[]): Promise<ISummaryState['summary']>;
     /**
      * 获取协议
@@ -21,4 +22,6 @@ export declare class SummaryModule extends BaseModule implements Module, ISummar
      */
     getProtocol(protocolId: string): Promise<any>;
     storeChange(): void;
+    private getTaxforUtils;
+    private getSurchargeforUtils;
 }

package/dist/modules/Summary/index.js

@@ -15,8 +15,10 @@ function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.g
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import Decimal from 'decimal.js';
 import { BaseModule } from "../BaseModule";
-import { calculatePriceDetails } from "./utils";
+import { ScheduleModule } from "../Schedule";
+import { calculatePriceDetails, getSurcharge, getSurchargeAmount, getTax } from "./utils";
 export var SummaryModule = /*#__PURE__*/function (_BaseModule) {
   _inherits(SummaryModule, _BaseModule);
   var _super = _createSuper(SummaryModule);
@@ -62,6 +64,9 @@ export var SummaryModule = /*#__PURE__*/function (_BaseModule) {
               }
               throw new Error('SummaryModule 需要 shopStore 插件支持');
             case 9:
+              // 加载当前店铺附加费
+              this.getSurchargeList();
+            case 10:
             case "end":
               return _context.stop();
           }
@@ -72,24 +77,53 @@ export var SummaryModule = /*#__PURE__*/function (_BaseModule) {
       }
       return initialize;
     }()
+  }, {
+    key: "getSurchargeList",
+    value: function () {
+      var _getSurchargeList = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
+        var surchargeList;
+        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              _context2.next = 2;
+              return this.request.get('/order/custom-surcharge/available', {
+                channel: 'online-store',
+                is_assemble_product_data: 1,
+                is_assemble_schedule_data: 1,
+                with: ['relationSchedule']
+              });
+            case 2:
+              surchargeList = _context2.sent;
+              this.store.surchargeList = (surchargeList === null || surchargeList === void 0 ? void 0 : surchargeList.data) || [];
+            case 4:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2, this);
+      }));
+      function getSurchargeList() {
+        return _getSurchargeList.apply(this, arguments);
+      }
+      return getSurchargeList;
+    }()
   }, {
     key: "getSummary",
     value: function () {
-      var _getSummary = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(cartItems) {
+      var _getSummary = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(cartItems) {
         var _this$shopStore$get;
         var shopInfo, summary;
-        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
-          while (1) switch (_context2.prev = _context2.next) {
+        return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+          while (1) switch (_context3.prev = _context3.next) {
             case 0:
               shopInfo = ((_this$shopStore$get = this.shopStore.get('core')) === null || _this$shopStore$get === void 0 || (_this$shopStore$get = _this$shopStore$get.core) === null || _this$shopStore$get === void 0 ? void 0 : _this$shopStore$get.shop) || {};
-              summary = calculatePriceDetails(shopInfo, cartItems);
+              summary = calculatePriceDetails(shopInfo, cartItems, ScheduleModule.isInScheduleByDate, this.store.surchargeList);
               this.store.summary = summary;
-              return _context2.abrupt("return", this.store.summary);
+              return _context3.abrupt("return", this.store.summary);
             case 4:
             case "end":
-              return _context2.stop();
+              return _context3.stop();
           }
-        }, _callee2, this);
+        }, _callee3, this);
       }));
       function getSummary(_x3) {
         return _getSummary.apply(this, arguments);
@@ -104,16 +138,16 @@ export var SummaryModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "getProtocol",
     value: (function () {
-      var _getProtocol = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(protocolId) {
-        return _regeneratorRuntime().wrap(function _callee3$(_context3) {
-          while (1) switch (_context3.prev = _context3.next) {
+      var _getProtocol = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4(protocolId) {
+        return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+          while (1) switch (_context4.prev = _context4.next) {
             case 0:
-              return _context3.abrupt("return", this.request.get("/shop-policy/".concat(protocolId)));
+              return _context4.abrupt("return", this.request.get("/shop-policy/".concat(protocolId)));
             case 1:
             case "end":
-              return _context3.stop();
+              return _context4.stop();
           }
-        }, _callee3, this);
+        }, _callee4, this);
       }));
       function getProtocol(_x4) {
         return _getProtocol.apply(this, arguments);
@@ -132,6 +166,49 @@ export var SummaryModule = /*#__PURE__*/function (_BaseModule) {
         });
       }
     }
+  }, {
+    key: "getTaxforUtils",
+    value: function getTaxforUtils(items, shopInfo, subtotal) {
+      return getTax({
+        service: items,
+        bookingDetail: null,
+        bookingId: undefined
+      }, {
+        computed: {
+          productExpectAmount: subtotal,
+          shopDiscount: 0
+        },
+        isEdit: false,
+        tax_rate: shopInfo === null || shopInfo === void 0 ? void 0 : shopInfo.tax_rate,
+        is_price_include_tax: shopInfo === null || shopInfo === void 0 ? void 0 : shopInfo.is_price_include_tax
+      });
+    }
+  }, {
+    key: "getSurchargeforUtils",
+    value: function getSurchargeforUtils(items) {
+      // const surchargeList = this.store.surchargeList;
+      var surchargeList = getSurcharge({
+        service: items,
+        addons: [],
+        bookingDetail: null,
+        bookingId: undefined
+      }, {
+        isEdit: false,
+        isInScheduleByDate: ScheduleModule.isInScheduleByDate,
+        surcharge_list: this.store.surchargeList,
+        scheduleById: {}
+      });
+      var surchargeAmount = new Decimal(getSurchargeAmount({
+        bookingDetail: null,
+        bookingId: undefined
+      }, surchargeList, {
+        isEdit: false
+      }));
+      return {
+        surchargeList: surchargeList,
+        surchargeAmount: surchargeAmount.toFixed(2)
+      };
+    }
   }]);
   return SummaryModule;
 }(BaseModule);

package/dist/modules/Summary/types.d.ts

@@ -1,5 +1,6 @@
 import { CartItem } from '../Cart/types';
 export interface ISummaryState {
+    surchargeList: any[];
     summary: {
         /** 商品总价 */
         subtotal: string | number;
@@ -11,6 +12,12 @@ export interface ISummaryState {
         totalTaxFee?: string | number;
         /** 商品价格是否包含费率 */
         isPriceIncludeTax?: 0 | 1;
+        /** 附加费金额 */
+        surchargeAmount?: string | number;
+        /** 附加费列表 */
+        surcharge?: any[];
+        /** 税率 */
+        taxRate?: string | number;
         /** 定金 */
         deposit?: {
             /** 定金总价 */

package/dist/modules/Summary/utils.d.ts

@@ -1,12 +1,57 @@
 import Decimal from 'decimal.js';
 import { CartItem } from '../Cart/types';
 import { ISummaryState } from './types';
-export declare const calculatePriceDetails: (shopInfo: any, items: CartItem[]) => ISummaryState['summary'];
+export declare const calculatePriceDetails: (shopInfo: any, items: CartItem[], isInScheduleByDate: any, surchargeList: any[]) => ISummaryState['summary'];
 /**
  * 获取子商品折扣信息
  * @param item
  */
 export declare const getBundleDiscountList: (bundle: any[]) => any[];
+export declare const calcDiscountListDifference: (discountList: any[]) => any;
+export declare const getProductDiscountProductDiscountDifference: (item: CartItem) => any;
+/**
+ * 计算订单税费（折扣前/折扣后），并把单品税费信息回写到商品数据上（用于明细展示/后续计算）。
+ *
+ * - **折扣前税费**：`originTax`
+ * - **折扣后税费**：`tax`（会考虑 `computed.shopDiscount` 对每个商品的分摊影响）
+ * - **税率/是否含税**：优先取 `bookingDetail.tax_rate` / `bookingDetail.is_price_include_tax`，取不到再回退到 `options.tax_rate` / `options.is_price_include_tax`
+ *
+ * **副作用（会修改入参商品对象）**：
+ * - 主商品：写入 `item.original_tax_fee` / `item.tax_fee`（四舍五入保留两位）
+ * - bundle 原价子商品：写入 `bundleItem.original_tax_fee` / `bundleItem.tax_fee`
+ * - 加时商品（`relation_details`）：写入 `atItem.tax_fee`
+ * - 税费舍入差值：追加到最后一个“含税商品”的 `tax_fee_rounding_remainder` / `original_tax_fee_rounding_remainder`
+ *
+ * @param params 入参集合（RORO）
+ * @param params.service 服务商品数组（主商品）。通常是购物车商品结构（可能包含 `bundle` / `relation_details`）
+ * @param params.addons 附加商品数组（可选）。结构同商品数组
+ * @param params.bookingDetail 订单详情（编辑/详情场景用于读取后端税率配置），可选
+ * @param params.bookingId 订单/预约 ID（编辑/详情场景识别用），可选
+ * @param options 计算选项
+ * @param options.isEdit 是否处于“编辑中”。当前实现不强依赖该值（历史逻辑保留），但建议按真实状态传入
+ * @param options.computed 预计算结果（用于折扣分摊）
+ * @param options.computed.productExpectAmount 商品期望总金额（用于按比例分摊折扣）
+ * @param options.computed.shopDiscount 店铺折扣总额（用于按比例分摊到商品）
+ * @param options.tax_rate 管理端税率（百分比，如 5 表示 5%）。仅当 `bookingDetail.tax_rate` 不存在时生效
+ * @param options.is_price_include_tax 是否含税：`0` 不含税、`1` 含税。仅当 `bookingDetail.is_price_include_tax` 不存在时生效
+ * @returns 税费汇总（number，金额单位与商品价格一致，四舍五入保留两位）
+ * @returns.originTax 折扣前税费合计
+ * @returns.tax 折扣后税费合计
+ */
+export declare const getTax: ({ service, addons, bookingDetail, bookingId }: {
+    service?: any;
+    addons?: any;
+    bookingDetail?: any;
+    bookingId?: number | undefined;
+}, options: {
+    isEdit: boolean;
+    computed: Record<string, number | string>;
+    tax_rate?: number;
+    is_price_include_tax?: number;
+} & Record<string, any>) => {
+    originTax: number;
+    tax: number;
+};
 /**
  * 计算商品小计（不含其他费用）
  * @param items - 购物车商品数组
@@ -32,3 +77,61 @@ export declare const calculateDeposit: (items: CartItem[]) => {
     protocols: any[];
     hasDeposit: never;
 } | undefined;
+/**
+ * 计算订单附加费金额（订单级别合计）。
+ *
+ * - **详情未编辑**（`!options.isEdit && bookingId`）且存在后端详情时：直接返回 `bookingDetail.surcharge_fee`
+ * - **新增/编辑**时：对 `surcharge`（通常为 `getSurcharge` 的返回值）按 `item.value` 求和
+ *
+ * @param params 入参集合（RORO）
+ * @param params.bookingDetail 订单详情（详情未编辑时用于读取后端的 `surcharge_fee`），可选
+ * @param params.bookingId 订单/预约 ID（详情未编辑时生效），可选
+ * @param surcharge 附加费列表（通常来自 `getSurcharge`），元素结构至少包含 `value: number`
+ * @param options 计算选项
+ * @param options.isEdit 是否处于“编辑中”。`false` 时会优先走后端金额直取逻辑（若存在）
+ * @returns 订单附加费金额（number，金额单位与商品价格一致）
+ */
+export declare const getSurchargeAmount: ({ bookingDetail, bookingId }: {
+    bookingDetail?: any;
+    bookingId?: number | undefined;
+}, surcharge: any[], options: any) => any;
+/**
+ * 订单附加费各项信息
+ *
+ * - **详情未编辑**（`!options.isEdit && bookingId`）时：直接返回 `bookingDetail.surcharge`（后端计算结果）
+ * - **新增/编辑**时：按 `options.surcharge_list` 逐条配置计算本次订单的附加费
+ *
+ * 规则要点：
+ * - 匹配范围包含：主商品（`service`）、原价 bundle 子商品（`item.bundle`）、加时商品（`item.relation_details`）、以及 addons（`addons.value`）
+ * - 固定附加费 `fixed`：只加一次，再按商品数量分摊（向下取整保留两位），剩余小数会以 `surcharge_rounding_remainder` 形式抹平到最后一个商品
+ * - 百分比附加费 `percentage`：按每个商品（价格 * 数量）分别计算再累加
+ * - 当 `open_product === 0`：不回写到商品，只在订单级别累加；否则会把单品附加费回写到商品
+ *
+ * **副作用（可能修改入参商品对象）**：
+ * - 当 `open_product !== 0` 时：写入 `item.surcharge_fee`（单品单数量附加费，保留两位、向下取整）
+ * - 写入 `item.relation_surcharge_ids`（关联到的 surcharge 配置 id 列表）
+ * - 写入 `item.surcharge_rounding_remainder`（用于抹平固定附加费/总额舍入差）
+ *
+ * @param params 入参集合（RORO）
+ * @param params.service 服务商品数组（主商品）。元素可能包含 `bundle` / `relation_details`
+ * @param params.addons 附加商品容器。当前实现读取 `addons.value` 作为商品数组（所以通常传 `{ value: CartItem[] }`）
+ * @param params.bookingDetail 订单详情（详情未编辑时用于直接取后端的 surcharge 列表），可选
+ * @param params.bookingId 订单/预约 ID（详情未编辑时生效），可选
+ * @param options 计算选项
+ * @param options.isEdit 是否处于“编辑中”。`false` 且存在 `bookingId` 时会走详情直取逻辑
+ * @param options.surcharge_list 附加费配置列表（后端下发）。缺失/为空则返回空数组
+ * @param options.isInScheduleByDate 判断日期是否落在某个 schedule 内的方法（通常来自 ScheduleModule）
+ * @param options.scheduleById schedule 映射表：`{ [scheduleId]: schedule }`（用于根据配置的 `available_schedule_ids` 做日程匹配）
+ * @returns 附加费列表（仅返回金额 > 0 的项）
+ */
+export declare const getSurcharge: ({ service, addons, bookingDetail, bookingId }: {
+    service: any;
+    addons: any;
+    bookingDetail?: any;
+    bookingId?: number | undefined;
+}, options: {
+    isEdit: boolean;
+    isInScheduleByDate: any;
+    surcharge_list?: any[];
+    scheduleById?: Record<string, any>;
+} & Record<string, any>) => any;