@unif/react-native-design 0.19.0 → 0.20.0

package/lib/module/components/ui/Carousel/Carousel.js

@@ -2,30 +2,27 @@
 
 import React from 'react';
 import { Pressable, useWindowDimensions, View } from 'react-native';
-import ReanimatedCarousel, { Pagination } from 'react-native-reanimated-carousel';
+import { Carousel as ReanimatedCarousel, Pagination } from 'react-native-reanimated-carousel';
 import { useSharedValue } from 'react-native-reanimated';
 import { space, useThemedStyles } from "../../../theme/index.js";
 import { makeCarouselStyles } from "./styles.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/** Carousel —— 包装 `react-native-reanimated-carousel@5.0.0-beta.5`。
+/** Carousel —— 包装 `react-native-reanimated-carousel@5.0.0`。
  *
- *  dot indicator 走 `c.primary` token,使用库内置 `Pagination.Custom`
- *  (`useSharedValue` + `onProgressChange` 驱动,re-render 全在 worklet 里)。
+ *  dot indicator 走 `c.primary` token,使用库内置 `Pagination`
+ *  (`useSharedValue` + `progress` 驱动,视觉插值留在 UI 线程)。
  *
- *  用 Pagination.Custom 而非 Basic:Basic 的 activeDot 用 translateX 推进
- *  内层 fill,外壳宽度等于 dotStyle.width,activeDotStyle.width 只影响内层,
- *  做不出"active 4 → 12 长条"。Custom 自己 interpolate width/height/bg。
- *
- *  forwardRef 透传 ICarouselInstance —— 解锁 a11y 暂停(ref.current.scrollTo)
- *  以及宿主页面的命令式 scrollTo / prev / next。
+ *  forwardRef 透传 CarouselRef,供宿主命令式 scrollTo / prev / next
+ *  并读取最后一次完成落位的 index。
  */
