@pisell/pisellos 0.0.568 → 0.0.569

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

@@ -0,0 +1,78 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getNoResource2 = getNoResource2;
+/**
+ * 「无资源」占位资源行的数据骨架。
+ *
+ * 与 info2 [`booking/mock.ts#getNoResource2`] 一比一对齐，区别仅在于：
+ *   - `main_field / room_name / labelText` 三个 i18n 文案字段在 OS 这边**置空**，
+ *     调用方（UI）在 `id === 0` 时自行渲染本地化的「无资源 / No resource」。
+ *
+ * 用途：`getResourceByIds` 在拼装 `optional_resource` 列表时，会在末尾 concat 一行此占位，
+ *   让用户能选择「不指定资源」。
+ */
+function getNoResource2(other) {
+  return {
+    form_tag: null,
+    policy: 148,
+    partyroom_package: {
+      type: 'product_all'
+    },
+    sort: '2',
+    status: 'active',
+    description: '',
+    media: '',
+    main_field: '',
+    subtitle: '',
+    room_name: '',
+    labelText: '',
+    form_record_id: 0,
+    item_type: 'resources',
+    form_id: 0,
+    id: 0,
+    form_resource_sort: 0,
+    form_title: '',
+    capacity: 999999,
+    form: {
+      id: 0,
+      shop_id: 0,
+      title: '',
+      navigation_display: 1,
+      button: '',
+      describe: '',
+      status: 'published',
+      resource_sort: 0,
+      code: 'resources',
+      type: 'manual',
+      version: 1,
+      setting: null,
+      created_at: '2000-01-01 00:00:00',
+      updated_at: '2000-01-01 00:00:00'
+    },
+    times: [{
+      keys: 'noResource2-placeholder',
+      schedule_id: 0,
+      item_type: 'resources',
+      item_id: 0,
+      start_date: '2000-01-01',
+      end_date: '2300-01-01',
+      start_time: '00:00',
+      end_time: '23:59',
+      is_all: 1,
+      max_participants_type: 'custom-limit',
+      max_participants_limit: 0,
+      relation_type: 'form',
+      start_at: '2000-01-01 00:00',
+      end_at: '2300-01-05 23:59',
+      is_blocked: 0,
+      blocked_times: [],
+      order_event_count: 0,
+      unique: 'noResource2-unique',
+      event_list: []
+    }],
+    ...(other || {})
+  };
+}

package/lib/modules/BookingContext/utils/orderLineDisplay.d.ts

@@ -0,0 +1 @@
+export declare function buildProductOptionStringFromOrderLine(product: any): string;

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

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildProductOptionStringFromOrderLine = buildProductOptionStringFromOrderLine;
+function pickDisplayText(value) {
+  if (value === undefined || value === null) return '';
+  if (typeof value === 'string') return value;
+  if (typeof value !== 'object') return String(value);
+  return value.auto || value.original || value.en || value['zh-CN'] || value['zh-HK'] || '';
+}
+function formatNamePair(group, item) {
+  const groupText = pickDisplayText(group);
+  const itemText = pickDisplayText(item);
+  if (groupText && itemText) return `${groupText}:${itemText}`;
+  return groupText || itemText;
+}
+function buildProductOptionStringFromOrderLine(product) {
+  const segments = [];
+  const sku = product?.product_sku || {};
+  if (Array.isArray(sku.variant)) {
+    for (const variant of sku.variant) {
+      const segment = formatNamePair(variant?.group, variant?.item);
+      if (segment) segments.push(segment);
+    }
+  }
+  return segments.join(', ');
+}

package/lib/modules/BookingContext/utils/productExtend.d.ts

