@pisell/private-materials 6.8.84 → 6.8.85

package/es/plus/skuOptionsSelection/utils/index.d.ts

@@ -0,0 +1,7 @@
+export * from './transformBundleGroup';
+export * from './transformOptionGroup';
+export * from './transformVariantGroup';
+export * from './calculateOption';
+export * from './checkSkuStatus';
+export * from './transformValueToSelectorValue';
+export * from './transformSelectorValueToValue';

package/es/plus/skuOptionsSelection/utils/transformBundleGroup.d.ts

@@ -0,0 +1,19 @@
+interface BundleItem {
+    id: string | number;
+    title?: string;
+    name?: string;
+    min_quantity?: number;
+    max_quantity?: number;
+    bundle_item?: Array<{
+        id: string | number;
+        title?: string;
+        cover?: string;
+        price?: number;
+        subtitle?: string;
+        [key: string]: any;
+    }>;
+    required?: 0 | 1;
+    is_enabled?: 0 | 1;
+}
+export declare const transformBundleGroup: (bundleGroup: BundleItem[]) => any[];
+export {};

package/es/plus/skuOptionsSelection/utils/transformOptionGroup.d.ts

@@ -0,0 +1 @@
+export declare const transformOptionGroup: (optionGroup: any[]) => any[];

package/es/plus/skuOptionsSelection/utils/transformSelectorValueToValue.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 将SelectorValue转换为Value
+ */
+export declare const transformSelectorValueToValue: (selectorValue: any) => {};

package/es/plus/skuOptionsSelection/utils/transformValueToSelectorValue.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 将value转换为SelectorGroup需要的格式
+ */
+export declare const transformValueToSelectorValue: (value: any, dataSource: any) => any;

package/es/plus/skuOptionsSelection/utils/transformVariantGroup.d.ts

@@ -0,0 +1 @@
+export declare const transformVariantGroup: (variantGroup: any[]) => any[];

package/es/plus/webPosLogin/WebPosLoginCpt.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { WebPosLoginCptProps } from './types';
+import './WebPosLoginCpt.less';
+/**
+ * WebPosLoginCpt 主组件
+ * @description WebPOS 登录流程组件，包含登录、店铺选择、设备选择三个步骤
+ */
+declare const WebPosLoginCpt: React.FC<WebPosLoginCptProps>;
+export default WebPosLoginCpt;

package/es/plus/webPosLogin/components/BrandPanel/index.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { BrandPanelProps } from '../../types';
+import './index.less';
+/**
+ * BrandPanel 品牌区组件
+ * @description 登录页面左侧品牌展示区域，支持轮播图片/视频（预留），当前仅展示 Logo
+ */
+declare const BrandPanel: React.FC<BrandPanelProps>;
+export default BrandPanel;

package/es/plus/webPosLogin/components/LoginPanel/index.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import './index.less';
+/**
+ * LoginPanel 组件 Props
+ */
+export interface LoginPanelProps {
+    /** 自定义类名 */
+    className?: string;
+    /** 子元素 */
+    children?: React.ReactNode;
+    /** 登录成功回调 */
+    onLoginSuccess?: (data: any) => void;
+    /** 登录配置 */
+    config?: any;
+}
+/**
+ * LoginPanel 登录面板组件
+ * @description 登录表单容器，由用户自行实现具体登录逻辑
+ */
+declare const LoginPanel: React.FC<LoginPanelProps>;
+export default LoginPanel;

package/es/plus/webPosLogin/components/MediaDisplay/type.d.ts

