@tarojs/components-advanced 4.1.12-beta.9 → 4.2.0

package/dist/components/water-flow/water-flow.js.map

@@ -1 +1 @@
-{"version":3,"file":"water-flow.js","sources":["../../../src/components/water-flow/water-flow.ts"],"sourcesContent":["import { BaseEventOrig, ScrollView, ScrollViewProps, View } from '@tarojs/components'\nimport { type ScrollElementContextValue, ScrollElementContext } from '@tarojs/components-react'\nimport { nextTick } from '@tarojs/taro'\nimport {\n  Children,\n  cloneElement,\n  createElement,\n  PropsWithChildren,\n  ReactElement,\n  useContext,\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n} from 'react'\n\nimport { debounce, getScrollViewContextNode } from '../../utils'\nimport { useMeasureStartOffset } from '../list/hooks/useMeasureStartOffset'\nimport { useScrollParentAutoFind } from '../list/hooks/useScrollParentAutoFind'\nimport { _FlowSectionProps } from './flow-section'\nimport { Root, RootEvents } from './root'\nimport { Section } from './section'\nimport { useMemoizedFn } from './use-memoized-fn'\nimport { useObservedAttr } from './use-observed-attr'\nimport { getSysInfo, isH5 } from './utils'\n\nimport type { ScrollDirection, WaterFlowProps } from './interface'\n\ngetSysInfo()\n\nexport function WaterFlow({ children, ...props }: PropsWithChildren<WaterFlowProps>) {\n  const {\n    id,\n    style = {},\n    className,\n    cacheCount = 1,\n    onScrollToUpper,\n    onScrollToLower,\n    upperThresholdCount,\n    lowerThresholdCount,\n    scrollIntoView,\n    nestedScroll,\n    scrollElement,\n    startOffset,\n    containerHeight,\n    onScrollHeightChange,\n    onScrollIntoViewComplete,\n    ...rest\n  } = props\n  // 与 plato 对齐：nestedScroll=true 为嵌套模式，不配置则为 default\n  const flowType = nestedScroll === true ? 'nested' : 'default'\n  // 任务 4.1：从 ScrollElementContext 获取（List/ScrollView 内嵌时统一提供）\n  const scrollElementCtx = useContext(ScrollElementContext) as ScrollElementContextValue | null\n  const contentWrapperRef = useRef<HTMLDivElement>(null)\n  const needAutoFind =\n    flowType === 'nested' &&\n    !scrollElement &&\n    !scrollElementCtx?.scrollRef &&\n    isH5\n  const { scrollParentRef: autoFoundRef, status: autoFindStatus } = useScrollParentAutoFind(\n    contentWrapperRef,\n    { enabled: !!needAutoFind, isHorizontal: false }\n  )\n  const effectiveScrollElement =\n    scrollElement ??\n    scrollElementCtx?.scrollRef ??\n    (needAutoFind && autoFindStatus === 'found' ? autoFoundRef : null)\n  // 当 Context 的 startOffset 为 0 时也需测量：ScrollView 默认传 0，上方有固定内容时需自动测量\n  const ctxStart = scrollElementCtx?.startOffset\n  const hasExplicitStartOffset = ctxStart != null && ctxStart > 0\n  const needMeasureStartOffset =\n    flowType === 'nested' &&\n    effectiveScrollElement &&\n    isH5 &&\n    startOffset == null &&\n    !hasExplicitStartOffset\n  const measuredStartOffset = useMeasureStartOffset(\n    effectiveScrollElement ?? { current: null },\n    contentWrapperRef,\n    { enabled: !!needMeasureStartOffset, isHorizontal: false }\n  )\n  // 当 Context 传 0 或未传时用测量值兜底\n  const effectiveStartOffset =\n    startOffset ??\n    (ctxStart != null && ctxStart > 0 ? ctxStart : null) ??\n    measuredStartOffset ??\n    0\n  const effectiveContainerHeight = containerHeight ?? scrollElementCtx?.containerHeight\n\n  const startOffsetRef = useRef(effectiveStartOffset)\n  const containerHeightRef = useRef(effectiveContainerHeight)\n  const lastReportedHeightRef = useRef<number>(0)\n  startOffsetRef.current = effectiveStartOffset\n  containerHeightRef.current = effectiveContainerHeight\n\n  // nestedScroll 时显式开启 scrollElement 模式；否则始终用 default（自有 ScrollView）\n  const useScrollElementMode =\n    flowType === 'nested' && !!(effectiveScrollElement && isH5)\n  if (flowType === 'nested' && !effectiveScrollElement && isH5 && autoFindStatus === 'not-found') {\n    // eslint-disable-next-line no-console\n    console.warn('[WaterFlow] nestedScroll 模式但无 scrollElement（props/Context/自动查找），回退为 default，将渲染自有 ScrollView')\n  }\n  const defaultId = useId().replace(/:/g, '')\n  /**\n   * 初始化数据模型\n   */\n  const root = useMemo(() => {\n    return new Root({\n      id: id ?? defaultId,\n      cacheCount,\n      upperThresholdCount,\n      lowerThresholdCount,\n      skipContainerMeasure: useScrollElementMode || (!!needAutoFind && autoFindStatus === 'pending'),\n    })\n  }, [id, cacheCount, upperThresholdCount, lowerThresholdCount, useScrollElementMode, needAutoFind, autoFindStatus])\n  const isScrolling$ = useObservedAttr(root, 'isScrolling')\n  const scrollHeight$ = useObservedAttr(root, 'scrollHeight')\n  const renderRange$ = useObservedAttr(root, 'renderRange')\n  const refEventOrig = useRef<BaseEventOrig>()\n\n  /**\n   * 滚动事件\n   */\n  const handleScroll = useMemoizedFn((ev: BaseEventOrig<ScrollViewProps.onScrollDetail>) => {\n    refEventOrig.current = ev\n    root.sections.forEach((section) => section.getNodeRenderRange())\n    const { scrollTop } = ev.detail\n    // 确定滚动方向\n    const scrollDirection: ScrollDirection = root.getState().scrollOffset < scrollTop ? 'forward' : 'backward'\n    // 设置滚动信息，包括方向和偏移量\n    root.setStateBatch({\n      scrollDirection: scrollDirection,\n      scrollOffset: scrollTop,\n      isScrolling: true,\n    })\n  })\n\n  const sections = useMemo(() => {\n    const [start, end] = renderRange$\n    return Children.map(children, (child: ReactElement<PropsWithChildren<_FlowSectionProps>>, order) => {\n      if (Object.is(child, null)) {\n        return null\n      }\n      const sectionProps = child.props\n      const sectionId = sectionProps.id || `section-${order}`\n      const childCount = Children.count(sectionProps.children)\n      let section = root.findSection(sectionId)\n      if (section) {\n        const originalCount = section.count\n        if (childCount > originalCount) {\n          section.pushNodes(childCount - originalCount)\n        }\n      } else {\n        section = new Section(root, {\n          id: sectionId,\n          order,\n          col: sectionProps.column ?? 1,\n          rowGap: sectionProps.rowGap || 0,\n          columnGap: sectionProps.columnGap || 0,\n          count: Children.count(sectionProps.children),\n        })\n      }\n\n      return cloneElement(child, { section, key: `${props.id}-${order}` })\n    })?.slice(start, end + 1)\n  }, [renderRange$[0], renderRange$[1], children, root, props.id])\n\n  const scrollTo = useMemoizedFn((scrollOffset = 0) => {\n    scrollOffset = Math.max(0, scrollOffset)\n    if (root.getState().scrollOffset === scrollOffset) return\n    // scrollElement 模式下需操作外部容器，且需加上 startOffset\n    if (useScrollElementMode && effectiveScrollElement?.current && isH5) {\n      const el = effectiveScrollElement.current\n      const scrollTarget = scrollOffset + (startOffsetRef.current ?? 0)\n      el.scrollTo({ top: scrollTarget })\n      root.setStateBatch({ scrollOffset, isScrolling: true })\n      root.sections.forEach((s) => s.getNodeRenderRange())\n      return\n    }\n    getScrollViewContextNode(`#${root.id}`).then((node: any) => {\n      node.scrollTo({\n        animated: true,\n        duration: 300,\n        top: scrollOffset,\n      })\n    })\n  })\n\n  const resetScrolling = useMemoizedFn(() => {\n    root.setStateIn('isScrolling', false)\n  })\n\n  const debouncedResetScrolling = debounce(resetScrolling)\n\n  useEffect(() => {\n    debouncedResetScrolling()\n  }, [isScrolling$])\n\n  /**\n   * 处理滚动阈值\n   * root 需入参：autoFind 从 pending→found 时 root 会重建，必须对新 root 重新订阅\n   */\n  useEffect(() => {\n    const disposers = [\n      root.sub(\n        RootEvents.ReachUpperThreshold,\n        debounce(() => {\n          onScrollToUpper?.(refEventOrig.current!)\n        })\n      ),\n      root.sub(\n        RootEvents.ReachLowerThreshold,\n        debounce(() => {\n          onScrollToLower?.(refEventOrig.current!)\n        })\n      ),\n    ]\n    return () => {\n      disposers.forEach((disposer) => {\n        disposer()\n      })\n    }\n  }, [root, onScrollToUpper, onScrollToLower])\n\n  /**\n   * 处理 scrollIntoView\n   * 竞态：快速切换目标时，取消前一次滚动，避免后发先至\n   */\n  useEffect(() => {\n    let cancelled = false\n    handleScrollIntoView()\n    async function handleScrollIntoView() {\n      if (!scrollIntoView) return\n      const targetNode = root.findNode(scrollIntoView)\n      if (!targetNode) {\n        nextTick(() => { if (!cancelled) onScrollIntoViewComplete?.() })\n        return\n      }\n      const targetSection = targetNode.section\n      const doScroll = () => {\n        if (cancelled) return\n        scrollTo(targetNode.getState().scrollTop)\n        if (cancelled) return\n        nextTick(() => { if (!cancelled) onScrollIntoViewComplete?.() })\n      }\n      if (!targetSection.getState().layouted) {\n        const order = targetSection.order\n        root.setStateIn('renderRange', [\n          Math.min(renderRange$[0], order),\n          Math.max(renderRange$[1], order),\n        ])\n        nextTick(async () => {\n          await targetNode.section.layoutedSignal.promise\n          if (cancelled) return\n          doScroll()\n        })\n        return\n      }\n      await targetSection.layoutedSignal.promise\n      if (cancelled) return\n      doScroll()\n    }\n    return () => { cancelled = true }\n  }, [scrollIntoView, renderRange$[0], renderRange$[1], onScrollIntoViewComplete])\n\n  // 任务 3.3：scrollElement 模式下监听外部滚动，更新 root.scrollOffset\n  // effectiveStartOffset 变化时（如自动测量完成）需重新同步\n  // 内嵌时 scrollRef 可能尚未就绪（父 List 的 useLayoutEffect 晚于子 useEffect），需重试\n  useEffect(() => {\n    if (!useScrollElementMode || !effectiveScrollElement) return\n\n    let cancelled = false\n    let teardown: (() => void) | null = null\n    const maxRetries = 20\n\n    const tryAttach = (retryCount = 0) => {\n      if (cancelled) return\n      const target = effectiveScrollElement.current\n      if (!target) {\n        if (retryCount < maxRetries) {\n          requestAnimationFrame(() => tryAttach(retryCount + 1))\n        }\n        return\n      }\n\n      const handler = () => {\n        const scrollTop = target.scrollTop\n        const offset = scrollTop - (startOffsetRef.current ?? 0)\n        const effectiveOffset = Math.max(0, offset)\n        const prevOffset = root.getState().scrollOffset\n        const scrollDirection: ScrollDirection = prevOffset < effectiveOffset ? 'forward' : 'backward'\n\n        root.sections.forEach((section) => section.getNodeRenderRange())\n        root.setStateBatch({\n          scrollDirection,\n          scrollOffset: effectiveOffset,\n          isScrolling: true,\n        })\n      }\n\n      const initialOffset = Math.max(0, target.scrollTop - (startOffsetRef.current ?? 0))\n      root.setStateBatch({ scrollOffset: initialOffset, isScrolling: true })\n      root.sections.forEach((s) => s.getNodeRenderRange())\n      target.addEventListener('scroll', handler, { passive: true })\n      teardown = () => target.removeEventListener('scroll', handler)\n    }\n\n    tryAttach()\n    return () => {\n      cancelled = true\n      teardown?.()\n    }\n  }, [useScrollElementMode, effectiveScrollElement, root, effectiveStartOffset])\n\n  // 任务 4.2：scrollHeight 变化时回调，便于 List 动高联动（props 优先，其次从 Context 获取）\n  // 防抖上报：Root 多源触发 updateScrollHeight 可能产生多轮不同值；等 150ms 无新值时上报当前值（视为布局收敛结果）\n  const reportHeight = onScrollHeightChange ?? scrollElementCtx?.reportNestedHeightChange\n  useEffect(() => {\n    if (!reportHeight || scrollHeight$ <= 0) return\n    const timer = setTimeout(() => {\n      if (Math.abs(lastReportedHeightRef.current - scrollHeight$) < 1) return\n      lastReportedHeightRef.current = scrollHeight$\n      reportHeight(scrollHeight$)\n    }, 150)\n    return () => clearTimeout(timer)\n  }, [scrollHeight$, reportHeight])\n\n  // 任务 3.4：scrollElement 模式下 containerSize 从 containerHeight / scrollElement 获取\n  // ResizeObserver 监听 scrollElement 尺寸变化；containerHeight prop 变化时也需同步（如 List 内嵌时父传子）\n  useEffect(() => {\n    if (!useScrollElementMode || !effectiveScrollElement) return\n    const el = effectiveScrollElement.current\n    if (!el || typeof ResizeObserver === 'undefined') return\n\n    const update = () => {\n      const height = containerHeightRef.current ?? el.clientHeight\n      const width = el.clientWidth\n      if (height > 0 && width > 0) {\n        root.setStateIn('containerSize', { width, height })\n      }\n    }\n    update()\n    const ro = new ResizeObserver(update)\n    ro.observe(el)\n    return () => ro.disconnect()\n  }, [useScrollElementMode, effectiveScrollElement, root, effectiveContainerHeight])\n\n  // 任务 3.2：scrollElement 模式下不渲染 ScrollView，只渲染内容 View\n  // 内容高度必须为 scrollHeight，否则父 scrollElement 无法正确滚动；显式写 height 覆盖 style 中的 height\n  // needAutoFind && pending：probe 阶段，渲染 View 以便 hook 能查找父滚动容器\n  const renderView =\n    useScrollElementMode || (!!needAutoFind && autoFindStatus === 'pending')\n  if (renderView) {\n    return createElement(\n      View,\n      {\n        ref: contentWrapperRef as any,\n        id: root.id,\n        style: {\n          ...style,\n          width: '100%',\n          position: 'relative',\n          height: scrollHeight$,\n          pointerEvents: isScrolling$ ? 'none' : 'auto',\n        },\n        className,\n      },\n      sections\n    )\n  }\n\n  return createElement(\n    ScrollView,\n    {\n      id: root.id,\n      style: {\n        WebkitOverflowScrolling: 'touch',\n        overflow: 'auto',\n        ...style,\n      },\n      className,\n      scrollY: true,\n      onScroll: handleScroll,\n      ...rest,\n    },\n    createElement(\n      View,\n      {\n        id: 'waterflow-root',\n        style: {\n          width: '100%',\n          position: 'relative',\n          height: scrollHeight$,\n          pointerEvents: isScrolling$ ? 'none' : 'auto',\n        },\n      },\n      sections\n    )\n  )\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"water-flow.js","sources":["../../../src/components/water-flow/water-flow.ts"],"sourcesContent":["import { BaseEventOrig, ScrollView, ScrollViewProps, View } from '@tarojs/components'\nimport { nextTick } from '@tarojs/taro'\nimport {\n  Children,\n  cloneElement,\n  createElement,\n  PropsWithChildren,\n  ReactElement,\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n} from 'react'\n\nimport { debounce, getScrollViewContextNode } from '../../utils'\nimport { _FlowSectionProps } from './flow-section'\nimport { Root, RootEvents } from './root'\nimport { Section } from './section'\nimport { useMemoizedFn } from './use-memoized-fn'\nimport { useObservedAttr } from './use-observed-attr'\nimport { getSysInfo } from './utils'\n\nimport type { ScrollDirection, WaterFlowProps } from './interface'\n\ngetSysInfo()\n\nexport function WaterFlow({ children, ...props }: PropsWithChildren<WaterFlowProps>) {\n  const {\n    id,\n    style = {},\n    className,\n    cacheCount = 1,\n    onScrollToUpper,\n    onScrollToLower,\n    upperThresholdCount,\n    lowerThresholdCount,\n    scrollIntoView,\n    ...rest\n  } = props\n  const defaultId = useId().replace(/:/g, '')\n  /**\n   * 初始化数据模型\n   */\n  const root = useMemo(() => {\n    return new Root({\n      id: id ?? defaultId,\n      cacheCount,\n      upperThresholdCount,\n      lowerThresholdCount,\n    })\n  }, [id, cacheCount, upperThresholdCount, lowerThresholdCount])\n  const isScrolling$ = useObservedAttr(root, 'isScrolling')\n  const scrollHeight$ = useObservedAttr(root, 'scrollHeight')\n  const renderRange$ = useObservedAttr(root, 'renderRange')\n  const refEventOrig = useRef<BaseEventOrig>()\n\n  /**\n   * 滚动事件\n   */\n  const handleScroll = useMemoizedFn((ev: BaseEventOrig<ScrollViewProps.onScrollDetail>) => {\n    refEventOrig.current = ev\n    root.sections.forEach((section) => section.getNodeRenderRange())\n    const { scrollTop } = ev.detail\n    // 确定滚动方向\n    const scrollDirection: ScrollDirection = root.getState().scrollOffset < scrollTop ? 'forward' : 'backward'\n    // 设置滚动信息，包括方向和偏移量\n    root.setStateBatch({\n      scrollDirection: scrollDirection,\n      scrollOffset: scrollTop,\n      isScrolling: true,\n    })\n  })\n\n  const sections = useMemo(() => {\n    const [start, end] = renderRange$\n    return Children.map(children, (child: ReactElement<PropsWithChildren<_FlowSectionProps>>, order) => {\n      if (Object.is(child, null)) {\n        return null\n      }\n      const sectionProps = child.props\n      const sectionId = sectionProps.id || `section-${order}`\n      const childCount = Children.count(sectionProps.children)\n      let section = root.findSection(sectionId)\n      if (section) {\n        const originalCount = section.count\n        if (childCount > originalCount) {\n          section.pushNodes(childCount - originalCount)\n        }\n      } else {\n        section = new Section(root, {\n          id: sectionId,\n          order,\n          col: sectionProps.column ?? 1,\n          rowGap: sectionProps.rowGap || 0,\n          columnGap: sectionProps.columnGap || 0,\n          count: Children.count(sectionProps.children),\n        })\n      }\n\n      return cloneElement(child, { section, key: `${props.id}-${order}` })\n    })?.slice(start, end + 1)\n  }, [renderRange$[0], renderRange$[1], children, root, props.id])\n\n  const scrollTo = useMemoizedFn((scrollOffset = 0) => {\n    scrollOffset = Math.max(0, scrollOffset)\n    if (root.getState().scrollOffset === scrollOffset) return\n    getScrollViewContextNode(`#${root.id}`).then((node: any) => {\n      node.scrollTo({\n        animated: true,\n        duration: 300,\n        top: scrollOffset,\n      })\n    })\n  })\n\n  const resetScrolling = useMemoizedFn(() => {\n    root.setStateIn('isScrolling', false)\n  })\n\n  const debouncedResetScrolling = debounce(resetScrolling)\n\n  useEffect(() => {\n    debouncedResetScrolling()\n  }, [isScrolling$])\n\n  /**\n   * 处理滚动阈值\n   */\n  useEffect(() => {\n    const disposers = [\n      root.sub(\n        RootEvents.ReachUpperThreshold,\n        debounce(() => {\n          onScrollToUpper?.(refEventOrig.current!)\n        })\n      ),\n      root.sub(\n        RootEvents.ReachLowerThreshold,\n        debounce(() => {\n          onScrollToLower?.(refEventOrig.current!)\n        })\n      ),\n    ]\n    return () => {\n      disposers.forEach((disposer) => {\n        disposer()\n      })\n    }\n  }, [onScrollToUpper, onScrollToLower])\n\n  /**\n   * 处理 scrollIntoView\n   */\n  useEffect(() => {\n    handleScrollIntoView()\n    async function handleScrollIntoView() {\n      if (scrollIntoView) {\n        if (root.getState().scrollOffset > 0) {\n          // 说明在自动滚动前手动滚动过了，不应该自动滚动了，避免造成困扰\n          return\n        }\n        const targetNode = root.findNode(scrollIntoView)\n        if (targetNode) {\n          const targetSection = targetNode.section\n          if (!targetSection.getState().layouted) {\n            const order = targetSection.order\n            root.setStateIn('renderRange', [renderRange$[0], order])\n            nextTick(async () => {\n              await targetNode.section.layoutedSignal.promise\n              scrollTo(targetNode.getState().scrollTop)\n            })\n            return\n          }\n          await targetNode.section.layoutedSignal.promise\n          scrollTo(targetNode.getState().scrollTop)\n        }\n      }\n    }\n  }, [scrollIntoView, renderRange$[0]])\n\n  return createElement(\n    ScrollView,\n    {\n      id: root.id,\n      style: {\n        WebkitOverflowScrolling: 'touch',\n        overflow: 'auto',\n        ...style,\n      },\n      className,\n      scrollY: true,\n      onScroll: handleScroll,\n      ...rest,\n    },\n    createElement(\n      View,\n      {\n        id: 'waterflow-root',\n        style: {\n          width: '100%',\n          position: 'relative',\n          height: scrollHeight$,\n          pointerEvents: isScrolling$ ? 'none' : 'auto',\n        },\n      },\n      sections\n    )\n  )\n}\n"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,9 +1,7 @@
 import './components/index.js';
 import './utils/index.js';
-export { ScrollElementContext as ListScrollElementContext } from '@tarojs/components-react';
 export { List, accumulate, isShaking } from './components/list/index.js';
 export { ListItem } from './components/list/ListItem.js';
-export { NoMore } from './components/list/NoMore.js';
 export { StickyHeader } from './components/list/StickyHeader.js';
 export { StickySection } from './components/list/StickySection.js';
 export { VirtualList } from './components/virtual-list/index.js';
@@ -16,6 +14,5 @@ export { getRectSize, getRectSizeSync, getScrollViewContextNode } from './utils/
 export { defaultItemKey, getOffsetForIndexAndAlignment } from './utils/helper.js';
 export { debounce, omit, throttle } from './utils/lodash.js';
 export { getMiddleNumber, isCosDistributing } from './utils/math.js';
-export { findScrollParent, isScrollableElement } from './utils/scrollParent.js';
 export { cancelTimeout, requestTimeout } from './utils/timer.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;"}

package/dist/utils/index.d.ts

@@ -3,5 +3,4 @@ export * from './dom';
 export * from './helper';
 export * from './lodash';
 export * from './math';
-export * from './scrollParent';
 export * from './timer';

package/dist/utils/index.js

@@ -3,6 +3,5 @@ export { getRectSize, getRectSizeSync, getScrollViewContextNode } from './dom.js
 export { defaultItemKey, getOffsetForIndexAndAlignment } from './helper.js';
 export { debounce, omit, throttle } from './lodash.js';
 export { getMiddleNumber, isCosDistributing } from './math.js';
-export { findScrollParent, isScrollableElement } from './scrollParent.js';
 export { cancelTimeout, requestTimeout } from './timer.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/components-advanced",
-  "version": "4.1.12-beta.9",
+  "version": "4.2.0",
   "description": "",
   "author": "O2Team",
   "license": "MIT",
@@ -20,20 +20,19 @@
     "csstype": "^3.1.1",
     "memoize-one": "^6.0.0",
     "tslib": "^2.6.2",
-    "@tarojs/components-react": "4.1.12-beta.9",
-    "@tarojs/components": "4.1.12-beta.9"
+    "@tarojs/components": "4.2.0"
   },
   "devDependencies": {
     "vue": "3.2.47",
-    "@tarojs/shared": "4.1.12-beta.9",
-    "@tarojs/runtime": "4.1.12-beta.9",
-    "@tarojs/taro": "4.1.12-beta.9"
+    "@tarojs/taro": "4.2.0",
+    "@tarojs/shared": "4.2.0",
+    "@tarojs/runtime": "4.2.0"
   },
   "peerDependencies": {
     "react": ">=18",
-    "@tarojs/runtime": "~4.1.12-beta.9",
-    "@tarojs/taro": "~4.1.12-beta.9",
-    "@tarojs/shared": "~4.1.12-beta.9"
+    "@tarojs/runtime": "~4.2.0",
+    "@tarojs/shared": "~4.2.0",
+    "@tarojs/taro": "~4.2.0"
   },
   "peerDependenciesMeta": {
     "react": {

package/dist/components/list/NoMore.d.ts

@@ -1,30 +0,0 @@
-import React from 'react';
-/**
- * NoMore 组件 - 底部"没有更多"提示
- *
- * 这是一个标记组件，不直接渲染内容，仅用于向 List 组件传递配置。
- * 实际渲染由 List 组件内部处理。
- *
- * @example
- * ```tsx
- * <List>
- *   <ListItem>Item 1</ListItem>
- *   <NoMore visible={!hasMore} text="没有更多了" />
- * </List>
- * ```
- */
-export interface NoMoreProps {
-    /** 是否显示（默认 true） */
-    visible?: boolean;
-    /** 提示文字（默认 "没有更多了"） */
-    text?: string;
-    /** 自定义样式 */
-    style?: React.CSSProperties;
-    /** 自定义内容（优先级高于 text） */
-    children?: React.ReactNode;
-    /** NoMore 区域高度（用于动态高度计算，默认 60） */
-    height?: number;
-}
-declare const NoMore: React.FC<NoMoreProps>;
-export { NoMore };
-export default NoMore;

package/dist/components/list/NoMore.js

@@ -1,10 +0,0 @@
-const NoMore = () => {
-    // 标记组件，不实际渲染
-    // 实际渲染由 List 组件内部的 renderNoMoreContent() 处理
-    return null;
-};
-// 设置 displayName 便于调试
-NoMore.displayName = 'NoMore';
-
-export { NoMore, NoMore as default };
-//# sourceMappingURL=NoMore.js.map

package/dist/components/list/NoMore.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"NoMore.js","sources":["../../../src/components/list/NoMore.tsx"],"sourcesContent":["import React from 'react'\n\n/**\n * NoMore 组件 - 底部\"没有更多\"提示\n *\n * 这是一个标记组件，不直接渲染内容，仅用于向 List 组件传递配置。\n * 实际渲染由 List 组件内部处理。\n *\n * @example\n * ```tsx\n * <List>\n *   <ListItem>Item 1</ListItem>\n *   <NoMore visible={!hasMore} text=\"没有更多了\" />\n * </List>\n * ```\n */\n\nexport interface NoMoreProps {\n  /** 是否显示（默认 true） */\n  visible?: boolean\n\n  /** 提示文字（默认 \"没有更多了\"） */\n  text?: string\n\n  /** 自定义样式 */\n  style?: React.CSSProperties\n\n  /** 自定义内容（优先级高于 text） */\n  children?: React.ReactNode\n\n  /** NoMore 区域高度（用于动态高度计算，默认 60） */\n  height?: number\n}\n\nconst NoMore: React.FC<NoMoreProps> = () => {\n  // 标记组件，不实际渲染\n  // 实际渲染由 List 组件内部的 renderNoMoreContent() 处理\n  return null\n}\n\n// 设置 displayName 便于调试\nNoMore.displayName = 'NoMore'\n\nexport { NoMore }\nexport default NoMore\n"],"names":[],"mappings":"AAkCM,MAAA,MAAM,GAA0B,MAAK;;;AAGzC,IAAA,OAAO,IAAI;AACb;AAEA;AACA,MAAM,CAAC,WAAW,GAAG,QAAQ;;;;"}

package/dist/components/list/hooks/useItemSizeCache.d.ts

@@ -1,13 +0,0 @@
-interface UseItemSizeCacheOptions {
-    isHorizontal: boolean;
-    estimatedItemSize: number;
-    itemCount: number;
-}
-interface UseItemSizeCacheReturn {
-    /** 获取项的尺寸（高度或宽度） */
-    getItemSize: (index: number) => number;
-    /** 设置项的尺寸 */
-    setItemSize: (index: number, size: number) => void;
-}
-export declare function useItemSizeCache(options: UseItemSizeCacheOptions): UseItemSizeCacheReturn;
-export {};

package/dist/components/list/hooks/useItemSizeCache.js

@@ -1,40 +0,0 @@
-import { useRef, useCallback } from 'react';
-
-function useItemSizeCache(options) {
-    const { estimatedItemSize } = options;
-    // 缓存 Map：key = 索引，value = 尺寸信息
-    const cacheRef = useRef(new Map());
-    /**
-     * 获取项的尺寸
-     * 优先返回实际测量值，否则返回估算值
-     */
-    const getItemSize = useCallback((index) => {
-        const cached = cacheRef.current.get(index);
-        if ((cached === null || cached === void 0 ? void 0 : cached.isMeasured) && cached.measuredSize !== null) {
-            return cached.measuredSize;
-        }
-        return estimatedItemSize;
-    }, [estimatedItemSize]);
-    /**
-     * 设置项的尺寸（实际测量后调用）
-     */
-    const setItemSize = useCallback((index, size) => {
-        const cached = cacheRef.current.get(index);
-        // 尺寸变化小于 1px，忽略（避免微小抖动）
-        if ((cached === null || cached === void 0 ? void 0 : cached.measuredSize) && Math.abs(cached.measuredSize - size) < 1) {
-            return;
-        }
-        cacheRef.current.set(index, {
-            measuredSize: size,
-            estimatedSize: estimatedItemSize,
-            isMeasured: true
-        });
-    }, [estimatedItemSize]);
-    return {
-        getItemSize,
-        setItemSize
-    };
-}
-
-export { useItemSizeCache };
-//# sourceMappingURL=useItemSizeCache.js.map

package/dist/components/list/hooks/useItemSizeCache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useItemSizeCache.js","sources":["../../../../src/components/list/hooks/useItemSizeCache.ts"],"sourcesContent":["import { useCallback, useRef } from 'react'\n\n/**\n * useItemSizeCache Hook - 动态尺寸缓存管理\n *\n * 支持垂直滚动（高度）和水平滚动（宽度）两种模式\n */\n\n/** 单个项的尺寸缓存 */\ninterface ItemMeasureCache {\n  measuredSize: number | null // 实际测量尺寸\n  estimatedSize: number // 估算尺寸\n  isMeasured: boolean // 是否已测量\n}\n\ninterface UseItemSizeCacheOptions {\n  isHorizontal: boolean // 是否水平滚动\n  estimatedItemSize: number // 估算尺寸\n  itemCount: number // 项总数\n}\n\ninterface UseItemSizeCacheReturn {\n  /** 获取项的尺寸（高度或宽度） */\n  getItemSize: (index: number) => number\n\n  /** 设置项的尺寸 */\n  setItemSize: (index: number, size: number) => void\n}\n\nexport function useItemSizeCache(\n  options: UseItemSizeCacheOptions\n): UseItemSizeCacheReturn {\n  const { estimatedItemSize } = options\n\n  // 缓存 Map：key = 索引，value = 尺寸信息\n  const cacheRef = useRef<Map<number, ItemMeasureCache>>(new Map())\n\n  /**\n   * 获取项的尺寸\n   * 优先返回实际测量值，否则返回估算值\n   */\n  const getItemSize = useCallback((index: number): number => {\n    const cached = cacheRef.current.get(index)\n\n    if (cached?.isMeasured && cached.measuredSize !== null) {\n      return cached.measuredSize\n    }\n\n    return estimatedItemSize\n  }, [estimatedItemSize])\n\n  /**\n   * 设置项的尺寸（实际测量后调用）\n   */\n  const setItemSize = useCallback((index: number, size: number) => {\n    const cached = cacheRef.current.get(index)\n\n    // 尺寸变化小于 1px，忽略（避免微小抖动）\n    if (cached?.measuredSize && Math.abs(cached.measuredSize - size) < 1) {\n      return\n    }\n\n    cacheRef.current.set(index, {\n      measuredSize: size,\n      estimatedSize: estimatedItemSize,\n      isMeasured: true\n    })\n  }, [estimatedItemSize])\n\n  return {\n    getItemSize,\n    setItemSize\n  }\n}\n"],"names":[],"mappings":";;AA6BM,SAAU,gBAAgB,CAC9B,OAAgC,EAAA;AAEhC,IAAA,MAAM,EAAE,iBAAiB,EAAE,GAAG,OAAO;;IAGrC,MAAM,QAAQ,GAAG,MAAM,CAAgC,IAAI,GAAG,EAAE,CAAC;AAEjE;;;AAGG;AACH,IAAA,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,KAAa,KAAY;QACxD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;AAE1C,QAAA,IAAI,CAAA,MAAM,KAAN,IAAA,IAAA,MAAM,uBAAN,MAAM,CAAE,UAAU,KAAI,MAAM,CAAC,YAAY,KAAK,IAAI,EAAE;YACtD,OAAO,MAAM,CAAC,YAAY;;AAG5B,QAAA,OAAO,iBAAiB;AAC1B,KAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC;AAEvB;;AAEG;IACH,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,KAAa,EAAE,IAAY,KAAI;QAC9D,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;;QAG1C,IAAI,CAAA,MAAM,KAAN,IAAA,IAAA,MAAM,uBAAN,MAAM,CAAE,YAAY,KAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE;YACpE;;AAGF,QAAA,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE;AAC1B,YAAA,YAAY,EAAE,IAAI;AAClB,YAAA,aAAa,EAAE,iBAAiB;AAChC,YAAA,UAAU,EAAE;AACb,SAAA,CAAC;AACJ,KAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC;IAEvB,OAAO;QACL,WAAW;QACX;KACD;AACH;;;;"}

package/dist/components/list/hooks/useListNestedScroll.d.ts

@@ -1,13 +0,0 @@
-import type { RefObject } from 'react';
-export interface UseListNestedScrollResult {
-    effectiveScrollElement: RefObject<HTMLElement | null> | null;
-    effectiveStartOffset: number;
-    useScrollElementMode: boolean;
-    needAutoFind: boolean;
-    autoFindStatus: 'pending' | 'found' | 'not-found';
-    contentWrapperRef: RefObject<HTMLDivElement | null>;
-}
-/**
- * 合并嵌套滚动相关逻辑：Context、自动查找、startOffset 测量、scrollElement 解析
- */
-export declare function useListNestedScroll(listType: 'default' | 'nested', scrollElement?: RefObject<HTMLElement | null>, startOffsetProp?: number, isHorizontal?: boolean): UseListNestedScrollResult;

package/dist/components/list/hooks/useListNestedScroll.js

@@ -1,46 +0,0 @@
-import { ScrollElementContext } from '@tarojs/components-react';
-import { useRef, useContext } from 'react';
-import { isH5 } from '../utils.js';
-import { useMeasureStartOffset } from './useMeasureStartOffset.js';
-import { useScrollParentAutoFind } from './useScrollParentAutoFind.js';
-
-const EMPTY_SCROLL_REF = { current: null };
-/**
- * 合并嵌套滚动相关逻辑：Context、自动查找、startOffset 测量、scrollElement 解析
- */
-function useListNestedScroll(listType, scrollElement, startOffsetProp, isHorizontal = false) {
-    var _a, _b, _c;
-    const contentWrapperRef = useRef(null);
-    const scrollElementCtx = useContext(ScrollElementContext);
-    const ctxStart = scrollElementCtx === null || scrollElementCtx === void 0 ? void 0 : scrollElementCtx.startOffset;
-    const hasExplicitCtxStartOffset = ctxStart != null && ctxStart > 0;
-    const needAutoFind = listType === 'nested' &&
-        !scrollElement &&
-        !(scrollElementCtx === null || scrollElementCtx === void 0 ? void 0 : scrollElementCtx.scrollRef) &&
-        isH5;
-    const { scrollParentRef: autoFoundRef, status: autoFindStatus } = useScrollParentAutoFind(contentWrapperRef, { enabled: !!needAutoFind, isHorizontal });
-    const effectiveScrollElement = (_a = scrollElement !== null && scrollElement !== void 0 ? scrollElement : scrollElementCtx === null || scrollElementCtx === void 0 ? void 0 : scrollElementCtx.scrollRef) !== null && _a !== void 0 ? _a : (needAutoFind && autoFindStatus === 'found' ? autoFoundRef : null);
-    const needMeasure = listType === 'nested' &&
-        effectiveScrollElement &&
-        isH5 &&
-        startOffsetProp == null &&
-        !hasExplicitCtxStartOffset;
-    const measuredStartOffset = useMeasureStartOffset(effectiveScrollElement !== null && effectiveScrollElement !== void 0 ? effectiveScrollElement : EMPTY_SCROLL_REF, contentWrapperRef, { enabled: !!needMeasure, isHorizontal });
-    const effectiveStartOffset = (_c = (_b = startOffsetProp !== null && startOffsetProp !== void 0 ? startOffsetProp : (ctxStart != null && ctxStart > 0 ? ctxStart : null)) !== null && _b !== void 0 ? _b : measuredStartOffset) !== null && _c !== void 0 ? _c : 0;
-    const useScrollElementMode = listType === 'nested' && !!(effectiveScrollElement && isH5);
-    if (listType === 'nested' && !effectiveScrollElement && isH5 && autoFindStatus === 'not-found') {
-        // eslint-disable-next-line no-console
-        console.warn('[List] nestedScroll 模式但无 scrollElement（props/Context/自动查找），回退为 default');
-    }
-    return {
-        effectiveScrollElement,
-        effectiveStartOffset,
-        useScrollElementMode,
-        needAutoFind,
-        autoFindStatus,
-        contentWrapperRef,
-    };
-}
-
-export { useListNestedScroll };
-//# sourceMappingURL=useListNestedScroll.js.map

package/dist/components/list/hooks/useListNestedScroll.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useListNestedScroll.js","sources":["../../../../src/components/list/hooks/useListNestedScroll.ts"],"sourcesContent":["import { type ScrollElementContextValue, ScrollElementContext } from '@tarojs/components-react'\nimport { useContext, useRef } from 'react'\n\nimport { isH5 } from '../utils'\nimport { useMeasureStartOffset } from './useMeasureStartOffset'\nimport { useScrollParentAutoFind } from './useScrollParentAutoFind'\n\nimport type { RefObject } from 'react'\n\nconst EMPTY_SCROLL_REF = { current: null as HTMLElement | null }\n\nexport interface UseListNestedScrollResult {\n  effectiveScrollElement: RefObject<HTMLElement | null> | null\n  effectiveStartOffset: number\n  useScrollElementMode: boolean\n  needAutoFind: boolean\n  autoFindStatus: 'pending' | 'found' | 'not-found'\n  contentWrapperRef: RefObject<HTMLDivElement | null>\n}\n\n/**\n * 合并嵌套滚动相关逻辑：Context、自动查找、startOffset 测量、scrollElement 解析\n */\nexport function useListNestedScroll(\n  listType: 'default' | 'nested',\n  scrollElement?: RefObject<HTMLElement | null>,\n  startOffsetProp?: number,\n  isHorizontal: boolean = false\n): UseListNestedScrollResult {\n  const contentWrapperRef = useRef<HTMLDivElement>(null)\n  const scrollElementCtx = useContext(ScrollElementContext) as ScrollElementContextValue | null\n  const ctxStart = scrollElementCtx?.startOffset\n  const hasExplicitCtxStartOffset = ctxStart != null && ctxStart > 0\n\n  const needAutoFind =\n    listType === 'nested' &&\n    !scrollElement &&\n    !scrollElementCtx?.scrollRef &&\n    isH5\n  const { scrollParentRef: autoFoundRef, status: autoFindStatus } = useScrollParentAutoFind(\n    contentWrapperRef,\n    { enabled: !!needAutoFind, isHorizontal }\n  )\n\n  const effectiveScrollElement =\n    scrollElement ??\n    scrollElementCtx?.scrollRef ??\n    (needAutoFind && autoFindStatus === 'found' ? autoFoundRef : null)\n\n  const needMeasure =\n    listType === 'nested' &&\n    effectiveScrollElement &&\n    isH5 &&\n    startOffsetProp == null &&\n    !hasExplicitCtxStartOffset\n  const measuredStartOffset = useMeasureStartOffset(\n    effectiveScrollElement ?? EMPTY_SCROLL_REF,\n    contentWrapperRef,\n    { enabled: !!needMeasure, isHorizontal }\n  )\n\n  const effectiveStartOffset =\n    startOffsetProp ??\n    (ctxStart != null && ctxStart > 0 ? ctxStart : null) ??\n    measuredStartOffset ??\n    0\n\n  const useScrollElementMode = listType === 'nested' && !!(effectiveScrollElement && isH5)\n\n  if (listType === 'nested' && !effectiveScrollElement && isH5 && autoFindStatus === 'not-found') {\n    // eslint-disable-next-line no-console\n    console.warn('[List] nestedScroll 模式但无 scrollElement（props/Context/自动查找），回退为 default')\n  }\n\n  return {\n    effectiveScrollElement,\n    effectiveStartOffset,\n    useScrollElementMode,\n    needAutoFind,\n    autoFindStatus,\n    contentWrapperRef,\n  }\n}\n"],"names":[],"mappings":";;;;;;AASA,MAAM,gBAAgB,GAAG,EAAE,OAAO,EAAE,IAA0B,EAAE;AAWhE;;AAEG;AACG,SAAU,mBAAmB,CACjC,QAA8B,EAC9B,aAA6C,EAC7C,eAAwB,EACxB,YAAA,GAAwB,KAAK,EAAA;;AAE7B,IAAA,MAAM,iBAAiB,GAAG,MAAM,CAAiB,IAAI,CAAC;AACtD,IAAA,MAAM,gBAAgB,GAAG,UAAU,CAAC,oBAAoB,CAAqC;IAC7F,MAAM,QAAQ,GAAG,gBAAgB,KAAA,IAAA,IAAhB,gBAAgB,KAAhB,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,gBAAgB,CAAE,WAAW;IAC9C,MAAM,yBAAyB,GAAG,QAAQ,IAAI,IAAI,IAAI,QAAQ,GAAG,CAAC;AAElE,IAAA,MAAM,YAAY,GAChB,QAAQ,KAAK,QAAQ;AACrB,QAAA,CAAC,aAAa;QACd,EAAC,gBAAgB,KAAhB,IAAA,IAAA,gBAAgB,uBAAhB,gBAAgB,CAAE,SAAS,CAAA;AAC5B,QAAA,IAAI;IACN,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,uBAAuB,CACvF,iBAAiB,EACjB,EAAE,OAAO,EAAE,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,CAC1C;AAED,IAAA,MAAM,sBAAsB,GAC1B,CAAA,EAAA,GAAA,aAAa,aAAb,aAAa,KAAA,KAAA,CAAA,GAAb,aAAa,GACb,gBAAgB,KAAA,IAAA,IAAhB,gBAAgB,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAhB,gBAAgB,CAAE,SAAS,MAC3B,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,EAAA,IAAC,YAAY,IAAI,cAAc,KAAK,OAAO,GAAG,YAAY,GAAG,IAAI,CAAC;AAEpE,IAAA,MAAM,WAAW,GACf,QAAQ,KAAK,QAAQ;QACrB,sBAAsB;QACtB,IAAI;AACJ,QAAA,eAAe,IAAI,IAAI;AACvB,QAAA,CAAC,yBAAyB;IAC5B,MAAM,mBAAmB,GAAG,qBAAqB,CAC/C,sBAAsB,aAAtB,sBAAsB,KAAA,KAAA,CAAA,GAAtB,sBAAsB,GAAI,gBAAgB,EAC1C,iBAAiB,EACjB,EAAE,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,CACzC;AAED,IAAA,MAAM,oBAAoB,GACxB,CAAA,EAAA,GAAA,CAAA,EAAA,GAAA,eAAe,KAAA,IAAA,IAAf,eAAe,KAAA,KAAA,CAAA,GAAf,eAAe,IACd,QAAQ,IAAI,IAAI,IAAI,QAAQ,GAAG,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,EAAA,GACpD,mBAAmB,MAAA,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,EAAA,GACnB,CAAC;AAEH,IAAA,MAAM,oBAAoB,GAAG,QAAQ,KAAK,QAAQ,IAAI,CAAC,EAAE,sBAAsB,IAAI,IAAI,CAAC;AAExF,IAAA,IAAI,QAAQ,KAAK,QAAQ,IAAI,CAAC,sBAAsB,IAAI,IAAI,IAAI,cAAc,KAAK,WAAW,EAAE;;AAE9F,QAAA,OAAO,CAAC,IAAI,CAAC,wEAAwE,CAAC;;IAGxF,OAAO;QACL,sBAAsB;QACtB,oBAAoB;QACpB,oBAAoB;QACpB,YAAY;QACZ,cAAc;QACd,iBAAiB;KAClB;AACH;;;;"}

package/dist/components/list/hooks/useListScrollElementAttach.d.ts

@@ -1,21 +0,0 @@
-import type { RefObject } from 'react';
-export interface ListScrollElementAttachRefs {
-    scrollCorrection: {
-        markUserScrolling: () => void;
-    };
-    onScroll: ((e: {
-        scrollTop: number;
-        scrollLeft: number;
-    }) => void) | undefined;
-    onScrollToUpper: (() => void) | undefined;
-    onScrollToLower: (() => void) | undefined;
-    threshold: {
-        upper: number;
-        lower: number;
-    };
-    listContentLength: number;
-}
-/**
- * scrollElement 模式下：监听外部滚动驱动 renderOffset，并从 scrollElement 获取 containerLength
- */
-export declare function useListScrollElementAttach(enabled: boolean, effectiveScrollElement: RefObject<HTMLElement | null> | null, effectiveStartOffset: number, isHorizontal: boolean, setContainerLength: (v: number) => void, updateRenderOffset: (offset: number, sync?: boolean, source?: string) => void, scrollRefProp: React.MutableRefObject<HTMLElement | null> | undefined, refsRef: RefObject<ListScrollElementAttachRefs>): void;

package/dist/components/list/hooks/useListScrollElementAttach.js

@@ -1,86 +0,0 @@
-import { useRef, useEffect } from 'react';
-
-/**
- * scrollElement 模式下：监听外部滚动驱动 renderOffset，并从 scrollElement 获取 containerLength
- */
-function useListScrollElementAttach(enabled, effectiveScrollElement, effectiveStartOffset, isHorizontal, setContainerLength, updateRenderOffset, scrollRefProp, refsRef) {
-    const effectiveStartOffsetRef = useRef(effectiveStartOffset);
-    effectiveStartOffsetRef.current = effectiveStartOffset;
-    useEffect(() => {
-        if (!enabled || !effectiveScrollElement)
-            return;
-        const el = effectiveScrollElement.current;
-        if (!el || typeof ResizeObserver === 'undefined')
-            return;
-        const update = () => {
-            const measured = isHorizontal ? el.clientWidth : el.clientHeight;
-            if (measured > 0)
-                setContainerLength(measured);
-            if (scrollRefProp)
-                scrollRefProp.current = el;
-        };
-        update();
-        const ro = new ResizeObserver(update);
-        ro.observe(el);
-        return () => ro.disconnect();
-    }, [enabled, effectiveScrollElement, isHorizontal, scrollRefProp, setContainerLength]);
-    useEffect(() => {
-        if (!enabled || !effectiveScrollElement)
-            return;
-        let cancelled = false;
-        let teardown = null;
-        const maxRetries = 20;
-        const tryAttach = (retryCount = 0) => {
-            if (cancelled)
-                return;
-            const target = effectiveScrollElement.current;
-            if (!target) {
-                if (retryCount < maxRetries) {
-                    requestAnimationFrame(() => tryAttach(retryCount + 1));
-                }
-                return;
-            }
-            const refs = refsRef.current;
-            if (!refs)
-                return;
-            let inUpperZone = true;
-            let inLowerZone = false;
-            const handler = () => {
-                var _a, _b, _c;
-                const r = refsRef.current;
-                if (!r)
-                    return;
-                const scrollPos = isHorizontal ? target.scrollLeft : target.scrollTop;
-                const adjustedPos = scrollPos - effectiveStartOffsetRef.current;
-                const effectiveAdjusted = Math.max(0, adjustedPos);
-                const clientSize = isHorizontal ? target.clientWidth : target.clientHeight;
-                r.scrollCorrection.markUserScrolling();
-                updateRenderOffset(effectiveAdjusted, false, 'scrollElement');
-                (_a = r.onScroll) === null || _a === void 0 ? void 0 : _a.call(r, { scrollTop: isHorizontal ? 0 : scrollPos, scrollLeft: isHorizontal ? scrollPos : 0 });
-                const { upper, lower } = r.threshold;
-                const innerContentLen = r.listContentLength;
-                const nowInUpper = effectiveAdjusted <= upper;
-                const nowInLower = innerContentLen > 0 && effectiveAdjusted + clientSize >= innerContentLen - lower;
-                if (nowInUpper && !inUpperZone)
-                    (_b = r.onScrollToUpper) === null || _b === void 0 ? void 0 : _b.call(r);
-                if (nowInLower && !inLowerZone)
-                    (_c = r.onScrollToLower) === null || _c === void 0 ? void 0 : _c.call(r);
-                inUpperZone = nowInUpper;
-                inLowerZone = nowInLower;
-            };
-            const initialScroll = isHorizontal ? target.scrollLeft : target.scrollTop;
-            const initialAdjusted = Math.max(0, initialScroll - effectiveStartOffsetRef.current);
-            updateRenderOffset(initialAdjusted, false, 'scrollElement');
-            target.addEventListener('scroll', handler, { passive: true });
-            teardown = () => target.removeEventListener('scroll', handler);
-        };
-        tryAttach();
-        return () => {
-            cancelled = true;
-            teardown === null || teardown === void 0 ? void 0 : teardown();
-        };
-    }, [enabled, effectiveScrollElement, isHorizontal, effectiveStartOffset, updateRenderOffset, refsRef]);
-}
-
-export { useListScrollElementAttach };
-//# sourceMappingURL=useListScrollElementAttach.js.map

package/dist/components/list/hooks/useListScrollElementAttach.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useListScrollElementAttach.js","sources":["../../../../src/components/list/hooks/useListScrollElementAttach.ts"],"sourcesContent":["import { useEffect, useRef } from 'react'\n\nimport type { RefObject } from 'react'\n\nexport interface ListScrollElementAttachRefs {\n  scrollCorrection: { markUserScrolling: () => void }\n  onScroll: ((e: { scrollTop: number, scrollLeft: number }) => void) | undefined\n  onScrollToUpper: (() => void) | undefined\n  onScrollToLower: (() => void) | undefined\n  threshold: { upper: number, lower: number }\n  listContentLength: number\n}\n\n/**\n * scrollElement 模式下：监听外部滚动驱动 renderOffset，并从 scrollElement 获取 containerLength\n */\nexport function useListScrollElementAttach(\n  enabled: boolean,\n  effectiveScrollElement: RefObject<HTMLElement | null> | null,\n  effectiveStartOffset: number,\n  isHorizontal: boolean,\n  setContainerLength: (v: number) => void,\n  updateRenderOffset: (offset: number, sync?: boolean, source?: string) => void,\n  scrollRefProp: React.MutableRefObject<HTMLElement | null> | undefined,\n  refsRef: RefObject<ListScrollElementAttachRefs>\n) {\n  const effectiveStartOffsetRef = useRef(effectiveStartOffset)\n  effectiveStartOffsetRef.current = effectiveStartOffset\n\n  useEffect(() => {\n    if (!enabled || !effectiveScrollElement) return\n    const el = effectiveScrollElement.current\n    if (!el || typeof ResizeObserver === 'undefined') return\n\n    const update = () => {\n      const measured = isHorizontal ? el.clientWidth : el.clientHeight\n      if (measured > 0) setContainerLength(measured)\n      if (scrollRefProp) scrollRefProp.current = el\n    }\n    update()\n    const ro = new ResizeObserver(update)\n    ro.observe(el)\n    return () => ro.disconnect()\n  }, [enabled, effectiveScrollElement, isHorizontal, scrollRefProp, setContainerLength])\n\n  useEffect(() => {\n    if (!enabled || !effectiveScrollElement) return\n\n    let cancelled = false\n    let teardown: (() => void) | null = null\n    const maxRetries = 20\n\n    const tryAttach = (retryCount = 0) => {\n      if (cancelled) return\n      const target = effectiveScrollElement.current\n      if (!target) {\n        if (retryCount < maxRetries) {\n          requestAnimationFrame(() => tryAttach(retryCount + 1))\n        }\n        return\n      }\n\n      const refs = refsRef.current\n      if (!refs) return\n\n      let inUpperZone = true\n      let inLowerZone = false\n\n      const handler = () => {\n        const r = refsRef.current\n        if (!r) return\n        const scrollPos = isHorizontal ? target.scrollLeft : target.scrollTop\n        const adjustedPos = scrollPos - effectiveStartOffsetRef.current\n        const effectiveAdjusted = Math.max(0, adjustedPos)\n        const clientSize = isHorizontal ? target.clientWidth : target.clientHeight\n        r.scrollCorrection.markUserScrolling()\n        updateRenderOffset(effectiveAdjusted, false, 'scrollElement')\n        r.onScroll?.({ scrollTop: isHorizontal ? 0 : scrollPos, scrollLeft: isHorizontal ? scrollPos : 0 })\n\n        const { upper, lower } = r.threshold\n        const innerContentLen = r.listContentLength\n        const nowInUpper = effectiveAdjusted <= upper\n        const nowInLower = innerContentLen > 0 && effectiveAdjusted + clientSize >= innerContentLen - lower\n        if (nowInUpper && !inUpperZone) r.onScrollToUpper?.()\n        if (nowInLower && !inLowerZone) r.onScrollToLower?.()\n        inUpperZone = nowInUpper\n        inLowerZone = nowInLower\n      }\n\n      const initialScroll = isHorizontal ? target.scrollLeft : target.scrollTop\n      const initialAdjusted = Math.max(0, initialScroll - effectiveStartOffsetRef.current)\n      updateRenderOffset(initialAdjusted, false, 'scrollElement')\n\n      target.addEventListener('scroll', handler, { passive: true })\n      teardown = () => target.removeEventListener('scroll', handler)\n    }\n\n    tryAttach()\n    return () => {\n      cancelled = true\n      teardown?.()\n    }\n  }, [enabled, effectiveScrollElement, isHorizontal, effectiveStartOffset, updateRenderOffset, refsRef])\n}\n"],"names":[],"mappings":"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"}

package/dist/components/list/hooks/useMeasureStartOffset.d.ts

@@ -1,12 +0,0 @@
-import type { RefObject } from 'react';
-/**
- * 测量 scrollElement 内 content 节点之前所有兄弟的高度/宽度之和，作为 startOffset。
- * 用于 scrollElement 模式下无 Context/props 时自动计算上方内容高度。
- * - 直接子节点：累加前兄弟尺寸（更稳定）
- * - 非直接子节点：getBoundingClientRect 回退，并 warning 建议传 startOffset
- * - ref 未就绪时自动重试，确保绑定到最外层滚动容器后能正确测量
- */
-export declare function useMeasureStartOffset(scrollElRef: RefObject<HTMLElement | null>, contentRef: RefObject<HTMLElement | null>, options: {
-    enabled: boolean;
-    isHorizontal?: boolean;
-}): number;

package/dist/components/list/hooks/useMeasureStartOffset.js

@@ -1,84 +0,0 @@
-import { useState, useRef, useEffect } from 'react';
-
-const WARNED_NESTED = new WeakSet();
-const MAX_RETRY = 20;
-const RETRY_DELAY = 50;
-/**
- * 测量 scrollElement 内 content 节点之前所有兄弟的高度/宽度之和，作为 startOffset。
- * 用于 scrollElement 模式下无 Context/props 时自动计算上方内容高度。
- * - 直接子节点：累加前兄弟尺寸（更稳定）
- * - 非直接子节点：getBoundingClientRect 回退，并 warning 建议传 startOffset
- * - ref 未就绪时自动重试，确保绑定到最外层滚动容器后能正确测量
- */
-function useMeasureStartOffset(scrollElRef, contentRef, options) {
-    const { enabled, isHorizontal = false } = options;
-    const [measuredStartOffset, setMeasuredStartOffset] = useState(0);
-    const [retryTrigger, setRetryTrigger] = useState(0);
-    const retryCountRef = useRef(0);
-    useEffect(() => {
-        if (!enabled) {
-            retryCountRef.current = 0;
-            return;
-        }
-        const scrollEl = scrollElRef.current;
-        const contentEl = contentRef.current;
-        // ref 未就绪时重试（如 ScrollView 与 WaterFlow 异步挂载）
-        if (!scrollEl || !contentEl) {
-            if (retryCountRef.current < MAX_RETRY) {
-                retryCountRef.current += 1;
-                const id = setTimeout(() => setRetryTrigger((t) => t + 1), RETRY_DELAY);
-                return () => clearTimeout(id);
-            }
-            return;
-        }
-        retryCountRef.current = 0;
-        const measure = () => {
-            const el = contentRef.current;
-            const scroll = scrollElRef.current;
-            if (!el || !scroll)
-                return;
-            if (el.parentElement === scroll) {
-                // 直接子节点：累加前兄弟尺寸
-                let offset = 0;
-                let prev = el.previousElementSibling;
-                while (prev) {
-                    offset += isHorizontal ? prev.offsetWidth : prev.offsetHeight;
-                    prev = prev.previousElementSibling;
-                }
-                setMeasuredStartOffset((prevVal) => (Math.abs(prevVal - offset) < 1 ? prevVal : offset));
-                return;
-            }
-            // 非直接子节点：getBoundingClientRect 回退
-            const scrollRect = scroll.getBoundingClientRect();
-            const contentRect = el.getBoundingClientRect();
-            const offset = isHorizontal
-                ? contentRect.left - scrollRect.left + scroll.scrollLeft
-                : contentRect.top - scrollRect.top + scroll.scrollTop;
-            const value = Math.max(0, offset);
-            setMeasuredStartOffset((prevVal) => (Math.abs(prevVal - value) < 1 ? prevVal : value));
-            if (!WARNED_NESTED.has(el)) {
-                WARNED_NESTED.add(el);
-                // eslint-disable-next-line no-console
-                console.warn('[useMeasureStartOffset] content 不是 scrollElement 的直接子节点，使用 getBoundingClientRect 测量。' +
-                    '建议通过 props 或 Context 传入 startOffset 以获得更稳定的布局。');
-            }
-        };
-        measure();
-        scrollEl.addEventListener('scroll', measure, { passive: true });
-        const ro = typeof ResizeObserver !== 'undefined' ? new ResizeObserver(measure) : null;
-        if (ro) {
-            ro.observe(scrollEl);
-            Array.from(scrollEl.children).forEach((child) => ro.observe(child));
-            // 非直接子节点：content 自身或其祖先变化时也需重测
-            ro.observe(contentEl);
-        }
-        return () => {
-            scrollEl.removeEventListener('scroll', measure);
-            ro === null || ro === void 0 ? void 0 : ro.disconnect();
-        };
-    }, [enabled, scrollElRef, contentRef, isHorizontal, retryTrigger]);
-    return measuredStartOffset;
-}
-
-export { useMeasureStartOffset };
-//# sourceMappingURL=useMeasureStartOffset.js.map

package/dist/components/list/hooks/useMeasureStartOffset.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useMeasureStartOffset.js","sources":["../../../../src/components/list/hooks/useMeasureStartOffset.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react'\n\nimport type { RefObject } from 'react'\n\nconst WARNED_NESTED = new WeakSet<Element>()\nconst MAX_RETRY = 20\nconst RETRY_DELAY = 50\n\n/**\n * 测量 scrollElement 内 content 节点之前所有兄弟的高度/宽度之和，作为 startOffset。\n * 用于 scrollElement 模式下无 Context/props 时自动计算上方内容高度。\n * - 直接子节点：累加前兄弟尺寸（更稳定）\n * - 非直接子节点：getBoundingClientRect 回退，并 warning 建议传 startOffset\n * - ref 未就绪时自动重试，确保绑定到最外层滚动容器后能正确测量\n */\nexport function useMeasureStartOffset(\n  scrollElRef: RefObject<HTMLElement | null>,\n  contentRef: RefObject<HTMLElement | null>,\n  options: { enabled: boolean, isHorizontal?: boolean }\n): number {\n  const { enabled, isHorizontal = false } = options\n  const [measuredStartOffset, setMeasuredStartOffset] = useState(0)\n  const [retryTrigger, setRetryTrigger] = useState(0)\n  const retryCountRef = useRef(0)\n\n  useEffect(() => {\n    if (!enabled) {\n      retryCountRef.current = 0\n      return\n    }\n    const scrollEl = scrollElRef.current\n    const contentEl = contentRef.current\n\n    // ref 未就绪时重试（如 ScrollView 与 WaterFlow 异步挂载）\n    if (!scrollEl || !contentEl) {\n      if (retryCountRef.current < MAX_RETRY) {\n        retryCountRef.current += 1\n        const id = setTimeout(() => setRetryTrigger((t) => t + 1), RETRY_DELAY)\n        return () => clearTimeout(id)\n      }\n      return\n    }\n    retryCountRef.current = 0\n\n    const measure = () => {\n      const el = contentRef.current\n      const scroll = scrollElRef.current\n      if (!el || !scroll) return\n\n      if (el.parentElement === scroll) {\n        // 直接子节点：累加前兄弟尺寸\n        let offset = 0\n        let prev: Element | null = el.previousElementSibling\n        while (prev) {\n          offset += isHorizontal ? (prev as HTMLElement).offsetWidth : (prev as HTMLElement).offsetHeight\n          prev = prev.previousElementSibling\n        }\n        setMeasuredStartOffset((prevVal) => (Math.abs(prevVal - offset) < 1 ? prevVal : offset))\n        return\n      }\n\n      // 非直接子节点：getBoundingClientRect 回退\n      const scrollRect = scroll.getBoundingClientRect()\n      const contentRect = el.getBoundingClientRect()\n      const offset = isHorizontal\n        ? contentRect.left - scrollRect.left + scroll.scrollLeft\n        : contentRect.top - scrollRect.top + scroll.scrollTop\n      const value = Math.max(0, offset)\n      setMeasuredStartOffset((prevVal) => (Math.abs(prevVal - value) < 1 ? prevVal : value))\n\n      if (!WARNED_NESTED.has(el)) {\n        WARNED_NESTED.add(el)\n        // eslint-disable-next-line no-console\n        console.warn(\n          '[useMeasureStartOffset] content 不是 scrollElement 的直接子节点，使用 getBoundingClientRect 测量。' +\n            '建议通过 props 或 Context 传入 startOffset 以获得更稳定的布局。'\n        )\n      }\n    }\n\n    measure()\n    scrollEl.addEventListener('scroll', measure, { passive: true })\n    const ro = typeof ResizeObserver !== 'undefined' ? new ResizeObserver(measure) : null\n    if (ro) {\n      ro.observe(scrollEl)\n      Array.from(scrollEl.children).forEach((child) => ro.observe(child))\n      // 非直接子节点：content 自身或其祖先变化时也需重测\n      ro.observe(contentEl)\n    }\n    return () => {\n      scrollEl.removeEventListener('scroll', measure)\n      ro?.disconnect()\n    }\n  }, [enabled, scrollElRef, contentRef, isHorizontal, retryTrigger])\n\n  return measuredStartOffset\n}\n"],"names":[],"mappings":";;AAIA,MAAM,aAAa,GAAG,IAAI,OAAO,EAAW;AAC5C,MAAM,SAAS,GAAG,EAAE;AACpB,MAAM,WAAW,GAAG,EAAE;AAEtB;;;;;;AAMG;SACa,qBAAqB,CACnC,WAA0C,EAC1C,UAAyC,EACzC,OAAqD,EAAA;IAErD,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,KAAK,EAAE,GAAG,OAAO;IACjD,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IACjE,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;AACnD,IAAA,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC;IAE/B,SAAS,CAAC,MAAK;QACb,IAAI,CAAC,OAAO,EAAE;AACZ,YAAA,aAAa,CAAC,OAAO,GAAG,CAAC;YACzB;;AAEF,QAAA,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO;AACpC,QAAA,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO;;AAGpC,QAAA,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,EAAE;AAC3B,YAAA,IAAI,aAAa,CAAC,OAAO,GAAG,SAAS,EAAE;AACrC,gBAAA,aAAa,CAAC,OAAO,IAAI,CAAC;gBAC1B,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC;AACvE,gBAAA,OAAO,MAAM,YAAY,CAAC,EAAE,CAAC;;YAE/B;;AAEF,QAAA,aAAa,CAAC,OAAO,GAAG,CAAC;QAEzB,MAAM,OAAO,GAAG,MAAK;AACnB,YAAA,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO;AAC7B,YAAA,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO;AAClC,YAAA,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM;gBAAE;AAEpB,YAAA,IAAI,EAAE,CAAC,aAAa,KAAK,MAAM,EAAE;;gBAE/B,IAAI,MAAM,GAAG,CAAC;AACd,gBAAA,IAAI,IAAI,GAAmB,EAAE,CAAC,sBAAsB;gBACpD,OAAO,IAAI,EAAE;AACX,oBAAA,MAAM,IAAI,YAAY,GAAI,IAAoB,CAAC,WAAW,GAAI,IAAoB,CAAC,YAAY;AAC/F,oBAAA,IAAI,GAAG,IAAI,CAAC,sBAAsB;;gBAEpC,sBAAsB,CAAC,CAAC,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;gBACxF;;;AAIF,YAAA,MAAM,UAAU,GAAG,MAAM,CAAC,qBAAqB,EAAE;AACjD,YAAA,MAAM,WAAW,GAAG,EAAE,CAAC,qBAAqB,EAAE;YAC9C,MAAM,MAAM,GAAG;kBACX,WAAW,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,GAAG,MAAM,CAAC;AAC9C,kBAAE,WAAW,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS;YACvD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC;YACjC,sBAAsB,CAAC,CAAC,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,GAAG,KAAK,CAAC,CAAC;YAEtF,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;AAC1B,gBAAA,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;;gBAErB,OAAO,CAAC,IAAI,CACV,sFAAsF;AACpF,oBAAA,gDAAgD,CACnD;;AAEL,SAAC;AAED,QAAA,OAAO,EAAE;AACT,QAAA,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC/D,QAAA,MAAM,EAAE,GAAG,OAAO,cAAc,KAAK,WAAW,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI;QACrF,IAAI,EAAE,EAAE;AACN,YAAA,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;;AAEnE,YAAA,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;;AAEvB,QAAA,OAAO,MAAK;AACV,YAAA,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC;AAC/C,YAAA,EAAE,aAAF,EAAE,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAF,EAAE,CAAE,UAAU,EAAE;AAClB,SAAC;AACH,KAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;AAElE,IAAA,OAAO,mBAAmB;AAC5B;;;;"}