feat: implemented global key signature track

2026-05-23 14:44:48 -07:00
parent 1e816596e4
commit 8eb3f5d84d
30 changed files with 1689 additions and 57 deletions
@@ -0,0 +1,113 @@
+import { KGCommand } from '../KGCommand';
+import { KGCore } from '../../KGCore';
+import type { KeySignature } from '../../KGProject';
+import { GlobalTrackType } from '../../global-track';
+import { KGKeySignatureRegion } from '../../region/KGKeySignatureRegion';
+import { generateUniqueId } from '../../../util/miscUtil';
+import {
+  cloneKeySignatureRegions,
+  findGlobalTrackByType,
+  findKeySignatureRegionAtBar,
+  getSongEndBar,
+  getSortedKeySignatureRegions,
+} from '../../../util/globalTrackUtil';
+
+export class CreateKeySignatureRegionCommand extends KGCommand {
+  private readonly startBar: number;
+  private readonly regionId: string;
+  private createdRegion: KGKeySignatureRegion | null = null;
+  private previousRegions: KGKeySignatureRegion[] = [];
+
+  constructor(startBar: number, regionId?: string) {
+    super();
+    this.startBar = startBar;
+    this.regionId = regionId ?? generateUniqueId('KGKeySignatureRegion');
+  }
+
+  execute(): void {
+    const project = KGCore.instance().getCurrentProject();
+    const beatsPerBar = project.getTimeSignature().numerator;
+    const track = findGlobalTrackByType(project, GlobalTrackType.Signature);
+    if (!track) {
+      throw new Error('Signature global track not found');
+    }
+
+    const existingRegions = getSortedKeySignatureRegions(track, beatsPerBar);
+    this.previousRegions = cloneKeySignatureRegions(existingRegions, beatsPerBar);
+
+    const songEndBar = getSongEndBar(project);
+    const clampedStartBar = Math.max(0, Math.min(this.startBar, Math.max(0, songEndBar - 1)));
+
+    if (existingRegions.length === 0) {
+      const nextRegions: KGKeySignatureRegion[] = [];
+
+      if (clampedStartBar > 0) {
+        nextRegions.push(new KGKeySignatureRegion(
+          generateUniqueId('KGKeySignatureRegion'),
+          track.getId(),
+          track.getTrackIndex(),
+          project.getKeySignature(),
+          0,
+          clampedStartBar,
+          beatsPerBar
+        ));
+      }
+
+      this.createdRegion = new KGKeySignatureRegion(
+        this.regionId,
+        track.getId(),
+        track.getTrackIndex(),
+        project.getKeySignature(),
+        clampedStartBar,
+        Math.max(1, songEndBar - clampedStartBar),
+        beatsPerBar
+      );
+      nextRegions.push(this.createdRegion);
+      track.setRegions(nextRegions);
+      return;
+    }
+
+    const containingRegion = findKeySignatureRegionAtBar(project, clampedStartBar);
+    if (!containingRegion) {
+      throw new Error(`No key signature region covers bar ${clampedStartBar}`);
+    }
+
+    const regionStartBar = containingRegion.getStartBar();
+    const regionEndBar = containingRegion.getEndBar();
+    if (clampedStartBar <= regionStartBar || clampedStartBar >= regionEndBar) {
+      throw new Error(`Bar ${clampedStartBar} is not a valid split point`);
+    }
+
+    containingRegion.setLengthBars(clampedStartBar - regionStartBar, beatsPerBar);
+    this.createdRegion = new KGKeySignatureRegion(
+      this.regionId,
+      track.getId(),
+      track.getTrackIndex(),
+      containingRegion.getKeySignature(),
+      clampedStartBar,
+      regionEndBar - clampedStartBar,
+      beatsPerBar
+    );
+
+    track.setRegions([...existingRegions, this.createdRegion].sort((left, right) => left.getStartBar() - right.getStartBar()));
+  }
+
+  undo(): void {
+    const project = KGCore.instance().getCurrentProject();
+    const track = findGlobalTrackByType(project, GlobalTrackType.Signature);
+    if (!track) {
+      throw new Error('Signature global track not found during undo');
+    }
+
+    const beatsPerBar = project.getTimeSignature().numerator;
+    track.setRegions(cloneKeySignatureRegions(this.previousRegions, beatsPerBar));
+  }
+
+  getDescription(): string {
+    return `Create key signature change at bar ${this.startBar + 1}`;
+  }
+
+  public getCreatedRegion(): KGKeySignatureRegion | null {
+    return this.createdRegion;
+  }
+}