@seakoi/native-ui 1.1.0 → 1.1.1

package/dist/commonjs/components/base/carousel/hooks/use-carousel-swipe.js

@@ -0,0 +1,140 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useCarouselSwipe = void 0;
+var _ahooks = require("ahooks");
+var _lodashEs = require("lodash-es");
+var _react = require("react");
+/**
+ * 轮播图切换逻辑 Hook
+ *
+ * 实现轮播图的切换功能，包括切换到指定索引、下一项、上一项。
+ * 处理循环播放时的边界无缝跳转，确保视觉上的连续性。
+ * 通过 ref 暴露切换方法供外部调用。
+ *
+ * @param params - Hook 参数配置
+ * @param params.total - 轮播项总数
+ * @param params.loopEnabled - 是否启用循环播放
+ * @param params.clonesBefore - 循环播放时前置克隆节点数量
+ * @param params.slidePixels - 单个滑块的像素大小
+ * @param params.extTotal - 扩展总数（包含克隆项）
+ * @param params.extIndexRef - 扩展索引的引用
+ * @param params.getBoundedPosition - 获取边界限制后的位置
+ * @param params.getIndexFromExtIndex - 从扩展索引获取逻辑索引
+ * @param params.getTargetExtIndexForIndex - 获取目标扩展索引
+ * @param params.updateCurrent - 更新当前索引
+ * @param params.maybeReportIndex - 可能触发索引变化回调
+ * @param params.setAnimating - 设置动画状态
+ * @param params.animateTo - 执行动画到指定位置
+ * @param params.setPositionImmediate - 立即设置位置
+ * @param params.ref - 组件 ref，用于暴露实例方法
+ *
+ * @returns Hook 返回值
+ * @returns swipeTo - 切换到指定索引的方法
+ * @returns swipeNext - 切换到下一项的方法
+ * @returns swipePrev - 切换到上一项的方法
+ * @returns swipeToExtIndex - 切换到扩展索引的方法
+ * @returns finalizeLoopJumpIfNeeded - 完成循环边界跳转的方法
+ */
+const useCarouselSwipe = params => {
+  const {
+    total,
+    loopEnabled,
+    clonesBefore,
+    slidePixels,
+    extTotal,
+    extIndexRef,
+    getBoundedPosition,
+    getIndexFromExtIndex,
+    getTargetExtIndexForIndex,
+    updateCurrent,
+    maybeReportIndex,
+    setAnimating,
+    animateTo,
+    setPositionImmediate,
+    ref
+  } = params;
+  const finalizeLoopJumpIfNeeded = (0, _ahooks.useMemoizedFn)(() => {
+    if (!loopEnabled) return;
+    const currentExt = extIndexRef.current;
+    if (currentExt < clonesBefore) {
+      const targetExt = currentExt + total;
+      extIndexRef.current = targetExt;
+      if (slidePixels > 0) setPositionImmediate(targetExt * slidePixels);
+      return;
+    }
+    if (currentExt >= clonesBefore + total) {
+      const targetExt = currentExt - total;
+      extIndexRef.current = targetExt;
+      if (slidePixels > 0) setPositionImmediate(targetExt * slidePixels);
+    }
+  });
+  const swipeToExtIndex = (0, _ahooks.useMemoizedFn)(targetExtIndex => {
+    if (total <= 0) return;
+    if (slidePixels <= 0) {
+      extIndexRef.current = (0, _lodashEs.clamp)(targetExtIndex, 0, extTotal - 1);
+      setAnimating(false);
+      updateCurrent(getIndexFromExtIndex(extIndexRef.current));
+      return;
+    }
+    const boundedExtIndex = (0, _lodashEs.clamp)(targetExtIndex, 0, extTotal - 1);
+    extIndexRef.current = boundedExtIndex;
+    const nextIndex = getIndexFromExtIndex(boundedExtIndex);
+    updateCurrent(nextIndex);
+    const rawPosition = boundedExtIndex * slidePixels;
+    const toPosition = getBoundedPosition(rawPosition);
+    setAnimating(true);
+    animateTo(toPosition, () => {
+      finalizeLoopJumpIfNeeded();
+      const normalizedIndex = getIndexFromExtIndex(extIndexRef.current);
+      updateCurrent(normalizedIndex);
+      maybeReportIndex(normalizedIndex);
+      setAnimating(false);
+    });
+  });
+  const swipeTo = (0, _ahooks.useMemoizedFn)(index => {
+    if (total <= 0) return;
+    const targetIndex = (0, _lodashEs.clamp)(Math.round(index), 0, total - 1);
+    const targetExtIndex = getTargetExtIndexForIndex(targetIndex);
+    swipeToExtIndex(targetExtIndex);
+  });
+  const swipeNext = (0, _ahooks.useMemoizedFn)(() => {
+    if (total <= 1) return;
+    let currentExt = extIndexRef.current;
+    // 若当前处于 after-clone 区域（快速连击导致 finalizeLoopJumpIfNeeded 尚未执行），
+    // 立即将位置平移回真实 item 区域（视觉内容相同，不可感知），再继续前进
+    if (clonesBefore > 0 && currentExt >= clonesBefore + total) {
+      currentExt -= total;
+      extIndexRef.current = currentExt;
+      if (slidePixels > 0) setPositionImmediate(currentExt * slidePixels);
+    }
+    swipeToExtIndex(currentExt + 1);
+  });
+  const swipePrev = (0, _ahooks.useMemoizedFn)(() => {
+    if (total <= 1) return;
+    let currentExt = extIndexRef.current;
+    // 若当前处于 before-clone 区域（快速连击导致 finalizeLoopJumpIfNeeded 尚未执行），
+    // 立即将位置平移回真实 item 区域（视觉内容相同，不可感知），再继续后退
+    if (clonesBefore > 0 && currentExt < clonesBefore) {
+      currentExt += total;
+      extIndexRef.current = currentExt;
+      if (slidePixels > 0) setPositionImmediate(currentExt * slidePixels);
+    }
+    swipeToExtIndex(currentExt - 1);
+  });
+  (0, _react.useImperativeHandle)(ref, () => ({
+    swipeTo,
+    swipeNext,
+    swipePrev
+  }), [swipeNext, swipePrev, swipeTo]);
+  return {
+    swipeTo,
+    swipeNext,
+    swipePrev,
+    swipeToExtIndex,
+    finalizeLoopJumpIfNeeded
+  };
+};
+exports.useCarouselSwipe = useCarouselSwipe;

