@pisell/private-materials 6.8.33 → 6.8.35

package/lib/components/eventBooking/components/bookingAvailabilityCalendar/components/CalendarDate/CalenDateWeek/CallToBook/index.d.ts

@@ -7,5 +7,5 @@ declare type CallToBookProps = {
 export declare const defaultBookingConfig: {
     booking_mode_after_cut_off: string;
 };
-declare const CallToBook: (props: CallToBookProps) => JSX.Element | null;
+declare const CallToBook: (props: CallToBookProps) => import("react").JSX.Element | null;
 export default CallToBook;

package/lib/components/eventBooking/components/bookingAvailabilityCalendar/components/CalendarDate/CalenDateWeek/WeekItem/index.d.ts

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

package/lib/components/eventBooking/components/bookingAvailabilityCalendar/components/CalendarDate/CalenDateWeek/index.d.ts

@@ -8,5 +8,5 @@ declare type CalenDateWeekProps = {
     dateLimitData: any;
     cutTime: any;
 };
-declare const CalenDateWeek: (props: CalenDateWeekProps) => JSX.Element;
+declare const CalenDateWeek: (props: CalenDateWeekProps) => import("react").JSX.Element;
 export default CalenDateWeek;

package/lib/components/eventBooking/components/bookingAvailabilityCalendar/components/CalendarDate/Item/DayItem/index.d.ts

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

package/lib/components/eventBooking/components/bookingAvailabilityCalendar/components/CalendarDate/Item/index.d.ts

@@ -1,5 +1,4 @@
-/// <reference types="react" />
 import './index.less';
 import { CalendarItemProps } from '../../../../../type';
-declare const Item: (props: CalendarItemProps) => JSX.Element;
+declare const Item: (props: CalendarItemProps) => import("react").JSX.Element;
 export default Item;

package/lib/components/eventBooking/components/bookingAvailabilityCalendar/components/CalendarDate/Status/index.d.ts

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

package/lib/components/eventBooking/components/bookingDetailModal/components/BookingOptions.d.ts

@@ -1,4 +1,5 @@
+import React from 'react';
 declare const BookingOptions: (props: {
     onChangeBookingOption?: ((bookingOption: any) => void) | undefined;
-}) => JSX.Element;
+}) => React.JSX.Element;
 export default BookingOptions;

package/lib/components/eventBooking/components/bookingDetailModal/components/Resource.d.ts

@@ -1,3 +1,3 @@
-/// <reference types="react" />
-declare const Resource: (props: any) => JSX.Element;
+import React from 'react';
+declare const Resource: (props: any) => React.JSX.Element;
 export default Resource;

package/lib/components/eventBooking/components/bookingDetailModal/components/Schedule.d.ts

@@ -1,3 +1,3 @@
-/// <reference types="react" />
-declare const Schedule: () => JSX.Element;
+import React from 'react';
+declare const Schedule: () => React.JSX.Element;
 export default Schedule;

package/lib/components/eventBooking/components/scheduleCalendar/ProductItem/index.d.ts

