@hum2music/core 0.0.0-stage → 0.1.0

package/package.json

@@ -1,6 +1,16 @@
 {
   "name": "@hum2music/core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Shared pipeline types for Hum2Music (NoteEvent, Composition, ChordEvent, TempoCandidate, etc.).",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/hum2music/hum2music",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hum2music/hum2music.git",
+    "directory": "packages/core"
+  },
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "files": ["src"]
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from "./types";

package/src/types.ts

@@ -0,0 +1,73 @@
+export interface PitchFrame {
+  timeMs: number;
+  f0Hz: number | null;
+  confidence: number;
+  voiced: boolean;
+}
+
+export interface NoteCandidate {
+  startMs: number;
+  durationMs: number;
+  rawPitch: number;
+  pitchTrajectory: PitchFrame[];
+  onsetConfidence: number;
+}
+
+/** One sample of a note's pitch deviation from its nominal pitch, in cents, at a time offset from note-on. */
+export interface PitchCurveSample {
+  offsetMs: number;
+  cents: number;
+}
+
+export interface NoteEvent {
+  pitch: number;
+  startBeat: number;
+  durationBeats: number;
+  velocity: number;
+  expression?: {
+    pitchCurve?: PitchCurveSample[];
+    timingOffsetMs?: number;
+  };
+}
+
+export interface TempoCandidate {
+  bpm: number;
+  confidence: number;
+  isHalfOrDoubleOf?: number;
+}
+
+export interface KeyCandidate {
+  tonic: string;
+  mode: "major" | "minor";
+  confidence: number;
+}
+
+export interface ChordEvent {
+  symbol: string;
+  startBeat: number;
+  durationBeats: number;
+  confidence: number;
+}
+
+/** One labeled span of bars in a bar-level repetition analysis (e.g. A/A/B for a repeated 4-bar cycle). */
+export interface SongSection {
+  label: string;
+  startBarIndex: number;
+  barCount: number;
+}
+
+export interface InstrumentTrack {
+  instrument: string;
+  notes: NoteEvent[];
+}
+
+export interface Composition {
+  metadata: {
+    bpm: number;
+    timeSignature: [number, number];
+    key?: string;
+  };
+  melody: NoteEvent[];
+  chords: ChordEvent[];
+  tracks: InstrumentTrack[];
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.