@seakoi/native-ui 1.1.3 → 1.2.0

package/dist/module/components/base/picker-backup/picker-backup.js

@@ -0,0 +1,69 @@
+"use strict";
+
+import { useMemoizedFn } from 'ahooks';
+import React, { useCallback, useMemo, useRef, useState } from 'react';
+import { Button } from "../button/index.js";
+import { Picker } from "../picker/index.js";
+import { PickerView } from "../picker-view/index.js";
+import { findOptionsByValue } from "../picker-view/utils/picker.js";
+import { normalizeColumns } from "./utils.js";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+export const PickerBackup = ({
+  placeholder = '请选择',
+  headerTitle = '请选择',
+  formatter,
+  confirmText = '确定',
+  columns: rawColumns,
+  fieldNames,
+  ...restProps
+}) => {
+  const [draftValue, setDraftValue] = useState();
+  const committedValueRef = useRef(restProps.value ?? []);
+  const handleOpen = useCallback(() => {
+    setDraftValue(committedValueRef.current);
+  }, []);
+
+  /** 标准化列数据：将自定义字段名映射为内部标准格式 */
+  const columns = useMemo(() => normalizeColumns(rawColumns, fieldNames), [rawColumns, fieldNames]);
+
+  /** 格式化显示文案 - 根据 value 从 columns 计算 */
+  const _renderValue = useMemoizedFn(value => {
+    if (!value?.length) return;
+    const options = findOptionsByValue(value, columns);
+    if (formatter) {
+      return formatter(value, options);
+    }
+    return options.map(opt => opt?.label).filter(Boolean).join(' / ');
+  });
+  return /*#__PURE__*/_jsxs(Picker, {
+    ...restProps,
+    children: [/*#__PURE__*/_jsx(Picker.Field, {
+      placeholder: placeholder,
+      renderValue: _renderValue
+    }), /*#__PURE__*/_jsx(Picker.Content, {
+      headerTitle: headerTitle,
+      onOpen: handleOpen,
+      children: ({
+        onChange,
+        value: contextValue
+      }) => {
+        // 同步 ref：始终保持最新的已提交值
+        committedValueRef.current = contextValue ?? [];
+        return /*#__PURE__*/_jsxs(_Fragment, {
+          children: [/*#__PURE__*/_jsx(PickerView, {
+            columns: columns,
+            itemHeight: restProps.itemHeight,
+            value: draftValue,
+            onChange: setDraftValue
+          }), /*#__PURE__*/_jsx(Button, {
+            text: confirmText,
+            size: "large",
+            onPress: () => {
+              onChange?.(draftValue);
+            }
+          })]
+        });
+      }
+    })]
+  });
+};

package/dist/module/components/base/picker-backup/picker-copy.js

