@tarojs/components-advanced 4.2.1-beta.2 → 4.2.1

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

@@ -1,24 +0,0 @@
-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

@@ -1,161 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/utils/scrollElementContext.d.ts

@@ -1,15 +0,0 @@
-import type { MutableRefObject } from 'react';
-/** 与 ScrollElementContextValue 同构，components-react 未导出时兜底 */
-export interface ScrollElementContextValueShape {
-    scrollRef: MutableRefObject<HTMLElement | null>;
-    containerHeight: number;
-    startOffset: number;
-    reportNestedHeightChange?: (scrollHeight: number) => void;
-}
-/**
- * 当 @tarojs/components-react 未导出 ScrollElementContext 时（版本过旧）兜底，
- * 避免 useContext(undefined) 报错。等效于无 Context，useContext 返回 null。
- */
-export declare const FALLBACK_SCROLL_ELEMENT_CTX: import("react").Context<ScrollElementContextValueShape>;
-/** 安全获取 ScrollElementContext：存在则用原版，否则用兜底 */
-export declare const ScrollElementContextOrFallback: import("react").Context<ScrollElementContextValueShape>;

package/dist/utils/scrollElementContext.js

@@ -1,14 +0,0 @@
-import * as ComponentsReact from '@tarojs/components-react';
-import { createContext } from 'react';
-
-var _a;
-/**
- * 当 @tarojs/components-react 未导出 ScrollElementContext 时（版本过旧）兜底，
- * 避免 useContext(undefined) 报错。等效于无 Context，useContext 返回 null。
- */
-const FALLBACK_SCROLL_ELEMENT_CTX = createContext(null);
-/** 安全获取 ScrollElementContext：存在则用原版，否则用兜底 */
-const ScrollElementContextOrFallback = (_a = ComponentsReact.ScrollElementContext) !== null && _a !== void 0 ? _a : FALLBACK_SCROLL_ELEMENT_CTX;
-
-export { FALLBACK_SCROLL_ELEMENT_CTX, ScrollElementContextOrFallback };
-//# sourceMappingURL=scrollElementContext.js.map

package/dist/utils/scrollElementContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"scrollElementContext.js","sources":["../../src/utils/scrollElementContext.ts"],"sourcesContent":["import * as ComponentsReact from '@tarojs/components-react'\nimport { createContext } from 'react'\n\nimport type { MutableRefObject } from 'react'\n\n/** 与 ScrollElementContextValue 同构，components-react 未导出时兜底 */\nexport interface ScrollElementContextValueShape {\n  scrollRef: MutableRefObject<HTMLElement | null>\n  containerHeight: number\n  startOffset: number\n  reportNestedHeightChange?: (scrollHeight: number) => void\n}\n\n/**\n * 当 @tarojs/components-react 未导出 ScrollElementContext 时（版本过旧）兜底，\n * 避免 useContext(undefined) 报错。等效于无 Context，useContext 返回 null。\n */\nexport const FALLBACK_SCROLL_ELEMENT_CTX =\n  createContext<ScrollElementContextValueShape | null>(null)\n\n/** 安全获取 ScrollElementContext：存在则用原版，否则用兜底 */\nexport const ScrollElementContextOrFallback =\n  (ComponentsReact as { ScrollElementContext?: typeof FALLBACK_SCROLL_ELEMENT_CTX }).ScrollElementContext ??\n  FALLBACK_SCROLL_ELEMENT_CTX\n"],"names":[],"mappings":";;;;AAaA;;;AAGG;MACU,2BAA2B,GACtC,aAAa,CAAwC,IAAI;AAE3D;AACa,MAAA,8BAA8B,GACzC,CAAA,EAAA,GAAC,eAAiF,CAAC,oBAAoB,MACvG,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,EAAA,GAAA;;;;"}

package/dist/utils/scrollParent.d.ts

