@pisell/private-materials 6.3.142 → 6.3.144

package/es/components/venueBooking/types.d.ts

@@ -1,204 +0,0 @@
-/// <reference types="react" />
-import type { Dayjs } from 'dayjs';
-/** 场地预订步骤枚举 */
-export declare type VenueBookingStepKey = 'select-venue' | 'addons' | 'checkout';
-/** 场地预订组件入口 props */
-export interface VenueBookingProps {
-    biz?: string;
-    resource_id?: string;
-}
-/** 标准化后的入口上下文（从 engine props 提取） */
-export interface VenueBookingEntryContext {
-    biz: string;
-    resource_id?: string;
-}
-/** 单个时段（来自 getTimeSlotGrid） */
-export interface VenueResourceSlot {
-    startTime: string;
-    endTime: string;
-    status: 'past' | 'occupied' | 'available' | 'partially_occupied' | 'unavailable';
-    price: string | null;
-    /** per-product 子行的 slot 带 productId；外层合并 slot 不带 */
-    productId?: number;
-}
-/** 多商品共享一个 resource 时的子行 */
-export interface VenueResourceSubRow {
-    productId: number;
-    productTitle: string;
-    price: string;
-    slots: VenueResourceSlot[];
-}
-/** 单个资源/场地（来自 getTimeSlotGrid） */
-export interface VenueResource {
-    resourceId: number;
-    resourceName: string;
-    /** 单商品时唯一；多商品时取第一个（兼容字段，请优先使用 products） */
-    productId: number;
-    productTitle: string;
-    slots: VenueResourceSlot[];
-    /** 多商品子行；仅当 hasMultipleProducts 时存在 */
-    products?: VenueResourceSubRow[];
-    hasMultipleProducts?: boolean;
-    /** 组合资源元信息（combined_resource.status === 1） */
-    combinedResource?: {
-        resourceIds: Array<number | string>;
-    };
-}
-/** 日期时段网格（来自 getTimeSlotGrid） */
-export interface VenueTimeSlotGrid {
-    date: string;
-    timeLabels: string[];
-    resources: VenueResource[];
-}
-/** 日期概览（来自 getDateRangeSummary） */
-export interface VenueDateSummaryItem {
-    date: string;
-    status: 'available' | 'few_left' | 'sold_out' | 'unavailable';
-    startingPrice: string | null;
-    totalSlots: number;
-    availableSlots: number;
-}
-/** 时段价格信息（用于 TimeGrid 渲染样式） */
-export interface SlotPriceInfo {
-    price: number;
-    originalPrice: number | null;
-    label: string;
-    highlight: boolean;
-}
-/** 时段标签（Off-Peak / Promo 等） */
-export interface SlotTag {
-    text: string;
-    className: string;
-}
-/** 日期元数据（用于 DayTabs 展示状态标签） */
-export interface DateMeta {
-    topTag: string | null;
-    startingPrice: string | null;
-    fewLeft: boolean;
-    soldOut: boolean;
-    unavailable: boolean;
-}
-/** 场地维度的可用性概况 */
-export interface CourtMeta {
-    soldOut: boolean;
-    fewLeft: boolean;
-}
-/** 时段维度的可用性概况 */
-export interface TimeMeta {
-    soldOut: boolean;
-    fewLeft: boolean;
-}
-/**
- * 视图模型 -- 聚合场地数据 + OS 模块数据
- * dateSummary / timeSlotGrid 来自 PisellOS venueBooking 模块
- * cartItems / summary / note 从 OS 模块快照构建
- */
-export interface VenueBookingViewModel {
-    /** 一周日期概览（状态 + 起步价） */
-    dateSummary: VenueDateSummaryItem[];
-    /** 当前选中日期的时段网格（资源 × 时段） */
-    timeSlotGrid: VenueTimeSlotGrid | null;
-    /** 购物车商品列表（ShoppingCart 组件所需格式） */
-    cartItems: any[];
-    /** 金额汇总对象（total_amount / tax_fee 等） */
-    summary: Record<string, any>;
-    /** 订单备注 */
-    note: string;
-    /** 联系人信息（tempOrder.contacts_info） */
-    contactsInfo: any[];
-    /** 场地商品列表（来自 loadVenueProducts / getVenueProducts） */
-    venueProducts: any[];
-    /** 附加商品列表（缓存在 context 中，避免步骤切换时丢失） */
-    addonProductList: any[];
-}
-/** Context 暴露给所有子组件的完整值类型 */
-export interface VenueBookingContextValue {
-    /** PisellOS venueBooking 模块实例 */
-    venueBookingModule: any;
-    /** 当前步骤 */
-    currentStep: VenueBookingStepKey;
-    /** 步骤列表 */
-    stepList: VenueBookingStepKey[];
-    /** 聚合视图模型 */
-    viewModel: VenueBookingViewModel;
-    /** 日历锚点日期 */
-    anchorDate: Dayjs;
-    /** 场地类型筛选器 */
-    filter: string;
-    /** 场地搜索关键字 */
-    search: string;
-    /** 数据加载中（初始 bootstrap） */
-    isLoading: boolean;
-    /** 周视图（dateSummary）加载中：拉取一周场地概览网络请求期间为 true */
-    isWeekLoading: boolean;
-    /** 时段网格（timeSlotGrid）加载中：切换日期 / 切换周时短暂为 true */
-    isGridLoading: boolean;
-    /** 预订上限提示信息 */
-    limitMessage: string;
-    /** 移动端购物车抽屉是否展开 */
-    mobileCartOpen: boolean;
-    /** 月份选择器是否展开 */
-    monthPickerOpen: boolean;
-    /** 月份选择器当前游标月份 */
-    monthCursor: Dayjs;
-    /** 是否满足进入下一步的条件 */
-    canNext: boolean;
-    /** 购物车校验状态（从 OS 事件同步） */
-    cartValidation: {
-        passed: boolean | null;
-        failures: any[];
-    };
-    /** Footer 操作按钮文案 */
-    footerActionText: string;
-    /** 下单提交中状态 */
-    isSubmittingOrder: boolean;
-    /** 是否已登录 */
-    isLogin: boolean;
-    /** 打开登录弹窗 */
-    openLoginModal: (params: {
-        callback: (status: string) => void;
-    }) => void;
-    /** 当前折扣/优惠券列表 */
-    discountList: any[];
-    /** 定金协议是否已勾选 */
-    isAgreeDepositPolicy: boolean;
-    /** 设置定金协议勾选状态 */
-    setIsAgreeDepositPolicy: (val: boolean) => void;
-    /** 步骤导航：跳转到指定步骤 */
-    goToStep: (step: VenueBookingStepKey) => void;
-    /** 步骤导航：下一步 */
-    nextStep: () => void;
-    /** 步骤导航：上一步 */
-    prevStep: () => void;
-    setAnchorDate: (date: Dayjs) => void;
-    setFilter: (filter: string) => void;
-    setSearch: (search: string) => void;
-    setLimitMessage: (msg: string) => void;
-    setMobileCartOpen: (open: boolean) => void;
-    setMonthPickerOpen: (open: boolean) => void;
-    setMonthCursor: (cursor: Dayjs) => void;
-    setFooterActionText: (text: string) => void;
-    /** 切换选中/取消某个时段（调用 OS venueBooking.toggleSlot） */
-    toggleSlot: (resourceId: number, productId: number, slot: VenueResourceSlot) => Promise<void>;
-    /** 刷新 OS 模块视图模型（调用 getSummary + 重建 viewModel），可选传入额外字段合并 */
-    refreshViewModel: (extraFields?: Partial<VenueBookingViewModel>) => Promise<void>;
-    /** 拉取指定周的资源数据并刷新 dateSummary + timeSlotGrid */
-    fetchWeekData: (startDate: string, endDate: string) => Promise<void>;
-    /** 从指定日期开始自动跳转到最近可用日期（必要时自动滚到后续周） */
-    goToNearestAvailableDate: (fromDate: Dayjs) => Promise<void>;
-    /** 刷新当前日期的 timeSlotGrid */
-    refreshTimeSlotGrid: (date?: string) => void;
-    /** 安全调用 OS 模块方法的快捷入口 */
-    runModuleAction: (actionName: string, ...args: any[]) => Promise<any>;
-    /** 更新订单备注到 OS 模块 */
-    updateOrderNote: (note: string) => Promise<void>;
-    /** 主操作按钮行为（根据当前步骤不同执行不同逻辑） */
-    handlePrimaryAction: () => void;
-    /** 结账步骤提交订单 */
-    handleSubmitOrder: () => Promise<void>;
-}
-/** Provider 组件的 props */
-export interface VenueBookingProviderProps {
-    entryContext: VenueBookingEntryContext;
-    children: React.ReactNode;
-}

