@pisell/pisellos 2.2.162 → 2.2.164

package/lib/solution/BaseSales/utils/quotationPrice.js

@@ -0,0 +1,201 @@
+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/solution/BaseSales/utils/quotationPrice.ts
+var quotationPrice_exports = {};
+__export(quotationPrice_exports, {
+  calculateBaseSalesProductBookingPrice: () => calculateBaseSalesProductBookingPrice
+});
+module.exports = __toCommonJS(quotationPrice_exports);
+var import_dayjs = __toESM(require("dayjs"));
+var import_decimal = __toESM(require("decimal.js"));
+function toFiniteNumber(value, fallback = 0) {
+  const parsedValue = Number(value);
+  if (!Number.isFinite(parsedValue))
+    return fallback;
+  return parsedValue;
+}
+function toPositiveInt(value, fallback = 1) {
+  const parsedValue = Math.floor(Number(value));
+  if (!Number.isFinite(parsedValue) || parsedValue < 1)
+    return fallback;
+  return parsedValue;
+}
+function toPriceString(value) {
+  return new import_decimal.default(Number(value) || 0).toDecimalPlaces(2).toFixed(2);
+}
+function normalizeDateTime(value) {
+  if (typeof value !== "string" || !value.trim())
+    return null;
+  const normalized = value.includes(":") ? value : `${value} 00:00:00`;
+  const datetime = (0, import_dayjs.default)(normalized);
+  if (!datetime.isValid())
+    return null;
+  return datetime;
+}
+function buildBookingDateTime(date, time) {
+  if (typeof date !== "string" || !date.trim())
+    return null;
+  const timeText = typeof time === "string" && time.trim() ? time.trim() : "00:00";
+  const datetime = (0, import_dayjs.default)(`${date.trim()} ${timeText}`);
+  if (!datetime.isValid())
+    return null;
+  return datetime;
+}
+function getDurationUnit(type) {
+  const normalizedType = String(type || "").toLowerCase();
+  if (normalizedType === "day" || normalizedType === "days")
+    return "day";
+  if (normalizedType === "minute" || normalizedType === "minutes")
+    return "minute";
+  return null;
+}
+function getProductId(product) {
+  const productId = toFiniteNumber(product.product_id ?? product.id, NaN);
+  if (!Number.isFinite(productId))
+    return null;
+  return productId;
+}
+function getProductVariantId(product) {
+  const variantId = toFiniteNumber(
+    product.product_variant_id ?? product.variant_id,
+    0
+  );
+  if (!Number.isFinite(variantId) || variantId <= 0)
+    return void 0;
+  return variantId;
+}
+function getFallbackPrice(params) {
+  const product = params.product || {};
+  return toPriceString(
+    params.fallback_price ?? product.price ?? product.selling_price ?? product.original_price ?? 0
+  );
+}
+function getProductQuantity(product) {
+  return toPositiveInt(product.num ?? product.quantity, 1);
+}
+function shouldSplitByDuration(duration, start, end) {
+  if (!duration)
+    return false;
+  if (!start || !end || !end.isAfter(start))
+    return false;
+  const unit = getDurationUnit(duration.type);
+  const value = toFiniteNumber(duration.value);
+  return !!unit && value > 0;
+}
+function buildTimeSegments(params) {
+  const booking = params.booking || {};
+  const explicitDatetime = normalizeDateTime(params.datetime);
+  const bookingStart = buildBookingDateTime(booking.start_date, booking.start_time);
+  const start = bookingStart || explicitDatetime || (0, import_dayjs.default)();
+  const bookingEnd = buildBookingDateTime(booking.end_date, booking.end_time);
+  if (!shouldSplitByDuration(params.duration, start, bookingEnd)) {
+    return [{ start }];
+  }
+  const unit = getDurationUnit(params.duration.type);
+  const value = toFiniteNumber(params.duration.value);
+  const segments = [];
+  let cursor = start;
+  let guard = 0;
+  while (cursor.isBefore(bookingEnd) && guard < 1e4) {
+    const next = cursor.add(value, unit);
+    segments.push({
+      start: cursor,
+      end: next.isBefore(bookingEnd) ? next : bookingEnd ?? void 0
+    });
+    cursor = next;
+    guard += 1;
+  }
+  return segments.length ? segments : [{ start }];
+}
+function formatTimePoint(datetime) {
+  return datetime.format("YYYY-MM-DD HH:mm:ss");
+}
+function buildPriceSegment(params) {
+  const timePoint = formatTimePoint(params.segment.start);
+  const quotedPrice = params.quotation && params.productId !== null ? params.quotation.getPriceForProduct({
+    productId: params.productId,
+    variantId: params.variantId,
+    datetime: timePoint,
+    customer_id: params.customerId
+  }) : null;
+  const unitPrice = toPriceString(quotedPrice ?? params.fallbackPrice);
+  const quotationShelfId = quotedPrice !== null && params.quotation && params.productId !== null ? params.quotation.getQuotationShelfId({
+    productId: params.productId,
+    variantId: params.variantId,
+    datetime: timePoint,
+    customer_id: params.customerId
+  }) : 0;
+  return {
+    start_datetime: timePoint,
+    end_datetime: params.segment.end ? formatTimePoint(params.segment.end) : void 0,
+    time_point: timePoint,
+    unit_price: unitPrice,
+    quantity: 1,
+    total_price: unitPrice,
+    quotation_shelf_id: quotationShelfId,
+    source: quotedPrice !== null ? "quotation" : "fallback"
+  };
+}
+function calculateBaseSalesProductBookingPrice(params) {
+  var _a;
+  const product = params.product || {};
+  const productId = getProductId(product);
+  const variantId = getProductVariantId(product);
+  const productQuantity = getProductQuantity(product);
+  const fallbackPrice = getFallbackPrice(params);
+  const segments = buildTimeSegments(params).map((segment) => buildPriceSegment({
+    quotation: params.quotation,
+    productId,
+    variantId,
+    customerId: params.customer_id,
+    fallbackPrice,
+    segment
+  }));
+  const unitPrice = segments.reduce(
+    (total, segment) => total.plus(segment.total_price),
+    new import_decimal.default(0)
+  );
+  const totalPrice = unitPrice.times(productQuantity);
+  const quotationShelfId = ((_a = segments.find((segment) => segment.quotation_shelf_id)) == null ? void 0 : _a.quotation_shelf_id) || 0;
+  return {
+    product_id: productId,
+    product_variant_id: variantId ?? 0,
+    customer_id: params.customer_id,
+    unit_price: unitPrice.toDecimalPlaces(2).toFixed(2),
+    total_price: totalPrice.toDecimalPlaces(2).toFixed(2),
+    quantity: productQuantity,
+    duration: params.duration,
+    quotation_shelf_id: quotationShelfId,
+    segments
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  calculateBaseSalesProductBookingPrice
+});

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

