@pisell/private-materials 6.6.9 → 6.6.10

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

@@ -0,0 +1,177 @@
+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;
+}
+/** 向后兼容的非泛型版本 */
+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;
+}

package/lib/components/list/utils/getText.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 国际化文案获取工具函数
+ * 参考 AmountSummary 组件的实现方式，使用 useEngineContext 获取语言设置
+ *
+ * @example
+ * ```typescript
+ * import { useGetText } from './utils';
+ * import locales from './locales';
+ *
+ * const MyComponent = () => {
+ *   const { getText, getTextFunc } = useGetText(locales);
+ *
+ *   // 获取字符串文案
+ *   const title = getText('component.title', 'Default Title');
+ *
+ *   // 获取函数类型文案
+ *   const formatFunc = getTextFunc('component.format');
+ *   const formattedText = typeof formatFunc === 'function'
+ *     ? formatFunc(arg1, arg2)
+ *     : 'Default Text';
+ *
+ *   return <div>{title}</div>;
+ * };
+ * ```
+ */
+export declare type SupportedLanguage = 'en' | 'zh-CN' | 'zh-HK';
+export interface LocalesObject {
+    [key: string]: {
+        [key: string]: string | ((...args: any[]) => string);
+    };
+}
+export interface GetTextFunctions {
+    getText: (key: string, fallback?: string) => string;
+    getTextFunc: (key: string) => any;
+    getCurrentLanguage: () => string;
+}
+/**
+ * 使用 useEngineContext 创建本地化文案获取函数的 Hook
+ * @param locales - 本地化文案对象
+ * @returns getText 和 getTextFunc 函数
+ */
+export declare const useGetText: (locales: LocalesObject) => GetTextFunctions;
+/**
+ * 创建本地化文案获取函数（非 Hook 版本，保持向后兼容）
+ * @param locales - 本地化文案对象
+ * @returns getText 和 getTextFunc 函数
+ * @deprecated 推荐使用 useGetText Hook 版本
+ */
+export declare const createGetText: (locales: LocalesObject) => GetTextFunctions;
+/**
+ * 默认导出：直接创建一个通用的 getText 函数工厂
+ */
+export default createGetText;

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

@@ -0,0 +1,4 @@
+/**
+ * List 组件工具函数导出
+ */
+export { useGetText, createGetText, default as createGetTextDefault, type SupportedLanguage, type LocalesObject, type GetTextFunctions } from './getText';

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

@@ -1,9 +1,8 @@
-import React from "react";
 import "./index.less";
 export interface LoginProps {
     title: string;
     style: any;
     onLogin: (values: any, callback: (status: any) => void) => void;
 }
-declare const Login: (props: LoginProps) => React.JSX.Element;
+declare const Login: (props: LoginProps) => JSX.Element;
 export default Login;

package/lib/components/pay/toB/components/Cache/index.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import './index.less';
 declare const ToBPayCache: (props: {
     open: boolean;
@@ -7,5 +6,5 @@ declare const ToBPayCache: (props: {
     expect_amount: string;
     onCancel: () => void;
     onOk: (amount: string) => void;
-}) => React.JSX.Element;
+}) => JSX.Element;
 export default ToBPayCache;

package/lib/components/pay/toB/components/Card/index.d.ts

@@ -1,8 +1,7 @@
-import React from 'react';
 import { PayMethod } from '../../types';
 import './index.less';
 declare const ToBPayCard: ({ data, onChange, }: {
     data: PayMethod;
     onChange: (item: PayMethod, type: 'fullPay' | 'pay') => void;
-}) => React.JSX.Element;
+}) => JSX.Element;
 export default ToBPayCard;

package/lib/components/pay/toB/components/CardGroup/index.d.ts

@@ -1,8 +1,7 @@
-import React from 'react';
 import { PayMethod, PayMethodGroup } from '../../types';
 import './index.less';
 declare const ToBPayCardGroup: (props: {
     data: PayMethodGroup;
     onChange: (item: PayMethod, type: 'fullPay' | 'pay') => void;
-}) => React.JSX.Element;
+}) => JSX.Element;
 export default ToBPayCardGroup;

package/lib/components/pay/toB/components/ConfirmedPayment/index.d.ts

@@ -1,7 +1,6 @@
-import React from 'react';
 import { Payment } from '../../types';
 import './index.less';
 declare const ConfirmedPayment: (props: {
     data: Payment[];
-}) => React.JSX.Element;
+}) => JSX.Element;
 export default ConfirmedPayment;

