@pisell/private-materials 6.3.149 → 6.3.150

package/es/plus/pisellSalesGrid/types.d.ts

@@ -0,0 +1,197 @@
+import type { CSSProperties, Key, ReactNode } from 'react';
+/** 排序子项（如 从低到高 / 从高到低），用于 getSortItems 返回值 */
+export interface SortOptionItemCompat {
+    key: string;
+    label: string;
+}
+/** 排序列表项：type 由 Sort 内置生成子项；getSortItems 则完全自定义子项，与 RecordBoard Sort 约定一致 */
+export interface SortListItemCompat {
+    name?: string | string[];
+    label?: string;
+    /** 排序类型，有 getSortItems 时可省略 */
+    type?: 'date' | 'string' | 'number' | 'option';
+    isCustom?: boolean;
+    columnKey?: string;
+    localFilter?: boolean;
+    isHidden?: boolean;
+    /** 自定义排序子项，优先于 type */
+    getSortItems?: (fieldKey: string) => SortOptionItemCompat[];
+}
+/** 筛选列表项：与 RecordBoard / PisellFilter 使用的 FilterItemProps 形状兼容 */
+export interface FilterItemPropsCompat {
+    type: 'single' | 'input' | 'datePicker' | 'rangePicker' | 'rangePickerNew' | 'search' | 'custom';
+    key: string;
+    name?: string | string[];
+    label?: string;
+    props?: Record<string, any>;
+    other?: Record<string, any>;
+    isCustom?: boolean;
+    columnKey?: string;
+    isHidden?: boolean;
+}
+/** 筛选默认值：quickFilter / otherFilter 为筛项列表，values 为表单值 */
+export interface FilterDefaultValueCompat {
+    quickFilter?: FilterItemPropsCompat[];
+    otherFilter?: FilterItemPropsCompat[];
+    values?: Record<string, any>;
+}
+/** ToolBar 内筛选配置：defaultFilterValue 提供筛项与初始值 */
+export interface RecordBoardToolBarFilterCompat {
+    hiddenQuickFilter?: boolean;
+    hiddenOtherFilter?: boolean;
+    defaultFilterValue?: FilterDefaultValueCompat;
+    [key: string]: any;
+}
+/** ToolBar 内排序配置：list 为排序项数组 */
+export interface RecordBoardToolBarSortCompat {
+    list?: SortListItemCompat[];
+    placement?: 'bottom' | 'bottomLeft' | 'bottomRight' | 'top' | 'topLeft' | 'topRight';
+    [key: string]: any;
+}
+/** ToolBar 内快速筛选配置：filterList 覆盖列派生的快筛列表 */
+export interface RecordBoardToolBarQuickFilterCompat {
+    filterList?: FilterItemPropsCompat[];
+    formFiltersPrefix?: string;
+    size?: 'small' | 'middle' | 'large';
+    [key: string]: any;
+}
+/** ToolBar 透传配置：与 RecordBoardToolBarProps 对齐，供 perspective.childComponentProps.toolBar 使用 */
+export interface RecordBoardToolBarPropsCompat {
+    className?: string;
+    style?: CSSProperties;
+    tabs?: ReactNode;
+    topLeft?: ReactNode;
+    topRight?: ReactNode;
+    bottomLeft?: ReactNode;
+    bottomRight?: ReactNode;
+    /** 搜索：true 默认 PisellFind；对象透传 props；false 不渲染 */
+    search?: boolean | Record<string, any>;
+    /** 筛选：true 默认 PisellFilter；对象可传 defaultFilterValue 等；false 不渲染 */
+    filter?: boolean | RecordBoardToolBarFilterCompat;
+    /** 排序：true 默认由列派生；对象可传 list、placement；false 不渲染 */
+    sort?: boolean | RecordBoardToolBarSortCompat;
+    /** 快速筛选：true 用列派生；对象可传 filterList 等 */
+    quickFilter?: boolean | RecordBoardToolBarQuickFilterCompat;
+    /** 列设置入口；默认 true */
+    columnSetting?: boolean;
+}
+/** Grid 透传配置：与 RecordBoardGridProps 对齐，多选由 SalesGrid 合并后传入 */
+export interface RecordBoardGridPropsCompat {
+    /** 列配置；列上可设 hidden: true 表示默认隐藏，与 defaultHiddenColumnKeys 合并由 RecordBoard 初始化列显隐 */
+    columns?: any[];
+    /** 默认隐藏的列 key 列表（对应 columns 的 key 或 dataIndex），与列上 hidden: true 合并后由 RecordBoard 初始化列显隐 */
+    defaultHiddenColumnKeys?: string[];
+    /** 当前页某列全同值/全空时隐藏该列并在表格上方展示总结区；默认 true，传 false 可关闭 */
+    collapseUniformColumns?: boolean;
+    /** 表格滚动，与 RecordBoard grid.scroll 对齐（含 autoCalc、scrollToFirstRowOnChange） */
+    scroll?: {
+        x?: number | string;
+        y?: number | string;
+        autoCalc?: boolean;
+        scrollToFirstRowOnChange?: boolean;
+    };
+    /** 表格尺寸 */
+    size?: 'small' | 'middle' | 'default';
+    /** 其余为 antd Table 透传（onRow、onHeaderRow、expandable、rowClassName、summary 等） */
+    [key: string]: any;
+}
+/** 与 RecordBoard 打散子组件配置兼容；grid 会与多选（selectedKeys/selectedRows/onSelectionChange）合并后传给 RecordBoard */
+export interface RecordBoardChildComponentPropsCompat {
+    /** 搜索配置，透传 PisellFind */
+    search?: Record<string, any>;
+    /** 工具栏配置：sort / filter / quickFilter 等 */
+    toolBar?: RecordBoardToolBarPropsCompat;
+    /** 分页组件透传配置 */
+    pagination?: Record<string, any>;
+    /** Grid 配置：columns、defaultHiddenColumnKeys、scroll、及 Table 透传 */
+    grid?: RecordBoardGridPropsCompat;
+    /** 卡片列表配置（card 布局时） */
+    cardList?: Record<string, any>;
+    /** 批量操作栏配置 */
+    batchActionBar?: Record<string, any>;
+    /**
+     * 平面图：与 PisellRecordBoard.floorMap 对齐，透传 PisellFloorMapLayout；
+     * 有值时工具栏出现「表格 / 平面图」切换。
+     */
+    floorMap?: Record<string, any>;
+    /** 有 floorMap 时首屏默认子视图；PisellReservation 组件内默认为 floorMap */
+    defaultBodyView?: 'grid' | 'floorMap';
+}
+/**
+ * 列渲染覆盖项：当视角的 grid.columns 中某列的 type 与此 type 一致时，使用此 render 替代该列默认渲染再传给 RecordBoard。
+ */
+export interface SalesGridColumnRenderer {
+    /** 与列配置的 type 匹配（如 'currency'、'singleSelect'） */
+    type: string;
+    /** 自定义列单元格渲染 */
+    render: (value: any, record: any, index: number) => ReactNode;
+}
+/**
+ * Perspective 运行时上下文：由 PisellSalesGrid 在运行时构建，
+ * 传入 perspective 的 getChildComponentProps 工厂函数，
+ * 使 columns / onRow / toolBar 等配置可访问刷新列表等运行时能力。
+ */
+export interface SalesGridRuntimeContext {
+    /** 重新请求当前列表数据（同步触发） */
+    refresh: () => void;
+    /** 重新请求当前列表数据（返回 Promise） */
+    refreshAsync: () => Promise<any>;
+    /** 当前激活的 perspective key */
+    currentPerspective: string;
+}
+/**
+ * 单个 Perspective 配置：对应一套 RecordBoard（表格 + 可选工具栏内平面图）。
+ * 支持两种配置方式（二选一）：
+ * 1. **静态配置** — 直接提供 childComponentProps。
+ * 2. **工厂配置** — 提供 getChildComponentProps(ctx)。
+ * 平面图：在 childComponentProps 中传 `floorMap`、`defaultBodyView`，由 RecordBoard 工具栏切换。
+ */
+export interface SalesGridPerspectiveConfig {
+    /** Perspective 唯一标识，与 currentPerspective 对应 */
+    key: string;
+    /** Perspective 展示名称（可选，供外部展示用） */
+    label?: string;
+    /** 该 Perspective 下 RecordBoard 子组件透传配置 */
+    childComponentProps?: RecordBoardChildComponentPropsCompat;
+    /**
+     * 工厂函数：接收运行时上下文，返回 RecordBoard 透传配置。
+     * 存在时忽略 childComponentProps。
+     */
+    getChildComponentProps?: (ctx: SalesGridRuntimeContext) => RecordBoardChildComponentPropsCompat;
+}
+export interface PisellSalesGridProps {
+    /** Perspective 数据：一组 RecordBoard 配置，支持配置多个 Perspective */
+    perspectives: SalesGridPerspectiveConfig[];
+    /** 当前 Perspective：对应 perspectives[].key，决定使用哪个 Perspective 的配置渲染 RecordBoard */
+    currentPerspective: string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    extParams?: Record<string, any>;
+    /** 实例 id，透传 RecordBoard 用于列显隐持久化（localStorage，与 @pisell/utils getComponentStorageKey 规则一致） */
+    __id?: string;
+    /** 受控数据：传入时表格视角使用此处数据，不请求 getOrderList/getBookingList（用于 Story、静态数据等） */
+    data?: any[];
+    loading?: boolean;
+    total?: number;
+    pagination?: {
+        pageNumber: number;
+        pageSize: number;
+    };
+    onPageChange?: (pageNumber: number, pageSize: number) => void;
+    searchParams?: Record<string, any>;
+    onSearch?: (params: Record<string, any>) => void;
+    onReset?: () => void;
+    selectedKeys?: React.Key[];
+    selectedRows?: any[];
+    onSelectionChange?: (keys: React.Key[], rows: any[]) => void;
+    rowKey?: string | ((record: any) => Key);
+    /** 受控时由父组件提供，供 perspective 的 getChildComponentProps 中 ctx.refresh 使用 */
+    onRefresh?: () => void;
+    refreshAsync?: () => Promise<any>;
+    /** 按列 type 覆盖单元格渲染；与内置合并，同 type 时传入的覆盖内置 */
+    columnRenderers?: SalesGridColumnRenderer[];
+}
+/** Story / 演示用的数据源相关 props 组合（与 PisellSalesGrid 列表态常用字段一致） */
+export declare type SalesGridDataSourceProps = Pick<PisellSalesGridProps, 'data' | 'loading' | 'total' | 'pagination' | 'onPageChange' | 'searchParams' | 'onSearch' | 'onReset' | 'selectedKeys' | 'selectedRows' | 'onSelectionChange' | 'rowKey'>;

