docs: update README C API table, add pause/resume/synth_to_bytes to all bindings

- README: add tts_pause, tts_resume, tts_synth_to_bytes, tts_free_bytes to C API table
- Python: add pause(), resume(), synth_to_bytes() with ctypes bindings
- .NET: add Pause(), Resume(), SynthToBytes() with P/Invoke declarations
- Swift: add pause(), resume(), synthToBytes() returning Data?
- Fix cbindgen.toml: remove duplicate after_includes/trailer (cpp_compat handles extern C)
- Regenerated header is now clean with single extern "C" block
- Clippy fixes: add #[must_use] to preprocess_speech_markdown, allow vec_init_then_push

Author: willwade

README.md

@@ -150,6 +150,10 @@ All functions are `extern "C"`, `#[no_mangle]`:
 | `tts_speak(ctx, text)` | Speak async, returns 0/-1 |
 | `tts_speak_sync(ctx, text)` | Speak sync (blocking) |
 | `tts_stop(ctx)` | Stop speech |
+| `tts_pause(ctx)` | Pause in-progress speech |
+| `tts_resume(ctx)` | Resume paused speech |
+| `tts_synth_to_bytes(ctx, text, out_bytes, out_len)` | Synth to buffer (returns 0/-1) |
+| `tts_free_bytes(bytes, len)` | Free buffer from tts_synth_to_bytes |
 | `tts_get_voices(ctx, out_voices, out_count)` | Get voice list |
 | `tts_free_voices(voices, count)` | Free voice array |
 | `tts_set_voice(ctx, voice_id)` | Set voice |

bindings/dotnet/TtsClient.cs

@@ -11,6 +11,10 @@ public static class Native
     [DllImport("rust_tts_wrapper")] public static extern int tts_speak(IntPtr ctx, string text);
     [DllImport("rust_tts_wrapper")] public static extern int tts_speak_sync(IntPtr ctx, string text);
     [DllImport("rust_tts_wrapper")] public static extern void tts_stop(IntPtr ctx);
+    [DllImport("rust_tts_wrapper")] public static extern void tts_pause(IntPtr ctx);
+    [DllImport("rust_tts_wrapper")] public static extern void tts_resume(IntPtr ctx);
+    [DllImport("rust_tts_wrapper")] public static extern int tts_synth_to_bytes(IntPtr ctx, string text, out IntPtr outBytes, out UIntPtr outLen);
+    [DllImport("rust_tts_wrapper")] public static extern void tts_free_bytes(IntPtr bytes, UIntPtr len);
     [DllImport("rust_tts_wrapper")] public static extern void tts_set_voice(IntPtr ctx, string voiceId);
     [DllImport("rust_tts_wrapper")] public static extern void tts_set_rate(IntPtr ctx, float rate);
     [DllImport("rust_tts_wrapper")] public static extern void tts_set_pitch(IntPtr ctx, float pitch);
@@ -46,6 +50,21 @@ public void SpeakSync(string text) =>
         Native.tts_speak_sync(_ctx, text);
 
     public void Stop() => Native.tts_stop(_ctx);
+    public void Pause() => Native.tts_pause(_ctx);
+    public void Resume() => Native.tts_resume(_ctx);
+
+    public byte[] SynthToBytes(string text)
+    {
+        IntPtr bufPtr;
+        UIntPtr len;
+        int result = Native.tts_synth_to_bytes(_ctx, text, out bufPtr, out len);
+        if (result != 0) throw new InvalidOperationException("Synthesis to bytes failed");
+        byte[] data = new byte[len.ToUInt32()];
+        if (data.Length > 0) Marshal.Copy(bufPtr, data, 0, data.Length);
+        Native.tts_free_bytes(bufPtr, len);
+        return data;
+    }
+
     public void SetVoice(string voiceId) => Native.tts_set_voice(_ctx, voiceId);
     public void SetRate(float rate) => Native.tts_set_rate(_ctx, rate);
     public void SetPitch(float pitch) => Native.tts_set_pitch(_ctx, pitch);

bindings/python/tts_wrapper.py

@@ -33,6 +33,14 @@ def _load_lib():
     _lib.tts_speak_sync.argtypes = [ctypes.c_void_p, ctypes.c_char_p]
     _lib.tts_stop.restype = None
     _lib.tts_stop.argtypes = [ctypes.c_void_p]
