vane-waterfall 1.0.4 → 2.0.0

package/dist/custom-plugins/DragReorderPlugin/create.d.ts

@@ -0,0 +1,33 @@
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type DragReorderConfig<T = any> = {
+    /** 是否启用（默认 true） */
+    enabled?: boolean;
+    /**
+     * 松手时的重排回调。插件只负责"拖"与"从哪到哪"，
+     * 数组怎么改由调用方决定（就地 splice / 走接口 / 写回 store）。
+     */
+    onReorder?: (from: number, to: number, item: T | undefined) => void;
+    /** 是否显示虚线边框提示可拖（默认 false，接入真实版式时基本都要关） */
+    showHandle?: boolean;
+    /**
+     * 触屏长按多久进入拖拽（ms，默认 180）。
+     *
+     * 触摸设备上 `draggable` 不生效，必须走 pointer 事件；但 pointer 一动就是滚动，
+     * 所以用「长按」区分「想滚」和「想拖」。设 0 则不需要长按。
+     */
+    touchHoldMs?: number;
+};
+/**
+ * DragReorderPlugin - 拖拽重排。
+ *
+ * 两条输入路径，各管一半设备：
+ *  - **鼠标**：原生 HTML5 `dragstart/dragover/drop`。别改它，改成 pointer 反而会
+ *    和 Core 的滚动、文本选择打架；
+ *  - **触屏 / 触控笔**：`pointerdown` + 长按（默认 180ms）进入拖拽，移动时用
+ *    `elementFromPoint` 找落点。触摸设备上 `draggable` 根本不触发，旧版因此在手机上完全失效。
+ *
+ * 旧版还有个大坑：只把 from/to 写进 sharedData 就结束了，`onReorder` 不存在，
+ * 页面拿不到任何回调（注释里写着"占位：仅记录"）。这里补上真回调。
+ */
+export declare function createDragReorderPlugin<T = any>(config?: DragReorderConfig<T>): WaterfallPlugin<T>;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/DragReorderPlugin/create.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,gDAAgD,CAAC;AAExD,MAAM,MAAM,iBAAiB,CAAC,CAAC,GAAG,GAAG,IAAI;IACvC,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;IACpE,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAeF;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,GAAG,GAAG,EAC7C,MAAM,GAAE,iBAAiB,CAAC,CAAC,CAAM,GAChC,eAAe,CAAC,CAAC,CAAC,CA0HpB"}

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

@@ -0,0 +1,53 @@
+declare const _default: {
+  "name": "DragReorderPlugin",
+  "description": "给每个项加拖拽能力，松手时回调 `onReorder(from, to)`，同时向 bus 发 `drag:reorder`。鼠标走原生 HTML5 拖拽，触屏走「长按 + pointer」——触摸设备上 `draggable` 根本不触发，旧版因此在手机上完全失效。",
+  "since": "2.0.0",
+  "tags": [
+    "interaction",
+    "拖拽"
+  ],
+  "config": [
+    {
+      "name": "enabled",
+      "type": "boolean",
+      "default": "true",
+      "description": "是否启用拖拽"
+    },
+    {
+      "name": "onReorder",
+      "type": "(from, to, item) => void",
+      "default": "—",
+      "description": "重排回调"
+    },
+    {
+      "name": "showHandle",
+      "type": "boolean",
+      "default": "false",
+      "description": "是否显示虚线边框提示可拖"
+    },
+    {
+      "name": "touchHoldMs",
+      "type": "number",
+      "default": "180",
+      "description": "触屏长按多久进入拖拽（ms），0 表示不需要长按"
+    }
+  ],
+  "example": "// 鼠标走 HTML5 draggable，触屏走长按 + pointer，松手时回调 onReorder(from, to)。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createDragReorderPlugin({\n    enabled: true,\n    showHandle: false,\n    touchHoldMs: 180,\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "鼠标：原生 HTML5 拖拽，无额外依赖",
+    "触屏：长按 180ms 后 pointer 拖拽（可配 touchHoldMs）",
+    "onReorder 回调真正可用，bus 发 `drag:reorder`"
+  ],
+  "useCases": [
+    "后台卡片排序",
+    "收藏夹手动排序",
+    "仪表盘组件排列"
+  ],
+  "notes": [
+    "插件只负责「拖」和「告诉你从哪到哪」，数组重排由调用方在 onReorder 里做。",
+    "触屏用长按区分「想滚」和「想拖」：不这样做，手指一滑就变成拖拽，页面滚不动。"
+  ]
+}
+;
+
+export default _default;

