@visactor/vseed 0.4.28 → 0.5.1

package/dist/esm/pipeline/spec/chart/pipes/animation/bar.d.ts

@@ -0,0 +1,77 @@
+import type { BarLikeAppearConfig, BarLikeLoopConfig, BarLikeUpdateConfig } from './types';
+/**
+ * 柱图/条形图 入场动画
+ * 动画类型:
+ * 1. growth: 生长动画
+ * 效果：横向柱使用宽度增长, 纵向柱使用高度增长。
+ * 编排逻辑：仅作用于 bar mark, 使用 appear 的 easing 和 duration。
+ * 2. load: 加载动画
+ * 效果：使用逐个淡入, 让柱子按图元顺序出现。
+ * 编排逻辑：仅作用于 bar mark, 使用 appear 的 easing 和 duration。
+ * 3. 其他: 默认入场动画
+ * 效果：不指定额外动画 type, 交给 VChart 默认入场补间。
+ * 编排逻辑：仅保留 easing 和 duration。
+ */
+export declare const barAppear: (config: BarLikeAppearConfig | undefined, chartType: string) => false | {
+    bar: {
+        easing: string | undefined;
+        duration: number;
+    };
+};
+/**
+ * 柱图/条形图 更新动画
+ * 动画类型:
+ * 1. moveIn: 移入动画
+ * 效果：update 阶段沿柱图方向从画布外移入。
+ * 编排逻辑：复用移入方向, 但不再补随机 dataKey, 只作用于 bar mark。
+ * 2. 其他: 默认更新动画
+ * 效果：使用 VChart 默认更新补间。
+ * 编排逻辑：只保留 easing 和 duration, 不影响轴、标签等其他组件。
+ */
+export declare const barUpdate: (config: BarLikeUpdateConfig | undefined, chartType: string, spec?: any) => false | {
+    bar: {
+        easing: string | undefined;
+        duration: number;
+    };
+};
+/**
+ * 柱图/条形图 循环动画
+ * 动画类型:
+ * 1. highLight: 分组高亮动画
+ * 效果：按类目分组依次切换高亮填充和描边。
+ * 编排逻辑：startTime = appear 存在 ? interval : 0, loopDuration = groupDuration * groupCount + stopDuration, 一轮结束后等待 interval。
+ * 2. growth/moveIn/load: mark 循环动画
+ * 效果：复用对应的柱图 mark 动画。
+ * 编排逻辑：先执行 loopDuration, 再等待 interval + atmosphereDuration 后重复。
+ * 3. atmosphere: 流光氛围动画
+ * 效果：使用 StreamLight 在柱子上形成流光。
+ * 编排逻辑：延迟 loopDuration 后启动, 持续 atmosphereDuration, 一轮结束后等待 interval。
+ */
+export declare const barLoop: (config: BarLikeLoopConfig | undefined, ignoreFirstNormal: boolean, chartType: string, spec?: any) => false | {
+    bar: any[];
+};
+/**
+ * 柱图/条形图 离场动画
+ * 动画类型:
+ * 1. moveIn: 反向移出动画
+ * 效果：沿柱图进入方向反向移出画布。
+ * 编排逻辑：只有 update 效果为 moveIn 时才补充 moveOut。
+ * 2. 其他: 默认离场动画
+ * 效果：不配置自定义 exit。
+ * 编排逻辑：返回空配置, 由 VChart 默认行为处理。
+ */
+export declare const barExit: (config: BarLikeUpdateConfig | undefined, chartType: string) => false | {
+    bar?: undefined;
+} | {
+    bar: {
+        duration: number;
+        type: string;
+        options: {
+            direction: string;
+            orient: string;
+            point: (_datum: any, element: any, opt: any) => {
+                [x: string]: any;
+            };
+        };
+    };
+};

package/dist/esm/pipeline/spec/chart/pipes/animation/bar.js