package/es/plus/pisellSalesManagement/hooks/useSalesGridData.d.ts

@@ -0,0 +1,30 @@
+export interface UseSalesGridDataParams {
+    perspective: 'monitor' | 'handle';
+    extParams?: {
+        list?: Record<string, any>;
+    };
+}
+/**
+ * Sales Management 内使用的列表数据 hook：统一发起订单/预订列表请求，
+ * 管理分页、筛选、多选状态，并返回传给 PisellSalesGrid 的受控 props，
+ * 使 Sales Grid 成为通用展示组件。
+ */
+export declare function useSalesGridData(params: UseSalesGridDataParams): {
+    data: any;
+    loading: boolean;
+    total: any;
+    pagination: {
+        pageNumber: number;
+        pageSize: number;
+    };
+    onPageChange: (pageNumber: number, pageSize: number) => void;
+    searchParams: Record<string, any>;
+    onSearch: (params: Record<string, any>) => void;
+    onReset: () => void;
+    selectedKeys: import("react").Key[];
+    selectedRows: any[];
+    onSelectionChange: (keys: React.Key[], rows: any[]) => void;
+    rowKey: "id";
+    onRefresh: () => void;
+    refreshAsync: () => Promise<any>;
+};

package/es/plus/pisellSalesProductCard/locales.d.ts

