vane-waterfall 2.0.2 → 2.0.3

package/dist/chunks/{doc-BfWnfTst.js → doc-CInpKZNU.js}

@@ -1,35 +1,46 @@
-function g(r = {}) {
+function S(e = {}) {
   return {
     name: "SortPlugin",
     priority: 30,
     enabled: !0,
     hooks: {
       transformProps: (o) => {
-        const e = Array.isArray(o.items) ? o.items : [], t = o.sortComparator || r.comparator;
+        const r = Array.isArray(o.items) ? o.items : [], t = o.sortComparator || e.comparator;
         if (typeof t != "function") return o;
-        const s = [...e].sort((a, n) => {
+        const s = [...r].sort((n, a) => {
           try {
-            return t(a, n);
+            return t(n, a);
           } catch {
             return 0;
           }
         });
         return { ...o, items: s };
       },
-      onPropsChange: (o, e, t) => {
-        const s = e?.sortComparator, a = t?.sortComparator;
-        if (((typeof t?.scrollToTopOnSortChange == "boolean" ? t.scrollToTopOnSortChange : void 0) ?? !!r.scrollToTop) && s !== a) {
-          const l = t?.scrollToTopBehavior ?? r.scrollBehavior ?? "auto";
-          o.scrollToTop?.({ behavior: l });
+      onPropsChange: (o, r, t) => {
+        const s = r?.sortComparator, n = t?.sortComparator;
+        if (((typeof t?.scrollToTopOnSortChange == "boolean" ? t.scrollToTopOnSortChange : void 0) ?? !!e.scrollToTop) && s !== n) {
+          const c = t?.scrollToTopBehavior ?? e.scrollBehavior ?? "auto";
+          o.scrollToTop?.({ behavior: c });
         }
       }
     }
   };
 }
-const c = "SortPlugin", i = "用比较函数排序，优先读 `props.sortComparator`。排序总是在过滤之后、分页之前执行，保证「第 N 页」是排序后的第 N 页。", m = "2.0.0", p = [
+const l = "SortPlugin", i = "用比较函数排序，优先读 `props.sortComparator`。排序总是在过滤之后、分页之前执行，保证「第 N 页」是排序后的第 N 页。", m = "2.0.0", p = [
   "data",
   "数据管线"
-], u = [
+], d = [
+  {
+    name: "onPropsChange",
+    when: "props 变化后",
+    description: "数据或配置变化时请求重排"
+  },
+  {
+    name: "transformProps",
+    when: "渲染前链式改写瀑布流 props",
+    description: "补 gap / columns 默认值、按断点覆盖配置"
+  }
+], u = [], h = "只读取 context 字段（props / state / data），不调用上下文方法", f = [
   {
     name: "comparator",
     type: "(a, b) => number",
@@ -48,7 +59,7 @@ const c = "SortPlugin", i = "用比较函数排序，优先读 `props.sortCompar
     default: '"auto"',
     description: "回顶行为"
   }
-], d = `// 按比较函数排序 items，比较函数变化可自动回顶。
+], C = `// 按比较函数排序 items，比较函数变化可自动回顶。
 const Waterfall = withPlugins(WaterfallCore, [
   createSortPlugin({
     scrollToTop: false,
@@ -56,28 +67,31 @@ const Waterfall = withPlugins(WaterfallCore, [
   }),
 ]);
 
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, f = [
+<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, T = [
   "稳定排序（不改原数组）",
   "比较函数抛错按相等处理",
   "与 Filter / Search 顺序固定"
-], h = [
+], g = [
   "价格 / 时间排序",
   "热度排序",
   "手动置顶项优先"
-], C = [
+], v = [
   "排序会复制数组（`[...items].sort`），不会改调用方传入的 items。"
-], y = {
-  name: c,
+], b = {
+  name: l,
   description: i,
   since: m,
   tags: p,
-  config: u,
-  example: d,
-  features: f,
-  useCases: h,
-  notes: C
+  events: d,
+  methods: u,
+  methodsNote: h,
+  config: f,
+  example: C,
+  features: T,
+  useCases: g,
+  notes: v
 };
 export {
-  g as c,
-  y as d
+  S as c,
+  b as d
 };

package/dist/chunks/{doc-gTAsLjVx.js → doc-CYxwSuG6.js}

@@ -1,55 +1,69 @@
-function u(n) {
+function g(t) {
   return {
     name: "AlignmentPlugin",
     priority: 60,
     enabled: !0,
     hooks: {
-      transformProps: (e) => ({ ...e, alignmentMode: n.mode }),
+      transformProps: (e) => ({ ...e, alignmentMode: t.mode }),
       onResize: (e) => {
         e.relayout?.();
       }
     }
   };
 }
-const t = "AlignmentPlugin", s = "设置瀑布流的列分配策略。shortest 让每列尽量等高（视觉最自然），balanced 让每列项数接近，sequential 按 index 轮转（可预测位置，适合需要与外部索引对齐的场景）。", o = "2.0.0", a = [
+const n = "AlignmentPlugin", s = "设置瀑布流的列分配策略。shortest 让每列尽量等高（视觉最自然），balanced 让每列项数接近，sequential 按 index 轮转（可预测位置，适合需要与外部索引对齐的场景）。", o = "2.0.0", a = [
   "layout",
   "布局"
 ], i = [
+  {
+    name: "onResize",
+    when: "容器宽度变化触发重排前",
+    description: "按新宽度调整列数或卡片密度"
+  },
+  {
+    name: "transformProps",
+    when: "渲染前链式改写瀑布流 props",
+    description: "补 gap / columns 默认值、按断点覆盖配置"
+  }
+], r = [], c = "只读取 context 字段（props / state / data），不调用上下文方法", l = [
   {
     name: "mode",
     type: '"shortest" | "balanced" | "sequential"',
     default: "shortest",
     description: "列分配策略"
   }
-], l = `// 指定列分配策略：最矮列优先（shortest）/ 项数均衡（balanced）/ 顺序轮转（sequential）。
+], m = `// 指定列分配策略：最矮列优先（shortest）/ 项数均衡（balanced）/ 顺序轮转（sequential）。
 const Waterfall = withPlugins(WaterfallCore, [
   createAlignmentPlugin({
     mode: "shortest",
   }),
 ]);
 
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, r = [
+<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, d = [
   "三种列分配策略",
   "只改 props.alignmentMode，不影响其他配置",
   "与 ResponsiveColumns / AutoColumn 正交"
-], c = [
+], u = [
   "内容流：默认 shortest",
   "等长卡片：balanced 更整齐",
   "需要与后端顺序对齐：sequential"
-], m = [
+], p = [
   "balanced 与 shortest 在列高相同时都取最左列，视觉上左偏是预期行为。"
-], d = {
-  name: t,
+], h = {
+  name: n,
   description: s,
   since: o,
   tags: a,
-  config: i,
-  example: l,
-  features: r,
-  useCases: c,
-  notes: m
+  events: i,
+  methods: r,
+  methodsNote: c,
+  config: l,
+  example: m,
+  features: d,
+  useCases: u,
+  notes: p
 };
 export {
-  u as c,
-  d
+  g as c,
+  h as d
 };

package/dist/chunks/{doc-DzvTrZ13.js → doc-CaJ02INP.js}

@@ -1,4 +1,4 @@
-function m(e) {
+function h(e) {
   return {
     name: "ThrottlePlugin",
     priority: 80,
@@ -12,10 +12,16 @@ function m(e) {
     }
   };
 }
-const n = "ThrottlePlugin", s = "接管 Core 的 throttleDelay（滚动回调节流）与 debounceDelay（尺寸变化后多久重排）。默认 16ms / 150ms，长列表滚动卡顿时可以放宽到 32 / 300。", o = "2.0.0", r = [
+const s = "ThrottlePlugin", n = "接管 Core 的 throttleDelay（滚动回调节流）与 debounceDelay（尺寸变化后多久重排）。默认 16ms / 150ms，长列表滚动卡顿时可以放宽到 32 / 300。", o = "2.0.0", r = [
   "perf",
   "性能"
 ], a = [
+  {
+    name: "transformProps",
+    when: "渲染前链式改写瀑布流 props",
+    description: "补 gap / columns 默认值、按断点覆盖配置"
+  }
+], c = [], l = "只读取 context 字段（props / state / data），不调用上下文方法", i = [
   {
     name: "scroll",
     type: "number",
@@ -28,33 +34,36 @@ const n = "ThrottlePlugin", s = "接管 Core 的 throttleDelay（滚动回调节
     default: "props.debounceDelay",
     description: "布局防抖 ms"
   }
-], l = `// 调整滚动节流与尺寸防抖，弱网/低端机可放宽。
+], m = `// 调整滚动节流与尺寸防抖，弱网/低端机可放宽。
 const Waterfall = withPlugins(WaterfallCore, [
   createThrottlePlugin(),
 ]);
 
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, c = [
+<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, u = [
   "滚动节流与布局防抖分开调",
   "只改 props，不改算法",
   "与 DebounceLayoutPlugin 叠加时后者优先"
-], i = [
+], d = [
   "低端安卓机长列表",
   "滚动时 CPU 占用过高",
   "拖拽侧栏时减少重排"
-], u = [
+], p = [
   "scroll 低于 16ms 没有意义（浏览器帧率上限）。"
-], d = {
-  name: n,
-  description: s,
+], f = {
+  name: s,
+  description: n,
   since: o,
   tags: r,
-  config: a,
-  example: l,
-  features: c,
-  useCases: i,
-  notes: u
+  events: a,
+  methods: c,
+  methodsNote: l,
+  config: i,
+  example: m,
+  features: u,
+  useCases: d,
+  notes: p
 };
 export {
-  m as c,
-  d
+  h as c,
+  f as d
 };

package/dist/chunks/{doc-BXElhF2h.js → doc-CiCso5Ti.js}

@@ -1,48 +1,48 @@
 import { jsx as E } from "react/jsx-runtime";
 const i = "data-drag-over";
-function y(s, l) {
+function w(a, c) {
   if (typeof document > "u") return null;
-  const c = document.elementFromPoint(s, l)?.closest?.("[data-index]");
-  if (!c) return null;
-  const d = Number(c.getAttribute("data-index"));
+  const l = document.elementFromPoint(a, c)?.closest?.("[data-index]");
+  if (!l) return null;
+  const d = Number(l.getAttribute("data-index"));
   return Number.isFinite(d) ? d : null;
 }
-function C(s = {}) {
-  const l = s.enabled ?? !0, g = s.showHandle ?? !1, c = s.touchHoldMs ?? 180, d = (t, n, r) => {
+function O(a = {}) {
+  const c = a.enabled ?? !0, g = a.showHandle ?? !1, l = a.touchHoldMs ?? 180, d = (t, n, r) => {
     const e = Number(r);
     if (!Number.isFinite(e) || e === n) return;
     t.sharedData.set("drag-from", e), t.sharedData.set("drag-to", n), t.bus.emit("drag:reorder", { from: e, to: n });
-    const f = t.props.items;
-    s.onReorder?.(e, n, f?.[e]);
-  }, b = () => {
+    const p = t.props.items;
+    a.onReorder?.(e, n, p?.[e]);
+  }, h = () => {
     document.querySelectorAll(`[${i}]`).forEach((t) => t.removeAttribute(i));
   }, m = () => {
-    typeof document > "u" || (b(), document.body.style.userSelect = "", document.body.style.cursor = "");
-  }, w = (t, n, r) => {
+    typeof document > "u" || (h(), document.body.style.userSelect = "", document.body.style.cursor = "");
+  }, y = (t, n, r) => {
     if (t.pointerType === "mouse") return;
-    const e = t.clientX, f = t.clientY, R = Date.now();
-    let p = !1, h = null;
+    const e = t.clientX, p = t.clientY, R = Date.now();
+    let f = !1, b = null;
     const v = (o) => {
-      if (!p) {
-        const D = Date.now() - R >= c, H = Math.hypot(o.clientX - e, o.clientY - f) >= 6;
+      if (!f) {
+        const D = Date.now() - R >= l, H = Math.hypot(o.clientX - e, o.clientY - p) >= 6;
         if (!D || !H) return;
-        p = !0, document.body.style.userSelect = "none", document.body.style.cursor = "grabbing";
+        f = !0, document.body.style.userSelect = "none", document.body.style.cursor = "grabbing";
       }
       o.preventDefault();
-      const a = y(o.clientX, o.clientY);
-      a !== h && (b(), h = a, a != null && document.querySelector(`[data-index="${a}"]`)?.setAttribute(i, ""));
+      const s = w(o.clientX, o.clientY);
+      s !== b && (h(), b = s, s != null && document.querySelector(`[data-index="${s}"]`)?.setAttribute(i, ""));
     }, u = (o) => {
-      if (window.removeEventListener("pointermove", v), window.removeEventListener("pointerup", u), window.removeEventListener("pointercancel", u), m(), !p) return;
-      const a = y(o.clientX, o.clientY);
-      a != null && d(r, a, String(n));
+      if (window.removeEventListener("pointermove", v), window.removeEventListener("pointerup", u), window.removeEventListener("pointercancel", u), m(), !f) return;
+      const s = w(o.clientX, o.clientY);
+      s != null && d(r, s, String(n));
     };
     window.addEventListener("pointermove", v, { passive: !1 }), window.addEventListener("pointerup", u), window.addEventListener("pointercancel", u);
   };
   return {
     name: "DragReorderPlugin",
-    enabled: l,
+    enabled: c,
     hooks: {
-      renderItemWrapper: (t, n, r) => l ? /* @__PURE__ */ E(
+      renderItemWrapper: (t, n, r) => c ? /* @__PURE__ */ E(
         "div",
         {
           draggable: !0,
@@ -62,7 +62,7 @@ function C(s = {}) {
             e.preventDefault(), m(), d(t, r, e.dataTransfer?.getData("text/plain") ?? "");
           },
           onDragEnd: m,
-          onPointerDown: (e) => w(e, r, t),
+          onPointerDown: (e) => y(e, r, t),
           style: {
             cursor: "grab",
             ...g ? { border: "1px dashed #bdbdbd", borderRadius: 6 } : null
@@ -77,6 +77,17 @@ const L = "DragReorderPlugin", M = "给每个项加拖拽能力，松手时回
   "interaction",
   "拖拽"
 ], S = [
+  {
+    name: "renderItemWrapper",
+    when: "渲染每个卡片时包裹其内容",
+    description: "给单卡加包裹层（拖拽、无障碍语义、占位骨架）"
+  },
+  {
+    name: "drag:reorder",
+    when: "拖拽排序完成后",
+    description: "广播 { from, to }，供业务层同步顺序"
+  }
+], T = [], N = "只读取 context 字段（props / state / data），不调用上下文方法", x = [
   {
     name: "enabled",
     type: "boolean",
@@ -101,7 +112,7 @@ const L = "DragReorderPlugin", M = "给每个项加拖拽能力，松手时回
     default: "180",
     description: "触屏长按多久进入拖拽（ms），0 表示不需要长按"
   }
-], T = `// 鼠标走 HTML5 draggable，触屏走长按 + pointer，松手时回调 onReorder(from, to)。
+], W = `// 鼠标走 HTML5 draggable，触屏走长按 + pointer，松手时回调 onReorder(from, to)。
 const Waterfall = withPlugins(WaterfallCore, [
   createDragReorderPlugin({
     enabled: true,
@@ -121,18 +132,21 @@ const Waterfall = withPlugins(WaterfallCore, [
 ], q = [
   "插件只负责「拖」和「告诉你从哪到哪」，数组重排由调用方在 onReorder 里做。",
   "触屏用长按区分「想滚」和「想拖」：不这样做，手指一滑就变成拖拽，页面滚不动。"
-], N = {
+], $ = {
   name: L,
   description: M,
   since: A,
   tags: P,
-  config: S,
-  example: T,
+  events: S,
+  methods: T,
+  methodsNote: N,
+  config: x,
+  example: W,
   features: X,
   useCases: Y,
   notes: q
 };
 export {
-  C as c,
-  N as d
+  O as c,
+  $ as d
 };

package/dist/chunks/{doc-BCmEnh39.js → doc-CkuMr8Ca.js}

@@ -1,39 +1,60 @@
-import { jsx as d } from "react/jsx-runtime";
-function W(n = {}) {
-  const l = n.containerRole ?? "list", c = n.itemRole ?? "listitem", u = n.enableTabIndex ?? !0, b = n.containerLabel ?? "Waterfall list", a = /* @__PURE__ */ new WeakMap(), i = (e) => e.containerRef?.current ?? e.bus, s = (e) => a.get(i(e)) ?? 0, r = (e) => {
+import { jsx as u } from "react/jsx-runtime";
+function w(n = {}) {
+  const l = n.containerRole ?? "list", c = n.itemRole ?? "listitem", m = n.enableTabIndex ?? !0, d = n.containerLabel ?? "Waterfall list", a = /* @__PURE__ */ new WeakMap(), s = (e) => e.containerRef?.current ?? e.bus, i = (e) => a.get(s(e)) ?? 0, o = (e) => {
     const t = e.containerRef.current;
-    t && (t.setAttribute("role", l), t.setAttribute("aria-label", b), t.setAttribute("aria-busy", e.isLayouting ? "true" : "false"));
+    t && (t.setAttribute("role", l), t.setAttribute("aria-label", d), t.setAttribute("aria-busy", e.isLayouting ? "true" : "false"));
   };
   return {
     name: "A11yPlugin",
     enabled: !0,
     hooks: {
       onMount: (e) => {
-        r(e);
+        o(e);
       },
       onLayoutComplete: (e) => {
-        r(e);
+        o(e);
       },
       onItemClick: (e, t) => {
-        s(e) !== t && (a.set(i(e), t), e.forceUpdate?.());
+        i(e) !== t && (a.set(s(e), t), e.forceUpdate?.());
       },
-      renderItemWrapper: (e, t, o) => /* @__PURE__ */ d(
+      renderItemWrapper: (e, t, r) => /* @__PURE__ */ u(
         "div",
         {
           role: c,
-          "aria-posinset": o + 1,
+          "aria-posinset": r + 1,
           "aria-setsize": e.itemCount,
-          tabIndex: u ? o === s(e) ? 0 : -1 : void 0,
+          tabIndex: m ? r === i(e) ? 0 : -1 : void 0,
           children: t
         }
       )
     }
   };
 }
-const m = "A11yPlugin", p = "把瀑布流补成读屏可理解的列表：容器 `role=list` + `aria-label`，每项 `role=listitem` + `aria-posinset` / `aria-setsize`，并可选加 `tabIndex` 让键盘能逐项聚焦。", f = "2.0.0", g = [
+const p = "A11yPlugin", b = "把瀑布流补成读屏可理解的列表：容器 `role=list` + `aria-label`，每项 `role=listitem` + `aria-posinset` / `aria-setsize`，并可选加 `tabIndex` 让键盘能逐项聚焦。", f = "2.0.0", y = [
   "ui",
   "a11y"
-], y = [
+], I = [
+  {
+    name: "onMount",
+    when: "瀑布流挂载完成",
+    description: "初始化观察器与滚动监听，返回清理函数"
+  },
+  {
+    name: "onItemClick",
+    when: "单个卡片被点击",
+    description: "卡片级跳转与点击埋点"
+  },
+  {
+    name: "onLayoutComplete",
+    when: "DOM 落位完成（可安全测量）",
+    description: "测量真实高度、懒加载判定、曝光上报"
+  },
+  {
+    name: "renderItemWrapper",
+    when: "渲染每个卡片时包裹其内容",
+    description: "给单卡加包裹层（拖拽、无障碍语义、占位骨架）"
+  }
+], g = [], R = "只读取 context 字段（props / state / data），不调用上下文方法", h = [
   {
     name: "containerRole",
     type: "string",
@@ -58,7 +79,7 @@ const m = "A11yPlugin", p = "把瀑布流补成读屏可理解的列表：容器
     default: '"Waterfall list"',
     description: "容器 aria-label"
   }
-], I = `// 给容器与项补 ARIA role / label / posinset，支持键盘 Tab 遍历。
+], C = `// 给容器与项补 ARIA role / label / posinset，支持键盘 Tab 遍历。
 const Waterfall = withPlugins(WaterfallCore, [
   createA11yPlugin({
     containerRole: "list",
@@ -67,28 +88,31 @@ const Waterfall = withPlugins(WaterfallCore, [
   }),
 ]);
 
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, R = [
+<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, A = [
   "容器 / 项 role 成对补齐",
   "aria-posinset + aria-setsize 正确标注序号",
   "键盘可逐项聚焦"
-], A = [
+], W = [
   "政务 / 金融等合规站点",
   "读屏用户可用的信息流",
   "键盘操作优先的桌面端"
-], C = [
+], T = [
   "项数很多时 `tabIndex=0` 会让 Tab 变长，建议配合「跳转主内容」链接使用。"
 ], x = {
-  name: m,
-  description: p,
+  name: p,
+  description: b,
   since: f,
-  tags: g,
-  config: y,
-  example: I,
-  features: R,
-  useCases: A,
-  notes: C
+  tags: y,
+  events: I,
+  methods: g,
+  methodsNote: R,
+  config: h,
+  example: C,
+  features: A,
+  useCases: W,
+  notes: T
 };
 export {
-  W as c,
+  w as c,
   x as d
 };

package/dist/chunks/{doc-3Fpag2G8.js → doc-D7m1OFCW.js}

@@ -1,4 +1,4 @@
-function g(o = {}) {
+function v(o = {}) {
   return {
     name: "FilterPlugin",
     priority: 40,
@@ -7,9 +7,9 @@ function g(o = {}) {
       transformProps: (e) => {
         const n = Array.isArray(e.items) ? e.items : [], t = e.filterFn || o.predicate;
         if (typeof t != "function") return e;
-        const r = n.filter((a, i) => {
+        const r = n.filter((s, a) => {
           try {
-            return !!t(a, i);
+            return !!t(s, a);
           } catch {
             return !0;
           }
@@ -17,19 +17,30 @@ function g(o = {}) {
         return { ...e, items: r };
       },
       onPropsChange: (e, n, t) => {
-        const r = n?.filterFn, a = t?.filterFn;
-        if (((typeof t?.scrollToTopOnFilterChange == "boolean" ? t.scrollToTopOnFilterChange : void 0) ?? !!o.scrollToTop) && r !== a) {
-          const l = t?.scrollToTopBehavior ?? o.scrollBehavior ?? "auto";
-          e.scrollToTop?.({ behavior: l });
+        const r = n?.filterFn, s = t?.filterFn;
+        if (((typeof t?.scrollToTopOnFilterChange == "boolean" ? t.scrollToTopOnFilterChange : void 0) ?? !!o.scrollToTop) && r !== s) {
+          const i = t?.scrollToTopBehavior ?? o.scrollBehavior ?? "auto";
+          e.scrollToTop?.({ behavior: i });
         }
       }
     }
   };
 }
-const s = "FilterPlugin", c = "用谓词函数过滤数据，优先读 `props.filterFn`，没有就用工厂里传入的 predicate。过滤条件变了可以自动滚回顶部（默认不开）。", u = "2.0.0", f = [
+const l = "FilterPlugin", c = "用谓词函数过滤数据，优先读 `props.filterFn`，没有就用工厂里传入的 predicate。过滤条件变了可以自动滚回顶部（默认不开）。", p = "2.0.0", d = [
   "data",
   "数据管线"
-], d = [
+], m = [
+  {
+    name: "onPropsChange",
+    when: "props 变化后",
+    description: "数据或配置变化时请求重排"
+  },
+  {
+    name: "transformProps",
+    when: "渲染前链式改写瀑布流 props",
+    description: "补 gap / columns 默认值、按断点覆盖配置"
+  }
+], u = [], f = "只读取 context 字段（props / state / data），不调用上下文方法", h = [
   {
     name: "predicate",
     type: "(item, index) => boolean",
@@ -48,7 +59,7 @@ const s = "FilterPlugin", c = "用谓词函数过滤数据，优先读 `props.fi
     default: '"auto"',
     description: "回顶行为"
   }
-], p = `// 按谓词过滤 items，参数变化可自动回顶。
+], F = `// 按谓词过滤 items，参数变化可自动回顶。
 const Waterfall = withPlugins(WaterfallCore, [
   createFilterPlugin({
     scrollToTop: false,
@@ -56,29 +67,32 @@ const Waterfall = withPlugins(WaterfallCore, [
   }),
 ]);
 
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, m = [
+<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, T = [
   "谓词抛错时按「保留」处理，不会整表消失",
   "props.filterFn 优先，便于页面动态换过滤条件",
   "可与 Sort / Search / Pagination 串联"
-], F = [
+], g = [
   "分类 Tab 切换",
   "只看有货 / 只看促销",
   "价格区间筛选"
-], h = [
+], y = [
   "数据管线的执行顺序由 priority 决定：Filter(40) → Sort(30) → Search(20) → Pagination(10)。",
   "先过滤再分页，页码总数才是过滤后的总数——顺序反了会出现「第 2 页空」。"
-], y = {
-  name: s,
+], b = {
+  name: l,
   description: c,
-  since: u,
-  tags: f,
-  config: d,
-  example: p,
-  features: m,
-  useCases: F,
-  notes: h
+  since: p,
+  tags: d,
+  events: m,
+  methods: u,
+  methodsNote: f,
+  config: h,
+  example: F,
+  features: T,
+  useCases: g,
+  notes: y
 };
 export {
-  g as c,
-  y as d
+  v as c,
+  b as d
 };