vane-waterfall 2.0.1 → 2.0.3

package/dist/chunks/doc-B-7dugGv.js

@@ -1,79 +0,0 @@
-function S(a = {}) {
-  return {
-    name: "PaginationPlugin",
-    priority: 10,
-    enabled: !0,
-    hooks: {
-      transformProps: (e) => {
-        const t = Math.max(1, Number(e.pageIndex ?? 1)), o = Math.max(1, Number(e.pageSize ?? a.pageSize ?? 20)), s = Array.isArray(e.items) ? e.items : [], n = (t - 1) * o, i = n + o, r = s.slice(n, i);
-        return { ...e, items: r };
-      },
-      onPropsChange: (e, t, o) => {
-        const s = Math.max(1, Number(t?.pageIndex ?? 1)), n = Math.max(1, Number(o?.pageIndex ?? 1));
-        if (((typeof o?.scrollToTopOnPageChange == "boolean" ? o.scrollToTopOnPageChange : void 0) ?? !!a.scrollToTop) && s !== n) {
-          const l = o?.scrollToTopBehavior ?? a.scrollBehavior ?? "auto";
-          e.scrollToTop?.({ behavior: l });
-        }
-      }
-    }
-  };
-}
-const c = "PaginationPlugin", p = "读 `props.pageIndex`（1 基）与 `props.pageSize` 切片。放在数据管线最末端，保证切的是「过滤 + 排序 + 搜索」之后的结果。", g = "2.0.0", d = [
-  "data",
-  "数据管线",
-  "分页"
-], m = [
-  {
-    name: "pageSize",
-    type: "number",
-    default: "props.pageSize ?? 20",
-    description: "每页条数"
-  },
-  {
-    name: "scrollToTop",
-    type: "boolean",
-    default: "false",
-    description: "翻页后回顶"
-  },
-  {
-    name: "scrollBehavior",
-    type: '"auto" | "smooth"',
-    default: '"auto"',
-    description: "回顶行为"
-  }
-], u = `// 按 props.pageIndex / pageSize 切片，页码从 1 开始。
-const Waterfall = withPlugins(WaterfallCore, [
-  createPaginationPlugin({
-    scrollToTop: false,
-    scrollBehavior: "auto",
-  }),
-]);
-
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, f = [
-  "InfiniteScrollPlugin"
-], h = [
-  "1 基页码（与 UI 分页器一致）",
-  "pageIndex 非法值自动夹到 1",
-  "翻页自动回顶可选"
-], x = [
-  "后台列表分页",
-  "搜索结果分页",
-  "与 URLSyncPlugin 配合做可分享链接"
-], P = [
-  "pageSize 优先级：props.pageSize > 工厂 config.pageSize > 20。"
-], T = {
-  name: c,
-  description: p,
-  since: g,
-  tags: d,
-  config: m,
-  example: u,
-  conflicts: f,
-  features: h,
-  useCases: x,
-  notes: P
-};
-export {
-  S as c,
-  T as d
-};

package/dist/chunks/doc-B6kLfMPv.js

@@ -1,121 +0,0 @@
-import { jsxs as r } from "react/jsx-runtime";
-function k(l = {}) {
-  const m = l.showOverlay ?? l.showOverlaySummary ?? !1, a = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map();
-  let i = !1;
-  const c = (t) => Array.from(t.values()).reduce((e, s) => e + s, 0);
-  return {
-    name: "HeatmapAnalyticsPlugin",
-    enabled: !0,
-    getStats: () => {
-      const t = /* @__PURE__ */ new Set([...a.keys(), ...o.keys()]);
-      return {
-        totalViews: c(a),
-        totalClicks: c(o),
-        items: Array.from(t).sort((e, s) => e - s).map((e) => ({
-          index: e,
-          views: a.get(e) ?? 0,
-          clicks: o.get(e) ?? 0
-        }))
-      };
-    },
-    hooks: {
-      onLayoutComplete: (t) => {
-        if (i) return;
-        const { start: e, end: s } = t.visibleRange;
-        for (let n = e; n <= s; n++)
-          a.set(n, (a.get(n) || 0) + 1);
-        i = !0;
-      },
-      onItemEnterViewport: (t, e) => {
-        a.set(e, (a.get(e) || 0) + 1);
-      },
-      onItemClick: (t, e) => {
-        o.set(e, (o.get(e) || 0) + 1), t.forceUpdate?.();
-      },
-      renderOverlay: () => {
-        if (!m) return null;
-        const t = Array.from(a.values()).reduce((s, n) => s + n, 0), e = Array.from(o.values()).reduce((s, n) => s + n, 0);
-        return /* @__PURE__ */ r(
-          "div",
-          {
-            style: {
-              position: "sticky",
-              top: 0,
-              zIndex: 100,
-              display: "flex",
-              gap: 12,
-              alignItems: "center",
-              padding: "6px 10px",
-              background: "rgba(0,0,0,0.6)",
-              color: "white",
-              borderRadius: 8,
-              fontSize: 12,
-              marginBottom: 8
-            },
-            children: [
-              /* @__PURE__ */ r("span", { children: [
-                "曝光总计: ",
-                t
-              ] }),
-              /* @__PURE__ */ r("span", { children: [
-                "点击总计: ",
-                e
-              ] })
-            ]
-          }
-        );
-      }
-    }
-  };
-}
-const u = "HeatmapAnalyticsPlugin", p = "统计每项进入视口次数与点击次数，可选顶部汇总条，`getStats()` 取出每项明细。曝光是瀑布流里最容易统计错的东西（滚动时反复进出视口），交给插件比自己写 IntersectionObserver 少踩坑。", y = "2.0.0", d = [
-  "interaction",
-  "埋点",
-  "曝光"
-], f = [
-  {
-    name: "showOverlay",
-    type: "boolean",
-    default: "false",
-    description: "是否显示顶部汇总条"
-  },
-  {
-    name: "showOverlaySummary",
-    type: "boolean",
-    default: "—",
-    description: "showOverlay 的旧别名"
-  }
-], g = `// 统计每项曝光次数与点击次数，可显示汇总条。
-const Waterfall = withPlugins(WaterfallCore, [
-  createHeatmapAnalyticsPlugin({
-    showOverlay: false,
-  }),
-]);
-
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, w = [
-  "按项的曝光 / 点击双计数",
-  "首屏曝光在 onLayoutComplete 补一次",
-  "getStats() 输出可上报的扁平结构"
-], v = [
-  "信息流曝光分析",
-  "广告位可见性验证",
-  "调试曝光策略"
-], h = [
-  "首屏曝光靠 onLayoutComplete 补一次，否则第一帧显示 0。",
-  "真实上报要自己做去重与批次（插件只负责计数，不区分「同一项第几次进入」）。",
-  "计数只在内存里，刷新即清零 —— 定时取 getStats() 上报。"
-], O = {
-  name: u,
-  description: p,
-  since: y,
-  tags: d,
-  config: f,
-  example: g,
-  features: w,
-  useCases: v,
-  notes: h
-};
-export {
-  k as c,
-  O as d
-};

