refactor: fix THRUSTMASTER typo, make Axis final, and improve downcall error message

- Add VENDOR_THRUSTMASTER (0x044F) and deprecate typo VENDOR_THURSTMASTER
- Mark Axis class as final per project style guidelines
- Remove unused Locale import from ControllerType
- Correct javadoc in InputDevices.init describing failure behavior
- Provide descriptive UnsatisfiedLinkError in captureCallState overload of downcallHandle
- Add tests for Thrustmaster lookup and deprecated constant compatibility

Author: steffen-wilke

src/main/java/de/gurkenlabs/input4j/ControllerDatabase.java

@@ -35,7 +35,15 @@ public final class ControllerDatabase {
   public static final int VENDOR_LOGITECH = 0x046D;
 
   /** Known vendor ID for Thrustmaster. */
-  public static final int VENDOR_THURSTMASTER = 0x044F;
+  public static final int VENDOR_THRUSTMASTER = 0x044F;
+
+  /**
+   * Known vendor ID for Thrustmaster.
+   *
+   * @deprecated Typo in constant name, use {@link #VENDOR_THRUSTMASTER} instead.
+   */
+  @Deprecated
+  public static final int VENDOR_THURSTMASTER = VENDOR_THRUSTMASTER;
 
   /** Known vendor ID for Mad Catz. */
   public static final int VENDOR_MAD_CATZ = 0x0738;

src/main/java/de/gurkenlabs/input4j/ControllerType.java

@@ -1,7 +1,5 @@
 package de.gurkenlabs.input4j;
 
-import java.util.Locale;
-
 /**
  * Represents the type of game controller.
  * This enum is used to identify the category of a controller based on its vendor and product IDs.

src/main/java/de/gurkenlabs/input4j/InputDevices.java

@@ -92,7 +92,7 @@ public static InputDevicePlugin init(Frame owner, InputLibrary library) {
    *                         The plugin class must be a fully qualified class name of a class that implements the {@link InputDevicePlugin} interface.
    *                         <p>
    *                         This can be used to explicitly select a custom input library implementation.
-   *                         If the class is not found or cannot be instantiated, an {@link IOException} is thrown.
+   *                         If the class is not found or cannot be instantiated, null is returned and the error is logged.
    *                         The class must have a public no-argument constructor.
    *                         </p>
    * @return The initialized input device provider or null if the initialization fails.

src/main/java/de/gurkenlabs/input4j/components/Axis.java

@@ -6,7 +6,7 @@
 /**
  * Predefined axis component identifiers for standard gamepad controllers.
  */
-public class Axis {
+public final class Axis {
   private Axis() {}
 
   /** Maximum default axis ID value. */

src/main/java/de/gurkenlabs/input4j/foreign/NativeHelper.java

@@ -21,11 +21,14 @@ public static MethodHandle downcallHandle(MemorySegment address, FunctionDescrip
     return Linker.nativeLinker().downcallHandle(address, fdesc);
   }
 
-  public static MethodHandle downcallHandle(String name, FunctionDescriptor fdesc, String captureCallState){
+  public static MethodHandle downcallHandle(String name, FunctionDescriptor fdesc, String captureCallState) {
     Linker.Option ccs = Linker.Option.captureCallState(captureCallState);
     return Linker.nativeLinker().downcallHandle(
-            SymbolLookup.loaderLookup().find(name).or(() -> Linker.nativeLinker().defaultLookup().find(name)).orElseThrow(),
-            fdesc,
-            ccs);
+        SymbolLookup.loaderLookup().find(name)
+            .or(() -> Linker.nativeLinker().defaultLookup().find(name))
+            .orElseThrow(() -> new UnsatisfiedLinkError(
+                "Native symbol not found: " + name + " with descriptor " + fdesc)),
+        fdesc,
+        ccs);
   }
 }

src/test/java/de/gurkenlabs/input4j/ControllerDatabaseTests.java

@@ -50,6 +50,19 @@ void testLookupKnownController_8BitDo() {
     assertEquals(ControllerType.EIGHTBITDO, result.get().type());
   }
 
+  @Test
+  void testLookupKnownController_Thrustmaster() {
+    var result = ControllerDatabase.lookup(ControllerDatabase.VENDOR_THRUSTMASTER, 0x0F00);
+    assertTrue(result.isPresent());
+    assertEquals("Thrustmaster Wheel Xbox", result.get().displayName());
+  }
+
+  @Test
+  @SuppressWarnings("deprecation")
+  void testDeprecatedThrustmasterConstantEqualsCorrectConstant() {
+    assertEquals(ControllerDatabase.VENDOR_THRUSTMASTER, ControllerDatabase.VENDOR_THURSTMASTER);
+  }
+
   @Test
   void testLookupUnknownReturnsEmpty() {
     var result = ControllerDatabase.lookup(0x1234, 0x5678);