release: v0.3.1

ESP Component Registry support. Adds an `idf_component.yml` at the
root (description, version, license, maintainers, tags, and
`dependencies.sauloverissimo/midi2 >= 0.3.4` + `idf >= 5.0`) and an
`if(ESP_PLATFORM)` gate in CMakeLists.txt that routes to
`idf_component_register(SRCS src/midi2_*.cpp INCLUDE_DIRS src REQUIRES midi2)`
with `cxx_std_17`.

ESP-IDF consumers can now write:

  dependencies:
    sauloverissimo/midi2cpp: ">=0.3.1"

instead of pinning a git tag, and the Component Manager resolves the
midi2 C99 dependency transitively.

Native CMake (find_package / FetchContent / add_subdirectory),
PlatformIO, and Arduino consumers are untouched -- the ESP-IDF gate
only fires when `ESP_PLATFORM` is set.

Verified locally: cmake configure + ctest 7/7 pass.

Author: sauloverissimo

CHANGELOG.md

@@ -5,6 +5,35 @@ All notable changes to `midi2cpp` are recorded here. Format follows
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
 mirrored from the upstream midi2 C99 policy.
 
+## [0.3.1]
+
+ESP Component Registry support. midi2cpp now ships an `idf_component.yml`
+at the root and an `if(ESP_PLATFORM)` gate in `CMakeLists.txt`, so
+ESP-IDF projects can pull it through the official Espressif registry
+with semver constraints instead of hard-pinning a git tag.
+
+### Added
+
+- **`idf_component.yml`** at the repo root (description, version,
+  url, license, maintainers, tags, and `dependencies.sauloverissimo/midi2`
+  + `idf >= 5.0`). Uploaded to https://components.espressif.com/components/sauloverissimo/midi2cpp
+- **ESP-IDF gate** at the top of `CMakeLists.txt`: when `ESP_PLATFORM`
+  is set, calls `idf_component_register(SRCS src/midi2_*.cpp INCLUDE_DIRS src REQUIRES midi2)`
+  with `cxx_std_17` and returns before `project()` runs. Native CMake
+  consumers (Pico SDK, vcpkg, FetchContent, system installs) are
+  unaffected by the gate.
+
+### Install (ESP-IDF, new)
+
+```yaml
+# main/idf_component.yml
+dependencies:
+  sauloverissimo/midi2cpp: ">=0.3.1"
+```
+
+The Component Manager pulls midi2cpp from the registry; midi2 is
+resolved transitively (declared in midi2cpp's own `idf_component.yml`).
+
 ## [0.3.0]
 
 Renamed from `midi2_cpp` to `midi2cpp` in deference to [`starfishmod/MIDI2_CPP`](https://github.com/starfishmod/MIDI2_CPP) (maintained since 2021 by Andrew Mee, MIDI Association TSB Rep), which operates in the same domain. Keeping the namespaces disjoint avoids confusion in package managers and search.

CMakeLists.txt

@@ -1,5 +1,26 @@
 cmake_minimum_required(VERSION 3.14)
-project(midi2cpp VERSION 0.3.0 LANGUAGES C CXX)
+
+# ESP-IDF Component Manager path. When IDF resolves this directory as
+# a component (clone under managed_components/midi2cpp + idf_component.yml
+# at the root), it sets ESP_PLATFORM before processing this file. Route
+# to idf_component_register and skip the rest, leaving the native CMake
+# build (project / install / export / find_package fallback) untouched
+# for every other consumer.
+if(ESP_PLATFORM)
+    idf_component_register(
+        SRCS
+            src/midi2_device.cpp
+            src/midi2_ci.cpp
+            src/midi2_host.cpp
+            src/midi2_bridge.cpp
+        INCLUDE_DIRS src
+        REQUIRES midi2
+    )
+    target_compile_features(${COMPONENT_LIB} PUBLIC cxx_std_17)
+    return()
+endif()
+
+project(midi2cpp VERSION 0.3.1 LANGUAGES C CXX)
 
 set(CMAKE_C_STANDARD 99)
 set(CMAKE_C_STANDARD_REQUIRED ON)

idf_component.yml

@@ -0,0 +1,36 @@
+## ESP-IDF Component Manager manifest.
+##
+## Lets ESP-IDF projects pull midi2cpp directly from the
+## ESP Component Registry without vendoring src/ into the
+## consumer tree:
+##
+##   # in your_app/main/idf_component.yml
+##   dependencies:
+##     sauloverissimo/midi2cpp: ">=0.3.1"
+##
+## The Component Manager clones midi2cpp into managed_components/,
+## ESP-IDF picks it up as a component because the top-level CMakeLists
+## detects ESP_PLATFORM and calls idf_component_register at the top of
+## the file. midi2 (the C99 core) is pulled transitively because it
+## is declared in the dependencies block below.
+
+description: "C++17 callback-first wrapper for MIDI 2.0 on embedded devices, layered over the portable midi2 C99 library. Covers UMP transport (M2-104), MIDI-CI with Appendix E (M2-101), Property Exchange Subscribe/Notify, Profile Configuration, Process Inquiry, Flex Data, and Bit Scaling (M2-115)."
+version: "0.3.1"
+url: "https://github.com/sauloverissimo/midi2cpp"
+documentation: "https://github.com/sauloverissimo/midi2cpp#readme"
+issues: "https://github.com/sauloverissimo/midi2cpp/issues"
+license: "MIT"
+maintainers:
+  - "Saulo Verissimo <sauloverissimo@gmail.com>"
+tags:
+  - midi
+  - midi2
+  - ump
+  - usb
+  - capability-inquiry
+  - property-exchange
+  - cpp17
+
+dependencies:
+  idf: ">=5.0"
+  sauloverissimo/midi2: ">=0.3.4"

library.json

@@ -1,6 +1,6 @@
 {
   "name": "midi2cpp",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "C++17 Arduino-style wrapper for MIDI 2.0 on embedded devices. Thin wrapper over the portable midi2 C99 library. Covers UMP, MIDI-CI with Appendix E, Profile, PE Subscribe/Notify, Process Inquiry, Flex Data, and Bit Scaling. Targets RP2040, RP2350, Teensy, ESP32 family, nRF52, and SAMD21.",
   "keywords": "midi, midi2, usb, ump, capability-inquiry, property-exchange, profile",
   "authors": [

library.properties

@@ -1,5 +1,5 @@
 name=midi2cpp
-version=0.3.0
+version=0.3.1
 author=Saulo Verissimo <sauloverissimo@gmail.com>
 maintainer=Saulo Verissimo <sauloverissimo@gmail.com>
 sentence=C++17 Arduino-style wrapper for MIDI 2.0 on embedded devices.