preparing for ktmidi 0.6 and breaking API changes

[atsushieno]

We just have released ktmidi 0.5 in June, but I'm thinking to bring in some breaking API changes around MidiMusic and thus bump the version to 0.6. Most notably...

• It had been a misnomer that a MIDI message that comes with a delta time was named MidiMessage and the one without the delta time was named MidiEvent. They became Midi1Event (with timestamp) and Midi1Message (without it), respectively i.e. their names are now flipped.
  • The new classes are now organized under the new Midi1Music class, with Midi1Track class.
• Midi1Message above actually becomes an interface. There will be Midi1SimpleMessage data class and Midi1CompoundMessage (non-data class) for SysEx and meta event messages.

The old API still remains, with @Deprecated annotation, but there are some exceptional immediately-broken API that was inevitable:

• Midi1TrackSplitter already contained 1in the name and now deals with the new Midi1Music and co. starting v0.6 immediately. Hopefully no one used it.
• Midi1Player.addOnMessageListener() and .removeOnMessageListener() - Midi1Playersimilarly contains 1 in the name already and the members had to immediately switch to the new types.

These are the breaking changes as far as I could verify from Metalava API diff reports. (Those reported as RemovedDeprecatedMethod are not counted as breaking changes here.)

[atsushieno]

v0.6 changes are pushed at https://github.com/atsushieno/ktmidi/tree/v0.6-branch

[atsushieno]

v0.6-branch is merged into main today, but I noticed that there will be a few more breaking API changes. Most of them could be still remain (with @ Deprecated), but there were still some immediate breakages. They are hopefully not too much (I assume there were not a lot of use in apps) - the changes this time are similar to the breaking changes mentioned earlier.

/Users/atsushi/sources/KtMidi/ktmidi/ktmidi/build/metalava/current.txt:630: error: Attempted to change parameter name from evt to message in constructor dev.atsushieno.ktmidi.Midi1Event [ParameterNameChange]
/Users/atsushi/sources/KtMidi/ktmidi/ktmidi/build/metalava/current.txt:647: error: Method dev.atsushieno.ktmidi.Midi1Machine.getEventListeners has changed return type from error.NonExistentClass to java.util.List<dev.atsushieno.ktmidi.Midi1Machine.OnMidi1MessageListener> [ChangedType]
/Users/atsushi/sources/KtMidi/ktmidi/ktmidi/api/ktmidi-api.txt:652: error: Removed class dev.atsushieno.ktmidi.Midi1Machine.OnMidiMessageListener [RemovedInterface]
/Users/atsushi/sources/KtMidi/ktmidi/ktmidi/api/ktmidi-api.txt:801: error: Removed method dev.atsushieno.ktmidi.Midi1Player.addOnMessageListener(dev.atsushieno.ktmidi.OnMidi1MessageListener) [RemovedMethod]
/Users/atsushi/sources/KtMidi/ktmidi/ktmidi/api/ktmidi-api.txt:804: error: Removed method dev.atsushieno.ktmidi.Midi1Player.removeOnMessageListener(dev.atsushieno.ktmidi.OnMidi1MessageListener) [RemovedMethod]
/Users/atsushi/sources/KtMidi/ktmidi/ktmidi/build/metalava/current.txt:892: error: Attempted to change parameter name from messages to events in constructor dev.atsushieno.ktmidi.Midi1Track [ParameterNameChange]
/Users/atsushi/sources/KtMidi/ktmidi/ktmidi/api/ktmidi-api.txt:1631: error: Removed class dev.atsushieno.ktmidi.OnMidi1MessageListener [RemovedInterface]
/Users/atsushi/sources/KtMidi/ktmidi/ktmidi/build/metalava/current.txt:1703: error: Added method dev.atsushieno.ktmidi.SeekProcessor.filterEvent(TEvent) [AddedAbstractMethod]
/Users/atsushi/sources/KtMidi/ktmidi/ktmidi/api/ktmidi-api.txt:1695: error: Removed method dev.atsushieno.ktmidi.SeekProcessor.filterMessage(TMessage) [RemovedMethod]
Aborting: Found compatibility problems checking the public API (/Users/atsushi/sources/KtMidi/ktmidi/ktmidi/build/metalava/current.txt) against the API in /Users/atsushi/sources/KtMidi/ktmidi/ktmidi/api/ktmidi-api.txt