@pisell/materials 1.8.20 → 1.8.21

package/es/components/dataSourceComponents/provider/dataSource/DataSourceContext.d.ts

@@ -0,0 +1,120 @@
+/// <reference types="react" />
+import { Result } from 'ahooks/es/useRequest/src/types';
+import { ActionsItem } from '../../dataSourceForm/serve';
+export interface Field {
+    name: string;
+    type: string;
+    allowNull: boolean;
+    primaryKey: boolean;
+    unique: boolean;
+    autoIncrement: boolean;
+    description?: (null | string)[];
+    possibleTypes?: string[];
+    rawType: string;
+    interface: string;
+    uiSchema: UiSchema;
+    key?: string;
+    collectionName?: string;
+    collectionKey?: any;
+    dataSourceKey?: string;
+    defaultValue?: any;
+}
+interface UiSchema {
+    type?: string;
+    'x-component': string;
+    'x-component-props'?: Xcomponentprops;
+    'x-validator'?: string;
+    title: string;
+    default?: any;
+    enum?: any[];
+}
+interface Xcomponentprops {
+    style?: Style;
+    autoSize?: AutoSize;
+    stringMode?: boolean;
+    step?: string;
+    dateFormat?: string;
+    showTime?: boolean;
+}
+interface AutoSize {
+    minRows: number;
+}
+interface Style {
+    width: string;
+}
+export declare type ActionTypes = 'list' | 'get' | 'update' | 'create' | 'destroy';
+export declare type DataSourceType = {
+    fromSettingMeta: boolean;
+    actions: {
+        get: ActionsItem;
+        update: ActionsItem;
+        create: ActionsItem;
+        delete: ActionsItem;
+        list: ActionsItem;
+    };
+    headerDataSource: string;
+    dataSourceKey: string;
+    filterTargetKey: string;
+    introspected: boolean;
+    isCustomApi: boolean;
+    key: string;
+    tableName: string;
+    logging: boolean;
+    name: string;
+    title: string;
+    titleField: string;
+    types: ActionTypes[];
+    fields: Field[];
+    options: {
+        apiType: string;
+        baseUrl: string;
+    };
+};
+export declare type DataSourceContextProps = {
+    dataSource: DataSourceType;
+    children?: React.ReactNode;
+    currentValue?: string;
+    actions?: {
+        list?: () => Promise<any>;
+        get?: () => Promise<any>;
+        update?: () => Promise<any>;
+        create?: () => Promise<any>;
+        destroy?: () => Promise<any>;
+    };
+    requestOptions?: {
+        list?: any;
+        get?: any;
+        update?: any;
+        create?: any;
+        destroy?: any;
+    };
+    overrideData?: {
+        list?: any;
+        get?: any;
+    };
+    autoRun?: {
+        list?: boolean;
+        get?: boolean;
+    };
+    extraParams?: {
+        list?: Record<string, any>;
+        get?: Record<string, any>;
+        update?: Record<string, any>;
+        create?: Record<string, any>;
+        destroy?: Record<string, any>;
+    };
+    __id?: string;
+    __designMode?: string;
+};
+export interface DataSourceContextType {
+    dataSource?: DataSourceType;
+    list: Result<any, any>;
+    destroy: Result<any, any>;
+    get: Result<any, any>;
+    update: Result<any, any>;
+    create: Result<any, any>;
+    __designMode?: string;
+    getCurrentRecord: () => any;
+}
+export declare const DataSourceContext: import("react").Context<DataSourceContextType>;
+export default DataSourceContext;

package/es/components/dataSourceComponents/provider/variables/VariablesContext.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="react" />
+export interface VariablesContextType {
+    children?: React.ReactNode;
+    variables?: Record<string, any>;
+    registerVariable?: (value: Record<string, any>) => void;
+    parseVariable?: (str: string, localVariables?: Record<string, any>) => any;
+    registerValueVariable?: (componentId: string, value: Record<string, any>) => void;
+    registerFunctionVariable?: (componentId: string, value: Record<string, any>) => void;
+    subscribeVariables?: (listener: (allVariables: Record<string, any>, updateVariables: Record<string, any>) => void) => () => void;
+    config?: {
+        disabledHistoryListener?: boolean;
+    };
+}
+export declare const VariablesContext: import("react").Context<VariablesContextType>;
+export default VariablesContext;

