@pisell/pisellos 2.2.267 → 2.2.268

package/dist/solution/BaseSales/index.js

@@ -3587,7 +3587,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "addProductToOrder",
     value: function () {
-      var _addProductToOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee39(product, booking) {
+      var _addProductToOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee39(product, booking, options) {
         var products;
         return _regeneratorRuntime().wrap(function _callee39$(_context39) {
           while (1) switch (_context39.prev = _context39.next) {
@@ -3600,7 +3600,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
               throw new Error('order 模块未初始化');
             case 3:
               _context39.next = 5;
-              return this.store.order.addProductToOrder(product, booking);
+              return this.store.order.addProductToOrder(product, booking, options);
             case 5:
               products = _context39.sent;
               return _context39.abrupt("return", products);
@@ -3614,7 +3614,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
           }
         }, _callee39, this, [[0, 9]]);
       }));
-      function addProductToOrder(_x31, _x32) {
+      function addProductToOrder(_x31, _x32, _x33) {
         return _addProductToOrder.apply(this, arguments);
       }
       return addProductToOrder;
@@ -3649,7 +3649,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
           }
         }, _callee40, this, [[0, 9]]);
       }));
-      function updateOrderProduct(_x33) {
+      function updateOrderProduct(_x34) {
         return _updateOrderProduct.apply(this, arguments);
       }
       return updateOrderProduct;
@@ -3684,7 +3684,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
           }
         }, _callee41, this, [[0, 9]]);
       }));
-      function updateOrderProducts(_x34) {
+      function updateOrderProducts(_x35) {
         return _updateOrderProducts.apply(this, arguments);
       }
       return updateOrderProducts;
@@ -3719,7 +3719,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
           }
         }, _callee42, this, [[0, 9]]);
       }));
-      function updateOrderProductQuantity(_x35) {
+      function updateOrderProductQuantity(_x36) {
         return _updateOrderProductQuantity.apply(this, arguments);
       }
       return updateOrderProductQuantity;
@@ -3777,7 +3777,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
           }
         }, _callee43, this, [[0, 11]]);
       }));
-      function setOrderProductLineNote(_x36, _x37) {
+      function setOrderProductLineNote(_x37, _x38) {
         return _setOrderProductLineNote.apply(this, arguments);
       }
       return setOrderProductLineNote;
@@ -3792,7 +3792,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "removeProductsFromOrder",
     value: (function () {
-      var _removeProductsFromOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee44(identities) {
+      var _removeProductsFromOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee44(identities, options) {
         return _regeneratorRuntime().wrap(function _callee44$(_context44) {
           while (1) switch (_context44.prev = _context44.next) {
             case 0:
@@ -3804,7 +3804,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
               throw new Error('order 模块未初始化');
             case 3:
               _context44.next = 5;
-              return this.store.order.removeProductsFromOrder(identities);
+              return this.store.order.removeProductsFromOrder(identities, options);
             case 5:
               return _context44.abrupt("return", _context44.sent);
             case 8:
@@ -3817,7 +3817,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
           }
         }, _callee44, this, [[0, 8]]);
       }));
-      function removeProductsFromOrder(_x38) {
+      function removeProductsFromOrder(_x39, _x40) {
         return _removeProductsFromOrder.apply(this, arguments);
       }
       return removeProductsFromOrder;
@@ -3825,18 +3825,18 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "removeProductFromOrder",
     value: function () {
-      var _removeProductFromOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee45(identity) {
+      var _removeProductFromOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee45(identity, options) {
         return _regeneratorRuntime().wrap(function _callee45$(_context45) {
           while (1) switch (_context45.prev = _context45.next) {
             case 0:
-              return _context45.abrupt("return", this.removeProductsFromOrder([identity]));
+              return _context45.abrupt("return", this.removeProductsFromOrder([identity], options));
             case 1:
             case "end":
               return _context45.stop();
           }
         }, _callee45, this);
       }));
-      function removeProductFromOrder(_x39) {
+      function removeProductFromOrder(_x41, _x42) {
         return _removeProductFromOrder.apply(this, arguments);
       }
       return removeProductFromOrder;
@@ -3999,7 +3999,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
           }
         }, _callee48, this);
       }));