@@ -0,0 +1,72 @@
+import { getSumCapacity } from './resources';
+import { TimeSlicesResult, TimeSlice, DurationSlice } from './timeSlices';
+/**
+ * 上下文（与 info2 state.bookingConfig / state.service / state.date 一一对应）。
+ *
+ * 设计原则：所有助手函数都通过 context 显式拿数据，**不读 mini-redux**，
+ * 让 OS 这层完全可在 Node 单测下运行（dayjs 在 Node 也是纯函数）。
+ */
+export interface BookingCalcContext {
+    /** 来自 `/core/board/management/config` 的整套配置；常用路径见 sliceTimeSlices / appointmentTimingPreference。 */
+    bookingConfig?: any;
+    /** 资源 origin map（id → resource origin）。 */
+    resourcesOriginMap?: Record<string, any>;
+    /** 资源全集列表（display_scope=all 时用）。 */
+    resourcesOrigin?: any[];
+    /** 当前选择的日期（dayjs 或 string）。 */
+    date?: any;
+    /** 上一个服务行（getServiceStartTimeAndEndTime 拼接续接 start_time 用）。可缺省。 */
+    previousService?: any;
+    /** 日历选中的资源 id（替代 info2 sessionStorage.serviceParams.resource_id）。 */
+    resourceIdFromCalendar?: number;
+    /** 资源自动分派开关（替代 info2 localStorage 'resource-auto-allocation'）；默认全开。 */
+    isAutoAllocationOn?: (formId: any) => boolean;
+    /** 当前预设开始时间（替代 info2 sessionStorage.serviceParams.start_date 取 HH:mm）。 */
+    presetStartTime?: string;
+    /** 店铺打烊时间（替代 info2 localStorage shopOpeningHours），默认 23:59。 */
+    shopOpeningHours?: string;
+}
+/** 从 BookingContext.date 提取 HH:mm（仅当日期带有效时分时）。 */
+export declare function derivePresetStartTimeFromDate(date: any): string | undefined;
+/**
+ * 时间切片对象（含灵活时长选项）。与 info2 `getTimeObj` 等价。
+ */
+export declare function getTimeObj(params: {
+    cacheItem: any;
+    useStartTime?: string;
+    useDuration?: number | string;
+    ctx: BookingCalcContext;
+}): TimeSlicesResult & {
+    timeSlices: TimeSlice[];
+    durationSlicesBasedOnTime: DurationSlice[];
+};
+/**
+ * 计算商品行 _extend（包含 start_time / endDate / duration / start_date / end_date / sub_type 等）。
+ * 与 info2 `utilsByBooking.ts#getServiceStartTimeAndEndTime` 等价；显著差异：
+ *   - 不读 `state.service.value` / `mini-redux`，由 ctx.previousService 显式注入。
+ *   - 不读 `sessionStorage.serviceParams`，由 ctx.presetStartTime / ctx.resourceIdFromCalendar 注入。
+ *   - cacheItem.isCustomItem → 直接返回 `{ duration: null }`。
+ */
+export declare function getServiceStartTimeAndEndTime(params: {
+    cacheItem: any;
+    timeObj: TimeSlicesResult;
+    ctx: BookingCalcContext;
+}): any;
+/**
+ * 综合：把 cacheItem 拼装出完整的 _extend / _data（资源 / 容量 / timeObj），并标记 autoClose。
+ * 与 info2 `service/addService/utils.tsx#getProductExtend` 等价；剥 React `console.time` / JSX。
+ *
+ * 入参 ctx 必须至少给：bookingConfig / resourcesOriginMap / resourcesOrigin / date。
+ */
+export declare function getProductExtend(params: {
+    cacheItem: any;
+    ctx: BookingCalcContext;
+    isDisabledTime?: boolean;
+}): any;
+/**
+ * 是否可自动关闭弹窗（不需要用户进 EditService 抽屉）。
+ * 与 info2 `service/addService/utils.tsx#getIsAutoClose` 等价；
+ * `getAutoAllocationStorage` 抽象为入参 `isAutoAllocationOn(formId)`。
+ */
+export declare function getIsAutoClose(cacheItem: any, isAutoAllocationOn: (formId: any) => boolean): boolean;
+export { getSumCapacity };

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