package/lib/components/scanOrder/components/Cart/index.d.ts

@@ -1,16 +0,0 @@
-import React from 'react';
-import './index.less';
-interface CartProps {
-    open: boolean;
-    onCancel: () => void;
-    onNext: () => void;
-    items: any[];
-    summary: Record<string, any>;
-    embedded?: boolean;
-    confirmLoading?: boolean;
-    extraContent?: React.ReactNode;
-    /** 视觉禁用：按钮仍会触发 onNext，由父级自行拦截（用于弹 toast 等反馈） */
-    disabled?: boolean;
-}
-export default function Cart(props: CartProps): JSX.Element | null;
-export {};

package/lib/components/scanOrder/components/Check/index.d.ts

@@ -1,3 +0,0 @@
-/// <reference types="react" />
-import './index.less';
-export default function Check(): JSX.Element;

package/lib/components/scanOrder/components/Content/index.d.ts

@@ -1,3 +0,0 @@
-/// <reference types="react" />
-import './index.less';
-export default function Content(): JSX.Element;

package/lib/components/scanOrder/components/Footer/index.d.ts

@@ -1,12 +0,0 @@
-/// <reference types="react" />
-import './index.less';
-interface FooterProps {
-    cartItems: any[];
-    summary: Record<string, any>;
-    actionText: string;
-    onAction: () => void;
-    /** 视觉禁用：按钮仍会触发 onAction，由父级自行拦截（用于弹 toast 等反馈） */
-    disabled?: boolean;
-}
-export default function Footer(props: FooterProps): JSX.Element;
-export {};