-      function setOtherParams(_x40) {
+      function setOtherParams(_x43) {
         return _setOtherParams.apply(this, arguments);
       }
       return setOtherParams;

package/dist/solution/BookingByStep/index.d.ts

@@ -311,7 +311,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
         date: string;
         status: string;
         week: string;
-        weekNum: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+        weekNum: 0 | 2 | 1 | 3 | 4 | 5 | 6;
     }[]>;
     submitTimeSlot(timeSlots: TimeSliceItem): void;
     private getScheduleDataByIds;

package/dist/solution/BookingTicket/index.d.ts

@@ -322,7 +322,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 获取当前的客户搜索条件
      * @returns 当前搜索条件
      */
-    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "skip" | "num">;
+    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "num" | "skip">;
     /**
      * 获取客户列表状态（包含滚动加载相关状态）
      * @returns 客户状态

package/dist/solution/BookingTicket/types.d.ts

@@ -118,12 +118,15 @@ export interface BookingTicketCartBookingView extends ISalesBooking {
         canAddTime: boolean;
     };
 }
+export type BookingTicketCartLineView = BookingTicketCartBookingView | BookingTicketCartItemView;
 /**
  * BookingTicket 面向 UI 的购物车视图。
  */
 export interface BookingTicketCartView {
     bookings: BookingTicketCartBookingView[];
     items: BookingTicketCartItemView[];
+    /** 以 tempOrder.products 为唯一顺序真源的统一购物车行（旧到新）。 */
+    lines: BookingTicketCartLineView[];
 }
 /**
  * BookingTicket 面向 UI 的客户展示视图。

package/dist/solution/BookingTicket/utils/cartView.js

@@ -108,33 +108,28 @@ export function buildCartView(lines, bookings) {
   var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
   var productLines = Array.isArray(lines) ? lines : [];
   var bookingList = Array.isArray(bookings) ? bookings : [];
+  var childBookings = bookingList.filter(function (booking) {
+    return booking.parent_id !== 0;
+  });
+  var bookingsByProductUid = indexBookingsByProductUid(childBookings);
   var linesByUid = indexProductsByUid(productLines);
   var addTimeLinesByBookingUid = indexAddTimeProductsByBookingUid(productLines);
-  var claimedUids = new Set();
   var claimedAddTimeLines = new Set();
-  var cartBookings = bookingList.filter(function (booking) {
-    return booking.parent_id !== 0;
-  }).reduce(function (acc, booking) {
-    var uid = booking === null || booking === void 0 ? void 0 : booking.product_uid;
+  childBookings.forEach(function (booking) {
     var bookingUid = getBookingUid(booking);
-    var product = null;
-    if (uid !== undefined && uid !== null && uid !== '') {
-      var key = String(uid);
-      if (!claimedUids.has(key)) {
-        var line = linesByUid[key];
-        // 赠品预约只作为提交数据保留，不在购物车顶部预约卡片区展示。
-        if (isGiftProductLine(line)) return acc;
-        if (line) {
-          claimedUids.add(key);
-          product = line;
-        }
-      }
-    }
-    var addTimeProduct = bookingUid ? addTimeLinesByBookingUid[bookingUid] || [] : [];
-    addTimeProduct.forEach(function (line) {
-      return claimedAddTimeLines.add(line);
+    if (!bookingUid) return;
+    (addTimeLinesByBookingUid[bookingUid] || []).forEach(function (line) {
+      claimedAddTimeLines.add(line);
     });
-    acc.push(_objectSpread(_objectSpread({}, booking), {}, {
+  });
+  var claimedBookings = new Set();
+  var cartBookings = [];
+  var items = [];
+  var orderedLines = [];
+  var buildBookingView = function buildBookingView(booking, product) {
+    var bookingUid = getBookingUid(booking);
+    var addTimeProduct = bookingUid ? addTimeLinesByBookingUid[bookingUid] || [] : [];
+    return _objectSpread(_objectSpread({}, booking), {}, {
       _extend: {
         product: product,
         addTimeProduct: addTimeProduct,
@@ -147,21 +142,38 @@ export function buildCartView(lines, bookings) {
           shopOpeningHours: options.shopOpeningHours
         })
       }
-    }));
-    return acc;
-  }, []);
-  var items = productLines.filter(function (line) {
+    });
+  };
+  productLines.forEach(function (line) {
     var _line$metadata6;
-    // 促销赠品行仅通过主商品 Gift 行展示，不在 items 单独占一行（对齐 legacy `isGift: !!_giftInfo`）
-    if (isGiftProductLine(line)) return false;
-    if (claimedAddTimeLines.has(line)) return false;
+    // 赠品由主商品 Gift 行展示；加时商品挂在 booking._extend.addTimeProduct。
+    if (isGiftProductLine(line) || claimedAddTimeLines.has(line)) return;
     var uid = (_line$metadata6 = line.metadata) === null || _line$metadata6 === void 0 ? void 0 : _line$metadata6.unique_identification_number;
-    if (uid === undefined || uid === null || uid === '') return true;
-    return !claimedUids.has(String(uid));
+    var matchedBooking = uid === undefined || uid === null || uid === '' ? undefined : (bookingsByProductUid[String(uid)] || []).find(function (booking) {
+      return !claimedBookings.has(booking);
+    });
+    if (matchedBooking) {
+      claimedBookings.add(matchedBooking);
+      var bookingView = buildBookingView(matchedBooking, line);
+      cartBookings.push(bookingView);
+      orderedLines.push(bookingView);
+      return;
+    }
+    items.push(line);
+    orderedLines.push(line);
+  });
+  childBookings.forEach(function (booking) {
+    if (claimedBookings.has(booking)) return;
+    var uid = booking === null || booking === void 0 ? void 0 : booking.product_uid;
+    var linkedProduct = uid === undefined || uid === null || uid === '' ? null : linesByUid[String(uid)] || null;
+    // 赠品预约只作为提交数据保留，不在购物车预约卡片区展示。
+    if (isGiftProductLine(linkedProduct)) return;
+    cartBookings.push(buildBookingView(booking, null));
   });
   return {
     bookings: cartBookings,
-    items: items
+    items: items,
+    lines: orderedLines
   };
 }
 export function isWalkInCustomer(customer) {

package/lib/modules/Order/index.d.ts

@@ -3,7 +3,7 @@ import { BaseModule } from '../BaseModule';
 import { OrderModuleAPI, CommitOrderParams, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, CheckoutOrderParams, CancelOrderParams, ChangeBookingStatusParams } from './types';
 import { CartItem } from '../Cart/types';
 import { type SubmitPayloadEnhancer } from './utils';
-import type { OrderAmountSnapshot, AddProductBookingInput, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions } from './types';
+import type { OrderAmountSnapshot, AddProductBookingInput, AddProductToOrderOptions, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions } from './types';
 import type { ICustomer } from '../AccountList/types';
 import type { Discount } from '../Discount/types';
 import { UnavailableReason } from '../Rules/types';
@@ -374,7 +374,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      * await order.addProductToOrder({ product_id: 1, num: 3 }, { start_time: '10:00' });
      * // → tempOrder.products 新增 3 行，每行 num=1，bookings 3 条
      */