@@ -0,0 +1,330 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.derivePresetStartTimeFromDate = derivePresetStartTimeFromDate;
+exports.getIsAutoClose = getIsAutoClose;
+exports.getProductExtend = getProductExtend;
+exports.getServiceStartTimeAndEndTime = getServiceStartTimeAndEndTime;
+Object.defineProperty(exports, "getSumCapacity", {
+  enumerable: true,
+  get: function () {
+    return _resources.getSumCapacity;
+  }
+});
+exports.getTimeObj = getTimeObj;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _resources = require("./resources");
+var _resourceSelection = require("./resourceSelection");
+var _serviceTimes = require("./serviceTimes");
+var _timeSlices = require("./timeSlices");
+var _flexible = require("./flexible");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * 上下文（与 info2 state.bookingConfig / state.service / state.date 一一对应）。
+ *
+ * 设计原则：所有助手函数都通过 context 显式拿数据，**不读 mini-redux**，
+ * 让 OS 这层完全可在 Node 单测下运行（dayjs 在 Node 也是纯函数）。
+ */
+
+/** 从 BookingContext.date 提取 HH:mm（仅当日期带有效时分时）。 */
+function derivePresetStartTimeFromDate(date) {
+  if (date == null) return undefined;
+  const d = (0, _dayjs.default)(date);
+  if (!d.isValid()) return undefined;
+  const hhmm = d.format('HH:mm');
+  if (hhmm === '00:00') return undefined;
+  return hhmm;
+}
+
+/**
+ * 取预约时间偏好（sequential / parallel）；默认 sequential。
+ */
+function getAppointmentTimingPreference(ctx) {
+  return ctx?.bookingConfig?.config?.information_tab?.appointment_timing_preference || 'sequential';
+}
+
+/**
+ * 灵活时长选项（cacheItem.duration.type === 'flexible' 时）。
+ */
+function getFlexibleOption(params) {
+  const {
+    cacheItem,
+    useStartTime
+  } = params;
+  const duration = (0, _flexible.getDurationValue)(cacheItem?.duration);
+  if (duration !== 'flexible') return null;
+  const startDate = (0, _dayjs.default)(`${(0, _dayjs.default)(cacheItem?._extend?.start_date).format('YYYY-MM-DD')} ${useStartTime || cacheItem?._extend?.start_time || '00:00'}`);
+  const usable = (0, _resources.getUsableTime)(cacheItem);
+  const usableEndAt = usable?._extend?.usableTime?.end_at ? (0, _dayjs.default)(usable._extend.usableTime.end_at) : null;
+  const endDate = (0, _timeSlices.getEndDate)(startDate, 'flexible', usableEndAt, params.ctx?.shopOpeningHours);
+  const timeValue = endDate.diff(startDate, 'minute');
+  return {
+    label: String(timeValue),
+    value: _flexible.flexibleObj.create(timeValue)
+  };
+}
+
+/**
+ * 时间切片对象（含灵活时长选项）。与 info2 `getTimeObj` 等价。
+ */
+function getTimeObj(params) {
+  const {
+    cacheItem,
+    useStartTime,
+    useDuration,
+    ctx
+  } = params;
+  const isMultiDay = (0, _serviceTimes.isMultiDayProduct)(cacheItem);
+  const flexibleOption = getFlexibleOption({
+    cacheItem,
+    useStartTime,
+    ctx
+  });
+  const baseSlices = (0, _timeSlices.sliceDayIntoFiveMinutes)(ctx?.bookingConfig?.config?.basic?.service_time, isMultiDay);
+  const timeSlices = [...baseSlices.timeSlices];
+  const durationSlicesBasedOnTime = [...baseSlices.durationSlicesBasedOnTime];
+  if (flexibleOption) {
+    durationSlicesBasedOnTime.unshift(flexibleOption);
+  }
+  if (useDuration && !durationSlicesBasedOnTime.some(d => d.value === useDuration)) {
+    durationSlicesBasedOnTime.unshift({
+      label: String(useDuration),
+      value: useDuration
+    });
+  }
+  return {
+    timeSlices,
+    durationSlicesBasedOnTime
+  };
+}
+
+/**
+ * 计算商品行 _extend（包含 start_time / endDate / duration / start_date / end_date / sub_type 等）。
+ * 与 info2 `utilsByBooking.ts#getServiceStartTimeAndEndTime` 等价；显著差异：
+ *   - 不读 `state.service.value` / `mini-redux`，由 ctx.previousService 显式注入。
+ *   - 不读 `sessionStorage.serviceParams`，由 ctx.presetStartTime / ctx.resourceIdFromCalendar 注入。
+ *   - cacheItem.isCustomItem → 直接返回 `{ duration: null }`。
+ */
+function getServiceStartTimeAndEndTime(params) {
+  const {
+    cacheItem,
+    timeObj,
+    ctx
+  } = params;
+  if (cacheItem?.isCustomItem) {
+    return {
+      duration: null
+    };
+  }
+  const appointmentTimingPreference = getAppointmentTimingPreference(ctx);
+  const lastServer = ctx.previousService || null;
+  const resolveDuration = () => {
+    if ((0, _serviceTimes.isMultiDayProduct)(cacheItem)) return (0, _serviceTimes.getDays)(cacheItem, 'days');
+    return (0, _timeSlices.findNextDuration)(cacheItem.duration, timeObj.durationSlicesBasedOnTime, cacheItem?.duration?.value);
+  };
+  let _extend = {
+    duration: resolveDuration()
+  };
+  if (lastServer) {
+    const lastStart = lastServer._extend?.startDate;
+    const lastEnd = lastServer._extend?.endDate;
+    if (appointmentTimingPreference === 'parallel') {
+      _extend.start_time = (0, _dayjs.default)(lastStart).format('HH:mm');
+    } else if ((0, _dayjs.default)(lastEnd).isAfter((0, _dayjs.default)(lastStart), 'day')) {
+      _extend.start_time = timeObj.timeSlices[timeObj.timeSlices.length - 1]?.value;
+    } else {
+      _extend.start_time = lastEnd ? (0, _dayjs.default)(lastEnd).format('HH:mm') : (0, _dayjs.default)().format('HH:mm');
+    }
+  } else {
+    const presetStartTime = ctx.presetStartTime;
+    // 与 info2 getServiceStartTimeAndEndTime 一致：日历/顶部日期带 HH:mm 时原样使用，
+    // 不做 findNextSlice 栅格对齐（否则 01:47 会被抬到 01:50）。
+    if (presetStartTime && presetStartTime !== '00:00') {
+      _extend.start_time = presetStartTime;
+    } else if (cacheItem.currentDefaultTime) {
+      _extend.start_time = cacheItem.currentDefaultTime;
+    } else {
+      _extend.start_time = (0, _dayjs.default)().format('HH:mm');
+    }
+  }
+  _extend = {
+    ..._extend,
+    ...cacheItem._extend
+  };
+  const {
+    startDate,
+    endDate
+  } = (0, _serviceTimes.getServiceTimes)({
+    ...cacheItem,
+    _extend
+  });
+  _extend.startDate = startDate;
+  _extend.endDate = endDate;
+  if ((0, _serviceTimes.isMultiDayProduct)(cacheItem)) {
+    _extend.start_time = _extend.start_time || startDate.format('HH:mm');
+    _extend.end_time = _extend.end_time || endDate.format('HH:mm');
+    _extend.start_date = _extend.start_date ?? startDate;
+    _extend.end_date = _extend.end_date ?? endDate;
+  }
+  const session = cacheItem?._extend?.other?.session;
+  if ((0, _serviceTimes.isSessionProduct)(cacheItem) && session) {
+    const baseDate = ctx.date ? (0, _dayjs.default)(ctx.date) : (0, _dayjs.default)();
+    const startAt = (0, _dayjs.default)(`${baseDate.format('YYYY-MM-DD')} ${(0, _dayjs.default)(session.start_at).format('HH:mm:ss')}`);
+    const endAt = (0, _dayjs.default)(`${baseDate.format('YYYY-MM-DD')} ${(0, _dayjs.default)(session.end_at).format('HH:mm:ss')}`);
+    _extend.start_date = startAt;
+    _extend.startDate = startAt;
+    _extend.start_time = session.start_time;
+    _extend.end_date = endAt;
+    _extend.endDate = endAt;
+    _extend.end_time = session.end_time;
+    _extend.duration = (0, _serviceTimes.getDays)({
+      _extend
+    }, 'minutes');
+  }
+  return _extend;
+}
+
+/**
+ * 综合：把 cacheItem 拼装出完整的 _extend / _data（资源 / 容量 / timeObj），并标记 autoClose。
+ * 与 info2 `service/addService/utils.tsx#getProductExtend` 等价；剥 React `console.time` / JSX。
+ *
+ * 入参 ctx 必须至少给：bookingConfig / resourcesOriginMap / resourcesOrigin / date。
+ */
+function getProductExtend(params) {
+  const {
+    cacheItem,
+    ctx,
+    isDisabledTime
+  } = params;
+  const isNew = cacheItem.new || !cacheItem._extend?.endDate;
+  const _cacheItem = {
+    ...cacheItem
+  };
+  const resourcesOriginMap = ctx.resourcesOriginMap || {};
+  _cacheItem._data = {};
+  if ((0, _serviceTimes.isMultiDayProduct)(cacheItem)) {
+    _cacheItem._extend = _cacheItem._extend || {};
+    _cacheItem._extend.holder_id = cacheItem?._extend?.holder_id || [];
+    _cacheItem._extend.sub_type = 'days';
+  }
+  if (isNew) {
+    _cacheItem._data.timeObj = getTimeObj({
+      cacheItem,
+      ctx
+    });
+    _cacheItem._extend = getServiceStartTimeAndEndTime({
+      cacheItem,
+      timeObj: _cacheItem._data.timeObj,
+      ctx
+    });
+    _cacheItem._data.capacitys = cacheItem.capacity;
+    _cacheItem._data.resourcesOrigin = (0, _resources.getResourceByIds)(resourcesOriginMap, cacheItem, {
+      resourceTab: ctx?.bookingConfig?.config?.resource_tab,
+      resourcesOrigin: ctx.resourcesOrigin || []
+    });
+    _cacheItem._extend.capacity = (0, _resources.setDefaultCapacitys)({
+      capacitys: _cacheItem._data.capacitys,
+      cacheItem: _cacheItem
+    });
+    const {
+      list,
+      maps
+    } = (0, _resources.formatResources)({
+      cacheItem: _cacheItem,
+      resourcesOrigin: _cacheItem._data.resourcesOrigin
+    });
+    _cacheItem._data.resources = list;
+    _cacheItem._data.resourceMaps = maps;
+    _cacheItem._extend.resource = (0, _resources.setDefaultResource)({
+      cacheItem: _cacheItem,
+      resources: _cacheItem._data.resources,
+      resourceIdFromCalendar: ctx.resourceIdFromCalendar,
+      isAutoAllocationOn: ctx.isAutoAllocationOn
+    });
+
+    // 灵活时长二次计算（资源默认选中后，按 usableTime 重算 flexible 分钟数）
+    if ((0, _flexible.isProductFlexibleDuration)(_cacheItem?.duration)) {
+      _cacheItem._data.timeObj = getTimeObj({
+        cacheItem: _cacheItem,
+        useStartTime: _cacheItem._extend.start_time,
+        ctx
+      });
+      _cacheItem._extend.duration = _cacheItem._data.timeObj?.durationSlicesBasedOnTime?.[0]?.value;
+      const {
+        endDate
+      } = (0, _serviceTimes.getServiceTimes)(_cacheItem);
+      _cacheItem._extend.endDate = endDate;
+    }
+    _cacheItem.autoClose = getIsAutoClose(_cacheItem, ctx.isAutoAllocationOn || (() => true));
+    if (_cacheItem._extend.bundle_edit !== undefined) {
+      _cacheItem._extend.bundle_edit = 1;
+    }
+    if (!isDisabledTime) {
+      _cacheItem._time = new Date().getTime();
+    }
+  } else {
+    if (!_cacheItem._data.capacitys) {
+      _cacheItem._data.capacitys = cacheItem.capacity;
+    }
+    if (!_cacheItem._data.resourcesOrigin) {
+      const extraResources = [];
+      if (Array.isArray(_cacheItem._extend?.event_resources)) {
+        _cacheItem._extend.event_resources.forEach(er => {
+          extraResources.push({
+            form_id: er.form_id,
+            id: er.relation_id
+          });
+        });
+      }
+      _cacheItem._data.resourcesOrigin = (0, _resources.getResourceByIds)(resourcesOriginMap, cacheItem, {
+        extraResources,
+        resourceTab: ctx?.bookingConfig?.config?.resource_tab,
+        resourcesOrigin: ctx.resourcesOrigin || []
+      });
+    }
+    if (!_cacheItem._data.resources) {
+      const {
+        list,
+        maps
+      } = (0, _resources.formatResources)({
+        cacheItem: _cacheItem,
+        resourcesOrigin: _cacheItem._data.resourcesOrigin
+      });
+      _cacheItem._data.resources = list;
+      _cacheItem._data.resourceMaps = maps;
+    }
+    _cacheItem._data.timeObj = getTimeObj({
+      cacheItem: _cacheItem,
+      useStartTime: _cacheItem._extend?.start_time,
+      ctx
+    });
+  }
+  return _cacheItem;
+}
+
+/**
+ * 是否可自动关闭弹窗（不需要用户进 EditService 抽屉）。
+ * 与 info2 `service/addService/utils.tsx#getIsAutoClose` 等价；
+ * `getAutoAllocationStorage` 抽象为入参 `isAutoAllocationOn(formId)`。
+ */
+function getIsAutoClose(cacheItem, isAutoAllocationOn) {
+  if ((0, _resourceSelection.productNeedsResourceExtend)(cacheItem) && !(0, _resourceSelection.hasActualResourceSelection)(cacheItem)) {
+    return false;
+  }
+  if (cacheItem._data?.capacitys?.type !== 'custom') {
+    const resources = cacheItem?._data?.resources || [];
+    if (resources.length === 1) {
+      const first = resources[0];
+      if (first.select_type?.type === 'single' && (first.default_resource || []).length > 0) {
+        return true;
+      }
+    }
+  }
+  const entries = Object.entries(cacheItem._extend?.resource || {});
+  if (entries.length === 0) {
+    return !(0, _resourceSelection.productNeedsResourceExtend)(cacheItem);
+  }
+  return entries.every(([key, value]) => isAutoAllocationOn(key) && Array.isArray(value) && value.length > 0);
+}

