feat: implemented global marker track

src/core/project-upgrader/KGProjectUpgrader.ts

@@ -11,6 +11,7 @@ import { upgradeToV9 } from './upgradeToV9';
 import { upgradeToV10 } from './upgradeToV10';
 import { upgradeToV11 } from './upgradeToV11';
 import { upgradeToV12 } from './upgradeToV12';
+import { upgradeToV13 } from './upgradeToV13';
 
 /**
  * Upgrade the given project to the latest structure version, one version at a time.
@@ -78,6 +79,10 @@ export function upgradeProjectToLatest(project: KGProject): KGProject {
         workingProject = upgradeToV12(workingProject);
         break;
       }
+      case 13: {
+        workingProject = upgradeToV13(workingProject);
+        break;
+      }
       default: {
         // If an upgrader is missing, throw to prevent loading incompatible structures
         throw new Error(`No upgrader found for project structure version ${nextVersion}`);

src/core/project-upgrader/upgradeToV13.test.ts

@@ -0,0 +1,31 @@
+import { describe, expect, it } from 'vitest';
+import { KGProject } from '../KGProject';
+import { GlobalTrackType } from '../global-track';
+import { upgradeProjectToLatest } from './KGProjectUpgrader';
+import { upgradeToV13 } from './upgradeToV13';
+
+describe('upgradeToV13', () => {
+  it('adds the default global tracks to legacy projects', () => {
+    const project = new KGProject('Legacy', 32, 0, 125, undefined, undefined, undefined, undefined, [0, 0], 1, [], 12, 1, []);
+
+    upgradeToV13(project);
+
+    expect(project.getProjectStructureVersion()).toBe(13);
+    expect(project.getGlobalTracks()).toHaveLength(4);
+    expect(project.getGlobalTracks().map(track => track.getType())).toEqual([
+      GlobalTrackType.Marker,
+      GlobalTrackType.Tempo,
+      GlobalTrackType.Signature,
+      GlobalTrackType.Chord,
+    ]);
+  });
+
+  it('runs through the main upgrader path', () => {
+    const project = new KGProject('Legacy', 32, 0, 125, undefined, undefined, undefined, undefined, [0, 0], 1, [], 12, 1, []);
+
+    const upgraded = upgradeProjectToLatest(project);
+
+    expect(upgraded.getProjectStructureVersion()).toBe(KGProject.CURRENT_PROJECT_STRUCTURE_VERSION);
+    expect(upgraded.getGlobalTracks()).toHaveLength(4);
+  });
+});

src/core/project-upgrader/upgradeToV13.ts

@@ -0,0 +1,12 @@
+import { KGProject } from '../KGProject';
+import { ensureDefaultGlobalTracks } from '../../util/globalTrackUtil';
+
+export function upgradeToV13(project: KGProject): KGProject {
+  try {
+    ensureDefaultGlobalTracks(project);
+  } finally {
+    project.setProjectStructureVersion(13);
+  }
+
+  return project;
+}