vane-waterfall 1.0.4 → 2.0.0

package/dist/chunks/doc-j4W9SUrY.js

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

@@ -0,0 +1,92 @@
+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-BAWlVYr3.js

@@ -0,0 +1,5 @@
+import { c as a, d as t } from "./doc-C5xrHNoC.js";
+const n = Object.assign(a, { meta: t });
+export {
+  n as c
+};

package/dist/chunks/index-COaun3nf.js

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

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

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

@@ -0,0 +1,21 @@
+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
+};

package/dist/chunks/index-wLI6UXkY.js

@@ -0,0 +1,5 @@
+import { c as a, d as c } from "./doc-kTbJE7rY.js";
+const t = Object.assign(a, { meta: c });
+export {
+  t as c
+};