package/dist/commonjs/components/base/carousel/style/index.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.useCarouselStyles = void 0;
 var _index = require("../../../../native-provider/index.js");
+const INDICATOR_DOT_SIZE = 6;
 const useCarouselStyles = exports.useCarouselStyles = (0, _index.createThemedStyles)(theme => ({
   container: {
     overflow: 'hidden',
@@ -28,15 +29,15 @@ const useCarouselStyles = exports.useCarouselStyles = (0, _index.createThemedSty
     position: 'absolute',
     left: 0,
     right: 0,
-    bottom: 8,
+    bottom: theme.spacing.sm,
     flexDirection: 'row',
     justifyContent: 'center',
     alignItems: 'center',
-    gap: 6
+    gap: theme.spacing.xs
   },
   indicatorDot: {
-    width: 6,
-    height: 6,
+    width: INDICATOR_DOT_SIZE,
+    height: INDICATOR_DOT_SIZE,
     borderRadius: theme.roundness.full,
     backgroundColor: theme.palette.fontGray5,
     opacity: 0.6

package/dist/commonjs/components/base/carousel/utils.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.normalizeChildren = exports.isRenderPropChildren = exports.getDefaultTotal = void 0;
+exports.normalizeChildren = exports.isRenderPropChildren = exports.getDefaultTotal = exports.getBoundaryIndexRange = void 0;
 var _react = require("react");
 const isRenderPropChildren = children => {
   return typeof children === 'function';
@@ -24,4 +24,40 @@ const getDefaultTotal = children => {
   if (isRenderPropChildren(children)) return 0;
   return Array.isArray(children) ? children.length : 1;
 };
-exports.getDefaultTotal = getDefaultTotal;
+
+/**
+ * 计算轮播边界索引范围
+ *
+ * @param params - 参数配置
+ * @param params.total - 轮播项总数
+ * @param params.slideSize - 单个滑块所占百分比 (0-100)
+ * @param params.trackOffset - 轨道偏移百分比 (0-100)
+ * @param params.stuckAtBoundary - 是否在边界处卡住
+ * @returns 边界索引范围 { min, max }
+ */
+exports.getDefaultTotal = getDefaultTotal;
+const getBoundaryIndexRange = params => {
+  const {
+    total,
+    slideSize,
+    trackOffset,
+    stuckAtBoundary
+  } = params;
+  if (total <= 0) return {
+    min: 0,
+    max: 0
+  };
+  if (!stuckAtBoundary) return {
+    min: 0,
+    max: total - 1
+  };
+  const slideRatio = slideSize / 100;
+  const offsetRatio = trackOffset / 100;
+  const min = 0 + offsetRatio / (slideRatio || 1);
+  const max = total - 1 - (1 - slideRatio - offsetRatio) / (slideRatio || 1);
+  return {
+    min,
+    max
+  };
+};
+exports.getBoundaryIndexRange = getBoundaryIndexRange;

package/dist/commonjs/components/base/index.js

@@ -14,7 +14,7 @@ Object.keys(_index).forEach(function (key) {
     }
   });
 });
-var _index2 = require("./async-boundary/index.js");
+var _index2 = require("./address-picker-view/index.js");
 Object.keys(_index2).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index2[key]) return;
@@ -25,7 +25,7 @@ Object.keys(_index2).forEach(function (key) {
     }
   });
 });