package/es/components/date-picker/datePickerCpt.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { PickerDateProps } from 'antd/es/date-picker/generatePicker';
 import { Dayjs } from 'dayjs';
 import './index.less';

package/es/components/drag-sort-tree/TreeItem/index.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="react" />
+import './index.less';
+import { ValueProps, SortType } from '../types';
+declare type IdType = string | number;
+declare type TreeItemProps = {
+    id: string | number;
+    key: string | number;
+    item: ValueProps | any;
+    depth: number;
+    lists: any[];
+    childrenProps?: SortType;
+    sensors?: any;
+    expandedKeys?: IdType[];
+    setExpandedKeys?: any;
+    onSelectKeys?: (ids: IdType) => void;
+    onChange?: (value: any[]) => void;
+};
+declare const TreeItem: (props: TreeItemProps) => JSX.Element;
+export default TreeItem;

package/es/components/drag-sort-tree/index.d.ts

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

package/es/components/filter/components/FilterItem/AsyncOptionsSelectWrapper.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 筛选项中 singleSelect/multipleSelect 的异步 options 包装器。
+ * 当列配置传入 getOptions（同步或异步）时，先解析再渲染 PisellSingleSelect/PisellMultipleSelect。
+ */
+import React from 'react';
+export declare type GetOptionsFn = (() => {
+    label: string;
+    value: any;
+}[]) | (() => Promise<{
+    label: string;
+    value: any;
+}[]>);
+export interface AsyncOptionsSelectWrapperProps {
+    getOptions: GetOptionsFn;
+    fieldType: 'singleSelect' | 'multipleSelect';
+    value?: any;
+    onChange?: (value: any, option?: any) => void;
+    [key: string]: any;
+}
+declare const AsyncOptionsSelectWrapper: React.FC<AsyncOptionsSelectWrapperProps>;
+export default AsyncOptionsSelectWrapper;

package/es/components/iconfont/index.d.ts

@@ -0,0 +1,8 @@
+import { IconComponentProps } from '@ant-design/icons/es/components/Icon';
+import React from 'react';
+interface IconFontProps extends IconComponentProps {
+    type: string;
+    onClick?: React.MouseEventHandler<HTMLSpanElement>;
+}
+declare const IconFont: React.FC<IconFontProps>;
+export default IconFont;

package/es/components/keyboard/index.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import './index.less';
+export declare type ItemValue = string | number;
+export interface Item {
+    value: ItemValue;
+    label: React.ReactNode;
+    disabled: boolean;
+    type: 'text' | 'primary';
+    style?: React.CSSProperties;
+    size?: number;
+}
+export interface KeyboardProps {
+    id?: string;
+    className?: string;
+    style?: React.CSSProperties;
+    onChange?: (value?: ItemValue) => void;
+    items?: Item[];
+    rightItems?: Item[];
+    keydown?: boolean;
+}
+declare const _default: React.MemoExoticComponent<(props: KeyboardProps) => JSX.Element>;
+export default _default;

package/es/components/lowCodePage/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 declare type LowCodePageProps = {
     id: number;
 };

package/es/components/page/index.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+import { ConfigProviderProps } from '../config-provider';
+interface PageProps extends ConfigProviderProps {
+    variablesConfig?: {
+        disabledHistoryListener?: boolean;
+    };
+}
+declare const Page: (props: PageProps) => JSX.Element;
+export default Page;

package/es/components/pisell-config-provider/context.d.ts

@@ -0,0 +1,22 @@
+/// <reference types="react" />
+export interface PisellContextType {
+    platform: 'h5' | 'pc' | 'ipad';
+    /** 货币符号 */
+    symbol?: string;
+    /** 当前语言环境 */
+    locale?: string;
+    /** 获取货币符号 */
+    getSymbolic?: () => string;
+}
+export declare const PisellContext: import("react").Context<PisellContextType>;
+/**
+ * provider外获取当前全局配置
+ */
+declare class GlobalConfig {
+    private config;
+    constructor();
+    setConfig(config: PisellContextType): void;
+    getConfig(): PisellContextType;
+}
+export declare const globalConfig: GlobalConfig;
+export default PisellContext;

