@pisell/materials 6.11.224 → 6.11.225

package/lib/components/dataSourceComponents/dataSourceForm/serve.d.ts

@@ -0,0 +1,201 @@
+export interface DataSourceType {
+    key: string;
+    displayName: string;
+    status: string;
+    type: string;
+    isDBInstance: boolean;
+    collections: Collection[];
+}
+export declare type ActionsItem = {
+    method: string;
+    path: string;
+    params: {
+        name: string;
+        value: string;
+    }[];
+    headers: {
+        name: string;
+        value: string;
+    }[];
+    body: Record<string, any>;
+};
+export interface Collection {
+    name: string;
+    title: string;
+    tableName: string;
+    timestamps: boolean;
+    autoGenId: boolean;
+    filterTargetKey: string;
+    fields: Field[];
+    introspected: boolean;
+    unavailableActions: any[];
+    actions: {
+        get: ActionsItem;
+        update: ActionsItem;
+        create: ActionsItem;
+        delete: ActionsItem;
+        list: ActionsItem;
+    };
+}
+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;
+}
+/**
+ * 获取nocobase自定义数据源
+ */
+export declare const getNocobaseDataSource: () => Promise<DataSourceType[]>;
+/**
+ * 获取nocobase主数据源
+ */
+export declare const getNocobaseMainDataSource: () => Promise<any>;
+/**
+ * 获取nocobase数据源设置
+ */
+export declare const getNocobaseDataSourceOptions: () => Promise<any>;
+/**
+ * 创建nocobase数据
+ */
+export declare const createNocobaseData: (params: {
+    key: string;
+    data: any;
+    headers?: any;
+}) => Promise<any>;
+/**
+ * nocobase get数据
+ */
+export declare const getNocobaseData: (params: {
+    key: string;
+    query: Record<string, any>;
+    headers?: any;
+}) => Promise<any>;
+/**
+ * 自定义api接口
+ */
+export declare const customApi: (url: string, data: Record<string, any>, options: {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    baseUrl?: string | undefined;
+    headers?: {
+        name: string;
+        value: any;
+    }[] | undefined;
+    params?: {
+        name: string;
+        value: any;
+    }[] | undefined;
+    body?: Record<string, any> | undefined;
+    dataSourceKey?: string | undefined;
+}) => Promise<any>;
+/**
+ * 更新nocobase数据
+ */
+export declare const updateNocobaseData: (params: {
+    key: string;
+    data: any;
+    headers?: any;
+    query?: Record<string, any> | undefined;
+}) => Promise<any>;
+/**
+ * 获取nocobase数据列表
+ */
+export declare const getNocobaseDataList: (allParams: {
+    key: string;
+    params: {
+        page: number;
+        pageSize: number;
+    };
+    headers?: any;
+}) => Promise<any>;
+/**
+ * 删除nocobase数据
+ */
+export declare const deleteNocobaseData: (key: string, id: string, headers?: any) => Promise<any>;
+/**
+ * 获取formSettingMeta数据
+ * @param params 请求参数
+ * @param params.sectionCodes 配置段代码数组，如 ['payment']
+ * @param params.businessCode 业务代码
+ * @param params.channelCode 渠道代码
+ * @param params.isBoard 是否包含board_code参数
+ * @returns Promise<any> 返回设置元数据
+ */
+export declare const getFormSettingMetaData: (params: {
+    sectionCodes: string[];
+    scope: string;
+    target?: string | undefined;
+}) => Promise<any>;
+/**
+ * 更新租户设置数据
+ * @param params 请求参数
+ * @param params.businessCode 业务代码
+ * @param params.channelCode 渠道代码
+ * @param params.boardCode 板块代码
+ * @param params.data 要更新的数据对象，如 {"order.prefix":"","order.suffix":"","payment.number":""}
+ * @returns Promise<any> 返回更新结果
+ */
+export declare const updateTenantSetting: (params: {
+    scope: string;
+    target?: string | undefined;
+    data: Record<string, any>;
+}) => Promise<any>;
+export declare type DeviceSettingScene = 'template' | 'profile' | 'instance';
+/**
+ * 获取设备设置元数据（POST 类型 GET）
+ * @param params.scene 场景，默认 template
+ * @param params.sceneRequestId URL 中 {id} 占位符的实际取值
+ * @param params.items 需要获取的字段列表，例如 ['order.name', 'order.id']
+ */
+export declare const getDeviceSettingMetaData: (params: {
+    scene?: DeviceSettingScene | undefined;
+    sceneRequestId: string;
+    items: string[];
+}) => Promise<any>;
+/**
+ * 更新设备设置数据
+ * @param params.scene 场景，默认 template
+ * @param params.sceneRequestId URL 中 {id} 占位符的实际取值
+ * @param params.data 需要更新的字段值对象
+ */
+export declare const updateDeviceSetting: (params: {
+    scene?: DeviceSettingScene | undefined;
+    sceneRequestId: string;
+    data: Record<string, any>;
+}) => Promise<any>;
+export {};

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

