@kelnishi/satmouse-client 0.9.1 → 0.9.4

package/dist/react/index.d.cts

@@ -119,7 +119,18 @@ type AxisMap = {
     rz: keyof Vec3;
 };
 
+/** Per-device transform overrides. Any field left undefined inherits from global defaults. */
+interface DeviceConfig {
+    sensitivity?: Partial<SensitivityConfig>;
+    flip?: Partial<FlipConfig>;
+    deadZone?: number;
+    dominant?: boolean;
+    axisRemap?: Partial<AxisMap>;
+    lockPosition?: boolean;
+    lockRotation?: boolean;
+}
 interface InputConfig {
+    /** Global defaults applied to all devices */
     sensitivity: SensitivityConfig;
     flip: FlipConfig;
     deadZone: number;
@@ -127,6 +138,12 @@ interface InputConfig {
     axisRemap: AxisMap;
     lockPosition: boolean;
     lockRotation: boolean;
+    /**
+     * Per-device overrides, keyed by device ID (e.g., "spacemouse-c635")
+     * or device family pattern (e.g., "spacemouse-*", "hid-054c-*").
+     * Values override global defaults for matching devices.
+     */
+    devices: Record<string, DeviceConfig>;
 }
 
 interface StorageAdapter {
@@ -148,18 +165,25 @@ interface InputManagerEvents {
     /** Configuration changed */
     configChange: (config: InputConfig) => void;
 }
+/** A connected device paired with its resolved configuration */
+interface DeviceWithConfig {
+    device: DeviceInfo$1;
+    config: DeviceConfig;
+}
 /**
  * Unified device service that wraps one or more SatMouseConnections
  * and provides a single processed event stream.
  *
- * Applies a configurable transform pipeline to spatial data:
+ * Applies a configurable transform pipeline per-device:
  *   deadZone → dominant → flip → axisRemap → sensitivity → lock
  *
- * Persists settings to storage (localStorage by default).
+ * Per-device overrides are resolved from InputConfig.devices using
+ * device ID matching (exact or pattern with wildcard "*").
  */
 declare class InputManager extends TypedEmitter<InputManagerEvents> {
     private connections;
     private storage?;
+    private knownDevices;
     private _config;
     get config(): InputConfig;
     constructor(config?: Partial<InputConfig>, storage?: StorageAdapter);
@@ -173,8 +197,14 @@ declare class InputManager extends TypedEmitter<InputManagerEvents> {
     disconnect(): void;
     /** Fetch device info from all connections */
     fetchDeviceInfo(): Promise<DeviceInfo$1[]>;
-    /** Update configuration. Persists by default. */
+    /** Get all known connected devices paired with their resolved config */
+    getDevicesWithConfig(): DeviceWithConfig[];
+    /** Get the resolved per-device config (global defaults + device overrides) */
+    getDeviceConfig(deviceId: string): DeviceConfig;
+    /** Update global configuration. Persists by default. */
     updateConfig(partial: Partial<InputConfig>, persist?: boolean): void;
+    /** Update configuration for a specific device. Persists by default. */
+    updateDeviceConfig(deviceId: string, partial: DeviceConfig, persist?: boolean): void;
     /** Register a callback for processed spatial data. Returns unsubscribe function. */
     onSpatialData(callback: (data: SpatialData) => void): () => void;
     /** Register a callback for button events. Returns unsubscribe function. */

package/dist/react/index.d.ts

@@ -119,7 +119,18 @@ type AxisMap = {
     rz: keyof Vec3;
 };
 
+/** Per-device transform overrides. Any field left undefined inherits from global defaults. */
+interface DeviceConfig {
+    sensitivity?: Partial<SensitivityConfig>;
+    flip?: Partial<FlipConfig>;
+    deadZone?: number;
+    dominant?: boolean;
+    axisRemap?: Partial<AxisMap>;
+    lockPosition?: boolean;
+    lockRotation?: boolean;
+}
 interface InputConfig {
+    /** Global defaults applied to all devices */
     sensitivity: SensitivityConfig;
     flip: FlipConfig;
     deadZone: number;
@@ -127,6 +138,12 @@ interface InputConfig {
     axisRemap: AxisMap;
     lockPosition: boolean;
     lockRotation: boolean;
+    /**
+     * Per-device overrides, keyed by device ID (e.g., "spacemouse-c635")
+     * or device family pattern (e.g., "spacemouse-*", "hid-054c-*").
+     * Values override global defaults for matching devices.
+     */
+    devices: Record<string, DeviceConfig>;
 }
 
 interface StorageAdapter {
@@ -148,18 +165,25 @@ interface InputManagerEvents {
     /** Configuration changed */
     configChange: (config: InputConfig) => void;
 }
+/** A connected device paired with its resolved configuration */
+interface DeviceWithConfig {
+    device: DeviceInfo$1;
+    config: DeviceConfig;
+}
 /**
  * Unified device service that wraps one or more SatMouseConnections
  * and provides a single processed event stream.
  *
- * Applies a configurable transform pipeline to spatial data:
+ * Applies a configurable transform pipeline per-device:
  *   deadZone → dominant → flip → axisRemap → sensitivity → lock
  *
- * Persists settings to storage (localStorage by default).
+ * Per-device overrides are resolved from InputConfig.devices using
+ * device ID matching (exact or pattern with wildcard "*").
  */
 declare class InputManager extends TypedEmitter<InputManagerEvents> {
     private connections;
     private storage?;
+    private knownDevices;
     private _config;
     get config(): InputConfig;
     constructor(config?: Partial<InputConfig>, storage?: StorageAdapter);
@@ -173,8 +197,14 @@ declare class InputManager extends TypedEmitter<InputManagerEvents> {
     disconnect(): void;
     /** Fetch device info from all connections */
     fetchDeviceInfo(): Promise<DeviceInfo$1[]>;
-    /** Update configuration. Persists by default. */
+    /** Get all known connected devices paired with their resolved config */
+    getDevicesWithConfig(): DeviceWithConfig[];
+    /** Get the resolved per-device config (global defaults + device overrides) */
+    getDeviceConfig(deviceId: string): DeviceConfig;
+    /** Update global configuration. Persists by default. */
     updateConfig(partial: Partial<InputConfig>, persist?: boolean): void;
+    /** Update configuration for a specific device. Persists by default. */
+    updateDeviceConfig(deviceId: string, partial: DeviceConfig, persist?: boolean): void;
     /** Register a callback for processed spatial data. Returns unsubscribe function. */
     onSpatialData(callback: (data: SpatialData) => void): () => void;
     /** Register a callback for button events. Returns unsubscribe function. */

package/dist/react/index.js

@@ -433,15 +433,57 @@ var DEFAULT_CONFIG = {
   dominant: false,
   axisRemap: { tx: "x", ty: "y", tz: "z", rx: "x", ry: "y", rz: "z" },
   lockPosition: false,
-  lockRotation: false
+  lockRotation: false,
+  devices: {}
 };
 function mergeConfig(base, partial) {
-  return {
+  const merged = {
     ...base,
     ...partial,
     sensitivity: { ...base.sensitivity, ...partial.sensitivity },
     flip: { ...base.flip, ...partial.flip },
-    axisRemap: { ...base.axisRemap, ...partial.axisRemap }
+    axisRemap: { ...base.axisRemap, ...partial.axisRemap },
+    devices: { ...base.devices }
+  };
+  if (partial.devices) {
+    for (const [key, devCfg] of Object.entries(partial.devices)) {
+      merged.devices[key] = mergeDeviceConfig(merged.devices[key], devCfg);
+    }
+  }
+  return merged;
+}
+function mergeDeviceConfig(base, partial) {
+  if (!base) return partial;
+  return {
+    ...base,
+    ...partial,
+    sensitivity: partial.sensitivity ? { ...base.sensitivity, ...partial.sensitivity } : base.sensitivity,
+    flip: partial.flip ? { ...base.flip, ...partial.flip } : base.flip,
+    axisRemap: partial.axisRemap ? { ...base.axisRemap, ...partial.axisRemap } : base.axisRemap
+  };
+}
+function resolveDeviceConfig(config, deviceId) {
+  let deviceOverride;
+  if (config.devices[deviceId]) {
+    deviceOverride = config.devices[deviceId];
+  } else {
+    for (const [pattern, cfg] of Object.entries(config.devices)) {
+      if (pattern.endsWith("*") && deviceId.startsWith(pattern.slice(0, -1))) {
+        deviceOverride = cfg;
+        break;
+      }
+    }
+  }
+  if (!deviceOverride) return config;
+  return {
+    ...config,
+    sensitivity: { ...config.sensitivity, ...deviceOverride.sensitivity },
+    flip: { ...config.flip, ...deviceOverride.flip },
+    deadZone: deviceOverride.deadZone ?? config.deadZone,
+    dominant: deviceOverride.dominant ?? config.dominant,
+    axisRemap: { ...config.axisRemap, ...deviceOverride.axisRemap },
+    lockPosition: deviceOverride.lockPosition ?? config.lockPosition,
+    lockRotation: deviceOverride.lockRotation ?? config.lockRotation
   };
 }
 
@@ -553,6 +595,7 @@ function applyAxisRemap(data, map) {
 var InputManager = class extends TypedEmitter {
   connections = [];
   storage;
+  knownDevices = /* @__PURE__ */ new Map();
   _config;
   get config() {
     return this._config;
@@ -585,14 +628,45 @@ var InputManager = class extends TypedEmitter {
   /** Fetch device info from all connections */
   async fetchDeviceInfo() {
     const results = await Promise.all(this.connections.map((c) => c.fetchDeviceInfo()));
-    return results.flat();
+    const devices = results.flat();
+    for (const d of devices) this.knownDevices.set(d.id, d);
+    return devices;
+  }
+  /** Get all known connected devices paired with their resolved config */
+  getDevicesWithConfig() {
+    return Array.from(this.knownDevices.values()).map((device) => ({
+      device,
+      config: this.getDeviceConfig(device.id)
+    }));
+  }
+  /** Get the resolved per-device config (global defaults + device overrides) */
+  getDeviceConfig(deviceId) {
+    const resolved = resolveDeviceConfig(this._config, deviceId);
+    return {
+      sensitivity: resolved.sensitivity,
+      flip: resolved.flip,
+      deadZone: resolved.deadZone,
+      dominant: resolved.dominant,
+      axisRemap: resolved.axisRemap,
+      lockPosition: resolved.lockPosition,
+      lockRotation: resolved.lockRotation
+    };
   }
-  /** Update configuration. Persists by default. */
+  /** Update global configuration. Persists by default. */
   updateConfig(partial, persist = true) {
     this._config = mergeConfig(this._config, partial);
     if (persist) saveSettings(this._config, this.storage);
     this.emit("configChange", this._config);
   }
+  /** Update configuration for a specific device. Persists by default. */
+  updateDeviceConfig(deviceId, partial, persist = true) {
+    const existing = this._config.devices[deviceId] ?? {};
+    this._config = mergeConfig(this._config, {
+      devices: { [deviceId]: { ...existing, ...partial } }
+    });
+    if (persist) saveSettings(this._config, this.storage);
+    this.emit("configChange", this._config);
+  }
   /** Register a callback for processed spatial data. Returns unsubscribe function. */
   onSpatialData(callback) {
     this.on("spatialData", callback);
@@ -611,7 +685,11 @@ var InputManager = class extends TypedEmitter {
     });
     connection.on("buttonEvent", (event) => this.emit("buttonEvent", event));
     connection.on("stateChange", (state, proto) => this.emit("stateChange", state, proto));
-    connection.on("deviceStatus", (event, device) => this.emit("deviceStatus", event, device));
+    connection.on("deviceStatus", (event, device) => {
+      if (event === "connected") this.knownDevices.set(device.id, device);
+      else this.knownDevices.delete(device.id);
+      this.emit("deviceStatus", event, device);
+    });
   }
   processSpatialData(raw) {
     const cfg = this._config;