package/es/components/pisell-config-provider/index.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { PisellContextType } from './context';
+interface PisellConfigProviderType {
+    platform?: PisellContextType['platform'];
+    children: React.ReactNode;
+    /** 货币符号 */
+    symbol?: string;
+    /** 当前语言环境 */
+    locale?: string;
+    getSymbolic?: () => string;
+}
+declare const PisellConfigProvider: React.FC<PisellConfigProviderType>;
+export default PisellConfigProvider;

package/es/components/pisellAdjustPrice/index.d.ts

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

package/es/components/pisellAdjustPrice/status.d.ts

@@ -0,0 +1,32 @@
+export declare const defaultConfig: {
+    dark: {
+        backgroundColor: string;
+        containerBackgroundColor: string;
+        buttonBackgroundColor: string;
+        textColor: string;
+        resetButtonBackgroundColor: string;
+        resetButtonTextColor: string;
+        isDoneButtonFollowTheme: boolean;
+        doneButtonBackgroundColor: string;
+        doneButtonTextColor: string;
+        isShowMainText: boolean;
+        mainTextColor: string;
+        isShowSubText: boolean;
+        subTextColor: string;
+    };
+    light: {
+        backgroundColor: string;
+        containerBackgroundColor: string;
+        buttonBackgroundColor: string;
+        textColor: string;
+        resetButtonBackgroundColor: string;
+        resetButtonTextColor: string;
+        isDoneButtonFollowTheme: boolean;
+        doneButtonBackgroundColor: string;
+        doneButtonTextColor: string;
+        isShowMainText: boolean;
+        mainTextColor: string;
+        isShowSubText: boolean;
+        subTextColor: string;
+    };
+};

package/es/components/pisellAdjustPrice/type.d.ts

@@ -0,0 +1,22 @@
+export interface PisellAdjustPriceProps {
+    value?: number;
+    originValue: number;
+    defaultValue?: number;
+    onChange?: (val: number) => void;
+    selectType?: 'light' | 'dark';
+    backgroundColor?: string;
+    containerBackgroundColor?: string;
+    buttonBackgroundColor?: string;
+    textColor?: string;
+    resetButtonBackgroundColor?: string;
+    resetButtonTextColor?: string;
+    isDoneButtonFollowTheme?: boolean;
+    doneButtonBackgroundColor?: string;
+    doneButtonTextColor?: string;
+    isShowMainText?: boolean;
+    mainTextColor?: string;
+    isShowSubText?: boolean;
+    subTextColor?: string;
+    resetText?: string;
+    doneText?: string;
+}

package/es/components/pisellBatchActionBar/types.d.ts