-    addProductToOrder(product: Partial<OrderProduct> & OrderProductIdentity, booking?: AddProductBookingInput): Promise<OrderProduct[]>;
+    addProductToOrder(product: Partial<OrderProduct> & OrderProductIdentity, booking?: AddProductBookingInput, options?: AddProductToOrderOptions): Promise<OrderProduct[]>;
     /**
      * 批量添加商品行，所有行追加完成后只触发一次促销、折扣、summary 重算与持久化。
      *
@@ -412,8 +412,8 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      * @example
      * await order.removeProductsFromOrder([identityA, identityB]);
      */
-    removeProductsFromOrder(identities: OrderProductIdentity[]): Promise<OrderProduct[]>;
-    removeProductFromOrder(identity: OrderProductIdentity): Promise<OrderProduct[]>;
+    removeProductsFromOrder(identities: OrderProductIdentity[], options?: RemoveProductsFromOrderOptions): Promise<OrderProduct[]>;
+    removeProductFromOrder(identity: OrderProductIdentity, options?: RemoveProductsFromOrderOptions): Promise<OrderProduct[]>;
     /**
      * 仅清空购物车行（products / bookings），不重置整单。
      * 用于「仅清空商品」；客户、备注、支付等协议字段保持不变。
@@ -468,7 +468,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     generateIdempotencyToken(): string;
     syncPaymentsToOrder<T = any>(params: SyncPaymentsToOrderParams): Promise<SyncPaymentsToOrderResult<T>>;
     createOrder(params: CommitOrderParams['query']): {
-        type: "virtual" | "appointment_booking";
+        type: "appointment_booking" | "virtual";
         platform: string;
         sales_channel: string;
         order_sales_channel: string;
@@ -541,4 +541,4 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     getOrderInfo(order_id: number): Promise<any>;
     getVouchers(): any[];
 }
-export type { UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, } from './types';
+export type { AddProductToOrderOptions, RemoveProductsFromOrderOptions, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, } from './types';

package/lib/modules/Order/index.js

@@ -2789,7 +2789,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * @example
    * await this.appendProductLineToTempOrder(tempOrder, { product_id: 1, num: 1 }, booking);
    */
