vane-waterfall 2.0.2 → 2.0.3

package/dist/entries/plugins.js

@@ -1,10 +1,10 @@
-import { w as r } from "../chunks/withPlugins-DG3YpSgL.js";
-import { c as i } from "../chunks/index-CF0tYRop.js";
-import { c, a as l, b as s, d as u, e as g, f as o, g as P, h as m, i as p } from "../chunks/index-CJR0Buju.js";
-import { c as d, a as x, b as y, d as S } from "../chunks/index-BFyYpEY_.js";
-import { c as A, a as b, b as R, d as k, e as C } from "../chunks/index-DHTB3QEP.js";
-import { c as w, a as D, b as F, d as G, e as I, f as L } from "../chunks/index-B8o6R4RZ.js";
-import { c as v } from "../chunks/index-BAWlVYr3.js";
+import { w as r } from "../chunks/withPlugins-BOeDFhof.js";
+import { c as i } from "../chunks/index-FBJVUYmH.js";
+import { c, a as l, b as s, d as u, e as g, f as o, g as P, h as m, i as p } from "../chunks/index-B96I5CKE.js";
+import { c as d, a as x, b as y, d as S } from "../chunks/index-Bjmhy8jW.js";
+import { c as A, a as b, b as R, d as k, e as C } from "../chunks/index-Cuq0ofv-.js";
+import { c as w, a as D, b as F, d as G, e as I, f as L } from "../chunks/index-8gEIzUxi.js";
+import { c as v } from "../chunks/index-Cz4YEqRF.js";
 export {
   i as createA11yPlugin,
   c as createAlignmentPlugin,

package/dist/index.js

@@ -1,5 +1,5 @@
 import { W as o, c as t, b as r } from "./chunks/WaterfallCore-EdAZuWAY.js";
-import { w as i } from "./chunks/withPlugins-DG3YpSgL.js";
+import { w as i } from "./chunks/withPlugins-BOeDFhof.js";
 export {
   o as WaterfallCore,
   t as computeLayout,

package/dist/presets/dashboard/index.js

@@ -1,5 +1,5 @@
-import { e as s, a as c, b as l, d as n, c as i } from "../../chunks/index-DHTB3QEP.js";
-import { c as u } from "../../chunks/index-CF0tYRop.js";
+import { e as s, a as c, b as l, d as n, c as i } from "../../chunks/index-Cuq0ofv-.js";
+import { c as u } from "../../chunks/index-FBJVUYmH.js";
 function P(r = {}) {
   const {
     scrollThrottle: t = 24,

package/dist/presets/photo-feed/index.js

@@ -1,6 +1,6 @@
-import { c as r } from "../../chunks/index-CF0tYRop.js";
-import { c as i, a as l, d as u, b as c } from "../../chunks/index-BFyYpEY_.js";
-import { c as m } from "../../chunks/index-BAWlVYr3.js";
+import { c as r } from "../../chunks/index-FBJVUYmH.js";
+import { c as i, a as l, d as u, b as c } from "../../chunks/index-Bjmhy8jW.js";
+import { c as m } from "../../chunks/index-Cz4YEqRF.js";
 function g(a = {}) {
   const { minColumnWidth: n = 240, maxColumns: o = 4, gap: e = 16, threshold: t = 400 } = a;
   return [

package/dist/presets/product-feed/index.js

@@ -1,5 +1,5 @@
-import { e as o, b as r, a, f as n, d as l, c as s } from "../../chunks/index-B8o6R4RZ.js";
-import { c } from "../../chunks/index-BAWlVYr3.js";
+import { e as o, b as r, a, f as n, d as l, c as s } from "../../chunks/index-8gEIzUxi.js";
+import { c } from "../../chunks/index-Cz4YEqRF.js";
 function p(e = {}) {
   const { itemHeight: t = 300, pageSize: i = 24 } = e;
   return [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vane-waterfall",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "description": "React 瀑布流布局组件：插件化、可变高、虚拟化，27 个领域插件",
   "type": "module",
   "main": "./dist/index.js",
@@ -168,22 +168,6 @@
     "url": "https://github.com/frankvane/vane-components/issues"
   },
   "homepage": "https://github.com/frankvane/vane-components/tree/main/packages/vane-waterfall#readme",
-  "scripts": {
-    "dev": "vite --config demo/vite.config.ts",
-    "build": "vite build --mode lib",
-    "build:demo": "vite build --config demo/vite.config.ts",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "vitest run",
-    "lint": "eslint .",
-    "sync:exports": "node ../../scripts/sync-exports.mjs",
-    "docs:plugins": "node ../../scripts/generate-plugin-docs.mjs",
-    "verify:scenarios": "node scripts/verify-scenarios.mjs",
-    "audit:demos": "node scripts/audit-demos.mjs",
-    "serve:demo": "node scripts/serve-demo.cjs",
-    "demo": "pnpm build:demo && node scripts/serve-demo.cjs",
-    "prepublishOnly": "npm run build",
-    "audit:controls": "node scripts/audit-controls.mjs"
-  },
   "peerDependencies": {
     "react": ">=16.8.0",
     "react-dom": ">=16.8.0"
@@ -193,11 +177,6 @@
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
     "@types/react-syntax-highlighter": "^15.5.13",
-    "@vane/build-config": "*",
-    "@vane/eslint-config": "*",
-    "vane-plugin-core": "*",
-    "@vane/tsconfig": "*",
-    "@vane/vitest-config": "*",
     "@vitejs/plugin-react": "^4.3.1",
     "happy-dom": "^15.11.7",
     "react": "^18.3.1",
@@ -207,7 +186,12 @@
     "typescript": "^5.5.3",
     "vite": "^5.4.1",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^2.1.9"
+    "vitest": "^2.1.9",
+    "@vane/build-config": "0.1.0",
+    "@vane/tsconfig": "0.1.0",
+    "@vane/eslint-config": "0.1.0",
+    "@vane/vitest-config": "0.1.0",
+    "vane-plugin-core": "0.1.2"
   },
   "vane": {
     "demo": {
@@ -217,13 +201,29 @@
       "accent": "#ccf24b",
       "bg": "#080a09"
     },
-    "sizeBudgetKb": 14,
-    "coreSizeBudgetKb": 12
+    "sizeBudgetKb": 14.9,
+    "coreSizeBudgetKb": 12,
+    "sizeBudgetNote": "【2026-11-04 内核修复批次：14→14.9KB】入口实测 14.46KB＝内核 withPlugins 共享块 8.24KB（devDep 内联）+ 瀑布流核心/领域槽；内核自 0.1.1 累计 gzip +1.33KB（本轮 +117B）。是否可裁：否——67 个 js 全部可达、0 重复内容。按实测 +3.0% 余量（上限），后续新增功能需先压回或走预算评审。"
   },
   "engines": {
     "node": ">=18"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "dev": "vite --config demo/vite.config.ts",
+    "build": "vite build --mode lib",
+    "build:demo": "vite build --config demo/vite.config.ts",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "lint": "eslint .",
+    "sync:exports": "node ../../scripts/sync-exports.mjs",
+    "docs:plugins": "node ../../scripts/generate-plugin-docs.mjs",
+    "verify:scenarios": "node scripts/verify-scenarios.mjs",
+    "audit:demos": "node scripts/audit-demos.mjs",
+    "serve:demo": "node scripts/serve-demo.cjs",
+    "demo": "pnpm build:demo && node scripts/serve-demo.cjs",
+    "audit:controls": "node scripts/audit-controls.mjs"
   }
-}
+}

package/dist/chunks/doc-BQQoKNto.js

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

package/dist/chunks/doc-BindRMfO.js

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

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