@@ -0,0 +1,237 @@
+import type { CSSProperties, ReactNode } from 'react';
+/**
+ * 布局模式
+ */
+export declare type BatchActionBarPosition = 'sticky-top' | 'sticky-bottom' | 'float' | 'inline';
+/**
+ * 确认弹窗配置
+ */
+export interface BatchActionConfirmConfig {
+    /**
+     * 弹窗标题
+     */
+    title?: string;
+    /**
+     * 弹窗描述内容
+     */
+    description?: string;
+    /**
+     * 确认按钮文案
+     */
+    okText?: string;
+    /**
+     * 取消按钮文案
+     */
+    cancelText?: string;
+}
+/**
+ * 默认操作按钮配置
+ * @description 固定四个基础操作按钮：全选、反选、取消选择、删除
+ */
+export interface DefaultActionsConfig {
+    /**
+     * 是否显示默认操作按钮（全选、反选、取消选择、删除）
+     * @default true
+     */
+    showDefaultActions?: boolean;
+    /**
+     * 是否显示全选按钮
+     * @default true
+     */
+    showSelectAll?: boolean;
+    /**
+     * 是否显示反选按钮
+     * @default true
+     */
+    showInvert?: boolean;
+    /**
+     * 是否显示取消选择按钮
+     * @default true
+     */
+    showClear?: boolean;
+    /**
+     * 是否显示删除按钮
+     * @default true
+     */
+    showDelete?: boolean;
+}
+/**
+ * 自定义操作按钮配置
+ */
+export interface BatchActionItem {
+    /**
+     * 操作唯一标识
+     */
+    key: string;
+    /**
+     * 按钮文案
+     */
+    label: ReactNode;
+    /**
+     * 按钮图标
+     */
+    icon?: ReactNode;
+    /**
+     * 按钮尺寸
+     * @description 对应 GraphicTextCard 的 size 属性
+     * @default 'small'
+     */
+    size?: 'small' | 'default' | 'large';
+    /**
+     * 是否禁用
+     * @description 支持函数形式，基于 selection 动态判断
+     */
+    disabled?: boolean | ((selectedKeys: React.Key[], selectedRows?: any[]) => boolean);
+    /**
+     * 是否显示
+     * @description 支持函数形式，基于 selection 动态判断
+     * @default true
+     */
+    visible?: boolean | ((selectedKeys: React.Key[], selectedRows?: any[]) => boolean);
+    /**
+     * 是否显示 loading 状态
+     */
+    loading?: boolean;
+    /**
+     * 是否需要确认弹窗
+     * @default false
+     */
+    confirm?: boolean | BatchActionConfirmConfig;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 按钮组标识
+     * @description 相同 group 的按钮会分组展示
+     */
+    group?: string;
+    /**
+     * 按钮点击回调
+     * @description 如果配置了此回调，会优先使用此回调，否则使用组件级别的 onActionClick
+     */
+    onClick?: (selectedKeys: React.Key[], selectedRows?: any[]) => void | Promise<void>;
+}
+/**
+ * PisellBatchActionBar 组件 Props
+ * @description 批量操作栏组件，用于承载基于选中对象的批量行为操作
+ */
+export interface PisellBatchActionBarProps {
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * 选中的 key 数组
+     * @description 必填，用于感知选择状态
+     */
+    selectedKeys: React.Key[];
+    /**
+     * 选中的行数据数组
+     * @description 可选，用于传递给操作回调
+     */
+    selectedRows?: any[];
+    /**
+     * 总数据量
+     * @description 用于判断全选状态
+     */
+    total?: number;
+    /**
+     * 当前页数据量
+     * @description 用于判断全选当前页状态
+     */
+    currentPageTotal?: number;
+    /**
+     * 当前页数据 key 数组
+     * @description 用于判断全选当前页状态
+     */
+    currentPageKeys?: React.Key[];
+    /**
+     * 布局模式
+     * @default 'float'
+     */
+    position?: BatchActionBarPosition;
+    /**
+     * 吸顶/吸底时的偏移量
+     * @default 0
+     */
+    offset?: number;
+    /**
+     * 是否显示选中数量提示
+     * @default true
+     */
+    showSelectedCount?: boolean;
+    /**
+     * 选中数量提示文案
+     * @description 支持字符串模板（使用 {count} 占位符）或函数形式，默认使用国际化文本
+     * @default getText('batch-action-bar-selected-count', count)
+     */
+    selectedCountText?: string | ((count: number) => string);
+    /**
+     * 默认操作按钮配置
+     * @description 只包含前三个基础选择操作按钮，其他操作按钮通过 actions 传入
+     */
+    defaultActions?: DefaultActionsConfig;
+    /**
+     * 自定义操作按钮配置
+     */
+    actions?: BatchActionItem[];
+    /**
+     * 操作按钮排序
+     * @description 通过 key 数组控制按钮顺序
+     */
+    actionOrder?: string[];
+    /**
+     * 是否启用溢出折叠
+     * @default true
+     */
+    enableOverflow?: boolean;
+    /**
+     * 溢出折叠阈值（按钮数量）
+     * @default 5
+     */
+    overflowThreshold?: number;
+    /**
+     * "更多"按钮文案
+     * @description 默认使用国际化文本
+     * @default getText('batch-action-bar-more')
+     */
+    moreText?: string;
+    /**
+     * 全选回调
+     */
+    onSelectAll?: () => void;
+    /**
+     * 反选回调
+     * @description 反选操作，将当前选中的变为未选中，未选中的变为选中
+     */
+    onInvert?: () => void;
+    /**
+     * 清空选择回调
+     */
+    onClear?: () => void;
+    /**
+     * 删除回调
+     * @description 删除选中项，点击后会先弹出确认弹窗
+     */
+    onDelete?: (selectedKeys: React.Key[], selectedRows?: any[]) => void;
+    /**
+     * 删除确认弹窗配置
+     * @description 自定义删除确认弹窗的标题和内容
+     */
+    deleteConfirmConfig?: BatchActionConfirmConfig;
+    /**
+     * 自定义操作按钮点击回调
+     * @description 当 actions 中的按钮被点击时触发，通过 action.key 区分不同的操作
+     * @description 如果 action 中配置了 onClick，则优先使用 action.onClick
+     */
+    onActionClick?: (key: string, selectedKeys: React.Key[], selectedRows?: any[]) => void | Promise<void>;
+}