package/lib/modules/BookingContext/utils/resourceErrors.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 结构化的「资源不可用」原因（替代 info2 `getErrorList` 输出的 i18n 文案 + type 字段）。
+ *
+ * 与 info2 type 字段映射：
+ *   - `no_product` ↔ type='products'
+ *   - `time_out_of_range` ↔ type='time'
+ *   - `count_out_of_range` ↔ type='limit'
+ *   - `resource_unbound` ↔ type='unbound'
+ *
+ * OS 这边不耦合 i18n 文案，UI 拿到 reason + params 后自行渲染（参考 docs/SDK 中给出的 i18n key 对照表）。
+ */
+export type ResourceUnavailableReason = 'no_product' | 'time_out_of_range' | 'count_out_of_range' | 'resource_unbound';
+export interface ResourceError {
+    reason: ResourceUnavailableReason;
+    params: {
+        /** 资源名（time / limit 用）。 */
+        labelText?: string;
+        /** 起始时间（time / limit 用，格式 'hh:mm A'）。 */
+        startText?: string;
+        /** 结束时间（time / limit 用，格式 'hh:mm A'）。 */
+        endText?: string;
+        /**
+         * 结束时间是否跨到第二天。UI 收到 true 时可在 endText 前加 'tomorrow' / '明天' 前缀。
+         * 与 info2 旧实现「endText = locales.getText('pisell1.text.tomorrow') + endText」等价。
+         */
+        isCrossDay?: boolean;
+    };
+}
+/**
+ * 替代 info2 `utilsByBooking.ts#getErrorList`，输出结构化错误。
+ *
+ * 行为对齐：
+ *   1. cacheItem 没有 id → `no_product`（与 info2 `!cacheItem?.id` 分支等价）。
+ *   2. 资源 null / 无 _extend → 返回 []。
+ *   3. resource.usable=false 时：
+ *      - 没有 _extend.usableTime → `time_out_of_range`
+ *      - 有 usableTime 但 `_extend.isCountRange=false` → `count_out_of_range`
+ *   4. resource.unbound=true → 追加 `resource_unbound`。
+ *   5. 不再耦合 `_data.resourceMaps[form_id].type === 'single'` 判断（与 info2 实际未使用此变量一致）。
+ */
+export declare function getResourceErrors(resource: any, cacheItem: any): ResourceError[];

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