package/dist/chunks/doc-BCGQ8Cp5.js

@@ -1,114 +0,0 @@
-import { jsxs as a } from "react/jsx-runtime";
-const p = "GROUPS";
-function x(i = {}) {
-  const u = i.groupBy ?? ((e) => e?.category ?? "default"), l = i.showOverlay ?? !1, r = (e) => {
-    const t = /* @__PURE__ */ new Map();
-    return (e.props.items ?? []).forEach((s, n) => {
-      const o = u(s, n);
-      t.has(o) || t.set(o, []), t.get(o).push(n);
-    }), e.sharedData.set(p, t), t.size > 0 && e.bus.emit("grouping:change", { groups: t }), t;
-  };
-  return {
-    name: "GroupingPlugin",
-    enabled: !0,
-    hooks: {
-      onMount: (e) => {
-        r(e);
-      },
-      onLayoutComplete: (e) => {
-        r(e);
-      },
-      onPropsChange: (e) => {
-        r(e);
-      },
-      renderOverlay: (e) => {
-        if (!l) return null;
-        const t = e.sharedData.get(p) ?? /* @__PURE__ */ new Map();
-        if (t.size === 0) return null;
-        const s = Array.from(t.entries()).slice(0, 3);
-        return /* @__PURE__ */ a(
-          "div",
-          {
-            style: {
-              position: "absolute",
-              top: 12,
-              left: 12,
-              zIndex: 99,
-              background: "#111827",
-              color: "#fff",
-              padding: "10px 12px",
-              borderRadius: 8,
-              boxShadow: "0 4px 12px rgba(0,0,0,0.25)",
-              border: "1px solid rgba(255,255,255,0.15)",
-              minWidth: 150,
-              fontSize: 12,
-              pointerEvents: "none"
-            },
-            children: [
-              /* @__PURE__ */ a("div", { style: { opacity: 0.85, marginBottom: 6 }, children: [
-                "分组：",
-                t.size,
-                " 组"
-              ] }),
-              s.map(([n, o]) => /* @__PURE__ */ a("div", { children: [
-                String(n),
-                " · ",
-                o.length,
-                " 项"
-              ] }, String(n)))
-            ]
-          }
-        );
-      }
-    }
-  };
-}
-const c = "GroupingPlugin", d = "用 groupBy 把项按业务字段分组，结果放进 sharedData 的 `GROUPS`（Map<组键, 索引数组>），供 StickyHeaderPlugin、分组统计条等消费。挂载即算一次，之后 props 变化重算。", g = "2.0.0", f = [
-  "ui",
-  "分组"
-], m = [
-  {
-    name: "groupBy",
-    type: "(item, index) => string | number",
-    default: 'item.category ?? "default"',
-    description: "分组函数"
-  },
-  {
-    name: "showOverlay",
-    type: "boolean",
-    default: "false",
-    description: "是否显示分组统计角标"
-  }
-], h = `// 按字段把项分组，结果写进 sharedData(GROUPS) 供吸顶条 / 统计用。
-const Waterfall = withPlugins(WaterfallCore, [
-  createGroupingPlugin({
-    groupBy: "item.category ?? \\"default\\"",
-    showOverlay: false,
-  }),
-]);
-
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, y = [
-  "挂载即计算（旧版只在 props 变化时算，首屏永远拿不到分组）",
-  "结果写 sharedData，跨插件可读",
-  "统计角标默认关闭"
-], b = [
-  "按分类分组的信息流",
-  "按日期分组的时间线",
-  "吸顶条显示当前分组"
-], P = [
-  "分组只产出索引映射，不改变渲染顺序；要视觉分组请自己按分组建行。"
-], w = {
-  name: c,
-  description: d,
-  since: g,
-  tags: f,
-  config: m,
-  example: h,
-  features: y,
-  useCases: b,
-  notes: P
-};
-export {
-  x as c,
-  w as d
-};

package/dist/chunks/doc-BP0DmB7-.js

@@ -1,91 +0,0 @@
-function v(s = {}) {
-  const c = s.storageKey || "waterfall-bookmark", l = s.scrollBehavior || "smooth", u = (r) => {
-    const e = r;
-    if (!e) return !1;
-    const n = e.tagName?.toLowerCase(), a = (e.getAttribute && e.getAttribute("contenteditable")) === "true";
-    return n === "input" || n === "textarea" || a;
-  };
-  return {
-    name: "BookmarkPlugin",
-    enabled: !0,
-    hooks: {
-      onMount: (r) => {
-        const e = (n) => {
-          if (u(n.target)) return;
-          const a = (n.key || "").toLowerCase(), i = n.code || "";
-          if (a === "b" || i === "KeyB") {
-            const t = r.containerRef?.current || null;
-            let o = 0;
-            t && t.scrollHeight > t.clientHeight ? o = t.scrollTop : o = window.pageYOffset || document.documentElement.scrollTop || document.body.scrollTop || 0;
-            try {
-              localStorage.setItem(c, String(Math.max(0, o)));
-            } catch {
-            }
-          } else if (a === "r" || i === "KeyR") {
-            let t = 0;
-            try {
-              const d = localStorage.getItem(c) || "0";
-              t = Math.max(0, Number(d) || 0);
-            } catch {
-            }
-            const o = r.containerRef?.current || null;
-            o && o.scrollHeight > o.clientHeight ? o.scrollTo({ top: t, behavior: l }) : window.scrollTo({ top: t, behavior: l });
-          }
-        };
-        return window.addEventListener("keydown", e, { capture: !0 }), document.addEventListener("keydown", e, { capture: !0 }), () => {
-          window.removeEventListener("keydown", e, { capture: !0 }), document.removeEventListener("keydown", e, { capture: !0 });
-        };
-      }
-    }
-  };
-}
-const m = "BookmarkPlugin", g = "长列表读到一半要跳走时按 **B** 存位置，回来按 **R** 复原。焦点在输入框/可编辑区域时不拦截按键。", f = "2.0.0", k = [
-  "ui",
-  "滚动",
-  "快捷键"
-], p = [
-  {
-    name: "storageKey",
-    type: "string",
-    default: '"waterfall-bookmark"',
-    description: "localStorage 键名"
-  },
-  {
-    name: "scrollBehavior",
-    type: '"auto" | "smooth"',
-    default: '"smooth"',
-    description: "恢复时的滚动行为"
-  }
-], h = `// 按 B 记录滚动位置、按 R 跳回（localStorage），忽略输入框按键。
-const Waterfall = withPlugins(WaterfallCore, [
-  createBookmarkPlugin({
-    storageKey: "waterfall-bookmark",
-    scrollBehavior: "smooth",
-  }),
-]);
-
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, w = [
-  "B 存 / R 取，零 UI 侵入",
-  "自动区分容器滚动与页面滚动",
-  "输入框内不误触"
-], y = [
-  "长文列表阅读",
-  "后台大表格浏览",
-  "演示时快速复位"
-], b = [
-  "键名全局共用，一个页面里多处瀑布流请各自传不同的 storageKey。"
-], B = {
-  name: m,
-  description: g,
-  since: f,
-  tags: k,
-  config: p,
-  example: h,
-  features: w,
-  useCases: y,
-  notes: b
-};
-export {
-  v as c,
-  B as d
-};