@@ -1,33 +0,0 @@
-/**
- * 查找元素的真实滚动父节点。
- * 用于 nestedScroll 模式下无 props/Context 时自动获取 scrollElement。
- *
- * 策略：
- * 1. 优先命中 Taro ScrollView 类名 .taro-scroll
- * 2. 回退：向上遍历找通用可滚动祖先
- *
- * 严格条件（均需满足）：
- * - overflow 为 auto | scroll | overlay
- * - scrollHeight > clientHeight（纵向）或 scrollWidth > clientWidth（横向）
- * - 在 document.body 前停止
- */
-import type { TaroElement } from '@tarojs/runtime';
-/**
- * 判断元素是否可滚动（严格：overflow 可滚动 + 实际有溢出）
- */
-export declare function isScrollableElement(el: HTMLElement | null, vertical?: boolean): el is HTMLElement;
-/**
- * 从给定元素向上查找最近的滚动父节点。
- * 优先匹配 .taro-scroll，未命中则按通用可滚动条件查找。
- */
-export declare function findScrollParent(el: HTMLElement | null, vertical?: boolean): HTMLElement | null;
-/**
- * 小程序端：基于 Taro 虚拟 DOM 查找父级 scroll-view。
- * 从 contentId 对应节点沿 parentNode 向上遍历，找到 nodeName === 'scroll-view' 的节点。
- *
- * 仅用于小程序环境，H5 请使用 findScrollParent。
- *
- * @param contentId - content 节点的 id（需在 eventSource 中已注册）
- * @returns 找到的 TaroElement（scroll-view）或 null
- */
-export declare function findScrollParentTaro(contentId: string): TaroElement | null;

package/dist/utils/scrollParent.js

@@ -1,88 +0,0 @@
-import { document as document$1 } from '@tarojs/runtime';
-
-/**
- * 查找元素的真实滚动父节点。
- * 用于 nestedScroll 模式下无 props/Context 时自动获取 scrollElement。
- *
- * 策略：
- * 1. 优先命中 Taro ScrollView 类名 .taro-scroll
- * 2. 回退：向上遍历找通用可滚动祖先
- *
- * 严格条件（均需满足）：
- * - overflow 为 auto | scroll | overlay
- * - scrollHeight > clientHeight（纵向）或 scrollWidth > clientWidth（横向）
- * - 在 document.body 前停止
- */
-const SCROLLABLE_OVERFLOW = ['auto', 'scroll', 'overlay'];
-/** 小程序端 scroll-view 的 nodeName（Taro 虚拟 DOM） */
-const SCROLL_VIEW_NODE_NAME = 'scroll-view';
-/**
- * 判断元素是否可滚动（严格：overflow 可滚动 + 实际有溢出）
- */
-function isScrollableElement(el, vertical = true) {
-    if (!el || el === document.body)
-        return false;
-    const style = getComputedStyle(el);
-    const overflow = vertical ? style.overflowY : style.overflowX;
-    if (!SCROLLABLE_OVERFLOW.includes(overflow))
-        return false;
-    const hasOverflow = vertical
-        ? el.scrollHeight > el.clientHeight
-        : el.scrollWidth > el.clientWidth;
-    return hasOverflow;
-}
-/**
- * 从给定元素向上查找最近的滚动父节点。
- * 优先匹配 .taro-scroll，未命中则按通用可滚动条件查找。
- */
-function findScrollParent(el, vertical = true) {
-    var _a;
-    if (!el)
-        return null;
-    // 1. 优先：Taro ScrollView 的 div（.taro-scroll）
-    const taroScroll = (_a = el.closest) === null || _a === void 0 ? void 0 : _a.call(el, '.taro-scroll');
-    if (taroScroll && taroScroll !== document.body && isScrollableElement(taroScroll, vertical)) {
-        return taroScroll;
-    }
-    // 2. 回退：通用可滚动祖先
-    let parent = el.parentElement;
-    while (parent !== null && parent !== document.body) {
-        if (isScrollableElement(parent, vertical))
-            return parent;
-        parent = parent.parentElement;
-    }
-    return null;
-}
-/**
- * 小程序端：基于 Taro 虚拟 DOM 查找父级 scroll-view。
- * 从 contentId 对应节点沿 parentNode 向上遍历，找到 nodeName === 'scroll-view' 的节点。
- *
- * 仅用于小程序环境，H5 请使用 findScrollParent。
- *
- * @param contentId - content 节点的 id（需在 eventSource 中已注册）
- * @returns 找到的 TaroElement（scroll-view）或 null
- */
-function findScrollParentTaro(contentId) {
-    var _a;
-    if (!contentId)
-        return null;
-    const doc = document$1;
-    const el = (_a = doc.getElementById) === null || _a === void 0 ? void 0 : _a.call(doc, contentId);
-    if (!el || !el.parentNode)
-        return null;
-    let node = el;
-    while (node) {
-        const parent = node.parentNode;
-        if (!parent)
-            break;
-        // NodeType.ELEMENT_NODE === 1
-        if (parent.nodeType === 1 && parent.nodeName === SCROLL_VIEW_NODE_NAME) {
-            return parent;
-        }
-        node = parent;
-    }
-    return null;
-}
-
-export { findScrollParent, findScrollParentTaro, isScrollableElement };
-//# sourceMappingURL=scrollParent.js.map