-var _index3 = require("./avatar/index.js");
+var _index3 = require("./async-boundary/index.js");
 Object.keys(_index3).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index3[key]) return;
@@ -36,7 +36,7 @@ Object.keys(_index3).forEach(function (key) {
     }
   });
 });
-var _index4 = require("./back-to-top/index.js");
+var _index4 = require("./avatar/index.js");
 Object.keys(_index4).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index4[key]) return;
@@ -47,7 +47,7 @@ Object.keys(_index4).forEach(function (key) {
     }
   });
 });
-var _index5 = require("./badge/index.js");
+var _index5 = require("./back-to-top/index.js");
 Object.keys(_index5).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index5[key]) return;
@@ -58,7 +58,7 @@ Object.keys(_index5).forEach(function (key) {
     }
   });
 });
-var _index6 = require("./button/index.js");
+var _index6 = require("./badge/index.js");
 Object.keys(_index6).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index6[key]) return;
@@ -69,7 +69,7 @@ Object.keys(_index6).forEach(function (key) {
     }
   });
 });
-var _index7 = require("./calendar/index.js");
+var _index7 = require("./button/index.js");
 Object.keys(_index7).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index7[key]) return;
@@ -80,7 +80,7 @@ Object.keys(_index7).forEach(function (key) {
     }
   });
 });
-var _index8 = require("./carousel/index.js");
+var _index8 = require("./calendar/index.js");
 Object.keys(_index8).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index8[key]) return;
@@ -91,7 +91,7 @@ Object.keys(_index8).forEach(function (key) {
     }
   });
 });
-var _index9 = require("./cell/index.js");
+var _index9 = require("./carousel/index.js");
 Object.keys(_index9).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index9[key]) return;
@@ -102,7 +102,7 @@ Object.keys(_index9).forEach(function (key) {
     }
   });
 });
-var _index0 = require("./checkbox/index.js");
+var _index0 = require("./cell/index.js");
 Object.keys(_index0).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index0[key]) return;
@@ -113,7 +113,7 @@ Object.keys(_index0).forEach(function (key) {
     }
   });
 });
-var _index1 = require("./collapse/index.js");
+var _index1 = require("./checkbox/index.js");
 Object.keys(_index1).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index1[key]) return;
@@ -124,7 +124,7 @@ Object.keys(_index1).forEach(function (key) {
     }
   });
 });
-var _index10 = require("./countdown/index.js");
+var _index10 = require("./collapse/index.js");
 Object.keys(_index10).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index10[key]) return;
@@ -135,7 +135,7 @@ Object.keys(_index10).forEach(function (key) {
     }
   });
 });
-var _index11 = require("./date-picker/index.js");
+var _index11 = require("./countdown/index.js");
 Object.keys(_index11).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index11[key]) return;
@@ -146,7 +146,7 @@ Object.keys(_index11).forEach(function (key) {
     }
   });
 });
-var _index12 = require("./date-picker-view/index.js");
+var _index12 = require("./date-picker/index.js");
 Object.keys(_index12).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index12[key]) return;
@@ -157,7 +157,7 @@ Object.keys(_index12).forEach(function (key) {
     }
   });
 });
-var _index13 = require("./divider/index.js");
+var _index13 = require("./date-picker-view/index.js");
 Object.keys(_index13).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index13[key]) return;
@@ -168,7 +168,7 @@ Object.keys(_index13).forEach(function (key) {
     }
   });
 });
-var _index14 = require("./flex/index.js");
+var _index14 = require("./divider/index.js");
 Object.keys(_index14).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index14[key]) return;
@@ -179,7 +179,7 @@ Object.keys(_index14).forEach(function (key) {
     }
   });
 });
