@pisell/pisellos 2.2.230 → 2.2.232

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

@@ -1,49 +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,
-  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,
-  PromotionAdapter,
-  PromotionEvaluator,
-  X_ITEMS_FOR_Y_PRICE_STRATEGY
-});

package/lib/modules/Order/index.js

@@ -534,6 +534,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * - 不主动调用 applyDiscount / recalculateSummary，调用方负责跟进。
    */
   async applyPromotion() {
+    var _a;
     if (this.isApplyingPromotion) {
       return;
     }
@@ -585,27 +586,39 @@ var OrderModule = class extends import_BaseModule.BaseModule {
             if (addAction.giftOptions.length === 1) {
               const sameStrategy = result.products.find(
                 (p) => {
-                  var _a, _b;
-                  return ((_b = (_a = p.metadata) == null ? void 0 : _a._giftInfo) == null ? void 0 : _b.strategyId) === addAction.strategyId;
+                  var _a2, _b;
+                  return ((_b = (_a2 = p.metadata) == null ? void 0 : _a2._giftInfo) == null ? void 0 : _b.strategyId) === addAction.strategyId;
                 }
               );
-              if (sameStrategy) {
+              if (sameStrategy && !sameStrategy.booking_uid && !((_a = sameStrategy.metadata) == null ? void 0 : _a.booking_uid)) {
                 sameStrategy.num = (Number(sameStrategy.num) || 0) + (addAction.giftCount || 1);
                 continue;
               }
             }
             try {
-              const giftProducts = await this.giftSelectResolver({
+              const giftResult = await this.giftSelectResolver({
                 strategyId: addAction.strategyId,
                 strategyName: addAction.strategyName,
                 giftCount: addAction.giftCount,
                 giftOptions: addAction.giftOptions,
                 sourceProductIds: addAction.sourceProductIds
               });
+              const giftProducts = Array.isArray(giftResult) ? giftResult : giftResult == null ? void 0 : giftResult.products;
+              const giftBookings = Array.isArray(giftResult) ? [] : (giftResult == null ? void 0 : giftResult.bookings) || [];
               if (Array.isArray(giftProducts) && giftProducts.length > 0) {
-                for (const gp of giftProducts) {
+                for (const [index, gp] of giftProducts.entries()) {
                   if (!gp)
                     continue;
+                  const booking = giftBookings[index];
+                  if (booking) {
+                    const linked = this.createLinkedProductAndBooking({
+                      product: gp,
+                      booking
+                    });
+                    result.products.push(linked.product);
+                    tempOrder.bookings = [...tempOrder.bookings || [], linked.booking];
+                    continue;
+                  }
                   result.products.push(gp);
                 }
               }

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

@@ -47,6 +47,18 @@ export interface OrderGiftSelectContext {
     /** 触发此赠品的主商品 metadata.unique_identification_number 列表 */
     sourceProductIds: string[];
 }
+/**
+ * 赠品 resolver 返回值。
+ *
+ * @example
+ * return { products: [giftProduct], bookings: [giftBooking] };
+ */
+export interface OrderGiftSelectResult {
+    /** 完整赠品购物车行，必须带 metadata._giftInfo。 */
+    products: Partial<OrderProduct>[];
+    /** 预约赠品对应的 booking，按 products 下标一一关联。 */
+    bookings?: AddProductBookingInput[];
+}
 /**
  * 赠品解析回调签名（SDK → OS 的返回值）。
  *
@@ -54,9 +66,9 @@ export interface OrderGiftSelectContext {
  * - 多选项：SDK 弹窗等用户确认后构造
  * - 用户取消：抛错或返回空数组（OS 视为放弃本次添加）
  *
- * 返回的 OrderProduct 必须是完整的购物车行（含 metadata._giftInfo 标记），OS 会直接 push 入 tempOrder.products。
+ * 返回数组时沿用旧协议，只写 tempOrder.products；返回对象时可同时写入预约 bookings。
  */
-export type OrderGiftSelectResolver = (ctx: OrderGiftSelectContext) => Promise<Partial<OrderProduct>[] | null>;
+export type OrderGiftSelectResolver = (ctx: OrderGiftSelectContext) => Promise<Partial<OrderProduct>[] | OrderGiftSelectResult | null>;
 /** 未满足的促销策略（购物车底部 alert 渲染源） */
 export interface OrderUnfulfilledPromotion {
     strategyId: string;

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

@@ -1,5 +1,6 @@
 import { Module, PisellCore } from '../../types';
 import { BaseModule } from '../BaseModule';
+import { ProductListLoadProductsParams } from './types';
 import { ProductData } from '../Product/types';
 export * from './types';
 export declare class ProductList extends BaseModule implements Module {
@@ -18,18 +19,14 @@ export declare class ProductList extends BaseModule implements Module {
      */
     updateOtherParams(params: Record<string, any>): void;
     storeChange(path?: string, value?: any): Promise<void>;
-    loadProducts({ category_ids, product_ids, collection, menu_list_ids, customer_id: paramsCustomerId, with_count, schedule_datetime, schedule_date, cacheId, with_schedule, }: {
-        category_ids?: number[];
-        product_ids?: number[];
-        collection?: number | string[];
-        schedule_date?: string;
-        cacheId?: string;
-        customer_id?: number;
-        menu_list_ids?: number[];
-        schedule_datetime?: string;
-        with_count?: string[];
-        with_schedule?: number;
-    }, options?: {
+    /**
+     * 获取加时商品列表。
+     *
+     * @example
+     * const products = await productList.getAddTimeProducts({ schedule_date: '2026-06-16' });
+     */
+    getAddTimeProducts(params?: ProductListLoadProductsParams): Promise<any>;
+    loadProducts({ category_ids, product_ids, collection, menu_list_ids, customer_id: paramsCustomerId, with_count, schedule_datetime, schedule_date, cacheId, with_schedule, extension_type, status, }?: ProductListLoadProductsParams, options?: {
         callback?: (result: any) => void;
         subscriberId?: string;
     }): Promise<any>;

package/lib/modules/ProductList/index.js

@@ -1,6 +1,8 @@
+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)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+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/modules/ProductList/index.ts
@@ -25,6 +35,7 @@ __export(ProductList_exports, {
 module.exports = __toCommonJS(ProductList_exports);
 var import_BaseModule = require("../BaseModule");
 var import_lodash_es = require("lodash-es");
+var import_dayjs = __toESM(require("dayjs"));
 __reExport(ProductList_exports, require("./types"), module.exports);
 var ProductList = class extends import_BaseModule.BaseModule {
   constructor(name, version) {
@@ -58,6 +69,20 @@ var ProductList = class extends import_BaseModule.BaseModule {
   }
   async storeChange(path, value) {
   }
+  /**
+   * 获取加时商品列表。
+   *
+   * @example
+   * const products = await productList.getAddTimeProducts({ schedule_date: '2026-06-16' });
+   */
+  async getAddTimeProducts(params = {}) {
+    return this.loadProducts({
+      schedule_date: (0, import_dayjs.default)().format("YYYY-MM-DD"),
+      status: "published",
+      ...params,
+      extension_type: ["product_add_time"]
+    });
+  }
   async loadProducts({
     category_ids = [],
     product_ids = [],
@@ -68,8 +93,10 @@ var ProductList = class extends import_BaseModule.BaseModule {
     schedule_datetime,
     schedule_date,
     cacheId,
-    with_schedule
-  }, options) {
+    with_schedule,
+    extension_type,
+    status = "published"
+  } = {}, options) {
     var _a, _b;
     let userPlugin = this.core.getPlugin("user");
     let customer_id = void 0;
@@ -92,7 +119,7 @@ var ProductList = class extends import_BaseModule.BaseModule {
           "event_item"
         ],
         with: ["category", "collection", "resourceRelation"],
-        status: "published",
+        status,
         num: 500,
         skip: 1,
         customer_id,
@@ -107,7 +134,8 @@ var ProductList = class extends import_BaseModule.BaseModule {
         application_code: (_b = this.otherParams) == null ? void 0 : _b.channel,
         is_eject: 1,
         with_schedule,
-        schedule_datetime
+        schedule_datetime,
+        extension_type
       },
       { osServer: true, callback: options == null ? void 0 : options.callback, subscriberId: options == null ? void 0 : options.subscriberId, customToast: () => {
       } }

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

@@ -1,4 +1,18 @@
 import { ProductData } from '../Product/types';
+export interface ProductListLoadProductsParams {
+    category_ids?: number[];
+    product_ids?: number[];
+    collection?: number | string[];
+    schedule_date?: string;
+    cacheId?: string;
+    customer_id?: number;
+    menu_list_ids?: number[];
+    schedule_datetime?: string;
+    with_count?: string[];
+    with_schedule?: number;
+    extension_type?: string[];
+    status?: string;
+}
 export interface ProductListData {
     list: ProductData[];
     selectProducts: ProductData[];

package/lib/server/index.d.ts

@@ -496,6 +496,27 @@ declare class Server {
      * 从订单中展开 bookings，再按条件筛选 + 分页
      */
     private computeBookingQueryResult;
+    /**
+     * 规范商品扩展类型过滤参数。
+     *
+     * @example
+     * const types = this.normalizeProductExtensionTypes(['product_add_time']);
+     */
+    private normalizeProductExtensionTypes;
+    /**
+     * 请求包含 product_add_time 时，按传入 extension_type 数组配置过滤商品。
+     *
+     * @example
+     * const list = this.filterProductsByExtensionTypes(products, ['product_add_time']);
+     */
+    private filterProductsByExtensionTypes;
+    /**
+     * 判断本次查询是否需要跳过餐牌过滤，直接按扩展类型拉商品。
+     *
+     * @example
+     * const skipMenu = this.shouldQueryProductsByExtensionTypes(['product_add_time']);
+     */
+    private shouldQueryProductsByExtensionTypes;
     /**
      * 商品查询的核心计算逻辑（编排 Products、Menu、Schedule 模块）
      * 供 handleProductQuery 首次返回及 pubsub 变更推送复用

package/lib/server/index.js

@@ -208,26 +208,27 @@ var Server = class {
      */
     this.handleProductQuery = async ({ url, method, data, config }) => {
       console.log("[Server] handleProductQuery:", url, method, data, config);
-      const { menu_list_ids, schedule_datetime, schedule_date, customer_id, ids } = data;
+      const { menu_list_ids, schedule_datetime, schedule_date, customer_id, ids, extension_type } = data;
       const { callback, subscriberId } = config || {};
       this.logInfo("handleProductQuery: 开始处理商品查询请求", {
         menu_list_ids,
         ids,
         schedule_datetime,
         schedule_date,
-        customer_id
+        customer_id,
+        extension_type
       });
       if (subscriberId && typeof callback === "function") {
         this.productQuerySubscribers.set(subscriberId, {
           callback,
-          context: { menu_list_ids, ids, schedule_date, schedule_datetime, customer_id }
+          context: { menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type }
         });
         this.logInfo("handleProductQuery: 已注册订阅者", {
           subscriberId,
           totalSubscribers: this.productQuerySubscribers.size
         });
       }
-      return this.computeProductQueryResult({ menu_list_ids, ids, schedule_date, schedule_datetime, customer_id });
+      return this.computeProductQueryResult({ menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type });
     };
     /**
      * 按商品 id 查询单条（GET /shop/product/query/:productId）
@@ -2573,6 +2574,7 @@ var Server = class {
     if (!(0, import_small_ticket.hasSmallTicketData)((_a = printableOrder.payment_info) == null ? void 0 : _a.small_ticket_data)) {
       return { printed: false, order: printableOrder };
     }
+    debugger;
     await this.dispatchPrintOtherReceiptTask({
       checkoutData: params.checkoutData,
       syncedOrder: printableOrder,
@@ -3470,6 +3472,38 @@ var Server = class {
       status: true
     };
   }
+  /**
+   * 规范商品扩展类型过滤参数。
+   *
+   * @example
+   * const types = this.normalizeProductExtensionTypes(['product_add_time']);
+   */
+  normalizeProductExtensionTypes(extension_type) {
+    if (!Array.isArray(extension_type))
+      return [];
+    return extension_type.map((item) => String(item || "").trim()).filter(Boolean);
+  }
+  /**
+   * 请求包含 product_add_time 时，按传入 extension_type 数组配置过滤商品。
+   *
+   * @example
+   * const list = this.filterProductsByExtensionTypes(products, ['product_add_time']);
+   */
+  filterProductsByExtensionTypes(products, extension_type) {
+    const extensionTypes = this.normalizeProductExtensionTypes(extension_type);
+    if (!extensionTypes.includes("product_add_time"))
+      return products;
+    return products.filter((product) => extensionTypes.includes(String((product == null ? void 0 : product.extension_type) || "")));
+  }
+  /**
+   * 判断本次查询是否需要跳过餐牌过滤，直接按扩展类型拉商品。
+   *
+   * @example
+   * const skipMenu = this.shouldQueryProductsByExtensionTypes(['product_add_time']);
+   */
+  shouldQueryProductsByExtensionTypes(extension_type) {
+    return this.normalizeProductExtensionTypes(extension_type).includes("product_add_time");
+  }
   /**
    * 商品查询的核心计算逻辑（编排 Products、Menu、Schedule 模块）
    * 供 handleProductQuery 首次返回及 pubsub 变更推送复用
@@ -3479,7 +3513,7 @@ var Server = class {
    */
   async computeProductQueryResult(context, options) {
     const tTotal = performance.now();
-    const { menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, product_id } = context;
+    const { menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type, product_id } = context;
     const queryIds = Array.isArray(ids) ? ids.map((id) => Number(id)).filter((id) => Number.isFinite(id)) : [];
     this.logInfo("computeProductQueryResult 开始", {
       menuListIdsCount: (menu_list_ids == null ? void 0 : menu_list_ids.length) ?? 0,
@@ -3487,6 +3521,7 @@ var Server = class {
       schedule_datetime,
       schedule_date,
       customer_id,
+      extension_type,
       product_id,
       changedIds: options == null ? void 0 : options.changedIds
     });
@@ -3510,18 +3545,19 @@ var Server = class {
         ids: uniqueIds
       });
       const filteredProducts2 = productsWithPrice.filter((p) => uniqueIds.includes(Number(p == null ? void 0 : p.id))).filter((p) => ((p == null ? void 0 : p.status) || "published") === "published");
+      const extensionFilteredProducts = this.filterProductsByExtensionTypes(filteredProducts2, extension_type);
       (0, import_product.perfMark)("computeProductQueryResult", performance.now() - tTotal, {
         mode: "ids",
         ids: uniqueIds,
-        count: filteredProducts2.length
+        count: extensionFilteredProducts.length
       });
       this.logInfo("computeProductQueryResult 完成（ids）", {
         ids: uniqueIds,
-        count: filteredProducts2.length
+        count: extensionFilteredProducts.length
       });
       return {
         code: 200,
-        data: { list: filteredProducts2, count: filteredProducts2.length },
+        data: { list: extensionFilteredProducts, count: extensionFilteredProducts.length },
         message: "",
         status: true
       };
@@ -3538,7 +3574,10 @@ var Server = class {
         count: allProductsWithPrice.length,
         productId: pid
       });
-      const published = allProductsWithPrice.filter((p) => ((p == null ? void 0 : p.status) || "published") === "published");
+      const published = this.filterProductsByExtensionTypes(
+        allProductsWithPrice.filter((p) => ((p == null ? void 0 : p.status) || "published") === "published"),
+        extension_type
+      );
       const item = published.find((p) => Number(p.id) === pid) ?? null;
       (0, import_product.perfMark)("computeProductQueryResult", performance.now() - tTotal, {
         mode: "single",
@@ -3556,6 +3595,57 @@ var Server = class {
         status: true
       };
     }
+    if (this.shouldQueryProductsByExtensionTypes(extension_type)) {
+      const tPrice2 = performance.now();
+      let filteredProducts2 = await this.products.getProductsWithPrice(schedule_date, {
+        scheduleModule: this.getSchedule(),
+        schedule_datetime,
+        customer_id
+      }, {
+        changedIds: options == null ? void 0 : options.changedIds
+      });
+      (0, import_product.perfMark)("computeQuery.getProductsWithPrice(extensionType)", performance.now() - tPrice2, {
+        count: filteredProducts2.length,
+        extension_type
+      });
+      const tStatus2 = performance.now();
+      const beforeStatusCount2 = filteredProducts2.length;
+      filteredProducts2 = filteredProducts2.filter((p) => ((p == null ? void 0 : p.status) || "published") === "published");
+      (0, import_product.perfMark)("computeQuery.filterByStatus(extensionType)", performance.now() - tStatus2, {
+        before: beforeStatusCount2,
+        after: filteredProducts2.length
+      });
+      const tExtensionType2 = performance.now();
+      const beforeExtensionTypeCount2 = filteredProducts2.length;
+      filteredProducts2 = this.filterProductsByExtensionTypes(filteredProducts2, extension_type);
+      (0, import_product.perfMark)("computeQuery.filterByExtensionType(extensionType)", performance.now() - tExtensionType2, {
+        before: beforeExtensionTypeCount2,
+        after: filteredProducts2.length,
+        extension_type
+      });
+      const tSort2 = performance.now();
+      filteredProducts2 = filteredProducts2.sort((a, b) => {
+        const sortDiff = Number(b.sort) - Number(a.sort);
+        if (sortDiff !== 0)
+          return sortDiff;
+        return (a.title || "").localeCompare(b.title || "");
+      });
+      (0, import_product.perfMark)("computeQuery.sort(extensionType)", performance.now() - tSort2, { count: filteredProducts2.length });
+      (0, import_product.perfMark)("computeProductQueryResult", performance.now() - tTotal, {
+        mode: "extensionType",
+        filteredCount: filteredProducts2.length
+      });
+      this.logInfo("computeProductQueryResult 完成（extension_type）", {
+        filteredCount: filteredProducts2.length,
+        extension_type
+      });
+      return {
+        code: 200,
+        data: { list: filteredProducts2, count: filteredProducts2.length },
+        message: "",
+        status: true
+      };
+    }
     if (!this.menu) {
       this.logError("computeProductQueryResult: Menu 模块未注册");
       return { message: "Menu 模块未注册", data: { list: [], count: 0 } };
@@ -3605,6 +3695,14 @@ var Server = class {
       before: beforeStatusCount,
       after: filteredProducts.length
     });
+    const tExtensionType = performance.now();
+    const beforeExtensionTypeCount = filteredProducts.length;
+    filteredProducts = this.filterProductsByExtensionTypes(filteredProducts, extension_type);
+    (0, import_product.perfMark)("computeQuery.filterByExtensionType", performance.now() - tExtensionType, {
+      before: beforeExtensionTypeCount,
+      after: filteredProducts.length,
+      extension_type
+    });
     const tSort = performance.now();
     filteredProducts = filteredProducts.sort((a, b) => {
       const sortDiff = Number(b.sort) - Number(a.sort);

package/lib/server/utils/small-ticket.js

@@ -183,6 +183,7 @@ function buildProducts(order, locale, productMap) {
       currencySymbol,
       parentProduct
     });
+    const resolvedVariant = resolveProductVariantText({ product, parentProduct, locale });
     return {
       product_title: productTitle,
       product_quantity: quantity,
@@ -191,7 +192,7 @@ function buildProducts(order, locale, productMap) {
       total_original_price: formatMoney(new import_decimal.default(toMoneyNumber(originalPrice)).mul(quantity), currencySymbol),
       extension_list: Array.isArray(product.extension_list) ? product.extension_list : [],
       ...options.length ? { options } : {},
-      ...product.variant ? { variant: getLocalizedValue(product.variant, locale) } : {},
+      ...resolvedVariant ? { variant: resolvedVariant } : {},
       ...Array.isArray(product.combinations) ? { combinations: product.combinations } : combinations.length ? { combinations } : {}
     };
   });
@@ -267,6 +268,82 @@ function resolveProductFromMap(productId, productMap) {
     return null;
   return productMap[productId] || productMap[String(productId)] || null;
 }
+function resolveProductVariantText(params) {
+  const { product, parentProduct, locale } = params;
+  if (product.variant)
+    return getLocalizedValue(product.variant, locale);
+  if (!parentProduct)
+    return "";
+  const productVariantId = product.product_variant_id ?? product.variant_id;
+  if (!isNonZeroId(productVariantId))
+    return "";
+  const matchedVariant = normalizeArray(parentProduct.variant).find((variant) => isSameId(variant.id, productVariantId));
+  if (!matchedVariant)
+    return "";
+  const resolvedFromSkuKey = resolveVariantTextFromSkuKey({
+    skuKey: matchedVariant.sku_key,
+    parentProduct,
+    locale
+  });
+  if (resolvedFromSkuKey)
+    return resolvedFromSkuKey;
+  return resolveVariantTextFromNameMap({
+    nameMap: matchedVariant.name || matchedVariant.title,
+    parentProduct,
+    locale
+  });
+}
+function resolveVariantTextFromSkuKey(params) {
+  const skuKey = stringify(params.skuKey);
+  if (!skuKey)
+    return "";
+  return skuKey.split("_").map((item) => {
+    const [groupPositionId, itemPositionId] = item.split(":");
+    return resolveVariantTextItem({
+      parentProduct: params.parentProduct,
+      groupPositionId,
+      itemPositionId,
+      locale: params.locale
+    });
+  }).filter(Boolean).join(",");
+}
+function resolveVariantTextFromNameMap(params) {
+  if (!params.nameMap || typeof params.nameMap !== "object")
+    return "";
+  return Object.entries(params.nameMap).map(([groupPositionId, value]) => {
+    const group = resolveVariantGroup(params.parentProduct, groupPositionId);
+    if (!group)
+      return "";
+    const groupName = getLocalizedValue(group.name, params.locale);
+    const itemName = getLocalizedValue(value, params.locale);
+    if (!groupName || !itemName)
+      return "";
+    return `${groupName}:${itemName}`;
+  }).filter(Boolean).join(",");
+}
+function resolveVariantTextItem(params) {
+  const group = resolveVariantGroup(params.parentProduct, params.groupPositionId);
+  const item = resolveVariantItem(group, params.itemPositionId);
+  if (!group || !item)
+    return "";
+  const groupName = getLocalizedValue(group.name, params.locale);
+  const itemName = getLocalizedValue(item.name, params.locale);
+  if (!groupName || !itemName)
+    return "";
+  return `${groupName}:${itemName}`;
+}
+function resolveVariantGroup(parentProduct, groupPositionId) {
+  return normalizeArray(parentProduct.variant_group).find(
+    (group) => isSameId(group.position_id, groupPositionId) || isSameId(group.id, groupPositionId)
+  ) || null;
+}
+function resolveVariantItem(group, itemPositionId) {
+  if (!group)
+    return null;
+  return normalizeArray(group.variant_item).find(
+    (item) => isSameId(item.position_id, itemPositionId) || isSameId(item.id, itemPositionId)
+  ) || null;
+}
 function getProductTitleSource(source, locale) {
   if (!source || typeof source !== "object")
     return "";

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

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

@@ -121,6 +121,13 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
         callback?: (result: any) => void;
         subscriberId?: string;
     }): Promise<any>;
+    /**
+     * 获取加时商品列表。
+     *
+     * @example
+     * const products = await bookingTicket.getAddTimeProducts({ schedule_date: '2026-06-16' });
+     */
+    getAddTimeProducts(params?: ILoadProductsParams): Promise<ProductData[]>;
     /**
      * 只读查询单商品详情：走 ProductList 报价查询，但不写 productCatalog、
      * 不 emit onProductsLoaded、不修改 BookingDate。
@@ -312,7 +319,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 获取当前的客户搜索条件
      * @returns 当前搜索条件
      */
-    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "num" | "skip">;
+    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "skip" | "num">;
     /**
      * 获取客户列表状态（包含滚动加载相关状态）
      * @returns 客户状态
@@ -504,6 +511,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * ```
      */
     handleGlobalScanCode(code: string, bridge?: GlobalScanHostBridge): Promise<GlobalScanHandleResult>;
+    resolveBestAddTimePlan(addTimeProducts: any[], targetMinutes: number): any;
     /**
      * 销毁模块：先调用父类（销毁所有 store 内子模块 + emit destroy + super.destroy()），
      * 再清理 BookingTicket 自有资源（scan 监听 + scan 内存缓存）。