feat(ds4api): add support for dynamic steering detection and error handling

Signed-off-by: Evan Wies <evan@neomantra.net>

Author: neomantra

ds4api/engine.go

@@ -126,7 +126,6 @@ func (e *Engine) Close() {
 	})
 }
 
-
 // require locks the engine and verifies it is open. The returned unlock
 // function MUST be called (typically via defer) to release the lock.
 func (e *Engine) require() (unlock func(), err error) {

ds4api/loader.go

@@ -92,6 +92,13 @@ func (l *Library) Path() string {
 	return l.path
 }
 
+// SupportsDynamicSteering reports whether the loaded library exports
+// ds4_session_set_directional_steering. When false, callers should rely on
+// engine-level (static) steering via EngineOptions.DirectionalSteering* fields.
+func (l *Library) SupportsDynamicSteering() bool {
+	return l != nil && l.raw.ds4SessionSetDirectionalSteering != nil
+}
+
 func (l *Library) register() (err error) {
 	defer func() {
 		if r := recover(); r != nil {

ds4api/mock_library.go

@@ -272,7 +272,9 @@ func NewMockLibrary() *Library {
 			snap.Ptr = nil
 		}
 	}
-	r.ds4SessionSetDirectionalSteering = func(s uintptr, file unsafe.Pointer, mode int32, ffn float32, attn float32, threshold float32, scope int32, err unsafe.Pointer, errLen uintptr) int32 { return 0 }
+	r.ds4SessionSetDirectionalSteering = func(s uintptr, file unsafe.Pointer, mode int32, ffn float32, attn float32, threshold float32, scope int32, err unsafe.Pointer, errLen uintptr) int32 {
+		return 0
+	}
 
 	return lib
 }

ds4api/session.go

@@ -1,12 +1,19 @@
 package ds4api
 
 import (
+	"errors"
 	"fmt"
 	"runtime"
 	"sync"
 	"unsafe"
 )
 
+// ErrSteeringNotSupported is returned by Session.SetDirectionalSteering when
+// the loaded libds4 build does not export ds4_session_set_directional_steering.
+// Callers can check with errors.Is and downgrade to a warning so the rest of
+// the program can continue without dynamic steering.
+var ErrSteeringNotSupported = errors.New("ds4: session directional steering is not supported by the loaded library (missing symbol)")
+
 // Session wraps a ds4_session.
 type Session struct {
 	lib     *Library
@@ -510,7 +517,7 @@ func (s *Session) SetDirectionalSteering(file string, mode SteeringMode, ffn flo
 	defer unlock()
 
 	if s.lib.raw.ds4SessionSetDirectionalSteering == nil {
-		return fmt.Errorf("ds4: session directional steering is not supported by the loaded library (missing symbol)")
+		return ErrSteeringNotSupported
 	}
 
 	buf, errPtr, n := errorBuffer()

internal/models/lock_test.go

@@ -117,4 +117,3 @@ func TestAcquireEngineRunLock(t *testing.T) {
 	}
 	lock2.Close()
 }
-

internal/models/progress.go

@@ -21,7 +21,6 @@ var (
 	progressRest = lipgloss.NewStyle().Foreground(colorPrimary).Background(colorSurface)
 )
 
-
 type progressReader struct {
 	out        io.Writer
 	name       string