merge develop

.gitignore

@@ -55,6 +55,8 @@ jspm_packages/
 
 # Optional eslint cache
 .eslintcache
+.jest-cache/
+**/.jest-cache/
 
 # Optional REPL history
 .node_repl_history
@@ -109,4 +111,4 @@ tsconfig.tsbuildinfo
 
 .history
 .trae/
-.agents/
+.agents/

common/changes/@visactor/vtable/codex-fix-pivot-expand-scroll-anchor_2026-06-24-00-52.json

@@ -0,0 +1,11 @@
+{
+  "changes": [
+    {
+      "comment": "fix: keep pivot row tree scroll position on toggle",
+      "type": "patch",
+      "packageName": "@visactor/vtable"
+    }
+  ],
+  "packageName": "@visactor/vtable",
+  "email": "892739385@qq.com"
+}

common/changes/@visactor/vtable/fix-issue-3672-right-frozen-count_2026-06-16-07-08.json

@@ -0,0 +1,11 @@
+{
+  "changes": [
+    {
+      "comment": "fix: handle right frozen column count update",
+      "type": "none",
+      "packageName": "@visactor/vtable"
+    }
+  ],
+  "packageName": "@visactor/vtable",
+  "email": "biukam.w@gmail.com"
+}

common/changes/@visactor/vtable/fix-issue-5088-carousel-fractional-row_2026-06-23-10-48.json

@@ -0,0 +1,11 @@
+{
+  "changes": [
+    {
+      "comment": "fix: keep fractional row scroll target",
+      "type": "none",
+      "packageName": "@visactor/vtable"
+    }
+  ],
+  "packageName": "@visactor/vtable",
+  "email": "biukam.w@gmail.com"
+}

common/changes/@visactor/vtable/fix-issue-5162-gantt-sort-drag_2026-06-17-07-15.json

@@ -0,0 +1,11 @@
+{
+  "changes": [
+    {
+      "comment": "fix: sync gantt task bars after sorted updates\n\n",
+      "type": "none",
+      "packageName": "@visactor/vtable"
+    }
+  ],
+  "packageName": "@visactor/vtable",
+  "email": "liufangfang.jane@bytedance.com"
+}

common/changes/@visactor/vtable/fix-issue-5162-gantt-sort-drag_2026-06-17-10-52.json

@@ -0,0 +1,11 @@
+{
+  "changes": [
+    {
+      "comment": "fix: preserve quad style values",
+      "type": "none",
+      "packageName": "@visactor/vtable"
+    }
+  ],
+  "packageName": "@visactor/vtable",
+  "email": "liufangfang.jane@bytedance.com"
+}

packages/vtable-gantt/__tests__/gantt-sort-sync.test.ts