package/lib/components/scanOrder/components/Menu/index.d.ts

@@ -1,18 +0,0 @@
-/// <reference types="react" />
-interface MenuProps {
-    onCheckout: () => void;
-    /**
-     * 商品列表（由上层 ReadyState 持有，配合 onEnsureProductList 做幂等拉取与持久化：
-     * 切 step 回到 product 时 Menu 会 remount，但 productList 在 ReadyState 不会丢）
-     */
-    productList: any[];
-    /**
-     * 幂等触发商品列表拉取。Menu mount 时调用：
-     * - 首次：真发请求
-     * - 后续（如从 check 返回 product）：命中缓存，直接短路，不重复发请求
-     */
-    isProductListLoading: boolean;
-    onEnsureProductList: () => Promise<void>;
-}
-export default function Menu(props: MenuProps): JSX.Element;
-export {};

package/lib/components/scanOrder/types.d.ts

@@ -1,79 +0,0 @@
-import React from 'react';
-export interface ScanOrderEntryContext {
-    biz: string;
-    resource_id?: string;
-    order_id?: string;
-}
-export interface ScanOrderProps {
-    biz?: string;
-    resource_id?: string;
-    order_id?: string;
-    entryContext?: ScanOrderEntryContext;
-}
-export declare type ScanOrderStepKey = 'init' | 'product' | 'check' | 'error';
-export declare type ScanOrderEntryMode = 'default' | 'additional_order';
-/** 步骤缓存中记录的 gate 标记（对应协议 / 表单 / 人数 modal 是否已走过） */
-export declare type ScanOrderGateKey = 'policyAccepted' | 'formSubmitted' | 'paxEntered';
-/** 存入 sessionStorage 桶内的 entryContext 快照（用于校验是否同一扫码场景） */
-export interface ScanOrderCachedEntryContext {
-    resourceId?: string;
-    hasOrderId?: boolean;
-    biz?: string;
-}
-export interface ScanOrderViewModel {
-    menuItems: any[];
-    cartItems: any[];
-    summary: Record<string, any>;
-    note: string;
-}
-export interface ScanOrderContextValue {
-    entryContext: ScanOrderEntryContext;
-    scanOrderModule: any;
-    cartValidation: {
-        passed: boolean | null;
-        failures: any[];
-    };
-    isLoading: boolean;
-    errorMessage: string;
-    currentStep: ScanOrderStepKey;
-    stepList: ScanOrderStepKey[];
-    viewModel: ScanOrderViewModel;
-    footerActionText: string;
-    tableName: string;
-    entryMode: ScanOrderEntryMode;
-    submitDisabledTips: string;
-    /** 折扣/优惠券列表（来自 scanOrder 模块 getDiscountList） */
-    discountList: any[];
-    isReady: boolean;
-    setCurrentStep: (step: ScanOrderStepKey) => void;
-    setTableName: (name: string) => void;
-    setEntryMode: (mode: ScanOrderEntryMode) => void;
-    setSubmitDisabledTips: (tips: string) => void;
-    goToStep: (step: ScanOrderStepKey) => void;
-    nextStep: () => void;
-    prevStep: () => void;
-    refreshViewModel: () => Promise<void>;
-    runModuleAction: (actionName: string, ...args: any[]) => Promise<any>;
-    setFooterActionText: (text: string) => void;
-    updateOrderNote: (note: string) => Promise<void>;
-    /** 步骤缓存 hydrate 是否已完成（未完成时不建议写入 step，避免覆盖缓存） */
-    isCacheHydrated: boolean;
-    /** 将 gate 标记为已完成（写入 sessionStorage 桶） */
-    markGate: (flag: ScanOrderGateKey) => void;
-    /** 查询某个 gate 是否已完成 */
-    isGatePassed: (flag: ScanOrderGateKey) => boolean;
-    /** 整桶清空（提交成功 / restoreOrder 等场景） */
-    clearStepCache: () => void;
-    /**
-     * bootstrap 结束后要恢复到的目标 step（仅记录 `'product' | 'check'`）。
-     * hydrate 阶段不直接 `setCurrentStep`，避免在 checkResourceAvailable 之前让
-     * `<Menu>` / `<Check>` mount、提前发出缺 menu_list_ids 的请求。
-     */
-    resumeStep: ScanOrderStepKey | null;
-    /** 消费并清空 resumeStep；建议在完成 goToStep 后立刻调用 */
-    consumeResumeStep: () => void;
-}
-export interface ScanOrderProviderProps {
-    entryContext: ScanOrderEntryContext;
-    children: React.ReactNode;
-}

