@pisell/pisellos 0.10.21 → 0.10.23

package/dist/solution/VenueBooking/utils/dateSummary.d.ts

@@ -7,5 +7,6 @@ export declare function buildDateRangeSummary(params: {
     rawResources: VenueResourceRawData[];
     resourceProductMap: Map<number | string, ResourceProductMapping[]>;
     quotationModule?: QuotationModule;
+    channel?: string;
     resolveConfig?: (date: string) => VenueBookingSlotConfig;
 }): VenueDateSummaryItem[];

package/dist/solution/VenueBooking/utils/dateSummary.js

@@ -14,6 +14,7 @@ export function buildDateRangeSummary(params) {
     rawResources = params.rawResources,
     resourceProductMap = params.resourceProductMap,
     quotationModule = params.quotationModule,
+    channel = params.channel,
     resolveConfig = params.resolveConfig;
   var result = [];
   var productIds = quotationModule ? _toConsumableArray(new Set(_toConsumableArray(resourceProductMap.values()).flat().map(function (m) {
@@ -32,7 +33,8 @@ export function buildDateRangeSummary(params) {
       });
       quotationPriceMap = quotationModule.buildProductPriceMap({
         productIds: productIds,
-        timePoints: timePoints
+        timePoints: timePoints,
+        channel: channel
       });
     }
     var grid = buildTimeSlotGrid({

package/dist/solution/VenueBooking/utils/slotMerge.d.ts

@@ -5,10 +5,12 @@ export declare function mergeConsecutiveSlots(slots: VenueSlotSelection[]): Merg
 export declare function buildPriceBreakdown(params: {
     group: MergedSlotGroup;
     productId: number;
+    channel?: string;
     quotation?: {
         getQuotationShelfId: (p: {
             productId: number;
             datetime: string;
+            channel?: string;
         }) => number;
     };
 }): PriceBreakdownEntry[];

package/dist/solution/VenueBooking/utils/slotMerge.js

@@ -53,6 +53,7 @@ export function mergeConsecutiveSlots(slots) {
 export function buildPriceBreakdown(params) {
   var group = params.group,
     productId = params.productId,
+    channel = params.channel,
     quotation = params.quotation;
   if (!group.slots.length) return [];
   var entries = [];
@@ -64,7 +65,8 @@ export function buildPriceBreakdown(params) {
       var unitPrice = Number(slot.price || '0');
       var shelfId = quotation ? quotation.getQuotationShelfId({
         productId: productId,
-        datetime: slot.startTime
+        datetime: slot.startTime,
+        channel: channel
       }) : 0;
       var startHm = dayjs(slot.startTime, 'YYYY-MM-DD HH:mm').format('YYYY-MM-DD HH:mm');
       var endHm = dayjs(slot.endTime, 'YYYY-MM-DD HH:mm').format('YYYY-MM-DD HH:mm');

package/dist/utils/platform.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Normalize the runtime platform passed through solution/module otherParams.
+ */
+export declare function normalizeRuntimePlatform(platform: unknown): string;
+/**
+ * PC and H5 are authenticated-customer clients rather than staff terminals.
+ */
+export declare function isCustomerUserPlatform(platform: unknown): boolean;

package/dist/utils/platform.js

@@ -0,0 +1,15 @@
+var CUSTOMER_USER_PLATFORMS = new Set(['pc', 'h5']);
+
+/**
+ * Normalize the runtime platform passed through solution/module otherParams.
+ */
+export function normalizeRuntimePlatform(platform) {
+  return String(platform !== null && platform !== void 0 ? platform : '').trim().toLowerCase();
+}
+
+/**
+ * PC and H5 are authenticated-customer clients rather than staff terminals.
+ */
+export function isCustomerUserPlatform(platform) {
+  return CUSTOMER_USER_PLATFORMS.has(normalizeRuntimePlatform(platform));
+}

package/lib/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/lib/modules/BookingContext/index.js

@@ -16,6 +16,7 @@ exports.buildBookingResourcesQueryKey = buildBookingResourcesQueryKey;
 var _dayjs = _interopRequireDefault(require("dayjs"));
 var _BaseModule = require("../BaseModule");
 var _request = require("../../plugins/request");
+var _platform = require("../../utils/platform");
 var _types = require("./types");
 Object.keys(_types).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -52,6 +53,8 @@ const DEFAULT_BOOKING_CONFIG_PARAMS = {
   item_type: 'appointment_booking',
   sub_type: 'ticket'
 };
+const BOOKING_CONFIG_ENDPOINT = '/core/board/management/config';
+const H5_BOOKING_CONFIG_ENDPOINT = '/core/board/config';
 const BOARD_CONFIG_CACHE = {
   useCache: true,
   cache: {
@@ -167,6 +170,26 @@ function buildBookingConfigQueryKey(params = {}) {
   });
   return JSON.stringify(sorted);
 }
+function resolveBookingConfigRequest(platform, params = {}) {
+  const isH5 = (0, _platform.normalizeRuntimePlatform)(platform) === 'h5';
+  const endpoint = isH5 ? H5_BOOKING_CONFIG_ENDPOINT : BOOKING_CONFIG_ENDPOINT;
+  const query = isH5 ? {
+    item_type: params.item_type || DEFAULT_BOOKING_CONFIG_PARAMS.item_type
+  } : {
+    ...DEFAULT_BOOKING_CONFIG_PARAMS,
+    ...params
+  };
+  const keys = Object.keys(query).sort();
+  const sortedQuery = {};
+  keys.forEach(key => {
+    sortedQuery[key] = query[key];
+  });
+  return {
+    endpoint,
+    query,
+    key: `${endpoint}:${JSON.stringify(sortedQuery)}`
+  };
+}
 
 /** 稳定序列化资源列表查询（date + bookingIds），用于跳过重复 loadResources。 */
 function buildBookingResourcesQueryKey(params = {}) {
@@ -181,6 +204,7 @@ class BookingContextModule extends _BaseModule.BaseModule {
   store = {
     ...EMPTY_STATE
   };
+  otherParams = {};
   /** 上次成功 loadBookingConfig 的 query key；命中则不再请求。 */
   lastConfigQueryKey = null;
   /** 上次成功 loadResources 的 query key（date|bookingIds）；命中则不再请求。 */
@@ -194,6 +218,7 @@ class BookingContextModule extends _BaseModule.BaseModule {
     if (!this.request) {
       throw new Error('BookingContextModule 需要 request 插件支持');
     }
+    this.otherParams = options.otherParams || {};
     this.store = {
       bookingConfig: null,
       resourcesOrigin: [],
@@ -212,15 +237,17 @@ class BookingContextModule extends _BaseModule.BaseModule {
       this.store.date = initialState.date;
     }
   }
+
+  /** 同步父级解决方案的运行态参数；platform 变化后会自然切换 config endpoint/cache key。 */
+  updateOtherParams(params) {
+    this.otherParams = params || {};
+  }
   async loadBookingConfig(params = {}, options = {}) {
-    const configKey = buildBookingConfigQueryKey(params);
+    const requestConfig = resolveBookingConfigRequest(this.otherParams?.platform, params);
+    const configKey = requestConfig.key;
     if (!options.forceRefresh && this.store.bookingConfig != null && this.lastConfigQueryKey === configKey) {
       return this.store.bookingConfig;
     }
-    const query = {
-      ...DEFAULT_BOOKING_CONFIG_PARAMS,
-      ...params
-    };
     const sharedKey = buildSharedCacheKey(this.request, configKey);
     if (!options.forceRefresh && sharedBookingConfigCache.has(sharedKey)) {
       const cached = sharedBookingConfigCache.get(sharedKey) ?? null;
@@ -232,7 +259,7 @@ class BookingContextModule extends _BaseModule.BaseModule {
     if (!pending) {
       const requestPromise = (async () => {
         try {
-          const res = await this.request.get('/core/board/management/config', query, BOARD_CONFIG_CACHE);
+          const res = await this.request.get(requestConfig.endpoint, requestConfig.query, BOARD_CONFIG_CACHE);
           const config = res?.data ?? null;
           sharedBookingConfigCache.set(sharedKey, config);
           return config;
@@ -293,7 +320,7 @@ class BookingContextModule extends _BaseModule.BaseModule {
    * store 内是否已具备与本次 init 入参等价的 config / resources（不再打接口）。
    */
   isBookingContextReady(params = {}) {
-    const configKey = buildBookingConfigQueryKey(params.bookingConfigParams);
+    const configKey = resolveBookingConfigRequest(this.otherParams?.platform, params.bookingConfigParams).key;
     const dateInput = params.date ?? this.store.date ?? (0, _dayjs.default)();
     const queryDate = toScheduleQueryDate(dateInput);
     const resourcesKey = buildBookingResourcesQueryKey({
@@ -311,7 +338,7 @@ class BookingContextModule extends _BaseModule.BaseModule {
     if (!params.forceRefresh && this.isBookingContextReady(params)) {
       return this.getState();
     }
-    const configKey = buildBookingConfigQueryKey(params.bookingConfigParams);
+    const configKey = resolveBookingConfigRequest(this.otherParams?.platform, params.bookingConfigParams).key;
     const resourcesKey = buildBookingResourcesQueryKey({
       date: queryDate,
       bookingIds: params.bookingIds

package/lib/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/lib/modules/BookingContext/types.js

@@ -7,7 +7,7 @@ exports.BookingContextEvent = void 0;
 /**
  * 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 的输入。
@@ -17,7 +17,7 @@ exports.BookingContextEvent = void 0;
  *  - 默认由 `loadBookingConfig` / `loadResources` 拉取并写入 store；也支持消费方 `set*` 直接灌入（复用 ticketBooking 已拉到的数据）。
  *  - 所有读 API 返回浅克隆（数组）或原引用（map / config），避免 UI 写穿。
  */
-/** `loadBookingConfig` 入参，与 ticketBooking `getBookingConfig` 一致。 */
+/** `loadBookingConfig` 入参；H5 公共接口只消费 `item_type`。 */
 /** `loadResources` 入参，与 info2 `getResourceList` 一致。 */
 /** `initBookingContext` 入参（BookingTicket 聚合入口）。 */
 /**
@@ -25,7 +25,7 @@ exports.BookingContextEvent = void 0;
  * 这里只声明 Record 形态；具体字段保留 `any`，与 ticketBooking 现网传入的数据形状兼容。
  */
 /**
- * 形参 booking_config（结构来自 `/core/board/management/config` 接口）。
+ * 形参 booking_config（结构来自 staff management 或 H5 board config 接口的 `data`）。
  * OS 不强制 schema，保留 `Record<string, any>` 兼容现网；常用路径文档化在 SDK docs。
  */
 /**

package/lib/modules/BookingContext/utils/buildCacheItemFromOrderLine.js

@@ -181,6 +181,7 @@ function buildCacheItemFromOrderLine(input) {
     booking,
     sourceProduct
   } = input;
+  const holderConfig = sourceProduct?.holder_config ?? sourceProduct?.origin?.holder_config ?? product.metadata?.holder_config;
   const resolvedId = product.product_id ?? sourceProduct?.id;
   const selling = Number(product.selling_price ?? 0);
   const original = Number(product.original_price ?? selling);
@@ -249,6 +250,9 @@ function buildCacheItemFromOrderLine(input) {
   }
   const base = {
     ...(sourceProduct || {}),
+    ...(holderConfig !== undefined && holderConfig !== null ? {
+      holder_config: holderConfig
+    } : {}),
     id: resolvedId,
     product_id: resolvedId,
     extension_type: sourceProduct?.extension_type ?? booking?.product?.extension_type ?? sourceProduct?.extension_type,

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

@@ -28,6 +28,7 @@ export declare class OpenDataModule extends BaseModule implements Module {
      * openDataModule.updateOtherParams({ openCache: true, cacheId: 'cache-2' })
      */
     updateOtherParams(params: Record<string, any>): void;
+    private shouldSkipInvoiceTemplateDocument;
     fetchOpenData(params: OpenDataFetchParams): Promise<OpenDataConfig>;
     getOpenData(): OpenDataConfig | null;
     getInvoiceLayoutConfig(): InvoiceLayoutConfig;

package/lib/modules/OpenData/index.js

@@ -152,6 +152,9 @@ class OpenDataModule extends _BaseModule.BaseModule {
     this.cacheId = this.otherParams.cacheId;
     this.fatherModule = this.otherParams.fatherModule;
   }
+  shouldSkipInvoiceTemplateDocument() {
+    return String(this.otherParams?.platform || '').trim().toLowerCase() === 'h5';
+  }
   async fetchOpenData(params) {
     const fetchRevision = ++this.fetchRevision;
     const getData = this.appPlugin?.getData?.();
@@ -190,6 +193,9 @@ class OpenDataModule extends _BaseModule.BaseModule {
     return (0, _utils.normalizeInvoiceLayoutFromTemplateSettings)(this.getInvoiceTemplateSettings());
   }
   getInvoiceTemplateSettings() {
+    if (this.shouldSkipInvoiceTemplateDocument()) {
+      return (0, _utils.getDefaultInvoiceTemplateSettings)();
+    }
     if (isRecord(this.store.invoiceTemplateSettings)) {
       const documentId = resolveInvoiceDocumentId(this.store.data?.['documents.invoice_template']);
       if (documentId) {
@@ -226,6 +232,13 @@ class OpenDataModule extends _BaseModule.BaseModule {
     this.store.invoiceTemplateCacheKey = resolved.cacheKey;
   }
   async resolveInvoiceTemplateSettings(config, target) {
+    if (this.shouldSkipInvoiceTemplateDocument()) {
+      return {
+        settings: (0, _utils.getDefaultInvoiceTemplateSettings)(),
+        documentId: null,
+        cacheKey: null
+      };
+    }
     const rawTemplate = config['documents.invoice_template'];
     const documentId = resolveInvoiceDocumentId(rawTemplate);
     if (!documentId) {

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

@@ -415,6 +415,11 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      * if (pending) await pending;
      */
     private appendProductLineToTempOrder;
+    /**
+     * booking 数量拆行时，若 Holder 数量与拆行数严格一致，则按下标分配。
+     * 数量不一致时保持旧数据，避免猜测 Holder 与商品份数的对应关系。
+     */
+    private createSplitBookingLine;
     /**
      * 添加商品行。带 booking 时强制独立行；num>1 时拆成多条 num=1 的 product+booking（对齐 BookingByStep / ticketBooking addService）。
      *

package/lib/modules/Order/index.js

@@ -3060,6 +3060,67 @@ class OrderModule extends _BaseModule.BaseModule {
     commitProductLine(shouldMerge);
   }
 
+  /**
+   * booking 数量拆行时，若 Holder 数量与拆行数严格一致，则按下标分配。
+   * 数量不一致时保持旧数据，避免猜测 Holder 与商品份数的对应关系。
+   */
+  createSplitBookingLine(product, booking, index, splitCount) {
+    const singleLine = (0, _lodashEs.cloneDeep)(product);
+    singleLine.num = 1;
+    delete singleLine.product_quantity;
+    const singleBooking = (0, _lodashEs.cloneDeep)(booking);
+    const bookingHolder = booking?.holder && typeof booking.holder === 'object' ? booking.holder : null;
+    const metadataHolder = booking?.metadata?.holder && typeof booking.metadata.holder === 'object' ? booking.metadata.holder : null;
+    const rawHolderIds = bookingHolder?.form_record ?? booking?.metadata?.holder_id ?? metadataHolder?.form_record ?? product?.metadata?.holder_id;
+    const holderIds = (Array.isArray(rawHolderIds) ? rawHolderIds : [rawHolderIds]).map(holderId => holderId && typeof holderId === 'object' ? holderId.form_record_id : holderId).filter(holderId => holderId !== undefined && holderId !== null && holderId !== '');
+    if (holderIds.length !== splitCount) {
+      return {
+        product: singleLine,
+        booking: singleBooking
+      };
+    }
+    const holderId = holderIds[index];
+    const rawHolderName = bookingHolder?.name ?? metadataHolder?.name;
+    const holderNames = Array.isArray(rawHolderName) ? rawHolderName.map(name => String(name || '').trim()) : typeof rawHolderName === 'string' ? rawHolderName.split(',').map(name => name.trim()) : [];
+    const holderName = holderNames.length === splitCount ? holderNames[index] : undefined;
+    const splitHolder = holder => ({
+      ...holder,
+      form_record: [holderId],
+      ...(holderName ? {
+        name: holderName
+      } : Object.prototype.hasOwnProperty.call(holder, 'name') ? {
+        name: undefined
+      } : {})
+    });
+    singleLine.metadata = {
+      ...(singleLine.metadata || {}),
+      holder_id: [holderId]
+    };
+    if (singleLine._extend && typeof singleLine._extend === 'object') {
+      singleLine._extend = {
+        ...singleLine._extend,
+        holder_id: [holderId]
+      };
+    }
+    if (singleBooking.holder && typeof singleBooking.holder === 'object') {
+      singleBooking.holder = splitHolder(singleBooking.holder);
+    }
+    singleBooking.metadata = {
+      ...(singleBooking.metadata || {}),
+      holder_id: [holderId],
+      ...(singleBooking.metadata?.holder && typeof singleBooking.metadata.holder === 'object' ? {
+        holder: splitHolder(singleBooking.metadata.holder)
+      } : {})
+    };
+    if (Object.prototype.hasOwnProperty.call(singleBooking, 'holder_id')) {
+      singleBooking.holder_id = [holderId];
+    }
+    return {
+      product: singleLine,
+      booking: singleBooking
+    };
+  }
+
   /**
    * 添加商品行。带 booking 时强制独立行；num>1 时拆成多条 num=1 的 product+booking（对齐 BookingByStep / ticketBooking addService）。
    *
@@ -3080,10 +3141,8 @@ class OrderModule extends _BaseModule.BaseModule {
       const splitCount = (0, _utils3.getSafeProductNum)(productRecord.num ?? productRecord.product_quantity ?? 1);
       if (splitCount > 1) {
         for (let i = 0; i < splitCount; i += 1) {
-          const singleLine = (0, _lodashEs.cloneDeep)(productRecord);
-          singleLine.num = 1;
-          delete singleLine.product_quantity;
-          const appendResult = this.appendProductLineToTempOrder(tempOrder, singleLine, (0, _lodashEs.cloneDeep)(booking), {
+          const splitLine = this.createSplitBookingLine(productRecord, booking, i, splitCount);
+          const appendResult = this.appendProductLineToTempOrder(tempOrder, splitLine.product, splitLine.booking, {
             insertAtIndex,
             disableMerge: options?.disableMerge
           });
@@ -3130,10 +3189,8 @@ class OrderModule extends _BaseModule.BaseModule {
         const splitCount = (0, _utils3.getSafeProductNum)(productRecord.num ?? productRecord.product_quantity ?? 1);
         if (splitCount > 1) {
           for (let i = 0; i < splitCount; i += 1) {
-            const singleLine = (0, _lodashEs.cloneDeep)(productRecord);
-            singleLine.num = 1;
-            delete singleLine.product_quantity;
-            const appendResult = this.appendProductLineToTempOrder(tempOrder, singleLine, (0, _lodashEs.cloneDeep)(booking));
+            const splitLine = this.createSplitBookingLine(productRecord, booking, i, splitCount);
+            const appendResult = this.appendProductLineToTempOrder(tempOrder, splitLine.product, splitLine.booking);
             if (appendResult) await appendResult;
           }
           continue;

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

@@ -0,0 +1,50 @@
+import type { PisellCore } from '../../types';
+import type { RequestPlugin } from '../../plugins';
+import type { ProductData } from '../Product/types';
+export declare const PRODUCT_QUERY_DATA_VARIANT_RELATIONS: readonly ["category", "collection", "resourceRelation", "bundleGroup.bundleItem", "optionGroup.optionItem", "variantGroup.variantItem", "dataVariants"];
+/**
+ * 判断当前商品查询是否会被本地 OS Server 接管。
+ *
+ * H5 RequestPlugin 即使收到 osServer=true 仍会直接请求远端接口，因此必须按
+ * RequestPlugin 实际 baseUrl 对应的已注册路由判断，不能只看请求选项。
+ */
+export declare function isProductQueryHandledByOsServer(core: PisellCore | undefined, request: RequestPlugin | undefined): boolean;
+export interface ResolveClientDataVariantsParams {
+    core: PisellCore | undefined;
+    otherParams?: Record<string, any>;
+    products: ProductData[];
+    queryPayload: Record<string, any>;
+    handledByOsServer: boolean;
+    scheduleList?: unknown;
+    menuList?: unknown;
+    /** Quote fast paths require hydrated relations; legacy list resolution does not. */
+    requireCompleteDataVariantRelations?: boolean;
+    /** Quote fast paths require every referenced rule; legacy list resolution is best-effort. */
+    requireEvaluatorReady?: boolean;
+}
+export type ResolveClientDataVariantsResult = {
+    status: 'handled-by-os-server' | 'empty' | 'data-variants-unavailable' | 'evaluator-unavailable' | 'evaluator-not-ready';
+    products: ProductData[];
+} | {
+    status: 'resolved';
+    products: ProductData[];
+} | {
+    status: 'error';
+    products: ProductData[];
+    error: unknown;
+};
+/**
+ * Strict client-side Data Variant resolution for quote fast paths.
+ *
+ * Unlike resolveClientDataVariants, callers can distinguish a complete local
+ * result from a capability/readiness/error fallback and decide to query the
+ * remote product endpoint instead.
+ */
+export declare function tryResolveClientDataVariants({ core, otherParams, products, queryPayload, handledByOsServer, scheduleList: explicitScheduleList, menuList: explicitMenuList, requireCompleteDataVariantRelations, requireEvaluatorReady, }: ResolveClientDataVariantsParams): ResolveClientDataVariantsResult;
+/**
+ * 未启用商品 OS 路由时，在客户端补做 Data Variant 解析。
+ *
+ * 商品列表和预约报价必须共用这个边界，避免 H5 的弹窗报价绕过客户端智能定价。
+ * OS Server 已接管时直接信任服务端结果，确保同一批商品只评估一次。
+ */
+export declare function resolveClientDataVariants({ core, otherParams, products, queryPayload, handledByOsServer, scheduleList: explicitScheduleList, menuList: explicitMenuList, }: ResolveClientDataVariantsParams): ProductData[];