package/dist/custom-plugins/DragReorderPlugin/index.d.ts

@@ -0,0 +1,11 @@
+import { createDragReorderPlugin as create, DragReorderConfig } from './create';
+import { PluginDoc } from '@vane/plugin-core';
+/**
+ * 工厂 + `.meta`：`typeof create` 保留原工厂的泛型签名，
+ * `.meta` 供 docs:plugins 与 demo 工坊读取配置项。
+ */
+export declare const createDragReorderPlugin: typeof create & {
+    meta: PluginDoc;
+};
+export type { DragReorderConfig };
+//# sourceMappingURL=index.d.ts.map

package/dist/custom-plugins/DragReorderPlugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/DragReorderPlugin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,uBAAuB,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAwD,OAAO,MAAM,GAAG;IAC1G,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEF,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

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

@@ -0,0 +1,5 @@
+import { c as e, d as r } from "../../chunks/doc-BXElhF2h.js";
+const o = Object.assign(e, { meta: r });
+export {
+  o as createDragReorderPlugin
+};

package/dist/{components/WaterfallPlugin/custom-plugins/Filter/index.d.ts → custom-plugins/FilterPlugin/create.d.ts}

@@ -1,5 +1,5 @@
-import { WaterfallPlugin } from '../../plugins/types';
-type FilterConfig<T = any> = {
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type FilterConfig<T = any> = {
     /** 初始筛选函数，可被 props.filterFn 覆盖 */
     predicate?: (item: T, index: number) => boolean;
     /** 条件变化后自动滚动到顶部 */
@@ -12,4 +12,4 @@ type FilterConfig<T = any> = {
  * 优先使用 props.filterFn，其次使用创建插件时传入的 predicate
  */
 export declare function createFilterPlugin<T = any>(config?: FilterConfig<T>): WaterfallPlugin<T>;
-export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/FilterPlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI;IAClC,kCAAkC;IAClC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD,mBAAmB;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CACpC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,GAAE,YAAY,CAAC,CAAC,CAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAiC5F"}

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

@@ -0,0 +1,47 @@
+declare const _default: {
+  "name": "FilterPlugin",
+  "description": "用谓词函数过滤数据，优先读 `props.filterFn`，没有就用工厂里传入的 predicate。过滤条件变了可以自动滚回顶部（默认不开）。",
+  "since": "2.0.0",
+  "tags": [
+    "data",
+    "数据管线"
+  ],
+  "config": [
+    {
+      "name": "predicate",
+      "type": "(item, index) => boolean",
+      "default": "—",
+      "description": "默认谓词，可被 props.filterFn 覆盖"
+    },
+    {
+      "name": "scrollToTop",
+      "type": "boolean",
+      "default": "false",
+      "description": "条件变化后回顶"
+    },
+    {
+      "name": "scrollBehavior",
+      "type": "\"auto\" | \"smooth\"",
+      "default": "\"auto\"",
+      "description": "回顶行为"
+    }
+  ],
+  "example": "// 按谓词过滤 items，参数变化可自动回顶。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createFilterPlugin({\n    scrollToTop: false,\n    scrollBehavior: \"auto\",\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "谓词抛错时按「保留」处理，不会整表消失",
+    "props.filterFn 优先，便于页面动态换过滤条件",
+    "可与 Sort / Search / Pagination 串联"
+  ],
+  "useCases": [
+    "分类 Tab 切换",
+    "只看有货 / 只看促销",
+    "价格区间筛选"
+  ],
+  "notes": [
+    "数据管线的执行顺序由 priority 决定：Filter(40) → Sort(30) → Search(20) → Pagination(10)。",
+    "先过滤再分页，页码总数才是过滤后的总数——顺序反了会出现「第 2 页空」。"
+  ]
+}
+;
+
+export default _default;

package/dist/custom-plugins/FilterPlugin/index.d.ts

@@ -0,0 +1,11 @@
+import { createFilterPlugin as create, FilterConfig } from './create';
+import { PluginDoc } from '@vane/plugin-core';
+/**
+ * 工厂 + `.meta`：`typeof create` 保留原工厂的泛型签名，
+ * `.meta` 供 docs:plugins 与 demo 工坊读取配置项。
+ */
+export declare const createFilterPlugin: typeof create & {
+    meta: PluginDoc;
+};
+export type { FilterConfig };
+//# sourceMappingURL=index.d.ts.map

package/dist/custom-plugins/FilterPlugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/FilterPlugin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,kBAAkB,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAwD,OAAO,MAAM,GAAG;IACrG,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEF,YAAY,EAAE,YAAY,EAAE,CAAC"}

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

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

package/dist/{components/WaterfallPlugin/custom-plugins/FixedHeight/index.d.ts → custom-plugins/FixedHeightPlugin/create.d.ts}

@@ -1,5 +1,5 @@
-import { WaterfallPlugin } from '../../plugins/types';
-type FixedHeightConfig = {
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type FixedHeightConfig = {
     /** 固定项高度（像素） */
     itemHeight: number;
 };
@@ -8,4 +8,4 @@ type FixedHeightConfig = {
  * 通过 transformProps 生成新的 items，使得 renderItem 使用统一高度
  */
 export declare function createFixedHeightPlugin<T = any>(config: FixedHeightConfig): WaterfallPlugin<T>;
-export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/FixedHeightPlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,iBAAiB,GAAG,eAAe,CAAC,CAAC,CAAC,CAsB9F"}

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

@@ -0,0 +1,34 @@
+declare const _default: {
+  "name": "FixedHeightPlugin",
+  "description": "把数据里带 height 字段的项统一改写为固定高度，瀑布流变成等高网格。适合「图少字多」的卡片流——等高反而更好扫读。",
+  "since": "2.0.0",
+  "tags": [
+    "layout",
+    "网格"
+  ],
+  "config": [
+    {
+      "name": "itemHeight",
+      "type": "number",
+      "default": "—",
+      "description": "统一项高 px（必填）"
+    }
+  ],
+  "example": "// 把项高度统一成固定值，瀑布流退化为等高网格。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createFixedHeightPlugin(),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "等高网格（严格对齐）",
+    "只改数据里已有的 height 字段",
+    "与 Pagination / Filter 组合仍然成立"
+  ],
+  "useCases": [
+    "商品列表（图固定比例）",
+    "后台看板卡片",
+    "需要严格栅格对齐的页面"
+  ],
+  "notes": [
+    "数据里没有 height 字段时不会生效——高度由 renderItem 自己的内容决定。"
+  ]
+}
+;
+
+export default _default;

package/dist/custom-plugins/FixedHeightPlugin/index.d.ts

@@ -0,0 +1,11 @@
+import { createFixedHeightPlugin as create, FixedHeightConfig } from './create';
+import { PluginDoc } from '@vane/plugin-core';
+/**
+ * 工厂 + `.meta`：`typeof create` 保留原工厂的泛型签名，
+ * `.meta` 供 docs:plugins 与 demo 工坊读取配置项。
+ */
+export declare const createFixedHeightPlugin: typeof create & {
+    meta: PluginDoc;
+};
+export type { FixedHeightConfig };
+//# sourceMappingURL=index.d.ts.map

package/dist/custom-plugins/FixedHeightPlugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/FixedHeightPlugin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,uBAAuB,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAwD,OAAO,MAAM,GAAG;IAC1G,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEF,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

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

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

package/dist/{components/WaterfallPlugin/custom-plugins/Gap/index.d.ts → custom-plugins/GapPlugin/create.d.ts}

@@ -1,5 +1,5 @@
-import { WaterfallPlugin } from '../../plugins/types';
-type GapConfig = {
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type GapConfig = {
     /** 列间距（像素） */
     columnGap?: number;
     /** 行间距（像素） */
@@ -28,4 +28,4 @@ type GapConfig = {
  * GapPlugin - 控制瀑布流的列间距和行间距，支持响应式
  */
 export declare function createGapPlugin<T = any>(config: GapConfig): WaterfallPlugin<T>;
-export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/GapPlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,SAAS,GAAG;IACtB,cAAc;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,UAAU,CAAC,EAAE;QACX,EAAE,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7C,EAAE,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7C,EAAE,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7C,EAAE,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC9C,CAAC;CACH,CAAC;AAeF;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,SAAS,GAAG,eAAe,CAAC,CAAC,CAAC,CAoB9E"}

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

@@ -0,0 +1,47 @@
+declare const _default: {
+  "name": "GapPlugin",
+  "description": "把 rowGap / columnGap 收敛到一处配置，并支持按窗口宽度切换间距（窄屏 8px、宽屏 16px 这类）。",
+  "since": "2.0.0",
+  "tags": [
+    "layout",
+    "间距"
+  ],
+  "config": [
+    {
+      "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 宽度）"
+    }
+  ],
+  "example": "// 统一控制行/列间距，支持按断点给不同间距。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createGapPlugin(),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "行列间距一处配置",
+    "断点覆盖（sm/md/lg/xl）",
+    "不填则回退到 props"
+  ],
+  "useCases": [
+    "设计规范里间距随断点变化",
+    "同一组件在不同页面用不同密度"
+  ],
+  "notes": [
+    "断点判断用的是 window.innerWidth（间距通常跟视口走，与列数按容器算不一样）。",
+    "断点是「命中即覆盖」：桌面窗口 ≥1200 又配了 responsive.lg，那就一直是 lg 的值，config.columnGap/rowGap 在这档不起作用；想让手写值生效就别给该档位配 responsive。",
+    "sm 只在小屏（<768）生效，不会被当成兜底档套到桌面端。"
+  ]
+}
+;
+
+export default _default;

package/dist/custom-plugins/GapPlugin/index.d.ts

@@ -0,0 +1,11 @@
+import { createGapPlugin as create, GapConfig } from './create';
+import { PluginDoc } from '@vane/plugin-core';
+/**
+ * 工厂 + `.meta`：`typeof create` 保留原工厂的泛型签名，
+ * `.meta` 供 docs:plugins 与 demo 工坊读取配置项。
+ */
+export declare const createGapPlugin: typeof create & {
+    meta: PluginDoc;
+};
+export type { GapConfig };
+//# sourceMappingURL=index.d.ts.map

package/dist/custom-plugins/GapPlugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/GapPlugin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,eAAe,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAwD,OAAO,MAAM,GAAG;IAClG,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEF,YAAY,EAAE,SAAS,EAAE,CAAC"}

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

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

package/dist/custom-plugins/GroupingPlugin/create.d.ts

@@ -0,0 +1,16 @@
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type GroupingConfig<T = any> = {
+    /** 分组函数，返回组键（默认取 item.category） */
+    groupBy?: (item: T, index: number) => string | number;
+    /** 是否显示分组统计角标（默认 false） */
+    showOverlay?: boolean;
+};
+/**
+ * GroupingPlugin - 按字段把项分组，结果写进 `sharedData.get("GROUPS")`。
+ *
+ * 旧版只在 `onPropsChange` 里算，而挂载时不会触发 props 变化 → **首屏永远拿不到分组**，
+ * 吸顶条只能显示写死的标题。这里改成挂载即算，并在 items 变化与布局完成时重算，
+ * 同时把结果 emit 出去（`grouping:change`），页面不用轮询 sharedData。
+ */
+export declare function createGroupingPlugin<T = any>(config?: GroupingConfig<T>): WaterfallPlugin<T>;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/GroupingPlugin/create.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,gDAAgD,CAAC;AAExD,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,GAAG,IAAI;IACpC,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAAC;IACtD,2BAA2B;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAIF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAC1C,MAAM,GAAE,cAAc,CAAC,CAAC,CAAM,GAC7B,eAAe,CAAC,CAAC,CAAC,CAiEpB"}

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

@@ -0,0 +1,40 @@
+declare const _default: {
+  "name": "GroupingPlugin",
+  "description": "用 groupBy 把项按业务字段分组，结果放进 sharedData 的 `GROUPS`（Map<组键, 索引数组>），供 StickyHeaderPlugin、分组统计条等消费。挂载即算一次，之后 props 变化重算。",
+  "since": "2.0.0",
+  "tags": [
+    "ui",
+    "分组"
+  ],
+  "config": [
+    {
+      "name": "groupBy",
+      "type": "(item, index) => string | number",
+      "default": "item.category ?? \"default\"",
+      "description": "分组函数"
+    },
+    {
+      "name": "showOverlay",
+      "type": "boolean",
+      "default": "false",
+      "description": "是否显示分组统计角标"
+    }
+  ],
+  "example": "// 按字段把项分组，结果写进 sharedData(GROUPS) 供吸顶条 / 统计用。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createGroupingPlugin({\n    groupBy: \"item.category ?? \\\"default\\\"\",\n    showOverlay: false,\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "挂载即计算（旧版只在 props 变化时算，首屏永远拿不到分组）",
+    "结果写 sharedData，跨插件可读",
+    "统计角标默认关闭"
+  ],
+  "useCases": [
+    "按分类分组的信息流",
+    "按日期分组的时间线",
+    "吸顶条显示当前分组"
+  ],
+  "notes": [
+    "分组只产出索引映射，不改变渲染顺序；要视觉分组请自己按分组建行。"
+  ]
+}
+;
+
+export default _default;

package/dist/custom-plugins/GroupingPlugin/index.d.ts

@@ -0,0 +1,11 @@
+import { createGroupingPlugin as create, GroupingConfig } from './create';
+import { PluginDoc } from '@vane/plugin-core';
+/**
+ * 工厂 + `.meta`：`typeof create` 保留原工厂的泛型签名，
+ * `.meta` 供 docs:plugins 与 demo 工坊读取配置项。
+ */
+export declare const createGroupingPlugin: typeof create & {
+    meta: PluginDoc;
+};
+export type { GroupingConfig };
+//# sourceMappingURL=index.d.ts.map

package/dist/custom-plugins/GroupingPlugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/GroupingPlugin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,oBAAoB,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAwD,OAAO,MAAM,GAAG;IACvG,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEF,YAAY,EAAE,cAAc,EAAE,CAAC"}

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

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

package/dist/custom-plugins/HeatmapAnalyticsPlugin/create.d.ts

@@ -0,0 +1,31 @@
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type HeatmapAnalyticsConfig = {
+    /** 是否显示顶部统计汇总条（默认 false） */
+    showOverlay?: boolean;
+    /** 别名：示例页使用的 showOverlaySummary */
+    showOverlaySummary?: boolean;
+};
+/**
+ * `getStats()` 的返回形状：每项的曝光 / 点击次数。
+ *
+ * 只列「有数据」的项 —— 上千项时把全零项也吐出来没有意义。
+ */
+export type HeatmapAnalyticsStats = {
+    totalViews: number;
+    totalClicks: number;
+    items: Array<{
+        index: number;
+        views: number;
+        clicks: number;
+    }>;
+};
+/**
+ * HeatmapAnalyticsPlugin - 点击/曝光热力分析（基础版）
+ * - 统计每项进入视口次数与点击次数
+ * - 可选在顶部显示统计摘要叠层
+ * - `getStats()` 把内存里的统计吐出来，方便接到自己的上报通道
+ */
+export declare function createHeatmapAnalyticsPlugin<T = any>(config?: HeatmapAnalyticsConfig): WaterfallPlugin<T> & {
+    getStats: () => HeatmapAnalyticsStats;
+};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/HeatmapAnalyticsPlugin/create.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,sBAAsB,GAAG;IACnC,4BAA4B;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mCAAmC;IACnC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,GAAG,GAAG,EAClD,MAAM,GAAE,sBAA2B,GAClC,eAAe,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;CAAE,CA2EhE"}

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

@@ -0,0 +1,43 @@
+declare const _default: {
+  "name": "HeatmapAnalyticsPlugin",
+  "description": "统计每项进入视口次数与点击次数，可选顶部汇总条，`getStats()` 取出每项明细。曝光是瀑布流里最容易统计错的东西（滚动时反复进出视口），交给插件比自己写 IntersectionObserver 少踩坑。",
+  "since": "2.0.0",
+  "tags": [
+    "interaction",
+    "埋点",
+    "曝光"
+  ],
+  "config": [
+    {
+      "name": "showOverlay",
+      "type": "boolean",
+      "default": "false",
+      "description": "是否显示顶部汇总条"
+    },
+    {
+      "name": "showOverlaySummary",
+      "type": "boolean",
+      "default": "—",
+      "description": "showOverlay 的旧别名"
+    }
+  ],
+  "example": "// 统计每项曝光次数与点击次数，可显示汇总条。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createHeatmapAnalyticsPlugin({\n    showOverlay: false,\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "按项的曝光 / 点击双计数",
+    "首屏曝光在 onLayoutComplete 补一次",
+    "getStats() 输出可上报的扁平结构"
+  ],
+  "useCases": [
+    "信息流曝光分析",
+    "广告位可见性验证",
+    "调试曝光策略"
+  ],
+  "notes": [
+    "首屏曝光靠 onLayoutComplete 补一次，否则第一帧显示 0。",
+    "真实上报要自己做去重与批次（插件只负责计数，不区分「同一项第几次进入」）。",
+    "计数只在内存里，刷新即清零 —— 定时取 getStats() 上报。"
+  ]
+}
+;
+
+export default _default;

package/dist/custom-plugins/HeatmapAnalyticsPlugin/index.d.ts

@@ -0,0 +1,11 @@
+import { createHeatmapAnalyticsPlugin as create, HeatmapAnalyticsConfig, HeatmapAnalyticsStats } from './create';
+import { PluginDoc } from '@vane/plugin-core';
+/**
+ * 工厂 + `.meta`：`typeof create` 保留原工厂的泛型签名，
+ * `.meta` 供 docs:plugins 与 demo 工坊读取配置项。
+ */
+export declare const createHeatmapAnalyticsPlugin: typeof create & {
+    meta: PluginDoc;
+};
+export type { HeatmapAnalyticsConfig, HeatmapAnalyticsStats };
+//# sourceMappingURL=index.d.ts.map

package/dist/custom-plugins/HeatmapAnalyticsPlugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/HeatmapAnalyticsPlugin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,4BAA4B,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAE9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAwD,OAAO,MAAM,GAAG;IAC/G,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEF,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,CAAC"}

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

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

package/dist/custom-plugins/InfiniteScrollPlugin/create.d.ts

@@ -0,0 +1,17 @@
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type InfiniteScrollConfig = {
+    /** 距底部多少像素开始预加载，默认 300（≈ 半屏，滚到底时数据已就位） */
+    threshold?: number;
+    /** 加载回调；不给则读 `props.onLoadMore` */
+    onLoadMore?: () => Promise<void> | void;
+};
+/**
+ * InfiniteScrollPlugin - 滚动到距底阈值内触发加载更多。
+ *
+ * 与旧版的三处差别：
+ *  1. 触发条件由 Core 的 `reachBottomOffset` 控制（旧版写死 100px，插件配 300 也不会提前触发）；
+ *  2. 自带并发锁：上一次 onLoadMore 没 resolve 前不会重复触发（旧版每次滚动事件都会调）；
+ *  3. `context.hasMore === false` 时直接停（配合页面 setState({ hasMore: false })）。
+ */
+export declare function createInfiniteScrollPlugin<T = any>(config?: InfiniteScrollConfig): WaterfallPlugin<T>;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/InfiniteScrollPlugin/create.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,gDAAgD,CAAC;AAExD,MAAM,MAAM,oBAAoB,GAAG;IACjC,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACzC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,GAAG,GAAG,EAChD,MAAM,GAAE,oBAAyB,GAChC,eAAe,CAAC,CAAC,CAAC,CAmCpB"}

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

@@ -0,0 +1,44 @@
+declare const _default: {
+  "name": "InfiniteScrollPlugin",
+  "description": "监听 Core 的 onReachBottom，在距底部 `threshold` 像素内触发 onLoadMore。自带并发锁：上一次还没结束不会重复触发。",
+  "since": "2.0.0",
+  "tags": [
+    "data",
+    "加载更多"
+  ],
+  "config": [
+    {
+      "name": "threshold",
+      "type": "number",
+      "default": "300",
+      "description": "触发距离 px"
+    },
+    {
+      "name": "onLoadMore",
+      "type": "() => void | Promise<void>",
+      "default": "props.onLoadMore",
+      "description": "加载回调"
+    }
+  ],
+  "example": "// 滚动到距底部阈值内触发加载更多，带并发锁防重复请求。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createInfiniteScrollPlugin({\n    threshold: 300,\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "conflicts": [
+    "PaginationPlugin"
+  ],
+  "features": [
+    "距底 300px 预加载，滚到底时数据已就位",
+    "并发锁：加载中不重复触发",
+    "context.hasMore 为 false 时自动停"
+  ],
+  "useCases": [
+    "信息流无限滚动",
+    "画廊继续加载",
+    "搜索结果瀑布流"
+  ],
+  "notes": [
+    "阈值不要小于一屏（约 600px），否则用户滚到底会看到空白等待。",
+    "翻页类场景请用 PaginationPlugin，两者不要同装。"
+  ]
+}
+;
+
+export default _default;