package/dist/utils/scrollParent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"scrollParent.js","sources":["../../src/utils/scrollParent.ts"],"sourcesContent":["/**\n * 查找元素的真实滚动父节点。\n * 用于 nestedScroll 模式下无 props/Context 时自动获取 scrollElement。\n *\n * 策略：\n * 1. 优先命中 Taro ScrollView 类名 .taro-scroll\n * 2. 回退：向上遍历找通用可滚动祖先\n *\n * 严格条件（均需满足）：\n * - overflow 为 auto | scroll | overlay\n * - scrollHeight > clientHeight（纵向）或 scrollWidth > clientWidth（横向）\n * - 在 document.body 前停止\n */\n\nimport { document as taroDocument } from '@tarojs/runtime'\n\nimport type { TaroElement, TaroNode } from '@tarojs/runtime'\n\nconst SCROLLABLE_OVERFLOW = ['auto', 'scroll', 'overlay'] as const\n\n/** 小程序端 scroll-view 的 nodeName（Taro 虚拟 DOM） */\nconst SCROLL_VIEW_NODE_NAME = 'scroll-view'\n\n/**\n * 判断元素是否可滚动（严格：overflow 可滚动 + 实际有溢出）\n */\nexport function isScrollableElement(\n  el: HTMLElement | null,\n  vertical = true\n): el is HTMLElement {\n  if (!el || el === document.body) return false\n  const style = getComputedStyle(el)\n  const overflow = vertical ? style.overflowY : style.overflowX\n  if (!SCROLLABLE_OVERFLOW.includes(overflow as any)) return false\n  const hasOverflow = vertical\n    ? el.scrollHeight > el.clientHeight\n    : el.scrollWidth > el.clientWidth\n  return hasOverflow\n}\n\n/**\n * 从给定元素向上查找最近的滚动父节点。\n * 优先匹配 .taro-scroll，未命中则按通用可滚动条件查找。\n */\nexport function findScrollParent(\n  el: HTMLElement | null,\n  vertical = true\n): HTMLElement | null {\n  if (!el) return null\n\n  // 1. 优先：Taro ScrollView 的 div（.taro-scroll）\n  const taroScroll = el.closest?.('.taro-scroll')\n  if (taroScroll && taroScroll !== document.body && isScrollableElement(taroScroll as HTMLElement, vertical)) {\n    return taroScroll as HTMLElement\n  }\n\n  // 2. 回退：通用可滚动祖先\n  let parent: HTMLElement | null = el.parentElement\n  while (parent !== null && parent !== document.body) {\n    if (isScrollableElement(parent, vertical)) return parent\n    parent = (parent as HTMLElement).parentElement\n  }\n  return null\n}\n\n/**\n * 小程序端：基于 Taro 虚拟 DOM 查找父级 scroll-view。\n * 从 contentId 对应节点沿 parentNode 向上遍历，找到 nodeName === 'scroll-view' 的节点。\n *\n * 仅用于小程序环境，H5 请使用 findScrollParent。\n *\n * @param contentId - content 节点的 id（需在 eventSource 中已注册）\n * @returns 找到的 TaroElement（scroll-view）或 null\n */\nexport function findScrollParentTaro (contentId: string): TaroElement | null {\n  if (!contentId) return null\n  const doc = taroDocument as { getElementById: (id: string) => TaroElement | null }\n  const el = doc.getElementById?.(contentId)\n  if (!el || !el.parentNode) return null\n\n  let node: TaroNode | null = el\n  while (node) {\n    const parent = node.parentNode\n    if (!parent) break\n    // NodeType.ELEMENT_NODE === 1\n    if (parent.nodeType === 1 && (parent as TaroElement).nodeName === SCROLL_VIEW_NODE_NAME) {\n      return parent as TaroElement\n    }\n    node = parent\n  }\n  return null\n}\n\n"],"names":["taroDocument"],"mappings":";;AAAA;;;;;;;;;;;;AAYG;AAMH,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAU;AAElE;AACA,MAAM,qBAAqB,GAAG,aAAa;AAE3C;;AAEG;SACa,mBAAmB,CACjC,EAAsB,EACtB,QAAQ,GAAG,IAAI,EAAA;AAEf,IAAA,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,QAAQ,CAAC,IAAI;AAAE,QAAA,OAAO,KAAK;AAC7C,IAAA,MAAM,KAAK,GAAG,gBAAgB,CAAC,EAAE,CAAC;AAClC,IAAA,MAAM,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS;AAC7D,IAAA,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,QAAe,CAAC;AAAE,QAAA,OAAO,KAAK;IAChE,MAAM,WAAW,GAAG;AAClB,UAAE,EAAE,CAAC,YAAY,GAAG,EAAE,CAAC;UACrB,EAAE,CAAC,WAAW,GAAG,EAAE,CAAC,WAAW;AACnC,IAAA,OAAO,WAAW;AACpB;AAEA;;;AAGG;SACa,gBAAgB,CAC9B,EAAsB,EACtB,QAAQ,GAAG,IAAI,EAAA;;AAEf,IAAA,IAAI,CAAC,EAAE;AAAE,QAAA,OAAO,IAAI;;IAGpB,MAAM,UAAU,GAAG,CAAA,EAAA,GAAA,EAAE,CAAC,OAAO,MAAA,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAA,IAAA,CAAA,EAAA,EAAG,cAAc,CAAC;AAC/C,IAAA,IAAI,UAAU,IAAI,UAAU,KAAK,QAAQ,CAAC,IAAI,IAAI,mBAAmB,CAAC,UAAyB,EAAE,QAAQ,CAAC,EAAE;AAC1G,QAAA,OAAO,UAAyB;;;AAIlC,IAAA,IAAI,MAAM,GAAuB,EAAE,CAAC,aAAa;IACjD,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,QAAQ,CAAC,IAAI,EAAE;AAClD,QAAA,IAAI,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC;AAAE,YAAA,OAAO,MAAM;AACxD,QAAA,MAAM,GAAI,MAAsB,CAAC,aAAa;;AAEhD,IAAA,OAAO,IAAI;AACb;AAEA;;;;;;;;AAQG;AACG,SAAU,oBAAoB,CAAE,SAAiB,EAAA;;AACrD,IAAA,IAAI,CAAC,SAAS;AAAE,QAAA,OAAO,IAAI;IAC3B,MAAM,GAAG,GAAGA,UAAsE;IAClF,MAAM,EAAE,GAAG,CAAA,EAAA,GAAA,GAAG,CAAC,cAAc,MAAA,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAA,IAAA,CAAA,GAAA,EAAG,SAAS,CAAC;AAC1C,IAAA,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,UAAU;AAAE,QAAA,OAAO,IAAI;IAEtC,IAAI,IAAI,GAAoB,EAAE;IAC9B,OAAO,IAAI,EAAE;AACX,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU;AAC9B,QAAA,IAAI,CAAC,MAAM;YAAE;;AAEb,QAAA,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,IAAK,MAAsB,CAAC,QAAQ,KAAK,qBAAqB,EAAE;AACvF,YAAA,OAAO,MAAqB;;QAE9B,IAAI,GAAG,MAAM;;AAEf,IAAA,OAAO,IAAI;AACb;;;;"}