package/lib/components/scanOrder/utils/toShoppingCartProducts.d.ts

@@ -1,21 +0,0 @@
-interface ScanOrderOrderProduct {
-    product_id: number | null;
-    product_variant_id: number;
-    num?: number;
-    /** 券后单品单价（订单域成交单价）。 */
-    selling_price?: string | number;
-    /** 券前单品单价（店铺售价）。 */
-    original_price?: string | number;
-    product_option_item?: any[];
-    product_bundle?: any[];
-    identity_key?: string;
-    note?: string;
-    metadata?: Record<string, any>;
-    _origin?: Record<string, any>;
-    [key: string]: any;
-}
-export declare function toShoppingCartProducts(params: {
-    orderProducts: ScanOrderOrderProduct[];
-    amountSymbol?: string;
-}): Record<string, any>[];
-export {};

package/lib/components/scanOrder/utils/transformProductDetail.d.ts

@@ -1,59 +0,0 @@
-export interface ProductDetailOptionItem {
-    product_option_item_id?: number | string;
-    option_group_item_id?: number | string;
-    option_group_id?: number | string;
-    num?: number;
-    price?: number | string;
-}
-export interface ProductDetailBundleItem {
-    option?: ProductDetailOptionItem[];
-    [key: string]: any;
-}
-export interface ProductDetailCallbackPayload {
-    id?: number | string | null;
-    product_id?: number | string | null;
-    variant_id?: number | string;
-    product_variant_id?: number | string;
-    quantity?: number;
-    num?: number;
-    option?: ProductDetailOptionItem[];
-    product_option_item?: ProductDetailOptionItem[];
-    bundle?: ProductDetailBundleItem[];
-    product_bundle?: ProductDetailBundleItem[];
-    unique?: string;
-    session?: any;
-    form?: any;
-    service_times?: number;
-    machine_code?: string;
-    schedule_id?: number[];
-    duration?: number;
-    policy_id?: number;
-    source_shop_id?: number;
-    origin?: any;
-    [key: string]: any;
-}
-export interface ScanOrderOrderProductInput {
-    product_id: number | null;
-    product_variant_id: number;
-    num: number;
-    product_option_item: Array<{
-        product_option_item_id: number;
-        option_group_id: number;
-        num: number;
-        price: number;
-    }>;
-    product_bundle: ProductDetailBundleItem[];
-    /** 券后单品单价；初次加购由入口置为 selling_price，之后由 SDK Rules 引擎维护。 */
-    selling_price: string;
-    /** 券前单品单价（店铺售价）。 */
-    original_price: string;
-    tax_fee: string;
-    is_charge_tax: number;
-    metadata: Record<string, any>;
-    _origin: Record<string, any>;
-}
-export declare function transformProductDetailToOrderProduct(params: {
-    payload: ProductDetailCallbackPayload;
-    fallbackProductId?: number | string | null;
-    sourceItem?: Record<string, any>;
-}): ScanOrderOrderProductInput | null;

