@unif/react-native-design 0.18.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/module/components/ui/Chip/Chip.js

@@ -3,15 +3,23 @@
 import React from 'react';
 import { Text, View } from 'react-native';
 import { Pressable } from 'react-native-gesture-handler';
-import { fixed, pressedOpacity, r, rf, useThemedStyles } from "../../../theme/index.js";
+import { fixed, pressedOpacity, r, rf, useColors, useThemedStyles } from "../../../theme/index.js";
+import { Spinner } from "../Spinner/index.js";
 import { makeStyles } from "./styles.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** 处理中 chip 的透明度 —— 比 disabled(0.5)亮、比按下(pressedOpacity)暗:
+ *  「正在办」既要压下去,又不能和「不能点」长一样(那两者只靠 spinner 区分就太弱了)。 */
+const busyOpacity = 0.6;
+/** busy spinner 直径 —— 与调用方常用的 leading icon(12)等大,顶替时不改 chip 宽度。 */
+const busySpinner = r(12);
+
 /**
  * 胶囊形可点击 chip。
  * - 默认：surface 底 + outline 细线边框，foreground 文本
  * - 选中：主色边框 + 主色文本
  * - 按下：透明度 pressedOpacity(与 ButtonBase 同源)
  * - 禁用：透明度 0.5 + 不响应 onPress
+ * - 处理中(`busy`)：leading 换 spinner + 透明度 0.6 + 不响应二次点击
  *
  * 常用于建议 chip、筛选 pill、多选标签等。
  */
