@pisell/materials 6.11.7 → 6.11.9

package/lowcode/_utils/defaultSchema.ts

@@ -47,7 +47,8 @@ export const generalItemMap = {
       },
       tip: {
         type: 'i18n',
-        'en-US': 'The text displayed in the label of the form item, corresponding to Label.',
+        'en-US':
+          'The text displayed in the label of the form item, corresponding to Label.',
         'zh-CN': '用于显示在表单项的标签文本，对应Label。',
       },
     },
@@ -113,6 +114,29 @@ export const generalItemMap = {
           // setTimeout(() => {
           //   target.document.project.simulatorHost.rerender();
           // });
+          // 根据字段配置更新选项类型相关配置
+          const xDataSource = field.uiSchema?.['x-data-source'];
+          if (xDataSource) {
+            // 如果字段有数据源配置，则同步设置
+            target.getProps().setPropValue('optionSourceType', xDataSource?.type);
+            target.getProps().setPropValue('dataSource', xDataSource?.dataSource);
+            target.getProps().setPropValue('extraParams', xDataSource?.extraParams);
+            target.getProps().setPropValue('labelField', xDataSource?.labelField);
+            target.getProps().setPropValue('valueField', xDataSource?.valueField);
+            // 直接 setPropValue 不会触发 optionSourceType 的 extraProps.setValue，
+            // simulatorHost.rerender() 只更新画布，不会刷新设置面板，
+            // 需要通过重新选中节点来强制设置面板重建，使 setter 函数重新求值
+            setTimeout(() => {
+              const node = target.node;
+              if (node?.document?.selection) {
+                const { selection } = node.document;
+                selection.clear();
+                requestAnimationFrame(() => {
+                  selection.select(node.id);
+                });
+              }
+            });
+          }
         }
         return target.getProps().setPropValue('name', value);
       },
@@ -164,8 +188,10 @@ export const generalItemMap = {
       },
       tip: {
         type: 'i18n',
-        'en-US': 'Whether to hide the Label of the component, including title and tooltip, but not including helper text.',
-        'zh-CN': '是否隐藏组件的Label，包括title和tooltip，但是不包括helper text。',
+        'en-US':
+          'Whether to hide the Label of the component, including title and tooltip, but not including helper text.',
+        'zh-CN':
+          '是否隐藏组件的Label，包括title和tooltip，但是不包括helper text。',
       },
     },
     propType: 'bool',
@@ -511,7 +537,9 @@ export const generalItemMap = {
               propType: 'string',
               setter: 'PisellI18nSetter',
               condition: (target: any) => {
-                return !(['subdomain', 'appIdentifier'].includes(target.parent.getPropValue('type')));
+                return !['subdomain', 'appIdentifier'].includes(
+                  target.parent.getPropValue('type')
+                );
               },
             },
           ],
@@ -676,7 +704,7 @@ export const formItemGeneralDataGroup = {
           disabled: true,
           filters: {
             tables: 'all',
-            variables: {}
+            variables: {},
           },
         },
       },
@@ -701,16 +729,40 @@ export const formItemGeneralOptionTypeGroup = {
         'en-US': 'Type',
         'zh-CN': '类型',
       },