@@ -0,0 +1,35 @@
+import React from 'react';
+import { DataSourceType } from "../provider/dataSource/DataSourceContext";
+export declare type ModeType = 'edit' | 'add' | 'view' | 'disabled' | 'hidden' | 'tableView';
+export interface DataSourceFormProps {
+    title: string;
+    description: string;
+    dataSource: DataSourceType;
+    extraParams?: Record<string, any>;
+    showTitle: boolean;
+    showDescription: boolean;
+    groupInfoPosition: 'top' | 'side';
+    variables: any[];
+    renderMode?: ModeType;
+    currentValue?: 'server' | 'local';
+    scene?: 'template' | 'profile' | 'instance';
+    sceneRequestId?: string;
+    children: React.ReactNode;
+    className?: string;
+    size?: 'small' | 'middle' | 'large';
+    onDataSourceFinish?: (values: any, result: any) => void;
+    __designMode?: string;
+    formatSubmitValues?: (values: Record<string, any>) => Record<string, any>;
+    formatInitialValues?: (values: Record<string, any>) => Record<string, any>;
+    onDataSourceLoaded?: (values: Record<string, any>, result: any) => void;
+    customSubmit?: (values: Record<string, any>) => Promise<any>;
+    beforeSubmit?: (values: Record<string, any>) => Promise<boolean> | boolean;
+    leaveConfirmConfig?: {
+        enable: boolean;
+        title: string;
+        content: string;
+        icon: React.ReactNode;
+        okText: string;
+        cancelText: string;
+    };
+}

package/lib/components/dataSourceComponents/dataSourceForm/urlUtils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * URL参数处理工具方法
+ */
+/**
+ * 从浏览器URL获取查询参数
+ * @returns Record<string, string> URL查询参数对象
+ */
+export declare const getUrlParams: () => Record<string, string>;
+/**
+ * 从URL参数中提取formSettingMeta相关的参数
+ * @param urlParams URL查询参数对象，如果不传则自动从浏览器获取
+ * @returns 包含business_code、channel_code和isBoard参数的对象
+ */
+export declare const getFormSettingParams: (urlParams?: Record<string, string>) => {
+    businessCode: string;
+    channelCode: string;
+    isBoard: boolean;
+};
+/**
+ * 根据URL参数更新租户设置数据
+ * @param data 要更新的数据对象，如 {"order.prefix":"","order.suffix":"","payment.number":""}
+ * @returns Promise<any> 返回更新结果
+ */
+export declare const updateTenantSettingFromUrl: (data: Record<string, any>) => Promise<any>;

package/lib/components/dataSourceComponents/dataSourceSubForm/types.d.ts