@@ -0,0 +1,80 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getResourceErrors = getResourceErrors;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _serviceTimes = require("./serviceTimes");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * 结构化的「资源不可用」原因（替代 info2 `getErrorList` 输出的 i18n 文案 + type 字段）。
+ *
+ * 与 info2 type 字段映射：
+ *   - `no_product` ↔ type='products'
+ *   - `time_out_of_range` ↔ type='time'
+ *   - `count_out_of_range` ↔ type='limit'
+ *   - `resource_unbound` ↔ type='unbound'
+ *
+ * OS 这边不耦合 i18n 文案，UI 拿到 reason + params 后自行渲染（参考 docs/SDK 中给出的 i18n key 对照表）。
+ */
+
+/**
+ * 替代 info2 `utilsByBooking.ts#getErrorList`，输出结构化错误。
+ *
+ * 行为对齐：
+ *   1. cacheItem 没有 id → `no_product`（与 info2 `!cacheItem?.id` 分支等价）。
+ *   2. 资源 null / 无 _extend → 返回 []。
+ *   3. resource.usable=false 时：
+ *      - 没有 _extend.usableTime → `time_out_of_range`
+ *      - 有 usableTime 但 `_extend.isCountRange=false` → `count_out_of_range`
+ *   4. resource.unbound=true → 追加 `resource_unbound`。
+ *   5. 不再耦合 `_data.resourceMaps[form_id].type === 'single'` 判断（与 info2 实际未使用此变量一致）。
+ */
+function getResourceErrors(resource, cacheItem) {
+  if (!cacheItem?.id) {
+    return [{
+      reason: 'no_product',
+      params: {}
+    }];
+  }
+  if (!resource) return [];
+  const list = [];
+  if (!resource.usable) {
+    const {
+      startDate,
+      endDate
+    } = (0, _serviceTimes.getServiceTimes)(cacheItem);
+    const startText = startDate.format('hh:mm A');
+    const endText = endDate.format('hh:mm A');
+    const isCrossDay = (0, _dayjs.default)(endDate).isAfter(startDate, 'day');
+    if (!resource._extend?.usableTime) {
+      list.push({
+        reason: 'time_out_of_range',
+        params: {
+          labelText: resource.labelText,
+          startText,
+          endText,
+          isCrossDay
+        }
+      });
+    } else if (!resource._extend?.usableTime?._extend?.isCountRange) {
+      list.push({
+        reason: 'count_out_of_range',
+        params: {
+          labelText: resource.labelText,
+          startText,
+          endText,
+          isCrossDay
+        }
+      });
+    }
+  }
+  if (resource.unbound) {
+    list.push({
+      reason: 'resource_unbound',
+      params: {}
+    });
+  }
+  return list;
+}

