@pisell/pisellos 2.2.291 → 2.2.293

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

@@ -1,9 +0,0 @@
-// 导出评估器
-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/BookingContext/index.d.ts

@@ -19,12 +19,15 @@ export declare class BookingContextModule extends BaseModule implements Module,
     protected defaultVersion: string;
     private request;
     private store;
+    private otherParams;
     /** 上次成功 loadBookingConfig 的 query key；命中则不再请求。 */
     private lastConfigQueryKey;
     /** 上次成功 loadResources 的 query key（date|bookingIds）；命中则不再请求。 */
     private lastResourcesQueryKey;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
+    /** 同步父级解决方案的运行态参数；platform 变化后会自然切换 config endpoint/cache key。 */
+    updateOtherParams(params: Record<string, any>): void;
     loadBookingConfig(params?: LoadBookingConfigParams, options?: {
         forceRefresh?: boolean;
     }): Promise<BookingContextConfig | null>;

package/dist/modules/BookingContext/index.js

@@ -26,6 +26,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 import dayjs from 'dayjs';
 import { BaseModule } from "../BaseModule";
 import { RequestModeENUM } from "../../plugins/request";
+import { normalizeRuntimePlatform } from "../../utils/platform";
 import { BookingContextEvent } from "./types";
 import { formatResourceListAndMap } from "./utils/formatResourceList";
 export * from "./types";
@@ -40,6 +41,8 @@ var DEFAULT_BOOKING_CONFIG_PARAMS = {
   item_type: 'appointment_booking',
   sub_type: 'ticket'
 };
+var BOOKING_CONFIG_ENDPOINT = '/core/board/management/config';
+var H5_BOOKING_CONFIG_ENDPOINT = '/core/board/config';
 var BOARD_CONFIG_CACHE = {
   useCache: true,
   cache: {
@@ -153,6 +156,24 @@ export function buildBookingConfigQueryKey() {
   });
   return JSON.stringify(sorted);
 }
+function resolveBookingConfigRequest(platform) {
+  var params = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var isH5 = normalizeRuntimePlatform(platform) === 'h5';
+  var endpoint = isH5 ? H5_BOOKING_CONFIG_ENDPOINT : BOOKING_CONFIG_ENDPOINT;
+  var query = isH5 ? {
+    item_type: params.item_type || DEFAULT_BOOKING_CONFIG_PARAMS.item_type
+  } : _objectSpread(_objectSpread({}, DEFAULT_BOOKING_CONFIG_PARAMS), params);
+  var keys = Object.keys(query).sort();
+  var sortedQuery = {};
+  keys.forEach(function (key) {
+    sortedQuery[key] = query[key];
+  });
+  return {
+    endpoint: endpoint,
+    query: query,
+    key: "".concat(endpoint, ":").concat(JSON.stringify(sortedQuery))
+  };
+}
 
 /** 稳定序列化资源列表查询（date + bookingIds），用于跳过重复 loadResources。 */
 export function buildBookingResourcesQueryKey() {
@@ -176,6 +197,7 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
     _defineProperty(_assertThisInitialized(_this), "defaultVersion", '1.0.0');
     _defineProperty(_assertThisInitialized(_this), "request", void 0);
     _defineProperty(_assertThisInitialized(_this), "store", _objectSpread({}, EMPTY_STATE));
+    _defineProperty(_assertThisInitialized(_this), "otherParams", {});
     /** 上次成功 loadBookingConfig 的 query key；命中则不再请求。 */
     _defineProperty(_assertThisInitialized(_this), "lastConfigQueryKey", null);
     /** 上次成功 loadResources 的 query key（date|bookingIds）；命中则不再请求。 */
@@ -201,6 +223,7 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
               }
               throw new Error('BookingContextModule 需要 request 插件支持');
             case 5:
+              this.otherParams = options.otherParams || {};
               this.store = {
                 bookingConfig: null,
                 resourcesOrigin: [],
@@ -218,7 +241,7 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
               if (initialState.date) {
                 this.store.date = initialState.date;
               }
-            case 10:
+            case 11:
             case "end":
               return _context.stop();
           }
@@ -228,16 +251,22 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
         return _initialize.apply(this, arguments);
       }
       return initialize;
