@pisell/materials 6.11.108 → 6.11.109

package/lib/components/PisellTabbar/hooks/useActiveKey.d.ts

@@ -0,0 +1,55 @@
+/**
+ * useActiveKey Hook 参数
+ */
+interface UseActiveKeyProps {
+    /** 初始激活的 key 数组（对应多层级） */
+    initialActiveKey?: (string | number)[];
+    /** key 变化回调 */
+    onChange?: (value: (string | number)[]) => void;
+}
+/**
+ * useActiveKey Hook 返回值
+ */
+interface UseActiveKeyReturn {
+    /** 当前激活的 key 数组 */
+    activeKey: (string | number)[];
+    /** 设置指定层级的激活 key */
+    setActiveKey: (level: number, key: string | number, cKey?: string | number) => void;
+    /** 获取指定层级的激活 key */
+    getActiveKey: (level: number) => string | number;
+    /** 内部设置方法（用于同步外部值） */
+    _setActiveKey: (value: (string | number)[]) => void;
+    /** 设置缓存key */
+    setCacheActiveKey: (val: (string | number)[]) => void;
+    /** 重置value为缓存key */
+    resetActiveKey: () => void;
+    /** 获取缓存key */
+    getCacheActiveKey: () => (string | number)[];
+}
+/**
+ * Tabbar 激活状态管理 Hook
+ *
+ * 用于管理多层级 Tabbar 的激活状态，支持级联选择
+ *
+ * @param props - Hook 配置参数
+ * @returns 激活状态和操作方法
+ *
+ * @example
+ * ```tsx
+ * const { activeKey, setActiveKey, getActiveKey } = useActiveKey({
+ *   initialActiveKey: [1, 10],
+ *   onChange: (value) => console.log('当前选中:', value)
+ * });
+ *
+ * // 设置第 0 层级的 key，并清除后续层级
+ * setActiveKey(0, '2');
+ *
+ * // 设置第 0 层级的 key，并同时设置第 1 层级
+ * setActiveKey(0, '2', '20');
+ *
+ * // 获取第 0 层级的 key
+ * const level0Key = getActiveKey(0);
+ * ```
+ */
+declare const useActiveKey: (props: UseActiveKeyProps) => UseActiveKeyReturn;
+export default useActiveKey;

package/lib/components/PisellTabbar/hooks/useExpand.d.ts

@@ -0,0 +1,42 @@
+import { ExpandState, LevelType } from '../types';
+/**
+ * useExpand Hook 参数
+ */
+interface UseExpandProps {
+    /** 初始展开状态 */
+    initialExpand?: Partial<ExpandState>;
+}
+/**
+ * useExpand Hook 返回值
+ */
+interface UseExpandReturn {
+    /** 展开状态 */
+    expand: ExpandState;
+    /** 设置展开状态 */
+    setExpand: (state: ExpandState) => void;
+    /** 切换指定层级的展开状态 */
+    toggleExpand: (level: LevelType) => void;
+    /** 获取指定层级的展开状态 */
+    getExpand: (level: LevelType) => boolean;
+    closeAll: () => void;
+}
+/**
+ * Tabbar 展开状态管理 Hook
+ * 用于管理多层级的展开/收起状态
+ *
+ * @param props - Hook 配置参数
+ * @returns 展开状态和操作方法
+ *
+ * @example
+ * ```tsx
+ * const { expand, toggleExpand, getExpand } = useExpand({
+ *   initialExpand: { level1: false }
+ * });
+ *
+ * <button onClick={() => toggleExpand('level1')}>
+ *   {getExpand('level1') ? '收起' : '展开'}
+ * </button>
+ * ```
+ */
+declare const useExpand: (props?: UseExpandProps) => UseExpandReturn;
+export default useExpand;

package/lib/components/PisellTabbar/template/Template1/PisellTabbar.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import '../../PisellTabbar.less';
+import { PisellTabbarProps } from '../../types';
+declare const _default: React.ForwardRefExoticComponent<PisellTabbarProps & React.RefAttributes<unknown>>;
+export default _default;

package/lib/components/PisellTabbar/template/Template1/constants.d.ts

