initial public release.

2025-08-11 18:37:21 -07:00
commit de51967b49
186 changed files with 32322 additions and 0 deletions
@@ -0,0 +1,130 @@
+import { Expose, Type } from 'class-transformer';
+import { KGTrack } from './track/KGTrack';
+import { KGMidiTrack } from './track/KGMidiTrack';
+import { type TimeSignature, WithDefault } from '../types/projectTypes';
+import { TIME_CONSTANTS, KEY_SIGNATURE_MAP } from '../constants/coreConstants';
+
+// Type for valid key signatures
+export type KeySignature = keyof typeof KEY_SIGNATURE_MAP;
+
+/**
+ * KGProject - Class representing a project in the DAW
+ * Contains project settings and track data
+ */
+export class KGProject {
+  @Expose()
+  private name: string = "Untitled Project";
+  
+  @Expose()
+  private maxBars: number = 32;
+  
+  @Expose()
+  private currentBars: number = 0;
+  
+  @Expose()
+  private timeSignature: TimeSignature = TIME_CONSTANTS.DEFAULT_TIME_SIGNATURE;
+  
+  @Expose()
+  private bpm: number = TIME_CONSTANTS.DEFAULT_BPM;
+  
+  @Expose()
+  @WithDefault("C major")
+  private keySignature: KeySignature = "C major";
+
+  @Expose()
+  @WithDefault(0)
+  private projectStructureVersion: number = 0;
+
+  public static readonly CURRENT_PROJECT_STRUCTURE_VERSION: number = 1;
+  
+  @Expose()
+  @Type(() => KGTrack, {
+    discriminator: {
+      property: '__type',
+      subTypes: [
+        { value: KGTrack, name: 'KGTrack' },
+        { value: KGMidiTrack, name: 'KGMidiTrack' },
+      ],
+    },
+  })
+  private tracks: KGTrack[] = [];
+
+  // Constructor
+  constructor(name: string = "Untitled Project", maxBars: number = 32, currentBars: number = 0, bpm: number = 125, timeSignature: TimeSignature = { numerator: 4, denominator: 4 }, keySignature: KeySignature = "C major", tracks: KGTrack[] = [], projectStructureVersion: number = KGProject.CURRENT_PROJECT_STRUCTURE_VERSION) {
+    this.name = name;
+    this.maxBars = maxBars;
+    this.currentBars = currentBars;
+    this.bpm = bpm;
+    this.timeSignature = timeSignature;
+    this.keySignature = keySignature;
+    this.tracks = tracks;
+    this.projectStructureVersion = projectStructureVersion;
+  }
+
+  // Getters
+  public getName(): string {
+    return this.name;
+  }
+
+  public getMaxBars(): number {
+    return this.maxBars;
+  }
+
+  public getCurrentBars(): number {
+    return this.currentBars;
+  }
+
+  public getTimeSignature(): TimeSignature {
+    return this.timeSignature;
+  }
+
+  public setTimeSignature(timeSignature: TimeSignature): void {
+    this.timeSignature = timeSignature;
+  }
+
+  public getBpm(): number {
+    return this.bpm;
+  }
+
+  public getKeySignature(): KeySignature {
+    return this.keySignature;
+  }
+
+  public getTracks(): KGTrack[] {
+    return this.tracks;
+  }
+
+  // Setters
+  public setName(name: string): void {
+    this.name = name;
+  }
+
+  public setMaxBars(maxBars: number): void {
+    this.maxBars = maxBars;
+  }
+
+  public setCurrentBars(currentBars: number): void {
+    this.currentBars = currentBars;
+  }
+
+  public setBpm(bpm: number): void {
+    this.bpm = bpm;
+  }
+
+  public setKeySignature(keySignature: KeySignature): void {
+    this.keySignature = keySignature;
+  }
+
+  public setTracks(tracks: KGTrack[]): void {
+    this.tracks = tracks;
+  }
+
+  public setProjectStructureVersion(projectStructureVersion: number): void {
+    this.projectStructureVersion = projectStructureVersion;
+  }
+
+  public getProjectStructureVersion(): number {
+    return this.projectStructureVersion;
+  }
+}
+