package/es/components/pisellCheckboxGroup/index.d.ts

@@ -0,0 +1,40 @@
+import React from 'react';
+import { PisellContextType } from '../pisell-config-provider/context';
+import './index.less';
+export interface PisellCheckboxGroupOption {
+    label: string;
+    value: string;
+    disabled?: boolean;
+    error?: boolean;
+    [key: string]: any;
+}
+declare type PisellCheckboxGroupValue = string | string[] | any;
+export interface PisellCheckboxGroupProps extends React.HTMLAttributes<HTMLDivElement> {
+    platform?: PisellContextType['platform'];
+    direction?: 'horizontal' | 'vertical';
+    fullWidth?: boolean;
+    gap?: number;
+    padding?: number;
+    options: PisellCheckboxGroupOption[];
+    onChange?: (value: PisellCheckboxGroupValue, item: PisellCheckboxGroupOption) => void;
+    value?: PisellCheckboxGroupValue;
+    renderOption?: (option: PisellCheckboxGroupOption, active: boolean, index: number) => React.ReactNode;
+    rowKey?: string;
+    mode?: 'multiple' | 'single';
+    iconPosition?: 'left' | 'right' | 'hide';
+    optionClassName?: string;
+    optionActiveClassName?: string;
+    onChangeDebounce?: boolean;
+    onItemClick?: (e: React.MouseEvent<HTMLDivElement>, option: PisellCheckboxGroupOption) => void;
+    showActiveBackground?: boolean;
+}
+/**
+ * @title: PisellCheckboxGroup
+ * @description: 选中组件
+ * @param {PisellCheckboxGroupProps} props
+ * @return {*}
+ * @Author: zhiwei.Wang
+ * @Date: 2024-08-16 10:34
+ */
+declare const PisellCheckboxGroup: (props: PisellCheckboxGroupProps) => JSX.Element;
+export default PisellCheckboxGroup;

package/es/components/pisellCurrency/PisellCurrency.stories.d.ts

@@ -0,0 +1,56 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellCurrency } from './PisellCurrency';
+/**
+ * PisellCurrency 组件 Storybook
+ */
+declare const meta: Meta<typeof PisellCurrency>;
+export default meta;
+declare type Story = StoryObj<typeof PisellCurrency>;
+/**
+ * 基础示例 - 人民币
+ */
+export declare const Basic: Story;
+/**
+ * 不同货币
+ */
+export declare const DifferentCurrencies: Story;
+/**
+ * 只读态展示
+ */
+export declare const ReadOnly: Story;
+/**
+ * 禁用态
+ */
+export declare const Disabled: Story;
+/**
+ * 不显示货币符号
+ */
+export declare const WithoutSymbol: Story;
+/**
+ * 禁止负数（商品价格）
+ */
+export declare const NoNegative: Story;
+/**
+ * 允许负数（退款金额）
+ */
+export declare const AllowNegative: Story;
+/**
+ * 表单场景
+ */
+export declare const InForm: Story;
+/**
+ * 表格场景
+ */
+export declare const InTable: Story;
+/**
+ * 不同精度
+ */
+export declare const DifferentPrecision: Story;
+/**
+ * 只读态样式
+ */
+export declare const ReadOnlyStyles: Story;
+/**
+ * 空值处理
+ */
+export declare const EmptyValue: Story;

package/es/components/pisellCurrency/components/DisabledView.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { PisellCurrencyProps } from '../types';
+/**
+ * PisellCurrency 禁用态视图组件
+ *
+ * 负责渲染禁用态的输入框
+ *
+ * @param props 组件 Props
+ */
+declare const DisabledView: React.FC<PisellCurrencyProps>;
+export default DisabledView;