feat: native host bridge integration — C++ bridge, Rust SHM, JS routing, build scripts, docs

- native_bridge/: InstrumentEngineManager multi-channel, sample-accurate, CC/program/pitchbend, transport, Vst3Instrument stub (HAVE_VST3SDK) - src-tauri: shm.rs, bridge spawn + audio pump + health monitor, open_vst_gui, externalBin, commands - app: UnifiedMidiRouter, NativeBridgeService, bridgeAudioNode, audioRoutingEngine, Plugin Manager UI, Bridge/WASM indicator, set_position sync - build: 3 ps1 (force-added, build/ ignored), verify_bundle --check-bridge, CI workflow - docs: TASKS.md, TEST_NOTES.md (Windows verify checklist), install/report updates
2026-08-11 23:37:29 +07:00
parent aae0b05473
commit c3368d0a91
37 changed files with 2970 additions and 80 deletions
@@ -0,0 +1,48 @@
+// native_bridge/include/SharedMemoryIPC.h
+#pragma once
+#include <cstdint>
+
+#define AUDIO_BLOCK_SIZE 256
+
+// WARNING: volatile is NOT a sync primitive. Real impl should use an
+// interlocked/index-flag pair or a Win32 event (SetEvent) signalled by the
+// writer. This struct follows the spec layout so Rust/JS mapping stays in sync.
+struct SharedAudioBufferIPC {
+    // Synchronization Flags
+    volatile uint32_t clientReadIndex;
+    volatile uint32_t bridgeWriteIndex;
+
+    // PCM Float32 Audio Buffers
+    float masterLeft[AUDIO_BLOCK_SIZE];
+    float masterRight[AUDIO_BLOCK_SIZE];
+
+    // Latency probe: bridge stamps every rendered block (QueryPerformanceCounter)
+    volatile uint64_t blockTimestamp;
+
+    // MIDI Event Exchange Queue
+    struct MidiEventIPC {
+        uint8_t command;      // 0x9 note on / 0x8 note off / 0xB CC / 0xC program / 0xE pitch bend
+        uint8_t channel;
+        uint8_t pitch;        // note number (0x9/0x8) or CC number (0xB)
+        uint8_t velocity;     // 0-127 (0x9 + vel=0 == note off)
+        uint8_t data2;        // CC value / program number / PB LSB
+        uint8_t data3;        // PB MSB (0xE only)
+        uint8_t reserved[2];  // explicit padding — keeps C/Rust layout stable
+        uint32_t sampleOffset;
+    } midiQueue[64];
+
+    volatile uint32_t midiQueueCount;
+
+    // Transport / Control (added vs spec: Stop/Play flush, instrument switch)
+    struct ControlEventIPC {
+        uint32_t type;        // 0 = NONE, 1 = PANIC/ALL_NOTES_OFF, 2 = LOAD_INSTRUMENT,
+                              // 3 = TRANSPORT, 4 = OPEN_GUI
+        uint32_t arg0;        // LOAD: instrument type (InstrumentType);
+                              // TRANSPORT: 0=STOP, 1=PLAY, 2=SET_POSITION
+        uint32_t arg1;        // LOAD: string length (bytes) of path;
+                              // TRANSPORT: playheadSamples (for timeline sync)
+        uint32_t channel;     // LOAD: MIDI channel to assign instrument to (A10)
+        char     arg2[1024];  // LOAD: UTF-8 path
+    } controlQueue[8];
+    volatile uint32_t controlQueueCount;
+};