@pisell/pisellos 2.3.48 → 2.3.49

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

@@ -397,12 +397,18 @@ export interface WalletAssetsState {
 export interface WalletAssetsSnapshot {
     state: WalletAssetsState;
     searchResults: SearchIdentificationCodeItem[];
+    /** 已搜索但尚未满足订单条件、等待首次可用后自动选中的 Wallet Asset code。 */
+    pendingAutoSelectSearchCodes?: string[];
     walletParams: WalletDeductionRecommendParams | null;
     calculationContext: {
         orderTotalAmount: number;
         products: any[];
     };
 }
+export interface WalletAssetsBehaviorOptions {
+    /** 搜索到 Wallet Asset 后，当前或后续首次可用时是否自动选中。 */
+    autoSelectAfterSearch?: boolean;
+}
 export interface RefreshWalletAssetsOptions {
     /** 商品/金额变化默认保留并重验选择；客户变化由实现层强制清空。 */
     preserveSelection?: boolean;
@@ -472,6 +478,8 @@ export interface WalletPassPayment {
     refreshWalletAssetsFromBusinessAsync: (businessData: WalletInitBusinessData, options?: RefreshWalletAssetsOptions) => Promise<WalletAssetsState>;
     /** 获取共享钱包资产状态快照。 */
     getWalletAssetsState: () => WalletAssetsState;
+    /** 配置仅影响 Wallet Assets 的交互行为。 */
+    configureWalletAssetsBehavior: (options: WalletAssetsBehaviorOptions) => void;
     /** 导出供 Shared Checkout 跨运行时传递的 Wallet Assets 快照。 */
     exportWalletAssetsSnapshot: () => WalletAssetsSnapshot;
     /** 恢复 Shared Checkout 传回的 Wallet Assets 快照。 */

package/dist/modules/Payment/walletpass.d.ts

@@ -1,4 +1,4 @@
-import { WalletPassPayment, WalletDeductionRecommendParams, WalletRecommendItem, UserIdentificationCodeParams, UserIdentificationCodeItem, SearchIdentificationCodeParams, SearchIdentificationCodeItem, SearchIdentificationCodeResult, WalletInitBusinessData, WalletAssetId, WalletAssetsSnapshot, WalletAssetsState, RefreshWalletAssetsOptions, SelectWalletAssetOptions, ScanWalletAssetResult } from './types';
+import { WalletPassPayment, WalletDeductionRecommendParams, WalletRecommendItem, UserIdentificationCodeParams, UserIdentificationCodeItem, SearchIdentificationCodeParams, SearchIdentificationCodeItem, SearchIdentificationCodeResult, WalletInitBusinessData, WalletAssetId, WalletAssetsBehaviorOptions, WalletAssetsSnapshot, WalletAssetsState, RefreshWalletAssetsOptions, SelectWalletAssetOptions, ScanWalletAssetResult } from './types';
 import type { PaymentModule } from './index';
 /**
  * 钱包支付实现
@@ -12,8 +12,11 @@ export declare class WalletPassPaymentImpl implements WalletPassPayment {
     private walletInitData;
     private walletAssetsState;
     private walletAssetsRequestSequence;
+    private walletAssetsBehavior;
+    private pendingAutoSelectSearchCodes;
     private walletAssetsCalculationContext;
     constructor(paymentModule: PaymentModule);
+    configureWalletAssetsBehavior(options: WalletAssetsBehaviorOptions): void;
     /**
      * 发送事件的辅助方法
      * 支持使用WalletPassHooks或PaymentHooks
@@ -28,6 +31,9 @@ export declare class WalletPassPaymentImpl implements WalletPassPayment {
      * 接口暂时缺失某个扫码 code 时继续保留旧值，避免列表闪空。
      */
     private syncSearchedWalletAssets;
+    private isPendingAutoSelectAsset;
+    private clearPendingAutoSelectForAsset;
+    private queuePendingAutoSelectForAssets;
     /**
      * 生成钱包API默认参数
      * 根据业务数据生成标准的钱包API参数，并存储在模块中

package/dist/modules/Payment/walletpass.js

@@ -39,6 +39,12 @@ function matchesWalletAssetCode(asset, normalizedCode) {
     return String(identifier !== null && identifier !== void 0 ? identifier : '').trim() === normalizedCode;
   });
 }
+function normalizeWalletAssetCode(code) {
+  return String(code !== null && code !== void 0 ? code : '').trim().toUpperCase();
+}
+function getWalletAssetCodeKeys(asset) {
+  return [asset === null || asset === void 0 ? void 0 : asset.code, asset === null || asset === void 0 ? void 0 : asset.encoded].map(normalizeWalletAssetCode).filter(Boolean);
+}
 function isWalletAssetAvailable(asset) {
   if (!asset) return false;
   if (asset.unified_available_status !== undefined && Number(asset.unified_available_status) !== 1) {
@@ -102,18 +108,31 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
     _defineProperty(this, "walletInitData", null);
     _defineProperty(this, "walletAssetsState", createInitialWalletAssetsState());
     _defineProperty(this, "walletAssetsRequestSequence", 0);
+    _defineProperty(this, "walletAssetsBehavior", {
+      autoSelectAfterSearch: true
+    });
+    _defineProperty(this, "pendingAutoSelectSearchCodes", new Set());
     _defineProperty(this, "walletAssetsCalculationContext", {
       orderTotalAmount: 0,
       products: []
     });
     this.paymentModule = paymentModule;
   }
-
-  /**
-   * 发送事件的辅助方法
-   * 支持使用WalletPassHooks或PaymentHooks
-   */
   _createClass(WalletPassPaymentImpl, [{
+    key: "configureWalletAssetsBehavior",
+    value: function configureWalletAssetsBehavior(options) {
+      if (options.autoSelectAfterSearch === undefined) return;
+      this.walletAssetsBehavior.autoSelectAfterSearch = options.autoSelectAfterSearch;
+      if (!options.autoSelectAfterSearch) {
+        this.pendingAutoSelectSearchCodes.clear();
+      }
+    }
+
+    /**
+     * 发送事件的辅助方法
+     * 支持使用WalletPassHooks或PaymentHooks
+     */
+  }, {
     key: "emitEvent",
     value: function emitEvent(hook, data) {
       try {
@@ -250,6 +269,33 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
       }
       return mergeWalletAssets(cachedAssets, refreshedAssets);
     }
+  }, {
+    key: "isPendingAutoSelectAsset",
+    value: function isPendingAutoSelectAsset(asset) {
+      var _this = this;
+      return getWalletAssetCodeKeys(asset).some(function (code) {
+        return _this.pendingAutoSelectSearchCodes.has(code);
+      });
+    }
+  }, {
+    key: "clearPendingAutoSelectForAsset",
+    value: function clearPendingAutoSelectForAsset(asset) {
+      var _this2 = this;
+      getWalletAssetCodeKeys(asset).forEach(function (code) {
+        _this2.pendingAutoSelectSearchCodes.delete(code);
+      });
+    }
+  }, {
+    key: "queuePendingAutoSelectForAssets",
+    value: function queuePendingAutoSelectForAssets(assets) {
+      var _this3 = this;
+      if (!this.walletAssetsBehavior.autoSelectAfterSearch) return;
+      assets.forEach(function (asset) {
+        getWalletAssetCodeKeys(asset).forEach(function (code) {
+          _this3.pendingAutoSelectSearchCodes.add(code);
+        });
+      });
+    }
 
     /**
      * 生成钱包API默认参数
@@ -960,7 +1006,8 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
     key: "refreshWalletAssetsFromBusinessAsync",
     value: (function () {
       var _refreshWalletAssetsFromBusinessAsync = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8(businessData) {
-        var _businessData$product2;
+        var _businessData$product2,
+          _this4 = this;
         var options,
           requestSequence,
           nextCustomerId,
@@ -971,6 +1018,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
           committedItems,
           selectedIds,
           selectionSources,
+          scanSelectedAssets,
           restoredSearchedAssets,
           searchedWalletAssetCodes,
           useAggregateRecalculate,
@@ -984,6 +1032,11 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
           items,
           latestSelectedIds,
           latestSelectionSources,
+          pendingAutoSelectAssets,
+          requestedKeySet,
+          nextState,
+          selectedKeySet,
+          droppedScanSelectedAssets,
           _args8 = arguments;
         return _regeneratorRuntime().wrap(function _callee8$(_context8) {
           while (1) switch (_context8.prev = _context8.next) {
@@ -1004,12 +1057,18 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
                 return committedKeys.has(getWalletAssetKey(item));
               });
               selectedIds = preserveSelection ? _toConsumableArray(this.walletAssetsState.selectedIds) : [];
-              selectionSources = preserveSelection ? _objectSpread({}, this.walletAssetsState.selectionSources) : {}; // aggregate-recalculate 不接受空商品列表。
-              // 清空购物车时保留扫码资产供后续加购恢复，但必须取消当前选择。
+              selectionSources = preserveSelection ? _objectSpread({}, this.walletAssetsState.selectionSources) : {};
+              scanSelectedAssets = preserveSelection ? this.walletAssetsState.selectedItems.filter(function (asset) {
+                var assetId = getWalletAssetId(asset);
+                return assetId !== undefined && assetId !== null && selectionSources[String(assetId)] === 'scan';
+              }) : []; // aggregate-recalculate 不接受空商品列表。
+              // 清空购物车时保留扫码资产供后续加购恢复；只有手动 Remove/Clear
+              // 会取消自动应用资格，商品变化导致的自动失效需要重新进入待选队列。
               if ((_businessData$product2 = businessData.products) !== null && _businessData$product2 !== void 0 && _businessData$product2.length) {
-                _context8.next = 20;
+                _context8.next = 22;
                 break;
               }
+              this.queuePendingAutoSelectForAssets(scanSelectedAssets);
               this.generateWalletParams(businessData);
               restoredSearchedAssets = this.searchResults.filter(isWalletPaymentAsset).map(function (item) {
                 return _objectSpread(_objectSpread({}, item), {}, {
@@ -1044,7 +1103,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
                 totalSelectedAmount: 0,
                 error: null
               }));
-            case 20:
+            case 22:
               this.publishWalletAssetsState({
                 status: 'loading',
                 customerId: nextCustomerId,
@@ -1055,40 +1114,40 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
                 totalSelectedAmount: preserveSelection ? this.walletAssetsState.totalSelectedAmount : 0,
                 error: null
               });
-              _context8.prev = 21;
+              _context8.prev = 23;
               searchedWalletAssetCodes = preserveSelection ? this.getSearchedWalletAssetCodes() : [];
               useAggregateRecalculate = preserveSelection && (selectedIds.length > 0 || searchedWalletAssetCodes.length > 0);
               if (!useAggregateRecalculate) {
-                _context8.next = 30;
+                _context8.next = 32;
                 break;
               }
-              _context8.next = 27;
+              _context8.next = 29;
               return this.aggregateRecalculateWalletAssetsAsync(businessData, selectedIds);
-            case 27:
+            case 29:
               _context8.t0 = _context8.sent;
-              _context8.next = 31;
+              _context8.next = 33;
               break;
-            case 30:
+            case 32:
               _context8.t0 = null;
-            case 31:
+            case 33:
               aggregateResult = _context8.t0;
               _context8.t1 = aggregateResult;
               if (_context8.t1) {
-                _context8.next = 37;
+                _context8.next = 39;
                 break;
               }
-              _context8.next = 36;
+              _context8.next = 38;
               return this.initializeWalletDataFromBusinessAsync(businessData);
-            case 36:
+            case 38:
               _context8.t1 = _context8.sent;
-            case 37:
+            case 39:
               result = _context8.t1;
               if (!(requestSequence !== this.walletAssetsRequestSequence)) {
-                _context8.next = 40;
+                _context8.next = 42;
                 break;
               }
               return _context8.abrupt("return", this.getWalletAssetsState());
-            case 40:
+            case 42:
               this.walletAssetsCalculationContext = {
                 orderTotalAmount: Number(businessData.order_wait_pay_amount || 0),
                 products: result.products || businessData.products || []
@@ -1111,11 +1170,11 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
               }
               searchedWalletAssets = preserveSelection ? this.syncSearchedWalletAssets([].concat(_toConsumableArray(result.transformList || []), _toConsumableArray(result.noApplicableVoucher || []))) : [];
               if (!(requestSequence !== this.walletAssetsRequestSequence)) {
-                _context8.next = 46;
+                _context8.next = 48;
                 break;
               }
               return _context8.abrupt("return", this.getWalletAssetsState());
-            case 46:
+            case 48:
               recommendedKeys = new Set((result.walletRecommendList || []).map(function (asset) {
                 return getWalletAssetKey(asset);
               }));
@@ -1126,16 +1185,47 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
               });
               latestSelectedIds = preserveSelection ? authoritativeSelectedIds : [];
               latestSelectionSources = preserveSelection ? _objectSpread({}, this.walletAssetsState.selectionSources) : {};
-              return _context8.abrupt("return", this.recalculateWalletAssets(items, latestSelectedIds, latestSelectionSources));
-            case 53:
-              _context8.prev = 53;
-              _context8.t2 = _context8["catch"](21);
+              pendingAutoSelectAssets = this.walletAssetsBehavior.autoSelectAfterSearch ? items.filter(function (asset) {
+                return _this4.isPendingAutoSelectAsset(asset) && isWalletAssetAvailable(asset);
+              }) : [];
+              requestedKeySet = new Set(latestSelectedIds.map(function (id) {
+                return String(id);
+              }));
+              pendingAutoSelectAssets.forEach(function (asset) {
+                var assetId = getWalletAssetId(asset);
+                if (assetId === undefined || assetId === null) return;
+                var assetKey = String(assetId);
+                if (!requestedKeySet.has(assetKey)) {
+                  requestedKeySet.add(assetKey);
+                  latestSelectedIds.push(assetId);
+                }
+                latestSelectionSources[assetKey] = 'scan';
+              });
+              nextState = this.recalculateWalletAssets(items, latestSelectedIds, latestSelectionSources);
+              selectedKeySet = new Set(nextState.selectedIds.map(function (id) {
+                return String(id);
+              }));
+              pendingAutoSelectAssets.forEach(function (asset) {
+                var assetId = getWalletAssetId(asset);
+                if (assetId !== undefined && assetId !== null && selectedKeySet.has(String(assetId))) {
+                  _this4.clearPendingAutoSelectForAsset(asset);
+                }
+              });
+              droppedScanSelectedAssets = scanSelectedAssets.filter(function (asset) {
+                var assetId = getWalletAssetId(asset);
+                return assetId !== undefined && assetId !== null && !selectedKeySet.has(String(assetId));
+              });
+              this.queuePendingAutoSelectForAssets(droppedScanSelectedAssets);
+              return _context8.abrupt("return", nextState);
+            case 63:
+              _context8.prev = 63;
+              _context8.t2 = _context8["catch"](23);
               if (!(requestSequence !== this.walletAssetsRequestSequence)) {
-                _context8.next = 57;
+                _context8.next = 67;
                 break;
               }
               return _context8.abrupt("return", this.getWalletAssetsState());
-            case 57:
+            case 67:
               this.paymentModule.logError('[WalletPass] 刷新共享钱包资产失败，保留刷新前状态', _context8.t2, {
                 customer_id: businessData.customer_id,
                 selected_ids: selectedIds,
@@ -1151,11 +1241,11 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
                 customerId: nextCustomerId,
                 error: _context8.t2 instanceof Error ? _context8.t2.message : String(_context8.t2)
               }));
-            case 59:
+            case 69:
             case "end":
               return _context8.stop();
           }
-        }, _callee8, this, [[21, 53]]);
+        }, _callee8, this, [[23, 63]]);
       }));
       function refreshWalletAssetsFromBusinessAsync(_x9) {
         return _refreshWalletAssetsFromBusinessAsync.apply(this, arguments);
@@ -1179,6 +1269,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
       return {
         state: this.getWalletAssetsState(),
         searchResults: _toConsumableArray(this.searchResults),
+        pendingAutoSelectSearchCodes: _toConsumableArray(this.pendingAutoSelectSearchCodes),
         walletParams: this.walletParams ? _objectSpread({}, this.walletParams) : null,
         calculationContext: {
           orderTotalAmount: this.walletAssetsCalculationContext.orderTotalAmount,
@@ -1193,6 +1284,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
       if (!(snapshot !== null && snapshot !== void 0 && snapshot.state)) return this.getWalletAssetsState();
       this.walletAssetsRequestSequence += 1;
       this.searchResults = Array.isArray(snapshot.searchResults) ? _toConsumableArray(snapshot.searchResults) : [];
+      this.pendingAutoSelectSearchCodes = this.walletAssetsBehavior.autoSelectAfterSearch && Array.isArray(snapshot.pendingAutoSelectSearchCodes) ? new Set(snapshot.pendingAutoSelectSearchCodes.map(normalizeWalletAssetCode).filter(Boolean)) : new Set();
       this.walletParams = snapshot.walletParams ? _objectSpread({}, snapshot.walletParams) : null;
       this.walletAssetsCalculationContext = {
         orderTotalAmount: Number(((_snapshot$calculation = snapshot.calculationContext) === null || _snapshot$calculation === void 0 ? void 0 : _snapshot$calculation.orderTotalAmount) || 0),
@@ -1210,6 +1302,9 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
     key: "selectWalletAsset",
     value: function selectWalletAsset(assetId, options) {
       var assetKey = String(assetId);
+      var asset = this.walletAssetsState.items.find(function (item) {
+        return getWalletAssetKey(item) === assetKey;
+      });
       var committedKeys = new Set(this.walletAssetsState.committedIds.map(function (id) {
         return String(id);
       }));
@@ -1220,22 +1315,27 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
       var selectionSources = _objectSpread({}, this.walletAssetsState.selectionSources);
       delete selectionSources[assetKey];
       if (options.selected) {
-        var asset = this.walletAssetsState.items.find(function (item) {
-          return getWalletAssetKey(item) === assetKey;
-        });
         if (!asset || !isWalletAssetAvailable(asset)) {
           return this.getWalletAssetsState();
         }
         selectedIds.push(assetId);
         selectionSources[assetKey] = options.source || 'manual';
+      } else if (asset) {
+        this.clearPendingAutoSelectForAsset(asset);
       }
-      return this.recalculateWalletAssets(this.walletAssetsState.items, selectedIds, selectionSources);
+      var nextState = this.recalculateWalletAssets(this.walletAssetsState.items, selectedIds, selectionSources);
+      if (options.selected && asset && nextState.selectedIds.some(function (id) {
+        return String(id) === assetKey;
+      })) {
+        this.clearPendingAutoSelectForAsset(asset);
+      }
+      return nextState;
     }
   }, {
     key: "scanWalletAssetAsync",
     value: function () {
       var _scanWalletAssetAsync = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9(code) {
-        var normalizedCode, selectedAsset, result, paymentAssets, asset, items, assetId, selected;
+        var normalizedCode, selectedAsset, result, paymentAssets, asset, items, recalculatedState, assetId, selected, isSelected;
         return _regeneratorRuntime().wrap(function _callee9$(_context9) {
           while (1) switch (_context9.prev = _context9.next) {
             case 0:
@@ -1288,21 +1388,28 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
               });
             case 14:
               items = mergeWalletAssets(this.walletAssetsState.items, [asset]);
-              this.recalculateWalletAssets(items, this.walletAssetsState.selectedIds, this.walletAssetsState.selectionSources);
+              recalculatedState = this.recalculateWalletAssets(items, this.walletAssetsState.selectedIds, this.walletAssetsState.selectionSources);
               assetId = getWalletAssetId(asset);
-              selected = assetId !== undefined && isWalletAssetAvailable(asset) ? this.selectWalletAsset(assetId, {
+              selected = this.walletAssetsBehavior.autoSelectAfterSearch && assetId !== undefined && isWalletAssetAvailable(asset) ? this.selectWalletAsset(assetId, {
                 selected: true,
                 source: 'scan'
-              }) : this.getWalletAssetsState();
+              }) : recalculatedState;
+              isSelected = assetId !== undefined && selected.selectedIds.some(function (id) {
+                return String(id) === String(assetId);
+              });
+              if (isSelected) {
+                this.clearPendingAutoSelectForAsset(asset);
+              } else if (this.walletAssetsBehavior.autoSelectAfterSearch) {
+                this.pendingAutoSelectSearchCodes.add(normalizeWalletAssetCode(normalizedCode));
+                this.queuePendingAutoSelectForAssets([asset]);
+              }
               return _context9.abrupt("return", {
                 type: result.type,
                 asset: asset,
-                selected: assetId !== undefined && selected.selectedIds.some(function (id) {
-                  return String(id) === String(assetId);
-                }),
+                selected: isSelected,
                 state: selected
               });
-            case 19:
+            case 21:
             case "end":
               return _context9.stop();
           }
@@ -1316,6 +1423,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
   }, {
     key: "clearWalletAssetSelection",
     value: function clearWalletAssetSelection() {
+      this.pendingAutoSelectSearchCodes.clear();
       return this.recalculateWalletAssets(this.walletAssetsState.items, [], {});
     }
   }, {
@@ -1491,6 +1599,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
     key: "clearSearchResults",
     value: function clearSearchResults() {
       this.searchResults = [];
+      this.pendingAutoSelectSearchCodes.clear();
       this.paymentModule.logInfo('[WalletPass] 搜索结果缓存已清除');
     }
 
@@ -1522,6 +1631,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
       this.walletRecommendList = [];
       this.userIdentificationCodes = [];
       this.searchResults = [];
+      this.pendingAutoSelectSearchCodes.clear();
       this.walletParams = null;
       this.walletInitData = null;
       this.walletAssetsRequestSequence += 1;

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

@@ -9,7 +9,7 @@ import { RequestPlugin, WindowPlugin } from '../../plugins';
 export * from './types';
 import { ProductList } from '../../modules/ProductList';
 import { PaymentModule } from '../../modules/Payment';
-import type { PaymentMethod, RoundingResult, WalletAssetId, WalletAssetsSnapshot, WalletAssetsState, WalletAssetSelectionSource, ScanWalletAssetResult } from '../../modules/Payment/types';
+import type { PaymentMethod, RoundingResult, WalletAssetId, WalletAssetsBehaviorOptions, WalletAssetsSnapshot, WalletAssetsState, WalletAssetSelectionSource, ScanWalletAssetResult } from '../../modules/Payment/types';
 import type { SalesSummaryModule } from '../../modules/SalesSummary';
 import type { ScheduleModule } from '../../modules/Schedule';
 import { QuotationModule } from '../../modules/Quotation';
@@ -326,6 +326,8 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     getWalletAssetsState(): WalletAssetsState;
     /** 导出 Shared Checkout 跨运行时恢复所需的钱包状态与搜索缓存。 */
     exportWalletAssetsSnapshot(): WalletAssetsSnapshot;
+    /** 配置仅影响 Wallet Assets，不改变 Promotion/Voucher 选择流程。 */
+    configureWalletAssetsBehavior(options: WalletAssetsBehaviorOptions): void;
     /**
      * 恢复 Shared Checkout 钱包快照，并把选择重新同步为订单 pending payment。
      */

package/dist/solution/BaseSales/index.js

@@ -3821,6 +3821,14 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
       return this.store.payment.wallet.exportWalletAssetsSnapshot();
     }
 
+    /** 配置仅影响 Wallet Assets，不改变 Promotion/Voucher 选择流程。 */
+  }, {
+    key: "configureWalletAssetsBehavior",
+    value: function configureWalletAssetsBehavior(options) {
+      if (!this.store.payment) throw new Error('payment 模块未初始化');
+      this.store.payment.wallet.configureWalletAssetsBehavior(options);
+    }
+
     /**
      * 恢复 Shared Checkout 钱包快照，并把选择重新同步为订单 pending payment。
      */

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 | 2 | 1 | 5 | 4 | 3 | 6;
+        weekNum: 0 | 2 | 1 | 3 | 4 | 5 | 6;
     }[]>;
     submitTimeSlot(timeSlots: TimeSliceItem): void;
     private getScheduleDataByIds;

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

@@ -326,7 +326,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/model/strategy/adapter/promotion/index.js

@@ -1,51 +0,0 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/model/strategy/adapter/promotion/index.ts
-var promotion_exports = {};
-__export(promotion_exports, {
-  BUY_X_GET_Y_FREE_STRATEGY: () => import_examples.BUY_X_GET_Y_FREE_STRATEGY,
-  ITEM_REWARD_STRATEGY: () => import_examples.ITEM_REWARD_STRATEGY,
-  PromotionAdapter: () => import_adapter.PromotionAdapter,
-  PromotionEvaluator: () => import_evaluator.PromotionEvaluator,
-  X_ITEMS_FOR_Y_PRICE_STRATEGY: () => import_examples.X_ITEMS_FOR_Y_PRICE_STRATEGY,
-  default: () => import_adapter2.default
-});
-module.exports = __toCommonJS(promotion_exports);
-var import_evaluator = require("./evaluator");
-var import_adapter = require("./adapter");
-var import_adapter2 = __toESM(require("./adapter"));
-var import_examples = require("./examples");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  BUY_X_GET_Y_FREE_STRATEGY,
-  ITEM_REWARD_STRATEGY,
-  PromotionAdapter,
-  PromotionEvaluator,
-  X_ITEMS_FOR_Y_PRICE_STRATEGY
-});

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

@@ -397,12 +397,18 @@ export interface WalletAssetsState {
 export interface WalletAssetsSnapshot {
     state: WalletAssetsState;
     searchResults: SearchIdentificationCodeItem[];
+    /** 已搜索但尚未满足订单条件、等待首次可用后自动选中的 Wallet Asset code。 */
+    pendingAutoSelectSearchCodes?: string[];
     walletParams: WalletDeductionRecommendParams | null;
     calculationContext: {
         orderTotalAmount: number;
         products: any[];
     };
 }
+export interface WalletAssetsBehaviorOptions {
+    /** 搜索到 Wallet Asset 后，当前或后续首次可用时是否自动选中。 */
+    autoSelectAfterSearch?: boolean;
+}
 export interface RefreshWalletAssetsOptions {
     /** 商品/金额变化默认保留并重验选择；客户变化由实现层强制清空。 */
     preserveSelection?: boolean;
@@ -472,6 +478,8 @@ export interface WalletPassPayment {
     refreshWalletAssetsFromBusinessAsync: (businessData: WalletInitBusinessData, options?: RefreshWalletAssetsOptions) => Promise<WalletAssetsState>;
     /** 获取共享钱包资产状态快照。 */
     getWalletAssetsState: () => WalletAssetsState;
+    /** 配置仅影响 Wallet Assets 的交互行为。 */
+    configureWalletAssetsBehavior: (options: WalletAssetsBehaviorOptions) => void;
     /** 导出供 Shared Checkout 跨运行时传递的 Wallet Assets 快照。 */
     exportWalletAssetsSnapshot: () => WalletAssetsSnapshot;
     /** 恢复 Shared Checkout 传回的 Wallet Assets 快照。 */

package/lib/modules/Payment/walletpass.d.ts

@@ -1,4 +1,4 @@
-import { WalletPassPayment, WalletDeductionRecommendParams, WalletRecommendItem, UserIdentificationCodeParams, UserIdentificationCodeItem, SearchIdentificationCodeParams, SearchIdentificationCodeItem, SearchIdentificationCodeResult, WalletInitBusinessData, WalletAssetId, WalletAssetsSnapshot, WalletAssetsState, RefreshWalletAssetsOptions, SelectWalletAssetOptions, ScanWalletAssetResult } from './types';
+import { WalletPassPayment, WalletDeductionRecommendParams, WalletRecommendItem, UserIdentificationCodeParams, UserIdentificationCodeItem, SearchIdentificationCodeParams, SearchIdentificationCodeItem, SearchIdentificationCodeResult, WalletInitBusinessData, WalletAssetId, WalletAssetsBehaviorOptions, WalletAssetsSnapshot, WalletAssetsState, RefreshWalletAssetsOptions, SelectWalletAssetOptions, ScanWalletAssetResult } from './types';
 import type { PaymentModule } from './index';
 /**
  * 钱包支付实现
@@ -12,8 +12,11 @@ export declare class WalletPassPaymentImpl implements WalletPassPayment {
     private walletInitData;
     private walletAssetsState;
     private walletAssetsRequestSequence;
+    private walletAssetsBehavior;
+    private pendingAutoSelectSearchCodes;
     private walletAssetsCalculationContext;
     constructor(paymentModule: PaymentModule);
+    configureWalletAssetsBehavior(options: WalletAssetsBehaviorOptions): void;
     /**
      * 发送事件的辅助方法
      * 支持使用WalletPassHooks或PaymentHooks
@@ -28,6 +31,9 @@ export declare class WalletPassPaymentImpl implements WalletPassPayment {
      * 接口暂时缺失某个扫码 code 时继续保留旧值，避免列表闪空。
      */
     private syncSearchedWalletAssets;
+    private isPendingAutoSelectAsset;
+    private clearPendingAutoSelectForAsset;
+    private queuePendingAutoSelectForAssets;
     /**
      * 生成钱包API默认参数
      * 根据业务数据生成标准的钱包API参数，并存储在模块中

package/lib/modules/Payment/walletpass.js

@@ -46,6 +46,12 @@ function matchesWalletAssetCode(asset, normalizedCode) {
     (identifier) => String(identifier ?? "").trim() === normalizedCode
   );
 }
+function normalizeWalletAssetCode(code) {
+  return String(code ?? "").trim().toUpperCase();
+}
+function getWalletAssetCodeKeys(asset) {
+  return [asset == null ? void 0 : asset.code, asset == null ? void 0 : asset.encoded].map(normalizeWalletAssetCode).filter(Boolean);
+}
 function isWalletAssetAvailable(asset) {
   if (!asset)
     return false;
@@ -107,11 +113,23 @@ var WalletPassPaymentImpl = class {
     this.walletInitData = null;
     this.walletAssetsState = createInitialWalletAssetsState();
     this.walletAssetsRequestSequence = 0;
+    this.walletAssetsBehavior = {
+      autoSelectAfterSearch: true
+    };
+    this.pendingAutoSelectSearchCodes = /* @__PURE__ */ new Set();
     this.walletAssetsCalculationContext = {
       orderTotalAmount: 0,
       products: []
     };
   }
+  configureWalletAssetsBehavior(options) {
+    if (options.autoSelectAfterSearch === void 0)
+      return;
+    this.walletAssetsBehavior.autoSelectAfterSearch = options.autoSelectAfterSearch;
+    if (!options.autoSelectAfterSearch) {
+      this.pendingAutoSelectSearchCodes.clear();
+    }
+  }
   /**
    * 发送事件的辅助方法
    * 支持使用WalletPassHooks或PaymentHooks
@@ -250,6 +268,25 @@ var WalletPassPaymentImpl = class {
       refreshedAssets
     );
   }
+  isPendingAutoSelectAsset(asset) {
+    return getWalletAssetCodeKeys(asset).some(
+      (code) => this.pendingAutoSelectSearchCodes.has(code)
+    );
+  }
+  clearPendingAutoSelectForAsset(asset) {
+    getWalletAssetCodeKeys(asset).forEach((code) => {
+      this.pendingAutoSelectSearchCodes.delete(code);
+    });
+  }
+  queuePendingAutoSelectForAssets(assets) {
+    if (!this.walletAssetsBehavior.autoSelectAfterSearch)
+      return;
+    assets.forEach((asset) => {
+      getWalletAssetCodeKeys(asset).forEach((code) => {
+        this.pendingAutoSelectSearchCodes.add(code);
+      });
+    });
+  }
   /**
    * 生成钱包API默认参数
    * 根据业务数据生成标准的钱包API参数，并存储在模块中
@@ -777,7 +814,12 @@ var WalletPassPaymentImpl = class {
     );
     const selectedIds = preserveSelection ? [...this.walletAssetsState.selectedIds] : [];
     const selectionSources = preserveSelection ? { ...this.walletAssetsState.selectionSources } : {};
+    const scanSelectedAssets = preserveSelection ? this.walletAssetsState.selectedItems.filter((asset) => {
+      const assetId = getWalletAssetId(asset);
+      return assetId !== void 0 && assetId !== null && selectionSources[String(assetId)] === "scan";
+    }) : [];
     if (!((_a = businessData.products) == null ? void 0 : _a.length)) {
+      this.queuePendingAutoSelectForAssets(scanSelectedAssets);
       this.generateWalletParams(businessData);
       const restoredSearchedAssets = this.searchResults.filter(isWalletPaymentAsset).map((item) => ({
         ...item,
@@ -882,11 +924,43 @@ var WalletPassPaymentImpl = class {
       }));
       const latestSelectedIds = preserveSelection ? authoritativeSelectedIds : [];
       const latestSelectionSources = preserveSelection ? { ...this.walletAssetsState.selectionSources } : {};
-      return this.recalculateWalletAssets(
+      const pendingAutoSelectAssets = this.walletAssetsBehavior.autoSelectAfterSearch ? items.filter(
+        (asset) => this.isPendingAutoSelectAsset(asset) && isWalletAssetAvailable(asset)
+      ) : [];
+      const requestedKeySet = new Set(
+        latestSelectedIds.map((id) => String(id))
+      );
+      pendingAutoSelectAssets.forEach((asset) => {
+        const assetId = getWalletAssetId(asset);
+        if (assetId === void 0 || assetId === null)
+          return;
+        const assetKey = String(assetId);
+        if (!requestedKeySet.has(assetKey)) {
+          requestedKeySet.add(assetKey);
+          latestSelectedIds.push(assetId);
+        }
+        latestSelectionSources[assetKey] = "scan";
+      });
+      const nextState = this.recalculateWalletAssets(
         items,
         latestSelectedIds,
         latestSelectionSources
       );
+      const selectedKeySet = new Set(
+        nextState.selectedIds.map((id) => String(id))
+      );
+      pendingAutoSelectAssets.forEach((asset) => {
+        const assetId = getWalletAssetId(asset);
+        if (assetId !== void 0 && assetId !== null && selectedKeySet.has(String(assetId))) {
+          this.clearPendingAutoSelectForAsset(asset);
+        }
+      });
+      const droppedScanSelectedAssets = scanSelectedAssets.filter((asset) => {
+        const assetId = getWalletAssetId(asset);
+        return assetId !== void 0 && assetId !== null && !selectedKeySet.has(String(assetId));
+      });
+      this.queuePendingAutoSelectForAssets(droppedScanSelectedAssets);
+      return nextState;
     } catch (error) {
       if (requestSequence !== this.walletAssetsRequestSequence) {
         return this.getWalletAssetsState();
@@ -926,6 +1000,9 @@ var WalletPassPaymentImpl = class {
     return {
       state: this.getWalletAssetsState(),
       searchResults: [...this.searchResults],
+      pendingAutoSelectSearchCodes: [
+        ...this.pendingAutoSelectSearchCodes
+      ],
       walletParams: this.walletParams ? { ...this.walletParams } : null,
       calculationContext: {
         orderTotalAmount: this.walletAssetsCalculationContext.orderTotalAmount,
@@ -939,6 +1016,9 @@ var WalletPassPaymentImpl = class {
       return this.getWalletAssetsState();
     this.walletAssetsRequestSequence += 1;
     this.searchResults = Array.isArray(snapshot.searchResults) ? [...snapshot.searchResults] : [];
+    this.pendingAutoSelectSearchCodes = this.walletAssetsBehavior.autoSelectAfterSearch && Array.isArray(snapshot.pendingAutoSelectSearchCodes) ? new Set(
+      snapshot.pendingAutoSelectSearchCodes.map(normalizeWalletAssetCode).filter(Boolean)
+    ) : /* @__PURE__ */ new Set();
     this.walletParams = snapshot.walletParams ? { ...snapshot.walletParams } : null;
     this.walletAssetsCalculationContext = {
       orderTotalAmount: Number(
@@ -957,6 +1037,9 @@ var WalletPassPaymentImpl = class {
   }
   selectWalletAsset(assetId, options) {
     const assetKey = String(assetId);
+    const asset = this.walletAssetsState.items.find(
+      (item) => getWalletAssetKey(item) === assetKey
+    );
     const committedKeys = new Set(
       this.walletAssetsState.committedIds.map((id) => String(id))
     );
@@ -968,20 +1051,23 @@ var WalletPassPaymentImpl = class {
     const selectionSources = { ...this.walletAssetsState.selectionSources };
     delete selectionSources[assetKey];
     if (options.selected) {
-      const asset = this.walletAssetsState.items.find(
-        (item) => getWalletAssetKey(item) === assetKey
-      );
       if (!asset || !isWalletAssetAvailable(asset)) {
         return this.getWalletAssetsState();
       }
       selectedIds.push(assetId);
       selectionSources[assetKey] = options.source || "manual";
+    } else if (asset) {
+      this.clearPendingAutoSelectForAsset(asset);
     }
-    return this.recalculateWalletAssets(
+    const nextState = this.recalculateWalletAssets(
       this.walletAssetsState.items,
       selectedIds,
       selectionSources
     );
+    if (options.selected && asset && nextState.selectedIds.some((id) => String(id) === assetKey)) {
+      this.clearPendingAutoSelectForAsset(asset);
+    }
+    return nextState;
   }
   async scanWalletAssetAsync(code) {
     const normalizedCode = String(code || "").trim();
@@ -1024,24 +1110,34 @@ var WalletPassPaymentImpl = class {
       };
     }
     const items = mergeWalletAssets(this.walletAssetsState.items, [asset]);
-    this.recalculateWalletAssets(
+    const recalculatedState = this.recalculateWalletAssets(
       items,
       this.walletAssetsState.selectedIds,
       this.walletAssetsState.selectionSources
     );
     const assetId = getWalletAssetId(asset);
-    const selected = assetId !== void 0 && isWalletAssetAvailable(asset) ? this.selectWalletAsset(assetId, {
+    const selected = this.walletAssetsBehavior.autoSelectAfterSearch && assetId !== void 0 && isWalletAssetAvailable(asset) ? this.selectWalletAsset(assetId, {
       selected: true,
       source: "scan"
-    }) : this.getWalletAssetsState();
+    }) : recalculatedState;
+    const isSelected = assetId !== void 0 && selected.selectedIds.some((id) => String(id) === String(assetId));
+    if (isSelected) {
+      this.clearPendingAutoSelectForAsset(asset);
+    } else if (this.walletAssetsBehavior.autoSelectAfterSearch) {
+      this.pendingAutoSelectSearchCodes.add(
+        normalizeWalletAssetCode(normalizedCode)
+      );
+      this.queuePendingAutoSelectForAssets([asset]);
+    }
     return {
       type: result.type,
       asset,
-      selected: assetId !== void 0 && selected.selectedIds.some((id) => String(id) === String(assetId)),
+      selected: isSelected,
       state: selected
     };
   }
   clearWalletAssetSelection() {
+    this.pendingAutoSelectSearchCodes.clear();
     return this.recalculateWalletAssets(
       this.walletAssetsState.items,
       [],
@@ -1156,6 +1252,7 @@ var WalletPassPaymentImpl = class {
    */
   clearSearchResults() {
     this.searchResults = [];
+    this.pendingAutoSelectSearchCodes.clear();
     this.paymentModule.logInfo("[WalletPass] 搜索结果缓存已清除");
   }
   /**
@@ -1178,6 +1275,7 @@ var WalletPassPaymentImpl = class {
     this.walletRecommendList = [];
     this.userIdentificationCodes = [];
     this.searchResults = [];
+    this.pendingAutoSelectSearchCodes.clear();
     this.walletParams = null;
     this.walletInitData = null;
     this.walletAssetsRequestSequence += 1;

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

@@ -9,7 +9,7 @@ import { RequestPlugin, WindowPlugin } from '../../plugins';
 export * from './types';
 import { ProductList } from '../../modules/ProductList';
 import { PaymentModule } from '../../modules/Payment';
-import type { PaymentMethod, RoundingResult, WalletAssetId, WalletAssetsSnapshot, WalletAssetsState, WalletAssetSelectionSource, ScanWalletAssetResult } from '../../modules/Payment/types';
+import type { PaymentMethod, RoundingResult, WalletAssetId, WalletAssetsBehaviorOptions, WalletAssetsSnapshot, WalletAssetsState, WalletAssetSelectionSource, ScanWalletAssetResult } from '../../modules/Payment/types';
 import type { SalesSummaryModule } from '../../modules/SalesSummary';
 import type { ScheduleModule } from '../../modules/Schedule';
 import { QuotationModule } from '../../modules/Quotation';
@@ -326,6 +326,8 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     getWalletAssetsState(): WalletAssetsState;
     /** 导出 Shared Checkout 跨运行时恢复所需的钱包状态与搜索缓存。 */
     exportWalletAssetsSnapshot(): WalletAssetsSnapshot;
+    /** 配置仅影响 Wallet Assets，不改变 Promotion/Voucher 选择流程。 */
+    configureWalletAssetsBehavior(options: WalletAssetsBehaviorOptions): void;
     /**
      * 恢复 Shared Checkout 钱包快照，并把选择重新同步为订单 pending payment。
      */

package/lib/solution/BaseSales/index.js

@@ -2535,6 +2535,12 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       throw new Error("payment 模块未初始化");
     return this.store.payment.wallet.exportWalletAssetsSnapshot();
   }
+  /** 配置仅影响 Wallet Assets，不改变 Promotion/Voucher 选择流程。 */
+  configureWalletAssetsBehavior(options) {
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    this.store.payment.wallet.configureWalletAssetsBehavior(options);
+  }
   /**
    * 恢复 Shared Checkout 钱包快照，并把选择重新同步为订单 pending payment。
    */

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 | 2 | 1 | 5 | 4 | 3 | 6;
+        weekNum: 0 | 2 | 1 | 3 | 4 | 5 | 6;
     }[]>;
     submitTimeSlot(timeSlots: TimeSliceItem): void;
     private getScheduleDataByIds;

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

@@ -326,7 +326,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/package.json

@@ -1,7 +1,7 @@
 {
   "private": false,
   "name": "@pisell/pisellos",
-  "version": "2.3.48",
+  "version": "2.3.49",
   "description": "一个可扩展的前端模块化SDK框架，支持插件系统",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",