@@ -0,0 +1,88 @@
+import { StreamLight } from "@visactor/vchart";
+import { VScreenAnimationType } from "./types.js";
+import { allowAnimation, getPrimaryEffect, toMs } from "./utils/index.js";
+import { fadeInBar, getGroupCountFromSpec, getLoopResult, groupHighLightBar, growBar, isHorizontalBar, moveInBar, moveOutBar, transform2VChartColor } from "./utils/bar.js";
+const barAppear = (config, chartType)=>{
+    if (!allowAnimation(config)) return false;
+    const effect = getPrimaryEffect(config);
+    const configByType = effect === VScreenAnimationType.growth ? growBar(chartType) : effect === VScreenAnimationType.load ? fadeInBar() : {};
+    return {
+        bar: {
+            ...configByType,
+            easing: config?.ease,
+            duration: toMs(config?.duration ?? 1)
+        }
+    };
+};
+const barUpdate = (config, chartType, spec)=>{
+    if (!allowAnimation(config)) return false;
+    const effect = getPrimaryEffect(config);
+    const configByType = effect === VScreenAnimationType.moveIn ? moveInBar(chartType, spec, true) : {};
+    return {
+        bar: {
+            ...configByType,
+            easing: config?.ease,
+            duration: toMs(config?.duration ?? 1)
+        }
+    };
+};
+const barLoop = (config, ignoreFirstNormal, chartType, spec)=>{
+    if (!config?.enable) return false;
+    const interval = config.interval ?? 0;
+    const startTime = ignoreFirstNormal ? toMs(interval) : 0;
+    const loop = config.loop;
+    const atmosphere = config.atmosphere;
+    const loopEffect = getPrimaryEffect(loop);
+    const result = [];
+    let loopDuration = loopEffect === VScreenAnimationType.none ? 0 : 1;
+    const atmosphereDuration = loopEffect === VScreenAnimationType.none ? 2 : 1;
+    if (loopEffect === VScreenAnimationType.highLight && loop) {
+        const groupDuration = 0.7;
+        const stopDuration = 0.85;
+        loopDuration = groupDuration * getGroupCountFromSpec(spec).groupCount + stopDuration;
+        result.push(...groupHighLightBar(startTime, loop, loopDuration, interval, atmosphereDuration, isHorizontalBar(chartType), spec));
+    } else if (loop) result.push({
+        ...getLoopResult(loopEffect, chartType, spec),
+        startTime,
+        easing: loop.ease,
+        duration: toMs(loopDuration),
+        delayAfter: toMs(interval + atmosphereDuration),
+        loop: true,
+        controlOptions: {
+            immediatelyApply: false
+        }
+    });
+    if (atmosphere?.ease || atmosphere?.color) result.push({
+        loop: true,
+        startTime,
+        delay: toMs(loopDuration),
+        delayAfter: toMs(interval),
+        duration: toMs(atmosphereDuration),
+        easing: atmosphere.ease,
+        custom: StreamLight,
+        customParameters: {
+            isHorizontal: isHorizontalBar(chartType),
+            attribute: {
+                fill: transform2VChartColor(atmosphere.color),
+                blur: 0,
+                shadowColor: 'rgba(0,0,0,0)'
+            }
+        }
+    });
+    return result.length > 0 ? {
+        bar: result
+    } : false;
+};
+const barExit = (config, chartType)=>{
+    if (!allowAnimation(config)) return false;
+    if (getPrimaryEffect(config) !== VScreenAnimationType.moveIn) return {};
+    return {
+        bar: {
+            ...moveOutBar(chartType),
+            duration: 1000
+        }
+    };
+};
+export { barAppear, barExit, barLoop, barUpdate };
+
+//# sourceMappingURL=bar.js.map

