vane-waterfall 2.0.1 → 2.0.3

package/dist/chunks/doc-NhL4Ux8q.js

@@ -1,125 +0,0 @@
-function K(o = {}) {
-  const i = o.storageKey || "waterfall-state", l = o.persistScroll ?? !0, a = o.persistKeys || ["pageIndex", "pageSize", "searchQuery"];
-  let u = !1;
-  function c() {
-    try {
-      const e = localStorage.getItem(i);
-      return e ? JSON.parse(e) : null;
-    } catch {
-      return null;
-    }
-  }
-  function p(e) {
-    try {
-      localStorage.setItem(i, JSON.stringify(e));
-    } catch {
-    }
-  }
-  return {
-    name: "StatePersistencePlugin",
-    enabled: !0,
-    hooks: {
-      // 首次渲染时，尽量将本地快照中的分页/查询键注入到 props，便于核心按恢复后的状态渲染
-      transformProps: (e) => {
-        if (u) return e;
-        const t = c();
-        if (!t) return e;
-        const n = { ...e };
-        let s = !1;
-        return a.forEach((r) => {
-          t[r] !== void 0 && (n[r] = t[r], s = !0);
-        }), s && (u = !0), n;
-      },
-      onMount: (e) => {
-        const t = c();
-        if (!t) return;
-        if (l) {
-          const s = Number(t.scrollTop ?? 0), r = e.containerRef.current;
-          r ? r.scrollTo({ top: s, behavior: "auto" }) : e.scrollToTop?.({ behavior: "auto" });
-        }
-        const n = {};
-        if (a.forEach((s) => {
-          t[s] !== void 0 && (n[s] = t[s]);
-        }), Object.keys(n).length > 0 && (e.bus?.emit("state:restored", n), typeof window < "u"))
-          try {
-            window.dispatchEvent(new CustomEvent("waterfall:state-restored", { detail: n }));
-          } catch {
-          }
-      },
-      // props 变化时，增量更新快照（立即持久化分页/查询键）
-      onPropsChange: (e, t, n) => {
-        const r = { ...c() || {} }, g = n ?? {};
-        a.forEach((f) => {
-          const d = g[f];
-          d !== void 0 && (r[f] = d);
-        }), p(r);
-      },
-      onUnmount: (e) => {
-        const t = {};
-        l && (t.scrollTop = e.containerRef.current?.scrollTop || 0);
-        const n = e.props ?? {};
-        a.forEach((s) => {
-          const r = n[s];
-          r !== void 0 && (t[s] = r);
-        }), p(t);
-      }
-    }
-  };
-}
-const y = "StatePersistencePlugin", m = "三个时机各做一件事：首次渲染把快照里的 pageIndex / searchQuery 注入 props；挂载后恢复 scrollTop；props 变化与卸载时写回快照。刷新页面不丢进度。", S = "2.0.0", h = [
-  "ui",
-  "持久化"
-], w = [
-  {
-    name: "storageKey",
-    type: "string",
-    default: '"waterfall-state"',
-    description: "localStorage 键名"
-  },
-  {
-    name: "persistScroll",
-    type: "boolean",
-    default: "true",
-    description: "是否持久化滚动位置"
-  },
-  {
-    name: "persistKeys",
-    type: "string[]",
-    default: '["pageIndex","pageSize","searchQuery"]',
-    description: "要持久化的 props 键"
-  }
-], v = `// 把滚动位置与分页/查询状态存 localStorage，回来时恢复。
-const Waterfall = withPlugins(WaterfallCore, [
-  createStatePersistencePlugin({
-    storageKey: "waterfall-state",
-    persistScroll: true,
-    persistKeys: ["pageIndex","pageSize","searchQuery"],
-  }),
-]);
-
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, P = [
-  "滚动位置 + 分页/查询一起存",
-  "首帧注入只做一次，不会覆盖用户操作",
-  "SSR / 隐私模式下降级为不持久化"
-], b = [
-  "后台列表刷新不丢页",
-  "搜索结果返回定位",
-  "移动端来回切换页面"
-], I = [
-  "只能恢复「值」，不能替你把它写回 React state——页面应订阅 `state:restored` 事件或读 bus。",
-  "localStorage 不可用（隐私模式/配额满）时静默跳过，不会抛错。"
-], T = {
-  name: y,
-  description: m,
-  since: S,
-  tags: h,
-  config: w,
-  example: v,
-  features: P,
-  useCases: b,
-  notes: I
-};
-export {
-  K as c,
-  T as d
-};

package/dist/chunks/doc-f4Uijujv.js

@@ -1,102 +0,0 @@
-import { jsxs as u, jsx as f } from "react/jsx-runtime";
-function v(o = {}) {
-  const { log: i = !1, showOverlay: l = !1 } = o, n = /* @__PURE__ */ new Map(), s = () => Array.from(n.values()).reduce((t, e) => t + e, 0);
-  return {
-    name: "ClickAnalyticsPlugin",
-    enabled: !0,
-    getStats: () => ({
-      total: s(),
-      byIndex: Array.from(n.entries()).map(([t, e]) => ({ index: t, clicks: e })).sort((t, e) => t.index - e.index)
-    }),
-    hooks: {
-      onMount: (t) => {
-        t.sharedData?.set("click-count", s());
-      },
-      onItemClick: (t, e, c, r) => {
-        const d = (n.get(e) ?? 0) + 1;
-        n.set(e, d);
-        const a = s();
-        t.sharedData?.set("click-count", a), t.bus?.emit("analytics:click", { index: e, item: c, event: r, total: a }), t.forceUpdate?.(), i && console.log(`[ClickAnalytics] item=${e} total=${a}`);
-      },
-      renderOverlay: (t) => {
-        if (!l) return null;
-        const e = t.sharedData?.get("click-count") || 0;
-        return /* @__PURE__ */ u(
-          "div",
-          {
-            style: {
-              position: "absolute",
-              top: 12,
-              right: 12,
-              padding: "10px 12px",
-              background: "#222",
-              color: "#fff",
-              borderRadius: 8,
-              fontSize: 14,
-              fontWeight: 600,
-              boxShadow: "0 4px 12px rgba(0,0,0,0.25)",
-              border: "1px solid rgba(255,255,255,0.15)",
-              pointerEvents: "none",
-              zIndex: 99
-            },
-            children: [
-              "点击次数：",
-              e,
-              /* @__PURE__ */ f("div", { style: { fontSize: 12, fontWeight: 400, opacity: 0.85, marginTop: 4 }, children: "提示：点击任意卡片观察计数变化" })
-            ]
-          }
-        );
-      }
-    }
-  };
-}
-const g = "ClickAnalyticsPlugin", p = "统计每次项点击并累计总数，向 bus 发 `analytics:click`（带 index / item / total），`getStats()` 可随时取出按 index 的计数。默认只上报不显示角标，接入真实版式时不会被调试面板盖住内容。", m = "2.0.0", y = [
-  "interaction",
-  "埋点"
-], k = [
-  {
-    name: "log",
-    type: "boolean",
-    default: "false",
-    description: "是否在控制台打印每次点击"
-  },
-  {
-    name: "showOverlay",
-    type: "boolean",
-    default: "false",
-    description: "是否显示右上角计数角标"
-  }
-], b = `// 统计项点击次数，发 \`analytics:click\` 事件，可选角标与日志。
-const Waterfall = withPlugins(WaterfallCore, [
-  createClickAnalyticsPlugin({
-    log: false,
-    showOverlay: false,
-  }),
-]);
-
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, h = [
-  "点击总量 + 按 index 明细（getStats）",
-  "bus 事件可被外部订阅上报",
-  "角标默认关闭"
-], x = [
-  "内容流点击率统计",
-  "AB 实验埋点",
-  "调试点击行为"
-], C = [
-  "生产环境请把数据从 bus 事件或 getStats() 接到自己的埋点 SDK，不要让插件直接打日志。",
-  "计数只在内存里，刷新即清零 —— 想持久化要自己定时取 getStats() 上报。"
-], A = {
-  name: g,
-  description: p,
-  since: m,
-  tags: y,
-  config: k,
-  example: b,
-  features: h,
-  useCases: x,
-  notes: C
-};
-export {
-  v as c,
-  A as d
-};

