@pisell/materials 6.3.27 → 6.3.28

package/es/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/es/components/dataSourceComponents/dataSourceSubForm/types.js

@@ -0,0 +1 @@
+export {};

package/es/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/es/components/dataSourceComponents/dataSourceTable/hooks/useTableProps.d.ts

@@ -52,9 +52,9 @@ declare const useTableProps: (props: UseTablePropsProps) => {
         show: boolean;
         title: string;
         width: number;
-        align: "left" | "right" | "center";
+        align: "center" | "left" | "right";
         fixed: false | "left" | "right";
-        type: "link" | "button";
+        type: "button" | "link";
         items: OperationItem[];
     } | undefined;
     operationContent?: {

package/es/components/dataSourceComponents/dataSourceTable/hooks/useTableQuery.d.ts

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

package/es/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/es/components/dataSourceComponents/fields/RecordListWrapper/ReadPretty.js

@@ -0,0 +1,61 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+import React from 'react';
+/**
+ * @title: RecordListWrapper 只读态
+ * @description: 低代码详情模式下展示每个 option 对应的 record 数据。
+ *   值结构: { optionValue: { field1: v1, field2: v2 } }
+ */
+var RecordListWrapperReadPretty = function RecordListWrapperReadPretty(props) {
+  var value = props.value,
+    _props$options = props.options,
+    options = _props$options === void 0 ? [] : _props$options;
+
+  /** 安全获取 Map 值 */
+  var safeValue = value && _typeof(value) === 'object' && !Array.isArray(value) ? value : {};
+  var entries = Object.entries(safeValue);
+  if (!entries.length) {
+    return /*#__PURE__*/React.createElement("span", null, "-");
+  }
+  return /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("div", {
+    style: {
+      marginBottom: 8
+    }
+  }, "Records: ", entries.length), entries.map(function (_ref) {
+    var _ref2 = _slicedToArray(_ref, 2),
+      key = _ref2[0],
+      record = _ref2[1];
+    var option = options.find(function (o) {
+      return String(o.value) === key;
+    });
+    var label = (option === null || option === void 0 ? void 0 : option.label) || key;
+    var displayLabel = _typeof(label) === 'object' ? JSON.stringify(label) : label;
+    return /*#__PURE__*/React.createElement("div", {
+      key: key,
+      style: {
+        marginBottom: 8
+      }
+    }, /*#__PURE__*/React.createElement("div", {
+      style: {
+        fontWeight: 500,
+        marginBottom: 4
+      }
+    }, displayLabel), /*#__PURE__*/React.createElement("pre", {
+      style: {
+        margin: 0,
+        padding: 8,
+        background: '#f7f8fa',
+        borderRadius: 4,
+        fontSize: 12,
+        maxHeight: 200,
+        overflow: 'auto'
+      }
+    }, JSON.stringify(record, null, 2)));
+  }));
+};
+export default RecordListWrapperReadPretty;

package/es/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/es/components/dataSourceComponents/fields/RecordListWrapper/WithMode.js

