@seakoi/native-ui 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 本文档记录了项目的所有重要变更。
 
+## [1.1.1](https://gitlab.seakoi.net/digiziting_client/native-ui/compare/@seakoi/native-ui@1.1.0...@seakoi/native-ui@1.1.1) (2026-02-28)
+
+
+### ♻️ Code Refactoring
+
+* **carousel:** ai review ([](https://gitlab.seakoi.net/digiziting_client/native-ui/commit/277f83a5f92a222f8ada96cc59db031f5929ec4b))
+* **carousel:** 状态管理代码组织方式优化 ([](https://gitlab.seakoi.net/digiziting_client/native-ui/commit/6788c60538c314012edd5d3930e01ee146ebd7f8))
+
+
+### 🐛 Bug Fixes
+
+* **carousel:** ai review 修改 ([](https://gitlab.seakoi.net/digiziting_client/native-ui/commit/68fdf77ff6f617da6e18af50a581779ad746b9d1))
+* **radio:** 为 iconRender 类型定义添加参数名 ([](https://gitlab.seakoi.net/digiziting_client/native-ui/commit/efaabcf334bdf65786bb906926e94e12318198dc))
+* 修复 PickerView 中 handlers 依赖项错误 ([](https://gitlab.seakoi.net/digiziting_client/native-ui/commit/a05002d71566e5e88de8eb22f843fefa005ff25d))
+* **native-ui:** 修复组件库类型文件丢失 ([](https://gitlab.seakoi.net/digiziting_client/native-ui/commit/2cf56a7e799c718aa7d9eb9e045edf80e2e5b33e))
+
 ## 1.1.0 (2026-02-26)
 
 * Merge branch 'dev' into 'release' ([3a7e26b](https://gitlab.seakoi.net/digiziting_client/native-ui/commit/3a7e26b))

package/dist/commonjs/components/base/address-picker/address-picker.js

@@ -4,195 +4,79 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.AddressPicker = void 0;
-var _svgIcons = require("@seakoi/svg-icons");
 var _ahooks = require("ahooks");
 var _react = _interopRequireWildcard(require("react"));
 var _reactNative = require("react-native");
-var _reactNativeSafeAreaContext = require("react-native-safe-area-context");
 var _index = require("./../index.js");
-var _index2 = require("../../../native-provider/index.js");
+var _index2 = require("../address-picker-view/index.js");
+var _utils = require("../address-picker-view/utils.js");
 var _index3 = require("./style/index.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
-const ADDRESS_PICKER_CONFIG = {
-  province: {
-    depth: 1,
-    title: '请选择省'
-  },
-  city: {
-    depth: 2,
-    title: '请选择省市'
-  },
-  district: {
-    depth: 3,
-    title: '请选择省市区'
-  },
-  street: {
-    depth: 4,
-    title: '请选择省市区、街道'
-  }
-};
 const AddressPicker = props => {
   const {
-    confirmText = '确定',
-    cancelText = '取消',
-    onCancel,
-    onConfirm,
+    placeholder = '请选择',
+    disabled = false,
+    style,
+    children,
     columns,
-    itemHeight = 40,
-    selectType = 'district',
-    title,
+    onConfirm,
     ...restProps
   } = props;
-  const theme = (0, _index2.useTheme)();
-  const defaultTitle = ADDRESS_PICKER_CONFIG[selectType].title;
-  const finalTitle = title ?? defaultTitle;
   const styles = (0, _index3.useAddressPickerStyles)();
 
-  /** 管理已确认的值（与父组件同步） 受控与非受控*/
-  const [value, onChange] = (0, _ahooks.useControllableValue)(props, {
+  // 使用 ahooks 管理受控/非受控 value
+  const [value, setValue] = (0, _ahooks.useControllableValue)(props, {
     defaultValue: []
   });
+  const [visible, setVisible] = (0, _react.useState)(false);
 
-  /** 管理选择器的值（内部状态*/
-  const [pickerValue, setPickerValue] = (0, _react.useState)(value || []);
-  /** 管理上一次确认的值（用于判断是否需要更新内部状态） */
-  const [prevValue, setPrevValue] = (0, _react.useState)(value);
-  if (value !== prevValue) {
-    setPrevValue(value);
-    setPickerValue(value || []);
-  }
-  /**
-   * @param v 选择器的值
-   * @description 当选择器的值发生变化时，更新内部状态
-   * @returns void
-   *  */
-  const handlePickerChange = (0, _ahooks.useMemoizedFn)(v => {
-    console.log('选择的数据', v);
-    setPickerValue(v);
+  // 计算显示文本
+  const displayText = (0, _react.useMemo)(() => {
+    if (!value || value.length === 0) return '';
+    const options = (0, _utils.getSelectedOptions)(columns, value);
+    // 如果找到了对应的选项，显示 label；否则（可能是初次加载数据还没到），暂不显示或显示 value
+    if (options.length === 0) return '';
+    return options.map(option => option.label).join(' / ');
+  }, [value, columns]);
+  const handleOpen = (0, _ahooks.useMemoizedFn)(() => {
+    setVisible(true);
   });
-  /**
-   * @description 确认选择
-   * @returns void
-   * */
-  const handleConfirm = (0, _ahooks.useMemoizedFn)(() => {
-    const getSelectedOptions = (cols, vals) => {
-      const options = [];
-      let currentCols = cols;
-      for (const val of vals) {
-        if (!currentCols) {
-          break;
-        }
-        const target = currentCols.find(col => col.value === val);
-        if (target) {
-          options.push(target);
-          currentCols = target.children;
-        } else {
-          break;
-        }
-      }
-      return options;
-    };
-    const options = getSelectedOptions(columns, pickerValue);
-    onChange(pickerValue, options);
-    onConfirm?.(pickerValue, options);
+  const handleClose = (0, _ahooks.useMemoizedFn)(() => {
+    setVisible(false);
   });
-  /**
-   * @description 取消选择
-   * @returns void
-   * */
-  const handleCancel = (0, _ahooks.useMemoizedFn)(() => {
-    setPickerValue(value || []);
-    onCancel?.();
+  const handleConfirm = (0, _ahooks.useMemoizedFn)((vals, options) => {
+    setValue(vals);
+    setVisible(false);
+    onConfirm?.(vals, options);
   });
-
-  /**
-   * @description 剪裁列
-   * @param columns 列
-   * @param selectType 选择类型
-   * @returns 剪裁后的列
-   * */
-  const prunedColumns = (0, _react.useMemo)(() => {
-    const depth = ADDRESS_PICKER_CONFIG[selectType].depth || 3;
-    const prune = (cols, currentDepth) => {
-      if (!cols) {
-        return [];
-      }
-      if (currentDepth >= depth) {
-        return cols.map(col => {
-          /** 剪裁列，移除子项 */
-          const {
-            children,
-            ...rest
-          } = col;
-          return rest;
-        });
-      }
-      /** 递归剪裁子项 */
-      return cols.map(col => {
-        const option = col;
-        if (option.children) {
-          return {
-            ...option,
-            children: prune(option.children, currentDepth + 1)
-          };
-        }
-        return option;
-      });
-    };
-    return prune(columns, 1);
-  }, [columns, selectType]);
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
-    style: styles.container,
-    children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNativeSafeAreaContext.SafeAreaView, {
-      edges: ['bottom', 'left', 'right'],
-      children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
-        style: styles.header,
-        children: [/*#__PURE__*/_react.default.isValidElement(finalTitle) ? finalTitle : /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.Text, {
-          style: styles.title,
-          children: finalTitle
-        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
-          onPress: handleCancel,
-          style: styles.closeIcon,
-          hitSlop: {
-            top: 10,
-            bottom: 10,
-            left: 10,
-            right: 10
-          },
-          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_svgIcons.CloseOutlined, {
-            size: 20,
-            color: theme.palette.fontGray3
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_index.PickerTrigger, {
+      displayText: displayText,
+      placeholder: placeholder,
+      disabled: disabled,
+      style: style,
+      onPress: handleOpen,
+      children: children
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.Portal, {
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.Modal, {
+        visible: visible,
+        position: "bottom",
+        contentHeight: "50%",
+        onClose: handleClose,
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+          style: styles.container,
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_index2.AddressPickerView, {
+            ...restProps,
+            columns: columns,
+            value: value,
+            onConfirm: handleConfirm,
+            onCancel: handleClose,
+            onClose: handleClose
           })
-        })]
-      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
-        style: styles.pickerContainer,
-        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.PickerView, {
-          ...restProps,
-          columns: prunedColumns,
-          value: pickerValue,
-          onChange: handlePickerChange,
-          itemHeight: itemHeight
         })
-      }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
-        style: styles.footer,
-        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_index.Button, {
-          text: cancelText,
-          variant: "base",
-          theme: "secondary",
-          size: "large",
-          onPress: handleCancel,
-          buttonStyle: styles.button
-        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.Button, {
-          text: confirmText,
-          variant: "base",
-          theme: "primary",
-          size: "large",
-          onPress: handleConfirm,
-          buttonStyle: styles.button
-        })]
-      })]
-    })
+      })
+    })]
   });
 };
 exports.AddressPicker = AddressPicker;

package/dist/commonjs/components/base/address-picker/style/index.js

@@ -5,55 +5,8 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.useAddressPickerStyles = void 0;
 var _index = require("../../../../native-provider/index.js");
-const useAddressPickerStyles = exports.useAddressPickerStyles = (0, _index.createThemedStyles)(theme => ({
+const useAddressPickerStyles = exports.useAddressPickerStyles = (0, _index.createThemedStyles)(() => ({
   container: {
-    backgroundColor: theme.palette.white,
-    borderTopLeftRadius: theme.roundness.lg,
-    borderTopRightRadius: theme.roundness.lg,
-    overflow: 'hidden'
-  },
-  header: {
-    flexDirection: 'row',
-    alignItems: 'center',
-    justifyContent: 'space-between',
-    paddingHorizontal: theme.spacing.lg,
-    paddingVertical: theme.spacing.md,
-    borderBottomWidth: 1,
-    borderBottomColor: theme.palette.gray1 // Verify palette color
-  },
-  title: {
-    fontSize: 16,
-    fontWeight: '600',
-    color: theme.palette.fontGray1
-  },
-  closeIcon: {
-    padding: 4
-  },
-  pickerContainer: {},
-  footer: {
-    flexDirection: 'row',
-    padding: theme.spacing.lg,
-    gap: theme.spacing.md,
-    borderTopWidth: 1,
-    borderTopColor: theme.palette.gray1
-  },
-  button: {
     flex: 1
-  },
-  columnHeaderContainer: {
-    flexDirection: 'row',
-    borderBottomWidth: 1,
-    borderBottomColor: theme.palette.gray1,
-    backgroundColor: theme.palette.gray1
-  },
-  columnHeader: {
-    flex: 1,
-    alignItems: 'center',
-    justifyContent: 'center',
-    paddingVertical: 8
-  },
-  columnHeaderText: {
-    fontSize: 12,
-    color: theme.palette.fontGray2
   }
 }));

package/dist/commonjs/components/base/address-picker-view/address-picker-view.js

@@ -0,0 +1,197 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AddressPickerView = void 0;
+var _svgIcons = require("@seakoi/svg-icons");
+var _ahooks = require("ahooks");
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _reactNativeSafeAreaContext = require("react-native-safe-area-context");
+var _index = require("./../index.js");
+var _index2 = require("../../../native-provider/index.js");
+var _index3 = require("./style/index.js");
+var _utils = require("./utils.js");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+const HIT_SLOP = {
+  top: 10,
+  bottom: 10,
+  left: 10,
+  right: 10
+};
+const ADDRESS_PICKER_CONFIG = {
+  province: {
+    depth: 1,
+    title: '请选择省'
+  },
+  city: {
+    depth: 2,
+    title: '请选择省市'
+  },
+  district: {
+    depth: 3,
+    title: '请选择省市区'
+  },
+  street: {
+    depth: 4,
+    title: '请选择省市区、街道'
+  }
+};
+const AddressPickerView = props => {
+  const {
+    confirmText = '确定',
+    cancelText = '取消',
+    onCancel,
+    onConfirm,
+    columns,
+    selectType = 'district',
+    title,
+    onClose,
+    style,
+    ...restProps
+  } = props;
+  const theme = (0, _index2.useTheme)();
+  const defaultTitle = ADDRESS_PICKER_CONFIG[selectType].title;
+  const finalTitle = title ?? defaultTitle;
+  const visibleItemCount = 5;
+  const itemHeight = 42;
+  const styles = (0, _index3.useAddressPickerStyles)({
+    height: itemHeight * visibleItemCount
+  });
+
+  /** 管理已确认的值（与父组件同步） 受控与非受控*/
+  const [value, onChange] = (0, _ahooks.useControllableValue)(props, {
+    defaultValue: []
+  });
+
+  /** 管理选择器的值（内部状态*/
+  const [pickerValue, setPickerValue] = (0, _react.useState)(value || []);
+  /** 管理上一次确认的值（用于判断是否需要更新内部状态） */
+  const [prevValue, setPrevValue] = (0, _react.useState)(value);
+  if (value !== prevValue) {
+    setPrevValue(value);
+    setPickerValue(value || []);
+  }
+
+  /**
+   * @param v 选择器的值
+   * @description 当选择器的值发生变化时，更新内部状态
+   * @returns void
+   *  */
+  const handlePickerChange = (0, _ahooks.useMemoizedFn)(v => {
+    setPickerValue(v);
+  });
+  /**
+   * @description 确认选择
+   * @returns void
+   * */
+  const handleConfirm = (0, _ahooks.useMemoizedFn)(() => {
+    const options = (0, _utils.getSelectedOptions)(columns, pickerValue);
+    onChange(pickerValue, options);
+    onConfirm?.(pickerValue, options);
+  });
+  /**
+   * @description 取消选择
+   * @returns void
+   * */
+  const handleCancel = (0, _ahooks.useMemoizedFn)(() => {
+    setPickerValue(value || []);
+    onCancel?.();
+  });
+  const handleClose = (0, _ahooks.useMemoizedFn)(() => {
+    onClose?.();
+  });
+
+  /**
+   * @description 剪裁列
+   * @param columns 列
+   * @param selectType 选择类型
+   * @returns 剪裁后的列
+   * */
+  const prunedColumns = (0, _react.useMemo)(() => {
+    const depth = ADDRESS_PICKER_CONFIG[selectType].depth || 3;
+    const prune = (cols, currentDepth) => {
+      if (!cols) {
+        return [];
+      }
+      if (currentDepth >= depth) {
+        return cols.map(col => {
+          /** 剪裁列，移除子项 */
+          if (typeof col === 'object' && col !== null && !Array.isArray(col) && 'children' in col) {
+            const {
+              children,
+              ...rest
+            } = col;
+            return rest;
+          }
+          return col;
+        });
+      }
+      /** 递归剪裁子项 */
+      return cols.map(col => {
+        if (typeof col === 'object' && col !== null && !Array.isArray(col) && 'children' in col) {
+          const option = col;
+          if (option.children) {
+            return {
+              ...option,
+              children: prune(option.children, currentDepth + 1)
+            };
+          }
+          return option;
+        }
+        return col;
+      });
+    };
+    return prune(columns, 1);
+  }, [columns, selectType]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+    style: [styles.container, style],
+    children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNativeSafeAreaContext.SafeAreaView, {
+      edges: ['bottom', 'left', 'right'],
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+        style: styles.header,
+        children: [/*#__PURE__*/_react.default.isValidElement(finalTitle) ? finalTitle : /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.Text, {
+          style: styles.title,
+          children: finalTitle
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
+          onPress: handleClose,
+          style: styles.closeIcon,
+          hitSlop: HIT_SLOP,
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_svgIcons.CloseOutlined, {
+            size: 20,
+            color: theme.palette.fontGray3
+          })
+        })]
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+        style: styles.pickerContainer,
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.PickerView, {
+          ...restProps,
+          columns: prunedColumns,
+          value: pickerValue,
+          onChange: handlePickerChange,
+          itemHeight: itemHeight
+        })
+      }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+        style: styles.footer,
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_index.Button, {
+          text: cancelText,
+          variant: "base",
+          theme: "secondary",
+          size: "large",
+          onPress: handleCancel,
+          buttonStyle: styles.button
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.Button, {
+          text: confirmText,
+          variant: "base",
+          theme: "primary",
+          size: "large",
+          onPress: handleConfirm,
+          buttonStyle: styles.button
+        })]
+      })]
+    })
+  });
+};
+exports.AddressPickerView = AddressPickerView;

package/dist/commonjs/components/base/address-picker-view/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _addressPickerView = require("./address-picker-view.js");
+Object.keys(_addressPickerView).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _addressPickerView[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _addressPickerView[key];
+    }
+  });
+});