-// T 约束 object —— `Pagination.Basic<T extends {}>` 需要 object
 function CarouselInner({
-  items,
+  data,
   renderItem,
+  keyExtractor,
   height,
-  itemWidth,
-  autoPlay,
+  itemSize,
+  autoplay,
+  autoplayInterval,
   loop = true,
   showIndicator = true,
   indicatorPosition = 'bottom',
@@ -37,16 +34,15 @@ function CarouselInner({
   const {
     width: screenWidth
   } = useWindowDimensions();
-  const width = itemWidth ?? screenWidth;
+  const width = itemSize ?? screenWidth;
   const styles = useThemedStyles(makeCarouselStyles);
-  // Carousel `onProgressChange` 把 absoluteProgress 写进 shared value,Pagination 自动跟。
+  // Carousel 把逻辑页进度写进 shared value,Pagination 自动跟随。
   const progress = useSharedValue(0);
 
   // 'bottom' 模式给容器额外 +space[7] (=r(16)) 高度容纳独立行指示器;
   // 与 dotsWrapBottom 的 paddingTop=space[3]+dot height space[1] 一起跟 r() 同步缩放。
   // 'overlay-bottom-right' 不占额外高度。
   const indicatorReservedHeight = showIndicator && indicatorPosition === 'bottom' ? space['7'] : 0;
-  const data = items;
   return /*#__PURE__*/_jsxs(View, {
     style: [{
       height: height + indicatorReservedHeight
@@ -59,15 +55,18 @@ function CarouselInner({
         width,
         height
       },
+      itemSize: width,
       data: data,
+      keyExtractor: keyExtractor,
       loop: loop,
-      autoPlay: !!autoPlay,
-      autoPlayInterval: autoPlay,
-      onProgressChange: progress,
+      autoplay: autoplay,
+      autoplayInterval: autoplayInterval,
+      progress: progress,
       ref: ref,
       renderItem: ({
         item,
-        index
+        index,
+        relativeProgress
       }) =>
       /*#__PURE__*/
       // RN Pressable 而非 RNGH Pressable:Carousel 的 GestureDetector 已挂在
@@ -93,24 +92,21 @@ function CarouselInner({
           accessibilityRole: 'button',
           accessibilityLabel: getAccessibilityLabel?.(item, index) ?? `第 ${index + 1} 项`
         } : null),
-        children: renderItem(item, index)
+        children: renderItem({
+          item,
+          index,
+          relativeProgress
+        })
       })
-    }), showIndicator && items.length > 1 ?
+    }), showIndicator && data.length > 1 ?
     /*#__PURE__*/
-    // importantForAccessibility="no" —— dots 仅视觉辅助,SR 不需要读出
-    // 每个 dot 的状态(已由 accessibilityRole=tab / accessibilityState.selected 表达
-    // 的场景另论,这里 Pagination.Custom 无内置 a11y 语义,对 SR 隐藏比误读更优)。
-    _jsx(Pagination.Custom, {
+    // 未传 onPress 时,正式版 Pagination 会把 dots 作为纯视觉辅助从 a11y 树隐藏。
+    _jsx(Pagination, {
       progress: progress,
-      data: data,
+      count: data.length,
       dotStyle: styles.dot,
       activeDotStyle: styles.dotActive,
       containerStyle: indicatorPosition === 'overlay-bottom-right' ? styles.dotsWrapOverlay : styles.dotsWrapBottom
-      // @ts-expect-error — importantForAccessibility 是 RN View prop,
-      // Pagination.Custom containerStyle 走 ViewStyle 但 TS 类型未收录该 prop
-      ,
-      importantForAccessibility: "no-hide-descendants",
-      accessibilityElementsHidden: true
     }) : null]
   });
 }

package/lib/module/components/ui/Carousel/Carousel.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","Pressable","useWindowDimensions","View","ReanimatedCarousel","Pagination","useSharedValue","space","useThemedStyles","makeCarouselStyles","jsx","_jsx","jsxs","_jsxs","CarouselInner","items","renderItem","height","itemWidth","autoPlay","loop","showIndicator","indicatorPosition","onPressItem","getAccessibilityLabel","style","testID","ref","width","screenWidth","styles","progress","indicatorReservedHeight","data","children","autoPlayInterval","onProgressChange","item","index","onPress","accessibilityRole","accessibilityLabel","length","Custom","dotStyle","dot","activeDotStyle","dotActive","containerStyle","dotsWrapOverlay","dotsWrapBottom","importantForAccessibility","accessibilityElementsHidden","Carousel","forwardRef"],"sourceRoot":"../../../../../src","sources":["components/ui/Carousel/Carousel.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","Pressable","useWindowDimensions","View","Carousel","ReanimatedCarousel","Pagination","useSharedValue","space","useThemedStyles","makeCarouselStyles","jsx","_jsx","jsxs","_jsxs","CarouselInner","data","renderItem","keyExtractor","height","itemSize","autoplay","autoplayInterval","loop","showIndicator","indicatorPosition","onPressItem","getAccessibilityLabel","style","testID","ref","width","screenWidth","styles","progress","indicatorReservedHeight","children","item","index","relativeProgress","onPress","accessibilityRole","accessibilityLabel","length","count","dotStyle","dot","activeDotStyle","dotActive","containerStyle","dotsWrapOverlay","dotsWrapBottom","forwardRef"],"sourceRoot":"../../../../../src","sources":["components/ui/Carousel/Carousel.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/components/ui/Carousel/styles.js

@@ -3,13 +3,11 @@
 import { StyleSheet } from 'react-native';
 import { r, radius, space } from "../../../theme/index.js";
 export const makeCarouselStyles = c => StyleSheet.create({
-  /** 'bottom' 模式:独立行容器,覆盖 Pagination.Custom 默认的 `justifyContent: 'space-between'`
-   *  (否则 dot 横向撑开),让 dot 居中紧贴。 */
+  /** 'bottom' 模式:独立行容器,让 dot 居中紧贴。 */
   dotsWrapBottom: {
-    flexDirection: 'row',
     justifyContent: 'center',
     alignItems: 'center',
-    // 3pt 横间距:dot 单元 4pt + space[1]=r(4) 偏大,保留 r(3) 作为局部 dot 间隙
+    // 正式版按 active 最大宽度为每个 dot 预留 12pt,额外保留 3pt 间距。
     gap: r(3),
     paddingTop: space['3']
   },
@@ -19,7 +17,6 @@ export const makeCarouselStyles = c => StyleSheet.create({
     position: 'absolute',
     bottom: space['3'],
     right: space['5'],
-    flexDirection: 'row',
     justifyContent: 'flex-end',
     alignItems: 'center',
     gap: r(3)
@@ -32,10 +29,10 @@ export const makeCarouselStyles = c => StyleSheet.create({
     backgroundColor: c.primary,
     opacity: 0.32
   },
-  /** activeDot —— 12×4 长条,Pagination.Custom 会把 dotStyle 的 height /
-   *  borderRadius 与 activeDotStyle 的 width 一起 interpolate,这里只 override 变化值。 */
+  /** activeDot —— 12×4 长条,正式版 Pagination 为每项预留 12pt 宽避免布局跳动。 */
   dotActive: {
     width: space['5'],
+    backgroundColor: c.primary,
     opacity: 1
   }
 });

package/lib/module/components/ui/Carousel/styles.js.map

@@ -1 +1 @@
-{"version":3,"names":["StyleSheet","r","radius","space","makeCarouselStyles","c","create","dotsWrapBottom","flexDirection","justifyContent","alignItems","gap","paddingTop","dotsWrapOverlay","position","bottom","right","dot","width","height","borderRadius","pill","backgroundColor","primary","opacity","dotActive"],"sourceRoot":"../../../../../src","sources":["components/ui/Carousel/styles.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,cAAc;AACzC,SAASC,CAAC,EAAEC,MAAM,EAAEC,KAAK,QAA0B,yBAAgB;AAEnE,OAAO,MAAMC,kBAAkB,GAAIC,CAAc,IAC/CL,UAAU,CAACM,MAAM,CAAC;EAChB;AACJ;EACIC,cAAc,EAAE;IACdC,aAAa,EAAE,KAAK;IACpBC,cAAc,EAAE,QAAQ;IACxBC,UAAU,EAAE,QAAQ;IACpB;IACAC,GAAG,EAAEV,CAAC,CAAC,CAAC,CAAC;IACTW,UAAU,EAAET,KAAK,CAAC,GAAG;EACvB,CAAC;EACD;AACJ;EACIU,eAAe,EAAE;IACfC,QAAQ,EAAE,UAAU;IACpBC,MAAM,EAAEZ,KAAK,CAAC,GAAG,CAAC;IAClBa,KAAK,EAAEb,KAAK,CAAC,GAAG,CAAC;IACjBK,aAAa,EAAE,KAAK;IACpBC,cAAc,EAAE,UAAU;IAC1BC,UAAU,EAAE,QAAQ;IACpBC,GAAG,EAAEV,CAAC,CAAC,CAAC;EACV,CAAC;EACDgB,GAAG,EAAE;IACHC,KAAK,EAAEf,KAAK,CAAC,GAAG,CAAC;IACjBgB,MAAM,EAAEhB,KAAK,CAAC,GAAG,CAAC;IAClB;IACAiB,YAAY,EAAElB,MAAM,CAACmB,IAAI;IACzBC,eAAe,EAAEjB,CAAC,CAACkB,OAAO;IAC1BC,OAAO,EAAE;EACX,CAAC;EACD;AACJ;EACIC,SAAS,EAAE;IACTP,KAAK,EAAEf,KAAK,CAAC,GAAG,CAAC;IACjBqB,OAAO,EAAE;EACX;AACF,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["StyleSheet","r","radius","space","makeCarouselStyles","c","create","dotsWrapBottom","justifyContent","alignItems","gap","paddingTop","dotsWrapOverlay","position","bottom","right","dot","width","height","borderRadius","pill","backgroundColor","primary","opacity","dotActive"],"sourceRoot":"../../../../../src","sources":["components/ui/Carousel/styles.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,cAAc;AACzC,SAASC,CAAC,EAAEC,MAAM,EAAEC,KAAK,QAA0B,yBAAgB;AAEnE,OAAO,MAAMC,kBAAkB,GAAIC,CAAc,IAC/CL,UAAU,CAACM,MAAM,CAAC;EAChB;EACAC,cAAc,EAAE;IACdC,cAAc,EAAE,QAAQ;IACxBC,UAAU,EAAE,QAAQ;IACpB;IACAC,GAAG,EAAET,CAAC,CAAC,CAAC,CAAC;IACTU,UAAU,EAAER,KAAK,CAAC,GAAG;EACvB,CAAC;EACD;AACJ;EACIS,eAAe,EAAE;IACfC,QAAQ,EAAE,UAAU;IACpBC,MAAM,EAAEX,KAAK,CAAC,GAAG,CAAC;IAClBY,KAAK,EAAEZ,KAAK,CAAC,GAAG,CAAC;IACjBK,cAAc,EAAE,UAAU;IAC1BC,UAAU,EAAE,QAAQ;IACpBC,GAAG,EAAET,CAAC,CAAC,CAAC;EACV,CAAC;EACDe,GAAG,EAAE;IACHC,KAAK,EAAEd,KAAK,CAAC,GAAG,CAAC;IACjBe,MAAM,EAAEf,KAAK,CAAC,GAAG,CAAC;IAClB;IACAgB,YAAY,EAAEjB,MAAM,CAACkB,IAAI;IACzBC,eAAe,EAAEhB,CAAC,CAACiB,OAAO;IAC1BC,OAAO,EAAE;EACX,CAAC;EACD;EACAC,SAAS,EAAE;IACTP,KAAK,EAAEd,KAAK,CAAC,GAAG,CAAC;IACjBkB,eAAe,EAAEhB,CAAC,CAACiB,OAAO;IAC1BC,OAAO,EAAE;EACX;AACF,CAAC,CAAC","ignoreList":[]}

package/lib/typescript/src/components/ui/Carousel/Carousel.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import type { CarouselProps, ICarouselInstance } from './types';
-export declare const Carousel: <T extends object>(props: CarouselProps<T> & {
-    ref?: React.Ref<ICarouselInstance>;
+import type { CarouselProps, CarouselRef } from './types';
+export declare const Carousel: <T>(props: CarouselProps<T> & {
+    ref?: React.Ref<CarouselRef>;
 }) => React.JSX.Element;
 //# sourceMappingURL=Carousel.d.ts.map

package/lib/typescript/src/components/ui/Carousel/Carousel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Carousel.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Carousel/Carousel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAQ1B,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAiHhE,eAAO,MAAM,QAAQ,EAAsC,CAAC,CAAC,SAAS,MAAM,EAC1E,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,KAC7D,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC"}
+{"version":3,"file":"Carousel.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Carousel/Carousel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAwG1D,eAAO,MAAM,QAAQ,EAAsC,CAAC,CAAC,EAC3D,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;CAAE,KACvD,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC"}

package/lib/typescript/src/components/ui/Carousel/index.d.ts

@@ -1,3 +1,3 @@
 export { Carousel } from './Carousel';
-export type { CarouselProps, ICarouselInstance } from './types';
+export type { CarouselProps, CarouselRef } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/components/ui/Carousel/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Carousel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Carousel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/lib/typescript/src/components/ui/Carousel/styles.d.ts

@@ -1,9 +1,7 @@
 import { type ColorTokens } from '../../../theme';
 export declare const makeCarouselStyles: (c: ColorTokens) => Readonly<{
-    /** 'bottom' 模式:独立行容器,覆盖 Pagination.Custom 默认的 `justifyContent: 'space-between'`
-     *  (否则 dot 横向撑开),让 dot 居中紧贴。 */
+    /** 'bottom' 模式:独立行容器,让 dot 居中紧贴。 */
     dotsWrapBottom: {
-        flexDirection: "row";
         justifyContent: "center";
         alignItems: "center";
         gap: number;
@@ -15,7 +13,6 @@ export declare const makeCarouselStyles: (c: ColorTokens) => Readonly<{
         position: "absolute";
         bottom: number;
         right: number;
-        flexDirection: "row";
         justifyContent: "flex-end";
         alignItems: "center";
         gap: number;
@@ -27,10 +24,10 @@ export declare const makeCarouselStyles: (c: ColorTokens) => Readonly<{
         backgroundColor: string;
         opacity: number;
     };
-    /** activeDot —— 12×4 长条,Pagination.Custom 会把 dotStyle 的 height /
-     *  borderRadius 与 activeDotStyle 的 width 一起 interpolate,这里只 override 变化值。 */
+    /** activeDot —— 12×4 长条,正式版 Pagination 为每项预留 12pt 宽避免布局跳动。 */
     dotActive: {
         width: number;
+        backgroundColor: string;
         opacity: number;
     };
 }>;

package/lib/typescript/src/components/ui/Carousel/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Carousel/styles.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEpE,eAAO,MAAM,kBAAkB,GAAI,GAAG,WAAW;IAE7C;oCACgC;;;;;;;;IAShC;4DACwD;;;;;;;;;;;;;;;;;IAkBxD;iFAC6E;;;;;EAK7E,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Carousel/styles.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEpE,eAAO,MAAM,kBAAkB,GAAI,GAAG,WAAW;IAE7C,oCAAoC;;;;;;;IAQpC;4DACwD;;;;;;;;;;;;;;;;IAiBxD,8DAA8D;;;;;;EAM9D,CAAC"}

package/lib/typescript/src/components/ui/Carousel/types.d.ts

@@ -1,25 +1,28 @@
-import type { ICarouselInstance } from 'react-native-reanimated-carousel';
-import type { ReactNode } from 'react';
+import type { CarouselRef, CarouselRenderItem } from 'react-native-reanimated-carousel';
 import type { StyleProp, ViewStyle } from 'react-native';
-export type { ICarouselInstance };
+export type { CarouselRef };
 /** Indicator 位置策略:
  *  - 'bottom'(默认):指示器独立行,跟 Carousel 下方;容器高度 = height + 16
  *  - 'overlay-bottom-right':指示器 absolute 浮在 Carousel 右下角,不占额外高度 */
 export type CarouselIndicatorPosition = 'bottom' | 'overlay-bottom-right';
 export type CarouselProps<T> = {
     /** 数组数据 */
-    items: ReadonlyArray<T>;
+    data: T[];
     /** 单项渲染 */
-    renderItem: (item: T, index: number) => ReactNode;
-    /** 每张高度(宽度默认 = 屏宽,被 itemWidth 覆盖) */
+    renderItem: CarouselRenderItem<T>;
+    /** 稳定 key 解析器,数据更新时用于保持 item 身份。 */
+    keyExtractor?: (item: T, index: number) => string;
+    /** 每张高度(宽度默认 = 屏宽,被 itemSize 覆盖) */
     height: number;
-    /** 每张宽度,默认 useWindowDimensions().width。
+    /** 每张宽度与水平翻页步长,默认 useWindowDimensions().width。
      *  若 caller 外层有 marginHorizontal(如 Dashboard banner inset 16),需要传
      *  `屏宽 - 左右 margin*2`,否则 slide 宽度超过可视区,右侧内容被裁切。 */
-    itemWidth?: number;
-    /** autoPlay 间隔 ms,undefined / 0 不自动 */
-    autoPlay?: number;
-    /** 是否循环播放,默认 true。传 false 时首尾不循环,可配合 a11y 暂停控制。 */
+    itemSize?: number;
+    /** 是否自动播放,默认 false。 */
+    autoplay?: boolean;
+    /** 自动播放间隔 ms,默认 3000。 */
+    autoplayInterval?: number;
+    /** 是否循环播放,默认 true。传 false 时到首尾停止。 */
     loop?: boolean;
     /** 是否显示底部 dot indicator,默认 true */
     showIndicator?: boolean;

package/lib/typescript/src/components/ui/Carousel/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Carousel/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC;;mEAEmE;AACnE,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG,sBAAsB,CAAC;AAE1E,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,WAAW;IACX,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACxB,WAAW;IACX,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAClD,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf;;uDAEmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mCAAmC;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,yBAAyB,CAAC;IAC9C,WAAW;IACX,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C;sEACkE;IAClE,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3D,mBAAmB;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Carousel/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EACnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;mEAEmE;AACnE,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG,sBAAsB,CAAC;AAE1E,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,WAAW;IACX,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,WAAW;IACX,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAClC,oCAAoC;IACpC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf;;uDAEmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mCAAmC;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,yBAAyB,CAAC;IAC9C,WAAW;IACX,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C;sEACkE;IAClE,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3D,mBAAmB;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/lib/typescript/src/components/ui/index.d.ts

@@ -7,7 +7,7 @@ export type { ButtonProps, ButtonSize, ButtonVariant } from './Button';
 export { Card } from './Card';
 export type { CardProps, CardVariant } from './Card';
 export { Carousel } from './Carousel';
-export type { CarouselProps } from './Carousel';
+export type { CarouselProps, CarouselRef } from './Carousel';
 export { Cell, List } from './Cell';
 export type { CellProps, ListProps } from './Cell';
 export { Checkbox } from './Checkbox';

package/lib/typescript/src/components/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unif/react-native-design",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Unif 设计系统:theme + icons + utils + components",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -88,9 +88,9 @@
     "react": "19.2.3",
     "react-native": "0.85.3",
     "react-native-builder-bob": "^0.41.0",
-    "react-native-gesture-handler": "^3.0.0",
+    "react-native-gesture-handler": "^3.1.0",
     "react-native-reanimated": "^4.4.0",
-    "react-native-reanimated-carousel": "^5.0.0-beta.5",
+    "react-native-reanimated-carousel": "^5.0.0",
     "react-native-safe-area-context": "^5.7.0",
     "react-native-svg": "^15.15.5",
     "react-native-worklets": "0.9.1",
@@ -102,9 +102,9 @@
     "@sbaiahmed1/react-native-blur": ">=4",
     "react": "*",
     "react-native": "*",
-    "react-native-gesture-handler": ">=2",
-    "react-native-reanimated": ">=4",
-    "react-native-reanimated-carousel": ">=5.0.0-beta.0",
+    "react-native-gesture-handler": ">=3.0.0 <4.0.0",
+    "react-native-reanimated": ">=4.1.0",
+    "react-native-reanimated-carousel": ">=5.0.0 <6.0.0",
     "react-native-safe-area-context": ">=5",
     "react-native-svg": ">=15",
     "react-native-worklets": ">=0.9"

package/src/components/ui/Carousel/Carousel.tsx

@@ -1,33 +1,31 @@
 import React from 'react';
 import { Pressable, useWindowDimensions, View } from 'react-native';
-import ReanimatedCarousel, {
+import {
+  Carousel as ReanimatedCarousel,
   Pagination,
 } from 'react-native-reanimated-carousel';
 import { useSharedValue } from 'react-native-reanimated';
 import { space, useThemedStyles } from '../../../theme';
 import { makeCarouselStyles } from './styles';
-import type { CarouselProps, ICarouselInstance } from './types';
+import type { CarouselProps, CarouselRef } from './types';
 
-/** Carousel —— 包装 `react-native-reanimated-carousel@5.0.0-beta.5`。
+/** Carousel —— 包装 `react-native-reanimated-carousel@5.0.0`。
  *
- *  dot indicator 走 `c.primary` token,使用库内置 `Pagination.Custom`
- *  (`useSharedValue` + `onProgressChange` 驱动,re-render 全在 worklet 里)。
+ *  dot indicator 走 `c.primary` token,使用库内置 `Pagination`
+ *  (`useSharedValue` + `progress` 驱动,视觉插值留在 UI 线程)。
  *
- *  用 Pagination.Custom 而非 Basic:Basic 的 activeDot 用 translateX 推进
- *  内层 fill,外壳宽度等于 dotStyle.width,activeDotStyle.width 只影响内层,
- *  做不出"active 4 → 12 长条"。Custom 自己 interpolate width/height/bg。
- *
- *  forwardRef 透传 ICarouselInstance —— 解锁 a11y 暂停(ref.current.scrollTo)
- *  以及宿主页面的命令式 scrollTo / prev / next。
+ *  forwardRef 透传 CarouselRef,供宿主命令式 scrollTo / prev / next
+ *  并读取最后一次完成落位的 index。
  */
-// T 约束 object —— `Pagination.Basic<T extends {}>` 需要 object
-function CarouselInner<T extends object>(
+function CarouselInner<T>(
   {
-    items,
+    data,
     renderItem,
+    keyExtractor,
     height,
-    itemWidth,
-    autoPlay,
+    itemSize,
+    autoplay,
+    autoplayInterval,
     loop = true,
     showIndicator = true,
     indicatorPosition = 'bottom',
@@ -36,12 +34,12 @@ function CarouselInner<T extends object>(
     style,
     testID,
   }: CarouselProps<T>,
-  ref: React.Ref<ICarouselInstance>
+  ref: React.Ref<CarouselRef>
 ): React.JSX.Element {
   const { width: screenWidth } = useWindowDimensions();
-  const width = itemWidth ?? screenWidth;
+  const width = itemSize ?? screenWidth;
   const styles = useThemedStyles(makeCarouselStyles);
-  // Carousel `onProgressChange` 把 absoluteProgress 写进 shared value,Pagination 自动跟。
+  // Carousel 把逻辑页进度写进 shared value,Pagination 自动跟随。
   const progress = useSharedValue<number>(0);
 
   // 'bottom' 模式给容器额外 +space[7] (=r(16)) 高度容纳独立行指示器;
@@ -50,8 +48,6 @@ function CarouselInner<T extends object>(
   const indicatorReservedHeight =
     showIndicator && indicatorPosition === 'bottom' ? space['7'] : 0;
 
-  const data = items as T[];
-
   return (
     <View
       style={[{ height: height + indicatorReservedHeight }, style]}
@@ -60,13 +56,15 @@ function CarouselInner<T extends object>(
       <ReanimatedCarousel
         // v5 把 width / height prop deprecate,迁到 style
         style={{ width, height }}
+        itemSize={width}
         data={data}
+        keyExtractor={keyExtractor}
         loop={loop}
-        autoPlay={!!autoPlay}
-        autoPlayInterval={autoPlay}
-        onProgressChange={progress}
+        autoplay={autoplay}
+        autoplayInterval={autoplayInterval}
+        progress={progress}
         ref={ref}
-        renderItem={({ item, index }) => (
+        renderItem={({ item, index, relativeProgress }) => (
           // RN Pressable 而非 RNGH Pressable:Carousel 的 GestureDetector 已挂在
           // ReanimatedCarousel 内部,外层再套 RNGH Pressable 会产生手势冲突;
           // 用 RN 原生 Pressable 让库自己的拖拽手势优先,tap 仍正常触发。
@@ -90,17 +88,15 @@ function CarouselInner<T extends object>(
                 }
               : null)}
           >
-            {renderItem(item, index)}
+            {renderItem({ item, index, relativeProgress })}
           </Pressable>
         )}
       />
-      {showIndicator && items.length > 1 ? (
-        // importantForAccessibility="no" —— dots 仅视觉辅助,SR 不需要读出
-        // 每个 dot 的状态(已由 accessibilityRole=tab / accessibilityState.selected 表达
-        // 的场景另论,这里 Pagination.Custom 无内置 a11y 语义,对 SR 隐藏比误读更优)。
-        <Pagination.Custom<T>
+      {showIndicator && data.length > 1 ? (
+        // 未传 onPress 时,正式版 Pagination 会把 dots 作为纯视觉辅助从 a11y 树隐藏。
+        <Pagination
           progress={progress}
-          data={data}
+          count={data.length}
           dotStyle={styles.dot}
           activeDotStyle={styles.dotActive}
           containerStyle={
@@ -108,10 +104,6 @@ function CarouselInner<T extends object>(
               ? styles.dotsWrapOverlay
               : styles.dotsWrapBottom
           }
-          // @ts-expect-error — importantForAccessibility 是 RN View prop,
-          // Pagination.Custom containerStyle 走 ViewStyle 但 TS 类型未收录该 prop
-          importantForAccessibility="no-hide-descendants"
-          accessibilityElementsHidden={true}
         />
       ) : null}
     </View>
@@ -119,6 +111,6 @@ function CarouselInner<T extends object>(
 }
 
 // forwardRef 不支持泛型函数组件直接推断 T,需要手动标注 + 类型断言
-export const Carousel = React.forwardRef(CarouselInner) as <T extends object>(
-  props: CarouselProps<T> & { ref?: React.Ref<ICarouselInstance> }
+export const Carousel = React.forwardRef(CarouselInner) as <T>(
+  props: CarouselProps<T> & { ref?: React.Ref<CarouselRef> }
 ) => React.JSX.Element;

package/src/components/ui/Carousel/index.ts

@@ -1,2 +1,2 @@
 export { Carousel } from './Carousel';
-export type { CarouselProps, ICarouselInstance } from './types';
+export type { CarouselProps, CarouselRef } from './types';

package/src/components/ui/Carousel/styles.ts

@@ -3,13 +3,11 @@ import { r, radius, space, type ColorTokens } from '../../../theme';
 
 export const makeCarouselStyles = (c: ColorTokens) =>
   StyleSheet.create({
-    /** 'bottom' 模式:独立行容器,覆盖 Pagination.Custom 默认的 `justifyContent: 'space-between'`
-     *  (否则 dot 横向撑开),让 dot 居中紧贴。 */
+    /** 'bottom' 模式:独立行容器,让 dot 居中紧贴。 */
     dotsWrapBottom: {
-      flexDirection: 'row',
       justifyContent: 'center',
       alignItems: 'center',
-      // 3pt 横间距:dot 单元 4pt + space[1]=r(4) 偏大,保留 r(3) 作为局部 dot 间隙
+      // 正式版按 active 最大宽度为每个 dot 预留 12pt,额外保留 3pt 间距。
       gap: r(3),
       paddingTop: space['3'],
     },
@@ -19,7 +17,6 @@ export const makeCarouselStyles = (c: ColorTokens) =>
       position: 'absolute',
       bottom: space['3'],
       right: space['5'],
-      flexDirection: 'row',
       justifyContent: 'flex-end',
       alignItems: 'center',
       gap: r(3),
@@ -32,10 +29,10 @@ export const makeCarouselStyles = (c: ColorTokens) =>
       backgroundColor: c.primary,
       opacity: 0.32,
     },
-    /** activeDot —— 12×4 长条,Pagination.Custom 会把 dotStyle 的 height /
-     *  borderRadius 与 activeDotStyle 的 width 一起 interpolate,这里只 override 变化值。 */
+    /** activeDot —— 12×4 长条,正式版 Pagination 为每项预留 12pt 宽避免布局跳动。 */
     dotActive: {
       width: space['5'],
+      backgroundColor: c.primary,
       opacity: 1,
     },
   });

package/src/components/ui/Carousel/types.ts

@@ -1,8 +1,10 @@
-import type { ICarouselInstance } from 'react-native-reanimated-carousel';
-import type { ReactNode } from 'react';
+import type {
+  CarouselRef,
+  CarouselRenderItem,
+} from 'react-native-reanimated-carousel';
 import type { StyleProp, ViewStyle } from 'react-native';
 
-export type { ICarouselInstance };
+export type { CarouselRef };
 
 /** Indicator 位置策略:
  *  - 'bottom'(默认):指示器独立行,跟 Carousel 下方;容器高度 = height + 16
@@ -11,18 +13,22 @@ export type CarouselIndicatorPosition = 'bottom' | 'overlay-bottom-right';
 
 export type CarouselProps<T> = {
   /** 数组数据 */
-  items: ReadonlyArray<T>;
+  data: T[];
   /** 单项渲染 */
-  renderItem: (item: T, index: number) => ReactNode;
-  /** 每张高度(宽度默认 = 屏宽,被 itemWidth 覆盖) */
+  renderItem: CarouselRenderItem<T>;
+  /** 稳定 key 解析器,数据更新时用于保持 item 身份。 */
+  keyExtractor?: (item: T, index: number) => string;
+  /** 每张高度(宽度默认 = 屏宽,被 itemSize 覆盖) */
   height: number;
-  /** 每张宽度,默认 useWindowDimensions().width。
+  /** 每张宽度与水平翻页步长,默认 useWindowDimensions().width。
    *  若 caller 外层有 marginHorizontal(如 Dashboard banner inset 16),需要传
    *  `屏宽 - 左右 margin*2`,否则 slide 宽度超过可视区,右侧内容被裁切。 */
-  itemWidth?: number;
-  /** autoPlay 间隔 ms,undefined / 0 不自动 */
-  autoPlay?: number;
-  /** 是否循环播放,默认 true。传 false 时首尾不循环,可配合 a11y 暂停控制。 */
+  itemSize?: number;
+  /** 是否自动播放,默认 false。 */
+  autoplay?: boolean;
+  /** 自动播放间隔 ms,默认 3000。 */
+  autoplayInterval?: number;
+  /** 是否循环播放,默认 true。传 false 时到首尾停止。 */
   loop?: boolean;
   /** 是否显示底部 dot indicator,默认 true */
   showIndicator?: boolean;

package/src/components/ui/index.ts

@@ -7,7 +7,7 @@ export type { ButtonProps, ButtonSize, ButtonVariant } from './Button';
 export { Card } from './Card';
 export type { CardProps, CardVariant } from './Card';
 export { Carousel } from './Carousel';
-export type { CarouselProps } from './Carousel';
+export type { CarouselProps, CarouselRef } from './Carousel';
 export { Cell, List } from './Cell';
 export type { CellProps, ListProps } from './Cell';
 export { Checkbox } from './Checkbox';