vane-waterfall 2.0.1 → 2.0.3

package/dist/custom-plugins/TransitionPlugin/doc.json.d.ts

@@ -1,43 +1,57 @@
-declare const _default: {
-  "name": "TransitionPlugin",
-  "description": "给每个项挂上 transform + opacity 的 CSS 过渡，布局重排、分页切换、筛选后重新排列时位置变化是滑过去的，不是瞬移。",
-  "since": "2.0.0",
-  "tags": [
-    "perf",
-    "动效"
-  ],
-  "config": [
+declare const _default: {
+  "name": "TransitionPlugin",
+  "description": "给每个项挂上 transform + opacity 的 CSS 过渡，布局重排、分页切换、筛选后重新排列时位置变化是滑过去的，不是瞬移。",
+  "since": "2.0.0",
+  "tags": [
+    "perf",
+    "动效"
+  ],
+  "events": [
     {
-      "name": "duration",
-      "type": "number",
-      "default": "300",
-      "description": "过渡时长 ms"
+      "name": "onItemMount",
+      "when": "单个卡片挂载并拿到 DOM 元素时",
+      "description": "按卡片绑定监听、观察器、埋点"
     },
     {
-      "name": "easing",
-      "type": "string",
-      "default": "ease",
-      "description": "缓动函数"
+      "name": "onLayout",
+      "when": "布局计算完成、结果已确定",
+      "description": "读取每列高度、做二次修正或上报"
     }
   ],
-  "example": "// 布局变化时给项加 transform/opacity 过渡，插入新数据不「闪现」。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createTransitionPlugin({\n    duration: 300,\n    easing: \"ease\",\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
-  "conflicts": [
-    "ReducedMotionPlugin"
-  ],
-  "features": [
-    "项位置变化平滑过渡",
-    "挂载时即生效（onItemMount）",
-    "与 ReducedMotionPlugin 互斥"
-  ],
-  "useCases": [
-    "筛选 / 排序后重排",
-    "分页切换",
-    "动态插入卡片"
-  ],
-  "notes": [
-    "首屏大量项同时过渡会有一次「整体滑入」，想要更克制可以把 duration 降到 150ms。"
-  ]
-}
+  "methods": [],
+  "methodsNote": "只读取 context 字段（props / state / data），不调用上下文方法",
+  "config": [
+    {
+      "name": "duration",
+      "type": "number",
+      "default": "300",
+      "description": "过渡时长 ms"
+    },
+    {
+      "name": "easing",
+      "type": "string",
+      "default": "ease",
+      "description": "缓动函数"
+    }
+  ],
+  "example": "// 布局变化时给项加 transform/opacity 过渡，插入新数据不「闪现」。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createTransitionPlugin({\n    duration: 300,\n    easing: \"ease\",\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "conflicts": [
+    "ReducedMotionPlugin"
+  ],
+  "features": [
+    "项位置变化平滑过渡",
+    "挂载时即生效（onItemMount）",
+    "与 ReducedMotionPlugin 互斥"
+  ],
+  "useCases": [
+    "筛选 / 排序后重排",
+    "分页切换",
+    "动态插入卡片"
+  ],
+  "notes": [
+    "首屏大量项同时过渡会有一次「整体滑入」，想要更克制可以把 duration 降到 150ms。"
+  ]
+}
 ;
 
 export default _default;

package/dist/custom-plugins/TransitionPlugin/index.js

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

package/dist/custom-plugins/URLSyncPlugin/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/URLSyncPlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,aAAa,GAAG;IAC1B,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,GAAE,aAAkB,GAAG,eAAe,CAAC,CAAC,CAAC,CAiF3F"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/URLSyncPlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,aAAa,GAAG;IAC1B,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,GAAE,aAAkB,GAAG,eAAe,CAAC,CAAC,CAAC,CA8G3F"}

package/dist/custom-plugins/URLSyncPlugin/doc.json.d.ts