@@ -0,0 +1,38 @@
+declare const _default: {
+    en: {
+        'pisell2.text.options': string;
+        'pisell2.salesProductCard.modal.title': string;
+        'pisell2.salesProductCard.modal.quantity': string;
+        'pisell2.salesProductCard.modal.addToCart': string;
+        'pisell2.salesProductCard.modal.detailSection': string;
+    };
+    'zh-CN': {
+        'pisell2.text.options': string;
+        'pisell2.salesProductCard.modal.title': string;
+        'pisell2.salesProductCard.modal.quantity': string;
+        'pisell2.salesProductCard.modal.addToCart': string;
+        'pisell2.salesProductCard.modal.detailSection': string;
+    };
+    'zh-HK': {
+        'pisell2.text.options': string;
+        'pisell2.salesProductCard.modal.title': string;
+        'pisell2.salesProductCard.modal.quantity': string;
+        'pisell2.salesProductCard.modal.addToCart': string;
+        'pisell2.salesProductCard.modal.detailSection': string;
+    };
+    ja: {
+        'pisell2.text.options': string;
+        'pisell2.salesProductCard.modal.title': string;
+        'pisell2.salesProductCard.modal.quantity': string;
+        'pisell2.salesProductCard.modal.addToCart': string;
+        'pisell2.salesProductCard.modal.detailSection': string;
+    };
+    pt: {
+        'pisell2.text.options': string;
+        'pisell2.salesProductCard.modal.title': string;
+        'pisell2.salesProductCard.modal.quantity': string;
+        'pisell2.salesProductCard.modal.addToCart': string;
+        'pisell2.salesProductCard.modal.detailSection': string;
+    };
+};
+export default _default;

