vane-waterfall 1.0.5 → 2.0.1

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/InfiniteScrollPlugin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,0BAA0B,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAwD,OAAO,MAAM,GAAG;IAC7G,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEF,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

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

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

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

@@ -1,5 +1,5 @@
-import { WaterfallPlugin } from '../../plugins/types';
-type PaginationConfig = {
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type PaginationConfig = {
     /** 每页数量 */
     pageSize?: number;
     /** 翻页后自动滚动到顶部 */
@@ -12,4 +12,4 @@ type PaginationConfig = {
  * 支持通过 config.pageSize 设定默认每页数量
  */
 export declare function createPaginationPlugin<T = any>(config?: PaginationConfig): WaterfallPlugin<T>;
-export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/PaginationPlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CACpC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,GAAE,gBAAqB,GAAG,eAAe,CAAC,CAAC,CAAC,CA+BjG"}

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

@@ -0,0 +1,50 @@
+declare const _default: {
+  "name": "PaginationPlugin",
+  "description": "读 `props.pageIndex`（1 基）与 `props.pageSize` 切片。放在数据管线最末端，保证切的是「过滤 + 排序 + 搜索」之后的结果。",
+  "since": "2.0.0",
+  "tags": [
+    "data",
+    "数据管线",
+    "分页"
+  ],
+  "config": [
+    {
+      "name": "pageSize",
+      "type": "number",
+      "default": "props.pageSize ?? 20",
+      "description": "每页条数"
+    },
+    {
+      "name": "scrollToTop",
+      "type": "boolean",
+      "default": "false",
+      "description": "翻页后回顶"
+    },
+    {
+      "name": "scrollBehavior",
+      "type": "\"auto\" | \"smooth\"",
+      "default": "\"auto\"",
+      "description": "回顶行为"
+    }
+  ],
+  "example": "// 按 props.pageIndex / pageSize 切片，页码从 1 开始。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createPaginationPlugin({\n    scrollToTop: false,\n    scrollBehavior: \"auto\",\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "conflicts": [
+    "InfiniteScrollPlugin"
+  ],
+  "features": [
+    "1 基页码（与 UI 分页器一致）",
+    "pageIndex 非法值自动夹到 1",
+    "翻页自动回顶可选"
+  ],
+  "useCases": [
+    "后台列表分页",
+    "搜索结果分页",
+    "与 URLSyncPlugin 配合做可分享链接"
+  ],
+  "notes": [
+    "pageSize 优先级：props.pageSize > 工厂 config.pageSize > 20。"
+  ]
+}
+;
+
+export default _default;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/PaginationPlugin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,sBAAsB,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAwD,OAAO,MAAM,GAAG;IACzG,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEF,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

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

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

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

@@ -0,0 +1,23 @@
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type PinItemConfig = {
+    /** 要钉在顶部的项索引（建议用 0 起的小索引） */
+    pinnedIndices: number[];
+    /** 钉到第几列，默认 0（最左列） */
+    column?: number;
+};
+/**
+ * PinItemPlugin - 把指定项钉在顶部指定列，其余项从置顶块下方继续排。
+ *
+ * 旧版这里是个空转插件：全部逻辑压在 `calculateItemPosition` 上，而 Core 里
+ * **没有任何地方执行这个钩子**（tasks/07 · 4.5 的死钩子清单），`renderOverlay`
+ * 又返回 null —— 上线至今什么都没做。D1-A 把钩子接上后这里才是真的实现。
+ *
+ * 语义与限制（写在这里，避免变成"看起来能用"的坑）：
+ *  - 置顶项在**同列普通项之前**被布局时最干净（通常 pinnedIndices 是 0..n）。
+ *    若置顶项的索引大于该列已排好的项，它会按 floor 规则把后续项往下推，
+ *    但已布局的项不会回退，视觉上会重叠。
+ *  - 置顶项不参与列轮转，永远落在 `config.column`。
+ *  - 同一列多条置顶按 pinnedIndices 顺序纵向堆叠。
+ */
+export declare function createPinItemPlugin<T = any>(config: PinItemConfig): WaterfallPlugin<T>;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/PinItemPlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,eAAe,EAEhB,MAAM,gDAAgD,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG;IAC1B,6BAA6B;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,aAAa,GAAG,eAAe,CAAC,CAAC,CAAC,CAiDtF"}

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

@@ -0,0 +1,43 @@
+declare const _default: {
+  "name": "PinItemPlugin",
+  "description": "把若干索引的项钉在顶部指定列，其余项从它们下方继续排。走 D1-A 布局钩子（calculateItemPosition），是旧版宣称但从未生效的能力。",
+  "since": "2.0.0",
+  "tags": [
+    "layout",
+    "layout-hook",
+    "置顶"
+  ],
+  "config": [
+    {
+      "name": "pinnedIndices",
+      "type": "number[]",
+      "default": "[]",
+      "description": "要钉住的项索引"
+    },
+    {
+      "name": "column",
+      "type": "number",
+      "default": "0",
+      "description": "钉到第几列"
+    }
+  ],
+  "example": "// 把指定索引的项钉在顶部同一列，不参与常规列高推进（广告位 / 公告卡）。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createPinItemPlugin({\n    pinnedIndices: [],\n    column: 0,\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "置顶项不占常规列高：后续项从置顶块下方开始",
+    "支持多列分别置顶（column 可不同）",
+    "每次布局前重置偏移，items 变化后不会累加错位"
+  ],
+  "useCases": [
+    "信息流首位的推广卡",
+    "公告 / 置顶帖",
+    "需要固定在左上角的活动位"
+  ],
+  "notes": [
+    "置顶项之间按 pinnedIndices 顺序纵向堆叠，同一列多条会依次往下排。",
+    "置顶会挤掉该列的正常网格位置，pinnedIndices 建议控制在 1~2 条。",
+    "换列后的 x 由布局引擎按本轮列宽补齐，插件只返回 column 即可 —— 自己用「列宽 + 间距」反推 x 会在间距由其它插件（GapPlugin）注入时算错。"
+  ]
+}
+;
+
+export default _default;

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

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

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

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

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

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

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

@@ -1,5 +1,5 @@
-import { WaterfallPlugin } from '../../plugins/types';
-type RecycleConfig = {
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type RecycleConfig = {
     /** 视口外隐藏项以降低渲染压力（最大可见项数，近似控制） */
     poolSize: number;
 };
@@ -9,4 +9,4 @@ type RecycleConfig = {
  * - 当项进入视口时，恢复为 `visibility:visible`
  */
 export declare function createRecyclePlugin<T = any>(config: RecycleConfig): WaterfallPlugin<T>;
-export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/RecyclePlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,aAAa,GAAG;IAC1B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,aAAa,GAAG,eAAe,CAAC,CAAC,CAAC,CAmCtF"}

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

@@ -0,0 +1,35 @@
+declare const _default: {
+  "name": "RecyclePlugin",
+  "description": "纯绘制层优化：项离开视口就 `visibility: hidden`，回来再显示。DOM 节点不销毁，滚动位置与已加载的图片都保留，适合「项里有视频/Canvas，重建代价高」的场景。",
+  "since": "2.0.0",
+  "tags": [
+    "interaction",
+    "性能"
+  ],
+  "config": [
+    {
+      "name": "poolSize",
+      "type": "number",
+      "default": "—",
+      "description": "同时保持可见的项数上限（超出则回收最早的）"
+    }
+  ],
+  "example": "// 视口外的项设 `visibility: hidden`，降低长列表的绘制压力。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createRecyclePlugin(),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "不销毁 DOM，只隐藏",
+    "项内媒体不重新加载",
+    "与虚拟化正交（一个省绘制、一个省节点）"
+  ],
+  "useCases": [
+    "项内含视频 / canvas",
+    "长列表滚动发虚",
+    "低端设备省电"
+  ],
+  "notes": [
+    "与 Core 的 `virtualize` 同开会让项被卸载又隐藏，收益互相抵消，建议只选一个。",
+    "只改 visibility 不改布局，所以不会引起重排。"
+  ]
+}
+;
+
+export default _default;

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

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

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

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

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

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

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

@@ -0,0 +1,25 @@
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type ReducedMotionConfig = {
+    /** 当用户偏好减少动画时，是否禁用 transform 定位 */
+    disableTransform?: boolean;
+    /** 当用户偏好减少动画时，是否移除项过渡效果 */
+    removeTransitions?: boolean;
+};
+/**
+ * ReducedMotionPlugin - 尊重系统的减少动画偏好
+ *
+ * 两条「为什么」值得记下来：
+ *
+ * 1. **只改 `itemStyle` 不够**：TransitionPlugin 这类插件会在 `onItemMount` / `onLayout`
+ *    里直接写元素的 `style.transition`，内联样式晚于 `itemStyle` 生效。`onLayoutComplete`
+ *    在全部 `onLayout` 之后执行，必须在这里再清一次才真的「没有过渡」。
+ *
+ * 2. **偏好要能运行时切换**：以前在工厂创建时把 `mq.matches` 求值存成常量，用户中途改
+ *    系统设置必须刷新页面。现在监听 `change`，并且自己维护一份已挂载元素表 ——
+ *    偏好变了并不会触发布局，插件没有别的入口能遍历到那些元素。
+ *
+ * 定位方式（`useTransform`）是 props 层的，运行时切换要等下一次重渲染才生效；
+ * 过渡效果则是即时生效的。
+ */
+export declare function createReducedMotionPlugin<T = any>(config?: ReducedMotionConfig): WaterfallPlugin<T>;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/ReducedMotionPlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,mBAAmB,GAAG;IAChC,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2BAA2B;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAIF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,GAAG,GAAG,EAC/C,MAAM,GAAE,mBAAwB,GAC/B,eAAe,CAAC,CAAC,CAAC,CA6FpB"}

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

@@ -0,0 +1,42 @@
+declare const _default: {
+  "name": "ReducedMotionPlugin",
+  "description": "检测 `prefers-reduced-motion: reduce`，命中后把 useTransform 关掉并清掉项上的 transition。前庭功能敏感用户不会因为滚动时的位置微动而不适。",
+  "since": "2.0.0",
+  "tags": [
+    "perf",
+    "a11y"
+  ],
+  "config": [
+    {
+      "name": "disableTransform",
+      "type": "boolean",
+      "default": "true",
+      "description": "命中偏好时改用 left/top 定位"
+    },
+    {
+      "name": "removeTransitions",
+      "type": "boolean",
+      "default": "true",
+      "description": "命中偏好时清掉项过渡"
+    }
+  ],
+  "example": "// 尊重系统「减少动画」偏好：关掉 transform 定位与项过渡。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createReducedMotionPlugin({\n    disableTransform: true,\n    removeTransitions: true,\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "系统偏好驱动，零配置生效",
+    "两项能力可分别关闭",
+    "与 TransitionPlugin 同装时优先生效"
+  ],
+  "useCases": [
+    "政务 / 医疗类站点",
+    "无障碍合规要求",
+    "低性能设备"
+  ],
+  "notes": [
+    "偏好由 matchMedia 驱动，并监听 change：运行中改系统设置即时生效（定位方式要等下一次重渲染才切过来）。",
+    "只压 `transition-duration`，不写 `transition: none` —— 写简写会把 TransitionPlugin 的过渡整条覆盖，撤销偏好后无从还原。",
+    "与 TransitionPlugin 同装不是冲突：ReducedMotion 优先级更高，会先执行并压住过渡。"
+  ]
+}
+;
+
+export default _default;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/ReducedMotionPlugin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,yBAAyB,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAwD,OAAO,MAAM,GAAG;IAC5G,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEF,YAAY,EAAE,mBAAmB,EAAE,CAAC"}

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

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

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

@@ -0,0 +1,22 @@
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+type Breakpoint = {
+    width: number;
+    columns: number;
+};
+type Breakpoints = Record<string, Breakpoint>;
+type ResponsiveColumnsConfig = {
+    /** 断点表：键名随意，按 width 升序匹配，命中哪档用哪档 */
+    breakpoints: Breakpoints;
+    /** 未命中任何断点时回退到几列（默认取 props.columns ?? 3） */
+    fallbackColumns?: number;
+};
+/**
+ * ResponsiveColumnsPlugin - 按断点表决定列数。
+ *
+ * 走 D1-A 布局钩子 `calculateColumns`：拿到的是**容器**宽度（不是 window.innerWidth），
+ * 所以同一个组件嵌在侧边栏或全宽区域里都能算对。旧版走 transformProps + window 宽度，
+ * 在「窄容器 + 宽视口」的组合下会给出偏大的列数。
+ */
+export declare function createResponsiveColumnsPlugin<T = any>(config: ResponsiveColumnsConfig): WaterfallPlugin<T>;
+export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/ResponsiveColumnsPlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,gDAAgD,CAAC;AAExD,KAAK,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AACrD,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAE9C,KAAK,uBAAuB,GAAG;IAC7B,oCAAoC;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,GAAG,GAAG,EACnD,MAAM,EAAE,uBAAuB,GAC9B,eAAe,CAAC,CAAC,CAAC,CAmBpB"}

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

@@ -0,0 +1,37 @@
+declare const _default: {
+  "name": "ResponsiveColumnsPlugin",
+  "description": "用一张断点表控制列数，命中哪档用哪档。走 D1-A 布局钩子（calculateColumns），按容器宽度匹配断点。",
+  "since": "2.0.0",
+  "tags": [
+    "layout",
+    "layout-hook",
+    "响应式"
+  ],
+  "config": [
+    {
+      "name": "breakpoints",
+      "type": "Record<string, { width: number; columns: number }>",
+      "default": "—",
+      "description": "断点表，按 width 升序匹配"
+    }
+  ],
+  "example": "// 按断点表决定列数（如 640 → 2 列、1024 → 3 列、1440 → 4 列）。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createResponsiveColumnsPlugin(),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "conflicts": [
+    "AutoColumnPlugin"
+  ],
+  "features": [
+    "断点表驱动，设计稿几档就写几档",
+    "按容器宽度而非视口宽度匹配",
+    "未命中任何断点时回退到 props.columns"
+  ],
+  "useCases": [
+    "严格对齐设计断点的站点",
+    "同一个组件嵌在不同宽度的容器里"
+  ],
+  "notes": [
+    "与 AutoColumnPlugin 互斥。"
+  ]
+}
+;
+
+export default _default;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/ResponsiveColumnsPlugin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,6BAA6B,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAwD,OAAO,MAAM,GAAG;IAChH,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC"}

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

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

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