@@ -1,41 +1,65 @@
-declare const _default: {
-  "name": "URLSyncPlugin",
-  "description": "props 变化时把指定键写进 URL（hash 或 search），挂载时读出来广播 `urlsync:init`。刷新与分享都能还原筛选状态。",
-  "since": "2.0.0",
-  "tags": [
-    "ui",
-    "URL",
-    "可分享"
-  ],
-  "config": [
+declare const _default: {
+  "name": "URLSyncPlugin",
+  "description": "props 变化时把指定键写进 URL（hash 或 search），挂载时读出来广播 `urlsync:init`。刷新与分享都能还原筛选状态。",
+  "since": "2.0.0",
+  "tags": [
+    "ui",
+    "URL",
+    "可分享"
+  ],
+  "events": [
+    {
+      "name": "onMount",
+      "when": "瀑布流挂载完成",
+      "description": "初始化观察器与滚动监听，返回清理函数"
+    },
     {
-      "name": "mode",
-      "type": "\"hash\" | \"search\"",
-      "default": "\"hash\"",
-      "description": "写 hash 还是 search"
+      "name": "onPropsChange",
+      "when": "props 变化后",
+      "description": "数据或配置变化时请求重排"
     },
     {
-      "name": "keys",
-      "type": "string[]",
-      "default": "[\"pageIndex\",\"pageSize\",\"searchQuery\"]",
-      "description": "要同步的 props 键"
+      "name": "transformProps",
+      "when": "渲染前链式改写瀑布流 props",
+      "description": "补 gap / columns 默认值、按断点覆盖配置"
+    },
+    {
+      "name": "urlsync:init",
+      "when": "从 URL 参数初始化完成后",
+      "description": "广播初始参数快照"
     }
   ],
-  "example": "// 把分页/搜索/排序同步进 URL（hash 或 search），链接可分享。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createURLSyncPlugin({\n    mode: \"hash\",\n    keys: [\"pageIndex\",\"pageSize\",\"searchQuery\"],\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
-  "features": [
-    "hash 模式会保留已有路由路径",
-    "用 replaceState，不污染后退栈",
-    "SSR 安全：无 window 时直接跳过"
-  ],
-  "useCases": [
-    "搜索结果可分享",
-    "后台筛选状态可刷新",
-    "带参数的深链"
-  ],
-  "notes": [
-    "只做单向同步（props → URL）与初始读取；URL 前进后退的监听请页面自己做。"
-  ]
-}
+  "methods": [],
+  "methodsNote": "只读取 context 字段（props / state / data），不调用上下文方法",
+  "config": [
+    {
+      "name": "mode",
+      "type": "\"hash\" | \"search\"",
+      "default": "\"hash\"",
+      "description": "写 hash 还是 search"
+    },
+    {
+      "name": "keys",
+      "type": "string[]",
+      "default": "[\"pageIndex\",\"pageSize\",\"searchQuery\"]",
+      "description": "要同步的 props 键"
+    }
+  ],
+  "example": "// 把分页/搜索/排序同步进 URL（hash 或 search），链接可分享。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createURLSyncPlugin({\n    mode: \"hash\",\n    keys: [\"pageIndex\",\"pageSize\",\"searchQuery\"],\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "hash 模式会保留已有路由路径",
+    "用 replaceState，不污染后退栈",
+    "SSR 安全：无 window 时直接跳过"
+  ],
+  "useCases": [
+    "搜索结果可分享",
+    "后台筛选状态可刷新",
+    "带参数的深链"
+  ],
+  "notes": [
+    "只做单向同步（props → URL）与初始读取；URL 前进后退的监听请页面自己做。"
+  ]
+}
 ;
 
 export default _default;

package/dist/custom-plugins/URLSyncPlugin/index.js