package/lib/components/venueBooking/components/Addons/index.d.ts

@@ -1,3 +0,0 @@
-/// <reference types="react" />
-import './index.less';
-export default function Addons(): JSX.Element;

package/lib/components/venueBooking/components/Cart/index.d.ts

@@ -1,28 +0,0 @@
-/**
- * venueBooking 购物车组件
- * 参照 scanOrder/Cart 实现，使用系统内置 ShoppingCart + SubTotal 组件
- * 支持两种模式：embedded（桌面端内嵌）和 drawer（移动端抽屉弹出）
- */
-import React from 'react';
-import './index.less';
-/** Cart 组件 Props，与 scanOrder/Cart 对齐 */
-interface CartProps {
-    /** 是否打开（drawer 模式生效） */
-    open: boolean;
-    /** 关闭回调（drawer 模式） */
-    onCancel: () => void;
-    /** 确认/下一步回调 */
-    onNext: () => void;
-    /** 购物车商品列表（从 OS 模块获取后由 toShoppingCartProducts 转换） */
-    items: any[];
-    /** 金额汇总（从 OS 模块 getSummary 获取） */
-    summary: Record<string, any>;
-    /** 是否内嵌模式（桌面端侧边栏使用） */
-    embedded?: boolean;
-    /** 确认按钮 loading 状态 */
-    confirmLoading?: boolean;
-    /** 购物车底部额外内容插槽 */
-    extraContent?: React.ReactNode;
-}
-export default function Cart(props: CartProps): JSX.Element | null;
-export {};

package/lib/components/venueBooking/components/Checkout/index.d.ts

@@ -1,2 +0,0 @@
-/// <reference types="react" />
-export default function Checkout(): JSX.Element;

package/lib/components/venueBooking/components/Footer/index.d.ts

@@ -1,3 +0,0 @@
-/// <reference types="react" />
-import './index.less';
-export default function Footer(): JSX.Element;

package/lib/components/venueBooking/components/Header/index.d.ts

@@ -1,2 +0,0 @@
-/// <reference types="react" />
-export default function Header(): JSX.Element;

package/lib/components/venueBooking/components/VenueSelection/components/TimeGrid.d.ts

@@ -1,2 +0,0 @@
-/// <reference types="react" />
-export default function TimeGrid(): JSX.Element;

package/lib/components/venueBooking/context.d.ts

@@ -1,9 +0,0 @@
-/// <reference types="react" />
-import type { VenueBookingContextValue, VenueBookingProviderProps } from './types';
-/**
- * VenueBookingProvider -- 场地预订全局 Context
- * 管理步骤导航、场地选择状态、OS 模块集成
- */
-export declare function VenueBookingProvider({ entryContext, children }: VenueBookingProviderProps): JSX.Element;
-/** 消费 venueBooking Context 的 hook */
-export declare function useVenueBookingContext(): VenueBookingContextValue;

package/lib/components/venueBooking/hooks.d.ts

