vane-waterfall 2.0.0 → 2.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/README.md +6 -6
  2. package/dist/chunks/WaterfallCore-EdAZuWAY.js +695 -0
  3. package/dist/chunks/{doc-kTbJE7rY.js → doc-BCmEnh39.js} +31 -29
  4. package/dist/chunks/doc-BQQoKNto.js +126 -0
  5. package/dist/chunks/{doc-j4W9SUrY.js → doc-BSnWbrkH.js} +39 -27
  6. package/dist/chunks/{doc-BCGQ8Cp5.js → doc-BXaJl1By.js} +54 -41
  7. package/dist/chunks/{doc-CraXjOaA.js → doc-BindRMfO.js} +30 -26
  8. package/dist/chunks/{doc-78xF08vt.js → doc-BmoijI6q.js} +35 -35
  9. package/dist/chunks/{doc-BtzhgTYj.js → doc-CN4edvn_.js} +27 -27
  10. package/dist/chunks/{doc-NhL4Ux8q.js → doc-CkU5GtLw.js} +65 -54
  11. package/dist/chunks/doc-DAieSXLy.js +86 -0
  12. package/dist/chunks/{doc-BP0DmB7-.js → doc-D_ozEn0Q.js} +27 -27
  13. package/dist/chunks/{doc-f4Uijujv.js → doc-KN6Bvmty.js} +54 -32
  14. package/dist/chunks/{doc-B6kLfMPv.js → doc-a0MK2S3n.js} +61 -40
  15. package/dist/chunks/{index-COaun3nf.js → index-B8o6R4RZ.js} +2 -2
  16. package/dist/chunks/{index-DXAtA2f6.js → index-BFyYpEY_.js} +2 -2
  17. package/dist/chunks/{index-wLI6UXkY.js → index-CF0tYRop.js} +1 -1
  18. package/dist/chunks/{index-gjoCq0yC.js → index-CJR0Buju.js} +4 -4
  19. package/dist/chunks/{index-DsRLmBW-.js → index-DHTB3QEP.js} +3 -3
  20. package/dist/chunks/withPlugins-DG3YpSgL.js +655 -0
  21. package/dist/components/WaterfallPlugin/WaterfallCore.d.ts +19 -0
  22. package/dist/components/WaterfallPlugin/WaterfallCore.d.ts.map +1 -1
  23. package/dist/components/WaterfallPlugin/layout.d.ts +7 -0
  24. package/dist/components/WaterfallPlugin/layout.d.ts.map +1 -1
  25. package/dist/components/WaterfallPlugin/plugins/types.d.ts +4 -1
  26. package/dist/components/WaterfallPlugin/plugins/types.d.ts.map +1 -1
  27. package/dist/components/WaterfallPlugin/withPlugins.d.ts.map +1 -1
  28. package/dist/custom-plugins/A11yPlugin/create.d.ts.map +1 -1
  29. package/dist/custom-plugins/A11yPlugin/index.d.ts +1 -1
  30. package/dist/custom-plugins/A11yPlugin/index.d.ts.map +1 -1
  31. package/dist/custom-plugins/A11yPlugin/index.js +1 -1
  32. package/dist/custom-plugins/AlignmentPlugin/index.d.ts +1 -1
  33. package/dist/custom-plugins/AlignmentPlugin/index.d.ts.map +1 -1
  34. package/dist/custom-plugins/AutoColumnPlugin/index.d.ts +1 -1
  35. package/dist/custom-plugins/AutoColumnPlugin/index.d.ts.map +1 -1
  36. package/dist/custom-plugins/BookmarkPlugin/create.d.ts.map +1 -1
  37. package/dist/custom-plugins/BookmarkPlugin/index.d.ts +1 -1
  38. package/dist/custom-plugins/BookmarkPlugin/index.d.ts.map +1 -1
  39. package/dist/custom-plugins/BookmarkPlugin/index.js +1 -1
  40. package/dist/custom-plugins/ClickAnalyticsPlugin/create.d.ts +2 -0
  41. package/dist/custom-plugins/ClickAnalyticsPlugin/create.d.ts.map +1 -1
  42. package/dist/custom-plugins/ClickAnalyticsPlugin/index.d.ts +1 -1
  43. package/dist/custom-plugins/ClickAnalyticsPlugin/index.d.ts.map +1 -1
  44. package/dist/custom-plugins/ClickAnalyticsPlugin/index.js +1 -1
  45. package/dist/custom-plugins/DebounceLayoutPlugin/index.d.ts +1 -1
  46. package/dist/custom-plugins/DebounceLayoutPlugin/index.d.ts.map +1 -1
  47. package/dist/custom-plugins/DragReorderPlugin/index.d.ts +1 -1
  48. package/dist/custom-plugins/DragReorderPlugin/index.d.ts.map +1 -1
  49. package/dist/custom-plugins/FilterPlugin/index.d.ts +1 -1
  50. package/dist/custom-plugins/FilterPlugin/index.d.ts.map +1 -1
  51. package/dist/custom-plugins/FixedHeightPlugin/index.d.ts +1 -1
  52. package/dist/custom-plugins/FixedHeightPlugin/index.d.ts.map +1 -1
  53. package/dist/custom-plugins/GapPlugin/create.d.ts.map +1 -1
  54. package/dist/custom-plugins/GapPlugin/index.d.ts +1 -1
  55. package/dist/custom-plugins/GapPlugin/index.d.ts.map +1 -1
  56. package/dist/custom-plugins/GapPlugin/index.js +1 -1
  57. package/dist/custom-plugins/GroupingPlugin/create.d.ts.map +1 -1
  58. package/dist/custom-plugins/GroupingPlugin/index.d.ts +1 -1
  59. package/dist/custom-plugins/GroupingPlugin/index.d.ts.map +1 -1
  60. package/dist/custom-plugins/GroupingPlugin/index.js +1 -1
  61. package/dist/custom-plugins/HeatmapAnalyticsPlugin/create.d.ts +2 -0
  62. package/dist/custom-plugins/HeatmapAnalyticsPlugin/create.d.ts.map +1 -1
  63. package/dist/custom-plugins/HeatmapAnalyticsPlugin/index.d.ts +1 -1
  64. package/dist/custom-plugins/HeatmapAnalyticsPlugin/index.d.ts.map +1 -1
  65. package/dist/custom-plugins/HeatmapAnalyticsPlugin/index.js +1 -1
  66. package/dist/custom-plugins/InfiniteScrollPlugin/create.d.ts.map +1 -1
  67. package/dist/custom-plugins/InfiniteScrollPlugin/index.d.ts +1 -1
  68. package/dist/custom-plugins/InfiniteScrollPlugin/index.d.ts.map +1 -1
  69. package/dist/custom-plugins/InfiniteScrollPlugin/index.js +1 -1
  70. package/dist/custom-plugins/PaginationPlugin/create.d.ts.map +1 -1
  71. package/dist/custom-plugins/PaginationPlugin/index.d.ts +1 -1
  72. package/dist/custom-plugins/PaginationPlugin/index.d.ts.map +1 -1
  73. package/dist/custom-plugins/PaginationPlugin/index.js +1 -1
  74. package/dist/custom-plugins/PinItemPlugin/index.d.ts +1 -1
  75. package/dist/custom-plugins/PinItemPlugin/index.d.ts.map +1 -1
  76. package/dist/custom-plugins/RecyclePlugin/create.d.ts.map +1 -1
  77. package/dist/custom-plugins/RecyclePlugin/index.d.ts +1 -1
  78. package/dist/custom-plugins/RecyclePlugin/index.d.ts.map +1 -1
  79. package/dist/custom-plugins/RecyclePlugin/index.js +1 -1
  80. package/dist/custom-plugins/ReducedMotionPlugin/index.d.ts +1 -1
  81. package/dist/custom-plugins/ReducedMotionPlugin/index.d.ts.map +1 -1
  82. package/dist/custom-plugins/ResponsiveColumnsPlugin/index.d.ts +1 -1
  83. package/dist/custom-plugins/ResponsiveColumnsPlugin/index.d.ts.map +1 -1
  84. package/dist/custom-plugins/ScrollAnchorPlugin/index.d.ts +1 -1
  85. package/dist/custom-plugins/ScrollAnchorPlugin/index.d.ts.map +1 -1
  86. package/dist/custom-plugins/SearchPlugin/index.d.ts +1 -1
  87. package/dist/custom-plugins/SearchPlugin/index.d.ts.map +1 -1
  88. package/dist/custom-plugins/SortPlugin/index.d.ts +1 -1
  89. package/dist/custom-plugins/SortPlugin/index.d.ts.map +1 -1
  90. package/dist/custom-plugins/StatePersistencePlugin/create.d.ts.map +1 -1
  91. package/dist/custom-plugins/StatePersistencePlugin/index.d.ts +1 -1
  92. package/dist/custom-plugins/StatePersistencePlugin/index.d.ts.map +1 -1
  93. package/dist/custom-plugins/StatePersistencePlugin/index.js +1 -1
  94. package/dist/custom-plugins/StickyHeaderPlugin/create.d.ts.map +1 -1
  95. package/dist/custom-plugins/StickyHeaderPlugin/index.d.ts +1 -1
  96. package/dist/custom-plugins/StickyHeaderPlugin/index.d.ts.map +1 -1
  97. package/dist/custom-plugins/StickyHeaderPlugin/index.js +1 -1
  98. package/dist/custom-plugins/ThrottlePlugin/index.d.ts +1 -1
  99. package/dist/custom-plugins/ThrottlePlugin/index.d.ts.map +1 -1
  100. package/dist/custom-plugins/TransitionPlugin/index.d.ts +1 -1
  101. package/dist/custom-plugins/TransitionPlugin/index.d.ts.map +1 -1
  102. package/dist/custom-plugins/URLSyncPlugin/create.d.ts.map +1 -1
  103. package/dist/custom-plugins/URLSyncPlugin/index.d.ts +1 -1
  104. package/dist/custom-plugins/URLSyncPlugin/index.d.ts.map +1 -1
  105. package/dist/custom-plugins/URLSyncPlugin/index.js +1 -1
  106. package/dist/custom-plugins/index.js +5 -5
  107. package/dist/entries/core.js +1 -1
  108. package/dist/entries/plugins.d.ts +1 -1
  109. package/dist/entries/plugins.d.ts.map +1 -1
  110. package/dist/entries/plugins.js +6 -6
  111. package/dist/index.d.ts +1 -1
  112. package/dist/index.d.ts.map +1 -1
  113. package/dist/index.js +2 -2
  114. package/dist/presets/dashboard/index.js +2 -2
  115. package/dist/presets/photo-feed/index.js +2 -2
  116. package/dist/presets/product-feed/index.js +1 -1
  117. package/package.json +32 -25
  118. package/dist/chunks/WaterfallCore-BSXw7bl_.js +0 -581
  119. package/dist/chunks/doc-B-7dugGv.js +0 -79
  120. package/dist/chunks/doc-DJjxOYzW.js +0 -111
  121. package/dist/chunks/withPlugins-DLoKg4AP.js +0 -559