-  async appendProductLineToTempOrder(tempOrder, product, booking) {
+  async appendProductLineToTempOrder(tempOrder, product, booking, options) {
     var _a, _b, _c, _d;
     const linked = booking ? this.createLinkedProductAndBooking({ product, booking }) : null;
     const productToAdd = (linked == null ? void 0 : linked.product) || product;
@@ -2871,7 +2871,16 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           booking_uid: linked.bookingUid
         };
       }
-      tempOrder.products = [...tempOrder.products, normalizedIncoming];
+      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 = (_d = targetProduct.metadata) == null ? void 0 : _d.unique_identification_number;
@@ -2930,6 +2939,14 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         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];
@@ -2942,8 +2959,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)(
@@ -2957,14 +2981,22 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           await this.appendProductLineToTempOrder(
             tempOrder,
             singleLine,
-            (0, import_lodash_es.cloneDeep)(booking)
+            (0, import_lodash_es.cloneDeep)(booking),
+            { insertAtIndex }
           );
+          if (insertAtIndex !== void 0)
+            insertAtIndex += 1;
         }
         await this.finalizeProductOrderMutation(tempOrder);
         return tempOrder.products;
       }
     }
-    await this.appendProductLineToTempOrder(tempOrder, product, booking);
+    await this.appendProductLineToTempOrder(
+      tempOrder,
+      product,
+      booking,
+      { insertAtIndex }
+    );
     await this.finalizeProductOrderMutation(tempOrder);
     this.logInfo("addProductToOrder success", {
       product_id: product.product_id,
@@ -3445,7 +3477,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();
     if (!identities.length) {
@@ -3453,6 +3485,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));
     });
@@ -3493,14 +3532,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），不重置整单。

package/lib/modules/Order/types.d.ts

@@ -319,6 +319,24 @@ export interface ReplaceTempOrderOptions {
     saveDraft?: boolean;
 }
 export type AddProductBookingInput = Record<string, any>;