package/lib/components/pay/toB/components/Content/Footer.d.ts

@@ -1,8 +1,7 @@
-import React from 'react';
 declare const ToBPayFooter: (props: {
     loading: boolean;
     submitDisabled: boolean;
     onCancel: () => void;
     onSubmit: () => void;
-}) => React.JSX.Element;
+}) => JSX.Element;
 export default ToBPayFooter;

package/lib/components/pay/toB/components/Content/Header.d.ts

@@ -0,0 +1,4 @@
+declare const ToBPayTitle: (props: {
+    amount: number | string;
+}) => JSX.Element;
+export default ToBPayTitle;

package/lib/components/pay/toB/components/Content/utils.d.ts

@@ -0,0 +1,16 @@
+import { Order, PayMethod, PayMethodCode } from '../../types';
+export declare const isEftposPay: (code: PayMethodCode) => boolean;
+/**
+ * @title: 处理eftpos支付
+ * @description: 处理eftpos支付
+ * @param {any} action 引擎action
+ * @param {any} params 参数
+ * @param {any} successCallback 成功回调
+ */
+export declare const handleEftposPay: (action: any, params: {
+    payMethod: PayMethod;
+    order: Order;
+    symbol: string;
+    network: any;
+    type: string;
+}, successCallback: (res: any) => void) => void;

package/lib/components/pay/toB/components/MX51/index.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const _default: React.ForwardRefExoticComponent<Omit<any, "ref"> & React.RefAttributes<unknown>>;
+export default _default;

package/lib/components/pay/toB/hooks.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @title: 获取引擎utils
+ */
+export declare const useEngineUtils: () => any;
+/**
+ * @title: 获取当前的语言
+ */
+export declare const useEngineLocale: () => any;
+/**
+ * @title: 获取当前的货币符号
+ */
+export declare const useSymbol: () => any;

package/lib/components/pay/toB/locales.d.ts

@@ -0,0 +1,54 @@
+declare const _default: {
+    en: {
+        'tobPay.text.back': string;
+        'tobPay.text.waitPay': string;
+        'tobPay.text.card.edit.amount': string;
+        'tobPay.text.group.normalPay': string;
+        'tobPay.text.group.thirdPay': string;
+        'tobPay.text.cancel': string;
+        'tobPay.text.submit': string;
+        'tobPay.text.confirmed.payment': string;
+        'tobPay.text.cash.modal.amount.toPay': string;
+        'tobPay.text.cash.modal.input.title': string;
+        'tobPay.text.cash.modal.no.change.given': string;
+        'tobPay.text.cash.modal.amount.pay.change': (money: string) => string;
+        'tobPay.text.cash.modal.amount.left.pay.paid': (money: string) => string;
+        'tobPay.text.cash.modal.ok': string;
+        'tobPay.text.payment.with.surcharge': string;
+    };
+    'zh-CN': {
+        'tobPay.text.back': string;
+        'tobPay.text.waitPay': string;
+        'tobPay.text.card.edit.amount': string;
+        'tobPay.text.group.normalPay': string;
+        'tobPay.text.group.thirdPay': string;
+        'tobPay.text.cancel': string;
+        'tobPay.text.submit': string;
+        'tobPay.text.confirmed.payment': string;
+        'tobPay.text.cash.modal.amount.toPay': string;
+        'tobPay.text.cash.modal.input.title': string;
+        'tobPay.text.cash.modal.no.change.given': string;
+        'tobPay.text.cash.modal.amount.pay.change': (money: string) => string;
+        'tobPay.text.cash.modal.amount.left.pay.paid': (money: string) => string;
+        'tobPay.text.cash.modal.ok': string;
+        'tobPay.text.payment.with.surcharge': string;
+    };
+    'zh-HK': {
+        'tobPay.text.back': string;
+        'tobPay.text.waitPay': string;
+        'tobPay.text.card.edit.amount': string;
+        'tobPay.text.group.normalPay': string;
+        'tobPay.text.group.thirdPay': string;
+        'tobPay.text.cancel': string;
+        'tobPay.text.submit': string;
+        'tobPay.text.confirmed.payment': string;
+        'tobPay.text.cash.modal.amount.toPay': string;
+        'tobPay.text.cash.modal.input.title': string;
+        'tobPay.text.cash.modal.no.change.given': string;
+        'tobPay.text.cash.modal.amount.pay.change': (money: string) => string;
+        'tobPay.text.cash.modal.amount.left.pay.paid': (money: string) => string;
+        'tobPay.text.cash.modal.ok': string;
+        'tobPay.text.payment.with.surcharge': string;
+    };
+};
+export default _default;