@@ -0,0 +1,101 @@
+"use strict";
+
+import { useControllableValue, useMemoizedFn } from 'ahooks';
+import { useMemo, useRef, useState } from 'react';
+import { Button } from "../button/index.js";
+import { Flex } from "../flex/index.js";
+import { Modal, ModalHeader } from "../modal/index.js";
+import { PickerView } from "../picker-view/index.js";
+import { findOptionsByValue, getDefaultValues } from "../picker-view/utils/picker.js";
+import { Portal } from "../portal/index.js";
+import { PickerTrigger } from "./picker-trigger.js";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+export const Picker = ({
+  placeholder = '请选择',
+  disabled = false,
+  title = '请选择',
+  formatter,
+  children,
+  style,
+  confirmText = '确定',
+  ...restProps
+}) => {
+  const [value, setValue] = useControllableValue(restProps, {
+    defaultValue: restProps.defaultValue
+  });
+  const [visible, setVisible] = useState(false);
+
+  // 内部状态用于管理滚动时的临时值
+  const [localValue, setLocalValue] = useState(restProps.value ?? restProps.defaultValue ?? []);
+
+  // 滑动时的临时 options（不用于 displayText）
+  const localOptionsRef = useRef([]);
+
+  /** 格式化显示文案 - 根据 value 从 columns 计算 */
+  const displayText = useMemo(() => {
+    if (!value?.length) return '';
+
+    // 从 columns 计算对应的 options
+    const options = findOptionsByValue(value, restProps.columns);
+    if (formatter) {
+      return formatter(value, options);
+    }
+    return options.map(opt => opt?.label).filter(Boolean).join(' / ');
+  }, [value, restProps.columns, formatter]);
+  const handleOpen = useMemoizedFn(() => {
+    // 打开时同步外部 value 到内部
+    // 如果 value 为空，使用 columns 的默认值（第一个选项）
+    const initialValue = value?.length ? value : getDefaultValues(restProps.columns);
+    setLocalValue(initialValue);
+    setVisible(true);
+  });
+  const handleClose = useMemoizedFn(() => {
+    setVisible(false);
+  });
+  const handleChange = useMemoizedFn((v, options) => {
+    setLocalValue(v);
+    localOptionsRef.current = options;
+  });
+  const handleConfirm = useMemoizedFn(() => {
+    setVisible(false);
+    setValue(localValue);
+  });
+  return /*#__PURE__*/_jsxs(_Fragment, {
+    children: [/*#__PURE__*/_jsx(PickerTrigger, {
+      displayText: displayText,
+      placeholder: placeholder,
+      disabled: disabled,
+      style: style,
+      onPress: handleOpen,
+      children: children
+    }), /*#__PURE__*/_jsx(Portal, {
+      children: /*#__PURE__*/_jsx(Modal, {
+        visible: visible,
+        position: "bottom",
+        safeAreaInsetBottom: true,
+        contentHeight: '50%',
+        children: /*#__PURE__*/_jsxs(Flex, {
+          vertical: true,
+          align: "stretch",
+          gap: 16,
+          style: {
+            flex: 1,
+            padding: 16
+          },
+          children: [/*#__PURE__*/_jsx(ModalHeader, {
+            title: title,
+            onClose: handleClose
+          }), /*#__PURE__*/_jsx(PickerView, {
+            ...restProps,
+            value: localValue,
+            onChange: handleChange
+          }), /*#__PURE__*/_jsx(Button, {
+            text: confirmText,
+            size: "large",
+            onPress: handleConfirm
+          })]
+        })
+      })
+    })]
+  });
+};

package/dist/module/components/base/{picker → picker-backup}/picker-trigger.js

@@ -4,8 +4,8 @@ import React, { cloneElement, isValidElement } from 'react';
 import { TouchableOpacity } from 'react-native';
 import { useTheme } from "../../../native-provider/index.js";
 import { Flex } from "../flex/index.js";
+import { usePickerFieldStyles } from "../picker/style/index.js";
 import { Text } from "../text/index.js";
-import { usePickerFieldStyles } from "./style/index.js";
 
 /** Picker 基础触发器 Props */
 import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
