VisActor · github-actions · Jul 16, 2026 · Jul 16, 2026 · Jul 16, 2026 · Jul 17, 2026
diff --git a/common/config/rush/pnpm-lock.yaml b/common/config/rush/pnpm-lock.yaml
diff --git a/common/config/rush/version-policies.json b/common/config/rush/version-policies.json
@@ -1 +1 @@
-[{"definitionName":"lockStepVersion","policyName":"vchartMain","version":"2.1.4","mainProject":"@visactor/vchart","nextBump":"patch"}]
+[{"definitionName":"lockStepVersion","policyName":"vchartMain","version":"2.1.5","mainProject":"@visactor/vchart","nextBump":"patch"}]
diff --git a/docs/assets/changelog/en/release.md b/docs/assets/changelog/en/release.md
@@ -1,3 +1,20 @@
+# v2.1.5
+
+2026-07-30
+
+**🆕 New Features**
+
+- **@visactor/vchart**: support layout-time callbacks for discrete legend pager.layout and pager.position with resolved maxRow and maxCol
+- **@visactor/vchart**: support dimension hover state for mark point target symbol
+
+**🐛 Bug Fixes**
+
+- **@visactor/vchart**: release the pointerout listener when dimension hover events are unregistered
+- **@visactor/vchart**: avoid duplicate event handlers after chart remake
+
+**Full Changelog**: https://github.com/VisActor/VChart/compare/v2.1.4...v2.1.5
+
+[more detail about v2.1.5](https://github.com/VisActor/VChart/releases/tag/v2.1.5)
 # v2.1.4
 
 2026-07-16

diff --git a/docs/assets/changelog/zh/release.md b/docs/assets/changelog/zh/release.md
@@ -1,3 +1,20 @@
+# v2.1.5
+
+2026-07-30
+
+**🆕 新增功能**
+
+- **@visactor/vchart**: 支持 layout-time callbacks for discrete 图例 pager.layout and pager.position with resolved maxRow and maxCol
+- **@visactor/vchart**: 支持 dimension hover state for mark point target symbol
+
+**🐛 问题修复**
+
+- **@visactor/vchart**: release the pointerout listener when dimension hover events are unregistered
+- **@visactor/vchart**: avoid duplicate event handlers after chart remake
+
+**Full Changelog**: https://github.com/VisActor/VChart/compare/v2.1.4...v2.1.5
+
+[更多详情请查看 v2.1.5](https://github.com/VisActor/VChart/releases/tag/v2.1.5)
 # v2.1.4
 
 2026-07-16

diff --git a/docs/assets/option/en/component/legend-discrete.md b/docs/assets/option/en/component/legend-discrete.md
@@ -817,13 +817,21 @@ Set the pager type, currently supporting two styles:
 - Default style: pager with arrows
 - `type: 'scrollbar'`: Scrollbar pager
 
-#### layout(string)
+#### layout(string|Function)
 
 The layout of the page turner, the optional values are `'horizontal'` and `'vertical'`. The default value logic is:
 
 - Defaults to `'vertical'` when legend `orient` is `'left'` or `'right'`.
 - Defaults to `'horizontal'` when legend `orient` is `'top'` or `'bottom'`.
 
+A callback `(ctx) => 'horizontal' | 'vertical'` is also supported. It is evaluated during layout after `maxRow` / `maxCol` have been resolved. `ctx` contains `rect`, `orient`, `id`, `maxRow`, and `maxCol`, so the pager handlers can switch to a vertical arrangement for a multi-row legend.
+
+#### position(string|Function)
+
+The cross-axis alignment of the pager within the legend content. The optional values are `'start'`, `'middle'`, and `'end'`; the default is `'middle'`.
+
+A callback `(ctx) => 'start' | 'middle' | 'end'` is also supported. It is evaluated during layout after `maxRow` / `maxCol` have been resolved and receives the same `ctx` as the `layout` callback, so a multi-row legend can top-align its pager while a single-row legend remains centered.
+
 #### defaultCurrent(number)
 
 Default current page number.

diff --git a/docs/assets/option/zh/component/legend-discrete.md b/docs/assets/option/zh/component/legend-discrete.md
@@ -804,13 +804,21 @@ value: {
 - 默认样式：带箭头的翻页器
 - `type: 'scrollbar'`: 滚动条翻页
 
-#### layout(string)
+#### layout(string|Function)
 
 翻页器的布局方式，可选值为 `'horizontal'` 和 `'vertical'`。默认值逻辑为：
 
 - 图例 `orient` 为 `'left'` 或者 `'right'` 时，默认为 `'vertical'`。
 - 图例 `orient` 为 `'top'` 或者 `'bottom'` 时，默认为 `'horizontal'`。
 
+支持回调 `(ctx) => 'horizontal' | 'vertical'`。回调在布局期、`maxRow` / `maxCol` 求值后执行，`ctx` 包含 `rect`、`orient`、`id`、`maxRow` 和 `maxCol`，可据此让多行图例的翻页按钮切换为上下排列。
+
+#### position(string|Function)
+
+翻页器在图例内容交叉轴方向上的对齐位置，可选值为 `'start'`、`'middle'` 和 `'end'`，默认值为 `'middle'`。
+
+支持回调 `(ctx) => 'start' | 'middle' | 'end'`。回调同样在布局期、`maxRow` / `maxCol` 求值后执行，并接收与 `layout` 回调相同的 `ctx`，可据此让多行图例的翻页器顶对齐、单行图例保持居中。
+
 #### defaultCurrent(number)
 
 默认当前页数。

diff --git a/docs/package.json b/docs/package.json
@@ -12,10 +12,10 @@
   },
   "dependencies": {
     "@arco-design/web-react": "2.46.1",
-    "@visactor/openinula-vchart": "workspace:2.1.4",
-    "@visactor/react-vchart": "workspace:2.1.4",
-    "@visactor/vchart": "workspace:2.1.4",
-    "@visactor/vchart-extension": "workspace:2.1.4",
+    "@visactor/openinula-vchart": "workspace:2.1.5",
+    "@visactor/react-vchart": "workspace:2.1.5",
+    "@visactor/vchart": "workspace:2.1.5",
+    "@visactor/vchart-extension": "workspace:2.1.5",
     "@visactor/vchart-theme": "~1.6.6",
     "@visactor/vmind": "1.2.4-alpha.5",
     "@visactor/vutils": "~1.0.23",

diff --git a/packages/block-vchart/block/vchart/index.js b/packages/block-vchart/block/vchart/index.js
diff --git a/packages/harmony_vchart/library/CHANGELOG.md b/packages/harmony_vchart/library/CHANGELOG.md
@@ -1,3 +1,20 @@
+# v2.1.5
+
+2026-07-30
+
+**🆕 New Features**
+
+- **@visactor/vchart**: support layout-time callbacks for discrete legend pager.layout and pager.position with resolved maxRow and maxCol
+- **@visactor/vchart**: support dimension hover state for mark point target symbol
+
+**🐛 Bug Fixes**
+
+- **@visactor/vchart**: release the pointerout listener when dimension hover events are unregistered
+- **@visactor/vchart**: avoid duplicate event handlers after chart remake
+
+**Full Changelog**: https://github.com/VisActor/VChart/compare/v2.1.4...v2.1.5
+
+[more detail about v2.1.5](https://github.com/VisActor/VChart/releases/tag/v2.1.5)
 # v2.1.4
 
 2026-07-16

diff --git a/packages/harmony_vchart/library/oh-package.json5 b/packages/harmony_vchart/library/oh-package.json5
@@ -1,6 +1,6 @@
 {
   name: '@visactor/harmony-vchart',
-  version: '2.1.4',
+  version: '2.1.5',
   description: '@visactor/vchart 针对 harmonyOS 打造的图表库，拥有非常酷炫的动画能力，近20种图表类型，以及原生的渲染性能',
   main: 'Index.ets',
   author: {

diff --git a/packages/harmony_vchart/library/src/main/ets/index-harmony-simple.es.min.js b/packages/harmony_vchart/library/src/main/ets/index-harmony-simple.es.min.js
diff --git a/packages/harmony_vchart/library/src/main/ets/index-harmony.es.min.js b/packages/harmony_vchart/library/src/main/ets/index-harmony.es.min.js
diff --git a/packages/lark-vchart/package.json b/packages/lark-vchart/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@visactor/lark-vchart",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "description": "VChart 飞书小程序组件",
   "main": "index.js",
   "files": [

diff --git a/packages/lark-vchart/src/vchart/index.js b/packages/lark-vchart/src/vchart/index.js
diff --git a/packages/openinula-vchart/package.json b/packages/openinula-vchart/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@visactor/openinula-vchart",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "sideEffects": false,
   "description": "The openinula version of VChart 4.x",
   "keywords": [
@@ -28,7 +28,7 @@
     "build": "bundle --clean"
   },
   "dependencies": {
-    "@visactor/vchart": "workspace:2.1.4",
+    "@visactor/vchart": "workspace:2.1.5",
     "@visactor/vutils": "~1.0.23",
     "@visactor/vrender-core": "~1.1.4",
     "@visactor/vrender-kits": "~1.1.4",

diff --git a/packages/react-vchart/package.json b/packages/react-vchart/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@visactor/react-vchart",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "sideEffects": false,
   "description": "The react version of VChart 4.x",
   "keywords": [
@@ -33,8 +33,8 @@
     "build": "bundle --clean"
   },
   "dependencies": {
-    "@visactor/vchart": "workspace:2.1.4",
-    "@visactor/vchart-extension": "workspace:2.1.4",
+    "@visactor/vchart": "workspace:2.1.5",
+    "@visactor/vchart-extension": "workspace:2.1.5",
     "@visactor/vutils": "~1.0.23",
     "@visactor/vrender-core": "~1.1.4",
     "@visactor/vrender-kits": "~1.1.4",

diff --git a/packages/taro-vchart/package.json b/packages/taro-vchart/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@visactor/taro-vchart",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "description": "Taro VChart 图表组件",
   "sideEffects": false,
   "main": "esm/index.js",
@@ -43,8 +43,8 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@visactor/vchart": "workspace:2.1.4",
-    "@visactor/vchart-extension": "workspace:2.1.4"
+    "@visactor/vchart": "workspace:2.1.5",
+    "@visactor/vchart-extension": "workspace:2.1.5"
   },
   "devDependencies": {
     "@internal/bundler": "workspace:*",

diff --git a/packages/tt-vchart/src/vchart/index.js b/packages/tt-vchart/src/vchart/index.js
diff --git a/packages/vchart-extension/package.json b/packages/vchart-extension/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@visactor/vchart-extension",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "description": "vchart extension package, including extension plugins and components",
   "sideEffects": false,
   "main": "cjs/index.js",
@@ -30,7 +30,7 @@
     "@visactor/vrender-kits": "~1.1.4",
     "@visactor/vrender-components": "~1.1.4",
     "@visactor/vrender-animate": "~1.1.4",
-    "@visactor/vchart": "workspace:2.1.4",
+    "@visactor/vchart": "workspace:2.1.5",
     "@visactor/vutils": "~1.0.23",
     "@visactor/vdataset": "~1.0.23",
     "@visactor/vlayouts": "~1.0.23"

diff --git a/packages/vchart-schema/package.json b/packages/vchart-schema/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@visactor/vchart-schema",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "description": "The VChart JSON schema file.",
   "sideEffects": false,
   "main": "vchart.json",
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		[{"definitionName":"lockStepVersion","policyName":"vchartMain","version":"2.1.4","mainProject":"@visactor/vchart","nextBump":"patch"}]
		[{"definitionName":"lockStepVersion","policyName":"vchartMain","version":"2.1.5","mainProject":"@visactor/vchart","nextBump":"patch"}]