@pisell/private-materials 6.8.13 → 6.8.15

package/lib/plus/selectHolder/types.d.ts

@@ -0,0 +1,104 @@
+/// <reference types="react" />
+/**
+ * @title: 选项数据类型
+ * @description:
+ * @return {*}
+ * @Author: WangHan
+ * @Date: 2025-10-11 14:18
+ */
+export interface HolderOption {
+    /** 显示的标签文本 */
+    label: string;
+    /** 选项的值（唯一标识） */
+    value: any;
+    /** 头像地址 */
+    avatar?: string;
+    /** 副标题/描述 */
+    subtitle?: string;
+    /** 其他字段 */
+    [key: string]: any;
+}
+/**
+ * @title: 模态框配置
+ * @description:
+ * @return {*}
+ * @Author: WangHan
+ * @Date: 2025-10-10 14:32
+ */
+export interface HolderModalProps {
+    title?: string;
+    confirmText?: string;
+    showClose?: boolean;
+}
+/**
+ * @title: 字段展示配置
+ * @description:
+ * @return {*}
+ * @Author: WangHan
+ * @Date: 2025-10-10 14:32
+ */
+export interface HolderDisplayProps {
+    showAvatar?: boolean;
+    showTitle?: boolean;
+    showSubtitle?: boolean;
+    isSkipable?: boolean;
+    direction?: 'horizontal' | 'vertical';
+    selectType?: 'single' | 'multiple';
+    showExtraFields?: boolean;
+    extraFields?: any[];
+}
+/**
+ * @title: SelectHolder 组件属性
+ * @description:
+ * @return {*}
+ * @Author: WangHan
+ * @Date: 2025-10-11 14:18
+ */
+export interface PisellSelectHolderProps {
+    /** 选项列表 */
+    dataSource?: HolderOption[];
+    /** 是否打开模态框 */
+    open?: boolean;
+    /** 关闭事件（右上角 X 按钮） */
+    onClose?: () => void;
+    /** 确认事件，返回选中的值 */
+    onConfirm?: (selected: any) => void;
+    /** 跳过事件（底部跳过按钮） */
+    onSkip?: () => void;
+    /** 点击添加按钮事件 */
+    onAdd?: () => void;
+    /** 当前选中的值(单选) 或 选中的值数组(多选) */
+    value?: any;
+    modalConfig?: HolderModalProps;
+    displayConfig?: HolderDisplayProps;
+    /** 是否禁用确认按钮 */
+    disabled?: boolean;
+    /** 错误提示文案 */
+    errorTipText?: string;
+    /** 是否显示添加按钮 */
+    allowAdd?: boolean;
+    /** 添加按钮文案 */
+    addText?: string;
+    /** 每行显示的列数 */
+    columns?: number;
+    /** 水平间距 */
+    horizontalGap?: number;
+    /** 垂直间距 */
+    verticalGap?: number;
+    /** 最大可选数量 */
+    maxSelectedCount?: number;
+    /** 是否内联模式（不显示弹窗，直接渲染内容，用于页面级别） */
+    isInline?: boolean;
+    /** 内联模式的容器样式类名 */
+    className?: string;
+    /** 内联模式的容器样式 */
+    style?: React.CSSProperties;
+}
+export interface HolderItemProps {
+    item: HolderOption;
+    displayDirection?: 'horizontal' | 'vertical';
+    displayConfig?: HolderDisplayProps;
+    onClick?: (value?: any) => void;
+    value?: any;
+    isAddItem?: boolean;
+}

package/lib/plus/selectHolder/utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @title: 获取头像文本
+ * @description: 获取头像文本（标签的首字母，最多两个单词）
+ * @param {string} label
+ * @return {*}
+ * @Author: WangHan
+ * @Date: 2025-10-11 13:46
+ */
+export declare const getAvatarText: (label: string) => string;