package/lib/components/pay/toB/store/context.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import { ToBPayContextType } from '../types';
+export declare const ToBPayContext: import("react").Context<ToBPayContextType>;

package/lib/components/pay/toB/store/provider.d.ts

@@ -1,4 +1,4 @@
 import React from 'react';
 export declare const ToBPayProvider: ({ children }: {
     children: React.ReactNode;
-}) => React.JSX.Element;
+}) => JSX.Element;

package/lib/components/pay/toB/store/utils.d.ts

@@ -0,0 +1,13 @@
+import { PayMethod, PayMethodGroup } from '../types';
+/**
+ * 处理支付方式列表
+ * @param payMethodList 支付方式列表
+ * @returns 处理后的支付方式列表
+ */
+export declare const handlePayMethodList: (payMethodList: PayMethod[]) => PayMethodGroup[];
+/**
+ * inputNumber过滤
+ * @param value
+ * @returns string
+ */
+export declare const limitDecimals: (value: any) => any;

package/lib/components/pay/toB/types/index.d.ts

@@ -0,0 +1,60 @@
+export * from './storeTypes';
+export interface ToBPayParams {
+    source?: 'normal' | 'restore';
+    data: {
+        type?: string;
+        payMethod: {
+            id: string;
+            code: string;
+            type: string;
+            name: string;
+        };
+        params: {
+            orderId: string | number;
+            symbol?: string;
+            amount: string;
+            surcharge?: string;
+        };
+        mode: 'pay' | 'refund';
+    };
+    callback: ToBPayCallback;
+}
+export declare type ToBPayCallback = (res: {
+    status: string;
+    data: {
+        amount: number;
+        surPercentRate?: number;
+        surMoney?: number;
+        surcharge?: number;
+        uniquePaymentNumber?: string;
+    };
+    msg?: string;
+}) => void;
+/**
+ * @title: 支付打开参数
+ */
+export interface PayOpenParams extends Omit<ToBPayParams, 'callback'> {
+    payCallback: (res: EftposPayResult | MX51PayResult) => void;
+}
+/**
+ * @title: eftpos支付结果
+ */
+export interface EftposPayResult {
+    status: 'success' | 'fail';
+    params: {
+        amount: number;
+        surPercentRate: number;
+        surMoney: number;
+        uniquePaymentNumber: string;
+    };
+}
+/**
+ * @title: MX51支付结果
+ */
+export interface MX51PayResult {
+    result: boolean;
+    msg?: string;
+    amount: number;
+    surcharge: number;
+    uniquePaymentNumber: string;
+}

package/lib/components/pay/toB/types/storeTypes.d.ts

