@soundor/vst3-host 0.0.0-stage → 0.1.1

package/CMakeLists.txt

@@ -0,0 +1,194 @@
+# soundor-vst3-host: the native executable of @soundor/vst3-host.
+#
+#   cmake --workflow --preset dev        Debug, tests, -Werror      → build/dev
+#   cmake --workflow --preset release    the shipped configuration  → build/release
+#
+# The version comes from package.json and the protocol from protocol.json,
+# so the executable and the Node client agree on both. Nothing here depends
+# on JUCE, the Soundor engine or any other workspace package.
+cmake_minimum_required(VERSION 3.25)
+
+file(READ "${CMAKE_CURRENT_SOURCE_DIR}/package.json" soundor_package)
+string(JSON SOUNDOR_VST3_HOST_VERSION GET "${soundor_package}" version)
+file(READ "${CMAKE_CURRENT_SOURCE_DIR}/protocol.json" soundor_protocol)
+string(JSON SOUNDOR_VST3_HOST_PROTOCOL GET "${soundor_protocol}" version)
+string(JSON SOUNDOR_VST3_HOST_MAX_HEADER GET "${soundor_protocol}" maxHeaderBytes)
+string(JSON SOUNDOR_VST3_HOST_MAX_PAYLOAD GET "${soundor_protocol}" defaultMaxPayloadBytes)
+string(REGEX MATCH "^[0-9]+\\.[0-9]+\\.[0-9]+" soundor_numeric_version "${SOUNDOR_VST3_HOST_VERSION}")
+
+# The oldest macOS the host runs on, in any build. CMake wants it before project().
+if(APPLE AND NOT DEFINED CMAKE_OSX_DEPLOYMENT_TARGET AND NOT DEFINED ENV{MACOSX_DEPLOYMENT_TARGET})
+  set(CMAKE_OSX_DEPLOYMENT_TARGET 12.0 CACHE STRING "The oldest macOS the host runs on")
+endif()
+
+project(SoundorVst3Host VERSION ${soundor_numeric_version} LANGUAGES C CXX)
+if(APPLE)
+  enable_language(OBJCXX)
+endif()
+
+option(SOUNDOR_VST3_HOST_BUILD_TESTS "Build the self-test and the fixture plugins" OFF)
+option(SOUNDOR_VST3_HOST_WARNINGS_AS_ERRORS "Treat warnings in the host's own sources as errors" OFF)
+option(SOUNDOR_VST3_HOST_SANITIZERS "Build with AddressSanitizer and UndefinedBehaviorSanitizer" OFF)
+option(SOUNDOR_VST3_HOST_CLANG_TIDY "Check the host's own sources with clang-tidy" OFF)
+
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+set(CMAKE_OBJCXX_STANDARD 20)
+set(CMAKE_CXX_VISIBILITY_PRESET hidden)
+set(CMAKE_OBJCXX_VISIBILITY_PRESET hidden)
+set(CMAKE_VISIBILITY_INLINES_HIDDEN ON)
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+# A self-contained executable: no Visual C++ redistributable needed.
+set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+
+find_package(Threads REQUIRED)
+include(cmake/Vst3HostDependencies.cmake)
+
+if(SOUNDOR_VST3_HOST_SANITIZERS AND NOT MSVC)
+  add_compile_options(-fsanitize=address,undefined -fno-omit-frame-pointer -fno-sanitize-recover=undefined)
+  add_link_options(-fsanitize=address,undefined)
+endif()
+
+# ── The SDK's hosting helpers ───────────────────────────────────────────────
+
+set(sdk "${SOUNDOR_VST3_SDK_DIR}")
+add_library(soundor_vst3_sdk_hosting STATIC
+  "${sdk}/pluginterfaces/base/conststringtable.cpp"
+  "${sdk}/pluginterfaces/base/coreiids.cpp"
+  "${sdk}/pluginterfaces/base/funknown.cpp"
+  "${sdk}/pluginterfaces/base/ustring.cpp"
+  "${sdk}/public.sdk/source/common/commoniids.cpp"
+  "${sdk}/public.sdk/source/common/commonstringconvert.cpp"
+  "${sdk}/public.sdk/source/common/memorystream.cpp"
+  "${sdk}/public.sdk/source/vst/hosting/connectionproxy.cpp"
+  "${sdk}/public.sdk/source/vst/hosting/eventlist.cpp"
+  "${sdk}/public.sdk/source/vst/hosting/hostclasses.cpp"
+  "${sdk}/public.sdk/source/vst/hosting/module.cpp"
+  "${sdk}/public.sdk/source/vst/hosting/parameterchanges.cpp"
+  "${sdk}/public.sdk/source/vst/hosting/pluginterfacesupport.cpp"
+  "${sdk}/public.sdk/source/vst/utility/stringconvert.cpp"
+  "${sdk}/public.sdk/source/vst/vstinitiids.cpp")
+if(WIN32)
+  target_sources(soundor_vst3_sdk_hosting PRIVATE
+    "${sdk}/public.sdk/source/vst/hosting/module_win32.cpp"
+    "${sdk}/public.sdk/source/common/threadchecker_win32.cpp")
+  target_link_libraries(soundor_vst3_sdk_hosting PUBLIC ole32 shell32)
+  # Written for C++17, where u8string() returns std::string.
+  set_source_files_properties("${sdk}/public.sdk/source/vst/hosting/module_win32.cpp"
+    PROPERTIES COMPILE_OPTIONS "$<$<CXX_COMPILER_ID:MSVC>:/Zc:char8_t->")
+  target_compile_definitions(soundor_vst3_sdk_hosting PUBLIC UNICODE _UNICODE NOMINMAX)
+elseif(APPLE)
+  target_sources(soundor_vst3_sdk_hosting PRIVATE
+    "${sdk}/public.sdk/source/vst/hosting/module_mac.mm"
+    "${sdk}/public.sdk/source/common/threadchecker_mac.mm")
+  target_link_libraries(soundor_vst3_sdk_hosting PUBLIC "-framework CoreFoundation" "-framework Foundation")
+  # The SDK's Objective-C++ needs ARC; the host's own (EditorWindowMac.mm,
+  # EventLoopMac.mm) manages references itself.
+  set_source_files_properties("${sdk}/public.sdk/source/vst/hosting/module_mac.mm"
+    PROPERTIES COMPILE_OPTIONS -fobjc-arc)
+else()
+  target_sources(soundor_vst3_sdk_hosting PRIVATE
+    "${sdk}/public.sdk/source/vst/hosting/module_linux.cpp"
+    "${sdk}/public.sdk/source/common/threadchecker_linux.cpp")
+  target_link_libraries(soundor_vst3_sdk_hosting PUBLIC ${CMAKE_DL_LIBS})
+endif()
+target_include_directories(soundor_vst3_sdk_hosting SYSTEM PUBLIC "${sdk}")
+target_compile_definitions(soundor_vst3_sdk_hosting PUBLIC $<IF:$<CONFIG:Debug>,DEVELOPMENT=1,RELEASE=1>)
+target_link_libraries(soundor_vst3_sdk_hosting PUBLIC Threads::Threads)
+# Upstream code: its warnings are not ours to fix.
+if(MSVC)
+  target_compile_options(soundor_vst3_sdk_hosting PRIVATE /W0)
+else()
+  target_compile_options(soundor_vst3_sdk_hosting PRIVATE -w)
+endif()
+
+# ── Warnings for the host's own sources ─────────────────────────────────────
+
+function(soundor_vst3_host_warnings target)
+  if(MSVC)
+    # Warnings are errors with Clang and GCC (the dev, release and tidy
+    # presets); MSVC's /W4 reports, but does not fail, the build.
+    target_compile_options(${target} PRIVATE /W4 /permissive- /utf-8)
+  else()
+    target_compile_options(${target} PRIVATE -Wall -Wextra -Wno-unused-parameter)
+    if(SOUNDOR_VST3_HOST_WARNINGS_AS_ERRORS)
+      target_compile_options(${target} PRIVATE -Werror)
+    endif()
+  endif()
+  if(SOUNDOR_VST3_HOST_CLANG_TIDY)
+    find_program(SOUNDOR_CLANG_TIDY_EXE NAMES clang-tidy-18 clang-tidy REQUIRED)
+    set_target_properties(${target} PROPERTIES
+      CXX_CLANG_TIDY "${SOUNDOR_CLANG_TIDY_EXE};--warnings-as-errors=*")
+  endif()
+endfunction()
+
+# Every configuration's outputs in one place (Visual Studio adds a
+# per-configuration directory otherwise).
+function(soundor_vst3_host_output target kind directory)
+  set_target_properties(${target} PROPERTIES ${kind}_OUTPUT_DIRECTORY "${directory}")
+  foreach(config IN ITEMS Debug Release RelWithDebInfo MinSizeRel)
+    string(TOUPPER ${config} upper)
+    set_target_properties(${target} PROPERTIES ${kind}_OUTPUT_DIRECTORY_${upper} "${directory}")
+  endforeach()
+endfunction()
+
+# ── The executable ──────────────────────────────────────────────────────────
+
+configure_file(native/src/Version.h.in "${CMAKE_BINARY_DIR}/generated/Version.h" @ONLY)
+
+add_executable(soundor-vst3-host
+  native/src/Bundle.cpp
+  native/src/HostContext.cpp
+  native/src/HostInterface.cpp
+  native/src/HostWindow.cpp
+  native/src/Ipc.cpp
+  native/src/Json.cpp
+  native/src/LiveAudio.cpp
+  native/src/Main.cpp
+  native/src/Plugin.cpp
+  native/src/Session.cpp
+  native/src/Settings.cpp
+  "${SOUNDOR_VST3_HOST_FONTS_SOURCE}")
+if(WIN32)
+  target_sources(soundor-vst3-host PRIVATE native/src/EventLoopWindows.cpp native/src/EditorWindowWindows.cpp
+                                           native/src/EditorAreaWindows.cpp)
+  target_link_libraries(soundor-vst3-host PRIVATE user32 gdi32)
+elseif(APPLE)
+  target_sources(soundor-vst3-host PRIVATE native/src/EventLoopMac.mm native/src/EditorWindowMac.mm
+                                           native/src/EditorAreaMac.mm)
+  target_link_libraries(soundor-vst3-host PRIVATE "-framework Cocoa")
+else()
+  # Xlib's headers only: the library is loaded in UI mode (X11Library.cpp).
+  find_path(SOUNDOR_X11_INCLUDE_DIR X11/Xlib.h REQUIRED)
+  target_include_directories(soundor-vst3-host SYSTEM PRIVATE "${SOUNDOR_X11_INCLUDE_DIR}")
+  target_sources(soundor-vst3-host PRIVATE native/src/EventLoopLinux.cpp native/src/EditorAreaX11.cpp
+                                           native/src/X11Library.cpp)
+  # The C++ runtime inside the executable, in every build: it runs on
+  # distributions with an older libstdc++ than the build machine's. A failed
+  # check is not kept, so installing the library is enough.
+  include(CheckCXXSourceCompiles)
+  set(CMAKE_REQUIRED_LINK_OPTIONS -static-libstdc++ -static-libgcc)
+  check_cxx_source_compiles("#include <string>
+int main(int argc, char** argv) { return static_cast<int>(std::string(argv[0]).size()) + argc; }" SOUNDOR_VST3_HOST_STATIC_CXX_RUNTIME)
+  unset(CMAKE_REQUIRED_LINK_OPTIONS)
+  if(NOT SOUNDOR_VST3_HOST_STATIC_CXX_RUNTIME)
+    unset(SOUNDOR_VST3_HOST_STATIC_CXX_RUNTIME CACHE)
+    message(FATAL_ERROR "Linux builds link the C++ runtime statically, and libstdc++.a wasn't found.\n"
+                        "Fedora, RHEL: sudo dnf install libstdc++-static\n"
+                        "Elsewhere: the package with your compiler's static C++ library.")
+  endif()
+  target_link_options(soundor-vst3-host PRIVATE -static-libstdc++ -static-libgcc)
+endif()
+target_include_directories(soundor-vst3-host PRIVATE native/src "${CMAKE_BINARY_DIR}/generated")
+target_link_libraries(soundor-vst3-host PRIVATE soundor_vst3_sdk_hosting soundor_imgui SDL3::SDL3-static)
+# A large generated array: nothing to lint.
+set_source_files_properties("${SOUNDOR_VST3_HOST_FONTS_SOURCE}" PROPERTIES SKIP_LINTING ON)
+soundor_vst3_host_warnings(soundor-vst3-host)
+soundor_vst3_host_output(soundor-vst3-host RUNTIME "${CMAKE_BINARY_DIR}/bin")
+
+if(SOUNDOR_VST3_HOST_BUILD_TESTS)
+  enable_testing()
+  add_subdirectory(native/tests)
+endif()

package/CMakePresets.json

@@ -0,0 +1,115 @@
+{
+  "version": 6,
+  "cmakeMinimumRequired": {
+    "major": 3,
+    "minor": 25,
+    "patch": 0
+  },
+  "configurePresets": [
+    {
+      "name": "dev",
+      "displayName": "Debug build with the self-test and fixture plugins",
+      "binaryDir": "${sourceDir}/build/dev",
+      "cacheVariables": {
+        "CMAKE_BUILD_TYPE": "Debug",
+        "SOUNDOR_VST3_HOST_BUILD_TESTS": "ON",
+        "SOUNDOR_VST3_HOST_WARNINGS_AS_ERRORS": "ON"
+      }
+    },
+    {
+      "name": "release",
+      "displayName": "The shipped configuration, with the fixtures for its tests",
+      "binaryDir": "${sourceDir}/build/release",
+      "cacheVariables": {
+        "CMAKE_BUILD_TYPE": "Release",
+        "SOUNDOR_VST3_HOST_BUILD_TESTS": "ON",
+        "SOUNDOR_VST3_HOST_WARNINGS_AS_ERRORS": "ON"
+      }
+    },
+    {
+      "name": "sanitize",
+      "inherits": "dev",
+      "displayName": "Debug build with ASan + UBSan",
+      "binaryDir": "${sourceDir}/build/sanitize",
+      "cacheVariables": {
+        "SOUNDOR_VST3_HOST_SANITIZERS": "ON"
+      }
+    },
+    {
+      "name": "tidy",
+      "inherits": "dev",
+      "displayName": "Debug build checked by clang-tidy",
+      "binaryDir": "${sourceDir}/build/tidy",
+      "cacheVariables": {
+        "SOUNDOR_VST3_HOST_CLANG_TIDY": "ON"
+      }
+    }
+  ],
+  "buildPresets": [
+    { "name": "dev", "configurePreset": "dev", "configuration": "Debug" },
+    {
+      "name": "release",
+      "configurePreset": "release",
+      "configuration": "Release"
+    },
+    {
+      "name": "sanitize",
+      "configurePreset": "sanitize",
+      "configuration": "Debug"
+    },
+    { "name": "tidy", "configurePreset": "tidy", "configuration": "Debug" }
+  ],
+  "testPresets": [
+    {
+      "name": "dev",
+      "configurePreset": "dev",
+      "configuration": "Debug",
+      "output": { "outputOnFailure": true }
+    },
+    {
+      "name": "release",
+      "configurePreset": "release",
+      "configuration": "Release",
+      "output": { "outputOnFailure": true }
+    },
+    {
+      "name": "sanitize",
+      "configurePreset": "sanitize",
+      "configuration": "Debug",
+      "output": { "outputOnFailure": true }
+    }
+  ],
+  "workflowPresets": [
+    {
+      "name": "dev",
+      "steps": [
+        { "type": "configure", "name": "dev" },
+        { "type": "build", "name": "dev" },
+        { "type": "test", "name": "dev" }
+      ]
+    },
+    {
+      "name": "release",
+      "steps": [
+        { "type": "configure", "name": "release" },
+        { "type": "build", "name": "release" },
+        { "type": "test", "name": "release" }
+      ]
+    },
+    {
+      "name": "sanitize",
+      "steps": [
+        { "type": "configure", "name": "sanitize" },
+        { "type": "build", "name": "sanitize" },
+        { "type": "test", "name": "sanitize" }
+      ]
+    },
+    {
+      "name": "tidy",
+      "steps": [
+        { "type": "configure", "name": "tidy" },
+        { "type": "build", "name": "tidy" }
+      ]
+    }
+  ]
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dmitrii Balakin and Egor Smirnov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,17 @@
+# Notices
+
+`@soundor/vst3-host` is MIT-licensed (LICENSE). Its executable is built with
+the following third-party code, under its own license:
+
+| Component                                                                                          | Version        | License | Notice                                                  |
+| -------------------------------------------------------------------------------------------------- | -------------- | ------- | ------------------------------------------------------- |
+| [VST3 SDK](https://github.com/steinbergmedia/vst3sdk) (pluginterfaces, public.sdk hosting helpers) | 3.8.1 build 84 | MIT     | `licenses/vst3sdk/LICENSE.txt` in each platform package |
+
+| [SDL](https://github.com/libsdl-org/SDL) | 3.4.18 | Zlib | `licenses/sdl/LICENSE.txt` in each platform package |
+| [Dear ImGui](https://github.com/ocornut/imgui) | 1.92.9b | MIT | `licenses/imgui/LICENSE.txt` in each platform package |
+| [Inter](https://github.com/rsms/inter) (font) | 4.1 | OFL-1.1 | `licenses/inter/LICENSE.txt` in each platform package |
+
+VST is a registered trademark of Steinberg Media Technologies GmbH.
+
+The test fixtures (`native/tests/fixtures`) additionally use the SDK's `base`
+library (MIT); they are never shipped as binaries.

package/README.md

@@ -1,3 +1,41 @@
-# Temporary Holding Version
+# @soundor/vst3-host
 
-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.
+A standalone VST3 host for tests and development: a native executable driven
+from Node.js. It loads a `.vst3` bundle by path, processes audio offline
+(parameters, MIDI, transport, state), and opens the plugin's editor in a
+native window when asked. Any VST3 plugin, made with Soundor or not.
+
+```sh
+pnpm add -D @soundor/vst3-host
+```
+
+```ts
+import { launchHost } from '@soundor/vst3-host';
+
+const host = await launchHost({
+  plugin: 'build/MyPlugin.vst3',
+  sampleRate: 48_000,
+  blockSize: 512,
+});
+try {
+  const [first] = await host.getParameters();
+  await host.setParameter(first!.id, 0.5);
+  const input = new Float32Array(48_000);
+  const { outputs } = await host.process({ inputs: [[input, input]] });
+} finally {
+  await host.close();
+}
+```
+
+The executable comes in a platform package installed with this one, at the
+same version: Linux x64 (glibc), macOS (arm64 and x64) and Windows x64.
+Installing compiles and downloads nothing else.
+
+Documentation: [user guide](https://soundor.dev/docs/testing/vst3-host) and
+[internals](https://soundor.dev/docs/contribute/vst3-host) (building from
+source, prebuilt selection, releases).
+
+## License
+
+MIT (LICENSE). The executable includes the VST3 SDK, under its own MIT license
+(NOTICE.md). VST is a registered trademark of Steinberg Media Technologies GmbH.

package/cmake/Vst3HostDependencies.cmake

@@ -0,0 +1,179 @@
+# The host's third-party dependencies.
+#
+# Each is fetched at configure time from an exact upstream commit or release,
+# verified by SHA-256, and compiled into a private static target. The archives
+# are kept in the user cache (SOUNDOR_CACHE, else ~/.cache/soundor,
+# ~/Library/Caches/Soundor or %LOCALAPPDATA%\Soundor\cache), so a new build
+# directory does not download them again.
+#
+# | Dependency                   | Version         | License  | Used for                          |
+# | ---------------------------- | --------------- | -------- | --------------------------------- |
+# | VST3 SDK pluginterfaces      | 3.8.1 build 84  | MIT      | VST3 interfaces (host, fixtures)  |
+# | VST3 SDK public.sdk          | 3.8.1 build 84  | MIT      | hosting helpers (host), plugin base classes (fixtures) |
+# | VST3 SDK base                | 3.8.1 build 84  | MIT      | plugin base classes (fixtures only) |
+# | SDL                          | 3.4.18          | zlib     | the host window, live audio, file dialogs |
+# | Dear ImGui                   | 1.92.9b         | MIT      | the host interface                |
+# | Inter                        | 4.1             | OFL-1.1  | the host interface's font         |
+#
+# SDL is the one built by its own CMake project (as a static library, with only
+# the subsystems the host uses): its platform configuration is not worth
+# reproducing. ImGui and Inter are compiled and embedded by the host's CMake.
+#
+# The tag v3.8.1_build_84 of each repository: VST3 SDK 3.8 is the first
+# release under the MIT license. Offline: -DFETCHCONTENT_SOURCE_DIR_SOUNDOR_VST3_<PART>=<checkout>.
+
+include_guard(GLOBAL)
+include(FetchContent)
+
+set(SOUNDOR_VST3_SDK_VERSION "3.8.1")
+set(SOUNDOR_VST3_PLUGINTERFACES_REVISION "4f547e8e102b47de4a8b8aaf343c73b700786372")
+set(SOUNDOR_VST3_PLUGINTERFACES_SHA256 "ee70777eebb8450fc04fae2a6dd452f723d12bfb8222af443b8c1f8a9259089a")
+set(SOUNDOR_VST3_PUBLIC_SDK_REVISION "586dc5e6c8012c3e4b01c79389375cbe96bdb1da")
+set(SOUNDOR_VST3_PUBLIC_SDK_SHA256 "71319491b771068b8e2c5374c22830a339677e9d54c4cd33af4a0aa210e4c838")
+set(SOUNDOR_VST3_BASE_REVISION "fcf9da0bd27a16f7f03773a3a39822f28f5c8477")
+set(SOUNDOR_VST3_BASE_SHA256 "3753d45a79b5e324c2843d74a18c8f1117fe0b1118fa9312658aecf6360ec603")
+
+function(soundor_vst3_host_cache_root out)
+  if(DEFINED ENV{SOUNDOR_CACHE} AND NOT "$ENV{SOUNDOR_CACHE}" STREQUAL "")
+    set(root "$ENV{SOUNDOR_CACHE}")
+  elseif(WIN32)
+    set(root "$ENV{LOCALAPPDATA}/Soundor/cache")
+  elseif(APPLE)
+    set(root "$ENV{HOME}/Library/Caches/Soundor")
+  elseif(DEFINED ENV{XDG_CACHE_HOME} AND NOT "$ENV{XDG_CACHE_HOME}" STREQUAL "")
+    set(root "$ENV{XDG_CACHE_HOME}/soundor")
+  else()
+    set(root "$ENV{HOME}/.cache/soundor")
+  endif()
+  file(TO_CMAKE_PATH "${root}" root)
+  set(${out} "${root}" PARENT_SCOPE)
+endfunction()
+
+# The SDK's sources include each other as "pluginterfaces/...",
+# "public.sdk/source/..." and "base/source/...": the parts are laid out
+# side by side under one root, as the SDK's umbrella repository does.
+set(SOUNDOR_VST3_SDK_DIR "${CMAKE_BINARY_DIR}/_deps/vst3sdk")
+soundor_vst3_host_cache_root(soundor_cache)
+set(soundor_downloads "${soundor_cache}/vst3-host/downloads")
+
+function(soundor_vst3_sdk_part name repository directory revision sha256)
+  FetchContent_Declare(
+    ${name}
+    URL "https://github.com/steinbergmedia/${repository}/archive/${revision}.tar.gz"
+    URL_HASH "SHA256=${sha256}"
+    DOWNLOAD_NAME "${repository}-${revision}.tar.gz"
+    DOWNLOAD_DIR "${soundor_downloads}"
+    DOWNLOAD_EXTRACT_TIMESTAMP TRUE
+    SOURCE_DIR "${SOUNDOR_VST3_SDK_DIR}/${directory}"
+    # Populate only: the host defines its own SDK targets.
+    SOURCE_SUBDIR "soundor-populate-only")
+  FetchContent_MakeAvailable(${name})
+endfunction()
+
+soundor_vst3_sdk_part(soundor_vst3_pluginterfaces vst3_pluginterfaces pluginterfaces
+  ${SOUNDOR_VST3_PLUGINTERFACES_REVISION} ${SOUNDOR_VST3_PLUGINTERFACES_SHA256})
+soundor_vst3_sdk_part(soundor_vst3_public_sdk vst3_public_sdk public.sdk
+  ${SOUNDOR_VST3_PUBLIC_SDK_REVISION} ${SOUNDOR_VST3_PUBLIC_SDK_SHA256})
+if(SOUNDOR_VST3_HOST_BUILD_TESTS)
+  soundor_vst3_sdk_part(soundor_vst3_base vst3_base base
+    ${SOUNDOR_VST3_BASE_REVISION} ${SOUNDOR_VST3_BASE_SHA256})
+endif()
+
+# The notice every distributed host executable carries.
+configure_file("${SOUNDOR_VST3_SDK_DIR}/pluginterfaces/LICENSE.txt"
+  "${CMAKE_BINARY_DIR}/licenses/vst3sdk/LICENSE.txt" COPYONLY)
+
+# ── The host interface: SDL, Dear ImGui, Inter ──────────────────────────────
+
+set(SOUNDOR_SDL_VERSION "3.4.18")
+set(SOUNDOR_SDL_SHA256 "9c75cf16330322c217dedd2e0609f1124f1b54b8633e763467b4684d0f4334a3")
+set(SOUNDOR_IMGUI_VERSION "1.92.9b")
+set(SOUNDOR_IMGUI_SHA256 "21d8a0a565e85dce943e375db00812c2f3f0ab21f3f0f7964e364a63422d7f99")
+set(SOUNDOR_INTER_VERSION "4.1")
+set(SOUNDOR_INTER_SHA256 "9883fdd4a49d4fb66bd8177ba6625ef9a64aa45899767dde3d36aa425756b11e")
+
+function(soundor_vst3_host_archive name url sha256 download_name out)
+  FetchContent_Declare(
+    ${name}
+    URL "${url}"
+    URL_HASH "SHA256=${sha256}"
+    DOWNLOAD_NAME "${download_name}"
+    DOWNLOAD_DIR "${soundor_downloads}"
+    DOWNLOAD_EXTRACT_TIMESTAMP TRUE
+    # Populate only: SDL is configured below; the other targets are ours.
+    SOURCE_SUBDIR "soundor-populate-only")
+  FetchContent_MakeAvailable(${name})
+  set(${out} "${${name}_SOURCE_DIR}" PARENT_SCOPE)
+endfunction()
+
+soundor_vst3_host_archive(soundor_sdl
+  "https://github.com/libsdl-org/SDL/releases/download/release-${SOUNDOR_SDL_VERSION}/SDL3-${SOUNDOR_SDL_VERSION}.tar.gz"
+  ${SOUNDOR_SDL_SHA256} "SDL3-${SOUNDOR_SDL_VERSION}.tar.gz" SOUNDOR_SDL_DIR)
+soundor_vst3_host_archive(soundor_imgui
+  "https://github.com/ocornut/imgui/archive/refs/tags/v${SOUNDOR_IMGUI_VERSION}.tar.gz"
+  ${SOUNDOR_IMGUI_SHA256} "imgui-${SOUNDOR_IMGUI_VERSION}.tar.gz" SOUNDOR_IMGUI_DIR)
+soundor_vst3_host_archive(soundor_inter
+  "https://github.com/rsms/inter/releases/download/v${SOUNDOR_INTER_VERSION}/Inter-${SOUNDOR_INTER_VERSION}.zip"
+  ${SOUNDOR_INTER_SHA256} "Inter-${SOUNDOR_INTER_VERSION}.zip" SOUNDOR_INTER_DIR)
+
+# SDL: a static library with the subsystems the host interface uses (video,
+# rendering, events, audio, dialogs). On Linux, X11 only (VST3 editors are
+# X11 windows), and every system library is loaded at run time, so headless
+# mode needs none of them.
+function(soundor_vst3_host_sdl)
+  set(BUILD_SHARED_LIBS OFF)
+  set(CMAKE_C_CLANG_TIDY "")
+  set(CMAKE_CXX_CLANG_TIDY "")
+  foreach(option IN ITEMS SDL_STATIC SDL_AUDIO SDL_VIDEO SDL_RENDER SDL_DEPS_SHARED SDL_DISABLE_INSTALL
+                          SDL_X11_XSYNC)
+    set(${option} ON CACHE BOOL "" FORCE)
+  endforeach()
+  foreach(option IN ITEMS SDL_SHARED SDL_TEST_LIBRARY SDL_TESTS SDL_EXAMPLES SDL_INSTALL SDL_GPU SDL_CAMERA
+                          SDL_HAPTIC SDL_HIDAPI SDL_POWER SDL_SENSOR SDL_TRAY SDL_VULKAN SDL_RENDER_VULKAN
+                          SDL_RENDER_GPU SDL_WAYLAND SDL_KMSDRM SDL_OFFSCREEN SDL_DUMMYCAMERA SDL_LIBUDEV
+                          SDL_IBUS SDL_JACK SDL_SNDIO SDL_OSS SDL_DISKAUDIO SDL_OPENVR SDL_RPI SDL_ROCKCHIP
+                          SDL_VIVANTE SDL_LIBURING SDL_FRIBIDI SDL_LIBTHAI SDL_CLANG_TIDY SDL_RPATH
+                          SDL_X11_XSCRNSAVER SDL_X11_XSHAPE SDL_X11_XDBE SDL_X11_XTEST)
+    set(${option} OFF CACHE BOOL "" FORCE)
+  endforeach()
+  add_subdirectory("${SOUNDOR_SDL_DIR}" "${CMAKE_BINARY_DIR}/_deps/sdl-build" EXCLUDE_FROM_ALL SYSTEM)
+endfunction()
+soundor_vst3_host_sdl()
+
+add_library(soundor_imgui STATIC
+  "${SOUNDOR_IMGUI_DIR}/imgui.cpp"
+  "${SOUNDOR_IMGUI_DIR}/imgui_draw.cpp"
+  "${SOUNDOR_IMGUI_DIR}/imgui_tables.cpp"
+  "${SOUNDOR_IMGUI_DIR}/imgui_widgets.cpp"
+  "${SOUNDOR_IMGUI_DIR}/backends/imgui_impl_sdl3.cpp"
+  "${SOUNDOR_IMGUI_DIR}/backends/imgui_impl_sdlrenderer3.cpp")
+target_include_directories(soundor_imgui SYSTEM PUBLIC "${SOUNDOR_IMGUI_DIR}" "${SOUNDOR_IMGUI_DIR}/backends")
+# No demo window, no default font file, no shell or clipboard helpers the
+# host does not use.
+target_compile_definitions(soundor_imgui PUBLIC IMGUI_DISABLE_DEMO_WINDOWS IMGUI_DISABLE_DEBUG_TOOLS
+                                                IMGUI_DISABLE_OBSOLETE_FUNCTIONS)
+target_link_libraries(soundor_imgui PUBLIC SDL3::SDL3-static)
+if(MSVC)
+  target_compile_options(soundor_imgui PRIVATE /W0)
+else()
+  target_compile_options(soundor_imgui PRIVATE -w)
+endif()
+
+# Inter's regular and semibold faces, embedded as byte arrays by a small
+# build-time tool (CMake's string functions are too slow for fonts).
+add_executable(soundor_vst3_host_embed "${CMAKE_CURRENT_LIST_DIR}/../native/tools/Embed.cpp")
+set(SOUNDOR_VST3_HOST_FONTS_SOURCE "${CMAKE_BINARY_DIR}/generated/HostFonts.cpp")
+add_custom_command(
+  OUTPUT "${SOUNDOR_VST3_HOST_FONTS_SOURCE}"
+  COMMAND soundor_vst3_host_embed "${SOUNDOR_VST3_HOST_FONTS_SOURCE}" soundor::vst3host::fonts
+          regular "${SOUNDOR_INTER_DIR}/extras/ttf/Inter-Regular.ttf"
+          semibold "${SOUNDOR_INTER_DIR}/extras/ttf/Inter-SemiBold.ttf"
+  DEPENDS soundor_vst3_host_embed
+          "${SOUNDOR_INTER_DIR}/extras/ttf/Inter-Regular.ttf"
+          "${SOUNDOR_INTER_DIR}/extras/ttf/Inter-SemiBold.ttf"
+  COMMENT "Embedding the host interface's fonts"
+  VERBATIM)
+
+configure_file("${SOUNDOR_SDL_DIR}/LICENSE.txt" "${CMAKE_BINARY_DIR}/licenses/sdl/LICENSE.txt" COPYONLY)
+configure_file("${SOUNDOR_IMGUI_DIR}/LICENSE.txt" "${CMAKE_BINARY_DIR}/licenses/imgui/LICENSE.txt" COPYONLY)
+configure_file("${SOUNDOR_INTER_DIR}/LICENSE.txt" "${CMAKE_BINARY_DIR}/licenses/inter/LICENSE.txt" COPYONLY)

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/cli.mjs

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+import { a as nativeInputs, i as resolveHost, l as Vst3HostError, r as launchHost, t as prepareHost } from "./prepare-ayjTVhfk.mjs";
+import { parseArgs } from "node:util";
+// src/cli.ts
+const { positionals, values } = parseArgs({
+	allowPositionals: true,
+	options: {
+		mode: { type: "string" },
+		artifact: { type: "string" },
+		commit: { type: "string" },
+		class: { type: "string" },
+		bare: { type: "boolean" },
+		interface: { type: "boolean" },
+		"sample-rate": { type: "string" },
+		"block-size": { type: "string" }
+	}
+});
+const USAGE = `usage: soundor-vst3-host <command>
+  open <plugin.vst3> [--class <name>] [--bare | --interface] [--sample-rate <hz>] [--block-size <frames>]
+  prepare [--mode prebuilt|published|source] [--artifact <dir>] [--commit <sha>]
+  resolve
+  inputs`;
+/** Opens a plugin's editor and waits until its window is closed. */
+async function open() {
+	const plugin = positionals[1];
+	if (plugin === void 0) throw new Error("open needs a .vst3 bundle");
+	if (values.bare && values.interface) throw new Error("--bare and --interface are opposites");
+	const number = (name) => {
+		const text = values[name];
+		if (text === void 0) return void 0;
+		const value = Number(text);
+		if (!Number.isFinite(value)) throw new Error(`--${name} is a number`);
+		return value;
+	};
+	const host = await launchHost({
+		plugin,
+		className: values.class,
+		editor: true,
+		presentation: values.bare ? "editor" : values.interface ? "host" : null,
+		sampleRate: number("sample-rate"),
+		blockSize: number("block-size"),
+		requestTimeout: 2147483647,
+		onLog: (line) => console.error(line)
+	});
+	const closed = new Promise((resolve) => {
+		host.once("editorClosed", () => resolve());
+		host.once("exit", () => resolve());
+		process.once("SIGINT", () => resolve());
+		process.once("SIGTERM", () => resolve());
+	});
+	console.error(`${host.info.name}: close its window (or press Ctrl+C) to quit`);
+	await closed;
+	await host.close();
+}
+try {
+	switch (positionals[0]) {
+		case "open":
+			await open();
+			break;
+		case "prepare": {
+			const mode = values.mode ?? "prebuilt";
+			if (mode !== "prebuilt" && mode !== "published" && mode !== "source") throw new Error(`--mode is "prebuilt", "published" or "source", not "${mode}"`);
+			await prepareHost({
+				mode,
+				artifact: values.artifact,
+				commit: values.commit
+			});
+			break;
+		}
+		case "resolve": {
+			const resolved = resolveHost();
+			console.log(`${resolved.executable}\t(${resolved.source}: ${resolved.reason})`);
+			break;
+		}
+		case "inputs":
+			console.log(JSON.stringify(nativeInputs(), null, 2));
+			break;
+		default:
+			console.error(USAGE);
+			process.exitCode = 64;
+	}
+} catch (error) {
+	console.error(error instanceof Vst3HostError ? `error (${error.code}): ${error.message}` : `error: ${error.message}`);
+	process.exitCode = 1;
+}
+export {};
+
+//# sourceMappingURL=cli.mjs.map