vane-waterfall 1.0.4 → 2.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/SearchPlugin/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/SearchPlugin/index.js

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/SortPlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,GAAG,IAAI;IAChC,wCAAwC;IACxC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;IACpC,mBAAmB;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CACpC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,GAAE,UAAU,CAAC,CAAC,CAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAiCxF"}

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

@@ -0,0 +1,46 @@
+declare const _default: {
+  "name": "SortPlugin",
+  "description": "用比较函数排序，优先读 `props.sortComparator`。排序总是在过滤之后、分页之前执行，保证「第 N 页」是排序后的第 N 页。",
+  "since": "2.0.0",
+  "tags": [
+    "data",
+    "数据管线"
+  ],
+  "config": [
+    {
+      "name": "comparator",
+      "type": "(a, b) => number",
+      "default": "—",
+      "description": "默认比较函数，可被 props.sortComparator 覆盖"
+    },
+    {
+      "name": "scrollToTop",
+      "type": "boolean",
+      "default": "false",
+      "description": "排序变化后回顶"
+    },
+    {
+      "name": "scrollBehavior",
+      "type": "\"auto\" | \"smooth\"",
+      "default": "\"auto\"",
+      "description": "回顶行为"
+    }
+  ],
+  "example": "// 按比较函数排序 items，比较函数变化可自动回顶。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createSortPlugin({\n    scrollToTop: false,\n    scrollBehavior: \"auto\",\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "稳定排序（不改原数组）",
+    "比较函数抛错按相等处理",
+    "与 Filter / Search 顺序固定"
+  ],
+  "useCases": [
+    "价格 / 时间排序",
+    "热度排序",
+    "手动置顶项优先"
+  ],
+  "notes": [
+    "排序会复制数组（`[...items].sort`），不会改调用方传入的 items。"
+  ]
+}
+;
+
+export default _default;

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

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

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

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

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

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

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