@@ -311,7 +311,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
         date: string;
         status: string;
         week: string;
-        weekNum: 0 | 1 | 5 | 4 | 2 | 3 | 6;
+        weekNum: 0 | 2 | 1 | 5 | 3 | 4 | 6;
     }[]>;
     submitTimeSlot(timeSlots: TimeSliceItem): void;
     private getScheduleDataByIds;
@@ -330,7 +330,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
         count: number;
         left: number;
         summaryCount: number;
-        status: "sold_out" | "lots_of_space" | "filling_up_fast";
+        status: "lots_of_space" | "filling_up_fast" | "sold_out";
     }[];
     /**
      * 找到多个资源的公共可用时间段

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

@@ -1,10 +1,15 @@
 import { Module, ModuleOptions, PisellCore } from '../../types';
 import { BookingTicketCartView, BookingTicketProductCatalogView, BookingTicketState, IGetCustomerListParams, ICustomer, ILoadProductsParams, ILoadProductDetailParams, IScanResult } from './types';
 import type { ProductData } from '../../modules';
+import { type BookingContextConfig, type BookingContextDateInput, type BookingContextResource, type BookingContextResourceMap, type BookingContextState, type InitBookingContextParams, type LoadBookingConfigParams, type LoadBookingResourcesParams, type ResourceError, type BookingCalcContext } from '../../modules/BookingContext';
 import type { OrderCustomerView } from '../../modules/Order/types';
 import { BaseSalesImpl } from '../BaseSales';
 import type { ISalesDetail } from '../BaseSales/utils/parseSalesResponse';
 import type { LoadSalesDetailParams } from '../../modules/Order/types';
+import { AddProductDecideContext, AddProductRequiresDetailPayload } from './utils/addProductDecision';
+import { type BuildCacheItemFromOrderLineInput } from '../../modules/BookingContext/utils/buildCacheItemFromOrderLine';
+import { type BuildNormalProductCacheItemFromOrderLineInput } from '../../modules/BookingContext/utils/buildNormalProductCacheItemFromOrderLine';
+import type { AddProductBookingInput, OrderProduct, OrderProductIdentity, UpdateOrderProductParams } from '../../modules/Order/types';
 export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
     protected defaultName: string;
     protected defaultVersion: string;
@@ -17,9 +22,11 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
     private scan;
     private productCatalog;
     /**
-     * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer。
+     * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer + bookingContext。
+     * bookingContext 是 SalesSdk 加车下沉所需的「预约 UI 上下文」（bookingConfig / resourcesOrigin / date）。
      */
     protected getRegisteredModuleNames(): readonly string[];