@@ -0,0 +1,10 @@
+import { TabbarLevelConfig, LevelType } from '../../types';
+export { getExpandConfig, DEFAULT_ITEMS } from '../../constants';
+/**
+ * 默认层级配置
+ */
+export declare const DEFAULT_LEVEL_CONFIG: Record<LevelType, TabbarLevelConfig>;
+/**
+ * 获取层级对应的添加项配置
+ */
+export declare const LEVEL_ADD_ITEMS: Record<LevelType, ('all' | 'search' | 'expand')[]>;

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

@@ -0,0 +1,90 @@
+import { CSSProperties } from 'react';
+/**
+ * Tabbar 数据源项类型
+ */
+export interface TabbarDataSource {
+    /** 唯一标识 */
+    id: string | number;
+    /** 店铺ID */
+    shop_id?: number;
+    /** 父级ID */
+    parent_id?: number;
+    /** 显示名称 */
+    name: string;
+    /** URL slug */
+    slug?: string;
+    /** 图标 URL 或图标名称 */
+    icon?: string;
+    /** 子级数据 */
+    children?: TabbarDataSource[];
+    /** 自定义点击事件标识 */
+    customClick?: boolean;
+    /** 唯一 key */
+    key?: string;
+}
+/**
+ * 层级配置
+ */
+export interface TabbarLevelConfig {
+    /** SuperTabs 背景色 */
+    superTabsBg: string;
+    /** 卡片宽度 */
+    cardWidth: number;
+    /** 卡片高度 */
+    cardHeight: number;
+    /** 左侧缩进 */
+    paddingLeft?: number;
+}
+/**
+ * 展开配置
+ */
+export interface ExpandConfig {
+    /** 激活状态配置 */
+    active: {
+        icon: string;
+        text: string;
+    };
+    /** 未激活状态配置 */
+    inactive: {
+        icon: string;
+        text: string;
+    };
+}
+/**
+ * 展开状态
+ */
+export interface ExpandState {
+    level1: boolean;
+    level2: boolean;
+    level3: boolean;
+}
+/**
+ * 层级类型
+ */
+export declare type LevelType = 'level1' | 'level2' | 'level3';
+/**
+ * PisellTabbar 组件属性
+ */
+export interface PisellTabbarProps {
+    /** 数据源 */
+    dataSource?: TabbarDataSource[];
+    /** 当前选中的值（多层级 key 数组） */
+    value?: (string | number)[];
+    /** 值变化回调 */
+    onChange?: (value: (string | number)[]) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 层级配置（可按层级自定义） */
+    levelConfig?: Partial<Record<LevelType, Partial<TabbarLevelConfig>>>;
+    /** 展开配置 */
+    expandConfig?: ExpandConfig;
+    /** 最大层级数 */
+    maxLevel?: 1 | 2 | 3;
+    onSearch?: (value: string) => void;
+    __designMode?: boolean;
+}
+export interface PisellTabbarRef {
+    closeSearchMode: () => void;
+}

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

@@ -0,0 +1,69 @@
+/**
+ * PisellTabbar 工具函数
+ */
+import { TabbarDataSource } from '../types';
+/**
+ * 默认的特殊项配置
+ */
+export declare const defaultItems: {
+    all: {
+        id: number;
+        shop_id: number;
+        parent_id: number;
+        name: any;
+        slug: string;
+        icon: string;
+    };
+    search: {
+        id: number;
+        shop_id: number;
+        parent_id: number;
+        name: any;
+        text: any;
+        slug: string;
+        key: string;
+        icon: string;
+        customClick: boolean;
+    };
+    expand: {
+        id: number;
+        shop_id: number;
+        parent_id: number;
+        key: string;
+        icon: string;
+        name: string;
+        slug: string;
+        customClick: boolean;
+    };
+};
+/**
+ * 向数据源添加特殊项（如 all、search、expand 按钮）
+ *
+ * @param dataSource - 原始数据源
+ * @param keys - 要添加的特殊项 key 数组
+ * @returns 添加了特殊项的新数据源
+ *
+ * @example
+ * ```tsx
+ * const newData = addDataSourceItemsByKey(categoryData, ['expand', 'all']);
+ * // 返回: [expandItem, allItem, ...categoryData]
+ * ```
+ */
+export declare const addDataSourceItemsByKey: (dataSource: TabbarDataSource[], keys: ('all' | 'search' | 'expand')[]) => TabbarDataSource[];
+/**
+ * 获取默认激活的 key 数组
+ *
+ * @param dataSource - 数据源
+ * @param rowKey - 用作唯一标识的字段名
+ * @returns 默认激活的 key 数组（多层级）
+ *
+ * @description
+ * 默认选中第一项，如果第一项有子级，同时选中第一个子级
+ *
+ * @example
+ * ```tsx
+ * const defaultKeys = getDefaultActiveKey(categoryData, 'id');
+ * // 返回: [1, 0] (第一层级的第一项ID，第二层级的第一项ID)
+ * ```
+ */
+export declare const getDefaultActiveKey: (dataSource: TabbarDataSource[], rowKey: string) => (string | number)[];

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

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { SafeAreaTopProps } from './types';
+import './index.less';
+export declare const SafeAreaTop: React.NamedExoticComponent<SafeAreaTopProps>;
+export default SafeAreaTop;

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