package/dist/chunks/doc-CBHjiDG7.js

@@ -1,88 +0,0 @@
-function C(t = {}) {
-  const c = t.fields ?? [];
-  return {
-    name: "SearchPlugin",
-    priority: 20,
-    enabled: !0,
-    hooks: {
-      transformProps: (e) => {
-        const s = String(e.searchQuery ?? "").trim(), o = Array.isArray(e.items) ? e.items : [];
-        if (!s) return e;
-        const n = s.toLowerCase(), a = o.filter((r) => {
-          if (typeof r != "object" || r === null) return !1;
-          const i = c.length > 0 ? c : Object.keys(r);
-          for (const l of i) {
-            const u = r[l];
-            if (u != null && String(u).toLowerCase().includes(n)) return !0;
-          }
-          return !1;
-        });
-        return { ...e, items: a };
-      },
-      onPropsChange: (e, s, o) => {
-        const n = String(s?.searchQuery ?? ""), a = String(o?.searchQuery ?? "");
-        if (((typeof o?.scrollToTopOnSearchChange == "boolean" ? o.scrollToTopOnSearchChange : void 0) ?? !!t.scrollToTop) && n !== a) {
-          const l = o?.scrollToTopBehavior ?? t.scrollBehavior ?? "auto";
-          e.scrollToTop?.({ behavior: l });
-        }
-      }
-    }
-  };
-}
-const f = "SearchPlugin", d = "读取 `props.searchQuery`，在指定字段上做大小写不敏感的 `includes` 匹配。没指定字段就对对象的全部自有字段匹配。", h = "2.0.0", m = [
-  "data",
-  "数据管线",
-  "搜索"
-], p = [
-  {
-    name: "fields",
-    type: "(keyof T)[]",
-    default: "[]",
-    description: "参与匹配的字段；空则匹配全部自有字段"
-  },
-  {
-    name: "scrollToTop",
-    type: "boolean",
-    default: "false",
-    description: "关键词变化后回顶"
-  },
-  {
-    name: "scrollBehavior",
-    type: '"auto" | "smooth"',
-    default: '"auto"',
-    description: "回顶行为"
-  }
-], y = `// 按 props.searchQuery 做大小写不敏感的多字段包含匹配。
-const Waterfall = withPlugins(WaterfallCore, [
-  createSearchPlugin({
-    fields: [],
-    scrollToTop: false,
-    scrollBehavior: "auto",
-  }),
-]);
-
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, g = [
-  "大小写不敏感",
-  "多字段 OR 匹配",
-  "空关键词直接放行（不触发过滤）"
-], T = [
-  "站内搜索结果页",
-  "后台列表即时搜索",
-  "商品名 / 店铺名联合搜索"
-], S = [
-  "纯前端 `includes`，不排序也不做拼音；要相关性排序请在 Search 之后接 SortPlugin。"
-], b = {
-  name: f,
-  description: d,
-  since: h,
-  tags: m,
-  config: p,
-  example: y,
-  features: g,
-  useCases: T,
-  notes: S
-};
-export {
-  C as c,
-  b as d
-};

package/dist/chunks/doc-CraXjOaA.js

@@ -1,68 +0,0 @@
-function y(s) {
-  const e = /* @__PURE__ */ new Set(), o = () => {
-    if (e.size <= s.poolSize) return;
-    const t = e.values().next().value;
-    typeof t == "number" && e.delete(t);
-  };
-  return {
-    name: "RecyclePlugin",
-    enabled: !0,
-    hooks: {
-      onItemEnterViewport: (t, n) => {
-        const i = t.getItemRef(n);
-        i && (i.style.visibility = "visible"), e.add(n), o();
-      },
-      onItemLeaveViewport: (t, n) => {
-        const i = t.getItemRef(n);
-        i && (i.style.visibility = "hidden"), e.delete(n);
-      },
-      onItemUnmount: (t, n) => {
-        e.delete(n);
-      },
-      onUnmount: () => {
-        e.clear();
-      }
-    }
-  };
-}
-const c = "RecyclePlugin", l = "纯绘制层优化：项离开视口就 `visibility: hidden`，回来再显示。DOM 节点不销毁，滚动位置与已加载的图片都保留，适合「项里有视频/Canvas，重建代价高」的场景。", a = "2.0.0", r = [
-  "interaction",
-  "性能"
-], u = [
-  {
-    name: "poolSize",
-    type: "number",
-    default: "—",
-    description: "同时保持可见的项数上限（超出则回收最早的）"
-  }
-], m = `// 视口外的项设 \`visibility: hidden\`，降低长列表的绘制压力。
-const Waterfall = withPlugins(WaterfallCore, [
-  createRecyclePlugin(),
-]);
-
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, d = [
-  "不销毁 DOM，只隐藏",
-  "项内媒体不重新加载",
-  "与虚拟化正交（一个省绘制、一个省节点）"
-], f = [
-  "项内含视频 / canvas",
-  "长列表滚动发虚",
-  "低端设备省电"
-], v = [
-  "与 Core 的 `virtualize` 同开会让项被卸载又隐藏，收益互相抵消，建议只选一个。",
-  "只改 visibility 不改布局，所以不会引起重排。"
-], p = {
-  name: c,
-  description: l,
-  since: a,
-  tags: r,
-  config: u,
-  example: m,
-  features: d,
-  useCases: f,
-  notes: v
-};
-export {
-  y as c,
-  p as d
-};