@@ -0,0 +1,143 @@
+export interface ToBPayContextType {
+    /** 订单 */
+    order: Order;
+    /** 设置订单 */
+    setOrder: (order: Order) => void;
+    /** 订单信息 */
+    orderInfo: OrderInfo;
+    /** 设置订单信息 */
+    setOrderInfo: (orderInfo: OrderInfo) => void;
+    /** 支付方式列表 */
+    payMethodGroupList: PayMethodGroup[];
+    /** 设置支付方式列表 */
+    setPayMethodGroupList: (payMethodGroupList: PayMethodGroup[]) => void;
+    /** 获取支付方式列表 */
+    getPayMethodList: () => Promise<void>;
+}
+/**
+ * OS支付的订单信息
+ */
+export interface Order {
+    /** 订单唯一标识 */
+    uuid: string;
+    /** 订单 id */
+    id: number;
+    /** 订单信息 */
+    order_info: OrderInfo;
+    /** 作废的支付项 */
+    adjust_offline_payments: any[];
+    /** 支付项 */
+    payment: Payment[];
+    /** 支付状态 */
+    payment_status: string;
+    /** 税费 */
+    tax_fee: string;
+    /** 订单总金额 */
+    total_amount: string;
+    /** 待付金额 */
+    expect_amount: string;
+}
+/**
+ * 订单信息
+ */
+export interface OrderInfo {
+    /** 订单 id */
+    order_id: number;
+    /** 订单总金额 */
+    total_amount: string;
+    /** 是否是定金订单 */
+    is_deposit: 0 | 1;
+    /** 定金金额 */
+    deposit_amount: string;
+}
+/**
+ * 支付方式
+ */
+export interface PayMethod {
+    /** 支付方式 id */
+    id: number;
+    /** 店铺 id */
+    shop_id: number;
+    /** 支付方式代码 */
+    code: PayMethodCode;
+    /** 支付方式类型 */
+    type: string;
+    /** 支付方式名称 */
+    name: string;
+    /** 支付方式描述 */
+    description: string;
+    /** 支付方式通道 */
+    channel_application: string[];
+    /** 支付方式状态 */
+    status: 0 | 1;
+    /** 是否是附加费用 */
+    is_surcharge: 0 | 1;
+    /** 是否禁用 */
+    disable: 0 | 1;
+    /** 支付方式公司 */
+    companies: any;
+    /** 支付方式额外数据 */
+    metadata?: {
+        order_rounding_switch: number;
+    };
+    /** 创建时间 */
+    created_at: string;
+    /** 更新时间 */
+    updated_at: string;
+    /** 删除时间 */
+    deleted_at: string | null;
+    /** 固定费用 */
+    fixed: string;
+    /** 百分比费用 */
+    percentage: string;
+}
+export declare enum PayMethodCode {
+    /** 现金支付 */
+    CASHMANUAL = "CASHMANUAL",
+    /** eftpos payo */
+    EFTPOS_PAYO = "EFTPOS_PAYO",
+    /** eftpos windcave */
+    EFTPOS_WINDCAVE = "EFTPOS_WINDCAVE",
+    /** eftpos tyro */
+    EFTPOS_TYRO = "EFTPOS_TYRO",
+    /** eftpos linkly */
+    EFTPOS_LINKLY = "EFTPOS_LINKLY"
+}
+export interface PayMethodGroup {
+    title: string;
+    list: PayMethod[];
+}
+/**
+ * 已经支付的信息
+ */
+export interface Payment {
+    /** 当前支付项的唯一 ID，用于标记支付项的唯一性 */
+    uuid: string;
+    /** 当前支付方式付出去多少钱 */
+    amount: number;
+    /** 支付类型，跟支付列表上对应的支付方式保持一致 */
+    code: PayMethodCode;
+    /** 支付类型id，跟支付列表上对应的支付方式保持一致 */
+    id: number;
+    /** 支付类型id，跟支付列表上对应的支付方式保持一致 */
+    name: string;
+    /** 支付类型type，跟支付列表上对应的支付方式保持一致 */
+    type: string;
+    /** 代金券、充值卡、积分卡 等wallet pass id,通过order/deduction 查出来的，本期都为空 */
+    voucher_id?: string | null;
+    /** 该支付项是否已经同步给后端 */
+    isSynced?: boolean;
+    /** 支付时间 */
+    created_at?: string;
+    /** 支付方式额外数据 */
+    metadata?: {
+        unique_payment_number: string;
+    };
+    /** 手续费 */
+    service_charge?: {
+        /** 手续费百分比 */
+        percentage?: number | string;
+        /** 手续费固定金额 */
+        amount?: number | string;
+    };
+}

package/lib/components/pay/toC/PaymentMethods/MWCreditCard/TDSPay/ThreedsLoading/index.d.ts

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

package/lib/components/pay/toC/PaymentMethods/StripePay/Stripe/Finish/Content.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import './index.less';
+declare type PaymentStatusProps = {
+    onChange: (status: 'succeeded' | 'processing' | 'requires_payment_method' | 'error') => void;
+};
+declare const PaymentStatus: React.FC<PaymentStatusProps>;
+export default PaymentStatus;

package/lib/components/pay/toC/PaymentMethods/StripePay/Stripe/Finish/index.d.ts

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

package/lib/components/pay/toC/PaymentMethods/StripePay/Stripe/StripeSDK/SDK.d.ts

@@ -1,8 +1,7 @@
-import React from 'react';
 declare const StripeSDK: ({ public_key, client_secret, children, lang, }: {
     public_key: string;
     client_secret?: string | undefined;
     children: any;
     lang?: string | undefined;
-}) => React.JSX.Element;
+}) => JSX.Element;
 export default StripeSDK;

package/lib/components/pay/toC/PaymentMethods/StripePay/Stripe/StripeSDK/index.d.ts

@@ -3,5 +3,5 @@ declare const StripeSDK: ({ public_key, client_secret, children, lang, }: {
     client_secret?: string | undefined;
     children: any;
     lang?: string | undefined;
-}) => import("react").JSX.Element;
+}) => JSX.Element;
 export default StripeSDK;

package/lib/components/pay/toC/PaymentMethods/StripePay/Stripe/components/PageLoading/index.d.ts

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