package/dist/esm/pipeline/spec/chart/pipes/animation/bar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline/spec/chart/pipes/animation/bar.js","sources":["../../../../../../../src/pipeline/spec/chart/pipes/animation/bar.ts"],"sourcesContent":["import { StreamLight } from '@visactor/vchart'\nimport type { BarLikeAppearConfig, BarLikeLoopConfig, BarLikeUpdateConfig } from './types'\nimport { VScreenAnimationType } from './types'\nimport { allowAnimation, getPrimaryEffect, toMs } from './utils'\nimport {\n  fadeInBar,\n  getGroupCountFromSpec,\n  getLoopResult,\n  groupHighLightBar,\n  growBar,\n  isHorizontalBar,\n  moveInBar,\n  moveOutBar,\n  transform2VChartColor,\n} from './utils/bar'\n\n/**\n * 柱图/条形图 入场动画\n * 动画类型:\n * 1. growth: 生长动画\n * 效果：横向柱使用宽度增长, 纵向柱使用高度增长。\n * 编排逻辑：仅作用于 bar mark, 使用 appear 的 easing 和 duration。\n * 2. load: 加载动画\n * 效果：使用逐个淡入, 让柱子按图元顺序出现。\n * 编排逻辑：仅作用于 bar mark, 使用 appear 的 easing 和 duration。\n * 3. 其他: 默认入场动画\n * 效果：不指定额外动画 type, 交给 VChart 默认入场补间。\n * 编排逻辑：仅保留 easing 和 duration。\n */\nexport const barAppear = (config: BarLikeAppearConfig | undefined, chartType: string) => {\n  if (!allowAnimation(config)) return false\n  const effect = getPrimaryEffect(config)\n  const configByType =\n    effect === VScreenAnimationType.growth\n      ? growBar(chartType)\n      : effect === VScreenAnimationType.load\n        ? fadeInBar()\n        : {}\n  return { bar: { ...configByType, easing: config?.ease, duration: toMs(config?.duration ?? 1) } }\n}\n\n/**\n * 柱图/条形图 更新动画\n * 动画类型:\n * 1. moveIn: 移入动画\n * 效果：update 阶段沿柱图方向从画布外移入。\n * 编排逻辑：复用移入方向, 但不再补随机 dataKey, 只作用于 bar mark。\n * 2. 其他: 默认更新动画\n * 效果：使用 VChart 默认更新补间。\n * 编排逻辑：只保留 easing 和 duration, 不影响轴、标签等其他组件。\n */\nexport const barUpdate = (config: BarLikeUpdateConfig | undefined, chartType: string, spec?: any) => {\n  if (!allowAnimation(config)) return false\n  const effect = getPrimaryEffect(config)\n  const configByType = effect === VScreenAnimationType.moveIn ? moveInBar(chartType, spec, true) : {}\n  return { bar: { ...configByType, easing: config?.ease, duration: toMs(config?.duration ?? 1) } }\n}\n\n/**\n * 柱图/条形图 循环动画\n * 动画类型:\n * 1. highLight: 分组高亮动画\n * 效果：按类目分组依次切换高亮填充和描边。\n * 编排逻辑：startTime = appear 存在 ? interval : 0, loopDuration = groupDuration * groupCount + stopDuration, 一轮结束后等待 interval。\n * 2. growth/moveIn/load: mark 循环动画\n * 效果：复用对应的柱图 mark 动画。\n * 编排逻辑：先执行 loopDuration, 再等待 interval + atmosphereDuration 后重复。\n * 3. atmosphere: 流光氛围动画\n * 效果：使用 StreamLight 在柱子上形成流光。\n * 编排逻辑：延迟 loopDuration 后启动, 持续 atmosphereDuration, 一轮结束后等待 interval。\n */\nexport const barLoop = (\n  config: BarLikeLoopConfig | undefined,\n  ignoreFirstNormal: boolean,\n  chartType: string,\n  spec?: any,\n) => {\n  if (!config?.enable) return false\n  const interval = config.interval ?? 0\n  const startTime = ignoreFirstNormal ? toMs(interval) : 0\n  const loop = config.loop\n  const atmosphere = config.atmosphere\n  const loopEffect = getPrimaryEffect(loop)\n  const result: any[] = []\n  let loopDuration = loopEffect === VScreenAnimationType.none ? 0 : 1\n  const atmosphereDuration = loopEffect === VScreenAnimationType.none ? 2 : 1\n\n  if (loopEffect === VScreenAnimationType.highLight && loop) {\n    const groupDuration = 0.7\n    const stopDuration = 0.85\n    loopDuration = groupDuration * getGroupCountFromSpec(spec).groupCount + stopDuration\n    result.push(\n      ...groupHighLightBar(\n        startTime,\n        loop,\n        loopDuration,\n        interval,\n        atmosphereDuration,\n        isHorizontalBar(chartType),\n        spec,\n      ),\n    )\n  } else if (loop) {\n    result.push({\n      ...getLoopResult(loopEffect, chartType, spec),\n      startTime,\n      easing: loop.ease,\n      duration: toMs(loopDuration),\n      delayAfter: toMs(interval + atmosphereDuration),\n      loop: true,\n      controlOptions: { immediatelyApply: false },\n    })\n  }\n\n  if (atmosphere?.ease || atmosphere?.color) {\n    result.push({\n      loop: true,\n      startTime,\n      delay: toMs(loopDuration),\n      delayAfter: toMs(interval),\n      duration: toMs(atmosphereDuration),\n      easing: atmosphere.ease,\n      custom: StreamLight,\n      customParameters: {\n        isHorizontal: isHorizontalBar(chartType),\n        attribute: {\n          fill: transform2VChartColor(atmosphere.color),\n          blur: 0,\n          shadowColor: 'rgba(0,0,0,0)',\n        },\n      },\n    })\n  }\n\n  return result.length > 0 ? { bar: result } : false\n}\n\n/**\n * 柱图/条形图 离场动画\n * 动画类型:\n * 1. moveIn: 反向移出动画\n * 效果：沿柱图进入方向反向移出画布。\n * 编排逻辑：只有 update 效果为 moveIn 时才补充 moveOut。\n * 2. 其他: 默认离场动画\n * 效果：不配置自定义 exit。\n * 编排逻辑：返回空配置, 由 VChart 默认行为处理。\n */\nexport const barExit = (config: BarLikeUpdateConfig | undefined, chartType: string) => {\n  if (!allowAnimation(config)) return false\n  if (getPrimaryEffect(config) !== VScreenAnimationType.moveIn) return {}\n  return { bar: { ...moveOutBar(chartType), duration: 1000 } }\n}\n"],"names":["barAppear","config","chartType","allowAnimation","effect","getPrimaryEffect","configByType","VScreenAnimationType","growBar","fadeInBar","toMs","barUpdate","spec","moveInBar","barLoop","ignoreFirstNormal","interval","startTime","loop","atmosphere","loopEffect","result","loopDuration","atmosphereDuration","groupDuration","stopDuration","getGroupCountFromSpec","groupHighLightBar","isHorizontalBar","getLoopResult","StreamLight","transform2VChartColor","barExit","moveOutBar"],"mappings":";;;;AA6BO,MAAMA,YAAY,CAACC,QAAyCC;IACjE,IAAI,CAACC,eAAeF,SAAS,OAAO;IACpC,MAAMG,SAASC,iBAAiBJ;IAChC,MAAMK,eACJF,WAAWG,qBAAqB,MAAM,GAClCC,QAAQN,aACRE,WAAWG,qBAAqB,IAAI,GAClCE,cACA,CAAC;IACT,OAAO;QAAE,KAAK;YAAE,GAAGH,YAAY;YAAE,QAAQL,QAAQ;YAAM,UAAUS,KAAKT,QAAQ,YAAY;QAAG;IAAE;AACjG;AAYO,MAAMU,YAAY,CAACV,QAAyCC,WAAmBU;IACpF,IAAI,CAACT,eAAeF,SAAS,OAAO;IACpC,MAAMG,SAASC,iBAAiBJ;IAChC,MAAMK,eAAeF,WAAWG,qBAAqB,MAAM,GAAGM,UAAUX,WAAWU,MAAM,QAAQ,CAAC;IAClG,OAAO;QAAE,KAAK;YAAE,GAAGN,YAAY;YAAE,QAAQL,QAAQ;YAAM,UAAUS,KAAKT,QAAQ,YAAY;QAAG;IAAE;AACjG;AAeO,MAAMa,UAAU,CACrBb,QACAc,mBACAb,WACAU;IAEA,IAAI,CAACX,QAAQ,QAAQ,OAAO;IAC5B,MAAMe,WAAWf,OAAO,QAAQ,IAAI;IACpC,MAAMgB,YAAYF,oBAAoBL,KAAKM,YAAY;IACvD,MAAME,OAAOjB,OAAO,IAAI;IACxB,MAAMkB,aAAalB,OAAO,UAAU;IACpC,MAAMmB,aAAaf,iBAAiBa;IACpC,MAAMG,SAAgB,EAAE;IACxB,IAAIC,eAAeF,eAAeb,qBAAqB,IAAI,GAAG,IAAI;IAClE,MAAMgB,qBAAqBH,eAAeb,qBAAqB,IAAI,GAAG,IAAI;IAE1E,IAAIa,eAAeb,qBAAqB,SAAS,IAAIW,MAAM;QACzD,MAAMM,gBAAgB;QACtB,MAAMC,eAAe;QACrBH,eAAeE,gBAAgBE,sBAAsBd,MAAM,UAAU,GAAGa;QACxEJ,OAAO,IAAI,IACNM,kBACDV,WACAC,MACAI,cACAN,UACAO,oBACAK,gBAAgB1B,YAChBU;IAGN,OAAO,IAAIM,MACTG,OAAO,IAAI,CAAC;QACV,GAAGQ,cAAcT,YAAYlB,WAAWU,KAAK;QAC7CK;QACA,QAAQC,KAAK,IAAI;QACjB,UAAUR,KAAKY;QACf,YAAYZ,KAAKM,WAAWO;QAC5B,MAAM;QACN,gBAAgB;YAAE,kBAAkB;QAAM;IAC5C;IAGF,IAAIJ,YAAY,QAAQA,YAAY,OAClCE,OAAO,IAAI,CAAC;QACV,MAAM;QACNJ;QACA,OAAOP,KAAKY;QACZ,YAAYZ,KAAKM;QACjB,UAAUN,KAAKa;QACf,QAAQJ,WAAW,IAAI;QACvB,QAAQW;QACR,kBAAkB;YAChB,cAAcF,gBAAgB1B;YAC9B,WAAW;gBACT,MAAM6B,sBAAsBZ,WAAW,KAAK;gBAC5C,MAAM;gBACN,aAAa;YACf;QACF;IACF;IAGF,OAAOE,OAAO,MAAM,GAAG,IAAI;QAAE,KAAKA;IAAO,IAAI;AAC/C;AAYO,MAAMW,UAAU,CAAC/B,QAAyCC;IAC/D,IAAI,CAACC,eAAeF,SAAS,OAAO;IACpC,IAAII,iBAAiBJ,YAAYM,qBAAqB,MAAM,EAAE,OAAO,CAAC;IACtE,OAAO;QAAE,KAAK;YAAE,GAAG0B,WAAW/B,UAAU;YAAE,UAAU;QAAK;IAAE;AAC7D"}