package/README.md CHANGED
@@ -17,7 +17,7 @@
17
17
  - **量到就重排**:项挂载量到真高与位置不一致时,下一帧立刻修正,不等布局防抖 —— 这是「快速滚动时卡片重叠」的真正解法(抬高估值只是把误差换成滚动条虚长)
18
18
  - **钩子有生命周期**:`onMount` 返回的函数会在卸载时执行,监听不会泄漏
19
19
  - **priority 越大越先执行**:与旧版语义同向,不做 `1000 - x` 反转
20
- - **零运行时依赖**(`@vane/plugin-core` / react / react-dom 均为 peer),不引 CSS 文件
20
+ - **零运行时依赖**(`vane-plugin-core` / react / react-dom 均为 peer),不引 CSS 文件
21
21
 
22
22
  ## 安装
23
23
 
@@ -65,7 +65,7 @@ export function Feed({ items }: { items: Item[] }) {
65
65
 
66
66
  单文件实测:`WaterfallCore` 4.68 KB gzip、`withPlugins` 5.62 KB gzip。
67
67
 
68
- > 根入口**不桶导出插件**——插件请走子路径,未引入的不进产物。插件目录见 [插件](plugins.md),现成组合见 [组合配方](recipes.md)。
68
+ > 根入口**不桶导出插件**——插件请走子路径,未引入的不进产物。插件目录见 [插件](../../docs/components/vane-waterfall/plugins.md),现成组合见 [组合配方](../../docs/components/vane-waterfall/recipes.md)。
69
69
 
70
70
  ## 包内有什么
71
71
 
@@ -89,7 +89,7 @@ demo/ 演示站:34 页逐项示例 + 工坊 + 13 场景(不随
89
89
  | 交互与埋点 | ClickAnalytics / HeatmapAnalytics / DragReorder / ScrollAnchor / Recycle | 点击与曝光统计、拖拽、锚点、离屏回收 |
90
90
  | 语义与状态 | A11y / Grouping / StickyHeader / Bookmark / StatePersistence / URLSync | 可访问性、分组、吸顶、位置书签、状态与 URL 同步 |
91
91
 
92
- 完整配置项见 [插件](plugins.md)。
92
+ 完整配置项见 [插件](../../docs/components/vane-waterfall/plugins.md)。
93
93
 
94
94
  ## 虚拟化的估值策略
95
95
 
@@ -121,12 +121,12 @@ virtualize={{ estimateQuantile: 0.95 }}
121
121
 
122
122
  ## 从 1.x 迁移
123
123
 
124
- 2.0.0 是破坏性大版本,插件系统内核已换成 `@vane/plugin-core`(与 `vane-lazy-image` 同一套):
124
+ 2.0.0 是破坏性大版本,插件系统内核已换成 `vane-plugin-core`(与 `vane-lazy-image` 同一套):
125
125
 
126
126
  | 变化 | 影响 | 怎么改 |
127
127
  | --- | --- | --- |
128
128
  | 插件系统换成内核 | 自建 `PluginBus` / `PluginManager` 删除 | 不要再 import 它们;`withPlugins` / `Plugin` 从包里取 |
129
- | 钩子面 48 → 20 | 31 个从未被执行过的钩子删除 | 按 [API](api.md) 的钩子表逐个核对,被删的钩子本来也没生效 |
129
+ | 钩子面 48 → 20 | 31 个从未被执行过的钩子删除 | 按 [API](../../docs/components/vane-waterfall/api.md) 的钩子表逐个核对,被删的钩子本来也没生效 |
130
130
  | 插件状态与清理 | `onMount` 返回值统一当清理函数 | 把 `unsubscribe` 逻辑放进返回的函数 |
131
131
  | 虚拟化下沉 Core | `VirtualWaterfallPlugin` 删除 | 去掉插件,改传 `virtualize` |
132
132
  | 多入口 | 插件不再桶导出进根入口 | `import { createXxxPlugin } from "vane-waterfall/custom-plugins/XxxPlugin"` |
@@ -144,7 +144,7 @@ virtualize={{ estimateQuantile: 0.95 }}
144
144
  | **插件工坊** | 26 插件 | 组合实验台:勾选任意组合,现场看冲突提示并生成装配代码 |
145
145
  | **场景库** | 13 版式 | 组合视角:真实版式(图文 / 电商 / 视频 / 看板 / 长文…),每卡两份源码 |
146
146
 
147
- 逐项示例分三组,与 [API](api.md) 的钩子表一一对得上:
147
+ 逐项示例分三组,与 [API](../../docs/components/vane-waterfall/api.md) 的钩子表一一对得上:
148
148
 
149
149
  - **基础功能**(3):基础示例、自定义列数、自定义间距 —— 只用 Core props
150
150
  - **高级功能**(3):Ref 方法调用(13 个方法逐个点)、生命周期和事件(13 个回调接满)、高级配置(padding / useTransform / alignmentMode / 节流防抖)