@@ -0,0 +1,54 @@
+/// <reference types="react" />
+/**
+ * 媒体轮播项
+ * @description 媒体展示区的轮播内容配置
+ */
+export interface CarouselItem {
+    /** 内容类型：图片或视频 */
+    type: 'image' | 'video' | 'logo';
+    /** 资源URL */
+    url: string;
+    /** 背景颜色 */
+    backgroundColor?: string;
+    /** logo样式 */
+    logoStyle?: React.CSSProperties;
+}
+/**
+ * 媒体配置
+ * @description 媒体展示区域的配置
+ */
+export interface MediaConfig {
+    /** 轮播内容列表（图片/视频） */
+    carouselItems?: CarouselItem[];
+    /** 默认Logo（当无轮播时显示） */
+    logo?: string;
+    /** 品牌标语 */
+    slogan?: string;
+}
+/**
+ * 视频播放状态
+ */
+export declare type VideoPlayState = 'idle' | 'playing' | 'paused' | 'ended' | 'error';
+/**
+ * MediaDisplay 媒体展示组件 Props
+ */
+export interface MediaDisplayProps {
+    /** 品牌配置 */
+    config?: MediaConfig;
+    /** 自定义类名 */
+    className?: string;
+    /** 是否全屏模式 */
+    fullscreen?: boolean;
+    /** 视频是否静音，默认 true */
+    muted?: boolean;
+    /** 视频是否循环播放，默认 false */
+    loop?: boolean;
+    /** 视频播放结束回调 */
+    onVideoEnded?: () => void;
+    /** 视频播放状态变化回调 */
+    onVideoStateChange?: (state: VideoPlayState) => void;
+    /** 是否可以关闭（用于控制视频结束后是否允许关闭） */
+    canClose?: boolean;
+    /** 关闭回调（视频结束且 canClose 为 true 时触发） */
+    onClose?: () => void;
+}

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

@@ -0,0 +1,12 @@
+/**
+ * WebPosLogin 组件导出
+ * @description WebPOS 登录流程组件
+ */
+export { default } from './WebPosLogin';
+export { default as WebPosLogin } from './WebPosLogin';
+export { default as BrandPanel } from './components/BrandPanel';
+export { default as LoginPanel } from './components/LoginPanel';
+export { default as SelectStore } from './components/SelectStore';
+export { default as SelectDevice } from './components/SelectDevice';
+export { default as UserFooter } from './components/UserFooter';
+export type { WebPosLoginCptProps, StoreItem, DeviceItem, DeviceClient, UserInfo, BrandConfig, CarouselItem, LoginStep, LocaleType, BrandPanelProps, SelectStoreProps, SelectDeviceProps, UserFooterProps, } from './types';

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

@@ -0,0 +1,49 @@
+/**
+ * WebPosLogin 组件国际化文本
+ * @description 支持 en、zh-CN、zh-HK 三种语言
+ */
+declare const _default: {
+    en: {
+        'webpos-login-search': string;
+        'webpos-login-back': string;
+        'webpos-login-last-used': string;
+        'webpos-login-select-store-title': string;
+        'webpos-login-select-store-empty': string;
+        'webpos-login-change-account': string;
+        'webpos-login-store-data-missing': string;
+        'webpos-login-select-device-title': string;
+        'webpos-login-select-device-empty': string;
+        'webpos-login-change-store': string;
+        'webpos-login-device-not-in-use': string;
+        'webpos-login-device-currently-used-by': string;
+    };
+    'zh-CN': {
+        'webpos-login-search': string;
+        'webpos-login-back': string;
+        'webpos-login-last-used': string;
+        'webpos-login-select-store-title': string;
+        'webpos-login-select-store-empty': string;
+        'webpos-login-change-account': string;
+        'webpos-login-store-data-missing': string;
+        'webpos-login-select-device-title': string;
+        'webpos-login-select-device-empty': string;
+        'webpos-login-change-store': string;
+        'webpos-login-device-not-in-use': string;
+        'webpos-login-device-currently-used-by': string;
+    };
+    'zh-HK': {
+        'webpos-login-search': string;
+        'webpos-login-back': string;
+        'webpos-login-last-used': string;
+        'webpos-login-select-store-title': string;
+        'webpos-login-select-store-empty': string;
+        'webpos-login-change-account': string;
+        'webpos-login-store-data-missing': string;
+        'webpos-login-select-device-title': string;
+        'webpos-login-select-device-empty': string;
+        'webpos-login-change-store': string;
+        'webpos-login-device-not-in-use': string;
+        'webpos-login-device-currently-used-by': string;
+    };
+};
+export default _default;

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