@@ -1,5 +1,5 @@
-import { WaterfallPlugin } from '../../plugins/types';
-type ScrollAnchorConfig<T = any> = {
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type ScrollAnchorConfig<T = any> = {
     /** 通过此函数提取锚点 id（默认使用 item.id） */
     getAnchorId?: (item: T, index: number) => string | number | undefined;
 };
@@ -9,4 +9,4 @@ type ScrollAnchorConfig<T = any> = {
  * - 支持通过 bus 事件 anchor:scrollToId 跳转
  */
 export declare function createScrollAnchorPlugin<T = any>(config?: ScrollAnchorConfig<T>): WaterfallPlugin<T>;
-export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/ScrollAnchorPlugin/create.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,GAAG,IAAI;IACxC,iCAAiC;IACjC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACvE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,GAAE,kBAAkB,CAAC,CAAC,CAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAmBxG"}

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

@@ -0,0 +1,34 @@
+declare const _default: {
+  "name": "ScrollAnchorPlugin",
+  "description": "不需要自己算索引：外部只管 `bus.emit(\"anchor:scrollToId\", { id })`，插件用 getAnchorId 找到对应项并滚过去。适合「从消息跳到某条内容」。",
+  "since": "2.0.0",
+  "tags": [
+    "interaction",
+    "滚动"
+  ],
+  "config": [
+    {
+      "name": "getAnchorId",
+      "type": "(item, index) => string | number | undefined",
+      "default": "item.id",
+      "description": "从项里取锚点 id"
+    }
+  ],
+  "example": "// 监听 `anchor:scrollToId` 事件，按业务 id 滚动到对应项。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createScrollAnchorPlugin({\n    getAnchorId: \"item.id\",\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "按业务 id 定位，不用算下标",
+    "onMount 订阅 / onUnmount 退订（不泄漏）",
+    "平滑滚动"
+  ],
+  "useCases": [
+    "从通知跳转到具体卡片",
+    "目录点击定位",
+    "外链深链定位"
+  ],
+  "notes": [
+    "目标项必须已在 items 里；分页场景请先切到对应页再发事件。"
+  ]
+}
+;
+
+export default _default;

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

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

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

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

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

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

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

@@ -1,5 +1,5 @@
-import { WaterfallPlugin } from '../../plugins/types';
-type SearchConfig<T = any> = {
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type SearchConfig<T = any> = {
     /** 要搜索的字段名列表（仅用于对象项） */
     fields?: (keyof T)[];
     /** 条件变化后自动滚动到顶部 */
@@ -12,4 +12,4 @@ type SearchConfig<T = any> = {
  * 仅在对象项中按指定字段进行大小写不敏感的包含匹配
  */
 export declare function createSearchPlugin<T = any>(config?: SearchConfig<T>): WaterfallPlugin<T>;
-export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/SearchPlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI;IAClC,wBAAwB;IACxB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACrB,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,CAqC5F"}

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

@@ -0,0 +1,47 @@
+declare const _default: {
+  "name": "SearchPlugin",
+  "description": "读取 `props.searchQuery`，在指定字段上做大小写不敏感的 `includes` 匹配。没指定字段就对对象的全部自有字段匹配。",
+  "since": "2.0.0",
+  "tags": [
+    "data",
+    "数据管线",
+    "搜索"
+  ],
+  "config": [
+    {
+      "name": "fields",
+      "type": "(keyof T)[]",
+      "default": "[]",
+      "description": "参与匹配的字段；空则匹配全部自有字段"
+    },
+    {
+      "name": "scrollToTop",
+      "type": "boolean",
+      "default": "false",
+      "description": "关键词变化后回顶"
+    },
+    {
+      "name": "scrollBehavior",
+      "type": "\"auto\" | \"smooth\"",
+      "default": "\"auto\"",
+      "description": "回顶行为"
+    }
+  ],
+  "example": "// 按 props.searchQuery 做大小写不敏感的多字段包含匹配。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createSearchPlugin({\n    fields: [],\n    scrollToTop: false,\n    scrollBehavior: \"auto\",\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "大小写不敏感",
+    "多字段 OR 匹配",
+    "空关键词直接放行（不触发过滤）"
+  ],
+  "useCases": [
+    "站内搜索结果页",
+    "后台列表即时搜索",
+    "商品名 / 店铺名联合搜索"
+  ],
+  "notes": [
+    "纯前端 `includes`，不排序也不做拼音；要相关性排序请在 Search 之后接 SortPlugin。"
+  ]
+}
+;
+
+export default _default;

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

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