@tarojs/components-advanced 4.1.12-beta.4 → 4.1.12-beta.40

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

@@ -1 +1 @@
-{"version":3,"file":"root.js","sources":["../../../src/components/water-flow/root.ts"],"sourcesContent":["/* eslint-disable no-labels */\nimport { nextTick } from '@tarojs/taro'\n\nimport { getRectSizeSync } from '../../utils'\nimport { Node } from './node'\nimport { Section } from './section'\nimport { StatefulEventBus } from './stateful-event-bus'\nimport { getSysInfo, isSameRenderRange } from './utils'\n\nimport type { BaseProps, ScrollDirection, Size, WaterFlowProps } from './interface'\n\nexport type RootProps = Pick<WaterFlowProps, 'cacheCount' | 'lowerThresholdCount' | 'upperThresholdCount'> &\nRequired<Pick<BaseProps, 'id'>>\n\nconst { windowHeight, windowWidth } = getSysInfo()\n\ntype RootState = {\n  /** 是否在滚动中 */\n  isScrolling: boolean\n  /** 滚动偏移量 */\n  scrollOffset: number\n  /**\n   * 滚动方向\n   *\n   * - forward 向下滚动\n   *\n   * - backward 向上滚动\n   */\n  scrollDirection: ScrollDirection\n  /** 滚动高度 */\n  scrollHeight: number\n  /** 容器的尺寸信息 */\n  containerSize: Size\n  /** 渲染的分组区间范围 */\n  renderRange: [number, number]\n}\n\nexport const RootEvents = {\n  ReachUpperThreshold: Symbol.for('ReachUpperThreshold'),\n  ReachLowerThreshold: Symbol.for('ReachLowerThreshold'),\n  Resize: Symbol.for('Resize'),\n  AllSectionsLayouted: Symbol.for('AllSectionsLayouted'),\n  InitialRenderCompleted: Symbol.for('InitialRenderCompleted'),\n}\n\ntype Events = keyof typeof RootEvents\n\n/**\n * 数据模型继承自有状态的事件总线，便于在节点之间通信，以及通过 useSyncExternalStore 关联 React 视图\n */\nexport class Root extends StatefulEventBus<RootState, Events> {\n  /**\n   * 瀑布流根节点唯一标识\n   */\n  id: string\n  /**\n   * 分组映射表，便于查找分组\n   */\n  sectionMap: Map<string, Section> = new Map()\n  /**\n   * 节点映射表，便于查找节点\n   */\n  nodeMap: Map<string, Node> = new Map()\n  /**\n   * 分组列表，基于计算出的渲染的分组区间范围 sections.slice(start, end + 1) 进行渲染\n   */\n  sections: Section[] = []\n  /**\n   * 设置预加载的 Item 条数。\n   */\n  cacheCount = 1\n\n  upperThresholdCount = 0\n\n  lowerThresholdCount = 0\n\n  /**\n   * 触发滚动阈值对应的 scrollTop 值\n   */\n  upperThresholdScrollTop = -Infinity\n\n  /**\n   * 触发滚动阈值对应的 scrollTop 值\n   */\n  lowerThresholdScrollTop = Infinity\n\n  constructor(props: RootProps) {\n    const { id, cacheCount, lowerThresholdCount, upperThresholdCount } = props\n    super({\n      isScrolling: false,\n      scrollOffset: 0,\n      scrollDirection: 'forward',\n      scrollHeight: windowHeight,\n      renderRange: [0, 0],\n      containerSize: {\n        width: windowWidth,\n        height: windowHeight,\n      },\n    })\n    Object.assign(this, {\n      id,\n      cacheCount,\n      lowerThresholdCount,\n      upperThresholdCount,\n    })\n    this.setupSubscriptions()\n    getRectSizeSync(`#${id}`, 100).then(({ width = windowWidth, height = windowHeight }) => {\n      this.setStateIn('containerSize', {\n        width,\n        height,\n      })\n    })\n    this.renderInitialLayout()\n  }\n\n  /**\n   * 设置订阅事件\n   */\n  private setupSubscriptions() {\n    /**\n     * 滚动过程中计算渲染的分组区间\n     * 滚动过程中分组的最大高度会发生更新，可以在这时计算滚动高度\n     */\n    this.sub('scrollOffset', () => {\n      this.setStateIn('renderRange', this.getSectionRenderRange())\n      this.handleReachThreshold()\n      if (this.getState().scrollDirection === 'forward') {\n        this.updateScrollHeight()\n      }\n    })\n\n    this.sub('scrollOffset', () => {\n      const sectionSize = this.sections.length\n      const lastSection = this.sections[sectionSize - 1]\n      // 最后一个分组的每一列最后一行都已经完成了布局计算，那么这个时候的总高度应该是准确的\n      if (lastSection.columnMap.every((column) => column[column.length - 1].getState().layouted)) {\n        this.setLowerThresholdScrollTop()\n      }\n    })\n\n    this.sub(RootEvents.AllSectionsLayouted, () => {\n      this.setUpperThresholdScrollTop()\n    })\n\n    this.sub(RootEvents.Resize, () => {\n      this.setUpperThresholdScrollTop()\n      this.setLowerThresholdScrollTop()\n    })\n  }\n\n  /**\n   * 渐进式渲染\n   *\n   * 因为初始没法知道每个分组的高度信息，不知道渲染边界，所以需要渐进式渲染\n   *\n   * 当目前的渲染批次的首个分组的scrollTop大于容器的高度，说明容器可视区域已经填满，没必要再往下渲染了\n   *\n   * @param [i=0] 从第几个分组开始渲染\n   *\n   */\n  renderInitialLayout(i = 0) {\n    nextTick(() => {\n      const sectionSize = this.sections.length\n\n      if (i >= sectionSize || i < 0) {\n        this.pub(RootEvents.InitialRenderCompleted, null)\n        return\n      }\n      const section = this.sections[i]\n      section.layoutedSignal.promise.then(() => {\n        this.setStateIn('renderRange', [0, i + 1 > sectionSize ? sectionSize - 1 : i + 1])\n        // 容器可视区域已经填满了，没必要再继续\n        if (section.getState().scrollTop > this.getState().containerSize.height) {\n          this.pub(RootEvents.InitialRenderCompleted, section)\n          return\n        }\n\n        this.renderInitialLayout(i + 1)\n      })\n    })\n  }\n\n  /**\n   * 计算滚动阈值对应的 scrollTop 并设置 upperThresholdScrollTop\n   * 当距顶部还有 upperThresholdCount 个 FlowItem 时的 scrollTop 值\n   */\n  private setUpperThresholdScrollTop() {\n    // 如果没有设置阈值或阈值为0，则返回0\n    if (!this.upperThresholdCount) {\n      this.upperThresholdScrollTop = 0\n      return 0\n    }\n    const sectionSize = this.sections.length\n    const tracker = Array.from(\n      { length: sectionSize },\n      () => new Map<number, { accCount: number, accHeight: number }>() // Map<列, { 当前列累计个数，当前列累计高度 }>\n    )\n\n    // 从第一个分组开始扫描\n    loopSeciton: for (let i = 0; i < sectionSize; i++) {\n      const section = this.sections[i]\n      const sectionTracker = tracker[i]\n      const columnMap = section.columnMap\n      // 扫描当前分组的每一列\n      for (let col = 0; col < columnMap.length; col++) {\n        const column = columnMap[col]\n        const columnSize = column.length\n        if (!sectionTracker.has(col)) {\n          if (i === 0) {\n            sectionTracker.set(col, { accCount: 0, accHeight: 0 })\n          } else {\n            const previousSectionTracker = tracker[i - 1]\n            sectionTracker.set(col, {\n              accCount: Math.max(...[...previousSectionTracker.values()].map((nodeTracker) => nodeTracker.accCount)),\n              accHeight: section.getState().scrollTop,\n            })\n          }\n        }\n        const colTracker = sectionTracker.get(col)!\n        // 扫描当前列的每一行\n        loopItem: for (let j = 0; j < columnSize; j++) {\n          colTracker.accCount += 1\n          colTracker.accHeight += column[j].getState().height + (j === 0 ? 0 : section.rowGap)\n          if (colTracker.accCount >= this.upperThresholdCount) {\n            break loopItem\n          }\n        }\n      }\n      for (const [, colTracker] of sectionTracker) {\n        if (colTracker.accCount >= this.upperThresholdCount) {\n          this.upperThresholdScrollTop = colTracker.accHeight\n          break loopSeciton\n        }\n      }\n    }\n    return this.upperThresholdScrollTop\n  }\n\n  /**\n   * 计算滚动阈值对应的 scrollTop 并设置 lowerThresholdScrollTop\n   * 当距底部还有 lowerThresholdCount 个 FlowItem 时的 scrollTop 值\n   */\n  private setLowerThresholdScrollTop() {\n    if (this.lowerThresholdCount === 0) {\n      this.lowerThresholdScrollTop = this.getState().scrollHeight - this.getState().containerSize.height\n      return 0\n    }\n    const sectionSize = this.sections.length\n    const tracker = Array.from(\n      { length: sectionSize },\n      () => new Map<number, { accCount: number, scrollTop: number }>()\n    )\n    // 从最后一个分组开始计算\n    loopSeciton: for (let i = sectionSize - 1; i >= 0; i--) {\n      const section = this.sections[i]\n      const sectionTracker = tracker[i]\n      const columnMap = section.columnMap\n      // 扫描当前分组的每一列\n      for (let col = 0; col < columnMap.length; col++) {\n        const column = columnMap[col]\n        const columnSize = column.length\n        if (!sectionTracker.has(col)) {\n          if (i === sectionSize - 1) {\n            sectionTracker.set(col, { accCount: 0, scrollTop: 0 })\n          } else {\n            const belowSectionTracker = tracker[i + 1]\n            sectionTracker.set(col, {\n              accCount: Math.max(...[...belowSectionTracker.values()].map((nodeTracker) => nodeTracker.accCount)),\n              scrollTop: 0,\n            })\n          }\n        }\n        const colTracker = sectionTracker.get(col)!\n        // 从当前列的最后一行开始往前扫描\n        loopItem: for (let j = columnSize - 1; j >= 0; j--) {\n          colTracker.accCount += 1\n          colTracker.scrollTop = column[j].getState().scrollTop\n          if (colTracker.accCount >= this.lowerThresholdCount) {\n            break loopItem\n          }\n        }\n      }\n\n      for (const [, colTracker] of sectionTracker) {\n        if (colTracker.accCount >= this.lowerThresholdCount) {\n          this.lowerThresholdScrollTop = colTracker.scrollTop\n          break loopSeciton\n        }\n      }\n    }\n\n    return this.lowerThresholdScrollTop\n  }\n\n  /**\n   * 处理滚动到阈值的情况\n   * 检测当前滚动位置是否达到了上下阈值，并触发相应的事件\n   */\n  private handleReachThreshold() {\n    const { upperThresholdScrollTop } = this\n    const { scrollOffset, scrollDirection, containerSize } = this.getState()\n    if (\n      scrollDirection === 'backward' &&\n      this.upperThresholdScrollTop !== -Infinity &&\n      scrollOffset <= upperThresholdScrollTop\n    ) {\n      this.pub(RootEvents.ReachUpperThreshold)\n    }\n    if (\n      scrollDirection === 'forward' &&\n      this.lowerThresholdCount !== Infinity &&\n      scrollOffset + containerSize.height >= this.lowerThresholdScrollTop\n    ) {\n      this.pub(RootEvents.ReachLowerThreshold)\n    }\n  }\n\n  /**\n   * 容器的滚动上边界\n   */\n  get scrollBoundaryStart() {\n    return this.getState().scrollOffset\n  }\n\n  /**\n   * 容器的滚动下边界\n   */\n  get scrollBoundaryEnd() {\n    return this.scrollBoundaryStart + this.getStateIn('containerSize').height\n  }\n\n  /**\n   * 计算每个section的底部位置\n   *\n   * sectionBottomRange = [ [section1.top, section1.bottom], [section2.top, section2.bottom], ..., [sectionN.top, sectionN.bottom] ]\n   *\n   * @returns [number,number][]\n   */\n  get sectionRange() {\n    const length = this.sections.length\n    if (length === 0) return []\n    const range = Array.from({ length }, () => [0, this.sections[0].maxColumnHeight])\n    for (let i = 1; i < length; i++) {\n      const previous = range[i - 1]\n      range[i] = [previous[1], previous[1] + this.sections[i].maxColumnHeight]\n    }\n\n    return range\n  }\n\n  /**\n   * 计算滚动高度\n   */\n  public updateScrollHeight() {\n    this.setStateIn('scrollHeight', this.sectionRange[this.sectionRange.length - 1][1])\n  }\n\n  /**\n   * 注册分组\n   */\n  public registerSection(section: Section) {\n    const { id, order } = section\n    this.sectionMap.set(id, section)\n    this.sections[order] = section\n  }\n\n  /**\n   * 注册节点\n   */\n  public registerNode(node: Node) {\n    this.nodeMap.set(node.id, node)\n  }\n\n  /**\n   * 查找分组\n   */\n  public findSection(id: string) {\n    return this.sectionMap.get(id)\n  }\n\n  /**\n   * 查找节点\n   */\n  public findNode(id: string) {\n    return this.nodeMap.get(id)\n  }\n\n  /**\n   * 获取分组渲染区间\n   */\n  public getSectionRenderRange() {\n    const result: [number, number] = [Infinity, -Infinity]\n\n    for (let i = 0; i < this.sections.length; i++) {\n      const section = this.sections[i]\n      if (section.isInRange) {\n        result[0] = Math.min(result[0], i)\n        result[1] = Math.max(result[1], i)\n      }\n    }\n\n    if (result[0] === Infinity) {\n      result[0] = 0\n    }\n\n    if (result[1] === -Infinity) {\n      result[1] = this.sections.length - 1\n    }\n\n    const scrollDirection = this.getState().scrollDirection\n    const [backwardCache, forwardCache] = this.calcCacheSection(result)\n    const backwardDistance = scrollDirection === 'backward' ? backwardCache : 0\n    const forwardDistance = scrollDirection === 'forward' ? forwardCache : 0\n\n    const overscanBackward = result[0] - backwardDistance\n    const overscanForward = result[1] + forwardDistance\n\n    result[0] = overscanBackward < 0 ? 0 : overscanBackward\n\n    result[1] = overscanForward > this.sections.length ? this.sections.length - 1 : overscanForward\n\n    return isSameRenderRange(result, this.getState().renderRange) ? this.getState().renderRange : result\n  }\n\n  /**\n   * 计算预渲染的分组个数\n   */\n  private calcCacheSection(renderRange: [number, number]) {\n    const clientHeight = this.getState().containerSize.height\n    const sectionCount = this.sectionMap.size\n    let [start, end] = renderRange\n    let cacheBackward = 1\n    let cacheForward = 1\n\n    if (start > 0) {\n      let acc = this.sections[--start]?.getState().height ?? 0\n      while (--start > 0) {\n        const prevSection = this.sections[start]\n        acc += prevSection.getState().height\n        cacheBackward += 1\n        if (acc >= clientHeight >>> 1) {\n          break\n        }\n      }\n    }\n\n    if (end < sectionCount - 1) {\n      let acc = this.sections[++end]?.getState().height ?? 0\n      while (++end < sectionCount - 1) {\n        const nextSection = this.sections[end]\n        acc += nextSection.getState().height\n        cacheForward += 1\n        if (acc >= clientHeight >>> 1) {\n          break\n        }\n      }\n    }\n\n    return [cacheBackward, cacheForward]\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"root.js","sources":["../../../src/components/water-flow/root.ts"],"sourcesContent":["/* eslint-disable no-labels */\nimport { cancelAnimationFrame, requestAnimationFrame } from '@tarojs/runtime'\nimport { nextTick } from '@tarojs/taro'\n\nimport { getRectSizeSync } from '../../utils'\nimport { Node } from './node'\nimport { Section } from './section'\nimport { StatefulEventBus } from './stateful-event-bus'\nimport { getSysInfo, isSameRenderRange } from './utils'\n\nimport type { BaseProps, ScrollDirection, Size, WaterFlowProps } from './interface'\n\nexport type RootProps = Pick<WaterFlowProps, 'cacheCount' | 'lowerThresholdCount' | 'upperThresholdCount'> &\nRequired<Pick<BaseProps, 'id'>> & {\n  /** scrollElement 模式下为 true，不测量自有容器；此时需布局全部 section 以展开完整高度 */\n  skipContainerMeasure?: boolean\n}\n\nconst { windowHeight, windowWidth } = getSysInfo()\n\ntype RootState = {\n  /** 是否在滚动中 */\n  isScrolling: boolean\n  /** 滚动偏移量 */\n  scrollOffset: number\n  /**\n   * 滚动方向\n   *\n   * - forward 向下滚动\n   *\n   * - backward 向上滚动\n   */\n  scrollDirection: ScrollDirection\n  /** 滚动高度 */\n  scrollHeight: number\n  /** 容器的尺寸信息 */\n  containerSize: Size\n  /** 渲染的分组区间范围 */\n  renderRange: [number, number]\n}\n\nexport const RootEvents = {\n  ReachUpperThreshold: Symbol.for('ReachUpperThreshold'),\n  ReachLowerThreshold: Symbol.for('ReachLowerThreshold'),\n  Resize: Symbol.for('Resize'),\n  AllSectionsLayouted: Symbol.for('AllSectionsLayouted'),\n  InitialRenderCompleted: Symbol.for('InitialRenderCompleted'),\n}\n\ntype Events = keyof typeof RootEvents\n\n/**\n * 数据模型继承自有状态的事件总线，便于在节点之间通信，以及通过 useSyncExternalStore 关联 React 视图\n */\nexport class Root extends StatefulEventBus<RootState, Events> {\n  /**\n   * 瀑布流根节点唯一标识\n   */\n  id: string\n  /**\n   * 分组映射表，便于查找分组\n   */\n  sectionMap: Map<string, Section> = new Map()\n  /**\n   * 节点映射表，便于查找节点\n   */\n  nodeMap: Map<string, Node> = new Map()\n  /**\n   * 分组列表，基于计算出的渲染的分组区间范围 sections.slice(start, end + 1) 进行渲染\n   */\n  sections: Section[] = []\n  /**\n   * 设置预加载的 Item 条数（与 props.cacheCount 一致，收敛目标）。\n   */\n  cacheCount = 1\n\n  /**\n   * Node 层向上（列索引减小方向）预缓存条数，可与 cacheCount 不同（快速滑动单边放大）。\n   */\n  nodeCacheBackward = 1\n\n  /**\n   * Node 层向下（列索引增大方向）预缓存条数。\n   */\n  nodeCacheForward = 1\n\n  upperThresholdCount = 0\n\n  lowerThresholdCount = 0\n\n  /**\n   * 触发滚动阈值对应的 scrollTop 值\n   */\n  upperThresholdScrollTop = -Infinity\n\n  /**\n   * 触发滚动阈值对应的 scrollTop 值\n   */\n  lowerThresholdScrollTop = Infinity\n\n  /** scrollElement 模式下为 true，需布局全部 section 以展开完整高度供父容器滚动 */\n  skipContainerMeasure = false\n\n  /** 当前是否处于触顶区域；初始为 true（起始在顶部），只有从 false→true 时才触发事件 */\n  private _inUpperZone = true\n  /** 当前是否处于触底区域；初始为 false */\n  private _inLowerZone = false\n  /** scrollHeight 更新防抖（raf），减轻 pushNodes 后测量前后的高度跳变 */\n  private _scrollHeightRafId: number | null = null\n\n  constructor(props: RootProps) {\n    const { id, cacheCount, lowerThresholdCount, upperThresholdCount, skipContainerMeasure } = props\n    super({\n      isScrolling: false,\n      scrollOffset: 0,\n      scrollDirection: 'forward',\n      scrollHeight: windowHeight,\n      renderRange: [0, 0],\n      containerSize: {\n        width: windowWidth,\n        height: windowHeight,\n      },\n    })\n    Object.assign(this, {\n      id,\n      cacheCount,\n      lowerThresholdCount,\n      upperThresholdCount,\n      skipContainerMeasure: !!skipContainerMeasure,\n    })\n    this.nodeCacheBackward = cacheCount\n    this.nodeCacheForward = cacheCount\n    this.setupSubscriptions()\n    if (!skipContainerMeasure) {\n      getRectSizeSync(`#${id}`, 100).then(({ width = windowWidth, height = windowHeight }) => {\n        this.setStateIn('containerSize', {\n          width,\n          height,\n        })\n      })\n    }\n    this.renderInitialLayout()\n  }\n\n  /**\n   * 设置订阅事件\n   */\n  private setupSubscriptions() {\n    /** 滚动：先更新触底阈值，再判触顶/触底并更新分组与总高度，避免同一帧内沿用无效阈值。 */\n    this.sub('scrollOffset', () => {\n      const sectionSize = this.sections.length\n      const lastSection = this.sections[sectionSize - 1]\n      if (lastSection?.columnMap.every((column) => column[column.length - 1]?.getState().layouted)) {\n        this.setLowerThresholdScrollTop()\n      }\n      this.setStateIn('renderRange', this.getSectionRenderRange())\n      this.handleReachThreshold()\n      this.updateScrollHeight()\n    })\n\n    this.sub(RootEvents.AllSectionsLayouted, () => {\n      this.updateScrollHeight()\n      this.setUpperThresholdScrollTop()\n      this.setLowerThresholdScrollTop()\n    })\n\n    this.sub(RootEvents.Resize, () => {\n      this.updateScrollHeight()\n      this.setUpperThresholdScrollTop()\n      this.setLowerThresholdScrollTop()\n    })\n  }\n\n  /**\n   * 渐进式渲染\n   *\n   * 因为初始没法知道每个分组的高度信息，不知道渲染边界，所以需要渐进式渲染\n   *\n   * 当目前的渲染批次的首个分组的scrollTop大于容器的高度，说明容器可视区域已经填满，没必要再往下渲染了\n   *\n   * @param [i=0] 从第几个分组开始渲染\n   *\n   */\n  renderInitialLayout(i = 0) {\n    nextTick(() => {\n      const sectionSize = this.sections.length\n\n      if (i >= sectionSize || i < 0) {\n        this.pub(RootEvents.InitialRenderCompleted, null)\n        return\n      }\n      const section = this.sections[i]\n      section.layoutedSignal.promise.then(() => {\n        this.setStateIn('renderRange', [0, i + 1 > sectionSize ? sectionSize - 1 : i + 1])\n        // skipContainerMeasure（nestedScroll 模式）：需布局全部 section，使 scrollHeight 展开供父容器滚动\n        // default 模式：容器可视区域已填满则提前终止，减少首屏渲染\n        if (\n          !this.skipContainerMeasure &&\n          section.getState().scrollTop > this.getState().containerSize.height\n        ) {\n          this.pub(RootEvents.InitialRenderCompleted, section)\n          return\n        }\n\n        this.renderInitialLayout(i + 1)\n      })\n    })\n  }\n\n  /**\n   * 计算滚动阈值对应的 scrollTop 并设置 upperThresholdScrollTop\n   * 当距顶部还有 upperThresholdCount 个 FlowItem 时的 scrollTop 值\n   */\n  private setUpperThresholdScrollTop() {\n    // 如果没有设置阈值或阈值为0，则返回0\n    if (!this.upperThresholdCount) {\n      this.upperThresholdScrollTop = 0\n      return 0\n    }\n    const sectionSize = this.sections.length\n    const tracker = Array.from(\n      { length: sectionSize },\n      () => new Map<number, { accCount: number, accHeight: number }>() // Map<列, { 当前列累计个数，当前列累计高度 }>\n    )\n\n    // 从第一个分组开始扫描\n    loopSeciton: for (let i = 0; i < sectionSize; i++) {\n      const section = this.sections[i]\n      const sectionTracker = tracker[i]\n      const columnMap = section.columnMap\n      // 扫描当前分组的每一列\n      for (let col = 0; col < columnMap.length; col++) {\n        const column = columnMap[col]\n        const columnSize = column.length\n        if (!sectionTracker.has(col)) {\n          if (i === 0) {\n            sectionTracker.set(col, { accCount: 0, accHeight: 0 })\n          } else {\n            const previousSectionTracker = tracker[i - 1]\n            sectionTracker.set(col, {\n              accCount: Math.max(...[...previousSectionTracker.values()].map((nodeTracker) => nodeTracker.accCount)),\n              accHeight: section.getState().scrollTop,\n            })\n          }\n        }\n        const colTracker = sectionTracker.get(col)!\n        // 扫描当前列的每一行\n        loopItem: for (let j = 0; j < columnSize; j++) {\n          colTracker.accCount += 1\n          colTracker.accHeight += column[j].getState().height + (j === 0 ? 0 : section.rowGap)\n          if (colTracker.accCount >= this.upperThresholdCount) {\n            break loopItem\n          }\n        }\n      }\n      for (const [, colTracker] of sectionTracker) {\n        if (colTracker.accCount >= this.upperThresholdCount) {\n          this.upperThresholdScrollTop = colTracker.accHeight\n          break loopSeciton\n        }\n      }\n    }\n    return this.upperThresholdScrollTop\n  }\n\n  /**\n   * 计算滚动阈值对应的 scrollTop 并设置 lowerThresholdScrollTop\n   * 当距底部还有 lowerThresholdCount 个 FlowItem 时的 scrollTop 值\n   */\n  private setLowerThresholdScrollTop() {\n    // 与 setUpperThresholdScrollTop 一致：0 或 undefined 时用「内容底 - 容器高」作为触底阈值\n    if (!this.lowerThresholdCount) {\n      // 必须用 sectionRange 实时计算，避免依赖可能未更新的 scrollHeight 状态\n      const range = this.sectionRange\n      const totalHeight = range.length > 0 ? range[range.length - 1][1] : 0\n      // 触底判定：scrollOffset + containerSize.height >= lowerThresholdScrollTop\n      // 须存内容底边 totalHeight(H)。若误存 H-h，则顶部时 h 与 H-h 比较，当 2h>=H 会恒判为在触底区，误触 onScrollToLower。\n      this.lowerThresholdScrollTop = totalHeight\n      return 0\n    }\n    const sectionSize = this.sections.length\n    const tracker = Array.from(\n      { length: sectionSize },\n      () => new Map<number, { accCount: number, scrollTop: number }>()\n    )\n    // 从最后一个分组开始计算\n    loopSeciton: for (let i = sectionSize - 1; i >= 0; i--) {\n      const section = this.sections[i]\n      const sectionTracker = tracker[i]\n      const columnMap = section.columnMap\n      // 扫描当前分组的每一列\n      for (let col = 0; col < columnMap.length; col++) {\n        const column = columnMap[col]\n        const columnSize = column.length\n        if (!sectionTracker.has(col)) {\n          if (i === sectionSize - 1) {\n            sectionTracker.set(col, { accCount: 0, scrollTop: 0 })\n          } else {\n            const belowSectionTracker = tracker[i + 1]\n            sectionTracker.set(col, {\n              accCount: Math.max(...[...belowSectionTracker.values()].map((nodeTracker) => nodeTracker.accCount)),\n              scrollTop: 0,\n            })\n          }\n        }\n        const colTracker = sectionTracker.get(col)!\n        // 从当前列的最后一行开始往前扫描\n        loopItem: for (let j = columnSize - 1; j >= 0; j--) {\n          colTracker.accCount += 1\n          colTracker.scrollTop = column[j].getState().scrollTop\n          if (colTracker.accCount >= this.lowerThresholdCount) {\n            break loopItem\n          }\n        }\n      }\n\n      for (const [, colTracker] of sectionTracker) {\n        if (colTracker.accCount >= this.lowerThresholdCount) {\n          this.lowerThresholdScrollTop = colTracker.scrollTop\n          break loopSeciton\n        }\n      }\n    }\n\n    return this.lowerThresholdScrollTop\n  }\n\n  /**\n   * 处理滚动到阈值的情况\n   * 检测当前滚动位置是否达到了上下阈值，并触发相应的事件\n   * scrollElement 模式：scrollOffset 为内容内偏移（scrollTop - startOffset），upper/lowerThresholdScrollTop 基于本组件内容计算，触顶/触底以本 WaterFlow 内容为基准\n   */\n  private handleReachThreshold() {\n    const { scrollOffset, containerSize } = this.getState()\n    const inUpper = this.upperThresholdScrollTop !== -Infinity && scrollOffset <= this.upperThresholdScrollTop\n    const inLower = this.lowerThresholdScrollTop !== Infinity && scrollOffset + containerSize.height >= this.lowerThresholdScrollTop\n    if (inUpper && !this._inUpperZone) this.pub(RootEvents.ReachUpperThreshold)\n    if (inLower && !this._inLowerZone) this.pub(RootEvents.ReachLowerThreshold)\n    this._inUpperZone = inUpper\n    this._inLowerZone = inLower\n  }\n\n  /**\n   * 列表追加并完成 finalize 后调用：重置触底边沿状态（_inLowerZone），\n   * 使用户仍在底部时下一次滚动能再次触发 onScrollToLower，而不必先上滑再下滑。\n   * 不在此处同步调用 handleReachThreshold，避免仍在底部时立刻连发触底（与误触区分）。\n   */\n  public resetLowerReachEdgeAfterContentChange () {\n    this._inLowerZone = false\n  }\n\n  /**\n   * 容器的滚动上边界\n   */\n  get scrollBoundaryStart() {\n    return this.getState().scrollOffset\n  }\n\n  /**\n   * 容器的滚动下边界\n   */\n  get scrollBoundaryEnd() {\n    return this.scrollBoundaryStart + this.getStateIn('containerSize').height\n  }\n\n  /**\n   * 计算每个section的底部位置\n   *\n   * sectionBottomRange = [ [section1.top, section1.bottom], [section2.top, section2.bottom], ..., [sectionN.top, sectionN.bottom] ]\n   *\n   * @returns [number,number][]\n   */\n  get sectionRange() {\n    const length = this.sections.length\n    if (length === 0) return []\n    const range = Array.from({ length }, () => [0, this.sections[0].maxColumnHeight])\n    for (let i = 1; i < length; i++) {\n      const previous = range[i - 1]\n      const prevSection = this.sections[i - 1]\n      const gap = prevSection.rowGap ?? 0\n      range[i] = [previous[1] + gap, previous[1] + gap + this.sections[i].maxColumnHeight]\n    }\n\n    return range\n  }\n\n  /**\n   * 更新总滚动高度（各 Section 累计）。\n   * @param immediate true 时跳过 raf 防抖（如 finalizePushNodesStateIfNeeded），避免高度滞后引起跳动\n   */\n  public updateScrollHeight(immediate = false) {\n    const flush = () => {\n      const next = this.sectionRange[this.sectionRange.length - 1]?.[1] ?? 0\n      this.setStateIn('scrollHeight', next)\n    }\n    if (immediate) {\n      if (this._scrollHeightRafId != null) {\n        cancelAnimationFrame(this._scrollHeightRafId)\n        this._scrollHeightRafId = null\n      }\n      flush()\n      return\n    }\n    if (this._scrollHeightRafId != null) {\n      cancelAnimationFrame(this._scrollHeightRafId)\n    }\n    this._scrollHeightRafId = requestAnimationFrame(() => {\n      this._scrollHeightRafId = null\n      flush()\n    })\n  }\n\n  /**\n   * 注册分组\n   */\n  public registerSection(section: Section) {\n    const { id, order } = section\n    this.sectionMap.set(id, section)\n    this.sections[order] = section\n  }\n\n  /**\n   * 注册节点\n   */\n  public registerNode(node: Node) {\n    this.nodeMap.set(node.id, node)\n  }\n\n  /**\n   * 查找分组\n   */\n  public findSection(id: string) {\n    return this.sectionMap.get(id)\n  }\n\n  /**\n   * 查找节点\n   */\n  public findNode(id: string) {\n    return this.nodeMap.get(id)\n  }\n\n  /**\n   * 设置 Node 层上下方向预缓存条数，并刷新可见分组内的列渲染区间。\n   */\n  public setNodeCacheRange (backward: number, forward: number) {\n    const b = Math.max(0, Math.floor(backward))\n    const f = Math.max(0, Math.floor(forward))\n    if (this.nodeCacheBackward === b && this.nodeCacheForward === f) {\n      return\n    }\n    this.nodeCacheBackward = b\n    this.nodeCacheForward = f\n    for (const section of this.sections) {\n      if (section.isInRange) {\n        section.setStateIn('renderRange', section.getNodeRenderRange())\n      }\n    }\n  }\n\n  /**\n   * 获取分组渲染区间\n   */\n  public getSectionRenderRange() {\n    const result: [number, number] = [Infinity, -Infinity]\n\n    for (let i = 0; i < this.sections.length; i++) {\n      const section = this.sections[i]\n      if (section.isInRange) {\n        result[0] = Math.min(result[0], i)\n        result[1] = Math.max(result[1], i)\n      }\n    }\n\n    if (result[0] === Infinity) {\n      result[0] = 0\n    }\n\n    if (result[1] === -Infinity) {\n      result[1] = this.sections.length - 1\n    }\n\n    const [backwardCache, forwardCache] = this.calcCacheSection(result)\n    // 双向预缓存，避免反向滚动时出现空白（原逻辑仅在滚动方向缓存，反向时未预渲染）\n    const backwardDistance = backwardCache\n    const forwardDistance = forwardCache\n\n    const overscanBackward = result[0] - backwardDistance\n    const overscanForward = result[1] + forwardDistance\n\n    result[0] = overscanBackward < 0 ? 0 : overscanBackward\n\n    result[1] = overscanForward > this.sections.length ? this.sections.length - 1 : overscanForward\n\n    const prevRange = this.getState().renderRange\n    return isSameRenderRange(result, prevRange) ? prevRange : result\n  }\n\n  /**\n   * 计算预渲染的分组个数\n   */\n  private calcCacheSection(renderRange: [number, number]) {\n    const clientHeight = this.getState().containerSize.height\n    const sectionCount = this.sectionMap.size\n    let [start, end] = renderRange\n    let cacheBackward = 1\n    let cacheForward = 1\n\n    if (start > 0) {\n      let acc = this.sections[--start]?.getState().height ?? 0\n      while (--start > 0) {\n        const prevSection = this.sections[start]\n        acc += prevSection.getState().height\n        cacheBackward += 1\n        if (acc >= clientHeight >>> 1) {\n          break\n        }\n      }\n    }\n\n    if (end < sectionCount - 1) {\n      let acc = this.sections[++end]?.getState().height ?? 0\n      while (++end < sectionCount - 1) {\n        const nextSection = this.sections[end]\n        acc += nextSection.getState().height\n        cacheForward += 1\n        if (acc >= clientHeight >>> 1) {\n          break\n        }\n      }\n    }\n\n    return [cacheBackward, cacheForward]\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/components/water-flow/section.d.ts

@@ -57,6 +57,8 @@ export declare class Section extends StatefulEventBus<SectionState> {
         resolve: () => void;
         reject: (reason?: any) => void;
     };
+    /** pushNodesStructuralOnly 后待 finalize；由 WaterFlow 的 useLayoutEffect 收尾，避免在父 render 中更新子 state */
+    private _pendingPushFinalize;
     constructor(root: Root, props: SectionProps);
     /**
      * 订阅事件
@@ -99,7 +101,7 @@ export declare class Section extends StatefulEventBus<SectionState> {
      */
     private updateNodes;
     /**
-     * 计算当前分组的 scrollTop，即该分组之前的所有分组的最大列高度之和
+     * 计算当前分组的 scrollTop，即该分组之前的所有分组的最大列高度 + rowGap 之和
      */
     private calcScrollTop;
     /**
@@ -107,6 +109,10 @@ export declare class Section extends StatefulEventBus<SectionState> {
      */
     getNodeRenderRange(): [number, number][];
     pushNode(nodeIndex: number, col: number): void;
+    /** 仅扩展 columnMap / 注册 Node，不 setState；与 finalizePushNodesStateIfNeeded 配对 */
+    pushNodesStructuralOnly(count: number): void;
+    /** 在 commit 后同步 height、节点位置与 scrollHeight（见 WaterFlow useLayoutEffect） */
+    finalizePushNodesStateIfNeeded(): void;
     pushNodes(count: number): void;
 }
 export {};

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

@@ -25,6 +25,8 @@ class Section extends StatefulEventBus {
         this.rowGap = 0;
         this.columnGap = 0;
         this.layoutedSignal = createImperativePromise();
+        /** pushNodesStructuralOnly 后待 finalize；由 WaterFlow 的 useLayoutEffect 收尾，避免在父 render 中更新子 state */
+        this._pendingPushFinalize = false;
         Object.assign(this, {
             id,
             col,
@@ -127,7 +129,10 @@ class Section extends StatefulEventBus {
         for (; start < this.root.sections.length; start++) {
             const currentSection = this.root.sections[start - 1];
             const nextSection = this.root.sections[start];
-            nextSection.setStateIn('scrollTop', currentSection.getState().scrollTop + currentSection.getState().height + this.rowGap);
+            // 使用 maxColumnHeight 替代 getState().height，避免 pushNodes 后 state 未同步导致 footer 错位
+            const effectiveHeight = currentSection.maxColumnHeight;
+            const newScrollTop = currentSection.getState().scrollTop + effectiveHeight + this.rowGap;
+            nextSection.setStateIn('scrollTop', newScrollTop);
             nextSection.updateNodes();
         }
     }
@@ -165,10 +170,10 @@ class Section extends StatefulEventBus {
         }
     }
     /**
-     * 计算当前分组的 scrollTop，即该分组之前的所有分组的最大列高度之和
+     * 计算当前分组的 scrollTop，即该分组之前的所有分组的最大列高度 + rowGap 之和
      */
     calcScrollTop() {
-        return this.root.sections.slice(0, this.order).reduce((acc, section) => acc + section.maxColumnHeight, 0);
+        return this.root.sections.slice(0, this.order).reduce((acc, section) => { var _a; return acc + section.maxColumnHeight + ((_a = section.rowGap) !== null && _a !== void 0 ? _a : 0); }, 0);
     }
     /**
      * 计算当前分组内每列应该渲染的节点索引区间
@@ -195,16 +200,29 @@ class Section extends StatefulEventBus {
             if (end === -Infinity) {
                 result[i][1] = -1;
             }
-            const cacheCount = this.root.cacheCount;
-            const scrollDirection = this.root.getState().scrollDirection;
-            const backwardDistance = scrollDirection === 'backward' ? cacheCount : 0;
-            const forwardDistance = scrollDirection === 'forward' ? cacheCount : 0;
+            const backwardDistance = this.root.nodeCacheBackward;
+            const forwardDistance = this.root.nodeCacheForward;
             const overscanBackward = result[i][0] - backwardDistance;
             const overscanForward = result[i][1] + forwardDistance;
             result[i][0] = overscanBackward < 0 ? 0 : overscanBackward;
             result[i][1] = overscanForward > column.length ? column.length - 1 : overscanForward;
+            // 列尾连续未测量节点纳入渲染区间，保证追加数据后能挂载并完成 measure
+            let tailUnmeasuredStart = column.length;
+            for (let j = column.length - 1; j >= 0; j--) {
+                if (!column[j].getState().layouted) {
+                    tailUnmeasuredStart = j;
+                }
+                else {
+                    break;
+                }
+            }
+            if (tailUnmeasuredStart < column.length) {
+                result[i][0] = Math.min(result[i][0], tailUnmeasuredStart);
+                result[i][1] = Math.max(result[i][1], column.length - 1);
+            }
         }
-        return isSameRenderRange(result, this.getState().renderRange) ? this.getState().renderRange : result;
+        const prevRange = this.getState().renderRange;
+        return isSameRenderRange(result, prevRange) ? prevRange : result;
     }
     pushNode(nodeIndex, col) {
         const { row: rowIndex, col: columnIndex } = getMatrixPosition(nodeIndex, col);
@@ -217,15 +235,42 @@ class Section extends StatefulEventBus {
         this.register(node);
         this.root.registerNode(node);
     }
-    pushNodes(count) {
+    /** 仅扩展 columnMap / 注册 Node，不 setState；与 finalizePushNodesStateIfNeeded 配对 */
+    pushNodesStructuralOnly(count) {
         const { count: originalCount, col } = this;
         for (let i = originalCount; i < originalCount + count; i++) {
             this.pushNode(i, col);
         }
         this.count += count;
         this.root.lowerThresholdScrollTop = Infinity;
+        this._pendingPushFinalize = true;
+    }
+    /** 在 commit 后同步 height、节点位置与 scrollHeight（见 WaterFlow useLayoutEffect） */
+    finalizePushNodesStateIfNeeded() {
+        if (!this._pendingPushFinalize)
+            return;
+        this._pendingPushFinalize = false;
+        // 同步 section state.height，避免与 maxColumnHeight 不一致导致 footer 错位
+        this.setStateIn('height', this.maxColumnHeight);
         this.updateNodes();
         this.updateBehindSectionsPosition();
+        // 立即更新 scrollHeight，避免防抖导致容器高度滞后引发往上抖动
+        this.root.updateScrollHeight(true);
+        if (this.isInRange) {
+            this.setStateIn('renderRange', this.getNodeRenderRange());
+        }
+        // 扩展 Root 的 section 切片，保证多 FlowSection 时当前分组始终在渲染树内
+        const [rStart, rEnd] = this.root.getState().renderRange;
+        const newStart = Math.min(rStart, this.order);
+        const newEnd = Math.max(rEnd, this.order);
+        if (newStart !== rStart || newEnd !== rEnd) {
+            this.root.setStateIn('renderRange', [newStart, newEnd]);
+        }
+        this.root.resetLowerReachEdgeAfterContentChange();
+    }
+    pushNodes(count) {
+        this.pushNodesStructuralOnly(count);
+        this.finalizePushNodesStateIfNeeded();
     }
 }
 

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

@@ -1 +1 @@
-{"version":3,"file":"section.js","sources":["../../../src/components/water-flow/section.ts"],"sourcesContent":["import { debounce } from '../../utils'\nimport { Size } from './interface'\nimport { Node } from './node'\nimport { Root, RootEvents } from './root'\nimport { StatefulEventBus } from './stateful-event-bus'\nimport { createImperativePromise, getMatrixPosition, isSameRenderRange } from './utils'\n\nexport interface SectionProps {\n  /** 分组的唯一标识 */\n  id: string\n  /** 分组的列数 */\n  col: number\n  /** 分组的顺序 */\n  order: number\n  /** 节点数量 */\n  count: number\n  /** 该分组的行间距 */\n  rowGap: number\n  /** 该分组的列间距  */\n  columnGap: number\n}\n\n/**\n * 分组状态\n */\ntype SectionState = {\n  /**\n   * 分组是否已经布局计算\n   */\n  layouted: boolean\n  /**\n   * 分组顶部距离容器顶部的距离\n   */\n  scrollTop: number\n  /**\n   * 分组的高度\n   */\n  height: number\n  /**\n   * 每个列的渲染范围\n   * 每个元素为一个二元组，第一个元素为起始索引，第二个元素为结束索引\n   */\n  renderRange: [number, number][]\n}\n\nexport const SectionEvents = {\n  AllNodesLayouted: Symbol.for('AllNodesLayouted'),\n  Resize: Symbol.for('Resize'),\n}\n\nexport class Section extends StatefulEventBus<SectionState> {\n  id: string\n  order: number\n  col: number\n  columnMap: Node[][]\n  nodes: Map<string, Node> = new Map()\n  defaultSize = 200\n  count = 0\n  rowGap = 0\n  columnGap = 0\n  layoutedSignal = createImperativePromise()\n\n  constructor(public root: Root, props: SectionProps) {\n    const { id, col, order, count, rowGap, columnGap } = props\n    super({\n      layouted: false,\n      scrollTop: 0,\n      height: 0,\n      renderRange: Array.from({ length: col }, () => [0, 0]),\n    })\n    Object.assign(this, {\n      id,\n      col,\n      count,\n      order,\n      rowGap,\n      columnGap,\n      columnMap: Array.from({ length: col }, () => []),\n    })\n    this.initializeColumnMap()\n    root.registerSection(this)\n    this.setupSubscriptions()\n  }\n\n  /**\n   * 订阅事件\n   */\n  private setupSubscriptions() {\n    // 分组的所有节点完成初次布局计算，Nodes的实际高度已经拿到，那么这时分组的高度是确定的，距离滚动容器的顶部距离也是确定的，可以开始计算\n    this.sub(SectionEvents.AllNodesLayouted, () => {\n      this.setStateBatch({\n        scrollTop: this.calcScrollTop(),\n        height: this.maxColumnHeight,\n      })\n      this.updateNodes()\n      this.setStateIn('renderRange', this.getNodeRenderRange())\n      this.setStateIn('layouted', true)\n      this.layoutedSignal.resolve()\n      if (this.root.sections.every((section) => section.getState().layouted)) {\n        this.root.pub(RootEvents.AllSectionsLayouted)\n      }\n    })\n    // 滚动过程中，如果分组自身可见，那么需要计算分组内应该渲染的元素节点索引区间\n    this.root.sub('scrollOffset', () => {\n      if (this.isInRange) {\n        this.setStateIn('renderRange', this.getNodeRenderRange())\n      }\n    })\n\n    /**\n     *  对应分组内的节点尺寸发生变化，需要重新进行相关计算\n     *  1. 重新计算尺寸发生变化的节点所在列的所有节点位置信息\n     *  2. 重新计算分组的高度\n     *  3. 重新计算当前分组之后的所有分组的scrollTop以及分组内的节点位置\n     *  4. 更新分组内节点的渲染范围\n     */\n    this.sub<{ node: Node, newSize: Size, originalSize: Size }>(\n      SectionEvents.Resize,\n      debounce(() => {\n        this.setStateIn('height', this.maxColumnHeight)\n        this.updateBehindSectionsPosition()\n        if (this.isInRange) {\n          this.setStateIn('renderRange', this.getNodeRenderRange())\n        }\n        this.root.pub(RootEvents.Resize)\n      })\n    )\n  }\n\n  /**\n   * 获取当前分组的最大高度，分组的最大高度由分组最高列决定\n   * @returns 当前分组的最大高度\n   */\n  get maxColumnHeight() {\n    return Math.max(\n      ...this.columnMap.map(\n        (column) => column.reduce((buf, node) => buf + node.getState().height, 0) + (column.length - 1) * this.rowGap\n      )\n    )\n  }\n\n  /**\n   * 当前分组是否在可视区域\n   *\n   * 滚动偏移为 scrollOffset，容器的高度为 containerSize.height\n   *\n   * 当前容器滚动上边界(scrollBoundaryStart)为 scrollOffset，容器滚动的下边界(scrollBoundaryEnd)为 scrollOffset + containerSize.height\n   *\n   * 如果分组的 scrollTop 小于滚动下边界并且 scrollTop + 分组高度大于滚动上边界，那么分组在可视区域\n   */\n  get isInRange() {\n    const { scrollBoundaryStart, scrollBoundaryEnd } = this.root\n    const { height: sectionHeight, scrollTop: sectionScrollTop } = this.getState()\n    return sectionScrollTop <= scrollBoundaryEnd && sectionScrollTop + sectionHeight >= scrollBoundaryStart\n  }\n\n  /**\n   * 注册节点\n   */\n  private register(node: Node) {\n    const { col, order } = node\n    this.columnMap[col][order] = node\n    this.nodes.set(node.id, node)\n  }\n\n  /**\n   * 初始化分组内的列，即将一维数组转二维数组\n   */\n  private initializeColumnMap() {\n    const { count, col } = this\n    for (let i = 0; i < count; i++) {\n      this.pushNode(i, col)\n    }\n  }\n\n  /**\n   * 更新当前分组之后的分组的位置信息\n   */\n  private updateBehindSectionsPosition() {\n    let start = this.order + 1\n    if (start > this.root.sections.length) {\n      return\n    }\n    for (; start < this.root.sections.length; start++) {\n      const currentSection = this.root.sections[start - 1]\n      const nextSection = this.root.sections[start]\n      nextSection.setStateIn(\n        'scrollTop',\n        currentSection.getState().scrollTop + currentSection.getState().height + this.rowGap\n      )\n      nextSection.updateNodes()\n    }\n  }\n\n  /**\n   * 更新指定列的节点位置信息\n   * @param col 列索引\n   */\n  private updateColumnNode(col: number) {\n    const column = this.columnMap[col]\n    const { scrollTop: sectionScrollTop } = this.getState()\n    for (let i = 0; i < column.length; i++) {\n      const node = column[i]\n      if (i === 0) {\n        node.setStateBatch({\n          scrollTop: sectionScrollTop,\n          top: 0,\n        })\n      } else {\n        const prevNode = column[i - 1]\n        const { scrollTop: prevNodeScrollTop, height: prevNodeHeight, top: prevNodeTop } = prevNode.getState()\n        node.setStateBatch({\n          scrollTop: prevNodeScrollTop + prevNodeHeight + this.rowGap,\n          top: prevNodeHeight + prevNodeTop + this.rowGap,\n        })\n      }\n    }\n  }\n\n  /**\n   * 更新每列节点的位置\n   */\n  private updateNodes() {\n    for (let col = 0; col < this.columnMap.length; col++) {\n      this.updateColumnNode(col)\n    }\n  }\n\n  /**\n   * 计算当前分组的 scrollTop，即该分组之前的所有分组的最大列高度之和\n   */\n  private calcScrollTop() {\n    return this.root.sections.slice(0, this.order).reduce((acc, section) => acc + section.maxColumnHeight, 0)\n  }\n\n  /**\n   * 计算当前分组内每列应该渲染的节点索引区间\n   */\n  public getNodeRenderRange() {\n    if (!this.isInRange) {\n      return Array.from({ length: this.col }, () => [0, -1] as [number, number])\n    }\n\n    const result = Array.from({ length: this.col }, () => [Infinity, -Infinity] as unknown as [number, number])\n    for (let i = 0; i < this.columnMap.length; i++) {\n      const column = this.columnMap[i]\n      for (let j = 0; j < column.length; j++) {\n        const node = column[j]\n        if (node.isInRange) {\n          result[i][0] = Math.min(result[i][0], j)\n          result[i][1] = Math.max(result[i][1], j)\n        }\n      }\n      const start = result[i][0]\n      const end = result[i][1]\n      if (start === Infinity) {\n        result[i][0] = 0\n      }\n      if (end === -Infinity) {\n        result[i][1] = -1\n      }\n\n      const cacheCount = this.root.cacheCount\n      const scrollDirection = this.root.getState().scrollDirection\n      const backwardDistance = scrollDirection === 'backward' ? cacheCount : 0\n      const forwardDistance = scrollDirection === 'forward' ? cacheCount : 0\n      const overscanBackward = result[i][0] - backwardDistance\n      const overscanForward = result[i][1] + forwardDistance\n      result[i][0] = overscanBackward < 0 ? 0 : overscanBackward\n      result[i][1] = overscanForward > column.length ? column.length - 1 : overscanForward\n    }\n\n    return isSameRenderRange(result, this.getState().renderRange) ? this.getState().renderRange : result\n  }\n\n  public pushNode(nodeIndex: number, col: number) {\n    const { row: rowIndex, col: columnIndex } = getMatrixPosition(nodeIndex, col)\n    const node = new Node(this.root, this, {\n      childIndex: nodeIndex,\n      order: rowIndex,\n      col: columnIndex,\n      height: this.defaultSize,\n    })\n    this.register(node)\n    this.root.registerNode(node)\n  }\n\n  public pushNodes(count: number) {\n    const { count: originalCount, col } = this\n    for (let i = originalCount; i < originalCount + count; i++) {\n      this.pushNode(i, col)\n    }\n    this.count += count\n    this.root.lowerThresholdScrollTop = Infinity\n    this.updateNodes()\n    this.updateBehindSectionsPosition()\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"section.js","sources":["../../../src/components/water-flow/section.ts"],"sourcesContent":["import { debounce } from '../../utils'\nimport { Size } from './interface'\nimport { Node } from './node'\nimport { Root, RootEvents } from './root'\nimport { StatefulEventBus } from './stateful-event-bus'\nimport { createImperativePromise, getMatrixPosition, isSameRenderRange } from './utils'\n\nexport interface SectionProps {\n  /** 分组的唯一标识 */\n  id: string\n  /** 分组的列数 */\n  col: number\n  /** 分组的顺序 */\n  order: number\n  /** 节点数量 */\n  count: number\n  /** 该分组的行间距 */\n  rowGap: number\n  /** 该分组的列间距  */\n  columnGap: number\n}\n\n/**\n * 分组状态\n */\ntype SectionState = {\n  /**\n   * 分组是否已经布局计算\n   */\n  layouted: boolean\n  /**\n   * 分组顶部距离容器顶部的距离\n   */\n  scrollTop: number\n  /**\n   * 分组的高度\n   */\n  height: number\n  /**\n   * 每个列的渲染范围\n   * 每个元素为一个二元组，第一个元素为起始索引，第二个元素为结束索引\n   */\n  renderRange: [number, number][]\n}\n\nexport const SectionEvents = {\n  AllNodesLayouted: Symbol.for('AllNodesLayouted'),\n  Resize: Symbol.for('Resize'),\n}\n\nexport class Section extends StatefulEventBus<SectionState> {\n  id: string\n  order: number\n  col: number\n  columnMap: Node[][]\n  nodes: Map<string, Node> = new Map()\n  defaultSize = 200\n  count = 0\n  rowGap = 0\n  columnGap = 0\n  layoutedSignal = createImperativePromise()\n\n  /** pushNodesStructuralOnly 后待 finalize；由 WaterFlow 的 useLayoutEffect 收尾，避免在父 render 中更新子 state */\n  private _pendingPushFinalize = false\n\n  constructor(public root: Root, props: SectionProps) {\n    const { id, col, order, count, rowGap, columnGap } = props\n    super({\n      layouted: false,\n      scrollTop: 0,\n      height: 0,\n      renderRange: Array.from({ length: col }, () => [0, 0]),\n    })\n    Object.assign(this, {\n      id,\n      col,\n      count,\n      order,\n      rowGap,\n      columnGap,\n      columnMap: Array.from({ length: col }, () => []),\n    })\n    this.initializeColumnMap()\n    root.registerSection(this)\n    this.setupSubscriptions()\n  }\n\n  /**\n   * 订阅事件\n   */\n  private setupSubscriptions() {\n    // 分组的所有节点完成初次布局计算，Nodes的实际高度已经拿到，那么这时分组的高度是确定的，距离滚动容器的顶部距离也是确定的，可以开始计算\n    this.sub(SectionEvents.AllNodesLayouted, () => {\n      this.setStateBatch({\n        scrollTop: this.calcScrollTop(),\n        height: this.maxColumnHeight,\n      })\n      this.updateNodes()\n      this.setStateIn('renderRange', this.getNodeRenderRange())\n      this.setStateIn('layouted', true)\n      this.layoutedSignal.resolve()\n      if (this.root.sections.every((section) => section.getState().layouted)) {\n        this.root.pub(RootEvents.AllSectionsLayouted)\n      }\n    })\n    // 滚动过程中，如果分组自身可见，那么需要计算分组内应该渲染的元素节点索引区间\n    this.root.sub('scrollOffset', () => {\n      if (this.isInRange) {\n        this.setStateIn('renderRange', this.getNodeRenderRange())\n      }\n    })\n\n    /**\n     *  对应分组内的节点尺寸发生变化，需要重新进行相关计算\n     *  1. 重新计算尺寸发生变化的节点所在列的所有节点位置信息\n     *  2. 重新计算分组的高度\n     *  3. 重新计算当前分组之后的所有分组的scrollTop以及分组内的节点位置\n     *  4. 更新分组内节点的渲染范围\n     */\n    this.sub<{ node: Node, newSize: Size, originalSize: Size }>(\n      SectionEvents.Resize,\n      debounce(() => {\n        this.setStateIn('height', this.maxColumnHeight)\n        this.updateBehindSectionsPosition()\n        if (this.isInRange) {\n          this.setStateIn('renderRange', this.getNodeRenderRange())\n        }\n        this.root.pub(RootEvents.Resize)\n      })\n    )\n  }\n\n  /**\n   * 获取当前分组的最大高度，分组的最大高度由分组最高列决定\n   * @returns 当前分组的最大高度\n   */\n  get maxColumnHeight() {\n    return Math.max(\n      ...this.columnMap.map(\n        (column) => column.reduce((buf, node) => buf + node.getState().height, 0) + (column.length - 1) * this.rowGap\n      )\n    )\n  }\n\n  /**\n   * 当前分组是否在可视区域\n   *\n   * 滚动偏移为 scrollOffset，容器的高度为 containerSize.height\n   *\n   * 当前容器滚动上边界(scrollBoundaryStart)为 scrollOffset，容器滚动的下边界(scrollBoundaryEnd)为 scrollOffset + containerSize.height\n   *\n   * 如果分组的 scrollTop 小于滚动下边界并且 scrollTop + 分组高度大于滚动上边界，那么分组在可视区域\n   */\n  get isInRange() {\n    const { scrollBoundaryStart, scrollBoundaryEnd } = this.root\n    const { height: sectionHeight, scrollTop: sectionScrollTop } = this.getState()\n    return sectionScrollTop <= scrollBoundaryEnd && sectionScrollTop + sectionHeight >= scrollBoundaryStart\n  }\n\n  /**\n   * 注册节点\n   */\n  private register(node: Node) {\n    const { col, order } = node\n    this.columnMap[col][order] = node\n    this.nodes.set(node.id, node)\n  }\n\n  /**\n   * 初始化分组内的列，即将一维数组转二维数组\n   */\n  private initializeColumnMap() {\n    const { count, col } = this\n    for (let i = 0; i < count; i++) {\n      this.pushNode(i, col)\n    }\n  }\n\n  /**\n   * 更新当前分组之后的分组的位置信息\n   */\n  private updateBehindSectionsPosition() {\n    let start = this.order + 1\n    if (start > this.root.sections.length) {\n      return\n    }\n    for (; start < this.root.sections.length; start++) {\n      const currentSection = this.root.sections[start - 1]\n      const nextSection = this.root.sections[start]\n      // 使用 maxColumnHeight 替代 getState().height，避免 pushNodes 后 state 未同步导致 footer 错位\n      const effectiveHeight = currentSection.maxColumnHeight\n      const newScrollTop = currentSection.getState().scrollTop + effectiveHeight + this.rowGap\n      nextSection.setStateIn('scrollTop', newScrollTop)\n      nextSection.updateNodes()\n    }\n  }\n\n  /**\n   * 更新指定列的节点位置信息\n   * @param col 列索引\n   */\n  private updateColumnNode(col: number) {\n    const column = this.columnMap[col]\n    const { scrollTop: sectionScrollTop } = this.getState()\n    for (let i = 0; i < column.length; i++) {\n      const node = column[i]\n      if (i === 0) {\n        node.setStateBatch({\n          scrollTop: sectionScrollTop,\n          top: 0,\n        })\n      } else {\n        const prevNode = column[i - 1]\n        const { scrollTop: prevNodeScrollTop, height: prevNodeHeight, top: prevNodeTop } = prevNode.getState()\n        node.setStateBatch({\n          scrollTop: prevNodeScrollTop + prevNodeHeight + this.rowGap,\n          top: prevNodeHeight + prevNodeTop + this.rowGap,\n        })\n      }\n    }\n  }\n\n  /**\n   * 更新每列节点的位置\n   */\n  private updateNodes() {\n    for (let col = 0; col < this.columnMap.length; col++) {\n      this.updateColumnNode(col)\n    }\n  }\n\n  /**\n   * 计算当前分组的 scrollTop，即该分组之前的所有分组的最大列高度 + rowGap 之和\n   */\n  private calcScrollTop() {\n    return this.root.sections.slice(0, this.order).reduce(\n      (acc, section) => acc + section.maxColumnHeight + (section.rowGap ?? 0),\n      0\n    )\n  }\n\n  /**\n   * 计算当前分组内每列应该渲染的节点索引区间\n   */\n  public getNodeRenderRange() {\n    if (!this.isInRange) {\n      return Array.from({ length: this.col }, () => [0, -1] as [number, number])\n    }\n\n    const result = Array.from({ length: this.col }, () => [Infinity, -Infinity] as unknown as [number, number])\n    for (let i = 0; i < this.columnMap.length; i++) {\n      const column = this.columnMap[i]\n      for (let j = 0; j < column.length; j++) {\n        const node = column[j]\n        if (node.isInRange) {\n          result[i][0] = Math.min(result[i][0], j)\n          result[i][1] = Math.max(result[i][1], j)\n        }\n      }\n      const start = result[i][0]\n      const end = result[i][1]\n      if (start === Infinity) {\n        result[i][0] = 0\n      }\n      if (end === -Infinity) {\n        result[i][1] = -1\n      }\n\n      const backwardDistance = this.root.nodeCacheBackward\n      const forwardDistance = this.root.nodeCacheForward\n      const overscanBackward = result[i][0] - backwardDistance\n      const overscanForward = result[i][1] + forwardDistance\n      result[i][0] = overscanBackward < 0 ? 0 : overscanBackward\n      result[i][1] = overscanForward > column.length ? column.length - 1 : overscanForward\n\n      // 列尾连续未测量节点纳入渲染区间，保证追加数据后能挂载并完成 measure\n      let tailUnmeasuredStart = column.length\n      for (let j = column.length - 1; j >= 0; j--) {\n        if (!column[j].getState().layouted) {\n          tailUnmeasuredStart = j\n        } else {\n          break\n        }\n      }\n      if (tailUnmeasuredStart < column.length) {\n        result[i][0] = Math.min(result[i][0], tailUnmeasuredStart)\n        result[i][1] = Math.max(result[i][1], column.length - 1)\n      }\n    }\n\n    const prevRange = this.getState().renderRange\n    return isSameRenderRange(result, prevRange) ? prevRange : result\n  }\n\n  public pushNode(nodeIndex: number, col: number) {\n    const { row: rowIndex, col: columnIndex } = getMatrixPosition(nodeIndex, col)\n    const node = new Node(this.root, this, {\n      childIndex: nodeIndex,\n      order: rowIndex,\n      col: columnIndex,\n      height: this.defaultSize,\n    })\n    this.register(node)\n    this.root.registerNode(node)\n  }\n\n  /** 仅扩展 columnMap / 注册 Node，不 setState；与 finalizePushNodesStateIfNeeded 配对 */\n  public pushNodesStructuralOnly (count: number) {\n    const { count: originalCount, col } = this\n    for (let i = originalCount; i < originalCount + count; i++) {\n      this.pushNode(i, col)\n    }\n    this.count += count\n    this.root.lowerThresholdScrollTop = Infinity\n    this._pendingPushFinalize = true\n  }\n\n  /** 在 commit 后同步 height、节点位置与 scrollHeight（见 WaterFlow useLayoutEffect） */\n  public finalizePushNodesStateIfNeeded () {\n    if (!this._pendingPushFinalize) return\n    this._pendingPushFinalize = false\n    // 同步 section state.height，避免与 maxColumnHeight 不一致导致 footer 错位\n    this.setStateIn('height', this.maxColumnHeight)\n    this.updateNodes()\n    this.updateBehindSectionsPosition()\n    // 立即更新 scrollHeight，避免防抖导致容器高度滞后引发往上抖动\n    this.root.updateScrollHeight(true)\n    if (this.isInRange) {\n      this.setStateIn('renderRange', this.getNodeRenderRange())\n    }\n    // 扩展 Root 的 section 切片，保证多 FlowSection 时当前分组始终在渲染树内\n    const [rStart, rEnd] = this.root.getState().renderRange\n    const newStart = Math.min(rStart, this.order)\n    const newEnd = Math.max(rEnd, this.order)\n    if (newStart !== rStart || newEnd !== rEnd) {\n      this.root.setStateIn('renderRange', [newStart, newEnd])\n    }\n    this.root.resetLowerReachEdgeAfterContentChange()\n  }\n\n  public pushNodes (count: number) {\n    this.pushNodesStructuralOnly(count)\n    this.finalizePushNodesStateIfNeeded()\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/components/water-flow/utils.d.ts

@@ -27,4 +27,8 @@ export declare const createImperativePromise: () => {
     reject: (reason?: any) => void;
 };
 export declare const isWeb: () => boolean;
+/** 判断是否为 H5（用于 scrollElement 模式等） */
+export declare const isH5: boolean;
+/** 判断是否为微信小程序（用于 scrollElement 模式等） */
+export declare const isWeapp: boolean;
 export {};

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

@@ -40,6 +40,10 @@ const createImperativePromise = () => {
     return Object.assign(Object.assign({}, handle), { promise });
 };
 const isWeb = () => getEnv().toLowerCase() === 'web';
+/** 判断是否为 H5（用于 scrollElement 模式等） */
+const isH5 = process.env.TARO_ENV === 'h5';
+/** 判断是否为微信小程序（用于 scrollElement 模式等） */
+const isWeapp = process.env.TARO_ENV === 'weapp';
 
-export { createImperativePromise, getMatrixPosition, getSysInfo, isSameRenderRange, isWeb };
+export { createImperativePromise, getMatrixPosition, getSysInfo, isH5, isSameRenderRange, isWeapp, isWeb };
 //# sourceMappingURL=utils.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sources":["../../../src/components/water-flow/utils.ts"],"sourcesContent":["import { getEnv, getSystemInfoSync } from '@tarojs/taro'\n\nlet sysInfo: ReturnType<typeof getSystemInfoSync>\n\nexport const getSysInfo = () => {\n  if (sysInfo) return sysInfo\n  sysInfo = getSystemInfoSync()\n  return sysInfo\n}\n\ntype ArrIndex = number;\n/**\n * 一维数组索引换算到二维数组\n * @param i 一维数组索引\n * @param columns 列数\n */\nexport function getMatrixPosition(i: ArrIndex, columns: number) {\n  const col = i % columns // 列号\n  const row = Math.floor(i / columns) // 行号\n  return { row, col }\n}\n\n/**\n * 简单比较渲染区间范围\n */\nexport function isSameRenderRange(a: any[], b: any[]) {\n  return JSON.stringify(a) === JSON.stringify(b)\n}\n\n/**\n * 创建一个命令式的 promise 对象\n *\n * 返回的对象包含以下属性：\n * - promise: 一个新的 Promise 对象，初始状态为 pending。\n * - resolve: 一个函数，用于将 promise 状态置为 resolved。\n * - reject: 一个函数，用于将 promise 状态置为 rejected，并可以传递一个原因参数。\n */\nexport const createImperativePromise = () => {\n  type ImperativePromiseHandle = {\n    resolve: () => void\n    reject: (reason?: any) => void\n  };\n  const handle = {} as ImperativePromiseHandle\n  const promise = new Promise<void>((resolve, reject) => {\n    handle.resolve = resolve\n    handle.reject = reject\n  })\n  return {\n    ...handle,\n    promise,\n  }\n}\n\nexport const isWeb = () => getEnv().toLowerCase() === 'web'\n"],"names":[],"mappings":";;AAEA,IAAI,OAA6C;AAE1C,MAAM,UAAU,GAAG,MAAK;AAC7B,IAAA,IAAI,OAAO;AAAE,QAAA,OAAO,OAAO;IAC3B,OAAO,GAAG,iBAAiB,EAAE;AAC7B,IAAA,OAAO,OAAO;AAChB;AAGA;;;;AAIG;AACa,SAAA,iBAAiB,CAAC,CAAW,EAAE,OAAe,EAAA;AAC5D,IAAA,MAAM,GAAG,GAAG,CAAC,GAAG,OAAO,CAAA;AACvB,IAAA,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,CAAA;AACnC,IAAA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE;AACrB;AAEA;;AAEG;AACa,SAAA,iBAAiB,CAAC,CAAQ,EAAE,CAAQ,EAAA;AAClD,IAAA,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;AAChD;AAEA;;;;;;;AAOG;AACI,MAAM,uBAAuB,GAAG,MAAK;IAK1C,MAAM,MAAM,GAAG,EAA6B;IAC5C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,KAAI;AACpD,QAAA,MAAM,CAAC,OAAO,GAAG,OAAO;AACxB,QAAA,MAAM,CAAC,MAAM,GAAG,MAAM;AACxB,KAAC,CAAC;IACF,OACK,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,EAAA,EAAA,MAAM,CACT,EAAA,EAAA,OAAO,EACR,CAAA;AACH;AAEO,MAAM,KAAK,GAAG,MAAM,MAAM,EAAE,CAAC,WAAW,EAAE,KAAK;;;;"}
+{"version":3,"file":"utils.js","sources":["../../../src/components/water-flow/utils.ts"],"sourcesContent":["import { getEnv, getSystemInfoSync } from '@tarojs/taro'\n\nlet sysInfo: ReturnType<typeof getSystemInfoSync>\n\nexport const getSysInfo = () => {\n  if (sysInfo) return sysInfo\n  sysInfo = getSystemInfoSync()\n  return sysInfo\n}\n\ntype ArrIndex = number;\n/**\n * 一维数组索引换算到二维数组\n * @param i 一维数组索引\n * @param columns 列数\n */\nexport function getMatrixPosition(i: ArrIndex, columns: number) {\n  const col = i % columns // 列号\n  const row = Math.floor(i / columns) // 行号\n  return { row, col }\n}\n\n/**\n * 简单比较渲染区间范围\n */\nexport function isSameRenderRange(a: any[], b: any[]) {\n  return JSON.stringify(a) === JSON.stringify(b)\n}\n\n/**\n * 创建一个命令式的 promise 对象\n *\n * 返回的对象包含以下属性：\n * - promise: 一个新的 Promise 对象，初始状态为 pending。\n * - resolve: 一个函数，用于将 promise 状态置为 resolved。\n * - reject: 一个函数，用于将 promise 状态置为 rejected，并可以传递一个原因参数。\n */\nexport const createImperativePromise = () => {\n  type ImperativePromiseHandle = {\n    resolve: () => void\n    reject: (reason?: any) => void\n  };\n  const handle = {} as ImperativePromiseHandle\n  const promise = new Promise<void>((resolve, reject) => {\n    handle.resolve = resolve\n    handle.reject = reject\n  })\n  return {\n    ...handle,\n    promise,\n  }\n}\n\nexport const isWeb = () => getEnv().toLowerCase() === 'web'\n\n/** 判断是否为 H5（用于 scrollElement 模式等） */\nexport const isH5 = process.env.TARO_ENV === 'h5'\n\n/** 判断是否为微信小程序（用于 scrollElement 模式等） */\nexport const isWeapp = process.env.TARO_ENV === 'weapp'\n"],"names":[],"mappings":";;AAEA,IAAI,OAA6C;AAE1C,MAAM,UAAU,GAAG,MAAK;AAC7B,IAAA,IAAI,OAAO;AAAE,QAAA,OAAO,OAAO;IAC3B,OAAO,GAAG,iBAAiB,EAAE;AAC7B,IAAA,OAAO,OAAO;AAChB;AAGA;;;;AAIG;AACa,SAAA,iBAAiB,CAAC,CAAW,EAAE,OAAe,EAAA;AAC5D,IAAA,MAAM,GAAG,GAAG,CAAC,GAAG,OAAO,CAAA;AACvB,IAAA,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,CAAA;AACnC,IAAA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE;AACrB;AAEA;;AAEG;AACa,SAAA,iBAAiB,CAAC,CAAQ,EAAE,CAAQ,EAAA;AAClD,IAAA,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;AAChD;AAEA;;;;;;;AAOG;AACI,MAAM,uBAAuB,GAAG,MAAK;IAK1C,MAAM,MAAM,GAAG,EAA6B;IAC5C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,KAAI;AACpD,QAAA,MAAM,CAAC,OAAO,GAAG,OAAO;AACxB,QAAA,MAAM,CAAC,MAAM,GAAG,MAAM;AACxB,KAAC,CAAC;IACF,OACK,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,EAAA,EAAA,MAAM,CACT,EAAA,EAAA,OAAO,EACR,CAAA;AACH;AAEO,MAAM,KAAK,GAAG,MAAM,MAAM,EAAE,CAAC,WAAW,EAAE,KAAK;AAEtD;AACa,MAAA,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK;AAE7C;AACa,MAAA,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK;;;;"}

package/dist/components/water-flow/water-flow-node-cache.d.ts

@@ -0,0 +1,24 @@
+import type { Root } from './root';
+/** 快速滑动判定：像素/秒 */
+export declare const WF_FAST_SCROLL_VELOCITY_PX_PER_S = 1000;
+/** 快速滑动时 cache 倍数 */
+export declare const WF_FAST_SCROLL_MULTIPLIER = 2;
+/** 单边 Node 缓存上限 */
+export declare const WF_FAST_SCROLL_NODE_CACHE_MAX = 30;
+/** 无 scroll 视为停止的等待（ms） */
+export declare const WF_SCROLL_STOP_MS = 300;
+/** 停止后多久收敛回 base cache（ms） */
+export declare const WF_CACHE_RESTORE_DELAY_MS = 2000;
+/** 过短间隔忽略 velocity（ms） */
+export declare const WF_VELOCITY_MIN_DELTA_MS = 16;
+/** 过长间隔视为新一段滚动（ms） */
+export declare const WF_VELOCITY_RESET_DELTA_MS = 500;
+export type WaterFlowNodeCacheControl = {
+    onScrollSample: (scrollTop: number) => void;
+    dispose: () => void;
+};
+/**
+ * 快速滑动时单边放大 Node 层 cache；停止后延迟收敛。
+ * 不暴露 props，内部常量可调参。
+ */
+export declare function createWaterFlowNodeCacheControl(root: Root, getBase: () => number): WaterFlowNodeCacheControl;

package/dist/components/water-flow/water-flow-node-cache.js

@@ -0,0 +1,161 @@
+import { cancelAnimationFrame, requestAnimationFrame } from '@tarojs/runtime';
+
+/** 快速滑动判定：像素/秒 */
+const WF_FAST_SCROLL_VELOCITY_PX_PER_S = 1000;
+/** 快速滑动时 cache 倍数 */
+const WF_FAST_SCROLL_MULTIPLIER = 2;
+/** 单边 Node 缓存上限 */
+const WF_FAST_SCROLL_NODE_CACHE_MAX = 30;
+/** 无 scroll 视为停止的等待（ms） */
+const WF_SCROLL_STOP_MS = 300;
+/** 停止后多久收敛回 base cache（ms） */
+const WF_CACHE_RESTORE_DELAY_MS = 2000;
+/** 过短间隔忽略 velocity（ms） */
+const WF_VELOCITY_MIN_DELTA_MS = 16;
+/** 过长间隔视为新一段滚动（ms） */
+const WF_VELOCITY_RESET_DELTA_MS = 500;
+/**
+ * 快速滑动时单边放大 Node 层 cache；停止后延迟收敛。
+ * 不暴露 props，内部常量可调参。
+ */
+function createWaterFlowNodeCacheControl(root, getBase) {
+    let lastProcessedScrollTop = 0;
+    let lastProcessedTime = 0;
+    let rafScheduled = false;
+    let rafId = null;
+    let pendingScrollTop = 0;
+    let pendingTime = 0;
+    let scrollStopTimer = null;
+    let restoreTimer = null;
+    let disposed = false;
+    /** 快滑会话：停滚收敛或长间隔重置前，轻滑仍按滚动方向维持单边放大 cache */
+    let boostSessionActive = false;
+    function flushVelocity() {
+        if (disposed)
+            return;
+        rafId = null;
+        rafScheduled = false;
+        const st = pendingScrollTop;
+        const t = pendingTime;
+        const base = getBase();
+        /** 基线 cache 已达快滑上限，放大无收益，直接收敛 */
+        if (base >= WF_FAST_SCROLL_NODE_CACHE_MAX) {
+            boostSessionActive = false;
+            root.setNodeCacheRange(base, base);
+            lastProcessedScrollTop = st;
+            lastProcessedTime = t;
+            return;
+        }
+        if (lastProcessedTime === 0) {
+            lastProcessedScrollTop = st;
+            lastProcessedTime = t;
+            boostSessionActive = false;
+            root.setNodeCacheRange(base, base);
+            return;
+        }
+        const dt = t - lastProcessedTime;
+        const delta = Math.abs(st - lastProcessedScrollTop);
+        if (dt < WF_VELOCITY_MIN_DELTA_MS) {
+            lastProcessedScrollTop = st;
+            lastProcessedTime = t;
+            return;
+        }
+        if (dt > WF_VELOCITY_RESET_DELTA_MS) {
+            lastProcessedScrollTop = st;
+            lastProcessedTime = t;
+            boostSessionActive = false;
+            root.setNodeCacheRange(base, base);
+            return;
+        }
+        const velocity = (delta / dt) * 1000;
+        const boosted = base > 0 ? Math.min(base * WF_FAST_SCROLL_MULTIPLIER, WF_FAST_SCROLL_NODE_CACHE_MAX) : 0;
+        const forwardDown = st >= lastProcessedScrollTop;
+        let backward = base;
+        let forward = base;
+        if (base > 0) {
+            if (velocity > WF_FAST_SCROLL_VELOCITY_PX_PER_S) {
+                boostSessionActive = true;
+            }
+            if (boostSessionActive) {
+                if (forwardDown) {
+                    forward = boosted;
+                    backward = base;
+                }
+                else {
+                    backward = boosted;
+                    forward = base;
+                }
+            }
+        }
+        root.setNodeCacheRange(backward, forward);
+        lastProcessedScrollTop = st;
+        lastProcessedTime = t;
+    }
+    function onScrollSample(scrollTop) {
+        if (disposed)
+            return;
+        const base = getBase();
+        /** 基线已达快滑上限，跳过全部检测调度以减少开销 */
+        if (base >= WF_FAST_SCROLL_NODE_CACHE_MAX) {
+            boostSessionActive = false;
+            if (rafId != null) {
+                cancelAnimationFrame(rafId);
+                rafId = null;
+            }
+            rafScheduled = false;
+            if (scrollStopTimer != null) {
+                clearTimeout(scrollStopTimer);
+                scrollStopTimer = null;
+            }
+            if (restoreTimer != null) {
+                clearTimeout(restoreTimer);
+                restoreTimer = null;
+            }
+            return;
+        }
+        pendingScrollTop = scrollTop;
+        pendingTime = Date.now();
+        if (!rafScheduled) {
+            rafScheduled = true;
+            rafId = requestAnimationFrame(flushVelocity);
+        }
+        if (scrollStopTimer != null) {
+            clearTimeout(scrollStopTimer);
+            scrollStopTimer = null;
+        }
+        if (restoreTimer != null) {
+            clearTimeout(restoreTimer);
+            restoreTimer = null;
+        }
+        scrollStopTimer = setTimeout(() => {
+            scrollStopTimer = null;
+            restoreTimer = setTimeout(() => {
+                restoreTimer = null;
+                if (disposed)
+                    return;
+                boostSessionActive = false;
+                root.setNodeCacheRange(getBase(), getBase());
+            }, WF_CACHE_RESTORE_DELAY_MS);
+        }, WF_SCROLL_STOP_MS);
+    }
+    function dispose() {
+        disposed = true;
+        if (rafId != null) {
+            cancelAnimationFrame(rafId);
+            rafId = null;
+        }
+        rafScheduled = false;
+        if (scrollStopTimer != null) {
+            clearTimeout(scrollStopTimer);
+            scrollStopTimer = null;
+        }
+        if (restoreTimer != null) {
+            clearTimeout(restoreTimer);
+            restoreTimer = null;
+        }
+    }
+    return { onScrollSample, dispose };
+}
+
+export { WF_CACHE_RESTORE_DELAY_MS, WF_FAST_SCROLL_MULTIPLIER, WF_FAST_SCROLL_NODE_CACHE_MAX, WF_FAST_SCROLL_VELOCITY_PX_PER_S, WF_SCROLL_STOP_MS, WF_VELOCITY_MIN_DELTA_MS, WF_VELOCITY_RESET_DELTA_MS, createWaterFlowNodeCacheControl };
+//# sourceMappingURL=water-flow-node-cache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"water-flow-node-cache.js","sources":["../../../src/components/water-flow/water-flow-node-cache.ts"],"sourcesContent":["import { cancelAnimationFrame, requestAnimationFrame } from '@tarojs/runtime'\n\nimport type { Root } from './root'\n\n/** 快速滑动判定：像素/秒 */\nexport const WF_FAST_SCROLL_VELOCITY_PX_PER_S = 1000\n/** 快速滑动时 cache 倍数 */\nexport const WF_FAST_SCROLL_MULTIPLIER = 2\n/** 单边 Node 缓存上限 */\nexport const WF_FAST_SCROLL_NODE_CACHE_MAX = 30\n/** 无 scroll 视为停止的等待（ms） */\nexport const WF_SCROLL_STOP_MS = 300\n/** 停止后多久收敛回 base cache（ms） */\nexport const WF_CACHE_RESTORE_DELAY_MS = 2000\n/** 过短间隔忽略 velocity（ms） */\nexport const WF_VELOCITY_MIN_DELTA_MS = 16\n/** 过长间隔视为新一段滚动（ms） */\nexport const WF_VELOCITY_RESET_DELTA_MS = 500\n\nexport type WaterFlowNodeCacheControl = {\n  onScrollSample: (scrollTop: number) => void\n  dispose: () => void\n}\n\n/**\n * 快速滑动时单边放大 Node 层 cache；停止后延迟收敛。\n * 不暴露 props，内部常量可调参。\n */\nexport function createWaterFlowNodeCacheControl (\n  root: Root,\n  getBase: () => number\n): WaterFlowNodeCacheControl {\n  let lastProcessedScrollTop = 0\n  let lastProcessedTime = 0\n  let rafScheduled = false\n  let rafId: number | null = null\n  let pendingScrollTop = 0\n  let pendingTime = 0\n  let scrollStopTimer: ReturnType<typeof setTimeout> | null = null\n  let restoreTimer: ReturnType<typeof setTimeout> | null = null\n  let disposed = false\n  /** 快滑会话：停滚收敛或长间隔重置前，轻滑仍按滚动方向维持单边放大 cache */\n  let boostSessionActive = false\n\n  function flushVelocity () {\n    if (disposed) return\n    rafId = null\n    rafScheduled = false\n    const st = pendingScrollTop\n    const t = pendingTime\n    const base = getBase()\n\n    /** 基线 cache 已达快滑上限，放大无收益，直接收敛 */\n    if (base >= WF_FAST_SCROLL_NODE_CACHE_MAX) {\n      boostSessionActive = false\n      root.setNodeCacheRange(base, base)\n      lastProcessedScrollTop = st\n      lastProcessedTime = t\n      return\n    }\n\n    if (lastProcessedTime === 0) {\n      lastProcessedScrollTop = st\n      lastProcessedTime = t\n      boostSessionActive = false\n      root.setNodeCacheRange(base, base)\n      return\n    }\n\n    const dt = t - lastProcessedTime\n    const delta = Math.abs(st - lastProcessedScrollTop)\n\n    if (dt < WF_VELOCITY_MIN_DELTA_MS) {\n      lastProcessedScrollTop = st\n      lastProcessedTime = t\n      return\n    }\n\n    if (dt > WF_VELOCITY_RESET_DELTA_MS) {\n      lastProcessedScrollTop = st\n      lastProcessedTime = t\n      boostSessionActive = false\n      root.setNodeCacheRange(base, base)\n      return\n    }\n\n    const velocity = (delta / dt) * 1000\n    const boosted =\n      base > 0 ? Math.min(base * WF_FAST_SCROLL_MULTIPLIER, WF_FAST_SCROLL_NODE_CACHE_MAX) : 0\n    const forwardDown = st >= lastProcessedScrollTop\n\n    let backward = base\n    let forward = base\n    if (base > 0) {\n      if (velocity > WF_FAST_SCROLL_VELOCITY_PX_PER_S) {\n        boostSessionActive = true\n      }\n      if (boostSessionActive) {\n        if (forwardDown) {\n          forward = boosted\n          backward = base\n        } else {\n          backward = boosted\n          forward = base\n        }\n      }\n    }\n\n    root.setNodeCacheRange(backward, forward)\n    lastProcessedScrollTop = st\n    lastProcessedTime = t\n  }\n\n  function onScrollSample (scrollTop: number) {\n    if (disposed) return\n\n    const base = getBase()\n    /** 基线已达快滑上限，跳过全部检测调度以减少开销 */\n    if (base >= WF_FAST_SCROLL_NODE_CACHE_MAX) {\n      boostSessionActive = false\n      if (rafId != null) {\n        cancelAnimationFrame(rafId)\n        rafId = null\n      }\n      rafScheduled = false\n      if (scrollStopTimer != null) {\n        clearTimeout(scrollStopTimer)\n        scrollStopTimer = null\n      }\n      if (restoreTimer != null) {\n        clearTimeout(restoreTimer)\n        restoreTimer = null\n      }\n      return\n    }\n\n    pendingScrollTop = scrollTop\n    pendingTime = Date.now()\n    if (!rafScheduled) {\n      rafScheduled = true\n      rafId = requestAnimationFrame(flushVelocity) as unknown as number\n    }\n\n    if (scrollStopTimer != null) {\n      clearTimeout(scrollStopTimer)\n      scrollStopTimer = null\n    }\n    if (restoreTimer != null) {\n      clearTimeout(restoreTimer)\n      restoreTimer = null\n    }\n\n    scrollStopTimer = setTimeout(() => {\n      scrollStopTimer = null\n      restoreTimer = setTimeout(() => {\n        restoreTimer = null\n        if (disposed) return\n        boostSessionActive = false\n        root.setNodeCacheRange(getBase(), getBase())\n      }, WF_CACHE_RESTORE_DELAY_MS)\n    }, WF_SCROLL_STOP_MS)\n  }\n\n  function dispose () {\n    disposed = true\n    if (rafId != null) {\n      cancelAnimationFrame(rafId)\n      rafId = null\n    }\n    rafScheduled = false\n    if (scrollStopTimer != null) {\n      clearTimeout(scrollStopTimer)\n      scrollStopTimer = null\n    }\n    if (restoreTimer != null) {\n      clearTimeout(restoreTimer)\n      restoreTimer = null\n    }\n  }\n\n  return { onScrollSample, dispose }\n}\n"],"names":[],"mappings":"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"}

package/dist/components/water-flow/water-flow.d.ts

@@ -1,4 +1,3 @@
-import { ScrollViewProps } from '@tarojs/components';
-import { PropsWithChildren, ReactElement } from 'react';
+import { PropsWithChildren } from 'react';
 import type { WaterFlowProps } from './interface';
-export declare function WaterFlow({ children, ...props }: PropsWithChildren<WaterFlowProps>): ReactElement<ScrollViewProps, string | import("react").JSXElementConstructor<any>>;
+export declare const WaterFlow: import("react").ForwardRefExoticComponent<Omit<PropsWithChildren<WaterFlowProps>, "ref"> & import("react").RefAttributes<HTMLElement>>;