package/dist/chunks/doc-DJjxOYzW.js

@@ -1,111 +0,0 @@
-function L(i = {}) {
-  const h = i.mode || "hash", r = i.keys || ["pageIndex", "pageSize", "searchQuery"];
-  function l() {
-    try {
-      if (h === "hash") {
-        const s = window.location.hash || "", t = s.indexOf("?"), a = t >= 0 ? s.slice(t + 1) : s.replace(/^#/, ""), e = new URLSearchParams(a), n = {};
-        return r.forEach((c) => {
-          const o = e.get(c);
-          o !== null && (n[c] = o);
-        }), n;
-      } else {
-        const s = new URLSearchParams(window.location.search), t = {};
-        return r.forEach((a) => {
-          const e = s.get(a);
-          e !== null && (t[a] = e);
-        }), t;
-      }
-    } catch {
-      return {};
-    }
-  }
-  function p(s) {
-    try {
-      const t = new URLSearchParams();
-      r.forEach((e) => {
-        const n = s[e];
-        n != null && String(n).length > 0 && t.set(e, String(n));
-      });
-      const a = t.toString();
-      if (h === "hash") {
-        const e = window.location.hash || "", o = `#${e.replace(/^#/, "").split("?")[0] || ""}${a ? `?${a}` : ""}`;
-        e !== o && history.replaceState(
-          null,
-          "",
-          `${window.location.pathname}${window.location.search}${o}`
-        );
-      } else {
-        const n = window.location.pathname + (a ? `?${a}` : "") + (window.location.hash || "");
-        history.replaceState(null, "", n);
-      }
-    } catch {
-    }
-  }
-  return {
-    name: "URLSyncPlugin",
-    enabled: !0,
-    hooks: {
-      onMount: (s) => {
-        const t = l();
-        s.bus?.emit("urlsync:init", t);
-      },
-      onPropsChange: (s, t, a) => {
-        const e = {}, n = a ?? {};
-        r.forEach((c) => {
-          const o = n[c];
-          o !== void 0 && (e[c] = o);
-        }), p(e);
-      }
-    }
-  };
-}
-const u = "URLSyncPlugin", d = "props 变化时把指定键写进 URL（hash 或 search），挂载时读出来广播 `urlsync:init`。刷新与分享都能还原筛选状态。", m = "2.0.0", w = [
-  "ui",
-  "URL",
-  "可分享"
-], f = [
-  {
-    name: "mode",
-    type: '"hash" | "search"',
-    default: '"hash"',
-    description: "写 hash 还是 search"
-  },
-  {
-    name: "keys",
-    type: "string[]",
-    default: '["pageIndex","pageSize","searchQuery"]',
-    description: "要同步的 props 键"
-  }
-], g = `// 把分页/搜索/排序同步进 URL（hash 或 search），链接可分享。
-const Waterfall = withPlugins(WaterfallCore, [
-  createURLSyncPlugin({
-    mode: "hash",
-    keys: ["pageIndex","pageSize","searchQuery"],
-  }),
-]);
-
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, S = [
-  "hash 模式会保留已有路由路径",
-  "用 replaceState，不污染后退栈",
-  "SSR 安全：无 window 时直接跳过"
-], y = [
-  "搜索结果可分享",
-  "后台筛选状态可刷新",
-  "带参数的深链"
-], R = [
-  "只做单向同步（props → URL）与初始读取；URL 前进后退的监听请页面自己做。"
-], U = {
-  name: u,
-  description: d,
-  since: m,
-  tags: w,
-  config: f,
-  example: g,
-  features: S,
-  useCases: y,
-  notes: R
-};
-export {
-  L as c,
-  U as d
-};