@@ -0,0 +1,113 @@
+// @ts-nocheck
+
+global.__VERSION__ = 'none';
+
+import { Gantt } from '../src';
+import { createDiv, removeDom } from './dom';
+
+describe('gantt sort sync', () => {
+  test('task bar nodes should bind sorted records after table sort', async () => {
+    const container = createDiv();
+    container.style.width = '900px';
+    container.style.height = '400px';
+
+    const records = [
+      { id: 1, title: 'Task 1', startDate: '2024-07-01', endDate: '2024-07-03', progress: 10 },
+      { id: 2, title: 'Task 2', startDate: '2024-07-05', endDate: '2024-07-07', progress: 20 },
+      { id: 3, title: 'Task 3', startDate: '2024-07-09', endDate: '2024-07-11', progress: 30 }
+    ];
+
+    const gantt = new Gantt(container, {
+      records,
+      taskListTable: {
+        columns: [
+          { field: 'title', title: 'title', width: 160, sort: true },
+          { field: 'startDate', title: 'startDate', width: 120, sort: true }
+        ],
+        tableWidth: 320
+      },
+      taskBar: {
+        startDateField: 'startDate',
+        endDateField: 'endDate',
+        progressField: 'progress'
+      },
+      timelineHeader: {
+        colWidth: 40,
+        scales: [{ unit: 'day', step: 1 }]
+      },
+      minDate: '2024-06-25',
+      maxDate: '2024-07-20'
+    });
+
+    try {
+      gantt.taskListTableInstance.updateSortState({ field: 'startDate', order: 'desc' });
+      await new Promise(resolve => setTimeout(resolve, 250));
+
+      const firstVisibleRecord = gantt.getRecordByIndex(0);
+      const firstTaskBarNode = gantt.scenegraph.taskBar.getTaskBarNodeByIndex(0);
+
+      expect(firstVisibleRecord.id).toBe(3);
+      expect(firstTaskBarNode.record.id).toBe(firstVisibleRecord.id);
+      expect(firstTaskBarNode.record.startDate).toBe(firstVisibleRecord.startDate);
+    } finally {
+      gantt.release?.();
+      removeDom(container);
+    }
+  });
+
+  test('task bar nodes should refresh when date update changes sorted row order', async () => {
+    const container = createDiv();
+    container.style.width = '900px';
+    container.style.height = '400px';
+
+    const records = [
+      { id: 101, title: '需求评审', startDate: '2024-02-05', endDate: '2024-02-12', progress: 20 },
+      { id: 102, title: '交互设计', startDate: '2024-03-10', endDate: '2024-03-18', progress: 35 },
+      { id: 103, title: '接口联调', startDate: '2024-05-28', endDate: '2024-06-05', progress: 50 },
+      { id: 104, title: '灰度验证', startDate: '2024-10-05', endDate: '2024-10-20', progress: 65 },
+      { id: 105, title: '正式上线', startDate: '2024-11-10', endDate: '2024-11-25', progress: 80 }
+    ];
+
+    const gantt = new Gantt(container, {
+      records,
+      taskKeyField: 'id',
+      taskListTable: {
+        columns: [
+          { field: 'title', title: 'title', width: 160, sort: true },
+          { field: 'startDate', title: 'startDate', width: 120, sort: true }
+        ],
+        tableWidth: 320
+      },
+      taskBar: {
+        startDateField: 'startDate',
+        endDateField: 'endDate',
+        progressField: 'progress'
+      },
+      timelineHeader: {
+        colWidth: 40,
+        scales: [{ unit: 'day', step: 1 }]
+      },
+      minDate: '2024-01-01',
+      maxDate: '2024-12-31'
+    });
+
+    try {
+      gantt.taskListTableInstance.updateSortState({ field: 'startDate', order: 'desc' });
+      await new Promise(resolve => setTimeout(resolve, 250));
+
+      expect(gantt.getRecordByIndex(0).id).toBe(105);
+      expect(gantt.scenegraph.taskBar.getTaskBarNodeByIndex(0).record.id).toBe(105);
+
+      gantt._updateStartEndDateToTaskRecord(new Date('2024-09-19'), new Date('2024-10-04'), 0);
+      await new Promise(resolve => setTimeout(resolve, 250));
+
+      expect(gantt.getRecordByIndex(0).id).toBe(104);
+      expect(gantt.scenegraph.taskBar.getTaskBarNodeByIndex(0).record.id).toBe(104);
+      expect(gantt.getRecordByIndex(1).id).toBe(105);
+      expect(gantt.scenegraph.taskBar.getTaskBarNodeByIndex(1).record.id).toBe(105);
+    } finally {
+      gantt.release?.();
+      removeDom(container);
+    }
+  });
+});

packages/vtable-gantt/examples/gantt/gantt-issue-5162-sort-drag.ts