package/dist/commonjs/components/base/address-picker-view/style/index.js

@@ -0,0 +1,63 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useAddressPickerStyles = void 0;
+var _index = require("../../../../native-provider/index.js");
+const useAddressPickerStyles = exports.useAddressPickerStyles = (0, _index.createThemedStyles)((theme, options) => ({
+  container: {
+    backgroundColor: theme.palette.white,
+    borderTopLeftRadius: theme.roundness.lg,
+    borderTopRightRadius: theme.roundness.lg,
+    overflow: 'hidden'
+  },
+  header: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    justifyContent: 'space-between',
+    paddingHorizontal: theme.spacing.lg,
+    paddingVertical: theme.spacing.md,
+    borderBottomWidth: 1,
+    borderBottomColor: theme.palette.gray1
+  },
+  title: {
+    fontSize: 16,
+    fontWeight: '600',
+    color: theme.palette.fontGray1
+  },
+  closeIcon: {
+    padding: 4
+  },
+  pickerContainer: {
+    height: options?.height ?? 200,
+    // 默认高度，确保 Picker 可见
+    backgroundColor: theme.palette.gray1 // 可选：背景色
+  },
+  footer: {
+    flexDirection: 'row',
+    padding: theme.spacing.lg,
+    gap: theme.spacing.md,
+    borderTopWidth: 1,
+    borderTopColor: theme.palette.gray1
+  },
+  button: {
+    flex: 1
+  },
+  columnHeaderContainer: {
+    flexDirection: 'row',
+    borderBottomWidth: 1,
+    borderBottomColor: theme.palette.gray1,
+    backgroundColor: theme.palette.gray1
+  },
+  columnHeader: {
+    flex: 1,
+    alignItems: 'center',
+    justifyContent: 'center',
+    paddingVertical: 8
+  },
+  columnHeaderText: {
+    fontSize: 12,
+    color: theme.palette.fontGray2
+  }
+}));