@@ -1,4 +1,4 @@
-/// <reference types="react" />
+import React from 'react';
 import './index.less';
 declare type Item = any;
 interface ProductItemProps {
@@ -6,5 +6,5 @@ interface ProductItemProps {
     onClickItem: (item: Item) => void;
     layout?: 'day' | 'all';
 }
-declare const ProductItem: ({ item, onClickItem, layout, }: ProductItemProps) => JSX.Element;
+declare const ProductItem: ({ item, onClickItem, layout, }: ProductItemProps) => React.JSX.Element;
 export default ProductItem;

package/lib/components/eventBooking/components/scheduleCalendar/calendarItem.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { CalendarDataItem } from '../../type';
 declare type CalendarItemProps = {
     month: string;
@@ -8,5 +9,5 @@ declare type CalendarItemProps = {
     isEdit: boolean;
     type?: 'calendarView' | 'textList';
 };
-declare const CalendarItem: (props: CalendarItemProps) => JSX.Element;
+declare const CalendarItem: (props: CalendarItemProps) => React.JSX.Element;
 export default CalendarItem;

package/lib/components/eventBooking/components/scheduleCalendar/components/ScheduleTimeItem/index.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import './index.less';
-declare const ScheduleTimeItem: ({ timeList }: any) => JSX.Element;
+declare const ScheduleTimeItem: ({ timeList }: any) => React.JSX.Element;
 export default ScheduleTimeItem;

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

@@ -1,3 +1,4 @@
+import React from 'react';
 import './index.less';
-declare const EventBooking: () => JSX.Element;
+declare const EventBooking: () => React.JSX.Element;
 export default EventBooking;

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

@@ -0,0 +1,36 @@
+import React from 'react';
+import type { SkuValue } from '../../plus/skuOptionsSelection/types';
+import './index.less';
+/**
+ * @description Kiosk 商品详情（参考 Figma: Kiosk / Launchpad screen）
+ * - 默认从 URL query 读取商品 id（productId / product_id / id），内部通过 getProductDetail 拉取详情
+ * - 中间区域用 SKUOptionsSelection 做 SKU 选择
+ * - 底部用 PisellNumberSelector 做数量编辑
+ */
+declare function KioskSkuDetail(props: KioskSkuDetailProps): React.JSX.Element;
+export default KioskSkuDetail;
+export interface KioskSkuDetailProps {
+    /** 商品 id（可选：目前默认从 URL 读取，props 仅作为兜底以兼容老用法） */
+    productId?: number | string;
+    /**
+     * 可选：用于商品报价的日期（预约类商品）
+     * @deprecated 目前 kiosk 详情暂时固定取当天，这个参数暂不生效
+     */
+    scheduleDate?: string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 返回 */
+    onBack?: () => void;
+    /** 加入购物车 */
+    onAddToCart?: (params: {
+        product: any;
+        skuValue: SkuValue;
+        quantity: number;
+        unitPrice: number;
+        total: number;
+        currencySymbol: string;
+        bookingConfig?: any;
+    }) => void;
+}

package/lib/components/list/List.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import './List.less';
+import { ListProps, BaseListItem } from './types';
+declare const List: <TItem extends BaseListItem = BaseListItem>(props: ListProps<TItem>) => React.ReactElement;
+export default List;

package/lib/components/list/components/ListItemSkeleton/ListItemSkeleton.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import './ListItemSkeleton.less';
+interface ListItemSkeletonProps {
+    className?: string;
+    style?: React.CSSProperties;
+    displayStyle?: 'grid' | 'waterfall';
+    showImage?: boolean;
+    imageWidth?: number;
+    imageHeight?: number;
+    rows?: number;
+}
+declare const ListItemSkeleton: React.FC<ListItemSkeletonProps>;
+export default ListItemSkeleton;

package/lib/components/list/components/ListItemSkeleton/index.d.ts

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

package/lib/components/list/components/ScrollLoader/ScrollLoader.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import './ScrollLoader.less';
+export interface ScrollLoadState {
+    canLoadMore: boolean;
+    totalLoaded: number;
+}
+export interface ScrollLoaderProps {
+    /** 是否正在加载 */
+    loading: boolean;
+    /** 滚动加载状态 */
+    scrollLoadState?: ScrollLoadState | null;
+    /** 布局方向 */
+    layoutDirection: 'horizontal' | 'vertical';
+    /** 分页类型 */
+    paginationType: 'all' | 'scroll' | 'pager' | 'more';
+}
+declare const ScrollLoader: React.FC<ScrollLoaderProps>;
+export default ScrollLoader;

package/lib/components/list/components/ScrollLoader/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './ScrollLoader';
+export type { ScrollLoaderProps, ScrollLoadState } from './ScrollLoader';

package/lib/components/list/components/Tab/Tab.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import './Tab.less';
+import { TabProps } from './types';
+declare const Tab: React.FC<TabProps>;
+export default Tab;

package/lib/components/list/components/Tab/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './Tab';
+export type { TabProps } from './types';

package/lib/components/list/components/Tab/types.d.ts

@@ -0,0 +1,14 @@
+/// <reference types="react" />
+import { TabItem } from '../../types';
+export interface TabProps {
+    /** 类名 */
+    className?: string;
+    /** 样式 */
+    style?: React.CSSProperties;
+    /** 当前激活的tab */
+    activeKey?: string;
+    /** tab项 */
+    items: TabItem[];
+    /** tab切换回调 */
+    onChange?: (key: string) => void;
+}

package/lib/components/list/components/TabSkeleton/TabSkeleton.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import './TabSkeleton.less';
+interface TabSkeletonProps {
+    className?: string;
+    style?: React.CSSProperties;
+    tabCount?: number;
+    animated?: boolean;
+    tabStyle?: 'switch' | 'anchor';
+}
+declare const TabSkeleton: React.FC<TabSkeletonProps>;
+export default TabSkeleton;

package/lib/components/list/components/TabSkeleton/index.d.ts

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

package/lib/components/list/components/WaterfallList/WaterfallList.d.ts

@@ -0,0 +1,33 @@
+import React, { ReactNode } from 'react';
+import { WaterfallLayout } from '../../hooks/useWaterfall';
+import './WaterfallList.less';
+export interface WaterfallListProps<TItem extends {
+    id: string | number;
+    height?: number;
+    width?: number;
+} = any> {
+    /** 瀑布流布局数据 */
+    layout: WaterfallLayout<TItem>;
+    /** 布局方向 */
+    layoutDirection: 'horizontal' | 'vertical';
+    /** 列间距 */
+    columnGap: number;
+    /** 行间距 */
+    rowGap: number;
+    /** 列数 */
+    columns: number;
+    /** 行数 */
+    rows: number;
+    /** 注册元素引用的函数 */
+    registerItemRef: (id: string | number, element: HTMLElement | null) => void;
+    /** 子元素 */
+    children?: ReactNode;
+    /** 自定义渲染函数 */
+    renderItem?: (item: TItem, index: number) => ReactNode;
+}
+declare const WaterfallList: <TItem extends {
+    id: string | number;
+    height?: number | undefined;
+    width?: number | undefined;
+} = any>(props: WaterfallListProps<TItem>) => React.ReactElement;
+export default WaterfallList;

package/lib/components/list/components/WaterfallList/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './WaterfallList';
+export type { WaterfallListProps } from './WaterfallList';

package/lib/components/list/hooks/useDevice.d.ts

@@ -0,0 +1,24 @@
+export declare type DeviceType = 'pc' | 'pad' | 'mobile';
+export interface DeviceInfo {
+    type: DeviceType;
+    isMobile: boolean;
+    isPad: boolean;
+    isPc: boolean;
+    width: number;
+    height: number;
+}
+/**
+ * 设备检测Hook
+ * 根据屏幕宽度和用户代理判断当前设备类型
+ */
+export declare const useDevice: () => DeviceInfo;
+/**
+ * 获取用户代理信息
+ * @returns 用户代理相关信息
+ */
+export declare const getUserAgentInfo: () => {
+    isMobileUA: boolean;
+    isTabletUA: boolean;
+    isDesktopUA: boolean;
+    userAgent: string;
+};

package/lib/components/list/hooks/useListState.d.ts

@@ -0,0 +1,45 @@
+import { TabItem, LoadDataParams } from '../types';
+export interface ListState {
+    activeTab: string;
+    currentPage: number;
+    isStickyActive: boolean;
+}
+export declare type ListAction = {
+    type: 'SET_ACTIVE_TAB';
+    payload: string[] | string;
+} | {
+    type: 'SET_CURRENT_PAGE';
+    payload: number;
+} | {
+    type: 'SET_STICKY_ACTIVE';
+    payload: boolean;
+} | {
+    type: 'RESET_PAGE';
+};
+export interface UseListStateProps {
+    /** 外部传入的当前页码 */
+    externalCurrentPage?: number;
+    /** tab数据 */
+    tabItems: TabItem[];
+    /** 默认页面大小 */
+    defaultPageSize: number;
+    /** 数据加载回调 */
+    onLoadData?: (params: LoadDataParams) => void;
+    /** tab样式 */
+    tabStyle: 'anchor' | 'switch' | 'none';
+}
+export interface UseListStateReturn {
+    state: ListState;
+    setActiveTab: (tab: string) => void;
+    setCurrentPage: (page: number) => void;
+    setStickyActive: (active: boolean) => void;
+    resetPage: () => void;
+    handleTabChange: (key: string[] | string) => void;
+    handlePageChange: (page: number, size?: number) => void;
+    handleShowSizeChange: (current: number, size: number) => void;
+    handleLoadMore: () => void;
+    handleViewLess: () => void;
+    handleScrollLoad: () => void;
+    actualCurrentPage: number;
+}
+export declare const useListState: ({ externalCurrentPage, tabItems, defaultPageSize, onLoadData, tabStyle, }: UseListStateProps) => UseListStateReturn;

package/lib/components/list/hooks/useWaterfall.d.ts

@@ -0,0 +1,34 @@
+export interface WaterfallItem {
+    id: string | number;
+    data: any;
+    height?: number;
+    width?: number;
+}
+export interface WaterfallTrack<T = any> {
+    items: T[];
+    size: number;
+}
+export interface WaterfallLayoutOptions {
+    tracks: number;
+    trackGap: number;
+    itemGap: number;
+    direction: 'vertical' | 'horizontal';
+}
+export interface WaterfallLayout<T = any> {
+    tracks: WaterfallTrack<T>[];
+    totalSize: number;
+}
+export declare const useWaterfall: <T extends {
+    id: string | number;
+    height?: number | undefined;
+    width?: number | undefined;
+}>(items: T[], options: WaterfallLayoutOptions) => {
+    layout: WaterfallLayout<T>;
+    registerItemRef: (id: string | number, element: HTMLElement | null) => void;
+    measureItemSize: (id: string | number) => {
+        width: number;
+        height: number;
+    };
+    recalculateLayout: () => void;
+};
+export default useWaterfall;

package/lib/components/list/locales.d.ts

@@ -0,0 +1,66 @@
+declare const _default: {
+    en: {
+        'pisell-list-tab-group-default': string;
+        'pisell-list-empty-text-default': string;
+        'pisell-list-load-more': string;
+        'pisell-list-view-less': string;
+        'pisell-list-pagination-total': (start: number, end: number, total: number) => string;
+        'pisell-list-pagination-total-fallback': (start: number, end: number, total: number) => string;
+        'pisell-list-pagination-page-of': (current: number, total: number) => string;
+        'pisell-list-pagination-previous': string;
+        'pisell-list-pagination-next': string;
+        'pisell-list-scroll-down': string;
+        'pisell-list-scroll-right': string;
+        'pisell-list-scroll-to-bottom': string;
+        'pisell-list-scroll-to-end': string;
+        'pisell-list-loading': string;
+        'pisell-list-loading-more': string;
+        'pisell-list-no-more-data': string;
+        'pisell-list-group-title-all': string;
+        'pisell-list-load-error': string;
+        'pisell-list-retry': string;
+    };
+    'zh-CN': {
+        'pisell-list-tab-group-default': string;
+        'pisell-list-empty-text-default': string;
+        'pisell-list-load-more': string;
+        'pisell-list-view-less': string;
+        'pisell-list-pagination-total': (start: number, end: number, total: number) => string;
+        'pisell-list-pagination-total-fallback': (start: number, end: number, total: number) => string;
+        'pisell-list-pagination-page-of': (current: number, total: number) => string;
+        'pisell-list-pagination-previous': string;
+        'pisell-list-pagination-next': string;
+        'pisell-list-scroll-down': string;
+        'pisell-list-scroll-right': string;
+        'pisell-list-scroll-to-bottom': string;
+        'pisell-list-scroll-to-end': string;
+        'pisell-list-loading': string;
+        'pisell-list-loading-more': string;
+        'pisell-list-no-more-data': string;
+        'pisell-list-group-title-all': string;
+        'pisell-list-load-error': string;
+        'pisell-list-retry': string;
+    };
+    'zh-HK': {
+        'pisell-list-tab-group-default': string;
+        'pisell-list-empty-text-default': string;
+        'pisell-list-load-more': string;
+        'pisell-list-view-less': string;
+        'pisell-list-pagination-total': (start: number, end: number, total: number) => string;
+        'pisell-list-pagination-total-fallback': (start: number, end: number, total: number) => string;
+        'pisell-list-pagination-page-of': (current: number, total: number) => string;
+        'pisell-list-pagination-previous': string;
+        'pisell-list-pagination-next': string;
+        'pisell-list-scroll-down': string;
+        'pisell-list-scroll-right': string;
+        'pisell-list-scroll-to-bottom': string;
+        'pisell-list-scroll-to-end': string;
+        'pisell-list-loading': string;
+        'pisell-list-loading-more': string;
+        'pisell-list-no-more-data': string;
+        'pisell-list-group-title-all': string;
+        'pisell-list-load-error': string;
+        'pisell-list-retry': string;
+    };
+};
+export default _default;

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

@@ -0,0 +1,178 @@
+import { ReactNode, CSSProperties } from 'react';
+/** 设备类型 */
+export declare type DeviceType = 'pc' | 'pad' | 'mobile';
+/** 设备信息 */
+export interface DeviceInfo {
+    type: DeviceType;
+    isMobile: boolean;
+    isPad: boolean;
+    isPc: boolean;
+    width: number;
+    height: number;
+}
+/** 响应式配置接口 */
+export interface ResponsiveConfig {
+    /** PC端特定配置 */
+    pc?: Partial<ListProps>;
+    /** 平板端特定配置 */
+    pad?: Partial<ListProps>;
+    /** 移动端特定配置 */
+    mobile?: Partial<ListProps>;
+}
+/** 响应式Props接口 - 继承ListProps并添加responsive属性 */
+export interface ResponsiveProps extends ListProps {
+    /** 响应式配置 */
+    responsive?: ResponsiveConfig;
+}
+/** ResponsiveWrapper 组件属性 */
+export interface ResponsiveWrapperProps extends ResponsiveProps {
+    /** 子元素 */
+    children?: ReactNode;
+}
+/** 基础列表项接口 */
+export interface BaseListItem {
+    /** 唯一标识 */
+    id: string | number;
+    /** 预设高度（瀑布流模式） */
+    height?: number;
+    /** 预设宽度（瀑布流模式） */
+    width?: number;
+    /** 其他任意属性，可以包含用于分组的字段 */
+    [key: string]: any;
+}
+/** 空状态配置接口 */
+export interface EmptyStateConfig {
+    /** 是否显示空状态 */
+    show?: boolean;
+    /** 空状态文本 */
+    text?: string;
+    /** 空状态图标 */
+    icon?: ReactNode;
+    /** 空状态描述 */
+    description?: string;
+}
+/** 分页信息接口 */
+export interface PaginationInfo {
+    /** 当前页数 */
+    current?: number;
+    /** 总页数 */
+    total?: number;
+    /** 总数据条数 */
+    totalCount?: number;
+}
+/** 布局配置接口 */
+export interface LayoutConfig {
+    /** 显示样式 */
+    displayStyle?: 'grid' | 'waterfall';
+    /** 排版方式 */
+    layoutDirection?: 'horizontal' | 'vertical';
+    /** 列数 */
+    columns?: number;
+    /** 行数 */
+    rows?: number;
+    /** 列间距 */
+    columnGap?: number;
+    /** 行间距 */
+    rowGap?: number;
+    /** 缩放倍率 */
+    zoom?: number;
+}
+/** Tab配置接口 */
+export interface TabConfig {
+    /** tab样式 */
+    tabStyle?: 'anchor' | 'switch' | 'none';
+    /** 指定用于分组的数据字段名，例如 'category'、'type' 等 */
+    tabGroup?: string;
+    /** Tab数据源 */
+    tabData?: TabItem[];
+    /** 顶部固定 */
+    stickyTop?: boolean;
+}
+/** 分页配置接口 */
+export interface PaginationConfig {
+    /** 分页方式 */
+    paginationType?: 'all' | 'scroll' | 'pager' | 'more';
+    /** 默认显示个数 */
+    defaultPageSize?: number;
+    /** 每次加载个数 */
+    pageSize?: number;
+    /** 分页信息 */
+    pagination?: PaginationInfo;
+}
+/** 泛型List组件Props接口 */
+export interface ListProps<TItem extends BaseListItem = BaseListItem> {
+    /** 基础属性 */
+    className?: string;
+    style?: CSSProperties;
+    width?: string | number;
+    height?: string | number;
+    /** 布局配置 */
+    displayStyle?: LayoutConfig['displayStyle'];
+    layoutDirection?: LayoutConfig['layoutDirection'];
+    columns?: LayoutConfig['columns'];
+    rows?: LayoutConfig['rows'];
+    columnGap?: LayoutConfig['columnGap'];
+    rowGap?: LayoutConfig['rowGap'];
+    zoom?: LayoutConfig['zoom'];
+    /** Tab配置 */
+    tabStyle?: TabConfig['tabStyle'];
+    tabGroup?: TabConfig['tabGroup'];
+    tabData?: TabConfig['tabData'];
+    stickyTop?: TabConfig['stickyTop'];
+    /** 分页配置 */
+    paginationType?: PaginationConfig['paginationType'];
+    defaultPageSize?: PaginationConfig['defaultPageSize'];
+    pageSize?: PaginationConfig['pageSize'];
+    pagination?: PaginationConfig['pagination'];
+    /** 数据和渲染 */
+    data?: TItem[];
+    children?: ReactNode;
+    renderItem?: (item: TItem, index: number) => ReactNode;
+    /** 回调函数 */
+    onLoadData?: (params: LoadDataParams) => void;
+    /** 状态配置 */
+    emptyConfig?: EmptyStateConfig;
+    loading?: boolean;
+    renderSearch?: () => ReactNode;
+}
+/** 向后兼容的非泛型版本 */
+export interface LegacyListProps extends ListProps<any> {
+    /** 兼容旧的any[]类型 */
+    data?: any[];
+    renderItem?: (item: any, index: number) => ReactNode;
+}
+export interface TabItem {
+    /** 唯一标识，同时用作anchor模式下的锚点标识 */
+    key: string;
+    /** 显示文本 */
+    label: string;
+    /** 分组值，对应数据项中 tabGroup 指定字段的值 */
+    group?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+}
+export interface LoadMoreParams {
+    /** 当前页码 */
+    currentPage: number;
+    /** 每页数量 */
+    pageSize: number;
+    /** 当前tab */
+    activeTab?: string;
+}
+/** 数据加载触发类型 */
+export declare type LoadDataTrigger = 'tabChange' | 'pagination' | 'pageSize' | 'loadMore' | 'scroll';
+/** 统一的数据加载参数 */
+export interface LoadDataParams {
+    /** 触发类型 */
+    trigger: LoadDataTrigger;
+    /** 当前页码 */
+    currentPage: number;
+    /** 每页数量 */
+    pageSize: number;
+    /** 当前激活的tab */
+    activeTab?: string;
+    /** 上一页页码（分页变化时提供） */
+    previousPage?: number;
+    /** 上一页大小（页大小变化时提供） */
+    previousPageSize?: number;
+}