@kelnishi/satmouse-client 0.16.1 → 0.17.0

package/README.md

@@ -73,33 +73,66 @@ function Scene() {
 <satmouse-debug></satmouse-debug>
 ```
 
-## Per-Device Configuration
+## Configuration
 
-Axis routing with per-device flip, scale, and remapping:
+### Device class defaults
+
+Set routes, scales, and behavior by device class — applies to all devices of that type:
 
 ```typescript
 const manager = new InputManager({
   translateScale: 0.001,
   rotateScale: 0.001,
-  wScale: 0.001,
-  devices: {
-    "cnx-*": {
+  deviceClasses: {
+    spacemouse: {
+      // Built-in default: flips Y/Z axes (3Dconnexion convention)
+      rotateScale: 0.0005,
+    },
+    gamepad: {
       routes: [
         { source: "tx", target: "tx" },
-        { source: "ty", target: "ty", flip: true },
-        { source: "tz", target: "tz", flip: true },
+        { source: "tz", target: "tz" },
         { source: "rx", target: "rx" },
-        { source: "ry", target: "ry", flip: true },
-        { source: "rz", target: "rz", flip: true },
+        { source: "rz", target: "rz" },
+        { source: "ty", target: "ty" },           // L2 trigger
+        { source: "ry", target: "ty", flip: true }, // R2 trigger (push-pull)
       ],
+      deadZone: 0.05,
     },
   },
 });
+```
+
+Device classes: `"spacemouse"`, `"gamepad"`, `"dial"`, `"joystick"`, `"6dof"`, `"other"`
+
+### Per-device overrides
+
+Override config for a specific device by ID or vendor pattern:
+
+```typescript
+const manager = new InputManager({
+  devices: {
+    // All PlayStation controllers (vendor 054c)
+    "hid-54c-*": { translateScale: 0.002 },
+    // A specific device by ID
+    "hid-54c-9cc-1": { dominant: true },
+  },
+});
 
-// Update per-device at runtime
+// Update at runtime
 manager.updateDeviceConfig("cnx-c635", { translateScale: 0.0005 });
 ```
 
+### Resolution order
+
+Config is resolved per-device in this priority:
+
+1. **Exact device ID** — `devices["hid-54c-9cc-1"]`
+2. **ID pattern** — `devices["hid-54c-*"]`
+3. **Device class** — `deviceClasses["gamepad"]`
+4. **Device axes metadata** — auto-generated passthrough from bridge
+5. **Global defaults** — `routes`, `translateScale`, etc.
+
 ## Button-to-Key Mapping
 
 Map device buttons to keyboard events:

package/dist/{connection-DXjjuaLv.d.cts → connection-DcA50IC2.d.cts}

@@ -162,4 +162,4 @@ declare class SatMouseConnection extends TypedEmitter<SatMouseEvents> {
     private clearReconnect;
 }
 
-export { type ButtonEvent as B, type ConnectOptions as C, type DeviceInfo as D, type SpatialData as S, type ThingDescription as T, type Vec3 as V, type ConnectionState as a, SatMouseConnection as b, type SatMouseEvents as c, type TransportProtocol as d, TypedEmitter as e, buildSatMouseUri as f, parseSatMouseUri as p };
+export { type ButtonEvent as B, type ConnectOptions as C, type DeviceInfo as D, type SpatialData as S, type ThingDescription as T, type Vec3 as V, type ConnectionState as a, SatMouseConnection as b, type SatMouseEvents as c, type TransportProtocol as d, TypedEmitter as e, buildSatMouseUri as f, type DeviceClass as g, parseSatMouseUri as p };

package/dist/{connection-DXjjuaLv.d.ts → connection-DcA50IC2.d.ts}

@@ -162,4 +162,4 @@ declare class SatMouseConnection extends TypedEmitter<SatMouseEvents> {
     private clearReconnect;
 }
 
-export { type ButtonEvent as B, type ConnectOptions as C, type DeviceInfo as D, type SpatialData as S, type ThingDescription as T, type Vec3 as V, type ConnectionState as a, SatMouseConnection as b, type SatMouseEvents as c, type TransportProtocol as d, TypedEmitter as e, buildSatMouseUri as f, parseSatMouseUri as p };
+export { type ButtonEvent as B, type ConnectOptions as C, type DeviceInfo as D, type SpatialData as S, type ThingDescription as T, type Vec3 as V, type ConnectionState as a, SatMouseConnection as b, type SatMouseEvents as c, type TransportProtocol as d, TypedEmitter as e, buildSatMouseUri as f, type DeviceClass as g, parseSatMouseUri as p };

package/dist/core/index.d.cts

@@ -1,5 +1,5 @@
-import { T as ThingDescription, S as SpatialData, B as ButtonEvent } from '../connection-DXjjuaLv.cjs';
-export { C as ConnectOptions, a as ConnectionState, D as DeviceInfo, b as SatMouseConnection, c as SatMouseEvents, d as TransportProtocol, e as TypedEmitter, V as Vec3, f as buildSatMouseUri, p as parseSatMouseUri } from '../connection-DXjjuaLv.cjs';
+import { T as ThingDescription, S as SpatialData, B as ButtonEvent } from '../connection-DcA50IC2.cjs';
+export { C as ConnectOptions, a as ConnectionState, D as DeviceInfo, b as SatMouseConnection, c as SatMouseEvents, d as TransportProtocol, e as TypedEmitter, V as Vec3, f as buildSatMouseUri, p as parseSatMouseUri } from '../connection-DcA50IC2.cjs';
 
 interface ResolvedEndpoints {
     webtransport?: {

package/dist/core/index.d.ts

@@ -1,5 +1,5 @@
-import { T as ThingDescription, S as SpatialData, B as ButtonEvent } from '../connection-DXjjuaLv.js';
-export { C as ConnectOptions, a as ConnectionState, D as DeviceInfo, b as SatMouseConnection, c as SatMouseEvents, d as TransportProtocol, e as TypedEmitter, V as Vec3, f as buildSatMouseUri, p as parseSatMouseUri } from '../connection-DXjjuaLv.js';
+import { T as ThingDescription, S as SpatialData, B as ButtonEvent } from '../connection-DcA50IC2.js';
+export { C as ConnectOptions, a as ConnectionState, D as DeviceInfo, b as SatMouseConnection, c as SatMouseEvents, d as TransportProtocol, e as TypedEmitter, V as Vec3, f as buildSatMouseUri, p as parseSatMouseUri } from '../connection-DcA50IC2.js';
 
 interface ResolvedEndpoints {
     webtransport?: {

package/dist/elements/index.d.cts

@@ -1,5 +1,5 @@
 import { InputManager } from '../utils/index.cjs';
-import '../connection-DXjjuaLv.cjs';
+import '../connection-DcA50IC2.cjs';
 
 declare class SatMouseStatus extends HTMLElement {
     private dot;

package/dist/elements/index.d.ts

@@ -1,5 +1,5 @@
 import { InputManager } from '../utils/index.js';
-import '../connection-DXjjuaLv.js';
+import '../connection-DcA50IC2.js';
 
 declare class SatMouseStatus extends HTMLElement {
     private dot;

package/dist/react/index.cjs

@@ -598,8 +598,9 @@ var DEFAULT_CONFIG = {
   dominant: false,
   lockPosition: false,
   lockRotation: false,
-  devices: {
-    "cnx-*": {
+  devices: {},
+  deviceClasses: {
+    spacemouse: {
       routes: [
         { source: "tx", target: "tx" },
         { source: "ty", target: "ty", flip: true },
@@ -608,17 +609,6 @@ var DEFAULT_CONFIG = {
         { source: "ry", target: "ry", flip: true },
         { source: "rz", target: "rz", flip: true }
       ]
-    },
-    // PlayStation: L2 (ty) → TY, R2 (ry) → TY flipped (push-pull)
-    "hid-54c-*": {
-      routes: [
-        { source: "tx", target: "tx" },
-        { source: "tz", target: "tz" },
-        { source: "rz", target: "rz" },
-        { source: "rx", target: "rx" },
-        { source: "ty", target: "ty" },
-        { source: "ry", target: "ty", flip: true }
-      ]
     }
   }
 };
@@ -628,16 +618,22 @@ function mergeConfig(base, partial) {
     ...partial,
     routes: partial.routes ?? [...base.routes],
     buttonRoutes: partial.buttonRoutes ?? [...base.buttonRoutes],
-    devices: { ...base.devices }
+    devices: { ...base.devices },
+    deviceClasses: { ...base.deviceClasses }
   };
   if (partial.devices) {
     for (const [key, devCfg] of Object.entries(partial.devices)) {
       merged.devices[key] = { ...merged.devices[key], ...devCfg };
     }
   }
+  if (partial.deviceClasses) {
+    for (const [key, classCfg] of Object.entries(partial.deviceClasses)) {
+      if (classCfg) merged.deviceClasses[key] = { ...merged.deviceClasses[key], ...classCfg };
+    }
+  }
   return merged;
 }
-function resolveDeviceConfig(config, deviceId) {
+function resolveDeviceConfig(config, deviceId, deviceClass) {
   let deviceOverride;
   if (config.devices[deviceId]) {
     deviceOverride = config.devices[deviceId];
@@ -649,6 +645,9 @@ function resolveDeviceConfig(config, deviceId) {
       }
     }
   }
+  if (!deviceOverride && deviceClass && config.deviceClasses[deviceClass]) {
+    deviceOverride = config.deviceClasses[deviceClass];
+  }
   if (!deviceOverride) return config;
   return {
     ...config,
@@ -764,7 +763,8 @@ var InputManager = class extends TypedEmitter {
     }));
   }
   getDeviceConfig(deviceId) {
-    const resolved = resolveDeviceConfig(this._config, deviceId);
+    const device = this.knownDevices.get(deviceId);
+    const resolved = resolveDeviceConfig(this._config, deviceId, device?.deviceClass);
     return {
       routes: resolved.routes,
       buttonRoutes: resolved.buttonRoutes,
@@ -868,7 +868,8 @@ var InputManager = class extends TypedEmitter {
   }
   /** Per-device: deadZone → dominant → routes (flip + scale + remap in one pass) */
   processPerDevice(raw, deviceId) {
-    const cfg = resolveDeviceConfig(this._config, deviceId);
+    const device = this.knownDevices.get(deviceId);
+    const cfg = resolveDeviceConfig(this._config, deviceId, device?.deviceClass);
     let data = raw;
     if (cfg.deadZone > 0) {
       const dz = (v) => Math.abs(v) < cfg.deadZone ? 0 : v;
@@ -894,12 +895,12 @@ var InputManager = class extends TypedEmitter {
       else r[max.k] = data.rotation[max.k];
       data = { ...data, translation: t, rotation: r };
     }
-    const device = this.knownDevices.get(deviceId);
     const deviceRoutes = this.resolveRoutes(deviceId, device);
     data = applyRoutes(data, deviceRoutes, cfg.translateScale, cfg.rotateScale, cfg.wScale);
     return data;
   }
-  /** Get the effective routes for a device: device config override > device axes metadata > global default */
+  /** Get the effective routes for a device:
+   *  device ID override > pattern match > deviceClass > device axes metadata > global default */
   resolveRoutes(deviceId, device) {
     const devCfg = this._config.devices[deviceId];
     if (devCfg?.routes && Array.isArray(devCfg.routes)) return devCfg.routes;
@@ -908,6 +909,10 @@ var InputManager = class extends TypedEmitter {
         if (cfg.routes && Array.isArray(cfg.routes)) return cfg.routes;
       }
     }
+    if (device?.deviceClass) {
+      const classCfg = this._config.deviceClasses[device.deviceClass];
+      if (classCfg?.routes && Array.isArray(classCfg.routes)) return classCfg.routes;
+    }
     if (device?.axes) return buildRoutes(device.axes);
     return DEFAULT_ROUTES;
   }