@@ -1,5 +1,5 @@
-import { WaterfallPlugin } from '../../plugins/types';
-type StatePersistenceConfig = {
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type StatePersistenceConfig = {
     /** 存储键（localStorage） */
     storageKey?: string;
     /** 是否持久化滚动位置 */
@@ -13,4 +13,4 @@ type StatePersistenceConfig = {
  * - 快照包含：scrollTop（可选）与部分 props 键
  */
 export declare function createStatePersistencePlugin<T = any>(config?: StatePersistenceConfig): WaterfallPlugin<T>;
-export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/StatePersistencePlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,sBAAsB,GAAG;IACnC,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,GAAE,sBAA2B,GAAG,eAAe,CAAC,CAAC,CAAC,CAiG7G"}

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

@@ -0,0 +1,47 @@
+declare const _default: {
+  "name": "StatePersistencePlugin",
+  "description": "三个时机各做一件事：首次渲染把快照里的 pageIndex / searchQuery 注入 props；挂载后恢复 scrollTop；props 变化与卸载时写回快照。刷新页面不丢进度。",
+  "since": "2.0.0",
+  "tags": [
+    "ui",
+    "持久化"
+  ],
+  "config": [
+    {
+      "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 键"
+    }
+  ],
+  "example": "// 把滚动位置与分页/查询状态存 localStorage，回来时恢复。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createStatePersistencePlugin({\n    storageKey: \"waterfall-state\",\n    persistScroll: true,\n    persistKeys: [\"pageIndex\",\"pageSize\",\"searchQuery\"],\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "滚动位置 + 分页/查询一起存",
+    "首帧注入只做一次，不会覆盖用户操作",
+    "SSR / 隐私模式下降级为不持久化"
+  ],
+  "useCases": [
+    "后台列表刷新不丢页",
+    "搜索结果返回定位",
+    "移动端来回切换页面"
+  ],
+  "notes": [
+    "只能恢复「值」，不能替你把它写回 React state——页面应订阅 `state:restored` 事件或读 bus。",
+    "localStorage 不可用（隐私模式/配额满）时静默跳过，不会抛错。"
+  ]
+}
+;
+
+export default _default;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/StatePersistencePlugin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,4BAA4B,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEvD,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,CAAC"}

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

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

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

@@ -0,0 +1,13 @@
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type StickyHeaderConfig = {
+    /** 标题文案（默认 "分组标题"） */
+    title?: string;
+    /** 是否显示「向下滚动观察」提示（默认 false） */
+    showHint?: boolean;
+};
+/**
+ * StickyHeaderPlugin - 吸顶标题（实验版）
+ * - 简化实现：始终显示一个吸顶条，可与 GroupingPlugin 联动
+ */
+export declare function createStickyHeaderPlugin<T = any>(config?: StickyHeaderConfig): WaterfallPlugin<T>;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/StickyHeaderPlugin/create.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,GAAE,kBAAuB,GAAG,eAAe,CAAC,CAAC,CAAC,CAoCrG"}

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

@@ -0,0 +1,40 @@
+declare const _default: {
+  "name": "StickyHeaderPlugin",
+  "description": "在滚动容器内渲染一条 `position: sticky` 的标题条，始终贴住容器顶部。装了 GroupingPlugin 时自动显示第一个分组名，也可用 title 写死。",
+  "since": "2.0.0",
+  "tags": [
+    "ui",
+    "吸顶"
+  ],
+  "config": [
+    {
+      "name": "title",
+      "type": "string",
+      "default": "\"分组标题\"",
+      "description": "标题文案"
+    },
+    {
+      "name": "showHint",
+      "type": "boolean",
+      "default": "false",
+      "description": "是否显示「向下滚动观察」提示"
+    }
+  ],
+  "example": "// 滚动容器内的吸顶标题条，可与分组联动显示当前组。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createStickyHeaderPlugin({\n    title: \"分组标题\",\n    showHint: false,\n  }),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "sticky 吸顶，不依赖额外容器",
+    "与 Grouping 联动显示当前组",
+    "提示文案默认关闭"
+  ],
+  "useCases": [
+    "分组信息流",
+    "按日期分组的时间线",
+    "长列表的上下文提示"
+  ],
+  "notes": [
+    "sticky 生效要求它作为滚动容器的直接子元素——由 composeSlots 保证，单测已锁。"
+  ]
+}
+;
+
+export default _default;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/StickyHeaderPlugin/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,mBAAmB,CAAC;AAEnD;;;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/StickyHeaderPlugin/index.js

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

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

@@ -1,5 +1,5 @@
-import { WaterfallPlugin } from '../../plugins/types';
-type ThrottleConfig = {
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type ThrottleConfig = {
     /** 滚动节流（ms） */
     scroll: number;
     /** 尺寸变化防抖（ms），用于容器 Resize 相关 */
@@ -9,4 +9,4 @@ type ThrottleConfig = {
  * ThrottlePlugin - 通过 transformProps 调整核心的滚动节流与尺寸变化防抖
  */
 export declare function createThrottlePlugin<T = any>(config: ThrottleConfig): WaterfallPlugin<T>;
-export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/ThrottlePlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,cAAc,GAAG,eAAe,CAAC,CAAC,CAAC,CAexF"}

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

@@ -0,0 +1,40 @@
+declare const _default: {
+  "name": "ThrottlePlugin",
+  "description": "接管 Core 的 throttleDelay（滚动回调节流）与 debounceDelay（尺寸变化后多久重排）。默认 16ms / 150ms，长列表滚动卡顿时可以放宽到 32 / 300。",
+  "since": "2.0.0",
+  "tags": [
+    "perf",
+    "性能"
+  ],
+  "config": [
+    {
+      "name": "scroll",
+      "type": "number",
+      "default": "—",
+      "description": "滚动节流 ms（必填）"
+    },
+    {
+      "name": "resize",
+      "type": "number",
+      "default": "props.debounceDelay",
+      "description": "布局防抖 ms"
+    }
+  ],
+  "example": "// 调整滚动节流与尺寸防抖，弱网/低端机可放宽。\nconst Waterfall = withPlugins(WaterfallCore, [\n  createThrottlePlugin(),\n]);\n\n<Waterfall items={items} renderItem={(item) => <Card data={item} />} />;",
+  "features": [
+    "滚动节流与布局防抖分开调",
+    "只改 props，不改算法",
+    "与 DebounceLayoutPlugin 叠加时后者优先"
+  ],
+  "useCases": [
+    "低端安卓机长列表",
+    "滚动时 CPU 占用过高",
+    "拖拽侧栏时减少重排"
+  ],
+  "notes": [
+    "scroll 低于 16ms 没有意义（浏览器帧率上限）。"
+  ]
+}
+;
+
+export default _default;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/ThrottlePlugin/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/ThrottlePlugin/index.js

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

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

@@ -1,5 +1,5 @@
-import { WaterfallPlugin } from '../../plugins/types';
-type TransitionConfig = {
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type TransitionConfig = {
     /** 过渡时长（ms） */
     duration?: number;
     /** 过渡缓动 */
@@ -10,4 +10,4 @@ type TransitionConfig = {
  * - 为项元素应用 transform/opacity 的过渡，提升布局更新的视觉平滑度
  */
 export declare function createTransitionPlugin<T = any>(config?: TransitionConfig): WaterfallPlugin<T>;
-export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/TransitionPlugin/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,GAAG,EAC5C,MAAM,GAAE,gBAAqB,GAC5B,eAAe,CAAC,CAAC,CAAC,CAsBpB"}

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

@@ -0,0 +1,43 @@
+declare const _default: {
+  "name": "TransitionPlugin",
+  "description": "给每个项挂上 transform + opacity 的 CSS 过渡，布局重排、分页切换、筛选后重新排列时位置变化是滑过去的，不是瞬移。",
+  "since": "2.0.0",
+  "tags": [
+    "perf",
+    "动效"
+  ],
+  "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.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/TransitionPlugin/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,mBAAmB,CAAC;AAEnD;;;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/TransitionPlugin/index.js

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

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

@@ -1,5 +1,5 @@
-import { WaterfallPlugin } from '../../plugins/types';
-type URLSyncConfig = {
+import { WaterfallPlugin } from '../../components/WaterfallPlugin/plugins/types';
+export type URLSyncConfig = {
     /** URL 同步使用 hash 还是 search（默认 hash） */
     mode?: "hash" | "search";
     /** 需要同步的键列表（从 props 读取） */
@@ -11,4 +11,4 @@ type URLSyncConfig = {
  * - 初次挂载时读取 URL 并向 bus 广播（页面可据此设置状态）
  */
 export declare function createURLSyncPlugin<T = any>(config?: URLSyncConfig): WaterfallPlugin<T>;
-export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,41 @@
+declare const _default: {
+  "name": "URLSyncPlugin",
+  "description": "props 变化时把指定键写进 URL（hash 或 search），挂载时读出来广播 `urlsync:init`。刷新与分享都能还原筛选状态。",
+  "since": "2.0.0",
+  "tags": [
+    "ui",
+    "URL",
+    "可分享"
+  ],
+  "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.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom-plugins/URLSyncPlugin/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,mBAAmB,CAAC;AAEnD;;;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/URLSyncPlugin/index.js

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

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

@@ -0,0 +1,61 @@
+/**
+ * vane-waterfall 官方插件（26 个）。
+ *
+ * 分组只是文档口径，实际装配顺序由 priority 决定（越大越先执行）：
+ *   perf 80–65 → layout 100–45 → data 40–10 → interaction / ui 0
+ * 数据管线内部固定为 Filter(40) → Sort(30) → Search(20) → Pagination(10)。
+ *
+ * 单个插件也可以走子路径按需引入：`vane-waterfall/custom-plugins/FilterPlugin`。
+ */
+export { createAlignmentPlugin } from './AlignmentPlugin';
+export type { AlignmentConfig } from './AlignmentPlugin';
+export { createAutoColumnPlugin } from './AutoColumnPlugin';
+export type { AutoColumnConfig } from './AutoColumnPlugin';
+export { createResponsiveColumnsPlugin } from './ResponsiveColumnsPlugin';
+export { createGapPlugin } from './GapPlugin';
+export type { GapConfig } from './GapPlugin';
+export { createFixedHeightPlugin } from './FixedHeightPlugin';
+export type { FixedHeightConfig } from './FixedHeightPlugin';
+export { createPinItemPlugin } from './PinItemPlugin';
+export type { PinItemConfig } from './PinItemPlugin';
+export { createThrottlePlugin } from './ThrottlePlugin';
+export type { ThrottleConfig } from './ThrottlePlugin';
+export { createDebounceLayoutPlugin } from './DebounceLayoutPlugin';
+export type { DebounceConfig } from './DebounceLayoutPlugin';
+export { createReducedMotionPlugin } from './ReducedMotionPlugin';
+export type { ReducedMotionConfig } from './ReducedMotionPlugin';
+export { createTransitionPlugin } from './TransitionPlugin';
+export type { TransitionConfig } from './TransitionPlugin';
+export { createFilterPlugin } from './FilterPlugin';
+export type { FilterConfig } from './FilterPlugin';
+export { createSortPlugin } from './SortPlugin';
+export type { SortConfig } from './SortPlugin';
+export { createSearchPlugin } from './SearchPlugin';
+export type { SearchConfig } from './SearchPlugin';
+export { createPaginationPlugin } from './PaginationPlugin';
+export type { PaginationConfig } from './PaginationPlugin';
+export { createInfiniteScrollPlugin } from './InfiniteScrollPlugin';
+export type { InfiniteScrollConfig } from './InfiniteScrollPlugin';
+export { createClickAnalyticsPlugin } from './ClickAnalyticsPlugin';
+export type { ClickAnalyticsConfig, ClickAnalyticsStats } from './ClickAnalyticsPlugin';
+export { createHeatmapAnalyticsPlugin } from './HeatmapAnalyticsPlugin';
+export type { HeatmapAnalyticsConfig, HeatmapAnalyticsStats } from './HeatmapAnalyticsPlugin';
+export { createDragReorderPlugin } from './DragReorderPlugin';
+export type { DragReorderConfig } from './DragReorderPlugin';
+export { createScrollAnchorPlugin } from './ScrollAnchorPlugin';
+export type { ScrollAnchorConfig } from './ScrollAnchorPlugin';
+export { createRecyclePlugin } from './RecyclePlugin';
+export type { RecycleConfig } from './RecyclePlugin';
+export { createA11yPlugin } from './A11yPlugin';
+export type { A11yConfig } from './A11yPlugin';
+export { createGroupingPlugin } from './GroupingPlugin';
+export type { GroupingConfig } from './GroupingPlugin';
+export { createStickyHeaderPlugin } from './StickyHeaderPlugin';
+export type { StickyHeaderConfig } from './StickyHeaderPlugin';
+export { createBookmarkPlugin } from './BookmarkPlugin';
+export type { BookmarkConfig } from './BookmarkPlugin';
+export { createStatePersistencePlugin } from './StatePersistencePlugin';
+export type { StatePersistenceConfig } from './StatePersistencePlugin';
+export { createURLSyncPlugin } from './URLSyncPlugin';
+export type { URLSyncConfig } from './URLSyncPlugin';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/custom-plugins/index.ts"],"names":[],"mappings":"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"}

package/dist/custom-plugins/index.js

@@ -0,0 +1,34 @@
+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";
+export {
+  T as createA11yPlugin,
+  r as createAlignmentPlugin,
+  P as createAutoColumnPlugin,
+  k as createBookmarkPlugin,
+  x as createClickAnalyticsPlugin,
+  C as createDebounceLayoutPlugin,
+  t as createDragReorderPlugin,
+  y as createFilterPlugin,
+  S as createFixedHeightPlugin,
+  m as createGapPlugin,
+  c as createGroupingPlugin,
+  i as createHeatmapAnalyticsPlugin,
+  p as createInfiniteScrollPlugin,
+  A as createPaginationPlugin,
+  n as createPinItemPlugin,
+  H as createRecyclePlugin,
+  d as createReducedMotionPlugin,
+  b as createResponsiveColumnsPlugin,
+  l as createScrollAnchorPlugin,
+  s as createSearchPlugin,
+  h as createSortPlugin,
+  D as createStatePersistencePlugin,
+  u as createStickyHeaderPlugin,
+  F as createThrottlePlugin,
+  I as createTransitionPlugin,
+  g as createURLSyncPlugin
+};