@@ -0,0 +1,9 @@
+import type React from 'react';
+export interface SafeAreaTopProps {
+    /** 顶部安全区背景色，默认透明。 */
+    backgroundColor?: string;
+    /** 业务页面传入的自定义样式类。 */
+    className?: string;
+    /** 额外内联样式，优先级高于组件默认样式。 */
+    style?: React.CSSProperties;
+}

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

@@ -0,0 +1,4 @@
+import { AppVersionControlProps } from './types';
+import './index.less';
+declare const AppVersionControl: (props: AppVersionControlProps) => JSX.Element;
+export default AppVersionControl;

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

@@ -0,0 +1,19 @@
+import React from 'react';
+import type { MenuProps, ButtonProps } from 'antd';
+export interface ButtonGroupListItemProps {
+    id?: string;
+    isMore?: boolean;
+    menuData?: MenuProps['items'];
+    buttonProps?: ButtonProps;
+}
+interface ButtonConfigProps {
+    [id: string]: ButtonGroupListItemProps;
+}
+export declare type ButtonGroupListProps = ButtonGroupListItemProps[][];
+interface ButtonGroupPreviewProps {
+    buttonConfig?: ButtonConfigProps;
+    buttonGroupList?: ButtonGroupListProps;
+    updateButtonProps?: ButtonGroupListItemProps;
+}
+declare const _default: React.MemoExoticComponent<React.ForwardRefExoticComponent<ButtonGroupPreviewProps & React.RefAttributes<any>>>;
+export default _default;

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

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

package/lib/components/dataSourceComponents/dataSourceShow/dataSourceImage/index.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+declare const DataSourceImage: (props: import("../utils").ParsedProps) => JSX.Element;
+export default DataSourceImage;

package/lib/components/dataSourceComponents/dataSourceTable/hooks/useDrawerState.d.ts

@@ -0,0 +1,4 @@
+declare const useDrawerState: (operationContent?: {
+    [key: string]: import("react").ReactNode;
+} | undefined) => any;
+export default useDrawerState;

package/lib/components/dataSourceComponents/dataSourceTable/hooks/useFormat.d.ts

@@ -0,0 +1,48 @@
+import { Field } from '../../provider/dataSource/DataSourceContext';
+export declare type ListResult = {
+    data: any[];
+    count: number;
+    page: number;
+    pageSize: number;
+};
+export declare type UseFormatParams = {
+    dataSourceKey: string;
+    fields: Field[];
+};
+export declare type ApiListResult = {
+    list: any[];
+    count: number;
+    size: number;
+} & ({
+    page: number;
+} | {
+    skip: number;
+});
+export declare type FormatListResultParams = ApiListResult | {
+    data: any[];
+    meta: {
+        count: number;
+        page: number;
+        pageSize: number;
+    };
+};
+export declare type FilterValue = {
+    [key: string]: any;
+};
+export declare type FilterOperator = '$includes' | '$dateAfter' | '$dateBefore' | '$eq' | '$in' | '$isTruly' | '$and';
+export declare type SimpleFilterValue = {
+    [key in Exclude<FilterOperator, '$and'>]?: any;
+};
+export declare type AndFilterValue = {
+    $and: FilterCondition[];
+};
+export declare type FilterConditionValue = SimpleFilterValue | AndFilterValue;
+export declare type FilterCondition = {
+    [key: string]: FilterConditionValue;
+} | AndFilterValue;
+declare const useFormat: ({ dataSourceKey, fields }: UseFormatParams) => {
+    formatListResult: (res: FormatListResultParams) => ListResult;
+    formatListParams: (params: any) => any;
+    formatCreateUpdateParams: (params: any) => any;
+};
+export default useFormat;