package/dist/esm/pipeline/spec/chart/pipes/animation/index.d.ts

@@ -0,0 +1,2 @@
+export * from './animation';
+export * from './types';

package/dist/esm/pipeline/spec/chart/pipes/animation/index.js

@@ -0,0 +1,2 @@
+export * from "./animation.js";
+export * from "./types.js";

package/dist/esm/pipeline/spec/chart/pipes/animation/lineOrArea.d.ts

@@ -0,0 +1,254 @@
+import type { LineAreaAppearConfig, LineAreaLoopConfig, LineAreaUpdateConfig } from './types';
+import { StreamLight } from '@visactor/vchart';
+/**
+ * 折线图/面积图/百分比面积图 入场动画
+ * 动画类型:
+ * 1. growth: 生长动画
+ * 效果：line/area 使用路径增长, point 使用顶部移入。
+ * 编排逻辑：line、area、point 共用 appear 的 easing 和 duration。
+ * 2. load: 加载动画
+ * 效果：line/area 使用整体裁剪进入, point 不额外配置进入方式。
+ * 编排逻辑：line、area、point 共用 appear 的 easing 和 duration。
+ */
+export declare const lineOrAreaAppear: (config: LineAreaAppearConfig | undefined) => false | {
+    line: {
+        easing: string | undefined;
+        duration: number;
+    };
+    area: {
+        easing: string | undefined;
+        duration: number;
+    };
+    point: {
+        easing: string | undefined;
+        duration: number;
+    };
+};
+/**
+ * 折线图/面积图/百分比面积图 循环动画
+ * 动画类型:
+ * 1. growth/load: 线面 loop 动画
+ * 效果：line/area 执行路径增长或整体裁剪。
+ * 编排逻辑：startTime = appear 存在 ? interval : 0, 有 loop 时 loopDuration = 1s, 执行后等待 interval + atmosphereDuration。
+ * 2. atmosphere: 线面流光氛围动画
+ * 效果：line/area 使用 StreamLight 形成流光。
+ * 编排逻辑：延迟 loopDuration 后启动, 持续 atmosphereDuration, 一轮结束后等待 interval。
+ * 3. atmospherePoint: 点氛围动画
+ * 效果：point 执行 breath/reveal/ripple 等氛围效果。
+ * 编排逻辑：和整轮时间线同步, 一轮结束后等待 interval + atmosphereDuration。
+ */
+export declare const lineOrAreaLoop: (config: LineAreaLoopConfig | undefined, ignoreFirstNormal: boolean) => false | {
+    line: ({
+        loop: boolean;
+        startTime: number;
+        delay: number;
+        delayAfter: number;
+        duration: number;
+        easing: string | undefined;
+        custom: typeof StreamLight;
+        customParameters: (...args: any[]) => {
+            streamLength: number;
+            attribute: {
+                stroke: string | {
+                    gradient: string;
+                    x0: number;
+                    x1: number;
+                    y1: number;
+                    y0: number;
+                    stops: {
+                        offset: number;
+                        color: string;
+                    }[];
+                } | undefined;
+                strokeOpacity: number;
+                lineWidth: any;
+            };
+        };
+    } | {
+        startTime: number;
+        easing: string;
+        duration: number;
+        delayAfter: number;
+        loop: boolean;
+        controlOptions: {
+            immediatelyApply: boolean;
+        };
+        type: string;
+        options: {
+            orient: string;
+        };
+    } | {
+        startTime: number;
+        easing: string;
+        duration: number;
+        delayAfter: number;
+        loop: boolean;
+        controlOptions: {
+            immediatelyApply: boolean;
+        };
+        type: string;
+        oneByOne: boolean;
+    })[];
+    area: ({
+        loop: boolean;
+        startTime: number;
+        delay: number;
+        delayAfter: number;
+        duration: number;
+        easing: string | undefined;
+        custom: typeof StreamLight;
+        customParameters: (...args: any[]) => {
+            streamLength: number;
+            attribute: {
+                stroke: string | {
+                    gradient: string;
+                    x0: number;
+                    x1: number;
+                    y1: number;
+                    y0: number;
+                    stops: {
+                        offset: number;
+                        color: string;
+                    }[];
+                } | undefined;
+                strokeOpacity: number;
+                lineWidth: any;
+            };
+        };
+    } | {
+        startTime: number;
+        easing: string;
+        duration: number;
+        delayAfter: number;
+        loop: boolean;
+        controlOptions: {
+            immediatelyApply: boolean;
+        };
+        type: string;
+        options: {
+            orient: string;
+        };
+    } | {
+        startTime: number;
+        easing: string;
+        duration: number;
+        delayAfter: number;
+        loop: boolean;
+        controlOptions: {
+            immediatelyApply: boolean;
+        };
+        type: string;
+        oneByOne: boolean;
+    })[];
+    point: ({
+        channel?: undefined;
+        loop: boolean;
+        startTime: number;
+        delayAfter: number;
+        duration: number;
+        easing: string | undefined;
+    } | {
+        channel: {
+            scaleX: {
+                from: number;
+                to: number;
+            };
+            scaleY: {
+                from: number;
+                to: number;
+            };
+            fillOpacity?: undefined;
+            strokeOpacity?: undefined;
+            outerBorder?: undefined;
+        };
+        loop: boolean;
+        startTime: number;
+        delayAfter: number;
+        duration: number;
+        easing: string | undefined;
+    } | {
+        channel: {
+            fillOpacity: {
+                from: number;
+                to: number;
+            };
+            strokeOpacity: {
+                from: number;
+                to: number;
+            };
+            scaleX?: undefined;
+            scaleY?: undefined;
+            outerBorder?: undefined;
+        };
+        loop: boolean;
+        startTime: number;
+        delayAfter: number;
+        duration: number;
+        easing: string | undefined;
+    } | {
+        channel: {
+            outerBorder: {
+                from: {
+                    distance: number;
+                    strokeOpacity: number;
+                };
+                to: (...args: any[]) => {
+                    distance: number;
+                    strokeOpacity: number;
+                    stroke: any;
+                };
+            };
+            scaleX?: undefined;
+            scaleY?: undefined;
+            fillOpacity?: undefined;
+            strokeOpacity?: undefined;
+        };
+        loop: boolean;
+        startTime: number;
+        delayAfter: number;
+        duration: number;
+        easing: string | undefined;
+    })[];
+};
+/**
+ * 折线图/面积图/百分比面积图 更新动画
+ * 动画类型:
+ * 1. default: 默认更新动画
+ * 效果：使用 VChart 默认补间覆盖数据更新、点位变化和面积路径变化。
+ * 编排逻辑：line、area、point 共用 update 的 easing 和 duration。
+ */
+export declare const lineOrAreaUpdate: (config: LineAreaUpdateConfig | undefined) => false | {
+    line: {
+        easing: string | undefined;
+        duration: number;
+    };
+    area: {
+        easing: string | undefined;
+        duration: number;
+    };
+    point: {
+        easing: string | undefined;
+        duration: number;
+    };
+};
+/**
+ * 折线图/面积图/百分比面积图 离场动画
+ * 动画类型:
+ * 1. default: 默认离场动画
+ * 效果：使用 VChart 默认补间完成 line、area、point 离场。
+ * 编排逻辑：line、area、point 共用 exit 的 easing 和 duration, 保持节奏一致。
+ */
+export declare const lineOrAreaExit: (config: LineAreaUpdateConfig | undefined) => false | {
+    line: {
+        easing: string | undefined;
+        duration: number;
+    };
+    point: {
+        easing: string | undefined;
+        duration: number;
+    };
+    area: {
+        easing: string | undefined;
+        duration: number;
+    };
+};