@@ -1,4 +1,4 @@
-import { c, d as e } from "../../chunks/doc-DJjxOYzW.js";
+import { c, d as e } from "../../chunks/doc-BAhVW3g8.js";
 const a = Object.assign(c, { meta: e });
 export {
   a as createURLSyncPlugin

package/dist/custom-plugins/index.js

@@ -1,9 +1,9 @@
-import { c as r, a as t, b as c, d as i, e as n, f as l, g as s, h as u, i as g } from "../chunks/index-gjoCq0yC.js";
-import { c as P, a as m, b as p, d } from "../chunks/index-DXAtA2f6.js";
-import { c as x, a as y, b as S, d as A, e as b, f as h } from "../chunks/index-COaun3nf.js";
-import { c as k, a as C, b as H, d as D, e as F } from "../chunks/index-DsRLmBW-.js";
-import { c as I } from "../chunks/index-BAWlVYr3.js";
-import { c as T } from "../chunks/index-wLI6UXkY.js";
+import { c as r, a as t, b as c, d as i, e as n, f as l, g as s, h as u, i as g } from "../chunks/index-B96I5CKE.js";
+import { c as P, a as m, b as p, d } from "../chunks/index-Bjmhy8jW.js";
+import { c as x, a as y, b as S, d as A, e as b, f as h } from "../chunks/index-8gEIzUxi.js";
+import { c as k, a as C, b as H, d as D, e as F } from "../chunks/index-Cuq0ofv-.js";
+import { c as I } from "../chunks/index-Cz4YEqRF.js";
+import { c as T } from "../chunks/index-FBJVUYmH.js";
 export {
   T as createA11yPlugin,
   r as createAlignmentPlugin,

package/dist/entries/core.js

@@ -1,4 +1,4 @@
-import { W as e, c as t, a as r, b as c } from "../chunks/WaterfallCore-BSXw7bl_.js";
+import { W as e, c as t, a as r, b as c } from "../chunks/WaterfallCore-EdAZuWAY.js";
 export {
   e as WaterfallCore,
   t as computeLayout,

package/dist/entries/plugins.js

@@ -1,10 +1,10 @@
-import { w as r } from "../chunks/withPlugins-DLoKg4AP.js";
-import { c as i } from "../chunks/index-wLI6UXkY.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-gjoCq0yC.js";
-import { c as d, a as x, b as y, d as S } from "../chunks/index-DXAtA2f6.js";
-import { c as A, a as b, b as R, d as k, e as C } from "../chunks/index-DsRLmBW-.js";
-import { c as w, a as D, b as F, d as G, e as I, f as L } from "../chunks/index-COaun3nf.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-BSXw7bl_.js";
-import { w as i } from "./chunks/withPlugins-DLoKg4AP.js";
+import { W as o, c as t, b as r } from "./chunks/WaterfallCore-EdAZuWAY.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-DsRLmBW-.js";
-import { c as u } from "../../chunks/index-wLI6UXkY.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-wLI6UXkY.js";
-import { c as i, a as l, d as u, b as c } from "../../chunks/index-DXAtA2f6.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-COaun3nf.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.1",
+  "version": "2.0.3",
   "description": "React 瀑布流布局组件：插件化、可变高、虚拟化，27 个领域插件",
   "type": "module",
   "main": "./dist/index.js",
@@ -187,15 +187,23 @@
     "vite": "^5.4.1",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^2.1.9",
-    "vane-plugin-core": "0.1.0",
-    "@vane/tsconfig": "0.1.0",
     "@vane/build-config": "0.1.0",
+    "@vane/tsconfig": "0.1.0",
     "@vane/eslint-config": "0.1.0",
-    "@vane/vitest-config": "0.1.0"
+    "@vane/vitest-config": "0.1.0",
+    "vane-plugin-core": "0.1.2"
   },
   "vane": {
-    "sizeBudgetKb": 14,
-    "coreSizeBudgetKb": 12
+    "demo": {
+      "brand": "V",
+      "subtitle": "排版台 / plugin index",
+      "title": "瀑布流排版台",
+      "accent": "#ccf24b",
+      "bg": "#080a09"
+    },
+    "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"
@@ -205,10 +213,10 @@
   },
   "scripts": {
     "dev": "vite --config demo/vite.config.ts",
-    "build": "vite build",
+    "build": "vite build --mode lib",
     "build:demo": "vite build --config demo/vite.config.ts",
     "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "vitest run --pool=threads",
+    "test": "vitest run",
     "lint": "eslint .",
     "sync:exports": "node ../../scripts/sync-exports.mjs",
     "docs:plugins": "node ../../scripts/generate-plugin-docs.mjs",