@@ -20,17 +28,26 @@ export function Chip({
   selected,
   onPress,
   disabled,
+  busy,
   leading,
   trailing,
   style,
   testID
 }) {
+  const c = useColors();
   const styles = useThemedStyles(makeStyles);
+  // 处理中把 spinner 放进 leading 位(有 leading 就顶掉它):label 必须留着 —— 换掉它 chip
+  // 会塌成一个圆点,同排 chip 集体重排。spinner 跟随文本色,不在未选中的 chip 上凭空冒主色。
+  const lead = busy ? /*#__PURE__*/_jsx(Spinner, {
+    size: busySpinner,
+    thickness: r(1.5),
+    color: selected ? c.primary : c.foreground
+  }) : leading;
   const inner = /*#__PURE__*/_jsxs(View, {
     style: [styles.chip, selected && styles.chipOn, style],
     testID: onPress ? undefined : testID,
-    children: [leading != null ? /*#__PURE__*/_jsx(View, {
-      children: leading
+    children: [lead != null ? /*#__PURE__*/_jsx(View, {
+      children: lead
     }) : null, /*#__PURE__*/_jsx(Text, {
       style: [styles.text, selected && styles.textOn],
       numberOfLines: 1,
@@ -43,13 +60,16 @@ export function Chip({
     // [M-7] chip 内容高 ≈ 2×space[3] + xs 行高 ≈ 34pt < 44pt
     // Pressable 是外壳,hitSlop 向外补足到 fixed.hitTarget
     const chipHitSlopV = Math.max(0, Math.round((fixed.hitTarget - (2 * r(8) + rf(13) * 1.4)) / 2));
+    // 处理中同样不响应:chip 的高频用法是「点一下发起一次请求」,放行二次点击就是重复提交。
+    const inactive = !!disabled || !!busy;
     return /*#__PURE__*/_jsx(Pressable, {
       onPress: onPress,
-      disabled: disabled,
+      disabled: inactive,
       accessibilityRole: "button",
       accessibilityState: {
         selected: !!selected,
-        disabled: !!disabled
+        disabled: inactive,
+        busy: !!busy
       },
       accessibilityLabel: label,
       testID: testID,
@@ -63,7 +83,7 @@ export function Chip({
         pressed
       }) => [{
         alignSelf: 'flex-start',
-        opacity: disabled ? 0.5 : pressed ? pressedOpacity : 1
+        opacity: disabled ? 0.5 : busy ? busyOpacity : pressed ? pressedOpacity : 1
       }],
       children: inner
     });

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

@@ -1 +1 @@
-{"version":3,"names":["React","Text","View","Pressable","fixed","pressedOpacity","r","rf","useThemedStyles","makeStyles","jsx","_jsx","jsxs","_jsxs","Chip","label","selected","onPress","disabled","leading","trailing","style","testID","styles","inner","chip","chipOn","undefined","children","text","textOn","numberOfLines","chipHitSlopV","Math","max","round","hitTarget","accessibilityRole","accessibilityState","accessibilityLabel","hitSlop","top","bottom","left","right","pressed","alignSelf","opacity"],"sourceRoot":"../../../../../src","sources":["components/ui/Chip/Chip.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,IAAI,EAAEC,IAAI,QAAQ,cAAc;AACzC,SAASC,SAAS,QAAQ,8BAA8B;AACxD,SAASC,KAAK,EAAEC,cAAc,EAAEC,CAAC,EAAEC,EAAE,EAAEC,eAAe,QAAQ,yBAAgB;AAC9E,SAASC,UAAU,QAAQ,aAAU;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAGtC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,IAAIA,CAAC;EACnBC,KAAK;EACLC,QAAQ;EACRC,OAAO;EACPC,QAAQ;EACRC,OAAO;EACPC,QAAQ;EACRC,KAAK;EACLC;AACS,CAAC,EAAqB;EAC/B,MAAMC,MAAM,GAAGf,eAAe,CAACC,UAAU,CAAC;EAC1C,MAAMe,KAAK,gBACTX,KAAA,CAACX,IAAI;IACHmB,KAAK,EAAE,CAACE,MAAM,CAACE,IAAI,EAAET,QAAQ,IAAIO,MAAM,CAACG,MAAM,EAAEL,KAAK,CAAE;IACvDC,MAAM,EAAEL,OAAO,GAAGU,SAAS,GAAGL,MAAO;IAAAM,QAAA,GAEpCT,OAAO,IAAI,IAAI,gBAAGR,IAAA,CAACT,IAAI;MAAA0B,QAAA,EAAET;IAAO,CAAO,CAAC,GAAG,IAAI,eAChDR,IAAA,CAACV,IAAI;MAACoB,KAAK,EAAE,CAACE,MAAM,CAACM,IAAI,EAAEb,QAAQ,IAAIO,MAAM,CAACO,MAAM,CAAE;MAACC,aAAa,EAAE,CAAE;MAAAH,QAAA,EACrEb;IAAK,CACF,CAAC,EACNK,QAAQ,IAAI,IAAI,gBAAGT,IAAA,CAACT,IAAI;MAAA0B,QAAA,EAAER;IAAQ,CAAO,CAAC,GAAG,IAAI;EAAA,CAC9C,CACP;EAED,IAAIH,OAAO,EAAE;IACX;IACA;IACA,MAAMe,YAAY,GAAGC,IAAI,CAACC,GAAG,CAC3B,CAAC,EACDD,IAAI,CAACE,KAAK,CAAC,CAAC/B,KAAK,CAACgC,SAAS,IAAI,CAAC,GAAG9B,CAAC,CAAC,CAAC,CAAC,GAAGC,EAAE,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAC9D,CAAC;IACD,oBACEI,IAAA,CAACR,SAAS;MACRc,OAAO,EAAEA,OAAQ;MACjBC,QAAQ,EAAEA,QAAS;MACnBmB,iBAAiB,EAAC,QAAQ;MAC1BC,kBAAkB,EAAE;QAAEtB,QAAQ,EAAE,CAAC,CAACA,QAAQ;QAAEE,QAAQ,EAAE,CAAC,CAACA;MAAS,CAAE;MACnEqB,kBAAkB,EAAExB,KAAM;MAC1BO,MAAM,EAAEA,MAAO;MACfkB,OAAO,EAAE;QAAEC,GAAG,EAAET,YAAY;QAAEU,MAAM,EAAEV,YAAY;QAAEW,IAAI,EAAE,CAAC;QAAEC,KAAK,EAAE;MAAE,CAAE;MACxEvB,KAAK,EAAEA,CAAC;QAAEwB;MAAQ,CAAC,KAAK,CACtB;QACEC,SAAS,EAAE,YAAY;QACvBC,OAAO,EAAE7B,QAAQ,GAAG,GAAG,GAAG2B,OAAO,GAAGxC,cAAc,GAAG;MACvD,CAAC,CACD;MAAAuB,QAAA,EAEDJ;IAAK,CACG,CAAC;EAEhB;EACA,OAAOA,KAAK;AACd","ignoreList":[]}
+{"version":3,"names":["React","Text","View","Pressable","fixed","pressedOpacity","r","rf","useColors","useThemedStyles","Spinner","makeStyles","jsx","_jsx","jsxs","_jsxs","busyOpacity","busySpinner","Chip","label","selected","onPress","disabled","busy","leading","trailing","style","testID","c","styles","lead","size","thickness","color","primary","foreground","inner","chip","chipOn","undefined","children","text","textOn","numberOfLines","chipHitSlopV","Math","max","round","hitTarget","inactive","accessibilityRole","accessibilityState","accessibilityLabel","hitSlop","top","bottom","left","right","pressed","alignSelf","opacity"],"sourceRoot":"../../../../../src","sources":["components/ui/Chip/Chip.tsx"],"mappings":"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","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/Chip/Chip.d.ts

@@ -6,8 +6,9 @@ import type { ChipProps } from './types';
  * - 选中：主色边框 + 主色文本
  * - 按下：透明度 pressedOpacity(与 ButtonBase 同源)
  * - 禁用：透明度 0.5 + 不响应 onPress
+ * - 处理中(`busy`)：leading 换 spinner + 透明度 0.6 + 不响应二次点击
  *
  * 常用于建议 chip、筛选 pill、多选标签等。
  */
-export declare function Chip({ label, selected, onPress, disabled, leading, trailing, style, testID, }: ChipProps): React.JSX.Element;
+export declare function Chip({ label, selected, onPress, disabled, busy, leading, trailing, style, testID, }: ChipProps): React.JSX.Element;
 //# sourceMappingURL=Chip.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Chip.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Chip/Chip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,EACnB,KAAK,EACL,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,KAAK,EACL,MAAM,GACP,EAAE,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA2C/B"}
+{"version":3,"file":"Chip.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Chip/Chip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAa1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAQzC;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,EACnB,KAAK,EACL,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,KAAK,EACL,MAAM,GACP,EAAE,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAmE/B"}

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

@@ -6,6 +6,10 @@ export type ChipProps = {
     onPress?: () => void;
     /** 整体禁用:opacity 0.5 + 不响应 onPress + accessibilityState.disabled */
     disabled?: boolean;
+    /** 处理中(点了、请求在飞):leading 位换 spinner + opacity 0.6 + 不响应二次点击 +
+     *  accessibilityState.busy。label 保留 —— 换掉它 chip 会塌成一个圆点、整行跟着重排。
+     *  与 `disabled` 的分工:disabled = 现在不能点(更暗、无 spinner),busy = 正在办。 */
+    busy?: boolean;
     /** 可选的前置插槽 —— 如 <Icon name="spark" /> */
     leading?: ReactNode;
     /** 可选的后置插槽 —— 如一个小的 × 关闭按钮 */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Chip/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,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/Chip/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;sEAEkE;IAClE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,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":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACpC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,UAAU,IAAI,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EACV,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unif/react-native-design",
-  "version": "0.18.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/Chip/Chip.tsx

@@ -1,16 +1,31 @@
 import React from 'react';
 import { Text, View } from 'react-native';
 import { Pressable } from 'react-native-gesture-handler';
-import { fixed, pressedOpacity, r, rf, useThemedStyles } from '../../../theme';
+import {
+  fixed,
+  pressedOpacity,
+  r,
+  rf,
+  useColors,
+  useThemedStyles,
+} from '../../../theme';
+import { Spinner } from '../Spinner';
 import { makeStyles } from './styles';
 import type { ChipProps } from './types';
 
+/** 处理中 chip 的透明度 —— 比 disabled(0.5)亮、比按下(pressedOpacity)暗:
+ *  「正在办」既要压下去,又不能和「不能点」长一样(那两者只靠 spinner 区分就太弱了)。 */
+const busyOpacity = 0.6;
+/** busy spinner 直径 —— 与调用方常用的 leading icon(12)等大,顶替时不改 chip 宽度。 */
+const busySpinner = r(12);
+
 /**
  * 胶囊形可点击 chip。
  * - 默认：surface 底 + outline 细线边框，foreground 文本
  * - 选中：主色边框 + 主色文本
  * - 按下：透明度 pressedOpacity(与 ButtonBase 同源)
  * - 禁用：透明度 0.5 + 不响应 onPress
+ * - 处理中(`busy`)：leading 换 spinner + 透明度 0.6 + 不响应二次点击
  *
  * 常用于建议 chip、筛选 pill、多选标签等。
  */
@@ -19,18 +34,31 @@ export function Chip({
   selected,
   onPress,
   disabled,
+  busy,
   leading,
   trailing,
   style,
   testID,
 }: ChipProps): React.JSX.Element {
+  const c = useColors();
   const styles = useThemedStyles(makeStyles);
+  // 处理中把 spinner 放进 leading 位(有 leading 就顶掉它):label 必须留着 —— 换掉它 chip
+  // 会塌成一个圆点,同排 chip 集体重排。spinner 跟随文本色,不在未选中的 chip 上凭空冒主色。
+  const lead = busy ? (
+    <Spinner
+      size={busySpinner}
+      thickness={r(1.5)}
+      color={selected ? c.primary : c.foreground}
+    />
+  ) : (
+    leading
+  );
   const inner = (
     <View
       style={[styles.chip, selected && styles.chipOn, style]}
       testID={onPress ? undefined : testID}
     >
-      {leading != null ? <View>{leading}</View> : null}
+      {lead != null ? <View>{lead}</View> : null}
       <Text style={[styles.text, selected && styles.textOn]} numberOfLines={1}>
         {label}
       </Text>
@@ -45,19 +73,31 @@ export function Chip({
       0,
       Math.round((fixed.hitTarget - (2 * r(8) + rf(13) * 1.4)) / 2)
     );
+    // 处理中同样不响应:chip 的高频用法是「点一下发起一次请求」,放行二次点击就是重复提交。
+    const inactive = !!disabled || !!busy;
     return (
       <Pressable
         onPress={onPress}
-        disabled={disabled}
+        disabled={inactive}
         accessibilityRole="button"
-        accessibilityState={{ selected: !!selected, disabled: !!disabled }}
+        accessibilityState={{
+          selected: !!selected,
+          disabled: inactive,
+          busy: !!busy,
+        }}
         accessibilityLabel={label}
         testID={testID}
         hitSlop={{ top: chipHitSlopV, bottom: chipHitSlopV, left: 0, right: 0 }}
         style={({ pressed }) => [
           {
             alignSelf: 'flex-start',
-            opacity: disabled ? 0.5 : pressed ? pressedOpacity : 1,
+            opacity: disabled
+              ? 0.5
+              : busy
+                ? busyOpacity
+                : pressed
+                  ? pressedOpacity
+                  : 1,
           },
         ]}
       >

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

@@ -7,6 +7,10 @@ export type ChipProps = {
   onPress?: () => void;
   /** 整体禁用:opacity 0.5 + 不响应 onPress + accessibilityState.disabled */
   disabled?: boolean;
+  /** 处理中(点了、请求在飞):leading 位换 spinner + opacity 0.6 + 不响应二次点击 +
+   *  accessibilityState.busy。label 保留 —— 换掉它 chip 会塌成一个圆点、整行跟着重排。
+   *  与 `disabled` 的分工:disabled = 现在不能点(更暗、无 spinner),busy = 正在办。 */
+  busy?: boolean;
   /** 可选的前置插槽 —— 如 <Icon name="spark" /> */
   leading?: ReactNode;
   /** 可选的后置插槽 —— 如一个小的 × 关闭按钮 */

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';