@pisell/private-materials 6.11.40 → 6.11.41

package/lib/components/booking/forms/table/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import "./index.less";
 declare const Table: ({ value, onChange, field, mode, onAdd }: any) => JSX.Element;
 export default Table;

package/lib/components/booking/hooks/useClearCart.d.ts

@@ -1,3 +1,2 @@
-/// <reference types="react" />
 declare const useClearCart: (state: any, dispatch: any) => false | JSX.Element;
 export default useClearCart;

package/lib/components/booking/info/date/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import "./index.less";
 export declare const updateServiceDate: (services: any[], date: any, isTime: boolean) => any[];
 declare const DateCom: () => JSX.Element;

package/lib/components/booking/info/dateRange/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 export declare const disabledDate: (current: any, position: any, currentDate: any) => any;
 declare const DateRange: ({ state, dispatch, key }: any) => JSX.Element;

package/lib/components/booking/info/header/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './index.less';
 declare const header: ({ state, dispatch }: any) => JSX.Element;
 export default header;

package/lib/components/booking/info/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { InfoProps } from './main';
 declare const APP: (props: InfoProps) => JSX.Element;
 export default APP;

package/lib/components/booking/info/service/editService/BookingList/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 declare const BookingList: ({ items }: {
     items: any[];
 }) => JSX.Element;

package/lib/components/booking/info/service/serviceItem/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 declare const ServiceItem: ({ d, handleEditService, state, handleLike, resourceItem, errorMessage, handleDeleteService, }: any) => JSX.Element;
 export default ServiceItem;

package/lib/components/booking/info/service2/Lists.d.ts

@@ -1,3 +1,2 @@
-/// <reference types="react" />
 declare const Lists: ({ onEdit, onChange }: any) => JSX.Element;
 export default Lists;

package/lib/components/booking/info/service2/utils.d.ts