@@ -0,0 +1,286 @@
+/**
+ * WebPosLogin 组件类型定义
+ * @description WebPOS 登录流程组件，包含登录、店铺选择、设备选择三个步骤
+ */
+/// <reference types="react" />
+/**
+ * 店铺数据结构
+ * @description 从租户列表接口返回的店铺信息
+ */
+export interface StoreItem {
+    /** 店铺ID */
+    id: number;
+    /** 租户ID */
+    tenant_id: number;
+    /** 账户ID */
+    account_id: number;
+    /** 类型 */
+    type: string;
+    /** 昵称 */
+    nickname: string;
+    /** 状态 */
+    status: string;
+    /** 创建时间 */
+    created_at?: string;
+    /** 更新时间 */
+    updated_at?: string;
+    /** 租户详情 */
+    tenant: {
+        /** 租户ID */
+        id: number;
+        /** 父租户ID */
+        tenant_id?: number;
+        /** 账户ID */
+        account_id?: number;
+        /** 类型 */
+        type?: string;
+        /** 名称（多语言） */
+        name: {
+            en?: string | null;
+            'zh-CN'?: string | null;
+            'zh-HK'?: string | null;
+            original: string;
+        };
+        /** Logo图片 */
+        logo?: string;
+        /** 图标 */
+        icon?: string;
+        /** Favicon */
+        favicon?: string;
+        /** 默认域名 */
+        default_domain: string;
+        /** 私有域名 */
+        private_domain?: string | null;
+        /** 货币代码 */
+        currency_code?: string | null;
+        /** 国家代码 */
+        country_code?: string | null;
+        /** 语言 */
+        locale?: string;
+        /** 时区 */
+        timezone?: string;
+        /** 状态 */
+        status?: string;
+    };
+}
+/**
+ * 设备客户端信息
+ * @description 设备绑定的客户端详情
+ */
+export interface DeviceClient {
+    /** 客户端ID */
+    id: number;
+    /** 店铺ID */
+    shop_id: number;
+    /** 设备ID */
+    device_id: number;
+    /** 客户端编号 */
+    number: string;
+    /** 客户端名称 */
+    name: string;
+    /** 客户端类型 */
+    type: string;
+    /** 设备型号 */
+    model?: string;
+    /** 系统版本 */
+    version?: string;
+    /** 设备详细数据 */
+    data?: {
+        battery?: {
+            is_charging?: boolean;
+            visible_percent?: string;
+        };
+        hardware?: {
+            country?: string;
+            datetime?: string;
+            language?: string;
+            timezone?: string;
+        };
+        application?: {
+            name?: string;
+            type?: string;
+            version?: string;
+            language?: string;
+            bundle_id?: string;
+        };
+        connectivity?: {
+            ip?: string;
+            type?: string;
+            wifi_details?: any[];
+        };
+    };
+    /** 最后刷新时间 */
+    refreshed_at?: string;
+    /** 创建时间 */
+    created_at?: string;
+    /** 更新时间 */
+    updated_at?: string;
+}
+/**
+ * 设备数据结构
+ * @description 从设备列表接口返回的设备信息
+ */
+export interface DeviceItem {
+    /** 设备ID */
+    id: number;
+    /** 店铺ID */
+    shop_id: number;
+    /** 设备类型 */
+    type: string;
+    /** 设备编号 */
+    number: string;
+    /** 设备名称 */
+    name: string;
+    /** 设备描述 */
+    description?: string;
+    /** 设备设置 */
+    setting?: any[];
+    /** 创建时间 */
+    created_at?: string;
+    /** 更新时间 */
+    updated_at?: string;
+    /** 绑定的客户端信息（null 表示未被使用） */
+    client?: DeviceClient | null;
+}
+/**
+ * 用户信息
+ * @description 当前登录用户的基本信息
+ */
+export interface UserInfo {
+    /** 用户名称 */
+    name: string;
+    /** 用户头像 */
+    avatar?: string;
+}
+/**
+ * 品牌区轮播项
+ * @description 左侧品牌区的轮播内容配置
+ */
+export interface CarouselItem {
+    /** 内容类型：图片或视频 */
+    type: 'image' | 'video';
+    /** 资源URL */
+    url: string;
+}
+/**
+ * 品牌区配置
+ * @description 左侧品牌展示区域的配置
+ */
+export interface BrandConfig {
+    /** 轮播内容列表（图片/视频） */
+    carouselItems?: CarouselItem[];
+    /** 默认Logo（当无轮播时显示） */
+    logo?: string;
+    /** 品牌标语 */
+    slogan?: string;
+}
+/**
+ * 登录流程步骤
+ */
+export declare type LoginStep = 'login' | 'store' | 'device';
+/**
+ * 支持的语言类型
+ */
+export declare type LocaleType = 'en' | 'zh-CN' | 'zh-HK';
+/**
+ * WebPosLogin 主组件 Props
+ * @description WebPOS 登录组件的所有配置项
+ */
+export interface WebPosLoginCptProps {
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 背景图片URL */
+    backgroundImage?: string;
+    /** 品牌区配置 */
+    brandConfig?: BrandConfig;
+    /** 当前步骤：login-登录 | store-店铺选择 | device-设备选择 */
+    step?: LoginStep;
+    /** 是否显示返回按钮（默认 true） */
+    showBackButton?: boolean;
+    /** 店铺列表数据 */
+    storeList?: StoreItem[];
+    /** 设备列表数据 */
+    deviceList?: DeviceItem[];
+    /** 当前用户信息 */
+    userInfo?: UserInfo;
+    /** 当前选中的店铺 */
+    selectedStore?: StoreItem;
+    /** 上次使用的店铺ID（用于显示 Last used 标签） */
+    lastUsedStoreId?: number;
+    /** 上次使用的设备ID（用于显示 Last used 标签） */
+    lastUsedDeviceId?: number;
+    /** 语言设置 */
+    locale?: LocaleType;
+    /** 加载状态 */
+    loading?: boolean;
+    /** 登录配置 */
+    loginConfig?: any;
+    /** 店铺选择回调 */
+    onStoreSelect?: (store: StoreItem) => void;
+    /** 设备选择回调 */
+    onDeviceSelect?: (device: DeviceItem) => void;
+    /** 切换账号回调 */
+    onChangeAccount?: () => void;
+    /** 切换店铺回调 */
+    onChangeStore?: () => void;
+    /** 返回上一步回调 */
+    onBack?: () => void;
+    /** 登录成功回调 */
+    onLoginSuccess?: (data: any) => void;
+}
+/**
+ * BrandPanel 品牌区组件 Props
+ */
+export interface BrandPanelProps {
+    /** 品牌配置 */
+    config?: BrandConfig;
+    /** 自定义类名 */
+    className?: string;
+}
+/**
+ * SelectStore 店铺选择组件 Props
+ */
+export interface SelectStoreProps {
+    /** 店铺列表 */
+    storeList?: StoreItem[];
+    /** 语言 */
+    locale?: LocaleType;
+    /** 加载状态 */
+    loading?: boolean;
+    /** 上次使用的店铺ID */
+    lastUsedStoreId?: number;
+    /** 选择店铺回调 */
+    onSelect?: (store: StoreItem) => void;
+}
+/**
+ * SelectDevice 设备选择组件 Props
+ */
+export interface SelectDeviceProps {
+    /** 设备列表 */
+    deviceList?: DeviceItem[];
+    /** 语言 */
+    locale?: LocaleType;
+    /** 加载状态 */
+    loading?: boolean;
+    /** 选择设备回调 */
+    onSelect?: (device: DeviceItem) => void;
+}
+/**
+ * UserFooter 底部用户信息组件 Props
+ */
+export interface UserFooterProps {
+    /** 用户信息 */
+    userInfo?: UserInfo;
+    /** 当前选中的店铺 */
+    selectedStore?: StoreItem;
+    /** 当前步骤 */
+    step?: LoginStep;
+    /** 语言 */
+    locale?: LocaleType;
+    /** 切换账号回调 */
+    onChangeAccount?: () => void;
+    /** 切换店铺回调 */
+    onChangeStore?: () => void;
+}