package/dist/chunks/doc-j4W9SUrY.js

@@ -1,76 +0,0 @@
-function r(o) {
-  const e = typeof window < "u" ? window.innerWidth : 1024, n = o.responsive || {};
-  return e >= 1200 && n.xl ? n.xl : e >= 992 && n.lg ? n.lg : e >= 768 && n.md ? n.md : e < 768 && n.sm ? n.sm : {};
-}
-function w(o) {
-  return {
-    name: "GapPlugin",
-    priority: 50,
-    enabled: !0,
-    hooks: {
-      transformProps: (e) => {
-        const n = { columnGap: o.columnGap, rowGap: o.rowGap }, t = r(o), s = {
-          columnGap: t.columnGap ?? n.columnGap ?? e.columnGap,
-          rowGap: t.rowGap ?? n.rowGap ?? e.rowGap
-        };
-        return { ...e, ...s };
-      },
-      onResize: (e) => {
-        e.relayout?.();
-      }
-    }
-  };
-}
-const a = "GapPlugin", p = "把 rowGap / columnGap 收敛到一处配置，并支持按窗口宽度切换间距（窄屏 8px、宽屏 16px 这类）。", i = "2.0.0", c = [
-  "layout",
-  "间距"
-], l = [
-  {
-    name: "columnGap",
-    type: "number",
-    default: "props.columnGap",
-    description: "列间距 px"
-  },
-  {
-    name: "rowGap",
-    type: "number",
-    default: "props.rowGap",
-    description: "行间距 px"
-  },
-  {
-    name: "responsive",
-    type: "{ sm?, md?, lg?, xl? }",
-    default: "—",
-    description: "断点覆盖（按 window 宽度）"
-  }
-], u = `// 统一控制行/列间距，支持按断点给不同间距。
-const Waterfall = withPlugins(WaterfallCore, [
-  createGapPlugin(),
-]);
-
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, m = [
-  "行列间距一处配置",
-  "断点覆盖（sm/md/lg/xl）",
-  "不填则回退到 props"
-], d = [
-  "设计规范里间距随断点变化",
-  "同一组件在不同页面用不同密度"
-], G = [
-  "断点判断用的是 window.innerWidth（间距通常跟视口走，与列数按容器算不一样）。",
-  "断点是「命中即覆盖」：桌面窗口 ≥1200 又配了 responsive.lg，那就一直是 lg 的值，config.columnGap/rowGap 在这档不起作用；想让手写值生效就别给该档位配 responsive。",
-  "sm 只在小屏（<768）生效，不会被当成兜底档套到桌面端。"
-], f = {
-  name: a,
-  description: p,
-  since: i,
-  tags: c,
-  config: l,
-  example: u,
-  features: m,
-  useCases: d,
-  notes: G
-};
-export {
-  w as c,
-  f as d
-};

package/dist/chunks/doc-kTbJE7rY.js

@@ -1,92 +0,0 @@
-import { jsx as c } from "react/jsx-runtime";
-function R(n = {}) {
-  const i = n.containerRole ?? "list", s = n.itemRole ?? "listitem", o = n.enableTabIndex ?? !0, r = n.containerLabel ?? "Waterfall list", a = (e) => {
-    const t = e.containerRef.current;
-    t && (t.setAttribute("role", i), t.setAttribute("aria-label", r), t.setAttribute("aria-busy", e.isLayouting ? "true" : "false"));
-  };
-  return {
-    name: "A11yPlugin",
-    enabled: !0,
-    hooks: {
-      onMount: (e) => {
-        a(e);
-      },
-      onLayoutComplete: (e) => {
-        a(e);
-      },
-      renderItemWrapper: (e, t, l) => /* @__PURE__ */ c(
-        "div",
-        {
-          role: s,
-          "aria-posinset": l + 1,
-          "aria-setsize": e.itemCount,
-          tabIndex: o ? 0 : void 0,
-          style: { outline: "none" },
-          children: t
-        }
-      )
-    }
-  };
-}
-const u = "A11yPlugin", d = "把瀑布流补成读屏可理解的列表：容器 `role=list` + `aria-label`，每项 `role=listitem` + `aria-posinset` / `aria-setsize`，并可选加 `tabIndex` 让键盘能逐项聚焦。", b = "2.0.0", m = [
-  "ui",
-  "a11y"
-], p = [
-  {
-    name: "containerRole",
-    type: "string",
-    default: '"list"',
-    description: "容器 role"
-  },
-  {
-    name: "itemRole",
-    type: "string",
-    default: '"listitem"',
-    description: "项 role"
-  },
-  {
-    name: "enableTabIndex",
-    type: "boolean",
-    default: "true",
-    description: "项是否可 Tab 聚焦"
-  },
-  {
-    name: "containerLabel",
-    type: "string",
-    default: '"Waterfall list"',
-    description: "容器 aria-label"
-  }
-], f = `// 给容器与项补 ARIA role / label / posinset，支持键盘 Tab 遍历。
-const Waterfall = withPlugins(WaterfallCore, [
-  createA11yPlugin({
-    containerRole: "list",
-    itemRole: "listitem",
-    enableTabIndex: true,
-  }),
-]);
-
-<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;`, y = [
-  "容器 / 项 role 成对补齐",
-  "aria-posinset + aria-setsize 正确标注序号",
-  "键盘可逐项聚焦"
-], g = [
-  "政务 / 金融等合规站点",
-  "读屏用户可用的信息流",
-  "键盘操作优先的桌面端"
-], x = [
-  "项数很多时 `tabIndex=0` 会让 Tab 变长，建议配合「跳转主内容」链接使用。"
-], A = {
-  name: u,
-  description: d,
-  since: b,
-  tags: m,
-  config: p,
-  example: f,
-  features: y,
-  useCases: g,
-  notes: x
-};
-export {
-  R as c,
-  A as d
-};

package/dist/chunks/index-COaun3nf.js

@@ -1,15 +0,0 @@
-import { c as a, d as e } from "./doc-DElLNjIc.js";
-import { c as t, d as s } from "./doc-CcPFavOs.js";
-import { c, d as i } from "./doc-3Fpag2G8.js";
-import { c as n, d as o } from "./doc-BfWnfTst.js";
-import { c as r, d as g } from "./doc-B-7dugGv.js";
-import { c as l, d as m } from "./doc-f4Uijujv.js";
-const f = Object.assign(a, { meta: e }), j = Object.assign(t, { meta: s }), O = Object.assign(c, { meta: i }), C = Object.assign(n, { meta: o }), F = Object.assign(r, { meta: g }), x = Object.assign(l, { meta: m });
-export {
-  O as a,
-  j as b,
-  x as c,
-  F as d,
-  f as e,
-  C as f
-};

package/dist/chunks/index-DXAtA2f6.js

@@ -1,11 +0,0 @@
-import { c as a, d as e } from "./doc-CTUoMe7o.js";
-import { c as t, d as c } from "./doc-j4W9SUrY.js";
-import { c as o, d as n } from "./doc-DukOmDCo.js";
-import { c as s, d as i } from "./doc-78xF08vt.js";
-const d = Object.assign(a, { meta: e }), g = Object.assign(t, { meta: c }), P = Object.assign(o, { meta: n }), p = Object.assign(s, { meta: i });
-export {
-  g as a,
-  p as b,
-  d as c,
-  P as d
-};

package/dist/chunks/index-DsRLmBW-.js

@@ -1,13 +0,0 @@
-import { c as e, d as t } from "./doc-DzvTrZ13.js";
-import { c as a, d as c } from "./doc-BIzjYAZW.js";
-import { c as s, d as o } from "./doc-CraXjOaA.js";
-import { c as r, d as n } from "./doc-BP0DmB7-.js";
-import { c as i, d as m } from "./doc-NhL4Ux8q.js";
-const $ = Object.assign(e, { meta: t }), b = Object.assign(a, { meta: c }), p = Object.assign(s, { meta: o }), f = Object.assign(r, { meta: n }), j = Object.assign(i, { meta: m });
-export {
-  b as a,
-  p as b,
-  f as c,
-  j as d,
-  $ as e
-};

package/dist/chunks/index-gjoCq0yC.js

@@ -1,21 +0,0 @@
-import { c as a, d as e } from "./doc-gTAsLjVx.js";
-import { c, d as t } from "./doc-bTHwfIVb.js";
-import { c as s, d as r } from "./doc-CBHjiDG7.js";
-import { c as n, d as i } from "./doc-B6kLfMPv.js";
-import { c as o, d as g } from "./doc-BXElhF2h.js";
-import { c as m, d as l } from "./doc-BXSy2aPP.js";
-import { c as d, d as u } from "./doc-BCGQ8Cp5.js";
-import { c as P, d as $ } from "./doc-BtzhgTYj.js";
-import { c as p, d as b } from "./doc-DJjxOYzW.js";
-const k = Object.assign(a, { meta: e }), D = Object.assign(c, { meta: t }), G = Object.assign(s, { meta: r }), I = Object.assign(n, { meta: i }), L = Object.assign(o, { meta: g }), U = Object.assign(m, { meta: l }), x = Object.assign(d, { meta: u }), q = Object.assign(P, { meta: $ }), v = Object.assign(p, { meta: b });
-export {
-  L as a,
-  x as b,
-  k as c,
-  I as d,
-  D as e,
-  U as f,
-  G as g,
-  q as h,
-  v as i
-};