package/es/plus/pisellSalesProductCard/types.d.ts

@@ -0,0 +1,134 @@
+/// <reference types="react" />
+import type { BundleGroupItem, BundleItem, OptionGroupItem, SkuCardConfig, VariantProductItem, VariantGroupItem } from '../skuOptionsSelection/types';
+import type { NumericStepperProps } from '../../pro/NumericStepper/index';
+/**
+ * 达到 min / max 限制时希望展示的提示文案。
+ * 通常来自 item_rule_limit.maxValidationMessage / minValidationMessage。
+ * 对应字段为空时该方向不 toast（仍会走 locales 里的默认兑底，详见 PisellSalesProductCard）。
+ */
+export interface SalesProductLimitMessage {
+    max?: string;
+    min?: string;
+}
+/**
+ * 商品卡使用的 stepper 配置，在 NumericStepperProps 基础上扩展业务字段。
+ */
+export declare type SalesProductStepperProps = NumericStepperProps & {
+    /**
+     * 达到限制时希望展示的提示文案。支持：
+     * - string：等价于 { max: string }（兼容旧用法）；
+     * - { min?, max? }：min / max 分开配置。
+     */
+    limitMessage?: string | SalesProductLimitMessage;
+};
+export declare type SalesProductText = string | Record<string, string>;
+/**
+ * 从 SKUOptionsSelection 数据结构反推的完整商品定义。
+ * 兼容普通商品、单规格商品、组合规格商品、套餐商品。
+ */
+export interface SalesProduct {
+    id?: number | string;
+    product_id?: number;
+    product_variant_id?: number;
+    title?: SalesProductText;
+    name?: SalesProductText;
+    product_subtitle?: string;
+    subtitle?: string;
+    description?: string | null;
+    cover?: string;
+    media?: Array<any>;
+    price?: string | number;
+    original_price?: string | number;
+    selling_price?: string | number;
+    payment_price?: string | number;
+    tax_fee?: string | number;
+    num?: number;
+    quantity?: number;
+    is_track?: 0 | 1;
+    stock_quantity?: number;
+    disabled?: 0 | 1 | boolean;
+    is_bundle?: 0 | 1 | boolean;
+    /**
+     * 业务侧可能通过类型字段直接标识商品类型
+     */
+    type?: 'normal' | 'option' | 'variant' | 'bundle' | string;
+    product_type?: 'normal' | 'option' | 'variant' | 'bundle' | string;
+    /**
+     * SKU 相关结构
+     */
+    option_group?: OptionGroupItem[];
+    variant_group?: VariantGroupItem[];
+    variant?: VariantProductItem[];
+    bundle_group?: BundleGroupItem[] | BundleItem[];
+    bundle_item?: BundleItem[];
+    product_option_item?: Array<Record<string, any>>;
+    product_bundle?: Array<Record<string, any>>;
+    metadata?: Record<string, any>;
+}
+/**
+ * PRD 中 products 数组单条 value 结构
+ */
+export interface SalesProductValue {
+    /** 订单明细 ID，创建时可为 null */
+    order_detail_id?: number | string | null;
+    /** 商品 ID（自定义商品可为 null） */
+    product_id?: number | string | null;
+    /** 数量（初始化阶段可由外部后续补充） */
+    num?: number;
+    /** 多规格商品 ID */
+    product_variant_id?: number | string;
+    /** 选项配置 */
+    product_option_item?: Array<Record<string, any>>;
+    /** 销售单价（交易快照） */
+    selling_price?: string;
+    /** 原价（交易快照） */
+    original_price?: string;
+    /** 支付单价（交易快照） */
+    payment_price?: string;
+    /** 税费 */
+    tax_fee?: string;
+    /** 是否收税 */
+    is_charge_tax?: 0 | 1;
+    /** 折扣列表 */
+    discount_list?: Array<Record<string, any>>;
+    /** 套餐子商品 */
+    product_bundle?: SalesProductBundleValue[];
+    /** 元数据 */
+    metadata?: {
+        unique_identification_number?: string;
+        [key: string]: any;
+    };
+}
+/**
+ * PRD 中 product_bundle 结构
+ */
+export interface SalesProductBundleValue {
+    bundle_group_id?: number;
+    bundle_id?: number;
+    bundle_variant_id?: number;
+    num?: number;
+    extension_id?: number;
+    extension_type?: string;
+    option?: Array<Record<string, any>>;
+}
+export declare type SalesProductCardIntent = 'detail' | 'options' | 'quantity';
+export declare type SalesProductCardTrigger = 'card' | 'button' | 'stepper';
+export interface SalesProductCardMeta {
+    intent: SalesProductCardIntent;
+    trigger: SalesProductCardTrigger;
+    product: SalesProduct;
+}
+export interface PisellSalesProductCardProps {
+    product: SalesProduct;
+    /** PRD products[i] value，组件会基于它进行增量更新并回传 */
+    value?: Partial<SalesProductValue>;
+    disabled?: boolean;
+    stepperProps?: SalesProductStepperProps;
+    optionsText?: string;
+    skuCardConfig?: SkuCardConfig;
+    cartElementId?: string;
+    style?: React.CSSProperties;
+    className?: string;
+    onChange?: (value: SalesProductValue, meta: SalesProductCardMeta) => void;
+    onClick?: (value: SalesProductValue, meta: SalesProductCardMeta) => void;
+}