@@ -0,0 +1,132 @@
+import type { ColumnsDefine } from '@visactor/vtable';
+import type { GanttConstructorOptions } from '../../src/index';
+import { Gantt } from '../../src/index';
+
+const CONTAINER_ID = 'vTable';
+
+function createTips(container: HTMLElement) {
+  const tips = document.createElement('div');
+  tips.style.cssText = [
+    'margin: 12px 0',
+    'padding: 12px 16px',
+    'border: 1px solid #d9e2f2',
+    'border-radius: 6px',
+    'background: #f7faff',
+    'font-family: Arial, sans-serif',
+    'font-size: 13px',
+    'line-height: 20px',
+    'color: #1f2329'
+  ].join(';');
+  tips.innerHTML = [
+    '<strong>Issue #5162 Repro</strong><br>',
+    '1. 点击左侧 start 列排序，切到 desc。<br>',
+    '2. 拖动排序后的第一行或第二行任务条，观察控制台输出。<br>',
+    '3. 再次排序或调用 <code>window.ganttIssue5162.logMapping()</code> 查看可见行与任务条绑定是否一致。'
+  ].join('');
+  container.appendChild(tips);
+}
+
+export function createTable() {
+  const container = document.getElementById(CONTAINER_ID)!;
+  container.innerHTML = '';
+  createTips(container);
+
+  const records = [
+    { id: 101, title: '需求评审', owner: 'Alice', start: '2024-02-05', end: '2024-02-12', progress: 20 },
+    { id: 102, title: '交互设计', owner: 'Bob', start: '2024-03-10', end: '2024-03-18', progress: 35 },
+    { id: 103, title: '接口联调', owner: 'Carol', start: '2024-05-28', end: '2024-06-05', progress: 50 },
+    { id: 104, title: '灰度验证', owner: 'David', start: '2024-10-05', end: '2024-10-20', progress: 65 },
+    { id: 105, title: '正式上线', owner: 'Eve', start: '2024-11-10', end: '2024-11-25', progress: 80 }
+  ];
+
+  const columns: ColumnsDefine = [
+    { field: 'title', title: 'title', width: 160, sort: true },
+    { field: 'owner', title: 'owner', width: 120, sort: true },
+    { field: 'start', title: 'start', width: 120, sort: true },
+    { field: 'end', title: 'end', width: 120, sort: true },
+    { field: 'progress', title: 'progress', width: 100, sort: true }
+  ];
+
+  const option: GanttConstructorOptions = {
+    records,
+    taskListTable: {
+      columns,
+      tableWidth: 360,
+      minTableWidth: 280,
+      maxTableWidth: 640
+    },
+    taskKeyField: 'id',
+    taskBar: {
+      startDateField: 'start',
+      endDateField: 'end',
+      progressField: 'progress',
+      moveable: true,
+      labelText: '{title}'
+    },
+    minDate: '2024-01-01',
+    maxDate: '2024-12-31',
+    timelineHeader: {
+      colWidth: 30,
+      scales: [{ unit: 'day', step: 1 }]
+    },
+    scrollStyle: {
+      visible: 'scrolling'
+    },
+    grid: {
+      verticalLine: {
+        lineWidth: 1,
+        lineColor: '#e1e4e8'
+      },
+      horizontalLine: {
+        lineWidth: 1,
+        lineColor: '#e1e4e8'
+      }
+    }
+  };
+
+  const ganttInstance = new Gantt(container, option);
+  (window as any).ganttInstance = ganttInstance;
+
+  const logMapping = () => {
+    const rows = records.map((_, index) => {
+      const visibleRecord = ganttInstance.getRecordByIndex(index);
+      const taskBarNode = ganttInstance.scenegraph.taskBar.getTaskBarNodeByIndex(index);
+      return {
+        row: index,
+        visibleId: visibleRecord?.id,
+        visibleTitle: visibleRecord?.title,
+        taskBarRecordId: taskBarNode?.record?.id,
+        taskBarRecordTitle: taskBarNode?.record?.title
+      };
+    });
+    console.table(rows);
+    return rows;
+  };
+
+  (window as any).ganttIssue5162 = {
+    gantt: ganttInstance,
+    sortByStartDesc: () => ganttInstance.taskListTableInstance?.updateSortState({ field: 'start', order: 'desc' }),
+    sortByStartAsc: () => ganttInstance.taskListTableInstance?.updateSortState({ field: 'start', order: 'asc' }),
+    logMapping,
+    logRecords: () => {
+      console.table(ganttInstance.records);
+      return ganttInstance.records;
+    }
+  };
+
+  ganttInstance.taskListTableInstance?.on('after_sort', () => {
+    console.log('[issue-5162] after_sort');
+    logMapping();
+  });
+
+  ganttInstance.on('move_end_task_bar', e => {
+    console.log('[issue-5162] move_end_task_bar', e);
+    logMapping();
+    console.table(ganttInstance.records);
+  });
+
+  setTimeout(() => {
+    const x = ganttInstance.getXByTime(new Date('2024-06-01 00:00:00').getTime());
+    ganttInstance.scrollLeft = x;
+  }, 0);
+}

packages/vtable-gantt/examples/menu.ts

@@ -174,6 +174,10 @@ export const menus = [
   {
     path: 'gantt',
     name: 'gantt-locate-taskbar'
+  },
+  {
+    path: 'gantt',
+    name: 'gantt-issue-5162-sort-drag'
   }
   //   ]
   // }

packages/vtable-gantt/jest.config.js

@@ -44,6 +44,7 @@ module.exports = {
       statements: 60
     }
   },
+  cacheDirectory: '<rootDir>/.jest-cache',
   moduleNameMapper: {
     'd3-color': path.resolve(__dirname, './node_modules/d3-color/dist/d3-color.min.js'),
     'd3-array': path.resolve(process.cwd(), './node_modules/d3-array/dist/d3-array.min.js'),