@pisell/materials 1.8.23 → 1.8.24

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/hooks/useTableQuery.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { DataSourceTableProps } from '../type';
 declare type Params = {
     pagination?: {

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/dataSourceWrapper/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { DataSourceContextProps } from '../provider/dataSource/DataSourceContext';
 declare const DataSourceWrapper: (props: DataSourceContextProps) => JSX.Element;
 export default DataSourceWrapper;

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/Input.Json/ReadPretty.d.ts

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

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

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

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

@@ -0,0 +1,9 @@
+import React from 'react';
+import { RecordListWrapperProps } from './type';
+/**
+ * @title: RecordListWrapper 只读态
+ * @description: 低代码详情模式下展示每个 option 对应的 record 数据。
+ *   值结构: { optionValue: { field1: v1, field2: v2 } }
+ */
+declare const RecordListWrapperReadPretty: React.FC<RecordListWrapperProps>;
+export default RecordListWrapperReadPretty;

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

@@ -0,0 +1,4 @@
+import React from 'react';
+import { RecordListWrapperProps } from './type';
+declare const RecordListWrapperWithMode: React.FC<RecordListWrapperProps & import("../../dataSourceForm/utils").WithModeProps>;
+export default RecordListWrapperWithMode;

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

@@ -0,0 +1,11 @@
+declare const RecordListWrapperWithDataSource: (props: import("./type").RecordListWrapperProps & import("../../dataSourceForm/utils").WithModeProps & import("../../dataSourceForm/utils").WithFormItemProps & {
+    options?: any;
+    optionSourceType?: "default" | "custom" | "api" | undefined;
+    labelField: string;
+    valueField: string;
+    extraParams?: Record<string, any> | undefined;
+} & {
+    dataSource?: any;
+    extraParams?: Record<string, any> | undefined;
+}) => JSX.Element;
+export default RecordListWrapperWithDataSource;

package/lib/components/dataSourceComponents/fields/RecordListWrapper/type.d.ts

@@ -0,0 +1,87 @@
+import React from 'react';
+import { ModeType } from '../../dataSourceForm/type';
+export interface RecordListWrapperOption {
+    label?: React.ReactNode;
+    value: string | number;
+}
+export interface RecordListWrapperFieldSchema {
+    name: string;
+    label?: React.ReactNode;
+    component?: string;
+    componentName?: string;
+    type?: string;
+    /** 接口类型，用于映射到具体组件（如 Select、Input 等） */
+    interface?: string;
+    options?: RecordListWrapperOption[];
+    props?: Record<string, any>;
+    /** 子字段（用于嵌套结构，如 Input.JSON） */
+    children?: RecordListWrapperFieldSchema[];
+    _children?: RecordListWrapperFieldSchema[];
+    schema?: Record<string, any>;
+    uiSchema?: {
+        title?: React.ReactNode;
+        enum?: RecordListWrapperOption[];
+        'x-component'?: string;
+        'x-component-props'?: Record<string, any>;
+        'x-read-pretty'?: boolean;
+        'x-validator'?: string;
+        'x-display'?: 'visible' | 'hidden' | 'none';
+        'x-pattern'?: 'editable' | 'disabled' | 'readPretty';
+        'x-data-source'?: {
+            type?: string;
+            options?: Array<{
+                id?: string;
+                label: string | Record<string, any>;
+                value: string;
+                color?: string;
+            }>;
+            labelField?: string;
+            valueField?: string;
+            dataSource?: any;
+            extraParams?: Record<string, any>;
+        };
+        'x-record-schema'?: RecordListWrapperSchema | RecordListWrapperFieldSchema[] | string;
+        default?: any;
+        type?: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object';
+    };
+}
+export interface RecordListWrapperSchema {
+    fields?: RecordListWrapperFieldSchema[];
+    properties?: Record<string, any>;
+    children?: RecordListWrapperFieldSchema[];
+}
+/**
+ * @title RecordListWrapper 组件 Props
+ * @description
+ * 值结构为 Map：key 是 xDataSource option 的 value，value 是该 option 对应的表单字段值。
+ * 例如：{ "5": { "code": "xxx", "type": "yyy" }, "3": { "code": "aaa" } }
+ */
+export interface RecordListWrapperProps {
+    renderMode: ModeType;
+    /**
+     * 值: Map 结构
+     * - key: xDataSource option 的 value
+     * - value: 该 option 对应的 xRecordSchema 字段值对象
+     */
+    value?: Record<string, Record<string, any>>;
+    onChange?: (value: Record<string, Record<string, any>>) => void;
+    /** xDataSource 选项列表，驱动 tabs 导航和 records 结构 */
+    options?: RecordListWrapperOption[];
+    /**
+     * 上部插槽：用户可在低代码平台拖入自定义导航组件。
+     * RecordListWrapper 会通过 cloneElement 注入 options、value（activeKey）、onChange。
+     */
+    topSlot?: React.ReactNode;
+    slot?: React.ReactNode;
+    /** xRecordSchema：定义每条记录的子字段结构 */
+    xRecordSchema?: string | RecordListWrapperSchema | RecordListWrapperFieldSchema[];
+    /** 容器 children：低代码引擎渲染的子组件节点 */
+    children?: React.ReactNode;
+    /** 低代码设计模式标识 */
+    __designMode?: string;
+    /**
+     * 默认激活的 Tab key，外部传入时优先于 options[0].value
+     */
+    defaultValue?: string;
+    [key: string]: any;
+}

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 declare const SelectWithDataSource: (props: import("antd").SelectProps<any, import("antd/es/select").DefaultOptionType> & import("../../dataSourceForm/utils").WithModeProps & import("../../dataSourceForm/utils").WithFormItemProps & {
     options?: any;
     optionSourceType?: "default" | "custom" | "api" | undefined;

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

@@ -0,0 +1,9 @@
+import React from 'react';
+import { TabsReadPrettyProps } from './type';
+/**
+ * Tabs 只读展示组件
+ *
+ * @description 在 view / tableView 模式下展示选中的标签名称文本。
+ */
+declare const TabsReadPretty: React.FC<TabsReadPrettyProps>;
+export default TabsReadPretty;

package/lib/components/dataSourceComponents/fields/Tabs/Tabs.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import { TabsProps } from './type';
+import './Tabs.less';
+/**
+ * Tabs 胶囊风格选项卡组件
+ *
+ * @description 提供类似 Segmented 控件的胶囊风格选项卡，支持受控与非受控模式。
+ * 用于表单中替代 Radio.Group，展示更为直观的标签页切换交互。
+ *
+ * @example
+ * ```tsx
+ * <Tabs
+ *   value={current}
+ *   options={[
+ *     { label: '校区', value: 'campus' },
+ *     { label: '场地', value: 'venue' },
+ *   ]}
+ *   onChange={(val) => setCurrent(val)}
+ * />
+ * ```
+ */
+declare const Tabs: React.FC<TabsProps>;
+export default Tabs;

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

@@ -0,0 +1,6 @@
+/// <reference types="react" />
+/**
+ * TabsWithMode
+ */
+declare const TabsWithMode: import("react").FC<import("./type").TabsProps & import("../../dataSourceForm/utils").WithModeProps>;
+export default TabsWithMode;

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

@@ -0,0 +1,12 @@
+/** 包装 DataSource 层（提供数据源上下文） */
+declare const FormItemTabs: (props: import("./type").TabsProps & import("../../dataSourceForm/utils").WithModeProps & import("../../dataSourceForm/utils").WithFormItemProps & {
+    options?: any;
+    optionSourceType?: "default" | "custom" | "api" | undefined;
+    labelField: string;
+    valueField: string;
+    extraParams?: Record<string, any> | undefined;
+} & {
+    dataSource?: any;
+    extraParams?: Record<string, any> | undefined;
+}) => JSX.Element;
+export default FormItemTabs;

package/lib/components/dataSourceComponents/fields/Tabs/type.d.ts

@@ -0,0 +1,38 @@
+import React from 'react';
+import { ModeType } from '../../dataSourceForm/type';
+/**
+ * Tabs 选项配置
+ */
+export interface TabOption {
+    /** 选项显示文本 */
+    label: React.ReactNode;
+    /** 选项对应的值 */
+    value: string | number;
+    /** 是否禁用该选项 */
+    disabled?: boolean;
+}
+/**
+ * Tabs 基础 Props（编辑态组件使用，不含 renderMode）
+ */
+export interface TabsProps {
+    /** 当前选中的值（受控） */
+    value?: string | number;
+    /** 默认选中的值（非受控） */
+    defaultValue?: string | number;
+    /** 选项列表 */
+    options?: TabOption[];
+    /** 是否禁用整个组件 */
+    disabled?: boolean;
+    /** 选中值变化时的回调 */
+    onChange?: (value: string | number) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+}
+/**
+ * Tabs ReadPretty Props（只读态组件使用，包含必填 renderMode）
+ */
+export interface TabsReadPrettyProps extends TabsProps {
+    renderMode: ModeType;
+}

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

@@ -0,0 +1,5 @@
+import React from 'react';
+import { TranslationProps } from './type';
+import './index.less';
+declare const Translation: React.FC<TranslationProps>;
+export default Translation;

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

@@ -0,0 +1,21 @@
+/// <reference types="react" />
+import { ModeType } from "../../dataSourceForm/type";
+export interface TranslationValue {
+    en: string;
+    'zh-CN': string;
+    'zh-HK': string;
+    'ja': string;
+    'pt': string;
+    original: string;
+}
+export interface TranslationProps {
+    renderMode: ModeType;
+    value?: TranslationValue;
+    onChange?: (value: TranslationValue) => void;
+    disabled?: boolean;
+    placeholder?: string;
+    className?: string;
+    type?: 'text' | 'textarea';
+    maxLength?: number;
+    inputStyle?: React.CSSProperties;
+}

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

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

package/lib/components/dataSourceComponents/fields/Upload/utils.d.ts

@@ -0,0 +1,18 @@
+import { RcFile, UploadFile } from 'antd/es/upload/interface';
+import type { MediaMetadata, FileCountValidation, ValidationResult, MultilingualFile, FileListOptions, UploadValue, SingleMultilingualValue } from './types';
+export declare const generateUid: () => string;
+export declare const getSuffix: (name: string) => string;
+export declare const getPointSuffix: (name: string) => string;
+export declare const getFileType: (name: string) => string;
+export declare const getFileName: (url: string) => string;
+export declare const checkFileCount: ({ multiple, minCount, maxCount, valueLength, }: FileCountValidation) => ValidationResult;
+export declare const getMediaMetadata: (file: RcFile) => Promise<MediaMetadata | null>;
+export declare const genFileListByString: (value: string) => UploadFile[];
+export declare const createMultilingualData: (value: string) => SingleMultilingualValue;
+export declare const createMultilingualFileList: (value: string) => Record<string, UploadFile<any>[]>;
+export declare const getDefaultFileList: (value: UploadValue | undefined, options: FileListOptions) => MultilingualFile[];
+export declare const getFileMetadataParams: (file: RcFile & {
+    metadata?: MediaMetadata;
+}) => Record<string, any>;
+export declare const isValueEqual: (value: any, fileListValue: any) => boolean;
+export declare const getBaseTime: (size: number) => 1000 | 2000 | 4000 | 8000;