package/lib/components/dataSourceComponents/dataSourceTable/hooks/useTableProps.d.ts

@@ -0,0 +1,100 @@
+import React from 'react';
+import { DataSourceTableProps } from '../type';
+import { OperationItem } from '../type';
+interface UseTablePropsProps {
+    data: any;
+    originProps: DataSourceTableProps;
+    openDrawer: (type: OperationItem) => void;
+    closeDrawer: () => void;
+    refreshData: () => void;
+    handleFilterChange: (changedFields: any, allFields: any) => void;
+    tableRef: any;
+    getInitialValues: () => Record<string, any>;
+}
+/**
+ * 处理table的props
+ * 转换title
+ * @param props
+ * @returns
+ */
+declare const useTableProps: (props: UseTablePropsProps) => {
+    currentComponentId: any;
+    title: number | boolean | React.ReactFragment | JSX.Element | (() => React.ReactNode) | null | undefined;
+    pagination: {
+        total: number;
+        current: number;
+        pageSize: number;
+        size: string;
+        showSizeChanger: boolean;
+    };
+    columns: import("./useColumns").Column[];
+    subTitle: number | boolean | React.ReactFragment | JSX.Element | (() => React.ReactNode) | null | undefined;
+    buttons: any[] | null;
+    filter: {
+        dom: any;
+        items: any;
+    } | null;
+    onRow: (record: any) => any;
+    actionButtons: any[] | null;
+    __id?: string | undefined;
+    currentSettingKey?: string | undefined;
+    titleButtons?: {
+        show: boolean;
+        maxCount: number;
+        items: OperationItem[];
+    } | undefined;
+    tableButtons?: {
+        show: boolean;
+        maxCount: number;
+        items: OperationItem[];
+    } | undefined;
+    operation?: {
+        show: boolean;
+        title: string;
+        width: number;
+        align: "center" | "left" | "right";
+        fixed: false | "left" | "right";
+        type: "link" | "button";
+        items: OperationItem[];
+    } | undefined;
+    operationContent?: {
+        [key: string]: React.ReactNode;
+    } | undefined;
+    dataSource: import("../../provider/dataSource/DataSourceContext").DataSourceType;
+    search?: {
+        show: boolean;
+        placeholder: string;
+    } | undefined;
+    __designMode: string;
+    componentId: string;
+    clickToDetail?: {
+        show: boolean;
+        useCustomAction: boolean;
+        actionType: string;
+        openMode: "modal" | "drawer";
+        openContentSize: "small" | "middle" | "large";
+        openTitle: string;
+        key: string;
+    } | undefined;
+    filterBy?: Record<string, any> | undefined;
+    sortBy: string;
+    tabs?: {
+        show: boolean;
+        type: string;
+        items: {
+            name: string;
+            filterBy: Record<string, any>;
+            sortBy: string;
+        }[];
+    } | undefined;
+    onValuesChange?: ((changedValues: any, values: any) => void) | undefined;
+    extraParams?: {
+        list?: Record<string, any> | undefined;
+        get?: Record<string, any> | undefined;
+        update?: Record<string, any> | undefined;
+        create?: Record<string, any> | undefined;
+        destroy?: Record<string, any> | undefined;
+    } | undefined;
+    localSettings?: import("../../../table/types").LocalSettingsType | undefined;
+};
+export default useTableProps;

package/lib/components/dataSourceComponents/dataSourceTable/type.d.ts