package/es/pro/Cards/index.d.ts

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

package/es/pro/Selector/BatchSelectorDemo.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+export declare const BatchSelectorDemo: React.FC;
+export default BatchSelectorDemo;

package/es/pro/Selector/Item.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import { OptionItem } from './types';
+export interface IItemProps {
+    actions: any;
+    dataSource: OptionItem;
+    indicator: React.ReactNode;
+    numberSelector: React.ReactNode;
+    optionItemValue?: any;
+    quantityInfo: any;
+    values: any;
+    children?: React.ReactNode;
+}
+declare const Item: (props: IItemProps) => JSX.Element;
+export default Item;

package/es/pro/Selector/Selector.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import { ItemLayout, ItemProps, PresetConfig, SelectorProps, SelectorVariant } from './types';
+import './selector.less';
+export declare const SelectorContext: React.Context<{
+    disabled?: boolean | undefined;
+    mode?: "multiple" | "single" | undefined;
+    itemLayout?: ItemLayout | undefined;
+    valueType?: "object" | "primitive" | undefined;
+    variant?: SelectorVariant | undefined;
+    itemProps?: ItemProps | undefined;
+    preset?: PresetConfig | undefined;
+}>;
+declare const Selector: React.ForwardRefExoticComponent<SelectorProps<import("./types").OptionKey> & React.RefAttributes<unknown>>;
+export default Selector;