+    _lib.tts_pause.restype = None
+    _lib.tts_pause.argtypes = [ctypes.c_void_p]
+    _lib.tts_resume.restype = None
+    _lib.tts_resume.argtypes = [ctypes.c_void_p]
+    _lib.tts_synth_to_bytes.restype = ctypes.c_int32
+    _lib.tts_synth_to_bytes.argtypes = [ctypes.c_void_p, ctypes.c_char_p, ctypes.POINTER(ctypes.POINTER(ctypes.c_uint8)), ctypes.POINTER(ctypes.c_size_t)]
+    _lib.tts_free_bytes.restype = None
+    _lib.tts_free_bytes.argtypes = [ctypes.POINTER(ctypes.c_uint8), ctypes.c_size_t]
     _lib.tts_set_voice.restype = None
     _lib.tts_set_voice.argtypes = [ctypes.c_void_p, ctypes.c_char_p]
     _lib.tts_set_rate.restype = None
@@ -102,6 +110,23 @@ def speak_sync(self, text: str) -> None:
     def stop(self) -> None:
         self._lib.tts_stop(self._ctx)
 
+    def pause(self) -> None:
+        self._lib.tts_pause(self._ctx)
+
+    def resume(self) -> None:
+        self._lib.tts_resume(self._ctx)
+
+    def synth_to_bytes(self, text: str) -> bytes:
+        buf = ctypes.POINTER(ctypes.c_uint8)()
+        length = ctypes.c_size_t()
+        result = self._lib.tts_synth_to_bytes(self._ctx, text.encode(), ctypes.byref(buf), ctypes.byref(length))
+        if result != 0:
+            raise RuntimeError("Synthesis to bytes failed")
+        data = ctypes.string_at(buf, length.value) if buf and length.value > 0 else b""
+        if buf:
+            self._lib.tts_free_bytes(buf, length.value)
+        return data
+
     def set_voice(self, voice_id: str) -> None:
         self._lib.tts_set_voice(self._ctx, voice_id.encode())
 

bindings/swift/TtsClient.swift

@@ -55,6 +55,28 @@ public class TTSClient {
         rust_tts_wrapper.tts_stop(ctx)
     }
 
+    public func pause() {
+        guard let ctx else { return }
+        rust_tts_wrapper.tts_pause(ctx)
+    }
+
+    public func resume() {
+        guard let ctx else { return }
+        rust_tts_wrapper.tts_resume(ctx)
+    }
+
+    public func synthToBytes(_ text: String) -> Data? {
+        guard let ctx else { return nil }
+        var bufPtr: UnsafeMutablePointer<UInt8>?
+        var length: Int = 0
+        let result = text.withCString { textPtr in
+            rust_tts_wrapper.tts_synth_to_bytes(ctx, textPtr, &bufPtr, &length)
+        }
+        guard result == 0, let buf = bufPtr, length > 0 else { return nil }
+        defer { rust_tts_wrapper.tts_free_bytes(buf, UInt(length)) }
+        return Data(bytes: buf, count: length)
+    }
+
     public func setVoice(_ voiceId: String) {
         guard let ctx else { return }
         voiceId.withCString { ptr in

cbindgen.toml

@@ -4,5 +4,3 @@ autogen_warning = "/* Auto-generated. Do not edit. */"
 no_includes = true
 sys_includes = ["stdint.h", "stdbool.h"]
 cpp_compat = true
-after_includes = "#ifdef __cplusplus\nextern \"C\" {\n#endif"
-trailer = "#ifdef __cplusplus\n}\n#endif"

include/tts_wrapper.h

@@ -5,9 +5,6 @@
 
 #include <stdint.h>
 #include <stdbool.h>
-#ifdef __cplusplus
-extern "C" {
-#endif
 
 typedef struct tts_ctx tts_ctx;
 
@@ -66,6 +63,10 @@ typedef struct tts_engine_info {
   char *credential_keys_json;
 } tts_engine_info;
 
+#ifdef __cplusplus
+extern "C" {
+#endif // __cplusplus
+
 /**
  * Create a new TTS engine instance.
  *

src/engine.rs

@@ -42,6 +42,7 @@ pub fn preprocess_speech_markdown(text: &str, platform: &str) -> (String, bool)
 }
 
 #[cfg(not(feature = "cloud"))]
+#[must_use]
 pub fn preprocess_speech_markdown(text: &str, _platform: &str) -> (String, bool) {
     (text.to_string(), false)
 }

src/factory.rs

@@ -41,6 +41,7 @@ pub fn engine_count() -> usize {
 
 /// Return a list of all registered engine descriptors.
 #[must_use]
+#[allow(clippy::vec_init_then_push)]
 pub fn engine_list() -> Vec<EngineDescriptor> {
     let mut engines = Vec::new();