@@ -0,0 +1,117 @@
+import React from 'react';
+import { ModeType } from '../dataSourceForm/type';
+/**
+ * @title 字段选项接口
+ * @description 用于下拉框、单选框等组件的选项配置
+ */
+export interface DataSourceSubFormOption {
+    label?: React.ReactNode;
+    value: string | number;
+}
+/**
+ * @title 字段 Schema 接口
+ * @description 定义表单字段的结构和配置
+ */
+export interface DataSourceSubFormFieldSchema {
+    /** 字段名称（必填） */
+    name: string;
+    /** 字段标签 */
+    label?: React.ReactNode;
+    /** 组件类型（兼容多种命名方式） */
+    component?: string;
+    componentName?: string;
+    /** 字段数据类型 */
+    type?: string;
+    /** 接口类型，用于映射到具体组件（如 Select、Input 等） */
+    interface?: string;
+    /** 字段选项列表（用于 Select、Radio 等） */
+    options?: DataSourceSubFormOption[];
+    /** 组件额外配置 */
+    props?: Record<string, any>;
+    /** 子字段（用于嵌套结构，如 Input.JSON） */
+    children?: DataSourceSubFormFieldSchema[];
+    _children?: DataSourceSubFormFieldSchema[];
+    /** 字段 Schema 配置 */
+    schema?: Record<string, any>;
+    /** UI Schema 配置（支持低代码平台的各种配置项） */
+    uiSchema?: {
+        title?: React.ReactNode;
+        enum?: DataSourceSubFormOption[];
+        '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'?: DataSourceSubFormSchema | DataSourceSubFormFieldSchema[] | string;
+        default?: any;
+        type?: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object';
+    };
+}
+/**
+ * @title Schema 接口
+ * @description 表单字段集合的结构定义
+ */
+export interface DataSourceSubFormSchema {
+    /** 字段列表 */
+    fields?: DataSourceSubFormFieldSchema[];
+    /** 属性映射（key-value 形式） */
+    properties?: Record<string, any>;
+    /** 子字段列表 */
+    children?: DataSourceSubFormFieldSchema[];
+}
+/**
+ * @title DataSourceSubForm 组件 Props
+ * @description
+ * 独立的子表单组件，用于渲染一组表单字段。
+ * 支持通过 xRecordSchema 配置字段，或直接传入 children 低代码子组件。
+ */
+export interface DataSourceSubFormProps {
+    /** 渲染模式：edit（编辑）、disabled（禁用）、preview（预览） */
+    renderMode?: ModeType;
+    /**
+     * 表单值对象
+     * @example { "fieldName1": "value1", "fieldName2": "value2" }
+     */
+    value?: Record<string, any>;
+    /**
+     * 值变化回调
+     * @param value 更新后的表单值对象
+     */
+    onChange?: (value: Record<string, any>) => void;
+    /**
+     * xRecordSchema：定义表单字段结构
+     * 支持三种格式：
+     * 1. JSON 字符串
+     * 2. Schema 对象（包含 fields/properties/children）
+     * 3. 字段数组
+     */
+    xRecordSchema?: string | DataSourceSubFormSchema | DataSourceSubFormFieldSchema[];
+    /**
+     * 容器 children：低代码引擎渲染的子组件节点
+     * 优先使用 children，如果没有则回退到 xRecordSchema 渲染
+     */
+    children?: React.ReactNode;
+    /** 低代码设计模式标识 */
+    __designMode?: string;
+    /** 表单布局方式 */
+    layout?: 'horizontal' | 'vertical' | 'inline';
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    [key: string]: any;
+}

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 declare const useDrawerState: (operationContent?: {
     [key: string]: import("react").ReactNode;
 } | undefined) => any;

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

@@ -72,7 +72,7 @@ declare const useTableProps: (props: UseTablePropsProps) => {
         useCustomAction: boolean;
         actionType: string;
         openMode: "modal" | "drawer";
-        openContentSize: "large" | "middle" | "small";
+        openContentSize: "small" | "middle" | "large";
         openTitle: string;
         key: string;
     } | undefined;

package/lib/components/dataSourceComponents/dataSourceWrapper/index.d.ts

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

package/lib/components/dataSourceComponents/fields/Input.Mobile/serve.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 获取nocobase数据列表
+ */
+export declare const getCountryDataList: () => Promise<any>;
+export interface Country {
+    id: number;
+    name: {
+        en: string;
+        'zh-CN': string;
+        'zh-HK': string;
+        'ja': string;
+        'pt': string;
+        original: string;
+    };
+    code: string;
+    calling_code: string;
+    currency_code: string;
+    sort: number;
+    status: string;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+}
+export declare const useCountries: () => {
+    data: Country[];
+};

package/lib/components/dataSourceComponents/fields/Input.Phone/serve.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 获取nocobase数据列表
+ */
+export declare const getCountryDataList: () => Promise<any>;
+export declare const getShopCountryDataList: (locale?: any) => Promise<any>;
+export interface Country {
+    id: number;
+    name: {
+        en: string;
+        'zh-CN': string;
+        'zh-HK': string;
+        'ja': string;
+        'pt': string;
+        original: string;
+    };
+    code: string;
+    calling_code: string;
+    currency_code: string;
+    sort: number;
+    status: string;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+}
+export declare const useCountries: () => {
+    data: Country[];
+};

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

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

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,3 +1,4 @@
+/// <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/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/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 /** 包装 DataSource 层（提供数据源上下文） */
 declare const FormItemTabs: (props: import("./type").TabsProps & import("../../dataSourceForm/utils").WithModeProps & import("../../dataSourceForm/utils").WithFormItemProps & {
     options?: any;

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

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

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

@@ -0,0 +1,22 @@
+/// <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;
+    allowClear?: boolean;
+}