-    }()
+    }() /** 同步父级解决方案的运行态参数；platform 变化后会自然切换 config endpoint/cache key。 */
+  }, {
+    key: "updateOtherParams",
+    value: function updateOtherParams(params) {
+      this.otherParams = params || {};
+    }
   }, {
     key: "loadBookingConfig",
     value: function () {
       var _loadBookingConfig = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
-        var _this2 = this;
+        var _this$otherParams,
+          _this2 = this;
         var params,
           options,
+          requestConfig,
           configKey,
-          query,
           sharedKey,
           _sharedBookingConfigC,
           cached,
@@ -250,14 +279,14 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
             case 0:
               params = _args3.length > 0 && _args3[0] !== undefined ? _args3[0] : {};
               options = _args3.length > 1 && _args3[1] !== undefined ? _args3[1] : {};
-              configKey = buildBookingConfigQueryKey(params);
+              requestConfig = resolveBookingConfigRequest((_this$otherParams = this.otherParams) === null || _this$otherParams === void 0 ? void 0 : _this$otherParams.platform, params);
+              configKey = requestConfig.key;
               if (!(!options.forceRefresh && this.store.bookingConfig != null && this.lastConfigQueryKey === configKey)) {
-                _context3.next = 5;
+                _context3.next = 6;
                 break;
               }
               return _context3.abrupt("return", this.store.bookingConfig);
-            case 5:
-              query = _objectSpread(_objectSpread({}, DEFAULT_BOOKING_CONFIG_PARAMS), params);
+            case 6:
               sharedKey = buildSharedCacheKey(this.request, configKey);
               if (!(!options.forceRefresh && sharedBookingConfigCache.has(sharedKey))) {
                 _context3.next = 12;
@@ -277,7 +306,7 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
                       case 0:
                         _context2.prev = 0;
                         _context2.next = 3;
-                        return _this2.request.get('/core/board/management/config', query, BOARD_CONFIG_CACHE);
+                        return _this2.request.get(requestConfig.endpoint, requestConfig.query, BOARD_CONFIG_CACHE);
                       case 3:
                         res = _context2.sent;
                         _config = (_res$data = res === null || res === void 0 ? void 0 : res.data) !== null && _res$data !== void 0 ? _res$data : null;
@@ -411,9 +440,9 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "isBookingContextReady",
     value: function isBookingContextReady() {
-      var _ref3, _params$date2;
+      var _this$otherParams2, _ref3, _params$date2;
       var params = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-      var configKey = buildBookingConfigQueryKey(params.bookingConfigParams);
+      var configKey = resolveBookingConfigRequest((_this$otherParams2 = this.otherParams) === null || _this$otherParams2 === void 0 ? void 0 : _this$otherParams2.platform, params.bookingConfigParams).key;
       var dateInput = (_ref3 = (_params$date2 = params.date) !== null && _params$date2 !== void 0 ? _params$date2 : this.store.date) !== null && _ref3 !== void 0 ? _ref3 : dayjs();
       var queryDate = toScheduleQueryDate(dateInput);
       var resourcesKey = buildBookingResourcesQueryKey({
@@ -428,7 +457,7 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
     key: "initBookingContext",
     value: function () {
       var _initBookingContext = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6() {
-        var _ref4, _params$date3;
+        var _ref4, _params$date3, _this$otherParams3;
         var params,
           dateInput,
           queryDate,
@@ -450,7 +479,7 @@ export var BookingContextModule = /*#__PURE__*/function (_BaseModule) {
               }
               return _context6.abrupt("return", this.getState());
             case 6:
-              configKey = buildBookingConfigQueryKey(params.bookingConfigParams);
+              configKey = resolveBookingConfigRequest((_this$otherParams3 = this.otherParams) === null || _this$otherParams3 === void 0 ? void 0 : _this$otherParams3.platform, params.bookingConfigParams).key;
               resourcesKey = buildBookingResourcesQueryKey({
                 date: queryDate,
                 bookingIds: params.bookingIds

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

@@ -1,7 +1,7 @@
 /**
  * BookingContext 子模块：承载「预约 UI 上下文」三件套。
  *
- *  - bookingConfig：来自 `/core/board/management/config` 的整套预约配置（service_time / resource_tab /
+ *  - bookingConfig：来自 staff `/core/board/management/config` 或 H5 `/core/board/config` 的整套预约配置（service_time / resource_tab /
  *    appointment_subject / subject_require / stock_setting / basic / capacity 等）。
  *  - resourcesOrigin / resourcesOriginMap：来自 `/schedule/resource/list` 的资源全集，含 times / event_list /
  *    combined_resource 等运行态信息，是 getResourceByIds / getResourceTimeIsUsable 的输入。
@@ -11,7 +11,7 @@
  *  - 默认由 `loadBookingConfig` / `loadResources` 拉取并写入 store；也支持消费方 `set*` 直接灌入（复用 ticketBooking 已拉到的数据）。
  *  - 所有读 API 返回浅克隆（数组）或原引用（map / config），避免 UI 写穿。
  */
-/** `loadBookingConfig` 入参，与 ticketBooking `getBookingConfig` 一致。 */
+/** `loadBookingConfig` 入参；H5 公共接口只消费 `item_type`。 */
 export interface LoadBookingConfigParams {
     item_type?: string;
     sub_type?: string;
@@ -42,7 +42,7 @@ export interface InitBookingContextParams {
 export type BookingContextResource = Record<string, any>;
 export type BookingContextResourceMap = Record<string, BookingContextResource>;
 /**
- * 形参 booking_config（结构来自 `/core/board/management/config` 接口）。
+ * 形参 booking_config（结构来自 staff management 或 H5 board config 接口的 `data`）。
  * OS 不强制 schema，保留 `Record<string, any>` 兼容现网；常用路径文档化在 SDK docs。
  */
 export type BookingContextConfig = Record<string, any>;
@@ -80,7 +80,7 @@ export interface BookingContextModuleAPI {
     getState(): BookingContextState;
     /** 一键清空，destroy / 切租户场景用。 */
     clear(): void;
-    /** 拉取 board config 并写入 store（`/core/board/management/config`）。 */
+    /** 按运行平台拉取 board config 并写入 store。 */
     loadBookingConfig(params?: LoadBookingConfigParams): Promise<BookingContextConfig | null>;
     /** 拉取资源全集并写入 store（`/schedule/resource/list`）。 */
     loadResources(params?: LoadBookingResourcesParams): Promise<BookingContextResource[]>;

package/dist/modules/BookingContext/types.js

@@ -1,7 +1,7 @@
 /**
  * BookingContext 子模块：承载「预约 UI 上下文」三件套。
  *
- *  - bookingConfig：来自 `/core/board/management/config` 的整套预约配置（service_time / resource_tab /
+ *  - bookingConfig：来自 staff `/core/board/management/config` 或 H5 `/core/board/config` 的整套预约配置（service_time / resource_tab /
  *    appointment_subject / subject_require / stock_setting / basic / capacity 等）。
  *  - resourcesOrigin / resourcesOriginMap：来自 `/schedule/resource/list` 的资源全集，含 times / event_list /
  *    combined_resource 等运行态信息，是 getResourceByIds / getResourceTimeIsUsable 的输入。
@@ -12,7 +12,7 @@
  *  - 所有读 API 返回浅克隆（数组）或原引用（map / config），避免 UI 写穿。
  */
 
-/** `loadBookingConfig` 入参，与 ticketBooking `getBookingConfig` 一致。 */
+/** `loadBookingConfig` 入参；H5 公共接口只消费 `item_type`。 */
 
 /** `loadResources` 入参，与 info2 `getResourceList` 一致。 */
 
@@ -24,7 +24,7 @@
  */
 
 /**
- * 形参 booking_config（结构来自 `/core/board/management/config` 接口）。
+ * 形参 booking_config（结构来自 staff management 或 H5 board config 接口的 `data`）。
  * OS 不强制 schema，保留 `Record<string, any>` 兼容现网；常用路径文档化在 SDK docs。
  */
 

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

@@ -23,6 +23,7 @@ export interface OpenDataConfig {
     'reservation.auto_confirm'?: boolean;
     'reservation.auto_confirm_mode'?: string;
     'reservation.auto_confirm_delay_seconds'?: number;
+    'reservation.time_slice'?: number | string;
     'sale.allow_item_notes'?: boolean;
     'sale.allow_order_notes'?: boolean;
     'sale.enable_item_rules'?: boolean;

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';
@@ -301,9 +301,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;
@@ -454,7 +469,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?: {
@@ -591,4 +606,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';