package/es/pro/Selector/Selector.stories.d.ts

@@ -0,0 +1,78 @@
+import { Meta, StoryObj } from '@storybook/react';
+import Selector from './index';
+/**
+ * Selector 组件 - 高级选择器
+ *
+ * 支持单选/多选、数量控制、校验规则、互斥组等功能
+ *
+ * 查看文档：
+ * - [开发文档](https://studio.picoding-dev.com/pro-components/selector?tab=dev)
+ * - [需求文档](https://m1ed09stz4r.feishu.cn/wiki/NL5AwOs0ei5ZBekT4i6cuzIOnoM)
+ */
+declare const meta: Meta<typeof Selector>;
+export default meta;
+declare type Story = StoryObj<typeof Selector>;
+/**
+ * 默认单选模式 - 原始值类型
+ */
+export declare const Default: Story;
+/**
+ * 多选模式 - 原始值数组
+ */
+export declare const Multiple: Story;
+/**
+ * 单选 + 数量 - 对象值类型
+ */
+export declare const SingleWithQuantity: Story;
+/**
+ * 多选 + 数量 - 卡片样式
+ */
+export declare const MultipleWithQuantity: Story;
+/**
+ * 网格布局 - 2列
+ */
+export declare const GridLayout2Columns: Story;
+/**
+ * 网格布局 - 3列
+ */
+export declare const GridLayout3Columns: Story;
+/**
+ * 校验规则 - 必选、最小/最大数量
+ */
+export declare const WithValidation: Story;
+/**
+ * 互斥组 - 同组只能选一个
+ */
+export declare const MutexGroups: Story;
+/**
+ * 禁用状态
+ */
+export declare const Disabled: Story;
+/**
+ * Select 变体 - 下拉选择
+ */
+export declare const SelectVariant: Story;
+/**
+ * Select 变体 - 多选下拉
+ */
+export declare const SelectVariantMultiple: Story;
+/**
+ * 卡片样式变体 - 不同选中态
+ */
+export declare const CardVariants: Story;
+/**
+ * 自定义图标
+ */
+export declare const CustomIcon: Story;
+/**
+ * 自定义渲染
+ */
+export declare const CustomRender: Story;
+/**
+ * SelectorGroup 基础示例
+ */
+export declare const SelectorGroupBasic: StoryObj;
+/**
+ * SelectorGroup 联动规则示例
+ */
+export declare const SelectorGroupWithLinkage: StoryObj;