+/**
+ * 添加商品行时的顺序控制。
+ * 默认追加到 products 尾部；预约数量同步可插入到既有预约组的最新行之后，
+ * 避免步进器修改数量改变该组展示位置。
+ */
+export interface AddProductToOrderOptions {
+    insertAfterProductUid?: string;
+}
+/**
+ * 删除商品后的可选位置保持策略。
+ * 预约合并行减量时仍删除最新真实行，再把剩余代表行移动到被删除代表行原位置。
+ */
+export interface RemoveProductsFromOrderOptions {
+    preserveDisplayPosition?: {
+        remainingProductUid: string;
+        anchorProductUid: string;
+    };
+}
 /** 更新购物车行：仅传 SKU 时命中同 SKU 第一行；多行同 SKU 须传 unique_identification_number / 选项指纹等 */
 export interface UpdateOrderProductParams {
     product_id: number | null;
@@ -685,15 +703,15 @@ export interface OrderModuleAPI {
     updateTempOrderCustomer: (customer: UpdateTempOrderCustomerInput) => OrderSnapshot['customer'];
     updateTempOrderBuzzer: (buzzer: string) => string;
     updateTempOrderContactsInfo: (contactsInfo: Record<string, any> | null) => Record<string, any> | null;
-    addProductToOrder: (product: Partial<OrderProduct> & OrderProductIdentity, booking?: AddProductBookingInput) => Promise<OrderProduct[]>;
+    addProductToOrder: (product: Partial<OrderProduct> & OrderProductIdentity, booking?: AddProductBookingInput, options?: AddProductToOrderOptions) => Promise<OrderProduct[]>;
     updateOrderProduct: (params: UpdateOrderProductParams) => Promise<OrderProduct[]>;
     /** 批量更新购物车行，末尾仅触发一次促销重算与 summary 刷新 */
     updateOrderProducts: (paramsList: UpdateOrderProductParams[]) => Promise<OrderProduct[]>;
     updateOrderProductQuantity: (params: UpdateOrderProductQuantityParams) => Promise<OrderProduct[]>;
     updateOrderBooking: (params: UpdateOrderBookingParams) => any[];
-    removeProductFromOrder: (identity: OrderProductIdentity) => Promise<OrderProduct[]>;
+    removeProductFromOrder: (identity: OrderProductIdentity, options?: RemoveProductsFromOrderOptions) => Promise<OrderProduct[]>;
     /** 批量删除购物车行，末尾仅触发一次促销重算与 summary 刷新 */
-    removeProductsFromOrder: (identities: OrderProductIdentity[]) => Promise<OrderProduct[]>;
+    removeProductsFromOrder: (identities: OrderProductIdentity[], options?: RemoveProductsFromOrderOptions) => Promise<OrderProduct[]>;
     /** @deprecated no-op；OrderModule 不再负责 tempOrder localStorage 持久化。 */
     persistTempOrder: () => void;
     /**

package/lib/solution/BaseSales/index.d.ts

@@ -2,7 +2,7 @@ import { Module, ModuleOptions, PisellCore } from '../../types';
 import { BaseModule } from '../../modules/BaseModule';
 import { BaseSalesOrderProduct, BaseSalesOrderProductIdentity, BaseSalesPaymentStatus, BaseSalesUpdateOrderProductQuantityParams, BaseSalesCalculateProductBookingPriceParams, BaseSalesPriceRecalculationContextChange, BaseSalesProductBookingPriceResult, BaseSalesQuotationCustomerScopeInfo, BaseSalesScanCodeResult } from './types';
 import { OrderModule } from '../../modules/Order';
-import type { AddProductBookingInput, LoadSalesDetailParams, OrderPaymentData, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions } from '../../modules/Order/types';
+import type { AddProductBookingInput, AddProductToOrderOptions, LoadSalesDetailParams, OrderPaymentData, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions } from '../../modules/Order/types';
 import type { SubmitPayloadEnhancer } from '../../modules/Order/utils';
 import type { Discount } from '../../modules/Discount/types';
 import { RequestPlugin, WindowPlugin } from '../../plugins';
@@ -315,7 +315,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     getQuotationCustomerScopeInfo(): BaseSalesQuotationCustomerScopeInfo;
     shouldRecalculateProductBookingPricesForContextChange(params: BaseSalesPriceRecalculationContextChange): boolean;
     calculateProductBookingPrices(paramsList: BaseSalesCalculateProductBookingPriceParams[]): Promise<BaseSalesProductBookingPriceResult[]>;
-    addProductToOrder(product: Partial<BaseSalesOrderProduct> & BaseSalesOrderProductIdentity, booking?: AddProductBookingInput): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    addProductToOrder(product: Partial<BaseSalesOrderProduct> & BaseSalesOrderProductIdentity, booking?: AddProductBookingInput, options?: AddProductToOrderOptions): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateOrderProduct(params: UpdateOrderProductParams): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateOrderProducts(paramsList: UpdateOrderProductParams[]): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateOrderProductQuantity(params: BaseSalesUpdateOrderProductQuantityParams): Promise<import("../../modules/Order/types").OrderProduct[]>;
@@ -331,8 +331,8 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      * @example
      * await baseSales.removeProductsFromOrder([identityA, identityB]);
      */
-    removeProductsFromOrder(identities: BaseSalesOrderProductIdentity[]): Promise<import("../../modules/Order/types").OrderProduct[]>;
-    removeProductFromOrder(identity: BaseSalesOrderProductIdentity): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    removeProductsFromOrder(identities: BaseSalesOrderProductIdentity[], options?: RemoveProductsFromOrderOptions): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    removeProductFromOrder(identity: BaseSalesOrderProductIdentity, options?: RemoveProductsFromOrderOptions): Promise<import("../../modules/Order/types").OrderProduct[]>;
     /**
      * 注入促销评估器到底层 OrderModule。
      *

package/lib/solution/BaseSales/index.js

@@ -2340,11 +2340,11 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       });
     });
   }
-  async addProductToOrder(product, booking) {
+  async addProductToOrder(product, booking, options) {
     try {
       if (!this.store.order)
         throw new Error("order 模块未初始化");
-      const products = await this.store.order.addProductToOrder(product, booking);
+      const products = await this.store.order.addProductToOrder(product, booking, options);
       return products;
     } catch (error) {
       throw error;
@@ -2420,17 +2420,17 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
    * @example
    * await baseSales.removeProductsFromOrder([identityA, identityB]);
    */
-  async removeProductsFromOrder(identities) {
+  async removeProductsFromOrder(identities, options) {
     try {
       if (!this.store.order)
         throw new Error("order 模块未初始化");
-      return await this.store.order.removeProductsFromOrder(identities);
+      return await this.store.order.removeProductsFromOrder(identities, options);
     } catch (error) {
       throw error;
     }
   }
-  async removeProductFromOrder(identity) {
-    return this.removeProductsFromOrder([identity]);
+  async removeProductFromOrder(identity, options) {
+    return this.removeProductsFromOrder([identity], options);
   }
   // ─── 促销/赠品 透传（迁移自 booking usePromotion） ────────────────
   /**

package/lib/solution/BookingByStep/index.d.ts

@@ -311,7 +311,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
         date: string;
         status: string;
         week: string;
-        weekNum: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+        weekNum: 0 | 2 | 1 | 3 | 4 | 5 | 6;
     }[]>;
     submitTimeSlot(timeSlots: TimeSliceItem): void;
     private getScheduleDataByIds;

package/lib/solution/BookingTicket/index.d.ts

@@ -322,7 +322,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 获取当前的客户搜索条件
      * @returns 当前搜索条件
      */
-    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "skip" | "num">;
+    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "num" | "skip">;
     /**
      * 获取客户列表状态（包含滚动加载相关状态）
      * @returns 客户状态

package/lib/solution/BookingTicket/types.d.ts

@@ -118,12 +118,15 @@ export interface BookingTicketCartBookingView extends ISalesBooking {
         canAddTime: boolean;
     };
 }
+export type BookingTicketCartLineView = BookingTicketCartBookingView | BookingTicketCartItemView;
 /**
  * BookingTicket 面向 UI 的购物车视图。
  */
 export interface BookingTicketCartView {
     bookings: BookingTicketCartBookingView[];
     items: BookingTicketCartItemView[];
+    /** 以 tempOrder.products 为唯一顺序真源的统一购物车行（旧到新）。 */
+    lines: BookingTicketCartLineView[];
 }
 /**
  * BookingTicket 面向 UI 的客户展示视图。