@@ -0,0 +1,176 @@
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+import React, { useEffect, useMemo, useState, useRef } from 'react';
+import { withMode } from "../../dataSourceForm/utils";
+import ReadPretty from "./ReadPretty";
+import Tabs from "../Tabs/Tabs";
+import DataSourceSubForm from "../../dataSourceSubForm";
+
+// ===================== 主组件 =====================
+
+/**
+ * @title RecordListWrapper 编辑器
+ * @description
+ *   上部为插槽区域（topSlot），通过 cloneElement 注入 options/value/onChange，默认展示 Tabs 导航。
+ *   下部委托给 DataSourceSubForm 渲染当前 activeKey 对应的子表单。
+ *   切换 tab 时通过 key={activeKey} 强制重新挂载 DataSourceSubForm，实现值自动同步。
+ *
+ *   值结构: { [optionValue]: { field1: v1, field2: v2 } }
+ */
+var RecordListWrapperBase = function RecordListWrapperBase(props) {
+  var value = props.value,
+    _onChange = props.onChange,
+    _props$options = props.options,
+    options = _props$options === void 0 ? [] : _props$options,
+    children = props.children,
+    xRecordSchema = props.xRecordSchema,
+    topSlot = props.topSlot,
+    slot = props.slot,
+    renderMode = props.renderMode,
+    __designMode = props.__designMode,
+    defaultValue = props.defaultValue;
+  var isMounted = useRef(false);
+  var dataSourceSubFormRef = useRef(null);
+
+  /** value 是 Map: { optionValue: { field1: v1 } } */
+  var safeValue = useMemo(function () {
+    if (value && _typeof(value) === 'object' && !Array.isArray(value)) {
+      return value;
+    }
+    return {};
+  }, [value]);
+
+  /**
+   * 当前选中的 option key
+   * 优先级：defaultActiveKey > options[0].value
+   */
+  var _useState = useState(function () {
+      var _options$;
+      if (defaultValue != null) return String(defaultValue);
+      return String(((_options$ = options[0]) === null || _options$ === void 0 ? void 0 : _options$.value) || '');
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    activeKey = _useState2[0],
+    setActiveKey = _useState2[1];
+
+  /** defaultValue 变化时同步更新 activeKey */
+  useEffect(function () {
+    if (defaultValue != null) {
+      setActiveKey(String(defaultValue));
+    }
+  }, [defaultValue]);
+
+  /** options 变化时校正 activeKey（仅在无 defaultValue 且当前 key 不合法时回退） */
+  useEffect(function () {
+    if (options.length && !options.find(function (o) {
+      return String(o.value) === activeKey;
+    })) {
+      var _options$2;
+      setActiveKey(defaultValue != null ? String(defaultValue) : String(((_options$2 = options[0]) === null || _options$2 === void 0 ? void 0 : _options$2.value) || ''));
+    }
+  }, [options]);
+
+  /**
+   * 初始化所有 option 的值：
+   * 以字段 schema 中的 uiSchema.default 作为每个 option 的默认值模板，
+   * 已有值（safeValue）优先覆盖，确保已填写的数据不丢失。
+   * 仅执行一次（由 isMounted 守卫），避免重复触发 onChange。
+   */
+  useEffect(function () {
+    if (isMounted.current) {
+      return;
+    }
+    if ((options === null || options === void 0 ? void 0 : options.length) > 0 && dataSourceSubFormRef.current) {
+      var _dataSourceSubFormRef, _dataSourceSubFormRef2, _dataSourceSubFormRef3;
+      var defaultValues = (_dataSourceSubFormRef = (_dataSourceSubFormRef2 = (_dataSourceSubFormRef3 = dataSourceSubFormRef.current).getFieldsValue) === null || _dataSourceSubFormRef2 === void 0 ? void 0 : _dataSourceSubFormRef2.call(_dataSourceSubFormRef3)) !== null && _dataSourceSubFormRef !== void 0 ? _dataSourceSubFormRef : {};
+      var completeValue = options.reduce(function (acc, option) {
+        if (option.value === null || option.value === undefined) return acc;
+        acc[String(option.value)] = _objectSpread(_objectSpread({}, defaultValues), safeValue[String(option.value)] || {});
+        return acc;
+      }, {});
+      _onChange === null || _onChange === void 0 || _onChange(completeValue);
+      isMounted.current = true;
+    }
+  }, [options, safeValue]);
+
+  // ---- 上部: 插槽区域 ----
+  var renderTopSlot = function renderTopSlot() {
+    var slotElement = topSlot || slot;
+    if (slotElement && /*#__PURE__*/React.isValidElement(slotElement)) {
+      // cloneElement 注入 options / value(activeKey) / onChange(setActiveKey)
+      return /*#__PURE__*/React.cloneElement(slotElement, {
+        options: options,
+        value: activeKey,
+        onChange: setActiveKey
+      });
+    }
+
+    // TabOption.label 为必填，RecordListWrapperOption.label 可选，fallback 到 value
+    var tabOptions = options.map(function (o) {
+      var _o$label;
+      return _objectSpread(_objectSpread({}, o), {}, {
+        label: (_o$label = o.label) !== null && _o$label !== void 0 ? _o$label : String(o.value)
+      });
+    });
+    if (!options.length) {
+      return /*#__PURE__*/React.createElement("div", {
+        style: {
+          color: '#999',
+          fontSize: 16
+        }
+      }, "\u6682\u65E0\u9009\u9879\uFF0C\u8BF7\u914D\u7F6E\u6570\u636E\u6E90\u3002");
+    }
+    return /*#__PURE__*/React.createElement(Tabs, {
+      options: tabOptions,
+      value: activeKey,
+      onChange: function onChange(key) {
+        return setActiveKey(String(key));
+      },
+      disabled: renderMode === 'disabled'
+    });
+  };
+
+  // ---- 下部: 委托给 DataSourceSubForm ----
+  var renderBottom = function renderBottom() {
+    return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(DataSourceSubForm, {
+      activeKey: activeKey,
+      value: safeValue[activeKey],
+      onChange: function onChange(recordValue) {
+        return _onChange === null || _onChange === void 0 ? void 0 : _onChange(_objectSpread(_objectSpread({}, safeValue || {}), {}, _defineProperty({}, activeKey, recordValue || {})));
+      },
+      xRecordSchema: xRecordSchema,
+      renderMode: renderMode,
+      __designMode: __designMode
+    }, children), /*#__PURE__*/React.createElement("div", {
+      style: {
+        width: '100%',
+        height: 0,
+        visibility: 'hidden',
+        overflow: 'hidden'
+      }
+    }, /*#__PURE__*/React.createElement(DataSourceSubForm, {
+      key: "record-list-wrapper-default-value-form",
+      ref: dataSourceSubFormRef,
+      xRecordSchema: xRecordSchema,
+      renderMode: renderMode,
+      __designMode: __designMode
+    }, children)));
+  };
+  return /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("div", {
+    style: {
+      marginBottom: 12
+    }
+  }, renderTopSlot()), renderBottom());
+};
+var RecordListWrapperWithMode = withMode(RecordListWrapperBase, ReadPretty);
+export default RecordListWrapperWithMode;

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