package/dist/commonjs/components/base/address-picker-view/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/commonjs/components/base/address-picker-view/utils.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getSelectedOptions = void 0;
+const getSelectedOptions = (cols, vals) => {
+  const options = [];
+  let currentCols = cols;
+  if (!vals || !currentCols) return [];
+  for (const val of vals) {
+    if (!currentCols) {
+      break;
+    }
+    const target = currentCols.find(col => col.value === val);
+    if (target) {
+      options.push(target);
+      currentCols = target.children;
+    } else {
+      break;
+    }
+  }
+  return options;
+};
+exports.getSelectedOptions = getSelectedOptions;

package/dist/commonjs/components/base/carousel/carousel-item.js

@@ -6,15 +6,39 @@ Object.defineProperty(exports, "__esModule", {
 exports.CarouselItem = void 0;
 var _reactNative = require("react-native");
 var _jsxRuntime = require("react/jsx-runtime");
+const FULL_SIZE_STYLE = {
+  height: '100%',
+  width: '100%'
+};
+
+/**
+ * 轮播项组件
+ *
+ * 用于包裹轮播图中的每一项内容，自动填充父容器的宽高。
+ *
+ * @example
+ * ```tsx
+ * <Carousel>
+ *   <Carousel.Item>
+ *     <Image source={image1} />
+ *   </Carousel.Item>
+ *   <Carousel.Item>
+ *     <Image source={image2} />
+ *   </Carousel.Item>
+ * </Carousel>
+ * ```
+ *
+ * @param props - 组件属性
+ * @param props.children - 轮播项内容
+ * @param props.style - 容器样式
+ * @returns 轮播项组件
+ */
 const CarouselItem = ({
   children,
   style
 }) => {
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
-    style: [{
-      height: '100%',
-      width: '100%'
-    }, style],
+    style: [FULL_SIZE_STYLE, style],
     children: children
   });
 };