package/lib/modules/BookingContext/utils/resourceSelection.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 预约商品资源是否「需要补齐 / 已选中」——供 getProductExtend 门禁与 getIsAutoClose 共用。
+ */
+/** 商品是否挂了生效的资源表单（product_resource.resources status=1）。 */
+export declare function productNeedsResourceExtend(cacheItem: any): boolean;
+/** `_extend.resource` 是否至少有一类表单选中了具体资源。 */
+export declare function hasActualResourceSelection(cacheItem: any): boolean;

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

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.hasActualResourceSelection = hasActualResourceSelection;
+exports.productNeedsResourceExtend = productNeedsResourceExtend;
+/**
+ * 预约商品资源是否「需要补齐 / 已选中」——供 getProductExtend 门禁与 getIsAutoClose 共用。
+ */
+
+/** 商品是否挂了生效的资源表单（product_resource.resources status=1）。 */
+function productNeedsResourceExtend(cacheItem) {
+  const forms = cacheItem?.product_resource?.resources;
+  if (!Array.isArray(forms)) return false;
+  return forms.some(d => Number(d?.status) === 1);
+}
+
+/** `_extend.resource` 是否至少有一类表单选中了具体资源。 */
+function hasActualResourceSelection(cacheItem) {
+  const resource = cacheItem?._extend?.resource;
+  if (!resource || typeof resource !== 'object') return false;
+  return Object.values(resource).some(rows => Array.isArray(rows) && rows.length > 0);
+}