@@ -216,7 +216,7 @@ export declare const updateAppointmentServicePrice: (state: any, { start_date, e
  * @Author: WangHan
  * @Date: 2024-12-24 11:32
  */
-export declare const updateServicePrice: (state: any) => never[] | Promise<any>;
+export declare const updateServicePrice: (state: any) => Promise<any> | never[];
 /**
  * @description: 根据_id和sourceProductId来获取主商品已选择的赠品
  * @param {string} productId 主商品_id

package/lib/components/booking/info2/model/index.d.ts

@@ -0,0 +1 @@
+export * from './strategy';

package/lib/components/booking/info2/model/strategy/adapter/index.d.ts

@@ -0,0 +1,7 @@
+export * from './type';
+export { default as WalletPassAdapter } from './walletPass';
+export { WalletPassEvaluator } from './walletPass/evaluator';
+export * from './promotion/type';
+export { PromotionAdapter, PromotionEvaluator, X_ITEMS_FOR_Y_PRICE_STRATEGY, BUY_X_GET_Y_FREE_STRATEGY, } from './promotion';
+export type { PromotionEvaluatorInput, ProductPromotionResult, ApplicablePromotion, CartEvaluationResult, CartApplicablePromotion, PromotionGroup, } from './promotion';
+export { default as PromotionAdapterDefault } from './promotion';

package/lib/components/booking/info2/model/strategy/adapter/promotion/evaluator.d.ts

@@ -0,0 +1,185 @@
+import { StrategyConfig } from '../../type';
+import { type PromotionProduct, type PromotionActionDetail, type PromotionEvaluatorInput, type ProductPromotionResult, type ApplicablePromotion, type CartEvaluationResult, type CartWithPricingResult } from './type';
+/**
+ * Promotion 评估器
+ *
+ * 用于评估商品适用的促销活动
+ * 封装了 StrategyEngine 和 PromotionAdapter 的调用逻辑
+ */
+export declare class PromotionEvaluator {
+    private engine;
+    private adapter;
+    private strategyConfigs;
+    private locale;
+    private locales;
+    constructor();
+    /**
+     * 设置策略配置列表
+     */
+    setStrategyConfigs(strategyConfigs: StrategyConfig[]): void;
+    /**
+     * 获取策略配置列表
+     */
+    getStrategyConfigs(): StrategyConfig[];
+    /**
+     * 添加策略配置
+     */
+    addStrategyConfig(strategyConfig: StrategyConfig): void;
+    /**
+     * 设置语言
+     */
+    setLocale(locale: string): void;
+    /**
+     * 设置自定义多语言文案
+     */
+    setLocales(locales: Record<string, Record<string, string>>): void;
+    /**
+     * 获取多语言文案
+     */
+    getText(key: string): string;
+    /**
+     * 获取多语言名称
+     */
+    getLocalizedName(name: string | Record<string, string>): string;
+    /**
+     * 评估商品列表
+     *
+     * 判断每个商品适用哪些促销活动
+     *
+     * @param input 评估输入
+     * @returns 每个商品的促销评估结果
+     */
+    evaluateProducts(input: PromotionEvaluatorInput): ProductPromotionResult[];
+    /**
+     * 评估购物车
+     *
+     * 返回所有适用的促销及按促销分组的商品
+     *
+     * @param input 评估输入
+     * @returns 购物车评估结果
+     */
+    evaluateCart(input: PromotionEvaluatorInput): CartEvaluationResult;
+    /**
+     * 评估购物车并计算定价
+     *
+     * 返回处理后的商品数组（包含拆分、finalPrice）和赠品信息
+     * - 对于 X_ITEMS_FOR_Y_PRICE：按原价比例均摊价格，优先使用高价商品
+     * - 对于 BUY_X_GET_Y_FREE：计算赠品数量和可选赠品列表
+     *
+     * @param input 评估输入
+     * @returns 带定价的购物车评估结果
+     */
+    evaluateCartWithPricing(input: PromotionEvaluatorInput): CartWithPricingResult;
+    /**
+     * 获取商品适用的促销列表
+     *
+     * 简化方法，用于商品卡片展示
+     *
+     * @param product 商品
+     * @param strategyConfigs 策略配置（可选）
+     * @returns 适用的促销列表
+     */
+    getProductPromotions(product: PromotionProduct, strategyConfigs?: StrategyConfig[]): ApplicablePromotion[];
+    /**
+     * 获取商品的促销标签
+     *
+     * 用于商品卡片展示
+     *
+     * @param product 商品
+     * @param strategyConfigs 策略配置（可选）
+     * @returns 促销标签列表
+     */
+    getProductPromotionTags(product: PromotionProduct, strategyConfigs?: StrategyConfig[]): Array<{
+        text: string;
+        type: string;
+        strategyId: string;
+    }>;
+    /**
+     * 查找商品适用的策略配置
+     *
+     * @param product 商品
+     * @param strategyConfigs 策略配置列表（可选）
+     * @returns 适用的策略配置列表
+     */
+    findApplicableStrategies(product: PromotionProduct, strategyConfigs?: StrategyConfig[]): StrategyConfig[];
+    /**
+     * 批量获取商品列表的适用策略信息
+     *
+     * 用于给商品列表追加策略标签信息
+     * 只检查商品 ID 匹配和策略时间范围
+     *
+     * @param input 评估输入（商品列表）
+     * @returns 每个商品的适用策略完整数据
+     */
+    getProductsApplicableStrategies(input: PromotionEvaluatorInput): Array<{
+        product: PromotionProduct;
+        applicableStrategies: Array<{
+            strategyId: string;
+            strategyName: string | Record<string, string>;
+            strategyMetadata: any;
+            actionType: string;
+            actionDetail: PromotionActionDetail;
+            display?: {
+                text: string | Record<string, string>;
+                type: string;
+            };
+            strategyConfig: StrategyConfig;
+        }>;
+        hasApplicableStrategy: boolean;
+    }>;
+    /**
+     * 按优先级排序促销组
+     * 优先级从 strategyConfig.actions[0].priority 获取，数值越小优先级越高
+     */
+    private sortPromotionGroupsByPriority;
+    /**
+     * 处理 X件Y元 促销
+     *
+     * 1. 展开商品为单件列表，按价格从高到低排序
+     * 2. 计算可凑成的组数
+     * 3. 按原价比例均摊价格
+     * 4. 拆分商品（部分参与促销、部分原价）
+     *
+     * 注意：每个商品按 id 独立处理，不会合并不同 id 的商品
+     */
+    private processXItemsForYPrice;
+    /**
+     * 处理 买X送Y 促销
+     *
+     * 计算赠品数量，商品本身价格不变
+     */
+    private processBuyXGetYFree;
+    /**
+     * 获取未参与任何促销的商品
+     */
+    private getRemainingProducts;
+    /**
+     * 价格统一保留两位小数
+     */
+    private formatPrice;
+    /**
+     * 获取商品唯一标识 key
+     * 使用商品的 id 作为唯一标识，不同 id 的商品不会被合并
+     */
+    private getProductKey;
+    /**
+     * 生成随机ID
+     */
+    private generateRandomId;
+    /**
+     * 检查商品是否在策略的适用范围内
+     */
+    private isProductInStrategy;
+    /**
+     * 查找商品匹配规则
+     */
+    private findProductMatchRule;
+    /**
+     * 检查商品是否匹配配置
+     */
+    private isProductMatch;
+    /**
+     * 获取展示配置
+     */
+    private getDisplayConfig;
+}

package/lib/components/booking/info2/model/strategy/adapter/promotion/type.d.ts

@@ -0,0 +1,420 @@
+import { StrategyConfig } from '../../type';
+/**
+ * Promotion 策略类型定义
+ *
+ * 定义促销活动相关的 Action 类型、值结构和配置
+ */
+/**
+ * 促销活动 Action 类型
+ */
+export declare const PROMOTION_ACTION_TYPES: {
+    /** X件Y元（每X件固定价格Y元，可累计） */
+    readonly X_ITEMS_FOR_Y_PRICE: "X_ITEMS_FOR_Y_PRICE";
+    /** 买X送Y（买X件送Y件，可累计） */
+    readonly BUY_X_GET_Y_FREE: "BUY_X_GET_Y_FREE";
+    /** 固定折扣 */
+    readonly DISCOUNT_RATE: "DISCOUNT_RATE";
+    /** 固定减价 */
+    readonly DEDUCT_AMOUNT: "DEDUCT_AMOUNT";
+};
+export declare type PromotionActionType = (typeof PROMOTION_ACTION_TYPES)[keyof typeof PROMOTION_ACTION_TYPES];
+/**
+ * X件Y元 - Action Value
+ *
+ * @example
+ * value: { x: 2, price: 10 }  // 每2件10元
+ */
+export interface XItemsForYPriceValue {
+    /** 每X件（需要凑满的数量） */
+    x: number;
+    /** 固定价格Y元 */
+    price: number;
+}
+/**
+ * X件Y元 - Action Config
+ */
+export interface XItemsForYPriceConfig {
+    /** 允许跨商品组合（A+B可以凑成一组） */
+    allowCrossProduct?: boolean;
+    /** 可累计（买5件 = 2组优惠 + 1件原价） */
+    cumulative?: boolean;
+}
+/**
+ * 买X送Y - Action Value
+ *
+ * @example
+ * value: { buyQuantity: 1, freeQuantity: 1 }  // 买1送1
+ */
+export interface BuyXGetYFreeValue {
+    /** 买X件 */
+    buyQuantity: number;
+    /** 送Y件 */
+    freeQuantity: number;
+}
+/**
+ * 赠品选择模式
+ */
+export declare type GiftSelectionMode = 'user_select' | 'auto' | 'cheapest';
+/**
+ * 买X送Y - Action Config
+ */
+export interface BuyXGetYFreeConfig {
+    /** 赠品选择模式 */
+    giftSelectionMode?: GiftSelectionMode;
+    /** 可累计（买2送2、买3送3...） */
+    cumulative?: boolean;
+    /** 可选的赠品列表 */
+    giftProducts?: ProductIdentifier[];
+}
+/**
+ * 商品标识
+ *
+ * 匹配规则：
+ * - product_variant_id = 0 表示匹配任意变体
+ * - product_variant_id != 0 表示精确匹配该变体
+ */
+export interface ProductIdentifier {
+    /** 商品ID */
+    product_id: number;
+    /**
+     * 变体ID
+     * - 0 表示匹配任意变体
+     * - 非0 表示精确匹配该变体
+     */
+    product_variant_id: number;
+}
+import { ActionEffect } from '../../type';
+/**
+ * X件Y元 Action
+ */
+export interface XItemsForYPriceAction extends Omit<ActionEffect, 'type' | 'value' | 'config'> {
+    type: typeof PROMOTION_ACTION_TYPES.X_ITEMS_FOR_Y_PRICE;
+    value: XItemsForYPriceValue;
+    valueType: 'object';
+    config?: XItemsForYPriceConfig;
+}
+/**
+ * 买X送Y Action
+ */
+export interface BuyXGetYFreeAction extends Omit<ActionEffect, 'type' | 'value' | 'config'> {
+    type: typeof PROMOTION_ACTION_TYPES.BUY_X_GET_Y_FREE;
+    value: BuyXGetYFreeValue;
+    valueType: 'object';
+    config?: BuyXGetYFreeConfig;
+}
+/**
+ * 促销活动 Action 联合类型
+ */
+export declare type PromotionAction = XItemsForYPriceAction | BuyXGetYFreeAction;
+/**
+ * 促销相关运算符
+ */
+export declare const PROMOTION_OPERATORS: {
+    /**
+     * 商品匹配运算符
+     *
+     * 匹配规则：
+     * - 首先匹配 product_id
+     * - 如果配置的 product_variant_id = 0，只需要 product_id 匹配
+     * - 如果配置的 product_variant_id != 0，还需要 product_variant_id 匹配
+     */
+    readonly PRODUCT_MATCH: "product_match";
+};
+/**
+ * 促销活动业务数据
+ *
+ * 由业务层传入，用于策略评估
+ */
+export interface PromotionBusinessData {
+    /** 商品列表 */
+    products: PromotionProduct[];
+    /** 当前评估的商品（用于单商品场景，如商品卡片展示） */
+    currentProduct?: PromotionProduct;
+    /** 渠道 */
+    channel?: string;
+    /** 自定义属性 */
+    custom?: Record<string, any>;
+}
+declare type ProductBundleItem = {
+    /** 商品ID */
+    product_id: number;
+    /** 变体ID（0 表示无变体） */
+    product_variant_id: number;
+    /** 数量 */
+    quantity: number;
+    /** 单价 */
+    price: number;
+    /** 原价 */
+    original_price?: number;
+    /** 套餐明细id */
+    id: number;
+};
+/**
+ * 促销商品信息
+ */
+export interface PromotionProduct {
+    id: number;
+    /** 商品ID */
+    product_id: number;
+    /** 变体ID（0 表示无变体） */
+    product_variant_id: number;
+    /** 商品名称 */
+    name?: string;
+    /** 单价 */
+    price: number;
+    /** 商品套餐 */
+    bundle: ProductBundleItem[];
+    /** 数量 */
+    quantity: number;
+    /** 原价 */
+    original_price?: number;
+}
+/**
+ * 促销活动适配器转换结果
+ *
+ * 返回给业务层，包含策略匹配信息
+ */
+export interface PromotionTransformResult {
+    /** 策略是否适用 */
+    isApplicable: boolean;
+    /** 匹配的 Action 类型 */
+    actionType?: PromotionActionType;
+    /** 匹配的 Action 详情 */
+    actionDetail?: PromotionActionDetail;
+    /** 适用的商品列表（从购物车商品中筛选出的适用商品） */
+    applicableProducts: PromotionProduct[];
+    /** 不适用的原因 */
+    reason?: string;
+    /** 不适用的原因码 */
+    reasonCode?: string;
+    /** 原始策略引擎结果 */
+    strategyResult: import('../../type').EvaluationResult;
+}
+/**
+ * Action 详情联合类型
+ */
+export declare type PromotionActionDetail = XItemsForYPriceActionDetail | BuyXGetYFreeActionDetail;
+/**
+ * X件Y元 Action 详情
+ */
+export interface XItemsForYPriceActionDetail {
+    type: typeof PROMOTION_ACTION_TYPES.X_ITEMS_FOR_Y_PRICE;
+    /** 每X件 */
+    x: number;
+    /** 固定价格Y元 */
+    price: number;
+    /** 允许跨商品组合 */
+    allowCrossProduct: boolean;
+    /** 可累计 */
+    cumulative: boolean;
+}
+/**
+ * 买X送Y Action 详情
+ */
+export interface BuyXGetYFreeActionDetail {
+    type: typeof PROMOTION_ACTION_TYPES.BUY_X_GET_Y_FREE;
+    /** 买X件 */
+    buyQuantity: number;
+    /** 送Y件 */
+    freeQuantity: number;
+    /** 赠品选择模式 */
+    giftSelectionMode: GiftSelectionMode;
+    /** 可累计 */
+    cumulative: boolean;
+    /** 可选的赠品列表 */
+    giftProducts: ProductIdentifier[];
+}
+/**
+ * X件Y元 - 业务层计算结果
+ *
+ * 由业务层根据 matchedAction 计算后返回
+ */
+export interface XItemsForYPriceResult {
+    /** 满足条件的组数 */
+    groupCount: number;
+    /** 剩余件数（原价） */
+    remainingCount: number;
+    /** 优惠金额 */
+    discountAmount: number;
+    /** 分组详情 */
+    groups: Array<{
+        products: Array<{
+            product_id: number;
+            product_variant_id: number;
+            originalPrice: number;
+        }>;
+        originalTotal: number;
+        discountedPrice: number;
+    }>;
+}
+/**
+ * 买X送Y - 业务层计算结果
+ *
+ * 由业务层根据 matchedAction 计算后返回
+ */
+export interface BuyXGetYFreeResult {
+    /** 可送的赠品数量 */
+    freeCount: number;
+    /** 需要用户选择的赠品数量 */
+    pendingSelectCount: number;
+    /** 已选择的赠品 */
+    selectedGifts: ProductIdentifier[];
+    /** 可选的赠品列表 */
+    availableGifts: ProductIdentifier[];
+}
+/**
+ * 评估器输入
+ */
+export interface PromotionEvaluatorInput {
+    /** 商品列表 */
+    products: PromotionProduct[];
+    /** 策略配置列表（可选，如果不传则使用 setStrategyConfigs 设置的） */
+    strategyConfigs?: StrategyConfig[];
+    /** 渠道 */
+    channel?: string;
+}
+/**
+ * 单商品评估结果
+ */
+export interface ProductPromotionResult {
+    /** 商品信息 */
+    product: PromotionProduct;
+    /** 适用的促销列表 */
+    applicablePromotions: ApplicablePromotion[];
+    /** 是否有适用的促销 */
+    hasPromotion: boolean;
+}
+/**
+ * 适用的促销信息
+ */
+export interface ApplicablePromotion {
+    /** 策略ID */
+    strategyId: string;
+    /** 策略名称 */
+    strategyName: string | Record<string, string>;
+    /** Action 类型 */
+    actionType: string;
+    /** Action 详情 */
+    actionDetail: PromotionActionDetail;
+    /** 展示配置 */
+    display?: {
+        text: string | Record<string, string>;
+        type: string;
+    };
+    /** 原始策略配置 */
+    strategyConfig: StrategyConfig;
+}
+/**
+ * 购物车评估结果
+ */
+export interface CartEvaluationResult {
+    /** 每个商品的促销结果 */
+    productResults: ProductPromotionResult[];
+    /** 购物车中所有适用的促销（去重） */
+    applicablePromotions: CartApplicablePromotion[];
+    /** 按促销分组的商品 */
+    promotionGroups: PromotionGroup[];
+}
+/**
+ * 购物车适用的促销
+ */
+export interface CartApplicablePromotion extends ApplicablePromotion {
+    /** 适用此促销的商品列表 */
+    applicableProducts: PromotionProduct[];
+    /** 适用商品的总数量 */
+    totalQuantity: number;
+    /** 适用商品的总金额 */
+    totalAmount: number;
+}
+/**
+ * 促销分组
+ */
+export interface PromotionGroup {
+    /** 策略ID */
+    strategyId: string;
+    /** 策略名称 */
+    strategyName: string | Record<string, string>;
+    /** Action 类型 */
+    actionType: string;
+    /** Action 详情 */
+    actionDetail: PromotionActionDetail;
+    /** 分组内的商品 */
+    products: PromotionProduct[];
+    /** 商品总数量 */
+    totalQuantity: number;
+    /** 商品总金额 */
+    totalAmount: number;
+}
+/**
+ * 带定价的商品
+ *
+ * 在 PromotionProduct 基础上增加了均摊后的最终价格和促销信息
+ */
+export interface PricedProduct extends PromotionProduct {
+    /**
+     * 原始商品ID
+     * 当商品被拆分时，此字段记录拆分前的原始商品id
+     * 例如 A*5 拆成 A*4（参与促销）+ A*1（原价），A*4 的 originalId 指向原始 A 的 id
+     */
+    originalId?: number;
+    /**
+     * 最终单价（均摊后）
+     * - 参与促销的商品：按原价比例均摊后的价格
+     * - 未参与促销的商品：等于 price
+     */
+    finalPrice: number;
+    /**
+     * 应用的策略ID
+     * 如果商品参与了促销，记录对应的策略ID
+     */
+    strategyId?: string;
+    /**
+     * 是否参与了促销
+     */
+    inPromotion: boolean;
+    /**
+     * 是否为拆分出来的商品
+     * true 表示这是从原商品拆分出来的新记录
+     */
+    isSplit?: boolean;
+}
+/**
+ * 赠品信息
+ *
+ * 记录某个促销产生的赠品数量和可选赠品列表
+ */
+export interface GiftInfo {
+    /** 策略ID */
+    strategyId: string;
+    /** 策略名称 */
+    strategyName: string | Record<string, string>;
+    /** 可送赠品数量 */
+    giftCount: number;
+    /** 可选赠品列表 */
+    giftOptions: ProductIdentifier[];
+}
+/**
+ * 带定价的购物车评估结果
+ *
+ * evaluateCartWithPricing 方法的返回结果
+ */
+export interface CartWithPricingResult {
+    /**
+     * 处理后的商品数组
+     * - 包含所有商品（参与促销和未参与促销的）
+     * - 参与促销的商品可能被拆分（如 A*5 拆成 A*4 + A*1）
+     * - 每个商品都有 finalPrice 字段
+     */
+    products: PricedProduct[];
+    /**
+     * 赠品信息列表
+     * 按促销分组，每个促销对应一个 GiftInfo
+     */
+    gifts: GiftInfo[];
+    /**
+     * 总优惠金额
+     * 所有商品的原价总和 - 所有商品的 finalPrice 总和
+     */
+    totalDiscount: number;
+}
+export {};