+    protected getSubmitOrderSalesChannel(): string;
     /**
      * 业务侧子模块工厂：BookingTicket 自带的 createBookingTicketModule 优先匹配；
      * 未识别的模块名（如 BookingByStep 公共类型）回退到父类工厂。
@@ -186,6 +193,16 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 清空下单客户（协议字段 + snapshot）。
      */
     clearOrderCustomer(): void;
+    /**
+     * 重置 tempOrder，并同步清空下单客户运行态。
+     *
+     * OrderModule.restoreOrder 会重建空单（customer_id 已为 null），但不会：
+     *  - emit BookingTicket `onOrderCustomerChange`
+     *  - 重置 CustomerModule.selectedCustomer（老路 getActiveCustomer）
+     *
+     * 因此在 super.restoreOrder 之后显式清客户，保证 SalesSdk / ticketBooking 订阅方与 tempOrder 一致。
+     */
+    restoreOrder(): Promise<import("../../modules/Order/types").OrderTempOrder>;
     /** 内部：基于 OrderModule 当前状态构造一份 OrderCustomerChangePayload。 */
     private buildOrderCustomerPayload;
     /**
@@ -291,6 +308,109 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * @returns 其他参数
      */
     getOtherParams(): Promise<Record<string, any>>;
+    /** 拉取 board config 并写入 BookingContext。 */
+    loadBookingConfig(params?: LoadBookingConfigParams): Promise<BookingContextConfig | null>;
+    /** 拉取资源全集并写入 BookingContext。 */
+    loadBookingResources(params?: LoadBookingResourcesParams): Promise<BookingContextResource[]>;
+    /** 初始化 BookingContext（date + config + resources）。 */
+    initBookingContext(params?: InitBookingContextParams): Promise<BookingContextState>;
+    /** 当前 store 是否已具备与入参等价的 config / resources（无需再请求接口）。 */
+    isBookingContextReady(params?: InitBookingContextParams): boolean;
+    /** 写入 booking config（来源：`/core/board/management/config`）。 */
+    setBookingConfig(config: BookingContextConfig | null): void;
+    /** 读取当前 booking config。 */
+    getBookingConfig(): BookingContextConfig | null;
+    /** 写入资源全集（来源：`/form/schedule`），同步派生 resourcesOriginMap。 */
+    setResources(resources: BookingContextResource[] | null | undefined): void;
+    /** 读取资源全集（浅克隆）。 */
+    getResourcesOrigin(): BookingContextResource[];
+    /** 读取资源全集 map（id → resource）。 */
+    getResourcesOriginMap(): BookingContextResourceMap;
+    /** 写入当前选择的日期；支持 dayjs / Date / string。 */
+    setBookingDate(date: BookingContextDateInput): void;
+    /** 读取当前选择的日期（统一 string）。 */
+    getBookingDate(): string | null;
+    /** 读取 BookingContext 完整 store（调试 / 测试 / 透传给 SDK 使用）。 */
+    getBookingContextState(): BookingContextState;
+    /** 清空 BookingContext（切租户 / destroy 场景）。 */
+    clearBookingContext(): void;
+    /**
+     * 构造 BookingContext 计算上下文（供 getProductExtend / getResourceByIds 等读 API 复用）。
+     */
+    private buildBookingCalcContext;
+    /**
+     * 取商品当前可选资源列表（透传 OS BookingContext utils#getResourceByIds）。
+     * `extraResources` 用于把拖入未绑定的资源也展示出来。
+     */
+    getResourcesForProduct(product: any, options?: {
+        extraResources?: Array<{
+            form_id: number | string;
+            id: number;
+        }>;
+    }): any[];
+    /**
+     * 拼装 cacheItem 的 _extend / _data（资源 / 容量 / timeObj），与 info2 `getProductExtend` 等价。
+     */
+    getProductExtend(cacheItem: any, extra?: Partial<BookingCalcContext>): any;
+    /**
+     * 取资源不可用原因列表（结构化 enum + params，i18n 文案由 UI 渲染）。
+     */
+    getResourceErrors(resource: any, cacheItem: any): ResourceError[];
+    /**
+     * 拼装 addProductDecision 通用上下文（从 store 自取）。
+     */
+    private buildAddProductCtx;
+    /**
+     * 加车两阶段主决策（规格弹窗 / 资源编辑 / 直接加车）。
+     * 与 ticketBooking `handleSelectProduct` + `handleBooking4Service` 等价。
+     */
+    decideAddProduct(item: any, options?: Partial<AddProductDecideContext>): import("./utils/addProductDecision").AddProductDecision;
+    /** 规格弹窗 callback 后的第二段决策。 */
+    decideAfterDetail(cacheItem: any, options?: Partial<AddProductDecideContext>): import("./utils/addProductDecision").AddProductDecision;
+    /**
+     * @deprecated 请用 `decideAddProduct`；`autoClose=true` 仅当 action=add。
+     */
+    decideAutoClose(item: any, options?: Partial<AddProductDecideContext>): {
+        autoClose: boolean;
+        cacheItem?: any;
+    };
+    /** 替代 info2 `getIsEject`：商品是否需要弹窗（0/1）。 */
+    getIsEject(item: any, type?: 'select' | 'detail'): 0 | 1;
+    /** 仅 session 商品（无 variant/option/package）→ true。 */
+    getIsOnlySession(item: any): boolean;
+    /**
+     * 拼装 requiresDetail payload（给 SDK 直接 return 给 UI 用）。
+     */
+    buildRequiresDetailPayload(item: any, options?: Partial<AddProductDecideContext>): AddProductRequiresDetailPayload;
+    /**
+     * 把 detail 弹窗回调结果（e, extension_type, detail）转换为 `(product, booking)` 入参。
+     * 内部会先拼 cacheItem，再走 cacheItemToBookingInput 严格协议对齐。
+     */
+    transformDetailToProductAndBooking(input: {
+        item: any;
+        cacheItem?: any;
+        detailResult?: {
+            e: any;
+            extension_type?: any;
+            detail?: any;
+        };
+        options?: Partial<AddProductDecideContext>;
+    }): {
+        product: Partial<OrderProduct> & OrderProductIdentity;
+        booking?: AddProductBookingInput;
+        cacheItem: any;
+    };
+    /**
+     * 从已加车的 order line + booking 反查资源编辑抽屉所需的 cacheItem。
+     * 供 SalesSdk「编辑资源」等场景使用；字段语义与 buildCacheItemFromDetail 产出对齐。
+     */
+    buildCacheItemFromOrderLine(input: BuildCacheItemFromOrderLineInput): Record<string, any>;
+    /**
+     * 从已加车的普通商品 order line 反查 SkuDetailModal edit 所需的 cacheItem。
+     */
+    buildNormalProductCacheItemFromOrderLine(input: BuildNormalProductCacheItemFromOrderLineInput): Record<string, any>;
+    /** 文档别名：与 OrderModule.updateOrderProduct 一致。 */
+    updateProductInOrder(params: UpdateOrderProductParams): Promise<OrderProduct[]>;
     /**
      * 销毁模块：先调用父类（销毁所有 store 内子模块 + emit destroy + super.destroy()），
      * 再清理 BookingTicket 自有资源（scan 监听 + scan 内存缓存）。

package/lib/solution/BookingTicket/index.js

@@ -35,12 +35,16 @@ __export(BookingTicket_exports, {
 });
 module.exports = __toCommonJS(BookingTicket_exports);
 var import_types = require("./types");
+var import_BookingContext = require("../../modules/BookingContext");
 var import_BaseSales = require("../BaseSales");
 var import_scan = __toESM(require("./utils/scan"));
 var import_orderCustomer = require("./utils/orderCustomer");
 var import_handleScan = require("./utils/scan/handleScan");
 var import_scanCache = __toESM(require("./utils/scan/scanCache"));
 var import_cartView = require("./utils/cartView");
+var import_addProductDecision = require("./utils/addProductDecision");
+var import_buildCacheItemFromOrderLine = require("../../modules/BookingContext/utils/buildCacheItemFromOrderLine");
+var import_buildNormalProductCacheItemFromOrderLine = require("../../modules/BookingContext/utils/buildNormalProductCacheItemFromOrderLine");
 var import_bookingStatus = require("./utils/bookingStatus");
 __reExport(BookingTicket_exports, require("./types"), module.exports);
 var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
@@ -56,10 +60,14 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
     this.productCatalog = [];
   }
   /**
-   * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer。
+   * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer + bookingContext。
+   * bookingContext 是 SalesSdk 加车下沉所需的「预约 UI 上下文」（bookingConfig / resourcesOrigin / date）。
    */
   getRegisteredModuleNames() {
-    return [...super.getRegisteredModuleNames(), "customer"];
+    return [...super.getRegisteredModuleNames(), "customer", "bookingContext"];
+  }
+  getSubmitOrderSalesChannel() {
+    return "pos";
   }
   /**
    * 业务侧子模块工厂：BookingTicket 自带的 createBookingTicketModule 优先匹配；
@@ -192,6 +200,10 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
    */
   async loadProducts(params = {}, options) {
     const { schedule_date, customer_id, menu_list_ids, schedule_datetime } = params;
+    const bookingDate = schedule_date || (schedule_datetime ? String(schedule_datetime).slice(0, 10) : "");
+    if (bookingDate) {
+      this.setBookingDate(bookingDate);
+    }
     try {
       const result = await this.store.products.loadProducts({
         with_count: ["bundleGroup", "optionGroup"],
@@ -408,6 +420,22 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
     this.store.order.clearOrderCustomer();
     this.core.effects.emit(`${this.name}:onOrderCustomerChange`, null);
   }
+  /**
+   * 重置 tempOrder，并同步清空下单客户运行态。
+   *
+   * OrderModule.restoreOrder 会重建空单（customer_id 已为 null），但不会：
+   *  - emit BookingTicket `onOrderCustomerChange`
+   *  - 重置 CustomerModule.selectedCustomer（老路 getActiveCustomer）
+   *
+   * 因此在 super.restoreOrder 之后显式清客户，保证 SalesSdk / ticketBooking 订阅方与 tempOrder 一致。
+   */
+  async restoreOrder() {
+    var _a;
+    const tempOrder = await super.restoreOrder();
+    this.clearOrderCustomer();
+    (_a = this.store.customer) == null ? void 0 : _a.setSelectedCustomer(null);
+    return tempOrder;
+  }
   /** 内部：基于 OrderModule 当前状态构造一份 OrderCustomerChangePayload。 */
   buildOrderCustomerPayload() {
     const patch = this.store.order.getOrderCustomer();
@@ -613,6 +641,183 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
   async getOtherParams() {
     return this.otherParams;
   }
+  // ─── BookingContext API（透传给 BookingContextModule） ──────────────────────
+  // SalesSdkProvider 挂载时默认调 initBookingContext；也可由 UI 显式 set* 灌入已有数据。
+  /** 拉取 board config 并写入 BookingContext。 */
+  loadBookingConfig(params) {
+    return this.store.bookingContext.loadBookingConfig(params);
+  }
+  /** 拉取资源全集并写入 BookingContext。 */
+  loadBookingResources(params) {
+    return this.store.bookingContext.loadResources(params);
+  }
+  /** 初始化 BookingContext（date + config + resources）。 */
+  initBookingContext(params) {
+    return this.store.bookingContext.initBookingContext(params);
+  }
+  /** 当前 store 是否已具备与入参等价的 config / resources（无需再请求接口）。 */
+  isBookingContextReady(params) {
+    return this.store.bookingContext.isBookingContextReady(params);
+  }
+  /** 写入 booking config（来源：`/core/board/management/config`）。 */
+  setBookingConfig(config) {
+    this.store.bookingContext.setBookingConfig(config);
+  }
+  /** 读取当前 booking config。 */
+  getBookingConfig() {
+    return this.store.bookingContext.getBookingConfig();
+  }
+  /** 写入资源全集（来源：`/form/schedule`），同步派生 resourcesOriginMap。 */
+  setResources(resources) {
+    this.store.bookingContext.setResources(resources);
+  }
+  /** 读取资源全集（浅克隆）。 */
+  getResourcesOrigin() {
+    return this.store.bookingContext.getResourcesOrigin();
+  }
+  /** 读取资源全集 map（id → resource）。 */
+  getResourcesOriginMap() {
+    return this.store.bookingContext.getResourcesOriginMap();
+  }
+  /** 写入当前选择的日期；支持 dayjs / Date / string。 */
+  setBookingDate(date) {
+    this.store.bookingContext.setDate(date);
+  }
+  /** 读取当前选择的日期（统一 string）。 */
+  getBookingDate() {
+    return this.store.bookingContext.getDate();
+  }
+  /** 读取 BookingContext 完整 store（调试 / 测试 / 透传给 SDK 使用）。 */
+  getBookingContextState() {
+    return this.store.bookingContext.getState();
+  }
+  /** 清空 BookingContext（切租户 / destroy 场景）。 */
+  clearBookingContext() {
+    this.store.bookingContext.clear();
+  }
+  /**
+   * 构造 BookingContext 计算上下文（供 getProductExtend / getResourceByIds 等读 API 复用）。
+   */
+  buildBookingCalcContext(extra) {
+    const state = this.store.bookingContext.getState();
+    const date = (extra == null ? void 0 : extra.date) ?? state.date;
+    return {
+      bookingConfig: state.bookingConfig,
+      resourcesOrigin: state.resourcesOrigin,
+      resourcesOriginMap: state.resourcesOriginMap,
+      date,
+      presetStartTime: (extra == null ? void 0 : extra.presetStartTime) ?? (0, import_BookingContext.derivePresetStartTimeFromDate)(date),
+      ...extra || {}
+    };
+  }
+  /**
+   * 取商品当前可选资源列表（透传 OS BookingContext utils#getResourceByIds）。
+   * `extraResources` 用于把拖入未绑定的资源也展示出来。
+   */
+  getResourcesForProduct(product, options) {
+    var _a, _b;
+    const ctx = this.buildBookingCalcContext();
+    return (0, import_BookingContext.getResourceByIds)(ctx.resourcesOriginMap || {}, product, {
+      resourceTab: (_b = (_a = ctx.bookingConfig) == null ? void 0 : _a.config) == null ? void 0 : _b.resource_tab,
+      resourcesOrigin: ctx.resourcesOrigin,
+      extraResources: (options == null ? void 0 : options.extraResources) || []
+    });
+  }
+  /**
+   * 拼装 cacheItem 的 _extend / _data（资源 / 容量 / timeObj），与 info2 `getProductExtend` 等价。
+   */
+  getProductExtend(cacheItem, extra) {
+    return (0, import_BookingContext.getProductExtend)({
+      cacheItem,
+      ctx: this.buildBookingCalcContext(extra)
+    });
+  }
+  /**
+   * 取资源不可用原因列表（结构化 enum + params，i18n 文案由 UI 渲染）。
+   */
+  getResourceErrors(resource, cacheItem) {
+    return (0, import_BookingContext.getResourceErrors)(resource, cacheItem);
+  }
+  // ─── addProduct 决策 / 转换 API（SDK 加车下沉所需） ─────────────────────────
+  // 这一组方法是 SalesSdkCartContext.addProduct / confirmDetail 的 OS 后端。
+  // 调用方传入 ProductData，OS 自取 bookingContext / customer / date 等上下文，
+  // 输出 (a) autoClose 决策结果或 (b) `{ product, booking }` 协议入参。
+  /**
+   * 拼装 addProductDecision 通用上下文（从 store 自取）。
+   */
+  buildAddProductCtx(extra) {
+    var _a, _b;
+    const bookingContextState = this.store.bookingContext.getState();
+    const date = (extra == null ? void 0 : extra.date) ?? bookingContextState.date;
+    const orderCustomerId = ((_a = this.getOrderCustomerSnapshot()) == null ? void 0 : _a.id) ?? ((_b = this.store.order.getTempOrder()) == null ? void 0 : _b.customer_id) ?? void 0;
+    return {
+      bookingConfig: bookingContextState.bookingConfig,
+      resourcesOrigin: bookingContextState.resourcesOrigin,
+      resourcesOriginMap: bookingContextState.resourcesOriginMap,
+      date,
+      presetStartTime: (extra == null ? void 0 : extra.presetStartTime) ?? (0, import_BookingContext.derivePresetStartTimeFromDate)(date),
+      customerId: orderCustomerId,
+      ...extra || {}
+    };
+  }
+  /**
+   * 加车两阶段主决策（规格弹窗 / 资源编辑 / 直接加车）。
+   * 与 ticketBooking `handleSelectProduct` + `handleBooking4Service` 等价。
+   */
+  decideAddProduct(item, options) {
+    return (0, import_addProductDecision.decideAddProduct)(item, this.buildAddProductCtx(options));
+  }
+  /** 规格弹窗 callback 后的第二段决策。 */
+  decideAfterDetail(cacheItem, options) {
+    return (0, import_addProductDecision.decideAfterDetail)(cacheItem, this.buildAddProductCtx(options));
+  }
+  /**
+   * @deprecated 请用 `decideAddProduct`；`autoClose=true` 仅当 action=add。
+   */
+  decideAutoClose(item, options) {
+    return (0, import_addProductDecision.decideAutoClose)(item, this.buildAddProductCtx(options));
+  }
+  /** 替代 info2 `getIsEject`：商品是否需要弹窗（0/1）。 */
+  getIsEject(item, type = "select") {
+    return (0, import_addProductDecision.getIsEject)(item, type);
+  }
+  /** 仅 session 商品（无 variant/option/package）→ true。 */
+  getIsOnlySession(item) {
+    return (0, import_addProductDecision.getIsOnlySession)(item);
+  }
+  /**
+   * 拼装 requiresDetail payload（给 SDK 直接 return 给 UI 用）。
+   */
+  buildRequiresDetailPayload(item, options) {
+    return (0, import_addProductDecision.buildRequiresDetailPayload)(item, this.buildAddProductCtx(options));
+  }
+  /**
+   * 把 detail 弹窗回调结果（e, extension_type, detail）转换为 `(product, booking)` 入参。
+   * 内部会先拼 cacheItem，再走 cacheItemToBookingInput 严格协议对齐。
+   */
+  transformDetailToProductAndBooking(input) {
+    const { item, cacheItem: preparedCacheItem, detailResult, options } = input;
+    const ctx = this.buildAddProductCtx(options);
+    const cacheItem = preparedCacheItem || (detailResult ? (0, import_addProductDecision.buildCacheItemFromDetail)(item, detailResult, ctx) : (0, import_addProductDecision.buildCacheItemFromCartDetail)(item, ctx));
+    return (0, import_addProductDecision.transformDetailToProductAndBooking)(cacheItem, ctx);
+  }
+  /**
+   * 从已加车的 order line + booking 反查资源编辑抽屉所需的 cacheItem。
+   * 供 SalesSdk「编辑资源」等场景使用；字段语义与 buildCacheItemFromDetail 产出对齐。
+   */
+  buildCacheItemFromOrderLine(input) {
+    return (0, import_buildCacheItemFromOrderLine.buildCacheItemFromOrderLine)(input);
+  }
+  /**
+   * 从已加车的普通商品 order line 反查 SkuDetailModal edit 所需的 cacheItem。
+   */
+  buildNormalProductCacheItemFromOrderLine(input) {
+    return (0, import_buildNormalProductCacheItemFromOrderLine.buildNormalProductCacheItemFromOrderLine)(input);
+  }
+  /** 文档别名：与 OrderModule.updateOrderProduct 一致。 */
+  async updateProductInOrder(params) {
+    return this.updateOrderProduct(params);
+  }
   /**
    * 销毁模块：先调用父类（销毁所有 store 内子模块 + emit destroy + super.destroy()），
    * 再清理 BookingTicket 自有资源（scan 监听 + scan 内存缓存）。

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

@@ -1,4 +1,5 @@
 import { ProductList, OrderModule } from '../../modules';
+import { BookingContextModule } from '../../modules/BookingContext';
 import { CustomerModule } from '../../modules/Customer';
 import { SalesSummaryModule } from '../../modules/SalesSummary';
 import { ScheduleModule } from '../../modules/Schedule';
@@ -16,6 +17,7 @@ export interface BookingTicketState extends BaseSalesState {
     salesSummary: SalesSummaryModule;
     schedule: ScheduleModule;
     customer: CustomerModule;
+    bookingContext: BookingContextModule;
 }
 export declare function createBookingTicketModule<T extends keyof BookingTicketState>(moduleName: T, solutionName: string, name?: string, version?: string): BookingTicketState[T] | null;
 export declare enum BookingTicketHooks {

package/lib/solution/BookingTicket/types.js

@@ -24,6 +24,7 @@ __export(types_exports, {
 });
 module.exports = __toCommonJS(types_exports);
 var import_modules = require("../../modules");
+var import_BookingContext = require("../../modules/BookingContext");
 var import_Customer = require("../../modules/Customer");
 var import_SalesSummary = require("../../modules/SalesSummary");
 var import_Schedule = require("../../modules/Schedule");
@@ -54,6 +55,11 @@ function createBookingTicketModule(moduleName, solutionName, name, version) {
         `${solutionName}_${name || moduleName}`,
         version
       );
+    case "bookingContext":
+      return new import_BookingContext.BookingContextModule(
+        `${solutionName}_${name || moduleName}`,
+        version
+      );
     default:
       return null;
   }