package/es/plus/pisellSalesProductCard/utils.d.ts

@@ -0,0 +1,17 @@
+declare type CardAnimaProps = {
+    position: {
+        x: number;
+        y: number;
+    };
+    cartElementId: string;
+};
+/**
+ * @title: 贝塞尔曲线
+ * @description:
+ * @param {CardAnimaProps} param1
+ * @return {*}
+ * @Author: zhiwei.Wang
+ * @Date: 2023-04-03 15:25
+ */
+export declare const cubicBezier: ({ position, cartElementId }: CardAnimaProps) => void;
+export {};

package/es/plus/productSelect/CategoryTabs/index.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import '../components/TabsStructure/TabsStructure.less';
+import CategorySkeleton from './CategorySkeleton';
+declare type TabItem = {
+    key: string;
+    label: React.ReactNode;
+    icon?: React.ReactNode;
+};
+interface IProps {
+    className?: string;
+    items: TabItem[];
+    activeKey: string;
+    onChange: (key: string) => void;
+    loading?: boolean;
+    skeleton?: React.ReactNode;
+    style?: React.CSSProperties;
+    id?: string;
+}
+declare const CategoryTabs: React.ForwardRefExoticComponent<IProps & React.RefAttributes<unknown>>;
+export default CategoryTabs;
+export { CategorySkeleton };

