@pisell/pisellos 0.0.567 → 0.0.569

package/lib/modules/BaseModule.js

@@ -1,32 +1,17 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";
 
-// src/modules/BaseModule.ts
-var BaseModule_exports = {};
-__export(BaseModule_exports, {
-  BaseModule: () => BaseModule
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(BaseModule_exports);
-var BaseModule = class {
+exports.BaseModule = void 0;
+class BaseModule {
+  defaultName = 'baseModule';
+  defaultVersion = '1.0.0';
+  name;
+  version;
+  isSolution = false;
+  core;
   constructor(name, version) {
-    this.defaultName = "baseModule";
-    this.defaultVersion = "1.0.0";
-    this.isSolution = false;
     this.name = name || this.defaultName;
     this.version = version || this.defaultVersion;
   }
@@ -34,6 +19,7 @@ var BaseModule = class {
     this.core.effects.offByModuleDestroy(this.name);
     this.core.unregisterModule(this);
   }
+
   // 提供统一的缓存 module 里的数据的方法
   checkSaveCache({
     cacheId,
@@ -41,11 +27,11 @@ var BaseModule = class {
     store,
     cacheKey
   }) {
-    const window = this.core.getPlugin("window");
+    const window = this.core.getPlugin('window');
     if (cacheId) {
       if (fatherModule) {
         const currentCacheData = window.sessionStorage.getItem(fatherModule);
-        let currentCacheDataObj = JSON.parse(currentCacheData || "{}");
+        let currentCacheDataObj = JSON.parse(currentCacheData || '{}');
         if (!currentCacheData || !currentCacheDataObj[cacheId]) {
           currentCacheDataObj = {
             [cacheId]: {
@@ -58,46 +44,37 @@ var BaseModule = class {
         if (!currentCacheDataObj[cacheId][this.name]) {
           currentCacheDataObj[cacheId][this.name] = {};
         }
-        cacheKey.forEach((key) => {
-          currentCacheDataObj[cacheId][this.name][key] = store == null ? void 0 : store[key];
+        cacheKey.forEach(key => {
+          currentCacheDataObj[cacheId][this.name][key] = store?.[key];
         });
-        window.sessionStorage.setItem(
-          fatherModule,
-          JSON.stringify(currentCacheDataObj)
-        );
+        window.sessionStorage.setItem(fatherModule, JSON.stringify(currentCacheDataObj));
       } else {
         let currentCacheData = window.sessionStorage.getItem(cacheId);
-        let currentCacheDataObj = JSON.parse(currentCacheData || "{}");
+        let currentCacheDataObj = JSON.parse(currentCacheData || '{}');
         if (!currentCacheDataObj) {
           currentCacheDataObj = {};
         }
         if (!currentCacheDataObj[this.name]) {
           currentCacheDataObj[this.name] = {};
         }
-        cacheKey.forEach((key) => {
+        cacheKey.forEach(key => {
           currentCacheDataObj[this.name][key] = store[key];
         });
-        window.sessionStorage.setItem(
-          cacheId,
-          JSON.stringify(currentCacheDataObj)
-        );
+        window.sessionStorage.setItem(cacheId, JSON.stringify(currentCacheDataObj));
       }
     }
   }
-  effectsOn(eventType, callback, force) {
-    return this.core.effects.on(`${this.name}:${eventType}`, callback, force);
+  effectsOn(eventType, callback) {
+    return this.core.effects.on(`${this.name}:${eventType}`, callback);
   }
   effectsOff(eventType, callback) {
     return this.core.effects.off(`${this.name}:${eventType}`, callback);
   }
-  effectsOnce(eventType, callback, force) {
-    return this.core.effects.once(`${this.name}:${eventType}`, callback, force);
+  effectsOnce(eventType, callback) {
+    return this.core.effects.once(`${this.name}:${eventType}`, callback);
   }
   effectsEmit(eventType, payload) {
     return this.core.effects.emit(`${this.name}:${eventType}`, payload);
   }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  BaseModule
-});
+}
+exports.BaseModule = BaseModule;

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

@@ -0,0 +1,48 @@
+import { Module, ModuleOptions, PisellCore } from '../../types';
+import { BaseModule } from '../BaseModule';
+import { BookingContextConfig, BookingContextDateInput, BookingContextModuleAPI, BookingContextResource, BookingContextResourceMap, BookingContextState, InitBookingContextParams, LoadBookingConfigParams, LoadBookingResourcesParams } from './types';
+export * from './types';
+export * from './utils';
+/**
+ * 清理跨实例共享缓存，仅供单元测试隔离使用。
+ *
+ * @example
+ * __clearBookingContextSharedCacheForTest();
+ */
+export declare function __clearBookingContextSharedCacheForTest(): void;
+/** 稳定序列化 config 查询参数，用于判断是否与上次 loadBookingConfig 一致。 */
+export declare function buildBookingConfigQueryKey(params?: LoadBookingConfigParams): string;
+/** 稳定序列化资源列表查询（date + bookingIds），用于跳过重复 loadResources。 */
+export declare function buildBookingResourcesQueryKey(params?: LoadBookingResourcesParams): string;
+export declare class BookingContextModule extends BaseModule implements Module, BookingContextModuleAPI {
+    protected defaultName: string;
+    protected defaultVersion: string;
+    private request;
+    private store;
+    /** 上次成功 loadBookingConfig 的 query key；命中则不再请求。 */
+    private lastConfigQueryKey;
+    /** 上次成功 loadResources 的 query key（date|bookingIds）；命中则不再请求。 */
+    private lastResourcesQueryKey;
+    constructor(name?: string, version?: string);
+    initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
+    loadBookingConfig(params?: LoadBookingConfigParams, options?: {
+        forceRefresh?: boolean;
+    }): Promise<BookingContextConfig | null>;
+    loadResources(params?: LoadBookingResourcesParams, options?: {
+        forceRefresh?: boolean;
+    }): Promise<BookingContextResource[]>;
+    /**
+     * store 内是否已具备与本次 init 入参等价的 config / resources（不再打接口）。
+     */
+    isBookingContextReady(params?: InitBookingContextParams): boolean;
+    initBookingContext(params?: InitBookingContextParams): Promise<BookingContextState>;
+    setBookingConfig(config: BookingContextConfig | null): void;
+    getBookingConfig(): BookingContextConfig | null;
+    setResources(resources: BookingContextResource[] | null | undefined): void;
+    getResourcesOrigin(): BookingContextResource[];
+    getResourcesOriginMap(): BookingContextResourceMap;
+    setDate(date: BookingContextDateInput): void;
+    getDate(): string | null;
+    getState(): BookingContextState;
+    clear(): void;
+}

package/lib/modules/BookingContext/index.js

@@ -0,0 +1,390 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  __clearBookingContextSharedCacheForTest: true,
+  buildBookingConfigQueryKey: true,
+  buildBookingResourcesQueryKey: true,
+  BookingContextModule: true
+};
+exports.BookingContextModule = void 0;
+exports.__clearBookingContextSharedCacheForTest = __clearBookingContextSharedCacheForTest;
+exports.buildBookingConfigQueryKey = buildBookingConfigQueryKey;
+exports.buildBookingResourcesQueryKey = buildBookingResourcesQueryKey;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _BaseModule = require("../BaseModule");
+var _request = require("../../plugins/request");
+var _types = require("./types");
+Object.keys(_types).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _types[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _types[key];
+    }
+  });
+});
+var _formatResourceList = require("./utils/formatResourceList");
+var _utils = require("./utils");
+Object.keys(_utils).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _utils[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _utils[key];
+    }
+  });
+});
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+const EMPTY_STATE = {
+  bookingConfig: null,
+  resourcesOrigin: [],
+  resourcesOriginMap: {},
+  date: null
+};
+const DEFAULT_BOOKING_CONFIG_PARAMS = {
+  item_type: 'appointment_booking',
+  sub_type: 'ticket'
+};
+const BOARD_CONFIG_CACHE = {
+  useCache: true,
+  cache: {
+    mode: _request.RequestModeENUM.REMOTE_LOCAL,
+    type: 'indexDB',
+    updateCache: true
+  }
+};
+const RESOURCE_LIST_CACHE = {
+  useCache: true,
+  cache: {
+    mode: _request.RequestModeENUM.REMOTE_LOCAL,
+    type: 'memory'
+  }
+};
+const requestScopeIds = new WeakMap();
+let nextRequestScopeId = 1;
+const sharedBookingConfigCache = new Map();
+const sharedBookingConfigPending = new Map();
+const sharedResourcesCache = new Map();
+const sharedResourcesPending = new Map();
+
+/**
+ * 为 request 插件生成稳定作用域，避免不同 request 客户端之间共享缓存数据。
+ *
+ * @example
+ * const scopedKey = buildSharedCacheKey(requestPlugin, '{"sub_type":"ticket"}');
+ */
+function getRequestScopeId(request) {
+  const key = request;
+  const existed = requestScopeIds.get(key);
+  if (existed) return existed;
+  const id = nextRequestScopeId++;
+  requestScopeIds.set(key, id);
+  return id;
+}
+
+/**
+ * 共享缓存 key = request 作用域 + 已稳定序列化的业务参数。
+ *
+ * @example
+ * const cacheKey = buildSharedCacheKey(requestPlugin, '2026-06-10|1,2');
+ */
+function buildSharedCacheKey(request, queryKey) {
+  return `${getRequestScopeId(request)}:${queryKey}`;
+}
+
+/**
+ * 清理跨实例共享缓存，仅供单元测试隔离使用。
+ *
+ * @example
+ * __clearBookingContextSharedCacheForTest();
+ */
+function __clearBookingContextSharedCacheForTest() {
+  sharedBookingConfigCache.clear();
+  sharedBookingConfigPending.clear();
+  sharedResourcesCache.clear();
+  sharedResourcesPending.clear();
+}
+
+/**
+ * 把多形态 date 入参 normalize 成字符串。
+ * - dayjs 实例：调用 format()（无参 ISO）。
+ * - Date 实例：toISOString()。
+ * - 字符串：原样保留。
+ * - null/undefined/空串：→ null。
+ */
+function normalizeDate(input) {
+  if (input === null || input === undefined) return null;
+  if (typeof input === 'string') return input || null;
+  if (input instanceof Date) return input.toISOString();
+  if (typeof input.format === 'function') {
+    try {
+      return input.format() || null;
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+
+/** 资源接口使用的 `YYYY-MM-DD` 日期串。 */
+function toScheduleQueryDate(input) {
+  const normalized = normalizeDate(input);
+  if (!normalized) return (0, _dayjs.default)().format('YYYY-MM-DD');
+  const parsed = (0, _dayjs.default)(normalized);
+  return parsed.isValid() ? parsed.format('YYYY-MM-DD') : (0, _dayjs.default)().format('YYYY-MM-DD');
+}
+
+/**
+ * 由 resources 数组派生出以 id 为 key 的 map，便于 `getResourceByIds` 直接命中。
+ */
+function buildResourcesMap(resources) {
+  const map = {};
+  resources.forEach(resource => {
+    if (resource && resource.id !== undefined && resource.id !== null) {
+      map[String(resource.id)] = resource;
+    }
+  });
+  return map;
+}
+
+/** 稳定序列化 config 查询参数，用于判断是否与上次 loadBookingConfig 一致。 */
+function buildBookingConfigQueryKey(params = {}) {
+  const merged = {
+    ...DEFAULT_BOOKING_CONFIG_PARAMS,
+    ...params
+  };
+  const keys = Object.keys(merged).sort();
+  const sorted = {};
+  keys.forEach(k => {
+    sorted[k] = merged[k];
+  });
+  return JSON.stringify(sorted);
+}
+
+/** 稳定序列化资源列表查询（date + bookingIds），用于跳过重复 loadResources。 */
+function buildBookingResourcesQueryKey(params = {}) {
+  const date = toScheduleQueryDate(params.date);
+  const ids = (params.bookingIds || []).filter(id => typeof id === 'number' && Number.isFinite(id)).sort((a, b) => a - b);
+  return `${date}|${ids.join(',')}`;
+}
+class BookingContextModule extends _BaseModule.BaseModule {
+  defaultName = 'bookingContext';
+  defaultVersion = '1.0.0';
+  request;
+  store = {
+    ...EMPTY_STATE
+  };
+  /** 上次成功 loadBookingConfig 的 query key；命中则不再请求。 */
+  lastConfigQueryKey = null;
+  /** 上次成功 loadResources 的 query key（date|bookingIds）；命中则不再请求。 */
+  lastResourcesQueryKey = null;
+  constructor(name, version) {
+    super(name, version);
+  }
+  async initialize(core, options = {}) {
+    this.core = core;
+    this.request = core.getPlugin('request');
+    if (!this.request) {
+      throw new Error('BookingContextModule 需要 request 插件支持');
+    }
+    this.store = {
+      bookingConfig: null,
+      resourcesOrigin: [],
+      resourcesOriginMap: {},
+      date: null
+    };
+    const initialState = options.initialState || {};
+    if (initialState.bookingConfig) {
+      this.store.bookingConfig = initialState.bookingConfig;
+    }
+    if (Array.isArray(initialState.resourcesOrigin)) {
+      this.store.resourcesOrigin = initialState.resourcesOrigin;
+      this.store.resourcesOriginMap = buildResourcesMap(initialState.resourcesOrigin);
+    }
+    if (initialState.date) {
+      this.store.date = initialState.date;
+    }
+  }
+  async loadBookingConfig(params = {}, options = {}) {
+    const configKey = buildBookingConfigQueryKey(params);
+    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;
+      this.setBookingConfig(cached);
+      this.lastConfigQueryKey = configKey;
+      return cached;
+    }
+    let pending = !options.forceRefresh ? sharedBookingConfigPending.get(sharedKey) : undefined;
+    if (!pending) {
+      const requestPromise = (async () => {
+        try {
+          const res = await this.request.get('/core/board/management/config', query, BOARD_CONFIG_CACHE);
+          const config = res?.data ?? null;
+          sharedBookingConfigCache.set(sharedKey, config);
+          return config;
+        } finally {
+          sharedBookingConfigPending.delete(sharedKey);
+        }
+      })();
+      pending = requestPromise;
+      sharedBookingConfigPending.set(sharedKey, requestPromise);
+    }
+    const config = await pending;
+    this.setBookingConfig(config);
+    this.lastConfigQueryKey = configKey;
+    return config;
+  }
+  async loadResources(params = {}, options = {}) {
+    const date = toScheduleQueryDate(params.date ?? this.store.date);
+    const resourcesKey = buildBookingResourcesQueryKey({
+      date,
+      bookingIds: params.bookingIds
+    });
+    if (!options.forceRefresh && this.lastResourcesQueryKey === resourcesKey) {
+      return this.getResourcesOrigin();
+    }
+    const sharedKey = buildSharedCacheKey(this.request, resourcesKey);
+    if (!options.forceRefresh && sharedResourcesCache.has(sharedKey)) {
+      const cached = sharedResourcesCache.get(sharedKey) ?? [];
+      this.setResources(cached);
+      this.lastResourcesQueryKey = resourcesKey;
+      return this.getResourcesOrigin();
+    }
+    let pending = !options.forceRefresh ? sharedResourcesPending.get(sharedKey) : undefined;
+    if (!pending) {
+      const requestPromise = (async () => {
+        try {
+          const res = await this.request.get('/schedule/resource/list', {
+            date
+          }, RESOURCE_LIST_CACHE);
+          const {
+            list
+          } = (0, _formatResourceList.formatResourceListAndMap)(res?.data, params.bookingIds || []);
+          sharedResourcesCache.set(sharedKey, list);
+          return list;
+        } finally {
+          sharedResourcesPending.delete(sharedKey);
+        }
+      })();
+      pending = requestPromise;
+      sharedResourcesPending.set(sharedKey, requestPromise);
+    }
+    const list = await pending;
+    this.setResources(list);
+    this.lastResourcesQueryKey = resourcesKey;
+    return this.getResourcesOrigin();
+  }
+
+  /**
+   * store 内是否已具备与本次 init 入参等价的 config / resources（不再打接口）。
+   */
+  isBookingContextReady(params = {}) {
+    const configKey = buildBookingConfigQueryKey(params.bookingConfigParams);
+    const dateInput = params.date ?? this.store.date ?? (0, _dayjs.default)();
+    const queryDate = toScheduleQueryDate(dateInput);
+    const resourcesKey = buildBookingResourcesQueryKey({
+      date: queryDate,
+      bookingIds: params.bookingIds
+    });
+    const configReady = this.store.bookingConfig != null && this.lastConfigQueryKey === configKey;
+    const resourcesReady = params.loadResources === false || this.lastResourcesQueryKey === resourcesKey;
+    return configReady && resourcesReady;
+  }
+  async initBookingContext(params = {}) {
+    const dateInput = params.date ?? this.store.date ?? (0, _dayjs.default)();
+    const queryDate = toScheduleQueryDate(dateInput);
+    this.setDate(dateInput);
+    if (!params.forceRefresh && this.isBookingContextReady(params)) {
+      return this.getState();
+    }
+    const configKey = buildBookingConfigQueryKey(params.bookingConfigParams);
+    const resourcesKey = buildBookingResourcesQueryKey({
+      date: queryDate,
+      bookingIds: params.bookingIds
+    });
+    const needConfig = params.forceRefresh || this.store.bookingConfig == null || this.lastConfigQueryKey !== configKey;
+    const needResources = params.loadResources !== false && (params.forceRefresh || this.lastResourcesQueryKey !== resourcesKey);
+    if (needConfig) {
+      await this.loadBookingConfig(params.bookingConfigParams, {
+        forceRefresh: params.forceRefresh
+      });
+    }
+    if (needResources) {
+      await this.loadResources({
+        date: queryDate,
+        bookingIds: params.bookingIds
+      }, {
+        forceRefresh: params.forceRefresh
+      });
+    }
+    return this.getState();
+  }
+  setBookingConfig(config) {
+    this.store.bookingConfig = config || null;
+    this.core.effects.emit(`${this.name}:${_types.BookingContextEvent.OnBookingConfigChange}`, this.store.bookingConfig);
+  }
+  getBookingConfig() {
+    return this.store.bookingConfig;
+  }
+  setResources(resources) {
+    const list = Array.isArray(resources) ? resources : [];
+    this.store.resourcesOrigin = list;
+    this.store.resourcesOriginMap = buildResourcesMap(list);
+    this.core.effects.emit(`${this.name}:${_types.BookingContextEvent.OnResourcesChange}`, {
+      resourcesOrigin: this.store.resourcesOrigin,
+      resourcesOriginMap: this.store.resourcesOriginMap
+    });
+  }
+  getResourcesOrigin() {
+    return [...this.store.resourcesOrigin];
+  }
+  getResourcesOriginMap() {
+    return this.store.resourcesOriginMap;
+  }
+  setDate(date) {
+    this.store.date = normalizeDate(date);
+    this.core.effects.emit(`${this.name}:${_types.BookingContextEvent.OnDateChange}`, this.store.date);
+  }
+  getDate() {
+    return this.store.date;
+  }
+  getState() {
+    return {
+      bookingConfig: this.store.bookingConfig,
+      resourcesOrigin: [...this.store.resourcesOrigin],
+      resourcesOriginMap: this.store.resourcesOriginMap,
+      date: this.store.date
+    };
+  }
+  clear() {
+    this.lastConfigQueryKey = null;
+    this.lastResourcesQueryKey = null;
+    this.store = {
+      bookingConfig: null,
+      resourcesOrigin: [],
+      resourcesOriginMap: {},
+      date: null
+    };
+    this.core.effects.emit(`${this.name}:${_types.BookingContextEvent.OnBookingConfigChange}`, null);
+    this.core.effects.emit(`${this.name}:${_types.BookingContextEvent.OnResourcesChange}`, {
+      resourcesOrigin: [],
+      resourcesOriginMap: {}
+    });
+    this.core.effects.emit(`${this.name}:${_types.BookingContextEvent.OnDateChange}`, null);
+  }
+}
+exports.BookingContextModule = BookingContextModule;

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

@@ -0,0 +1,102 @@
+/**
+ * BookingContext 子模块：承载「预约 UI 上下文」三件套。
+ *
+ *  - bookingConfig：来自 `/core/board/management/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 的输入。
+ *  - date：当前选择的日期（dayjs 或 ISO 字符串，迁移后内部统一存原始 ISO 字符串，UI 可自行解析）。
+ *
+ * 设计原则（与 BookingTicket 现状对齐）：
+ *  - 默认由 `loadBookingConfig` / `loadResources` 拉取并写入 store；也支持消费方 `set*` 直接灌入（复用 ticketBooking 已拉到的数据）。
+ *  - 所有读 API 返回浅克隆（数组）或原引用（map / config），避免 UI 写穿。
+ */
+/** `loadBookingConfig` 入参，与 ticketBooking `getBookingConfig` 一致。 */
+export interface LoadBookingConfigParams {
+    item_type?: string;
+    sub_type?: string;
+    source_type?: string;
+    [key: string]: any;
+}
+/** `loadResources` 入参，与 info2 `getResourceList` 一致。 */
+export interface LoadBookingResourcesParams {
+    /** 查询日期，`YYYY-MM-DD`；缺省用 store 内已 set 的 date，再缺省为当天。 */
+    date?: string;
+    /** 编辑态排除容量占用用的 booking id 列表。 */
+    bookingIds?: number[];
+}
+/** `initBookingContext` 入参（BookingTicket 聚合入口）。 */
+export interface InitBookingContextParams {
+    bookingConfigParams?: LoadBookingConfigParams;
+    date?: BookingContextDateInput;
+    /** 是否拉资源列表，默认 true。 */
+    loadResources?: boolean;
+    bookingIds?: number[];
+    /** 为 true 时忽略内存命中，强制重新请求（默认 false）。 */
+    forceRefresh?: boolean;
+}
+/**
+ * 资源全集 map：key 为资源 id（数字），value 为资源原始对象，含 times / event_list 等运行态。
+ * 这里只声明 Record 形态；具体字段保留 `any`，与 ticketBooking 现网传入的数据形状兼容。
+ */
+export type BookingContextResource = Record<string, any>;
+export type BookingContextResourceMap = Record<string, BookingContextResource>;
+/**
+ * 形参 booking_config（结构来自 `/core/board/management/config` 接口）。
+ * OS 不强制 schema，保留 `Record<string, any>` 兼容现网；常用路径文档化在 SDK docs。
+ */
+export type BookingContextConfig = Record<string, any>;
+/**
+ * 日期入参：接受 dayjs 实例、ISO 字符串、Date 实例；内部统一 normalize 为 ISO 字符串保存。
+ */
+export type BookingContextDateInput = string | Date | {
+    format?: (fmt?: string) => string;
+} | null | undefined;
+/**
+ * 内部 store 形态。`resourcesOriginMap` 由 `setResources` 派生，不允许外部直接 set。
+ */
+export interface BookingContextState {
+    bookingConfig: BookingContextConfig | null;
+    resourcesOrigin: BookingContextResource[];
+    resourcesOriginMap: BookingContextResourceMap;
+    /**
+     * 当前选择的日期，统一 ISO 字符串（'YYYY-MM-DD HH:mm:ss' 或 'YYYY-MM-DD'）。
+     * UI 取出后可自行 dayjs 解析；OS 内的计算 helper 都接受 string，不做 dayjs 依赖。
+     */
+    date: string | null;
+}
+/**
+ * BookingContextModule 对外 API（给 BookingTicket / SDK Provider 透传消费）。
+ */
+export interface BookingContextModuleAPI {
+    setBookingConfig(config: BookingContextConfig | null): void;
+    getBookingConfig(): BookingContextConfig | null;
+    setResources(resources: BookingContextResource[] | null | undefined): void;
+    getResourcesOrigin(): BookingContextResource[];
+    getResourcesOriginMap(): BookingContextResourceMap;
+    setDate(date: BookingContextDateInput): void;
+    getDate(): string | null;
+    /** 当前 store 的浅克隆，调试 / 测试用。 */
+    getState(): BookingContextState;
+    /** 一键清空，destroy / 切租户场景用。 */
+    clear(): void;
+    /** 拉取 board config 并写入 store（`/core/board/management/config`）。 */
+    loadBookingConfig(params?: LoadBookingConfigParams): Promise<BookingContextConfig | null>;
+    /** 拉取资源全集并写入 store（`/schedule/resource/list`）。 */
+    loadResources(params?: LoadBookingResourcesParams): Promise<BookingContextResource[]>;
+    /**
+     * 依次 setDate → loadBookingConfig → loadResources。
+     * SalesSdkProvider 挂载时默认调用 BookingTicket.initBookingContext。
+     */
+    initBookingContext(params?: InitBookingContextParams): Promise<BookingContextState>;
+    /** store 是否已具备与入参等价的 config / resources（无需再请求）。 */
+    isBookingContextReady(params?: InitBookingContextParams): boolean;
+}
+/**
+ * BookingContextModule 事件名常量（采用 `${this.name}:` 前缀，与现有模块一致）。
+ */
+export declare enum BookingContextEvent {
+    OnBookingConfigChange = "onBookingConfigChange",
+    OnResourcesChange = "onResourcesChange",
+    OnDateChange = "onDateChange"
+}