package/lib/plus/skuOptionsSelection/components/NormalCard/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { RenderItemProps } from '../../../../pro/Selector/types';
 declare const NormalCard: (props: RenderItemProps & {
     parentDataSource: any;

package/lib/plus/skuOptionsSelection/components/TitleExtra/index.d.ts

@@ -0,0 +1,3 @@
+import './index.less';
+declare const TitleExtra: (props: any) => JSX.Element;
+export default TitleExtra;

package/lib/plus/skuOptionsSelection/components/VariantCard/index.d.ts

@@ -0,0 +1,3 @@
+import './index.less';
+declare const VariantCard: (props: any) => JSX.Element;
+export default VariantCard;

package/lib/plus/skuOptionsSelection/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export { default as useLanguage } from './useLanguage';
+export { default as useStore } from './useStore';
+export { default as useSymbol } from './useSymbol';

package/lib/plus/skuOptionsSelection/hooks/useLanguage.d.ts

@@ -0,0 +1,2 @@
+declare const useLanguage: () => any;
+export default useLanguage;

package/lib/plus/skuOptionsSelection/hooks/useStore.d.ts

@@ -0,0 +1,2 @@
+import useStore from '../store/store';
+export default useStore;

package/lib/plus/skuOptionsSelection/hooks/useSymbol.d.ts

@@ -0,0 +1,2 @@
+declare const useSymbol: () => any;
+export default useSymbol;

package/lib/plus/skuOptionsSelection/locales.d.ts

@@ -0,0 +1,30 @@
+declare const _default: {
+    en: {
+        'pisell2.skuOptionsSelection.title': string;
+        'pisell2.skuOptionsSelection.titleExtra.alreadySelected': string;
+        'pisell2.skuOptionsSelection.titleExtra.totalPrice': string;
+        'pisell2.skuOptionsSelection.optionItemCard.editSelections': string;
+        'pisell2.skuOptionsSelection.variantItemCard.soldOut': string;
+        'pisell2.skuOptionsSelection.optionItemCard.typeText': string;
+        'pisell2.skuOptionsSelection.optionItemCard.overSelected': string;
+    };
+    'zh-CN': {
+        'pisell2.skuOptionsSelection.title': string;
+        'pisell2.skuOptionsSelection.titleExtra.alreadySelected': string;
+        'pisell2.skuOptionsSelection.titleExtra.totalPrice': string;
+        'pisell2.skuOptionsSelection.optionItemCard.editSelections': string;
+        'pisell2.skuOptionsSelection.variantItemCard.soldOut': string;
+        'pisell2.skuOptionsSelection.optionItemCard.typeText': string;
+        'pisell2.skuOptionsSelection.optionItemCard.overSelected': string;
+    };
+    'zh-HK': {
+        'pisell2.skuOptionsSelection.title': string;
+        'pisell2.skuOptionsSelection.titleExtra.alreadySelected': string;
+        'pisell2.skuOptionsSelection.titleExtra.totalPrice': string;
+        'pisell2.skuOptionsSelection.optionItemCard.editSelections': string;
+        'pisell2.skuOptionsSelection.variantItemCard.soldOut': string;
+        'pisell2.skuOptionsSelection.optionItemCard.typeText': string;
+        'pisell2.skuOptionsSelection.optionItemCard.overSelected': string;
+    };
+};
+export default _default;

package/lib/plus/skuOptionsSelection/store/actions.d.ts

@@ -0,0 +1,22 @@
+import { SkuCardConfig, SkuSelectionState } from '../types';
+declare const actions: {
+    /** 更新数据源 */
+    updateDataSource: (dataSource: any) => void;
+    /** 更新原始值 */
+    updateValue: (value: Record<string | number, any>) => void;
+    /** 更新配置 */
+    updateConfig: (config: any) => void;
+    /** 更新符号 */
+    updateSymbol: (symbol: string) => void;
+    /** 更新Selector数据源 */
+    updateSelectorDataSource: (selectorDataSource: any[]) => void;
+    /** 更新Selector识别的值 */
+    updateSelectorValue: (selectorValue: Record<string | number, any>) => void;
+    /** 更新 SKU Card 配置 */
+    updateSkuCardConfig: (skuCardConfig: SkuCardConfig) => void;
+    /** 更新自定义配置 */
+    updateCustomConfig: (customConfig: Partial<SkuSelectionState['customConfig']>) => void;
+    /** 清空整个store的值 */
+    clearStore: () => void;
+};
+export default actions;

package/lib/plus/skuOptionsSelection/store/createStore.d.ts

@@ -0,0 +1,15 @@
+export interface StoreApi<T> {
+    setState: (partial: Partial<T> | ((prev: T) => Partial<T>)) => void;
+    getState: () => T;
+    subscribe: (listener: () => void) => () => void;
+}
+export interface UseStore<T> extends StoreApi<T> {
+    <S>(selector?: (state: T) => S): S;
+    <S = T>(): S;
+}
+/**
+ * 创建一个跨 React 版本兼容的 Store
+ * 支持自动浅合并 (Auto Shallow Merge)
+ * @param initialState 初始状态
+ */
+export default function createStore<T extends object>(initialState: T): UseStore<T>;

package/lib/plus/skuOptionsSelection/store/index.d.ts

@@ -0,0 +1,2 @@
+export { default as store } from './store';
+export { default as actions } from './actions';

package/lib/plus/skuOptionsSelection/store/store.d.ts

@@ -0,0 +1,4 @@
+import { SkuSelectionState } from '../types';
+export declare const initialState: SkuSelectionState;
+declare const store: import("./createStore").UseStore<SkuSelectionState>;
+export default store;

package/lib/plus/skuOptionsSelection/types.d.ts

@@ -0,0 +1,426 @@
+/// <reference types="react" />
+/**
+ * SKU Card 文本样式配置
+ */
+export interface SkuCardTextConfig {
+    /** 是否显示 */
+    visible?: boolean;
+    /** 字体大小 */
+    fontSize?: number;
+    /** 颜色 */
+    color?: string;
+    /** 字体粗细 */
+    fontWeight?: 'normal' | 'bold' | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+    /** 展示行数 */
+    lineClamp?: number;
+}
+/**
+ * SKU Card 图片配置
+ */
+export interface SkuCardImageConfig {
+    /** 是否显示 */
+    visible?: boolean;
+    /** 宽度 */
+    width?: number;
+    /** 高度 */
+    height?: number;
+    /** 圆角 */
+    borderRadius?: number | string;
+    /** 边框 */
+    border?: string;
+}
+/**
+ * SKU Card 配置
+ */
+export interface SkuCardConfig {
+    /** 主标题配置 */
+    title?: SkuCardTextConfig;
+    /** 副标题配置 */
+    subTitle?: SkuCardTextConfig;
+    /** 价格配置 */
+    price?: Omit<SkuCardTextConfig, 'lineClamp'>;
+    /** 图片配置 */
+    image?: SkuCardImageConfig;
+}
+/**
+ * SKU store状态类型
+ */
+export interface SkuSelectionState {
+    /** 数据源 */
+    dataSource: any;
+    /** 原始值 */
+    value: Record<string | number, any>;
+    /** 配置 */
+    config: {
+        overSold?: boolean;
+    };
+    /** 货币符号 */
+    symbol: string;
+    /** Selector数据源 */
+    selectorDataSource: any[];
+    /** Selector识别的值  */
+    selectorValue: Record<string | number, any>;
+    /** SKU Card 配置 */
+    skuCardConfig: SkuCardConfig;
+    style?: React.CSSProperties;
+    /** 样式配置 */
+    customConfig?: {
+        /** 弹窗宽度 */
+        modalWidth?: number | string;
+    };
+}
+/** SKU Card 默认配置 */
+export declare const defaultSkuCardConfig: SkuCardConfig;
+export interface IProps {
+    /** 数据源 */
+    dataSource: DataSource;
+    /** 原始值 */
+    value: SkuValue;
+    /** 配置 */
+    config?: {
+        /** 是否禁用 */
+        overSold?: 0 | 1;
+    };
+    /** SKU Card 配置 */
+    skuCardConfig?: SkuCardConfig;
+    /** 选中变更回调 */
+    onChange: (value: SkuValue) => void;
+    /** 自定义滚动容器 */
+    customScrollParent?: HTMLElement | string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 自定义配置 */
+    customConfig?: {
+        /** 弹窗宽度 */
+        modalWidth?: number | string;
+    };
+}
+export interface DataSource {
+    /** 单规格组数据 */
+    option_group?: Array<OptionGroupItem>;
+    /** 组合规格组装后的数据 */
+    variant?: Array<VariantProductItem>;
+    /** 组合规格组数据 */
+    variant_group?: Array<VariantGroupItem>;
+    /** 套餐商品组数据 */
+    bundle_group?: Array<BundleItem>;
+}
+/**
+ * 单规格组数据
+ */
+export interface OptionGroupItem {
+    /** 创建者id */
+    create_account_id?: number;
+    /** 创建时间 */
+    created_at?: string;
+    /** 删除时间 */
+    deleted_at?: string | null;
+    /** 模板id */
+    template_id?: number;
+    /** 更新者id */
+    update_account_id?: number;
+    /** 更新时间 */
+    updated_at?: string;
+    /** 单规格组id */
+    id?: number;
+    /** 是否启用 */
+    is_enabled?: 0 | 1;
+    /** 是否多选 */
+    is_multiple?: 0 | 1;
+    /** 最大选择数量 */
+    max_quantity?: number;
+    /** 最小选择数量 */
+    min_quantity?: number;
+    /** 单规格组名称 */
+    name?: string;
+    /** 单规格组下规格数据 */
+    option_item?: Array<OptionItem>;
+    /** 商品id */
+    product_id?: number;
+    /** 是否必选 */
+    required?: 0 | 1;
+    /** 店铺id */
+    shop_id?: number;
+    /** 排序 */
+    sort?: number;
+    /** 状态 */
+    status?: 0 | 1;
+}
+/**
+ * 单规格组下选项数据
+ */
+export interface OptionItem {
+    /** 创建者id */
+    create_account_id?: number;
+    /** 创建时间 */
+    created_at?: string;
+    /** 删除时间 */
+    deleted_at?: string | null;
+    /** 模板id */
+    template_id?: number;
+    /** 更新者id */
+    update_account_id?: number;
+    /** 更新时间 */
+    updated_at?: string;
+    /** 加价 */
+    add_price?: string;
+    /** 封面 */
+    cover?: string;
+    /** 描述 */
+    description?: string;
+    /** 规格id */
+    id?: number;
+    /** 是否启用 */
+    is_enabled?: 0 | 1;
+    /** 最大选择数量 */
+    max_quantity?: number;
+    /** 规格名称 */
+    name?: string;
+    /** 规格组id */
+    option_group_id?: number;
+    /** 原价 */
+    original_price?: string;
+    /** 商品id */
+    product_id?: number;
+    /** 店铺id */
+    shop_id?: number;
+    /** 排序 */
+    sort?: number;
+    /** 状态 */
+    status?: 0 | 1;
+}
+/**
+ * 组合规格组数据
+ */
+export interface VariantGroupItem {
+    /** 创建者id */
+    create_account_id?: number;
+    /** 创建时间 */
+    created_at?: string;
+    /** 删除时间 */
+    deleted_at?: string | null;
+    /** 更新者id */
+    update_account_id?: number;
+    /** 更新时间 */
+    updated_at?: string;
+    /** 组合规格组id */
+    id?: number;
+    /** 组合规格组名称 */
+    name?: string;
+    /** 位置id */
+    position_id?: number;
+    /** 商品id */
+    product_id?: number;
+    /** 店铺id */
+    shop_id?: number;
+    /** 排序 */
+    sort?: number;
+    /** 状态 */
+    status?: 0 | 1;
+    /** 组合规格组下选项数据 */
+    variant_item?: Array<VariantItem>;
+}
+/**
+ * 组合规格组下选项数据
+ */
+export interface VariantItem {
+    /** 创建者id */
+    create_account_id?: number;
+    /** 创建时间 */
+    created_at?: string;
+    /** 删除时间 */
+    deleted_at?: string | null;
+    /** 更新者id */
+    update_account_id?: number;
+    /** 更新时间 */
+    updated_at?: string;
+    /** 店铺id */
+    shop_id?: number;
+    /** 排序 */
+    sort?: number;
+    /** 规格id */
+    id?: number;
+    /** 是否默认 */
+    is_default?: 0 | 1;
+    /** 变体名称 */
+    name?: string;
+    /** 位置id */
+    position_id?: number;
+    /** 商品id */
+    product_id?: number;
+    /** 状态 */
+    status?: 0 | 1;
+    /** 组合规格组id */
+    variant_group_id?: number;
+}
+/**
+ * 组合规格商品数据
+ */
+export interface VariantProductItem {
+    /** 创建者id */
+    create_account_id?: number;
+    /** 创建时间 */
+    created_at?: string;
+    /** 更新者id */
+    update_account_id?: number;
+    /** 更新时间 */
+    updated_at?: string;
+    /** 条形码 */
+    barcode?: string;
+    /** 基础价格 */
+    base_price?: string;
+    /** 箱规数量 */
+    box_specification_quantity?: number;
+    /** 编码 */
+    code?: string;
+    /** 成本价格 */
+    cost_price?: string;
+    /** 封面 */
+    cover?: string;
+    /** 描述 */
+    description?: string | null;
+    /** 是否禁用 */
+    disabled?: 0 | 1;
+    /** 组合规格商品id */
+    id?: number;
+    /** 是否收税 */
+    is_charge_tax?: 0 | 1;
+    /** 是否发货 */
+    is_delivery?: 0 | 1;
+    /** 是否收税 */
+    is_gst?: 0 | 1;
+    /** 是否跟踪库存 */
+    is_track?: 0 | 1;
+    /** 名称 */
+    name?: Record<string, string>;
+    /** 开售重量 */
+    open_sold_weight?: number;
+    /** 原价 */
+    original_price?: string;
+    /** 是否超卖 */
+    over_sold?: 0 | 1;
+    /** 价格 */
+    price?: string;
+    /** 商品id */
+    product_id?: number;
+    /** 折扣类型 */
+    rebate_type?: string;
+    /** 折扣值 */
+    rebate_value?: number;
+    /** 标题 */
+    title?: Record<string, string>;
+    /** 单位 */
+    unit?: string;
+    /** 单位值 */
+    unit_value?: number;
+    /** 重量单位 */
+    weight_unit?: string;
+    /** 重量值 */
+    weight_value?: string;
+}
+/**
+ * 套餐商品组数据
+ */
+export interface BundleGroupItem {
+    /** 店铺id */
+    shop_id?: number;
+    /** 排序 */
+    sort?: number;
+    /** 套餐id */
+    id?: number;
+    /** 最大选择数量 */
+    max_quantity?: number;
+    /** 最小选择数量 */
+    min_quantity?: number;
+    /** 套餐名称 */
+    name?: string;
+    /** 商品id */
+    product_id?: number;
+    /** 套餐商品组数据 */
+    bundle_item?: Array<BundleItem>;
+}
+/**
+ * 套餐商品组下选项数据
+ */
+export interface BundleItem {
+    /** 店铺id */
+    shop_id?: number;
+    /** 排序 */
+    sort?: number;
+    /** 条形码 */
+    barcode?: string;
+    /** 套餐商品id */
+    bundle_product_id?: number;
+    /** 套餐商品变体id */
+    bundle_variant_id?: number;
+    /** 编码 */
+    code?: string;
+    /** 封面 */
+    cover?: string;
+    /** 扩展id */
+    extension_id?: number;
+    /** 扩展类型 */
+    extension_type?: string;
+    /** 套餐商品组id */
+    group_id?: number;
+    /** 套餐商品id */
+    id: string | number;
+    /** 是否跟踪库存 */
+    is_track?: 0 | 1;
+    /** 最大选择数量 */
+    max_quantity?: number;
+    /** 单规格组数据 */
+    option_group?: Array<OptionGroupItem>;
+    /** 是否允许超卖 */
+    over_sold?: 0 | 1;
+    /** 价格 */
+    price?: string;
+    /** 价格类型: mark_up==>加价 | mark_down==>减价 */
+    price_type?: 'mark_up' | 'mark_down';
+    /** 价格类型扩展: product_price==>商品价格 */
+    price_type_ext?: '' | 'product_price';
+    /** 商品id */
+    product_id?: number;
+    /** 商品价格 */
+    product_price?: string;
+    /** 商品副标题 */
+    product_subtitle?: string;
+    /** 库存数量 */
+    stock_quantity?: number;
+    /** 标题 */
+    title?: string;
+}
+/**
+ * sku value
+ */
+export interface SkuValue {
+    /** 商品id */
+    product_id: number;
+    /** 多规格商品id */
+    product_variant_id: number;
+    /** 多规格商品选项字符串 */
+    product_option_string?: string;
+    /** 套餐商品组数据 */
+    bundle: Array<any>;
+    /** 价格 */
+    price?: string | number;
+    /** 单规格组数据 */
+    option: Array<OptionItem & {
+        num: number;
+        price: string;
+        product_option_item_id: number;
+    }>;
+}
+/**
+ * Selector值原子类型
+ */
+export interface SelectorValueAtom {
+    /** 数据 */
+    data: Record<string, any>;
+    /** 数量 */
+    quantity: number;
+    /** 总价 */
+    totalPrice: string | number;
+    /** 值 */
+    value: number | string;
+}

package/lib/plus/skuOptionsSelection/utils/calculateOption.d.ts

@@ -0,0 +1,6 @@
+export declare const calculateOptionItem: (params: {
+    editIndex: number;
+    optionItemValue: any;
+    optionItemDataSource: any;
+    data: any;
+}) => any[];

package/lib/plus/skuOptionsSelection/utils/checkSkuStatus.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @title 检查SKU库存是否可以售卖
+ * @description
+ * 首先受到 SKU 的 is_track 字段的影响，如果 is_track 为 0，表示不跟踪库存，则不检查库存
+ * 其次受到 SKU 的 over_sold 字段 和 config.overSold 配置的影响，如果 over_sold 为 1 或 config.overSold 为 true，表示允许超卖，则不检查库存
+ * 最后受到 SKU 的 stock_quantity 字段的影响，如果 stock_quantity 小于等于 0，表示库存不足
+ */
+export declare const checkSkuStockCanSell: (sku: any) => {
+    canSell: boolean;
+    hasStock: boolean;
+};
+/**
+ * @title 检查SKU是否禁用
+ * @description 如果SKU被禁用，或者库存不足不能售卖，则返回 true
+ */
+export declare const checkSkuDisabled: (sku: any, canSell?: boolean) => boolean;
+/**
+ * @title 组合规格库存检查（初始化时使用）
+ * @description 检查包含该规格选项的所有组合商品的库存状态
+ */
+export declare const checkVariantStockCanSell: (sku: any) => {
+    canSell: any;
+    hasStock: any;
+};
+/**
+ * @title 根据已经选择的规格选项，筛选出包含对应规格的商品并进行库存检查
+ * @description
+ * 1. 收集当前判断的规格 + 其他规格组已选的规格（排除当前规格组）
+ * 2. 根据收集的规格，筛选出包含对应规格的组合商品
+ * 3. 对筛选出的商品进行库存检查
+ * 4. 只要有一个匹配商品能售卖，则该选项可选
+ * 5. 只要有一个匹配商品有库存，则显示有库存
+ */
+export declare const checkVariantStockByValue: (sku: any) => {
+    canSell: boolean;
+    hasStock: boolean;
+};