package/es/pro/Selector/SelectorGroup.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { SelectionValue, SelectorGroupProps } from './types';
+import './selectorGroup.less';
+export declare type SelectorGroupRef = {
+    getValues: (includeHidden?: boolean) => Record<string, SelectionValue>;
+    setValues: (values: Record<string, SelectionValue>) => void;
+    validate: () => Promise<Record<string, never>>;
+    reset: () => void;
+};
+declare const SelectorGroup: React.ForwardRefExoticComponent<Omit<SelectorGroupProps, "ref"> & React.RefAttributes<SelectorGroupRef>>;
+export default SelectorGroup;

package/es/pro/Selector/components/Card/index.d.ts

@@ -0,0 +1,57 @@
+import React from 'react';
+import './index.less';
+export declare type CardVariant = 'outlined' | 'borderless';
+export declare type CardLayout = 'vertical' | 'horizontal';
+export declare type SelectedType = 'none' | 'outlined' | 'outlined-bold' | 'filled';
+export declare type ActionsPosition = 'left' | 'right';
+export interface CardStyles {
+    container?: React.CSSProperties | ((props: CardStyleProps) => React.CSSProperties);
+    content?: React.CSSProperties | ((props: CardStyleProps) => React.CSSProperties);
+    actions?: React.CSSProperties | ((props: CardStyleProps) => React.CSSProperties);
+    corner?: React.CSSProperties | ((props: CardStyleProps) => React.CSSProperties);
+}
+export interface CardStyleProps {
+    selected?: boolean;
+    disabled?: boolean;
+    hoverable?: boolean;
+    variant?: CardVariant;
+    layout?: CardLayout;
+}
+export interface CardProps {
+    /** 卡片变体样式 */
+    variant?: CardVariant;
+    /** 布局方向 */
+    layout?: CardLayout;
+    /** 操作按钮区域，水平模式在右侧，垂直模式在底部 */
+    actions?: React.ReactNode[];
+    /** 水平模式下，操作按钮的位置 */
+    actionsPosition?: ActionsPosition;
+    /** 垂直模式下，右上角绝对定位展示的组件 */
+    corner?: React.ReactNode;
+    /** 子内容 */
+    children?: React.ReactNode;
+    /** 选中状态 */
+    selected?: boolean;
+    /** 禁用状态 */
+    disabled?: boolean;
+    /** 是否可悬停 */
+    hoverable?: boolean;
+    /** 点击事件 */
+    onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;
+    /** 自定义样式 */
+    styles?: CardStyles;
+    /**
+     * 选中时的样式类型
+     * - none: 无样式
+     * - outlined: 边框高亮
+     * - outlined-bold: 边框高亮 + 加粗（使用 outline 实现，不影响布局）
+     * - filled: 填充背景色
+     */
+    selectedType?: SelectedType;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+}
+declare const Card: React.FC<CardProps>;
+export default Card;

package/es/pro/Selector/components/Card/types.d.ts

@@ -0,0 +1 @@
+export type { CardVariant, CardLayout, SelectedType, ActionsPosition, CardStyles, CardStyleProps, CardProps, } from './index';