package/es/plus/productSelect/ProductCard/ProductCardV2.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import type { ProductCardConfig } from './index';
+interface ProductCardV2Props {
+    item: any;
+    index: number;
+    context?: {
+        onItemIntersectionIn: (item: any) => void;
+        onItemIntersectionOut: (item: any) => void;
+    };
+    className?: string;
+    value?: any;
+    onChange?: (value: any, meta?: any) => void;
+    decorateConfig?: ProductCardConfig;
+    cartElementId?: string;
+}
+/**
+ * v2 卡片：复用 ProductCard 的结构能力（分类项 + IntersectionTrigger），
+ * 商品项内部渲染 PisellSalesProductCard。
+ */
+declare const ProductCardV2: React.MemoExoticComponent<({ item, index, context, className, value, onChange, decorateConfig, cartElementId, }: ProductCardV2Props) => JSX.Element>;
+export default ProductCardV2;

package/es/plus/productSelect/ProductCard/index.d.ts

@@ -0,0 +1,47 @@
+import React from 'react';
+import ProductCardSkeleton from './ProductCardSkeleton';
+import './index.less';
+declare type BoolConfigVal = 0 | 1;
+export interface ProductCardConfig {
+    isProductCover?: BoolConfigVal;
+    imgWidth?: string;
+    imgHeight?: string;
+    radius?: number;
+    isTitle?: BoolConfigVal;
+    isSubtitle?: BoolConfigVal;
+    showSpec?: boolean;
+    isTag?: BoolConfigVal;
+    isPrice?: BoolConfigVal;
+    isOriginPrice?: BoolConfigVal;
+    showZeroPrice?: boolean;
+    showMarketingTag?: boolean;
+    showRemark?: boolean;
+    isStock?: BoolConfigVal;
+}
+export interface ProductCardProps {
+    item: any;
+    index: number;
+    context?: {
+        onItemIntersectionIn: (item: any) => void;
+        onItemIntersectionOut: (item: any) => void;
+    };
+    className?: string;
+    onSelectProduct?: (item: any) => void;
+    currentProductId?: number;
+    onSelect?: (item: any) => void;
+    onSelectCover?: (item: any) => void;
+    onSelectInfo?: (item: any) => void;
+    isSelected?: boolean;
+    decorateConfig?: ProductCardConfig;
+}
+export declare const ProductCard: React.MemoExoticComponent<({ item, index, context, onSelect, onSelectCover, onSelectInfo, isSelected, className, decorateConfig, }: ProductCardProps) => JSX.Element>;
+export declare const DefaultItemContent: React.MemoExoticComponent<(props: {
+    item: any;
+    index: number;
+    context?: {
+        onItemIntersectionIn: (item: any) => void;
+        onItemIntersectionOut: (item: any) => void;
+    } | undefined;
+}) => JSX.Element>;
+export default ProductCard;
+export { ProductCardSkeleton };

package/es/plus/saasCreateOrganization/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { SCOProps } from './types';
 import './index.less';
 declare const SaasCreateOrganization: (props: SCOProps) => JSX.Element;