package/dist/utils/weapp-scope.d.ts

@@ -1,7 +0,0 @@
-/**
- * 微信小程序：从 Taro 节点 ref 取 SelectorQuery.in 所需作用域（`ref.current._scope`）。
- * 与运行时 TaroNode._scope（getNearestCtx）一致；非小程序恒为 undefined。
- */
-export declare function weappScope(ref: {
-    current: any;
-} | null | undefined): object | undefined;

package/dist/utils/weapp-scope.js

@@ -1,20 +0,0 @@
-const IS_TARO_WEAPP = process.env.TARO_ENV === 'weapp';
-/**
- * 微信小程序：从 Taro 节点 ref 取 SelectorQuery.in 所需作用域（`ref.current._scope`）。
- * 与运行时 TaroNode._scope（getNearestCtx）一致；非小程序恒为 undefined。
- */
-function weappScope(ref) {
-    if (!IS_TARO_WEAPP || !(ref === null || ref === void 0 ? void 0 : ref.current))
-        return undefined;
-    const cur = ref.current;
-    if (typeof (cur === null || cur === void 0 ? void 0 : cur._scope) === 'function') {
-        return cur._scope();
-    }
-    if ((cur === null || cur === void 0 ? void 0 : cur._scope) != null) {
-        return cur._scope;
-    }
-    return undefined;
-}
-
-export { weappScope };
-//# sourceMappingURL=weapp-scope.js.map