@@ -38,7 +38,7 @@ export const PickerTrigger = ({
       children: /*#__PURE__*/_jsx(Flex, {
         align: "center",
         gap: theme.spacing.sm,
-        style: [styles.content, disabled && styles.disabled, style],
+        style: [disabled && styles.disabled, style],
         children: /*#__PURE__*/React.isValidElement(displayText) ? displayText : /*#__PURE__*/_jsx(Text, {
           size: 14,
           color: displayText ? theme.palette.fontGray1 : theme.palette.fontGray3,

package/dist/module/components/base/picker-backup/style/index.js

@@ -0,0 +1,15 @@
+"use strict";
+
+import { createThemedStyles } from "../../../../native-provider/index.js";
+export const usePickerFieldStyles = createThemedStyles(theme => ({
+  container: {
+    flex: 1,
+    alignSelf: 'stretch',
+    backgroundColor: theme.palette.white,
+    paddingVertical: 12,
+    paddingHorizontal: 12
+  },
+  disabled: {
+    backgroundColor: theme.palette.blueGray2
+  }
+}));

package/dist/module/components/base/picker-backup/utils.js

@@ -0,0 +1,48 @@
+"use strict";
+
+/** 默认字段名 */
+const DEFAULT_FIELD_NAMES = {
+  label: 'label',
+  value: 'value',
+  children: 'children'
+};
+
+/**
+ * 将自定义字段名的数据标准化为内部使用的 { label, value, children } 格式
+ * 如果 fieldNames 与默认值相同，则直接返回原始数据（零开销）
+ */
+export const normalizeColumns = (columns, fieldNames) => {
+  if (!fieldNames) return columns;
+  const merged = {
+    ...DEFAULT_FIELD_NAMES,
+    ...fieldNames
+  };
+
+  // 如果所有字段名都和默认值一样，无需转换
+  if (merged.label === 'label' && merged.value === 'value' && merged.children === 'children') {
+    return columns;
+  }
+  const normalizeOption = item => {
+    const normalized = {
+      ...item
+    };
+    if (merged.label !== 'label') {
+      normalized.label = item[merged.label];
+    }
+    if (merged.value !== 'value') {
+      normalized.value = item[merged.value];
+    }
+    if (merged.children !== 'children' && item[merged.children]) {
+      normalized.children = item[merged.children].map(normalizeOption);
+    } else if (item.children) {
+      normalized.children = item.children.map(normalizeOption);
+    }
+    return normalized;
+  };
+  return columns.map(column => {
+    if (Array.isArray(column)) {
+      return column.map(normalizeOption);
+    }
+    return normalizeOption(column);
+  });
+};

package/dist/module/components/base/picker-view/picker-view-column.js

@@ -48,6 +48,21 @@ export const PickerViewColumn = /*#__PURE__*/memo(({
     }
   });
   const selectedIndex = getSelectedIndex(options.findIndex(item => item.value === value));
+
+  /**
+   * 自初始化：当 value 为空或不在 options 中时，主动上报第一个可用选项
+   * 这从根本上解决了「不滚动就拿不到值」的问题
+   */
+  useEffect(() => {
+    if (options.length === 0) return;
+    const hasValidValue = value !== undefined && value !== null && options.some(item => item.value === value);
+    if (!hasValidValue) {
+      const defaultIndex = findUsableOptionIndex(options, true, 0, false);
+      if (defaultIndex >= 0) {
+        onChange?.(options[defaultIndex]);
+      }
+    }
+  }, [options, value, onChange]);
   useEffect(() => {
     if (selectedIndex >= 0 && selectedIndex < options.length) {
       flatListRef.current?.scrollToIndex({

package/dist/module/components/base/picker-view/picker-view.js

@@ -47,8 +47,8 @@ export const PickerView = ({
   }, [dataType, columns, value]);
 
   // 保存 columnDefaultValues 到 ref，供 handleChange 使用
-  const columnDefaultValuesRef = useRef(columnDefaultValues);
-  columnDefaultValuesRef.current = columnDefaultValues;
+  // const columnDefaultValuesRef = useRef<PickerValue[]>(columnDefaultValues);
+  // columnDefaultValuesRef.current = columnDefaultValues;
 
   /** 获取容器实际高度 */
   const handleLayout = useCallback(event => {
@@ -72,7 +72,7 @@ export const PickerView = ({
       case 'multiple':
         {
           const newValues = [...value];
-          columnDefaultValuesRef.current.forEach((item, i) => {
+          columnDefaultValues.forEach((item, i) => {
             if (isNil(newValues[i])) {
               newValues[i] = item;
             }
@@ -138,7 +138,7 @@ export const PickerView = ({
         }
         if (!isControlled && !isNoDefaultValue) {
           if (dataType === 'multiple') {
-            return columnDefaultValuesRef.current[index];
+            return columnDefaultValues[index];
           }
 
           // 真的没有就默认第一个选项

package/dist/module/components/base/tag/index.js

@@ -0,0 +1,5 @@
+"use strict";
+
+import { Tag } from "./tag.js";
+export * from "./tag.js";
+export default Tag;

package/dist/module/components/base/tag/style/index.js

@@ -0,0 +1,85 @@
+"use strict";
+
+import { createThemedStyles } from "../../../../native-provider/index.js";
+export const useTagStyles = createThemedStyles((theme, props) => {
+  const {
+    themeColor = 'primary'
+  } = props;
+  const BASE_COLOR_MAP = {
+    primary: {
+      baseColor: theme.palette.brand7,
+      lightColor: theme.palette.brand1
+    },
+    danger: {
+      baseColor: theme.palette.error6,
+      lightColor: theme.palette.error1
+    },
+    default: {
+      baseColor: theme.palette.gray6,
+      lightColor: theme.palette.gray2
+    }
+  };
+  const Color = BASE_COLOR_MAP[themeColor];
+  return {
+    tag: {},
+    large: {
+      paddingHorizontal: 8,
+      paddingVertical: 4,
+      borderRadius: 4
+    },
+    medium: {
+      paddingHorizontal: 6,
+      paddingVertical: 2,
+      borderRadius: 2
+    },
+    small: {
+      paddingHorizontal: 4,
+      paddingVertical: 1.5,
+      borderRadius: 1.5
+    },
+    disabled: {
+      opacity: 0.5
+    },
+    'font-small': {
+      fontSize: 10
+    },
+    'font-medium': {
+      fontSize: 12
+    },
+    'font-large': {
+      fontSize: 14
+    },
+    filled: {
+      backgroundColor: Color.lightColor
+    },
+    'text-filled': {
+      color: Color.baseColor
+    },
+    outlined: {
+      borderColor: Color.baseColor,
+      borderWidth: 0.5
+    },
+    'text-outlined': {
+      color: Color.baseColor
+    },
+    solid: {
+      backgroundColor: Color.baseColor
+    },
+    'text-solid': {
+      color: '#fff'
+    }
+  };
+});
+export const useTagGroupStyles = createThemedStyles(() => {
+  return {
+    container: {
+      flexDirection: 'row',
+      alignItems: 'center',
+      flexWrap: 'wrap'
+    },
+    vertical: {
+      flexDirection: 'column',
+      alignItems: 'stretch'
+    }
+  };
+});

package/dist/module/components/base/tag/tag-context.js

@@ -0,0 +1,8 @@
+"use strict";
+
+import { createContext } from 'react';
+export const TagContext = /*#__PURE__*/createContext({
+  size: 'medium',
+  disabled: false
+});
+TagContext.displayName = 'TagContext';

package/dist/module/components/base/tag/tag-group.js

@@ -0,0 +1,29 @@
+"use strict";
+
+import React from 'react';
+import { View } from 'react-native';
+import { useTagGroupStyles } from "./style/index.js";
+import { TagContext } from "./tag-context.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+export const TagGroup = ({
+  children,
+  direction = 'horizontal',
+  gap = 16,
+  style,
+  size,
+  disabled
+}) => {
+  const groupStyles = useTagGroupStyles();
+  return /*#__PURE__*/_jsx(TagContext.Provider, {
+    value: {
+      size,
+      disabled
+    },
+    children: /*#__PURE__*/_jsx(View, {
+      style: [groupStyles.container, direction === 'vertical' && groupStyles.vertical, gap > 0 && {
+        gap
+      }, style],
+      children: children
+    })
+  });
+};

package/dist/module/components/base/tag/tag.js

@@ -0,0 +1,41 @@
+"use strict";
+
+import React, { use, useMemo } from 'react';
+import { Pressable } from 'react-native';
+import { Text } from "./../index.js";
+import { useTagStyles } from "./style/index.js";
+import { TagContext } from "./tag-context.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+export const Tag = ({
+  text,
+  variant = 'solid',
+  style,
+  theme = 'primary',
+  disabled: customDisabled,
+  size,
+  child,
+  textStyle,
+  onPress
+}) => {
+  const context = use(TagContext);
+  const mergedDisabled = customDisabled ?? context.disabled ?? false;
+  const mergedSize = size ?? context.size ?? 'medium';
+  const styles = useTagStyles({
+    variant,
+    themeColor: theme,
+    mergedSize
+  });
+  const tagStyle = useMemo(() => {
+    return [styles.tag, styles[variant], styles[mergedSize], style];
+  }, [mergedSize, style, variant, styles]);
+  const tagNode = /*#__PURE__*/_jsx(Pressable, {
+    style: tagStyle,
+    onPress: mergedDisabled ? undefined : onPress,
+    disabled: mergedDisabled,
+    children: child ? child : /*#__PURE__*/_jsx(Text, {
+      style: [styles[`text-${variant}`], styles[`font-${mergedSize}`], textStyle],
+      children: text
+    })
+  });
+  return tagNode;
+};

package/dist/module/components/base/tag/types.js

@@ -0,0 +1,3 @@
+"use strict";
+
+export {};

package/dist/typescript/components/base/carousel/carousel-indicator.d.ts

@@ -0,0 +1,42 @@
+import { type ViewStyle } from 'react-native';
+import type { CarouselProps } from './types';
+interface CarouselIndicatorProps {
+    /** 指示器配置（false 表示不显示，函数表示自定义渲染） */
+    indicator: CarouselProps['indicator'];
+    /** 指示器属性配置（颜色、样式） */
+    indicatorProps: CarouselProps['indicatorProps'];
+    /** 轮播项总数 */
+    total: number;
+    /** 当前激活的索引 */
+    current: number;
+    /** 激活状态的指示器颜色 */
+    activeColor: string;
+    /** 非激活状态的指示器颜色 */
+    inactiveColor: string;
+    /** 指示器样式对象 */
+    styles: {
+        indicatorContainer: ViewStyle;
+        indicatorDot: ViewStyle;
+        indicatorDotActive: ViewStyle;
+    };
+}
+/**
+ * 轮播图指示器渲染组件
+ *
+ * 负责渲染轮播图底部的指示器（小圆点），支持自定义指示器或使用默认样式。
+ * 当轮播项总数小于等于 1 时，不显示指示器。
+ *
+ * @param props - 组件属性配置
+ * @param props.indicator - 指示器配置（false 表示不显示，函数表示自定义渲染）
+ * @param props.indicatorProps - 指示器属性配置（颜色、样式）
+ * @param props.total - 轮播项总数
+ * @param props.current - 当前激活的索引
+ * @param props.activeColor - 激活状态的指示器颜色
+ * @param props.inactiveColor - 非激活状态的指示器颜色
+ * @param props.styles - 指示器样式对象
+ *
+ * @returns 渲染的指示器内容或 null
+ */
+export declare const CarouselIndicator: (props: CarouselIndicatorProps) => string | number | bigint | boolean | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+export {};
+//# sourceMappingURL=carousel-indicator.d.ts.map

package/dist/typescript/components/base/carousel/carousel-indicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carousel-indicator.d.ts","sourceRoot":"","sources":["../../../../../src/components/base/carousel/carousel-indicator.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,UAAU,sBAAsB;IAC9B,mCAAmC;IACnC,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IACtC,qBAAqB;IACrB,cAAc,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAChD,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc;IACd,MAAM,EAAE;QACN,kBAAkB,EAAE,SAAS,CAAC;QAC9B,YAAY,EAAE,SAAS,CAAC;QACxB,kBAAkB,EAAE,SAAS,CAAC;KAC/B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,sBAAsB,gWAqC9D,CAAC"}

package/dist/typescript/components/base/carousel/carousel-slides.d.ts

@@ -0,0 +1,49 @@
+import { type ReactNode } from 'react';
+interface CarouselSlidesProps<Data = unknown> {
+    /** 数据源数组 */
+    data: Data[];
+    /** 渲染每一项的函数 */
+    renderItem: (item: Data, index: number) => ReactNode;
+    /** 轮播项总数 */
+    total: number;
+    /** 虚拟渲染范围（start、end、isVirtual） */
+    virtualRange: {
+        start: number;
+        end: number;
+        isVirtual: boolean;
+    } | null;
+    /** 是否启用循环播放 */
+    loopEnabled: boolean;
+    /** 循环播放时前置克隆节点数量 */
+    clonesBefore: number;
+    /** 滑动方向 */
+    direction: 'horizontal' | 'vertical';
+    /** 单个滑块的像素大小 */
+    slidePixels: number;
+    /** 扩展后的总数（包含克隆节点） */
+    extTotal: number;
+}
+/**
+ * 轮播图滑块渲染组件
+ *
+ * 负责渲染轮播图的滑块内容，使用 data + renderItem 模式。
+ * 实现虚拟渲染优化，仅渲染可见范围内的滑块，并处理循环播放时的克隆逻辑。
+ * 为虚拟渲染添加前后占位空间，确保滚动位置正确。
+ *
+ * @template Data - 数据项类型
+ * @param props - 组件属性配置
+ * @param props.data - 数据源数组
+ * @param props.renderItem - 渲染每一项的函数
+ * @param props.total - 轮播项总数
+ * @param props.virtualRange - 虚拟渲染范围（start、end、isVirtual）
+ * @param props.loopEnabled - 是否启用循环播放
+ * @param props.clonesBefore - 循环播放时前置克隆节点数量
+ * @param props.direction - 滑动方向
+ * @param props.slidePixels - 单个滑块的像素大小
+ * @param props.extTotal - 扩展后的总数（包含克隆节点）
+ *
+ * @returns 渲染的滑块内容或 null
+ */
+export declare const CarouselSlides: <Data = unknown>(props: CarouselSlidesProps<Data>) => import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=carousel-slides.d.ts.map

package/dist/typescript/components/base/carousel/carousel-slides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carousel-slides.d.ts","sourceRoot":"","sources":["../../../../../src/components/base/carousel/carousel-slides.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,OAAO,CAAC;AAGhD,UAAU,mBAAmB,CAAC,IAAI,GAAG,OAAO;IAC1C,YAAY;IACZ,IAAI,EAAE,IAAI,EAAE,CAAC;IACb,eAAe;IACf,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IACrD,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,YAAY,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,OAAO,CAAC;KACpB,GAAG,IAAI,CAAC;IACT,eAAe;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,SAAS,EAAE,YAAY,GAAG,UAAU,CAAC;IACrC,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,GAAG,OAAO,EAC3C,OAAO,mBAAmB,CAAC,IAAI,CAAC,uCA4HjC,CAAC"}

package/dist/typescript/components/base/carousel/carousel.d.ts

@@ -8,24 +8,29 @@ import type { CarouselProps } from './types';
  * @example
  * ```tsx
  * // 基础用法
- * <Carousel>
- *   <Carousel.Item><View /></Carousel.Item>
- *   <Carousel.Item><View /></Carousel.Item>
- * </Carousel>
+ * <Carousel
+ *   data={[1, 2, 3]}
+ *   renderItem={(item) => <View><Text>{item}</Text></View>}
+ * />
  *
  * // 循环播放和自动轮播
- * <Carousel loop autoplay autoplayInterval={3000}>
- *   {items.map(item => <Carousel.Item key={item.id}>{item.content}</Carousel.Item>)}
- * </Carousel>
+ * <Carousel
+ *   data={items}
+ *   renderItem={(item) => <View>{item.content}</View>}
+ *   loop
+ *   autoplay
+ *   autoplayInterval={3000}
+ * />
  *
  * // 虚拟渲染（大量数据）
- * <Carousel total={1000}>
- *   {(index) => <Carousel.Item><Text>{index}</Text></Carousel.Item>}
- * </Carousel>
+ * <Carousel
+ *   data={largeDataArray}
+ *   renderItem={(item, index) => <View><Text>{index}: {item}</Text></View>}
+ * />
  * ```
  *
  * @param props - 组件属性
  * @returns 轮播图组件
  */
-export declare const Carousel: (props: CarouselProps) => React.JSX.Element;
+export declare const Carousel: <Data = unknown>(props: CarouselProps<Data>) => React.JSX.Element | null;
 //# sourceMappingURL=carousel.d.ts.map

package/dist/typescript/components/base/carousel/carousel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"carousel.d.ts","sourceRoot":"","sources":["../../../../../src/components/base/carousel/carousel.tsx"],"names":[],"mappings":"AACA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAuB9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAQ7C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,aAAa,sBA6S5C,CAAC"}
+{"version":3,"file":"carousel.d.ts","sourceRoot":"","sources":["../../../../../src/components/base/carousel/carousel.tsx"],"names":[],"mappings":"AACA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAsB9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAa7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,QAAQ,GAAI,IAAI,GAAG,OAAO,EAAG,OAAO,aAAa,CAAC,IAAI,CAAC,6BA0RnE,CAAC"}

package/dist/typescript/components/base/carousel/hooks/index.d.ts

@@ -1,9 +1,7 @@
 export { useCarouselAutoplay } from './use-carousel-autoplay';
 export { useCarouselIndex } from './use-carousel-index';
-export { useCarouselIndicator } from './use-carousel-indicator';
 export { useCarouselLifecycle } from './use-carousel-lifecycle';
 export { useCarouselPanResponder } from './use-carousel-pan-responder';
 export { useCarouselPosition } from './use-carousel-position';
-export { useCarouselSlides } from './use-carousel-slides';
 export { useCarouselSwipe } from './use-carousel-swipe';
 //# sourceMappingURL=index.d.ts.map

package/dist/typescript/components/base/carousel/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/base/carousel/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/base/carousel/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/typescript/components/base/carousel/hooks/use-carousel-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-carousel-index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/base/carousel/hooks/use-carousel-index.ts"],"names":[],"mappings":"AAQA,UAAU,sBAAsB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,sBAAsB;;0BAkBpD,MAAM;;;;kCAeL,MAAM;qCAQH,MAAM;6CAcH,MAAM;;CAoDvB,CAAC"}
+{"version":3,"file":"use-carousel-index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/base/carousel/hooks/use-carousel-index.ts"],"names":[],"mappings":"AASA,UAAU,sBAAsB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,sBAAsB;;0BAkBpD,MAAM;;;;kCAeL,MAAM;qCAQH,MAAM;6CAcH,MAAM;;CAuDvB,CAAC"}

package/dist/typescript/components/base/carousel/hooks/use-carousel-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-carousel-lifecycle.d.ts","sourceRoot":"","sources":["../../../../../../src/components/base/carousel/hooks/use-carousel-lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,OAAO,CAAC;AAElD,UAAU,0BAA0B;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,cAAc,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,oBAAoB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,0BAA0B,SAkDtE,CAAC"}
+{"version":3,"file":"use-carousel-lifecycle.d.ts","sourceRoot":"","sources":["../../../../../../src/components/base/carousel/hooks/use-carousel-lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,OAAO,CAAC;AAElD,UAAU,0BAA0B;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,cAAc,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,oBAAoB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,0BAA0B,SAmDtE,CAAC"}