-      setter: {
-        componentName: 'SelectSetter',
-        props: {
-          options: [
-            { title: '默认', value: 'default' },
-            { title: '自定义', value: 'custom' },
-            { title: 'API', value: 'api' },
-          ],
+      condition: (target: any) => {
+        // 读取 optionSourceType 建立响应式依赖，值变更时触发重新求值
+        target.getProps().getPropValue('optionSourceType');
+        return true;
+      },
+      extraProps: {
+        setValue(target: any, value: any) {
+          target.getProps().setPropValue('optionSourceType', value);
         },
       },
+      setter: (target: any) => {
+        const parentForm = getParentForm(target);
+        const fields = getVariable(parentForm, 'currentFields');
+        // 获取当前表单项的 name
+        const currentFieldName = target.getProps().getPropValue('name');
+        // 在 currentFields 中查找对应的字段配置
+        const fieldConfig = fields?.find(
+          (item: any) => item.name === currentFieldName
+        );
+        // 检查字段配置中是否有 x-data-source，如果有说明 optionSourceType 是从数据源设置的
+        const dataSourceType = fieldConfig?.uiSchema?.['x-data-source']?.type;
+
+        return {
+          componentName: 'PisellSelectSetter',
+          props: {
+            disabled: !!dataSourceType,
+            options: [
+              { label: '默认', value: 'default' },
+              { label: '自定义', value: 'custom' },
+              { label: 'API', value: 'api' },
+            ],
+          },
+        };
+      },
     },
     {
       name: 'dataSource',
@@ -741,15 +793,29 @@ export const formItemGeneralOptionTypeGroup = {
           return target.getProps().setPropValue('dataSource', value.item);
         },
       },
-      setter: {
-        componentName: 'PisellDataSourceSetter',
-        props: {
-          mode: 'list',
-          filters: {
-            tables: 'all',
-            variables: {}
+      setter: (target: any) => {
+        const parentForm = getParentForm(target);
+        const fields = getVariable(parentForm, 'currentFields');
+        // 获取当前表单项的 name
+        const currentFieldName = target.getProps().getPropValue('name');
+        // 在 currentFields 中查找对应的字段配置
+        const fieldConfig = fields?.find(
+          (item: any) => item.name === currentFieldName
+        );
+        // 检查字段配置中是否有 x-data-source，如果有说明 dataSource 是从数据源设置的
+        const dataSource = fieldConfig?.uiSchema?.['x-data-source']?.dataSource;
+
+        return {
+          componentName: 'PisellDataSourceSetter',
+          props: {
+            disabled: !!dataSource,
+            mode: 'list',
+            filters: {
+              tables: 'all',
+              variables: {},
+            },
           },
-        },
+        };
       },
     },
     {
@@ -765,7 +831,7 @@ export const formItemGeneralOptionTypeGroup = {
         'en-US': 'Extra Params',
         'zh-CN': '额外参数',
       },
-      setter: 'JsonSetter'
+      setter: 'JsonSetter',
     },
     {
       name: 'labelField',
@@ -852,7 +918,7 @@ export const formItemGeneralOptionTypeGroup = {
             itemSetter: {
               componentName: 'ObjectSetter',
               initialValue: () => {
-                return {}
+                return {};
               },
               props: {
                 config: {
@@ -1554,7 +1620,7 @@ export const genGeneralVariablesSetting = ({
       props: (target: any) => {
         return {
           filters: {
-            variables: {}
+            variables: {},
           },
           variables: getCptValuesVariables(target),
         };
@@ -1563,38 +1629,37 @@ export const genGeneralVariablesSetting = ({
   };
 };
 
-
 export const inputPlaceholder = {
   type: 'i18n',
-  'en': 'Enter',
+  en: 'Enter',
   'zh-CN': '请输入',
   'zh-HK': '請輸入',
 };
 
 export const selectPlaceholder = {
   type: 'i18n',
-  'en': 'Select an option',
+  en: 'Select an option',
   'zh-CN': '请选择一个选项',
   'zh-HK': '請選擇一個選項',
 };
 
 export const selectMultiplePlaceholder = {
   type: 'i18n',
-  'en': 'Select one or more options',
+  en: 'Select one or more options',
   'zh-CN': '请选择一个或多个选项',
   'zh-HK': '請選擇一個或多個選項',
 };
 
 export const datePickerPlaceholder = {
   type: 'i18n',
-  'en': 'Select a date',
+  en: 'Select a date',
   'zh-CN': '请选择日期',
   'zh-HK': '請選擇日期',
 };
 
 export const timePickerPlaceholder = {
   type: 'i18n',
-  'en': 'Select a time',
+  en: 'Select a time',
   'zh-CN': '请选择时间',
   'zh-HK': '請選擇時間',
 };

package/lowcode/data-source-form/utils.ts

@@ -16,6 +16,20 @@ type UiSchema = {
   'x-validator'?: string;
   'x-display'?: 'visible' | 'hidden' | 'none';
   'x-pattern'?: 'editable' | 'disabled' | 'readPretty';
+  'x-data-source'?: {
+    sourceType?: string;
+    type?: string;
+    options?: Array<{ 
+      id?: string;
+      label: string | any; // 支持字符串或多语言对象
+      value: string;
+      color?: string;
+    }>;
+    labelField?: string;
+    valueField?: string;
+    dataSource?: any;
+    extraParams?: Record<string, any>;
+  };
   type: 'string' | 'number' | 'boolean' | 'array' | 'object';
 };
 
@@ -135,7 +149,6 @@ export const createFormItemSchema = (
     'x-display': xDisplay,
     type,
   } = uiSchema;
-
   let cptTitle = undefined;
 
   // 根据 x-pattern 和 x-display 确定 renderMode
@@ -290,14 +303,20 @@ export const createFormItemSchema = (
     componentName = 'Translation';
   }
 
+  // 获取选项配置
+  const dataSourceConfig = (uiSchema as any)?.['x-data-source'];
+  
   if (
     ['Select', 'Radio.Group', 'Checkbox.Group'].includes(xComponent) &&
-    uiSchema?.enum?.length > 0
+    (uiSchema?.enum?.length > 0 || dataSourceConfig)
   ) {
     if (['Radio.Group', 'Checkbox.Group'].includes(xComponent)) {
       props.direction = 'horizontal';
       props.placeholder = "";
     } else {
+      if (type === 'array') {
+        props.mode = 'multiple';
+      }
       props.styleType = 'antd';
       props.showSearch = true;
       props.optionFilterProp = 'label';
@@ -319,8 +338,53 @@ export const createFormItemSchema = (
         };
       }
     }
-    props.optionSourceType = 'default';
-    props.options = uiSchema?.enum || [];
+    
+    // 统一的选项配置处理
+    const optionConfig = dataSourceConfig || {};
+    
+    // 设置 optionSourceType
+    props.optionSourceType = optionConfig?.type || 'default';
+    
+    // 根据 sourceType 设置不同的配置
+    if (props.optionSourceType === 'default') {
+      // 优先使用 optionConfig.options，其次兼容旧的 enum 格式
+      const rawOptions = optionConfig.options || uiSchema?.enum || [];
+      
+      // 转换多语言格式的 label 为组件可识别的 i18n 格式
+      props.options = rawOptions.map((option: any) => {
+        const label = option.label;
+        
+        // 如果 label 是多语言对象格式，转换为 i18n 格式
+        if (label && typeof label === 'object' && !label.type) {
+          return {
+            ...option,
+            label: {
+              type: 'i18n',
+              'en': label.en || label.original || '',
+              'zh-CN': label['zh-CN'] || label.original || '',
+              'zh-HK': label['zh-HK'] || label.original || '',
+            }
+          };
+        }
+        
+        // 如果已经是 i18n 格式或者是字符串，直接返回
+        return option;
+      });
+    } else if (props.optionSourceType === 'api') {
+      // API 类型需要设置 labelField 和 valueField
+      if (optionConfig?.labelField) {
+        props.labelField = optionConfig.labelField;
+      }
+      if (optionConfig?.valueField) {
+        props.valueField = optionConfig.valueField;
+      }
+      if (optionConfig?.dataSource) {
+        props.dataSource = optionConfig.dataSource;
+      }
+      if (optionConfig?.extraParams) {
+        props.extraParams = optionConfig.extraParams;
+      }
+    }
   }
 
   if (xComponent === 'TimePicker') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pisell/materials",
-  "version": "6.11.7",
+  "version": "6.11.9",
   "main": "./lib/index.js",
   "module": "./es/index.js",
   "types": "./lib/index.d.ts",

package/es/components/PisellBasicGrid/PisellBasicGrid.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-import type { PisellBasicGridProps } from './types';
-import './PisellBasicGrid.less';
-/**
- * 使用 memo 优化组件性能
- * @description 当 props 没有变化时，避免不必要的重新渲染
- */
-declare const MemoizedPisellBasicGrid: <T>(props: PisellBasicGridProps<T>) => React.JSX.Element;
-export { MemoizedPisellBasicGrid as PisellBasicGrid };
-export default MemoizedPisellBasicGrid;

package/es/components/PisellBasicGrid/hooks/index.d.ts

@@ -1 +0,0 @@
-export { useGridStyle, default } from './useGridStyle';

package/es/components/PisellBasicGrid/hooks/useGridStyle.d.ts

@@ -1,37 +0,0 @@
-import type { DirectionType, WrapType, JustifyType, AlignType, AlignContentType, UseGridStyleReturn } from '../types';
-/**
- * useGridStyle Hook 参数
- */
-interface UseGridStyleParams {
-    /** 排列方向 */
-    direction?: DirectionType;
-    /** 换行控制 */
-    wrap?: WrapType;
-    /** 一行显示的元素个数 */
-    columns?: number;
-    /** 是否等分容器宽度 */
-    equalWidth?: boolean;
-    /** 统一间距 */
-    gap?: number | string;
-    /** 行间距 */
-    rowGap?: number | string;
-    /** 列间距 */
-    columnGap?: number | string;
-    /** 主轴对齐方式 */
-    justify?: JustifyType;
-    /** 交叉轴对齐方式 */
-    align?: AlignType;
-    /** 多行对齐方式 */
-    alignContent?: AlignContentType;
-}
-/**
- * 计算 Grid 布局样式的 Hook
- * @param params - 布局参数
- * @returns 容器样式和子元素样式
- * @description
- * - 根据传入的布局参数计算容器的 flex 样式
- * - 根据 columns 和 gap 计算子元素的 flex-basis
- * - 使用 useMemo 缓存计算结果，避免不必要的重复计算
- */
-export declare const useGridStyle: (params: UseGridStyleParams) => UseGridStyleReturn;
-export default useGridStyle;

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

@@ -1,6 +0,0 @@
-/**
- * PisellBasicGrid 组件导出
- * @description 基于 Flexbox 的基础布局组件
- */
-export { PisellBasicGrid, default } from './PisellBasicGrid';
-export type { PisellBasicGridProps, DirectionType, WrapType, JustifyType, AlignType, AlignContentType, BreakpointType, ResponsiveConfig, } from './types';

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

@@ -1,221 +0,0 @@
-import type { CSSProperties, ReactNode } from 'react';
-/**
- * 排列方向类型
- * @description 控制子元素的排列方向
- */
-export declare type DirectionType = 'horizontal' | 'horizontal-reverse' | 'vertical' | 'vertical-reverse';
-/**
- * 换行类型
- * @description 控制子元素是否换行
- */
-export declare type WrapType = 'nowrap' | 'wrap' | 'wrap-reverse';
-/**
- * 主轴对齐类型
- * @description 控制子元素在主轴上的对齐方式
- */
-export declare type JustifyType = 'start' | 'end' | 'center' | 'between' | 'around' | 'evenly';
-/**
- * 交叉轴对齐类型
- * @description 控制子元素在交叉轴上的对齐方式
- */
-export declare type AlignType = 'start' | 'end' | 'center' | 'stretch' | 'baseline';
-/**
- * 多行对齐类型
- * @description 控制多行时行与行之间的对齐方式
- */
-export declare type AlignContentType = 'start' | 'end' | 'center' | 'between' | 'around' | 'stretch';
-/**
- * 响应式断点类型
- * @description 响应式配置的断点名称
- */
-export declare type BreakpointType = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
-/**
- * 响应式配置类型（预留）
- * @description 用于配置不同断点下的布局属性
- */
-export interface ResponsiveConfig {
-    /** 一行显示的元素个数 */
-    columns?: number;
-    /** 间距 */
-    gap?: number | string;
-    /** 排列方向 */
-    direction?: DirectionType;
-}
-/**
- * PisellBasicGrid 组件 Props
- * @template T - 数据源项的类型
- * @description 基于 Flexbox 的基础布局组件属性定义
- */
-export interface PisellBasicGridProps<T = any> {
-    /**
-     * 子元素
-     * @description 当未传入 dataSource 时使用
-     */
-    children?: ReactNode;
-    /**
-     * 自定义类名
-     * @description 添加到容器元素的额外类名
-     */
-    className?: string;
-    /**
-     * 自定义样式
-     * @description 支持所有 CSS 属性，会与组件计算的样式合并
-     */
-    style?: CSSProperties;
-    /**
-     * 排列方向
-     * @default 'horizontal'
-     * @description
-     * - horizontal: 横向排列
-     * - horizontal-reverse: 横向反向排列
-     * - vertical: 竖向排列
-     * - vertical-reverse: 竖向反向排列
-     */
-    direction?: DirectionType;
-    /**
-     * 换行控制
-     * @default 'nowrap'
-     * @description
-     * - nowrap: 不换行
-     * - wrap: 换行
-     * - wrap-reverse: 反向换行
-     */
-    wrap?: WrapType;
-    /**
-     * 一行显示的元素个数
-     * @description 设置后子元素宽度为 calc((100% - gap * (N-1)) / N)
-     * @note 优先级高于 equalWidth
-     */
-    columns?: number;
-    /**
-     * 是否等分容器宽度
-     * @default false
-     * @description 设置为 true 时，子元素会平均分配容器宽度 (flex: 1)
-     * @note 当设置了 columns 时，此属性无效
-     */
-    equalWidth?: boolean;
-    /**
-     * 间距（统一设置行列间距）
-     * @description 数字类型默认单位为 px，也可传入带单位的字符串
-     * @example gap={16} 或 gap="1rem"
-     */
-    gap?: number | string;
-    /**
-     * 行间距
-     * @description 优先级高于 gap
-     */
-    rowGap?: number | string;
-    /**
-     * 列间距
-     * @description 优先级高于 gap
-     */
-    columnGap?: number | string;
-    /**
-     * 主轴对齐方式
-     * @default 'start'
-     * @description
-     * - start: 起始对齐
-     * - end: 末尾对齐
-     * - center: 居中对齐
-     * - between: 两端对齐
-     * - around: 等间距对齐
-     * - evenly: 均匀分布
-     */
-    justify?: JustifyType;
-    /**
-     * 交叉轴对齐方式
-     * @default 'stretch'
-     * @description
-     * - start: 顶部对齐
-     * - end: 底部对齐
-     * - center: 居中对齐
-     * - stretch: 拉伸填充
-     * - baseline: 基线对齐
-     */
-    align?: AlignType;
-    /**
-     * 多行对齐方式
-     * @default 'stretch'
-     * @description 当存在多行时，控制行与行之间的对齐方式
-     * - start: 顶部对齐
-     * - end: 底部对齐
-     * - center: 居中对齐
-     * - between: 两端对齐
-     * - around: 等间距对齐
-     * - stretch: 拉伸填充
-     */
-    alignContent?: AlignContentType;
-    /**
-     * 响应式配置（预留）
-     * @description 当前版本暂不实现，后续版本迭代
-     */
-    responsive?: Partial<Record<BreakpointType, ResponsiveConfig>>;
-    /**
-     * 数据源数组
-     * @description
-     * - 当传入 dataSource 时，组件内部会自动循环渲染
-     * - dataSource 为 undefined 时，渲染 children
-     * - dataSource 为空数组时，不渲染任何内容
-     */
-    dataSource?: T[];
-    /**
-     * 渲染函数
-     * @param item - 当前数据项
-     * @param index - 当前索引
-     * @returns ReactNode
-     * @description 用于自定义每个数据项的渲染内容
-     */
-    renderItem?: (item: T, index: number) => ReactNode;
-    /**
-     * 指定每项的唯一 key
-     * @description
-     * - 传入 string 时，作为数据项的属性名获取 key
-     * - 传入函数时，通过函数返回 key
-     * - 不传时，默认使用 index 作为 key
-     * @example rowKey="id" 或 rowKey={(item, index) => `item-${item.id}`}
-     */
-    rowKey?: string | ((item: T, index: number) => string);
-    /**
-     * 前置插槽
-     * @description 在数据源渲染之前渲染
-     */
-    startSlot?: ReactNode;
-    /**
-     * 后置插槽
-     * @description 在数据源渲染之后渲染
-     */
-    endSlot?: ReactNode;
-}
-/**
- * 容器样式配置
- * @description useGridStyle Hook 返回的容器样式类型
- */
-export interface ContainerStyle extends CSSProperties {
-    display: 'flex';
-    flexDirection: CSSProperties['flexDirection'];
-    flexWrap: CSSProperties['flexWrap'];
-    justifyContent: CSSProperties['justifyContent'];
-    alignItems: CSSProperties['alignItems'];
-    alignContent?: CSSProperties['alignContent'];
-    gap?: CSSProperties['gap'];
-    rowGap?: CSSProperties['rowGap'];
-    columnGap?: CSSProperties['columnGap'];
-}
-/**
- * 子元素样式配置
- * @description useGridStyle Hook 返回的子元素样式类型
- */
-export interface ItemStyle extends CSSProperties {
-    flexBasis?: CSSProperties['flexBasis'];
-    flexGrow?: CSSProperties['flexGrow'];
-    flexShrink?: CSSProperties['flexShrink'];
-}
-/**
- * useGridStyle Hook 返回值类型
- */
-export interface UseGridStyleReturn {
-    /** 容器样式 */
-    containerStyle: ContainerStyle;
-    /** 子元素样式 */
-    itemStyle: ItemStyle;
-}

package/es/components/PisellBasicGrid/utils/index.d.ts

@@ -1,63 +0,0 @@
-import type { DirectionType, WrapType, JustifyType, AlignType, AlignContentType } from '../types';
-/**
- * 将间距值转换为 CSS 值
- * @param value - 间距值，可以是数字或字符串
- * @returns CSS 间距值字符串
- * @example
- * normalizeGap(16) // '16px'
- * normalizeGap('1rem') // '1rem'
- * normalizeGap(undefined) // undefined
- */
-export declare const normalizeGap: (value: number | string | undefined) => string | undefined;
-/**
- * 计算 flex-basis 值，考虑 gap 影响
- * @param columns - 一行显示的元素个数
- * @param gap - 间距值
- * @returns flex-basis CSS 值
- * @description 公式：calc((100% - gap * (N-1)) / N)
- * @example
- * calculateFlexBasis(4, 16) // 'calc((100% - 16px * 3) / 4)'
- * calculateFlexBasis(3, '1rem') // 'calc((100% - 1rem * 2) / 3)'
- */
-export declare const calculateFlexBasis: (columns: number, gap?: number | string) => string;
-/**
- * 获取数据项的唯一 key
- * @param item - 数据项
- * @param index - 索引
- * @param rowKey - rowKey 配置
- * @returns 唯一 key 字符串
- * @example
- * getRowKey({ id: 1 }, 0, 'id') // '1'
- * getRowKey({ id: 1 }, 0, (item, index) => `item-${item.id}`) // 'item-1'
- * getRowKey({ id: 1 }, 0) // '0'
- */
-export declare const getRowKey: <T>(item: T, index: number, rowKey?: string | ((item: T, index: number) => string) | undefined) => string;
-/**
- * flex-direction 映射表
- * @description 将 direction 属性值映射为 CSS flex-direction 值
- */
-export declare const DIRECTION_MAP: Record<DirectionType, 'row' | 'row-reverse' | 'column' | 'column-reverse'>;
-/**
- * flex-wrap 映射表
- * @description 将 wrap 属性值映射为 CSS flex-wrap 值
- */
-export declare const WRAP_MAP: Record<WrapType, 'nowrap' | 'wrap' | 'wrap-reverse'>;
-/**
- * justify-content 映射表
- * @description 将 justify 属性值映射为 CSS justify-content 值
- */
-export declare const JUSTIFY_MAP: Record<JustifyType, 'flex-start' | 'flex-end' | 'center' | 'space-between' | 'space-around' | 'space-evenly'>;
-/**
- * align-items 映射表
- * @description 将 align 属性值映射为 CSS align-items 值
- */
-export declare const ALIGN_MAP: Record<AlignType, 'flex-start' | 'flex-end' | 'center' | 'stretch' | 'baseline'>;
-/**
- * align-content 映射表
- * @description 将 alignContent 属性值映射为 CSS align-content 值
- */
-export declare const ALIGN_CONTENT_MAP: Record<AlignContentType, 'flex-start' | 'flex-end' | 'center' | 'space-between' | 'space-around' | 'stretch'>;
-/**
- * 组件样式前缀
- */
-export declare const COMPONENT_PREFIX = "pisell-basic-grid";