@@ -1,72 +0,0 @@
-import type { VenueBookingProps, VenueBookingEntryContext, VenueBookingViewModel, VenueTimeSlotGrid, VenueDateSummaryItem } from './types';
-/** 步骤定义常量 */
-export declare const VENUE_BOOKING_STEPS: readonly ["select-venue", "addons", "checkout"];
-/** 写死的场地商品 ID（后续改为从配置读取） */
-export declare const VENUE_PRODUCT_IDS: number[];
-/**
- * 获取 PisellOS venueBooking 业务模块
- * 使用 useRef 稳定模块引用，防止 getModule 返回值每次渲染变化时触发 bootstrap useEffect 重跑
- */
-export declare function useVenueBookingModule(): any;
-/** 统一获取货币前缀（优先引擎配置，兜底 '$'） */
-export declare function useVenueBookingSymbol(): string;
-/** 获取引擎上下文中的 utils 工具集（action / token 等） */
-export declare function contextUtils(): any;
-/** 从 engine props 提取标准化的入口上下文 */
-export declare function normalizeEntryContext(props: VenueBookingProps): VenueBookingEntryContext;
-/**
- * 安全调用模块异步方法
- * 检查模块和方法是否存在，不存在时抛出友好错误
- */
-export declare function safeRunModuleAction(module: any, actionName: string, ...args: any[]): Promise<any>;
-/** 加载场地商品（初始化时调用一次） */
-export declare function loadVenueProducts(module: any, productIds: number[]): Promise<any>;
-/** 拉取资源可用性数据（按日期范围，翻周时调用） */
-export declare function fetchResourceAvailability(module: any, startDate: string, endDate: string): Promise<any>;
-/** 获取日期概览（纯计算不发请求，fetchResourceAvailability 后调用） */
-export declare function getDateRangeSummary(module: any, startDate: string, endDate: string): VenueDateSummaryItem[];
-/** 获取某天的时段网格（纯计算不发请求，切换日期时调用） */
-export declare function getTimeSlotGrid(module: any, date: string): VenueTimeSlotGrid | null;
-/** 切换选中/取消一个时段（同一资源下多商品场景必须携带 productId） */
-export declare function toggleSlotAction(module: any, params: {
-    resourceId: number;
-    productId: number;
-    startTime: string;
-    endTime: string;
-    price: string;
-}): Promise<any>;
-/**
- * 查询某个时段是否已被选中
- * 不传 productId 时：该资源下任一商品选中即 true；传了则精确匹配
- */
-export declare function isSlotSelected(module: any, resourceId: number, startTime: string, productId?: number): boolean;
-/**
- * 询问 OS：该 (resourceId, productId, startTime) 格子是否因其它已选项而应禁用
- * 覆盖：同场地多商品互斥、组合资源 ↔ 子资源联动
- */
-export declare function isSlotDisabledBySelection(module: any, params: {
-    resourceId: number;
-    productId: number;
-    startTime: string;
-}): boolean;
-/** 获取全部已选时段（按资源分组） */
-export declare function getAllSelectedSlots(module: any): any[];
-/** 查询 otherParams */
-export declare function getOtherParams(module: any): any;
-/**
- * 获取所有“已选时段”对应的日期 key（YYYY-MM-DD）
- * 兼容 venueBooking 模块返回 Map 或数组结构
- */
-export declare function getSelectedDateKeySet(module: any): Set<string>;
-/**
- * 从 OS 模块快照构建 ViewModel（购物车部分）
- * 购物车数据使用 toShoppingCartProducts 转换为 ShoppingCart 组件所需格式
- */
-export declare function createVenueBookingViewModel(module: any): Partial<VenueBookingViewModel>;
-/** 登录状态 hook（检查 token + 弹出登录弹窗） */
-export declare function useVenueBookingLogin(): {
-    isLogin: boolean;
-    openLoginModal: (params: {
-        callback: any;
-    }) => void;
-};

package/lib/components/venueBooking/index.d.ts

@@ -1,6 +0,0 @@
-/// <reference types="react" />
-import type { VenueBookingProps } from './types';
-/** 场地预订主组件 */
-declare function VenueBooking(props: VenueBookingProps): JSX.Element;
-export type { VenueBookingProps } from './types';
-export default VenueBooking;