@pisell/pisellos 2.3.94 → 2.3.95

package/dist/model/strategy/adapter/itemRule/adapter.d.ts

@@ -1,6 +1,6 @@
 import type { EvaluationResult, RuntimeContext, ActionEffect } from '../../type';
 import type { BusinessAdapter } from '../type';
-import { type ItemRuleBusinessData, type QuantityCheckResult, type PrefillItemResult, type QuantityLimitResult } from './type';
+import { type ItemRuleBusinessData, type QuantityCheckResult, type PrefillItemResult, type QuantityLimitResult, type AllergyRequirement } from './type';
 /**
  * ItemRule 适配器
  *
@@ -14,7 +14,10 @@ export declare class ItemRuleAdapter implements BusinessAdapter {
     transformResult(result: EvaluationResult, businessData?: ItemRuleBusinessData): {
         quantityChecks: QuantityCheckResult[];
         prefillItems: PrefillItemResult[];
+        allergyRequirements: AllergyRequirement[];
     };
+    private processAllergyCheck;
+    private normalizeAllergyDataSourceItems;
     formatConfig(result: EvaluationResult, businessData?: ItemRuleBusinessData): {
         result: EvaluationResult;
         businessData?: ItemRuleBusinessData;

package/dist/model/strategy/adapter/itemRule/adapter.js

@@ -1,4 +1,8 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
@@ -31,18 +35,22 @@ export var ItemRuleAdapter = /*#__PURE__*/function () {
   _createClass(ItemRuleAdapter, [{
     key: "prepareContext",
     value: function prepareContext(businessData) {
+      var _ref;
       var pax = businessData.pax,
         cartItems = businessData.cartItems,
         serviceType = businessData.serviceType,
+        channel = businessData.channel,
         submissionIndex = businessData.submissionIndex,
         custom = businessData.custom;
+      var resolvedChannel = String((_ref = channel !== null && channel !== void 0 ? channel : custom === null || custom === void 0 ? void 0 : custom.channel) !== null && _ref !== void 0 ? _ref : '').trim();
       return {
         entities: {
           cartItems: cartItems,
           historicalItems: businessData.historicalItems || [],
-          pax: pax
+          pax: pax,
+          currentProduct: businessData.currentProduct
         },
-        attributes: _objectSpread({
+        attributes: _objectSpread(_objectSpread({
           serviceType: serviceType || '',
           totalPax: pax.total,
           adultPax: pax.adult,
@@ -52,7 +60,9 @@ export var ItemRuleAdapter = /*#__PURE__*/function () {
           cartTotalQuantity: cartItems.reduce(function (sum, item) {
             return sum + item.quantity;
           }, 0)
-        }, custom),
+        }, custom), {}, {
+          channel: resolvedChannel
+        }),
         metadata: {
           timestamp: Date.now()
         }
@@ -63,10 +73,12 @@ export var ItemRuleAdapter = /*#__PURE__*/function () {
     value: function transformResult(result, businessData) {
       var quantityChecks = [];
       var prefillItems = [];
+      var allergyRequirements = [];
       if (!result.applicable || !businessData) {
         return {
           quantityChecks: quantityChecks,
-          prefillItems: prefillItems
+          prefillItems: prefillItems,
+          allergyRequirements: allergyRequirements
         };
       }
       var _iterator = _createForOfIteratorHelper(result.matchedActions),
@@ -82,6 +94,9 @@ export var ItemRuleAdapter = /*#__PURE__*/function () {
           } else if (action.type === ITEM_RULE_ACTION_TYPES.PREFILL_CART) {
             var items = this.processPrefillCart(action, businessData);
             prefillItems.push.apply(prefillItems, _toConsumableArray(items));
+          } else if (action.type === ITEM_RULE_ACTION_TYPES.ALLERGY_CHECK) {
+            var requirement = this.processAllergyCheck(action, result, businessData);
+            if (requirement) allergyRequirements.push(requirement);
           }
         }
       } catch (err) {
@@ -91,9 +106,94 @@ export var ItemRuleAdapter = /*#__PURE__*/function () {
       }
       return {
         quantityChecks: quantityChecks,
-        prefillItems: prefillItems
+        prefillItems: prefillItems,
+        allergyRequirements: allergyRequirements
       };
     }
+
+    // ============================================
+    // Allergy Check 处理
+    // ============================================
+  }, {
+    key: "processAllergyCheck",
+    value: function processAllergyCheck(action, result, businessData) {
+      var _currentProduct$produ, _productTargets$find, _target$dataSource, _action$priority, _target$product_varia;
+      var config = action.config;
+      var currentProduct = businessData.currentProduct;
+      if (!config || config.targetType !== 'product' || config.promptScope !== 'once_per_order_product' || !Array.isArray(config.targets) || !currentProduct) {
+        return null;
+      }
+      var currentProductId = Number(currentProduct.product_id);
+      var currentVariantId = Number((_currentProduct$produ = currentProduct.product_variant_id) !== null && _currentProduct$produ !== void 0 ? _currentProduct$produ : 0);
+      if (!Number.isFinite(currentProductId) || currentProductId <= 0) return null;
+      var productTargets = config.targets.filter(function (item) {
+        return Number(item.product_id) === currentProductId;
+      });
+      var target = (_productTargets$find = productTargets.find(function (item) {
+        var _item$product_variant;
+        return currentVariantId > 0 && Number((_item$product_variant = item.product_variant_id) !== null && _item$product_variant !== void 0 ? _item$product_variant : 0) === currentVariantId;
+      })) !== null && _productTargets$find !== void 0 ? _productTargets$find : productTargets.find(function (item) {
+        var _item$product_variant2;
+        return Number((_item$product_variant2 = item.product_variant_id) !== null && _item$product_variant2 !== void 0 ? _item$product_variant2 : 0) <= 0;
+      });
+      if (!target || ((_target$dataSource = target.dataSource) === null || _target$dataSource === void 0 ? void 0 : _target$dataSource.type) !== 'inline') return null;
+      var items = this.normalizeAllergyDataSourceItems(target.dataSource.items);
+      if (!items.length) return null;
+      return _objectSpread(_objectSpread({
+        strategyId: result.config.metadata.id,
+        ruleId: action.id,
+        priority: (_action$priority = action.priority) !== null && _action$priority !== void 0 ? _action$priority : 0,
+        targetType: 'product',
+        product_id: currentProductId
+      }, Number((_target$product_varia = target.product_variant_id) !== null && _target$product_varia !== void 0 ? _target$product_varia : 0) > 0 ? {
+        product_variant_id: Number(target.product_variant_id)
+      } : {}), {}, {
+        dataSource: {
+          type: 'inline',
+          items: items
+        },
+        promptScope: config.promptScope,
+        allowNote: config.allowNote === true
+      });
+    }
+  }, {
+    key: "normalizeAllergyDataSourceItems",
+    value: function normalizeAllergyDataSourceItems(items) {
+      if (!Array.isArray(items)) return [];
+      var uniqueIds = new Set();
+      var normalized = [];
+      var _iterator2 = _createForOfIteratorHelper(items),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var _item$id;
+          var item = _step2.value;
+          var id = String((_item$id = item === null || item === void 0 ? void 0 : item.id) !== null && _item$id !== void 0 ? _item$id : '').trim();
+          var rawLabel = item === null || item === void 0 ? void 0 : item.label;
+          var label = typeof rawLabel === 'string' ? rawLabel.trim() : Object.entries(rawLabel || {}).reduce(function (labels, _ref2) {
+            var _ref3 = _slicedToArray(_ref2, 2),
+              locale = _ref3[0],
+              value = _ref3[1];
+            if (typeof value === 'string' && value.trim().length > 0) {
+              labels[locale] = value.trim();
+            }
+            return labels;
+          }, {});
+          var hasLabel = typeof label === 'string' ? label.length > 0 : Object.keys(label).length > 0;
+          if (!id || !hasLabel || uniqueIds.has(id)) continue;
+          uniqueIds.add(id);
+          normalized.push({
+            id: id,
+            label: label
+          });
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+      return normalized;
+    }
   }, {
     key: "formatConfig",
     value: function formatConfig(result, businessData) {
@@ -178,19 +278,19 @@ export var ItemRuleAdapter = /*#__PURE__*/function () {
       }));
       var quantity = 0;
       var countFromItems = function countFromItems(items) {
-        var _iterator2 = _createForOfIteratorHelper(items),
-          _step2;
+        var _iterator3 = _createForOfIteratorHelper(items),
+          _step3;
         try {
-          for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
-            var item = _step2.value;
+          for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+            var item = _step3.value;
             if (targetIds.has(item.product_id)) {
               quantity += item.quantity;
             }
           }
         } catch (err) {
-          _iterator2.e(err);
+          _iterator3.e(err);
         } finally {
-          _iterator2.f();
+          _iterator3.f();
         }
       };
       if (scope === 'cumulative') {
@@ -214,11 +314,11 @@ export var ItemRuleAdapter = /*#__PURE__*/function () {
       var requiredMax;
       var requiredExact;
       var mustInclude;
-      var _iterator3 = _createForOfIteratorHelper(rules),
-        _step3;
+      var _iterator4 = _createForOfIteratorHelper(rules),
+        _step4;
       try {
-        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
-          var rule = _step3.value;
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var rule = _step4.value;
           var resolvedValue = this.resolveQuantityValue(rule, businessData);
           switch (rule.comparison) {
             case 'minimum':
@@ -260,9 +360,9 @@ export var ItemRuleAdapter = /*#__PURE__*/function () {
           }
         }
       } catch (err) {
-        _iterator3.e(err);
+        _iterator4.e(err);
       } finally {
-        _iterator3.f();
+        _iterator4.f();
       }
       return {
         passed: failedRules.length === 0,
@@ -336,11 +436,11 @@ export var ItemRuleAdapter = /*#__PURE__*/function () {
       var requiredMax;
       var requiredExact;
       var mustInclude;
-      var _iterator4 = _createForOfIteratorHelper(quantityRules),
-        _step4;
+      var _iterator5 = _createForOfIteratorHelper(quantityRules),
+        _step5;
       try {
-        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
-          var rule = _step4.value;
+        for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+          var rule = _step5.value;
           var resolvedValue = this.resolveQuantityValue(rule, businessData);
           switch (rule.comparison) {
             case 'minimum':
@@ -370,9 +470,9 @@ export var ItemRuleAdapter = /*#__PURE__*/function () {
           }
         }
       } catch (err) {
-        _iterator4.e(err);
+        _iterator5.e(err);
       } finally {
-        _iterator4.f();
+        _iterator5.f();
       }
       var remainingMax = this.calculateRemainingMax(scope, requiredMax, targets, businessData);
       var formattedValidationMessage = this.formatValidationMessage(validationMessage, requiredMin, requiredMax, requiredExact);
@@ -412,19 +512,19 @@ export var ItemRuleAdapter = /*#__PURE__*/function () {
         return t.product_id;
       }));
       var historicalQty = 0;
-      var _iterator5 = _createForOfIteratorHelper(historicalItems),
-        _step5;
+      var _iterator6 = _createForOfIteratorHelper(historicalItems),
+        _step6;
       try {
-        for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
-          var item = _step5.value;
+        for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
+          var item = _step6.value;
           if (targetIds.has(item.product_id)) {
             historicalQty += item.quantity;
           }
         }
       } catch (err) {
-        _iterator5.e(err);
+        _iterator6.e(err);
       } finally {
-        _iterator5.f();
+        _iterator6.f();
       }
       return Math.max(0, requiredMax - historicalQty);
     }
@@ -438,11 +538,11 @@ export var ItemRuleAdapter = /*#__PURE__*/function () {
       var config = action.config;
       if (!(config !== null && config !== void 0 && config.products)) return [];
       var results = [];
-      var _iterator6 = _createForOfIteratorHelper(config.products),
-        _step6;
+      var _iterator7 = _createForOfIteratorHelper(config.products),
+        _step7;
       try {
-        for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
-          var prefillProduct = _step6.value;
+        for (_iterator7.s(); !(_step7 = _iterator7.n()).done;) {
+          var prefillProduct = _step7.value;
           var quantity = this.resolvePrefillQuantity(prefillProduct.quantityFrom, prefillProduct.quantity, businessData);
           if (quantity <= 0) continue;
           results.push({
@@ -453,9 +553,9 @@ export var ItemRuleAdapter = /*#__PURE__*/function () {
           });
         }
       } catch (err) {
-        _iterator6.e(err);
+        _iterator7.e(err);
       } finally {
-        _iterator6.f();
+        _iterator7.f();
       }
       return results;
     }

package/dist/model/strategy/adapter/itemRule/evaluator.d.ts

@@ -1,5 +1,5 @@
 import type { StrategyConfig } from '../../type';
-import { type ItemRuleBusinessData, type ItemRuleEvaluationResult, type QuantityCheckResult, type QuantityLimitResult, type PrefillItemResult } from './type';
+import { type ItemRuleBusinessData, type ItemRuleEvaluationResult, type QuantityCheckResult, type QuantityLimitResult, type PrefillItemResult, type AllergyRequirement } from './type';
 /**
  * ItemRule 评估器
  *
@@ -21,6 +21,13 @@ export declare class ItemRuleEvaluator {
      * 完整评估：数量校验 + 预填购物车
      */
     evaluate(businessData: ItemRuleBusinessData): ItemRuleEvaluationResult;
+    /**
+     * 获取当前商品优先级最高的过敏门禁要求。
+     *
+     * 不同商品或不同 Action 的数据源不会合并；相同优先级按
+     * strategyId + ruleId 稳定排序，保证多次评估结果一致。
+     */
+    getAllergyRequirement(businessData: ItemRuleBusinessData): AllergyRequirement | null;
     /**
      * 获取当前配置中各商品的数量限制
      *

package/dist/model/strategy/adapter/itemRule/evaluator.js

@@ -63,6 +63,7 @@ export var ItemRuleEvaluator = /*#__PURE__*/function () {
       }) : this.strategyConfigs;
       var allQuantityChecks = [];
       var allPrefillItems = [];
+      var allAllergyRequirements = [];
       var rawResults = [];
       var context = this.adapter.prepareContext(businessData);
       var _iterator = _createForOfIteratorHelper(configs),
@@ -74,9 +75,11 @@ export var ItemRuleEvaluator = /*#__PURE__*/function () {
           rawResults.push(evalResult);
           var _this$adapter$transfo = this.adapter.transformResult(evalResult, businessData),
             quantityChecks = _this$adapter$transfo.quantityChecks,
-            prefillItems = _this$adapter$transfo.prefillItems;
+            prefillItems = _this$adapter$transfo.prefillItems,
+            allergyRequirements = _this$adapter$transfo.allergyRequirements;
           allQuantityChecks.push.apply(allQuantityChecks, _toConsumableArray(quantityChecks));
           allPrefillItems.push.apply(allPrefillItems, _toConsumableArray(prefillItems));
+          allAllergyRequirements.push.apply(allAllergyRequirements, _toConsumableArray(allergyRequirements));
         }
       } catch (err) {
         _iterator.e(err);
@@ -89,12 +92,33 @@ export var ItemRuleEvaluator = /*#__PURE__*/function () {
       return {
         quantityChecks: allQuantityChecks,
         prefillItems: allPrefillItems,
+        allergyRequirements: allAllergyRequirements,
         allPassed: failedChecks.length === 0,
         failedChecks: failedChecks,
         rawResults: rawResults
       };
     }
 
+    /**
+     * 获取当前商品优先级最高的过敏门禁要求。
+     *
+     * 不同商品或不同 Action 的数据源不会合并；相同优先级按
+     * strategyId + ruleId 稳定排序，保证多次评估结果一致。
+     */
+  }, {
+    key: "getAllergyRequirement",
+    value: function getAllergyRequirement(businessData) {
+      var requirements = this.evaluate(businessData).allergyRequirements;
+      if (!requirements.length) return null;
+      return _toConsumableArray(requirements).sort(function (left, right) {
+        var priorityDiff = right.priority - left.priority;
+        if (priorityDiff !== 0) return priorityDiff;
+        var strategyDiff = left.strategyId.localeCompare(right.strategyId);
+        if (strategyDiff !== 0) return strategyDiff;
+        return left.ruleId.localeCompare(right.ruleId);
+      })[0];
+    }
+
     /**
      * 获取当前配置中各商品的数量限制
      *

package/dist/model/strategy/adapter/itemRule/type.d.ts

@@ -4,6 +4,8 @@ export declare const ITEM_RULE_ACTION_TYPES: {
     readonly QUANTITY_CHECK: "QUANTITY_CHECK";
     /** 预填购物车 */
     readonly PREFILL_CART: "PREFILL_CART";
+    /** 加购前过敏信息确认 */
+    readonly ALLERGY_CHECK: "ALLERGY_CHECK";
 };
 export type ItemRuleActionType = (typeof ITEM_RULE_ACTION_TYPES)[keyof typeof ITEM_RULE_ACTION_TYPES];
 export declare const ITEM_RULE_TEMPLATES: {
@@ -63,6 +65,42 @@ export interface TargetItem {
     /** 变体 ID */
     product_variant_id?: number;
 }
+/** 策略展示文案，可由调用方按当前 locale 解析。 */
+export type ItemRuleLocalizedText = string | Record<string, string>;
+/** 内联过敏源选项。稳定 id 用于保存选择，label 只负责展示。 */
+export interface AllergyDataSourceItem {
+    id: string;
+    label: ItemRuleLocalizedText;
+}
+/** 当前仅支持随策略下发的内联过敏源。 */
+export interface AllergyDataSource {
+    type: 'inline';
+    items: AllergyDataSourceItem[];
+}
+/** 每个目标商品独立持有自己的过敏源，禁止跨商品合并。 */
+export interface AllergyTargetItem extends TargetItem {
+    dataSource: AllergyDataSource;
+}
+export type AllergyPromptScope = 'once_per_order_product';
+/** ALLERGY_CHECK Action 的商品级配置。 */
+export interface AllergyCheckConfig {
+    targetType: 'product';
+    targets: AllergyTargetItem[];
+    promptScope: AllergyPromptScope;
+    allowNote?: boolean;
+}
+/** 当前商品命中的单条过敏门禁要求。 */
+export interface AllergyRequirement {
+    strategyId: string;
+    ruleId: string;
+    priority: number;
+    targetType: 'product';
+    product_id: number;
+    product_variant_id?: number;
+    dataSource: AllergyDataSource;
+    promptScope: AllergyPromptScope;
+    allowNote: boolean;
+}
 /**
  * 预填商品项
  */
@@ -119,6 +157,10 @@ export interface ItemRuleBusinessData {
     historicalItems?: CartItemSummary[];
     /** 服务类型（如 'dine-in', 'takeaway'） */
     serviceType?: string;
+    /** 当前业务渠道（如 'kiosk', 'pos', 'online_store'） */
+    channel?: string;
+    /** 当前正在加入购物车的商品；ALLERGY_CHECK 只读取该商品的 Target。 */
+    currentProduct?: Pick<TargetItem, 'product_id' | 'product_variant_id'>;
     /** 当前提交次数（0=首次提交, >0=追加提交） */
     submissionIndex?: number;
     /** 策略配置列表（可选，如果不传则使用 setStrategyConfigs 设置的） */
@@ -216,6 +258,8 @@ export interface ItemRuleEvaluationResult {
     quantityChecks: QuantityCheckResult[];
     /** 需要预填的商品列表 */
     prefillItems: PrefillItemResult[];
+    /** 当前商品命中的过敏门禁要求；不同 Action/商品不会合并。 */
+    allergyRequirements: AllergyRequirement[];
     /** 所有校验是否全部通过 */
     allPassed: boolean;
     /** 未通过的校验列表 */

package/dist/model/strategy/adapter/itemRule/type.js

@@ -6,7 +6,9 @@ export var ITEM_RULE_ACTION_TYPES = {
   /** 数量校验 */
   QUANTITY_CHECK: 'QUANTITY_CHECK',
   /** 预填购物车 */
-  PREFILL_CART: 'PREFILL_CART'
+  PREFILL_CART: 'PREFILL_CART',
+  /** 加购前过敏信息确认 */
+  ALLERGY_CHECK: 'ALLERGY_CHECK'
 };
 // ============================================
 // Rule Template 类型（创建规则时的起始模板）
@@ -50,6 +52,22 @@ export var ITEM_RULE_TEMPLATES = {
 
 /** 目标项 */
 
+// ============================================
+// Allergy Check 相关类型
+// ============================================
+
+/** 策略展示文案，可由调用方按当前 locale 解析。 */
+
+/** 内联过敏源选项。稳定 id 用于保存选择，label 只负责展示。 */
+
+/** 当前仅支持随策略下发的内联过敏源。 */
+
+/** 每个目标商品独立持有自己的过敏源，禁止跨商品合并。 */
+
+/** ALLERGY_CHECK Action 的商品级配置。 */
+
+/** 当前商品命中的单条过敏门禁要求。 */
+
 // ============================================
 // Prefill Cart 相关类型
 // ============================================

package/dist/model/strategy/adapter/promotion/index.js

@@ -0,0 +1,9 @@
+// 导出评估器
+export { PromotionEvaluator } from "./evaluator";
+
+// 导出适配器
+export { PromotionAdapter } from "./adapter";
+export { default } from "./adapter";
+
+// 导出策略配置示例常量
+export { X_ITEMS_FOR_Y_PRICE_STRATEGY, BUY_X_GET_Y_FREE_STRATEGY, ITEM_REWARD_STRATEGY } from "./examples";

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

@@ -3,7 +3,7 @@ import { BaseModule } from '../BaseModule';
 import { OrderModuleAPI, CommitOrderParams, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, CancelOrderParams, ChangeBookingStatusParams, CheckoutOrderParams } from './types';
 import { CartItem } from '../Cart/types';
 import { type SubmitPayloadEnhancer } from './utils';
-import type { OrderAmountSnapshot, AddProductBookingInput, AddProductToOrderOptions, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions } from './types';
+import type { OrderAmountSnapshot, AddProductBookingInput, AddProductToOrderOptions, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, SalesNote, SalesNotesMutationSnapshot, SetSalesNoteInput, PickupReferenceMode, ShopServiceData, ShopServiceType } from './types';
 import type { ICustomer } from '../AccountList/types';
 import type { Discount } from '../Discount/types';
 import { UnavailableReason } from '../Rules/types';
@@ -299,9 +299,24 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     updateTempOrderNote(note: string, sync: boolean): string | Promise<string>;
     syncTempOrderNoteToRemote(orderId: number | string, note: string): Promise<string>;
     getTempOrderNote(): string;
+    private ensureSalesNotesRuntimeState;
+    private ensureSalesNotesLoadedForMutation;
+    private normalizeSalesNoteUuid;
+    private getSalesNotePrimaryRelation;
+    private removeSalesNotesForMissingProductLines;
+    private setSalesNoteOnTempOrder;
+    getSalesNotes(): SalesNote[];
+    createSalesNotesMutationSnapshot(): SalesNotesMutationSnapshot;
+    restoreSalesNotesMutationSnapshot(snapshot: SalesNotesMutationSnapshot): void;
+    setSalesNote(input: SetSalesNoteInput): Promise<SalesNote>;
+    removeSalesNote(uuid: string): Promise<void>;
+    clearSalesNotes(): Promise<void>;
     updateTempOrderShopDiscount(amount: string | number): string;
     updateTempOrderDepositAmount(amount: string | number): OrderSummary;
     updateTempOrderBuzzer(buzzer: string): string;
+    private updateTempOrderShopServiceData;
+    updateTempOrderPickupReferenceMode(mode: PickupReferenceMode): ShopServiceData;
+    updateTempOrderServiceType(serviceType: ShopServiceType): ShopServiceData;
     updateTempOrderContactsInfo(contactsInfo: Record<string, any> | null): Record<string, any> | null;
     private buildTempOrderCustomer;
     private isCustomerBoundDiscount;
@@ -452,7 +467,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     removeProductFromOrder(identity: OrderProductIdentity, options?: RemoveProductsFromOrderOptions): Promise<OrderProduct[]>;
     /**
      * 仅清空购物车行（products / bookings），不重置整单。
-     * 用于「仅清空商品」；客户、备注、支付等协议字段保持不变。
+     * 普通整单 note 保持不变；以商品行为主体的 Sales Notes 同步删除。
      */
     clearOrderCartLines(): Promise<OrderTempOrder>;
     buildCurrentSubmitPayloadForLocalPrint(params?: {
@@ -589,4 +604,4 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     getOrderInfo(order_id: number): Promise<any>;
     getVouchers(): any[];
 }
-export type { AddProductToOrderOptions, RemoveProductsFromOrderOptions, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, } from './types';
+export type { AddProductToOrderOptions, RemoveProductsFromOrderOptions, SalesNote, SalesNoteDraftInput, SalesNoteLocalizedSelection, SalesNoteLocalizedText, SalesNoteRelation, SalesNoteTextInput, SetSalesNoteInput, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, } from './types';