@@ -0,0 +1,84 @@
+/// <reference types="react" />
+import { ColumnType } from 'antd/es/table';
+import { LocalSettingsType } from '../../table/types';
+import { DataSourceType } from '../provider/dataSource/DataSourceContext';
+export declare type OperationItem = {
+    label?: string;
+    openMode: 'modal' | 'drawer' | 'custom';
+    openContentSize: 'small' | 'middle' | 'large';
+    openTitle: string;
+    actionType: 'detail' | 'edit' | 'delete' | 'custom';
+    key: string;
+    buttonProps?: any;
+    onClick?: (record: any) => void;
+    afterClose?: () => void;
+};
+export interface DataSourceTableProps {
+    __id?: string;
+    currentComponentId?: string;
+    currentSettingKey?: string;
+    title?: string | React.ReactNode | (() => React.ReactNode);
+    subTitle?: string | React.ReactNode | (() => React.ReactNode);
+    titleButtons?: {
+        show: boolean;
+        maxCount: number;
+        items: OperationItem[];
+    };
+    tableButtons?: {
+        show: boolean;
+        maxCount: number;
+        items: OperationItem[];
+    };
+    buttons?: any[];
+    operation?: {
+        show: boolean;
+        title: string;
+        width: number;
+        align: 'left' | 'center' | 'right';
+        fixed: 'left' | 'right' | false;
+        type: 'link' | 'button';
+        items: OperationItem[];
+    };
+    operationContent?: {
+        [key: string]: React.ReactNode;
+    };
+    dataSource: DataSourceType;
+    columns: ColumnType<any>[];
+    filter: any;
+    search?: {
+        show: boolean;
+        placeholder: string;
+    };
+    __designMode: string;
+    componentId: string;
+    clickToDetail?: {
+        show: boolean;
+        useCustomAction: boolean;
+        actionType: string;
+        openMode: 'modal' | 'drawer';
+        openContentSize: 'small' | 'middle' | 'large';
+        openTitle: string;
+        key: string;
+    };
+    onRow?: any;
+    filterBy?: Record<string, any>;
+    sortBy: string;
+    tabs?: {
+        show: boolean;
+        type: string;
+        items: {
+            name: string;
+            filterBy: Record<string, any>;
+            sortBy: string;
+        }[];
+    };
+    onValuesChange?: (changedValues: any, values: any) => void;
+    extraParams?: {
+        list?: Record<string, any>;
+        get?: Record<string, any>;
+        update?: Record<string, any>;
+        create?: Record<string, any>;
+        destroy?: Record<string, any>;
+    };
+    localSettings?: LocalSettingsType;
+}

package/lib/components/dataSourceComponents/fields/ColorPicker/ReadPretty.d.ts

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

package/lib/components/dataSourceComponents/fields/DatePicker/WithMode.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+import { DatePickerProps } from 'antd';
+declare const DatePickerWithMode: import("react").FC<DatePickerProps & import("../../dataSourceForm/utils").WithModeProps>;
+export default DatePickerWithMode;

package/lib/components/dataSourceComponents/fields/DatePicker/index.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const DatePicker: React.FC<(import("antd").DatePickerProps & import("../../dataSourceForm/utils").WithModeProps) & import("../../dataSourceForm/utils").WithFormItemProps>;
+export default DatePicker;

package/lib/components/dataSourceComponents/fields/DateRangePicker/ReadPretty.d.ts

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

package/lib/components/dataSourceComponents/fields/IconSelect/ReadPretty.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { IconSelectProps } from './type';
 import './ReadPretty.less';
 declare const IconSelectReadPretty: (props: IconSelectProps) => JSX.Element | null;

package/lib/components/dataSourceComponents/fields/Input/ReadPretty.d.ts

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

package/lib/components/dataSourceComponents/fields/Input.Email/ReadPretty.d.ts

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

package/lib/components/dataSourceComponents/fields/Input.Subdomain/ReadPretty.d.ts

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

package/lib/components/dataSourceComponents/fields/Input.Subdomain/index.d.ts

@@ -2,7 +2,7 @@ import React from 'react';
 declare const Subdomain: React.FC<import("antd").InputProps & {
     onChange: (value: string) => void;
     onBlur?: ((e: React.FocusEvent<HTMLInputElement, Element>) => void) | undefined;
-    rootDomain: "custom" | "xzero" | "saas";
+    rootDomain: "custom" | "saas" | "xzero";
     customDomain?: string | undefined;
     value?: string | undefined;
     tenantId: string;

package/lib/components/dataSourceComponents/fields/Input.TextArea/ReadPretty.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { TextAreaProps } from "./type";
 import "./ReadPretty.less";
 declare const TextAreaReadPretty: (props: TextAreaProps) => JSX.Element;

package/lib/components/dataSourceComponents/fields/Input.Url/ReadPretty.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { UrlProps } from './type';
 import './ReadPretty.less';
 export declare const formatUrl: (url: string) => string;

package/lib/components/dataSourceComponents/fields/TimePicker/ReadPretty.d.ts

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

package/lib/components/dataSourceComponents/fields/Translation/ReadPretty.d.ts

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