package/dist/utils/weapp-scope.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"weapp-scope.js","sources":["../../src/utils/weapp-scope.ts"],"sourcesContent":["const IS_TARO_WEAPP = process.env.TARO_ENV === 'weapp'\n\n/**\n * 微信小程序：从 Taro 节点 ref 取 SelectorQuery.in 所需作用域（`ref.current._scope`）。\n * 与运行时 TaroNode._scope（getNearestCtx）一致；非小程序恒为 undefined。\n */\nexport function weappScope (\n  ref: { current: any } | null | undefined\n): object | undefined {\n  if (!IS_TARO_WEAPP || !ref?.current) return undefined\n  const cur: any = ref.current\n  if (typeof cur?._scope === 'function') {\n    return cur._scope()\n  }\n  if (cur?._scope != null) {\n    return cur._scope\n  }\n  return undefined\n}\n"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO;AAEtD;;;AAGG;AACG,SAAU,UAAU,CACxB,GAAwC,EAAA;AAExC,IAAA,IAAI,CAAC,aAAa,IAAI,EAAC,GAAG,KAAH,IAAA,IAAA,GAAG,KAAH,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,GAAG,CAAE,OAAO,CAAA;AAAE,QAAA,OAAO,SAAS;AACrD,IAAA,MAAM,GAAG,GAAQ,GAAG,CAAC,OAAO;AAC5B,IAAA,IAAI,QAAO,GAAG,KAAA,IAAA,IAAH,GAAG,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAH,GAAG,CAAE,MAAM,CAAA,KAAK,UAAU,EAAE;AACrC,QAAA,OAAO,GAAG,CAAC,MAAM,EAAE;;IAErB,IAAI,CAAA,GAAG,KAAA,IAAA,IAAH,GAAG,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAH,GAAG,CAAE,MAAM,KAAI,IAAI,EAAE;QACvB,OAAO,GAAG,CAAC,MAAM;;AAEnB,IAAA,OAAO,SAAS;AAClB;;;;"}