package/dist/esm/pipeline/spec/chart/pipes/animation/lineOrArea.js

@@ -0,0 +1,138 @@
+import { VScreenAnimationType } from "./types.js";
+import { allowLineOrAreaAnimation, atmospherePoint } from "./utils/index.js";
+import { transform2VChartColor } from "./utils/bar.js";
+import { clipInLine, growthTopLine, growthTopPoint } from "./utils/lineOrArea.js";
+import { StreamLight } from "@visactor/vchart";
+const lineOrAreaAppear = (config)=>{
+    if (!config || !allowLineOrAreaAnimation(config)) return false;
+    const { effects, ease, duration } = config;
+    const effect = effects?.[0];
+    const durationMs = (duration ?? 1) * 1000;
+    let lineOrAreaConfigByType = {};
+    let pointConfigByType = {};
+    if (effect === VScreenAnimationType.growth) {
+        lineOrAreaConfigByType = growthTopLine();
+        pointConfigByType = growthTopPoint();
+    } else if (effect === VScreenAnimationType.load) lineOrAreaConfigByType = clipInLine();
+    return {
+        line: {
+            ...lineOrAreaConfigByType,
+            easing: ease,
+            duration: durationMs
+        },
+        area: {
+            ...lineOrAreaConfigByType,
+            easing: ease,
+            duration: durationMs
+        },
+        point: {
+            ...pointConfigByType,
+            easing: ease,
+            duration: durationMs
+        }
+    };
+};
+const lineOrAreaLoop = (config, ignoreFirstNormal)=>{
+    if (!config?.enable) return false;
+    const { loop, atmosphere, interval = 5 } = config;
+    const totalDuration = 2;
+    const startTime = ignoreFirstNormal ? 1000 * interval : 0;
+    const lineOrAreaResult = [];
+    const pointResult = [];
+    const { effects: loopEffects = [], ease: loopEase = 'linear' } = loop ?? {};
+    const loopEffect = loopEffects[0] ?? VScreenAnimationType.none;
+    const loopDuration = loopEffect === VScreenAnimationType.none ? 0 : totalDuration / 2;
+    const atmosphereDuration = loopEffect === VScreenAnimationType.none ? totalDuration : totalDuration / 2;
+    const timeLineConfig = {
+        startTime,
+        easing: loopEase,
+        duration: 1000 * loopDuration,
+        delayAfter: (interval + atmosphereDuration) * 1000,
+        loop: true,
+        controlOptions: {
+            immediatelyApply: false
+        }
+    };
+    if (loopEffect === VScreenAnimationType.growth) lineOrAreaResult.push({
+        ...growthTopLine(),
+        ...timeLineConfig
+    });
+    else if (loopEffect === VScreenAnimationType.load) lineOrAreaResult.push({
+        ...clipInLine(),
+        ...timeLineConfig
+    });
+    const { ease: atmosphereEase, effect: atmosphereEffect, color: atmosphereColor } = atmosphere ?? {};
+    const atmosphereLineOrAreaResult = {
+        loop: true,
+        startTime,
+        delay: 1000 * loopDuration,
+        delayAfter: 1000 * interval,
+        duration: 1000 * atmosphereDuration,
+        easing: atmosphereEase,
+        custom: StreamLight,
+        customParameters: (...args)=>({
+                streamLength: 20,
+                attribute: {
+                    stroke: transform2VChartColor(atmosphereColor),
+                    strokeOpacity: 0.8,
+                    lineWidth: args[1].attribute?.lineWidth ?? 1
+                }
+            })
+    };
+    lineOrAreaResult.push(atmosphereLineOrAreaResult);
+    const atmospherePointResult = {
+        loop: true,
+        startTime,
+        delayAfter: (interval + atmosphereDuration) * 1000,
+        duration: 1000 * atmosphereDuration,
+        easing: atmosphereEase,
+        ...atmospherePoint(atmosphereEffect)
+    };
+    pointResult.push(atmospherePointResult);
+    return {
+        line: lineOrAreaResult,
+        area: lineOrAreaResult,
+        point: pointResult
+    };
+};
+const lineOrAreaUpdate = (config)=>{
+    if (!config || !allowLineOrAreaAnimation(config)) return false;
+    const { ease, duration } = config;
+    const durationMs = (duration ?? 1) * 1000;
+    return {
+        line: {
+            easing: ease,
+            duration: durationMs
+        },
+        area: {
+            easing: ease,
+            duration: durationMs
+        },
+        point: {
+            easing: ease,
+            duration: durationMs
+        }
+    };
+};
+const lineOrAreaExit = (config)=>{
+    if (!config || !allowLineOrAreaAnimation(config)) return false;
+    const { ease, duration } = config;
+    const durationMs = (duration ?? 1) * 1000;
+    return {
+        line: {
+            easing: ease,
+            duration: durationMs
+        },
+        point: {
+            easing: ease,
+            duration: durationMs
+        },
+        area: {
+            easing: ease,
+            duration: durationMs
+        }
+    };
+};
+export { lineOrAreaAppear, lineOrAreaExit, lineOrAreaLoop, lineOrAreaUpdate };
+
+//# sourceMappingURL=lineOrArea.js.map