@@ -0,0 +1,12 @@
+import React from 'react';
+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;
+}) => React.JSX.Element;
+export default RecordListWrapperWithDataSource;

package/es/components/dataSourceComponents/fields/RecordListWrapper/index.js

@@ -0,0 +1,11 @@
+import { withDataSource, withFormItem, withOptions } from "../../dataSourceForm/utils";
+import RecordListWrapperWithMode from "./WithMode";
+
+/**
+ * @title: RecordListWrapper 字段封装
+ * @description: 复用 DataSourceForm 的 FormItem/DataSource/Options 三层能力，保持与 Select 一致的数据源接入方式。
+ */
+var RecordListWrapperWithFormItem = withFormItem(RecordListWrapperWithMode);
+var RecordListWrapperWithOptions = withOptions(RecordListWrapperWithFormItem);
+var RecordListWrapperWithDataSource = withDataSource(RecordListWrapperWithOptions);
+export default RecordListWrapperWithDataSource;

package/es/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/es/components/dataSourceComponents/fields/RecordListWrapper/type.js

@@ -0,0 +1 @@
+export {};

package/es/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/es/components/dataSourceComponents/fields/Tabs/ReadPretty.js

@@ -0,0 +1,16 @@
+import useValueMap from "../../hooks/useValueMap";
+import { renderValueWithMap } from "../../dataSourceForm/utils";
+
+/**
+ * Tabs 只读展示组件
+ *
+ * @description 在 view / tableView 模式下展示选中的标签名称文本。
+ */
+var TabsReadPretty = function TabsReadPretty(_ref) {
+  var value = _ref.value,
+    options = _ref.options,
+    renderMode = _ref.renderMode;
+  var valueMap = useValueMap(options || []);
+  return renderValueWithMap(value, valueMap, renderMode);
+};
+export default TabsReadPretty;

package/es/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/es/components/dataSourceComponents/fields/Tabs/Tabs.js

@@ -0,0 +1,93 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import React, { useMemo } from 'react';
+import classNames from 'classnames';
+import "./Tabs.less";
+
+/**
+ * Tabs 胶囊风格选项卡组件
+ *
+ * @description 提供类似 Segmented 控件的胶囊风格选项卡，支持受控与非受控模式。
+ * 用于表单中替代 Radio.Group，展示更为直观的标签页切换交互。
+ *
+ * @example
+ * ```tsx
+ * <Tabs
+ *   value={current}
+ *   options={[
+ *     { label: '校区', value: 'campus' },
+ *     { label: '场地', value: 'venue' },
+ *   ]}
+ *   onChange={(val) => setCurrent(val)}
+ * />
+ * ```
+ */
+var Tabs = function Tabs(_ref) {
+  var value = _ref.value,
+    defaultValue = _ref.defaultValue,
+    _ref$options = _ref.options,
+    options = _ref$options === void 0 ? [] : _ref$options,
+    _ref$disabled = _ref.disabled,
+    disabled = _ref$disabled === void 0 ? false : _ref$disabled,
+    onChange = _ref.onChange,
+    className = _ref.className,
+    style = _ref.style;
+  /** 内部选中值，支持受控与非受控 */
+  var _React$useState = React.useState(defaultValue),
+    _React$useState2 = _slicedToArray(_React$useState, 2),
+    internalValue = _React$useState2[0],
+    setInternalValue = _React$useState2[1];
+
+  /** 最终使用的选中值：受控优先 */
+  var selectedValue = value !== undefined ? value : internalValue;
+
+  /**
+   * 处理选项点击
+   */
+  var handleSelect = function handleSelect(option) {
+    if (disabled || option.disabled) return;
+    var newValue = option.value;
+    if (value === undefined) {
+      setInternalValue(newValue);
+    }
+    onChange === null || onChange === void 0 || onChange(newValue);
+  };
+  var tabItems = useMemo(function () {
+    return options.map(function (option) {
+      var isActive = selectedValue != null && selectedValue !== undefined && String(selectedValue) === String(option.value);
+      var isDisabled = disabled || option.disabled;
+      return /*#__PURE__*/React.createElement("div", {
+        key: option.value,
+        className: classNames('pisell-form-tabs-item', {
+          'pisell-form-tabs-item--active': isActive,
+          'pisell-form-tabs-item--disabled': isDisabled
+        }),
+        onClick: function onClick() {
+          return handleSelect(option);
+        },
+        role: "tab",
+        "aria-selected": isActive,
+        "aria-disabled": isDisabled,
+        tabIndex: isDisabled ? -1 : 0,
+        onKeyDown: function onKeyDown(e) {
+          if (e.key === 'Enter' || e.key === ' ') {
+            e.preventDefault();
+            handleSelect(option);
+          }
+        }
+      }, /*#__PURE__*/React.createElement("span", {
+        className: "pisell-form-tabs-item-label"
+      }, option.label));
+    });
+  }, [options, selectedValue, disabled]);
+  return /*#__PURE__*/React.createElement("div", {
+    className: classNames('pisell-form-tabs', className),
+    style: style,
+    role: "tablist"
+  }, tabItems);
+};
+export default Tabs;