-var _index15 = require("./form/index.js");
+var _index15 = require("./flex/index.js");
 Object.keys(_index15).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index15[key]) return;
@@ -190,7 +190,7 @@ Object.keys(_index15).forEach(function (key) {
     }
   });
 });
-var _index16 = require("./input/index.js");
+var _index16 = require("./form/index.js");
 Object.keys(_index16).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index16[key]) return;
@@ -201,7 +201,7 @@ Object.keys(_index16).forEach(function (key) {
     }
   });
 });
-var _index17 = require("./link/index.js");
+var _index17 = require("./input/index.js");
 Object.keys(_index17).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index17[key]) return;
@@ -212,7 +212,7 @@ Object.keys(_index17).forEach(function (key) {
     }
   });
 });
-var _index18 = require("./loading/index.js");
+var _index18 = require("./link/index.js");
 Object.keys(_index18).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index18[key]) return;
@@ -223,7 +223,7 @@ Object.keys(_index18).forEach(function (key) {
     }
   });
 });
-var _index19 = require("./modal/index.js");
+var _index19 = require("./loading/index.js");
 Object.keys(_index19).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index19[key]) return;
@@ -234,7 +234,7 @@ Object.keys(_index19).forEach(function (key) {
     }
   });
 });
-var _index20 = require("./nav-bar/index.js");
+var _index20 = require("./modal/index.js");
 Object.keys(_index20).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index20[key]) return;
@@ -245,7 +245,7 @@ Object.keys(_index20).forEach(function (key) {
     }
   });
 });
-var _index21 = require("./picker/index.js");
+var _index21 = require("./nav-bar/index.js");
 Object.keys(_index21).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index21[key]) return;
@@ -256,7 +256,7 @@ Object.keys(_index21).forEach(function (key) {
     }
   });
 });
-var _index22 = require("./picker-view/index.js");
+var _index22 = require("./picker/index.js");
 Object.keys(_index22).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index22[key]) return;
@@ -267,7 +267,7 @@ Object.keys(_index22).forEach(function (key) {
     }
   });
 });
-var _index23 = require("./portal/index.js");
+var _index23 = require("./picker-view/index.js");
 Object.keys(_index23).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index23[key]) return;
@@ -278,7 +278,7 @@ Object.keys(_index23).forEach(function (key) {
     }
   });
 });
-var _index24 = require("./radio/index.js");
+var _index24 = require("./portal/index.js");
 Object.keys(_index24).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index24[key]) return;
@@ -289,7 +289,7 @@ Object.keys(_index24).forEach(function (key) {
     }
   });
 });
-var _index25 = require("./result/index.js");
+var _index25 = require("./radio/index.js");
 Object.keys(_index25).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index25[key]) return;
@@ -300,7 +300,7 @@ Object.keys(_index25).forEach(function (key) {
     }
   });
 });
-var _index26 = require("./surface/index.js");
+var _index26 = require("./result/index.js");
 Object.keys(_index26).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index26[key]) return;
@@ -311,7 +311,7 @@ Object.keys(_index26).forEach(function (key) {
     }
   });
 });
-var _index27 = require("./switch/index.js");
+var _index27 = require("./surface/index.js");
 Object.keys(_index27).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index27[key]) return;
@@ -322,7 +322,7 @@ Object.keys(_index27).forEach(function (key) {
     }
   });
 });
-var _index28 = require("./tabs/index.js");
+var _index28 = require("./switch/index.js");
 Object.keys(_index28).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index28[key]) return;
@@ -333,7 +333,7 @@ Object.keys(_index28).forEach(function (key) {
     }
   });
 });
-var _index29 = require("./text/index.js");
+var _index29 = require("./tabs/index.js");
 Object.keys(_index29).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _index29[key]) return;
@@ -343,4 +343,15 @@ Object.keys(_index29).forEach(function (key) {
       return _index29[key];
     }
   });
+});
+var _index30 = require("./text/index.js");
+Object.keys(_index30).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _index30[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _index30[key];
+    }
+  });
 });

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

@@ -97,8 +97,8 @@ const PickerView = ({
     }
   });
   const handlers = (0, _react.useMemo)(() => {
-    return columns.map((_, index) => item => handleChange(item, index));
-  }, [columns, handleChange]);
+    return options.map((_, index) => item => handleChange(item, index));
+  }, [options, handleChange]);
 
   // 非受控模式的初始化：只在首次挂载时设置默认值
   const initializedRef = (0, _react.useRef)(false);