package/dist/esm/pipeline/spec/chart/pipes/animation/lineOrArea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline/spec/chart/pipes/animation/lineOrArea.js","sources":["../../../../../../../src/pipeline/spec/chart/pipes/animation/lineOrArea.ts"],"sourcesContent":["import type { LineAreaAppearConfig, LineAreaLoopConfig, LineAreaUpdateConfig } from './types'\nimport { VScreenAnimationType } from './types'\nimport { allowLineOrAreaAnimation, atmospherePoint } from './utils'\nimport { transform2VChartColor } from './utils/bar'\nimport { clipInLine, growthTopLine, growthTopPoint } from './utils/lineOrArea'\nimport { StreamLight } from '@visactor/vchart'\n\n/**\n * 折线图/面积图/百分比面积图 入场动画\n * 动画类型:\n * 1. growth: 生长动画\n * 效果：line/area 使用路径增长, point 使用顶部移入。\n * 编排逻辑：line、area、point 共用 appear 的 easing 和 duration。\n * 2. load: 加载动画\n * 效果：line/area 使用整体裁剪进入, point 不额外配置进入方式。\n * 编排逻辑：line、area、point 共用 appear 的 easing 和 duration。\n */\nexport const lineOrAreaAppear = (config: LineAreaAppearConfig | undefined) => {\n  if (!config || !allowLineOrAreaAnimation(config)) {\n    return false\n  }\n  const { effects, ease, duration } = config\n  const effect = effects?.[0]\n  const durationMs = (duration ?? 1) * 1000\n\n  let lineOrAreaConfigByType = {}\n  let pointConfigByType = {}\n  if (effect === VScreenAnimationType.growth) {\n    lineOrAreaConfigByType = growthTopLine()\n    pointConfigByType = growthTopPoint()\n  } else if (effect === VScreenAnimationType.load) {\n    lineOrAreaConfigByType = clipInLine()\n  }\n  return {\n    line: {\n      ...lineOrAreaConfigByType,\n      easing: ease,\n      duration: durationMs,\n    },\n    area: {\n      ...lineOrAreaConfigByType,\n      easing: ease,\n      duration: durationMs,\n    },\n    point: {\n      ...pointConfigByType,\n      easing: ease,\n      duration: durationMs,\n    },\n  }\n}\n\n/**\n * 折线图/面积图/百分比面积图 循环动画\n * 动画类型:\n * 1. growth/load: 线面 loop 动画\n * 效果：line/area 执行路径增长或整体裁剪。\n * 编排逻辑：startTime = appear 存在 ? interval : 0, 有 loop 时 loopDuration = 1s, 执行后等待 interval + atmosphereDuration。\n * 2. atmosphere: 线面流光氛围动画\n * 效果：line/area 使用 StreamLight 形成流光。\n * 编排逻辑：延迟 loopDuration 后启动, 持续 atmosphereDuration, 一轮结束后等待 interval。\n * 3. atmospherePoint: 点氛围动画\n * 效果：point 执行 breath/reveal/ripple 等氛围效果。\n * 编排逻辑：和整轮时间线同步, 一轮结束后等待 interval + atmosphereDuration。\n */\nexport const lineOrAreaLoop = (config: LineAreaLoopConfig | undefined, ignoreFirstNormal: boolean) => {\n  if (!config?.enable) {\n    return false\n  }\n  const { loop, atmosphere, interval = 5 } = config\n  const totalDuration = 2\n  // const startTime = 0\n  const startTime = ignoreFirstNormal ? interval * 1000 : 0\n  const lineOrAreaResult = []\n  const pointResult = []\n\n  // 轮播动画\n  const { effects: loopEffects = [], ease: loopEase = 'linear' } = loop ?? {}\n  const loopEffect = loopEffects[0] ?? VScreenAnimationType.none\n\n  const loopDuration = loopEffect === VScreenAnimationType.none ? 0 : totalDuration / 2\n  const atmosphereDuration = loopEffect === VScreenAnimationType.none ? totalDuration : totalDuration / 2\n\n  const timeLineConfig = {\n    startTime,\n    easing: loopEase,\n    duration: loopDuration * 1000,\n    delayAfter: (interval + atmosphereDuration) * 1000,\n    loop: true,\n    controlOptions: {\n      immediatelyApply: false,\n    },\n  }\n  if (loopEffect === VScreenAnimationType.growth) {\n    lineOrAreaResult.push({\n      ...growthTopLine(),\n      ...timeLineConfig,\n    })\n  } else if (loopEffect === VScreenAnimationType.load) {\n    lineOrAreaResult.push({\n      ...clipInLine(),\n      ...timeLineConfig,\n    })\n  }\n  // point loop动画只能在appear中生效\n\n  // 氛围动画\n  const { ease: atmosphereEase, effect: atmosphereEffect, color: atmosphereColor } = atmosphere ?? {}\n\n  const atmosphereLineOrAreaResult = {\n    loop: true,\n    startTime,\n    delay: loopDuration * 1000,\n    delayAfter: interval * 1000,\n    duration: atmosphereDuration * 1000,\n    easing: atmosphereEase,\n    custom: StreamLight,\n    customParameters: (...args: any[]) => {\n      return {\n        streamLength: 20,\n        attribute: {\n          stroke: transform2VChartColor(atmosphereColor),\n          strokeOpacity: 0.8,\n          lineWidth: args[1].attribute?.lineWidth ?? 1,\n        },\n      }\n    },\n  }\n  lineOrAreaResult.push(atmosphereLineOrAreaResult)\n\n  // 虽然是氛围动画, 但时机跟随折线loop动画\n  const atmospherePointResult = {\n    loop: true,\n    startTime,\n    delayAfter: (interval + atmosphereDuration) * 1000,\n    duration: atmosphereDuration * 1000,\n    easing: atmosphereEase,\n    ...atmospherePoint(atmosphereEffect),\n  }\n\n  pointResult.push(atmospherePointResult)\n\n  return {\n    line: lineOrAreaResult,\n    area: lineOrAreaResult,\n    point: pointResult,\n  }\n}\n\n/**\n * 折线图/面积图/百分比面积图 更新动画\n * 动画类型:\n * 1. default: 默认更新动画\n * 效果：使用 VChart 默认补间覆盖数据更新、点位变化和面积路径变化。\n * 编排逻辑：line、area、point 共用 update 的 easing 和 duration。\n */\nexport const lineOrAreaUpdate = (config: LineAreaUpdateConfig | undefined) => {\n  if (!config || !allowLineOrAreaAnimation(config)) {\n    return false\n  }\n  const { ease, duration } = config\n  const durationMs = (duration ?? 1) * 1000\n\n  // 用图表库默认的补间效果\n  return {\n    line: {\n      easing: ease,\n      duration: durationMs,\n    },\n    area: {\n      easing: ease,\n      duration: durationMs,\n    },\n    point: {\n      easing: ease,\n      duration: durationMs,\n    },\n  }\n}\n\n/**\n * 折线图/面积图/百分比面积图 离场动画\n * 动画类型:\n * 1. default: 默认离场动画\n * 效果：使用 VChart 默认补间完成 line、area、point 离场。\n * 编排逻辑：line、area、point 共用 exit 的 easing 和 duration, 保持节奏一致。\n */\nexport const lineOrAreaExit = (config: LineAreaUpdateConfig | undefined) => {\n  if (!config || !allowLineOrAreaAnimation(config)) {\n    return false\n  }\n  const { ease, duration } = config\n  const durationMs = (duration ?? 1) * 1000\n  return {\n    line: {\n      easing: ease,\n      duration: durationMs,\n    },\n    point: {\n      easing: ease,\n      duration: durationMs,\n    },\n    area: {\n      easing: ease,\n      duration: durationMs,\n    },\n  }\n}\n"],"names":["lineOrAreaAppear","config","allowLineOrAreaAnimation","effects","ease","duration","effect","durationMs","lineOrAreaConfigByType","pointConfigByType","VScreenAnimationType","growthTopLine","growthTopPoint","clipInLine","lineOrAreaLoop","ignoreFirstNormal","loop","atmosphere","interval","totalDuration","startTime","lineOrAreaResult","pointResult","loopEffects","loopEase","loopEffect","loopDuration","atmosphereDuration","timeLineConfig","atmosphereEase","atmosphereEffect","atmosphereColor","atmosphereLineOrAreaResult","StreamLight","args","transform2VChartColor","atmospherePointResult","atmospherePoint","lineOrAreaUpdate","lineOrAreaExit"],"mappings":"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"}

package/dist/esm/pipeline/spec/chart/pipes/animation/pie.d.ts

@@ -0,0 +1,71 @@
+import { type PieLikeAppearConfig, type PieLikeLoopConfig, type PieLikeUpdateConfig } from './types';
+/**
+ * 饼图/环图/玫瑰图 入场动画
+ * 动画类型:
+ * 1. radial: 角度展开动画
+ * 效果：pie/rose 按扇区角度展开。
+ * 编排逻辑：pie/rose 同步使用 growAngleIn, rose 额外补 preset = growAngle。
+ * 2. scale: 半径展开动画
+ * 效果：pie/rose 按半径从内向外展开。
+ * 编排逻辑：pie/rose 同步使用 growRadiusIn, 共用 appear 的 easing 和 duration。
+ */
+export declare const pieAppear: (config: PieLikeAppearConfig | undefined, chartType: string) => any;
+/**
+ * 饼图/环图/玫瑰图 更新动画
+ * 动画类型:
+ * 1. default: 默认更新动画
+ * 效果：pie/rose 使用 VChart 默认补间。
+ * 编排逻辑：不指定角度或半径动画, 避免和 normal 阶段的通道动画冲突。
+ */
+export declare const pieUpdate: (config: PieLikeUpdateConfig | undefined) => false | {
+    pie: {
+        easing: string | undefined;
+        duration: number;
+    };
+    rose: {
+        easing: string | undefined;
+        duration: number;
+    };
+};
+/**
+ * 饼图/环图/玫瑰图 新数据进入动画
+ * 动画类型:
+ * 1. default: 默认 enter 动画
+ * 效果：新数据使用 VChart 默认 enter 补间。
+ * 编排逻辑：pie/rose 共用 update 的 easing 和 duration。
+ * 2. enlarge + rose: 淡入 enter 动画
+ * 效果：rose 新数据使用 fadeIn。
+ * 编排逻辑：当 normal 的 loop 效果为 enlarge 时启用, 避免 enter 和 enlarge 同时争用 outerRadius 通道。
+ */
+export declare const pieEnter: (config: PieLikeUpdateConfig | undefined, atmosphereConfig: PieLikeLoopConfig | undefined) => false | {
+    pie: {
+        easing: string | undefined;
+        duration: number;
+    };
+    rose: {
+        easing: string | undefined;
+        duration: number;
+    };
+};
+/**
+ * 饼图/环图/玫瑰图 循环动画
+ * 动画类型:
+ * 1. enlarge: 半径放大动画
+ * 效果：扇区 outerRadius 放大 10px 后恢复。
+ * 编排逻辑：startTime = appear 存在 ? interval : 0, 前半段放大, 后半段恢复, oneByOne 错峰执行。
+ * 2. relocate: 扇区偏移动画
+ * 效果：扇区沿中心角方向向外偏移后恢复。
+ * 编排逻辑：前半段计算 x/y 偏移, 后半段回到原始 x/y, 一轮结束后等待 interval。
+ */
+export declare const pieLoop: (config: PieLikeLoopConfig | undefined, ignoreFirstNormal: boolean) => false | {
+    pie: {};
+    rose: {};
+};
+/**
+ * 饼图/环图/玫瑰图 离场动画
+ * 动画类型:
+ * 1. none: 无离场动画
+ * 效果：不配置自定义 exit。
+ * 编排逻辑：返回 false, 关闭该阶段动画配置。
+ */
+export declare const pieExit: () => boolean;