fix(vchart): fix mark state persistence issue during updateSpec

common/changes/@visactor/vchart/feat-fix-issue-of-mark-state-when-updateSpec_2026-03-17-06-14.json

@@ -0,0 +1,11 @@
+{
+  "changes": [
+    {
+      "comment": "update changes for 009-fix-issue-of-mark-state-when-updateSpec: Fix an issue where mark states were not properly cleared when updateSpec was called, causing incorrect state persistence.",
+      "type": "none",
+      "packageName": "@visactor/vchart"
+    }
+  ],
+  "packageName": "@visactor/vchart",
+  "email": "lixuef1313@163.com"
+}

packages/vchart/src/compile/mark/interface.ts

@@ -64,6 +64,7 @@ export interface IMarkStateManager {
   addStateInfo: (stateInfo: IStateInfo) => void;
   changeStateInfo: (stateInfo: Partial<IStateInfo>) => void;
   clearStateInfo: (stateValues: StateValue[]) => void;
+  clearAllStateInfo: () => void;
   checkOneState: (renderNode: IMarkGraphic, datum: Datum[], state: IStateInfo) => 'in' | 'out' | 'skip';
   checkState: (renderNode: IMarkGraphic, datum: Datum[]) => StateValue[];
   getStateMap: () => StateValueMap;

packages/vchart/src/compile/mark/mark-state-manager.ts

@@ -123,6 +123,10 @@ export class MarkStateManager extends StateManager implements IMarkStateManager
     });
   }
 
+  clearAllStateInfo() {
+    this._stateInfoList = [];
+  }
+
   protected _isMultiMark() {
     return !this._mark || isMultiDatumMark(this._mark.type as MarkTypeEnum);
   }

packages/vchart/src/mark/base/base-mark.ts

@@ -1087,7 +1087,11 @@ export class BaseMark<T extends ICommonSpec> extends GrammarItem implements IMar
       return;
     }
     this._product = mark.getProduct();
+    this._product.clearStates();
     this._graphics = mark.getGraphics();
+    this._graphics.forEach(g => {
+      g.clearStates();
+    });
     this._graphicMap = (mark as any)._graphicMap;
 
     this._graphicMap.forEach(g => {
@@ -2056,4 +2060,13 @@ export class BaseMark<T extends ICommonSpec> extends GrammarItem implements IMar
   runAnimation() {
     this._runStateAnimation(this.getGraphics());
   }
+
+  clearBeforeReInit() {
+    this.state.clearAllStateInfo();
+    this.uncommit();
+    this.stateStyle = {};
+    this.getGraphics().forEach(g => {
+      g.clearStates();
+    });
+  }
 }

packages/vchart/src/mark/interface/common.ts

@@ -246,6 +246,8 @@ export interface IMarkRaw<T extends ICommonSpec> extends ICompilableMark {
   disableAnimationByState: (state: string | string[]) => void;
   /** 启用状态动画 */
   enableAnimationByState: (state: string | string[]) => void;
+  /** 重新加载前清除缓存 */
+  clearBeforeReInit: () => void;
 }
 
 export type IMark = IMarkRaw<ICommonSpec>;

packages/vchart/src/series/base/base-series.ts

@@ -1109,6 +1109,7 @@ export abstract class BaseSeries<T extends ISeriesSpec> extends BaseModel<T> imp
     const marks = this.getMarksWithoutRoot();
     // FIXME: 合并 mark spec 的时机是否需要统一调整到 this.initMarkStyle() 中？
     marks.forEach(mark => {
+      mark.clearBeforeReInit();
       (this._spec as any)[mark.name] && this.initMarkStyleWithSpec(mark, (this._spec as any)[mark.name]);
     });
     this.initMarkStyle();

specs/009-fix-issue-of-mark-state-when-updateSpec/plan.md

@@ -0,0 +1,25 @@
+# Implementation Plan: Fix mark state issue during updateSpec
+
+## Summary
+Fix an issue where mark states were not properly cleared when `updateSpec` was called, causing incorrect state persistence.
+
+## Technical Context
+The `updateSpec` process re-initializes marks but previous state information was lingering.
+Changes include:
+- Added `clearAllStateInfo` method to `IMarkStateManager` interface and implementation.
+- Added `clearBeforeReInit` method to `IMarkRaw` interface and implementation.
+- Invoked `clearBeforeReInit` in `BaseMark` during re-initialization.
+- Updated `BaseSeries` to handle state cleanup during spec updates.
+
+### Source Code (repository root)
+```
+packages/vchart/src/compile/mark/interface.ts
+packages/vchart/src/compile/mark/mark-state-manager.ts
+packages/vchart/src/mark/base/base-mark.ts
+packages/vchart/src/mark/interface/common.ts
+packages/vchart/src/series/base/base-series.ts
+```
+
+## Verification Plan
+- Verify that mark states (e.g., hover, select) are reset correctly after `updateSpec`.
+- Ensure no regression in normal state interactions.