@kelnishi/satmouse-client 0.9.14 → 0.10.0

package/dist/react/index.d.cts

@@ -40,6 +40,12 @@ interface DeviceInfo$1 {
     productId?: number;
     connectionType?: "usb" | "wireless" | "bluetooth" | "unknown";
     connected?: boolean;
+    /** Axes this device provides (e.g., ["tx","ty","tz","rx","ry","rz"] or ["tx","ty","rx","ry","tz+","rz+"]) */
+    axes?: string[];
+    /** Human-readable labels for axes (same order as axes array) */
+    axisLabels?: string[];
+    /** Number of buttons this device provides */
+    buttonCount?: number;
 }
 type ConnectionState = "disconnected" | "connecting" | "connected" | "failed";
 type TransportProtocol = "webtransport" | "websocket" | "none";
@@ -104,78 +110,42 @@ declare class SatMouseConnection extends TypedEmitter<SatMouseEvents> {
     private clearReconnect;
 }
 
-interface FlipConfig {
-    tx: boolean;
-    ty: boolean;
-    tz: boolean;
-    rx: boolean;
-    ry: boolean;
-    rz: boolean;
-}
-interface SensitivityConfig {
-    translation: number;
-    rotation: number;
-}
-/** Maps each input axis to an output axis. E.g., { tx: "tz", tz: "tx" } swaps X and Z translation. */
-type AxisMap = {
-    tx: keyof Vec3;
-    ty: keyof Vec3;
-    tz: keyof Vec3;
-    rx: keyof Vec3;
-    ry: keyof Vec3;
-    rz: keyof Vec3;
-};
-
-/** Input axis identifier */
-type InputAxis = "tx" | "ty" | "tz" | "rx" | "ry" | "rz";
-/** A single action binding — maps one input axis to a named output */
-interface ActionBinding {
-    /** Which input axis drives this action */
+/** Axis identifier — full or half */
+type InputAxis = "tx" | "ty" | "tz" | "rx" | "ry" | "rz" | "tx+" | "ty+" | "tz+" | "rx+" | "ry+" | "rz+" | "tx-" | "ty-" | "tz-" | "rx-" | "ry-" | "rz-";
+/** A single axis route — reads from source, writes to target */
+interface AxisRoute {
     source: InputAxis;
-    /** Scale multiplier (default: 1) */
-    scale?: number;
-    /** Invert the value (default: false) */
-    invert?: boolean;
+    target: InputAxis;
+    /** Negate the value (default: false) */
+    flip?: boolean;
 }
-/**
- * ActionMap defines how raw 6DOF axes map to named output actions.
- *
- * Client apps declare the actions they support and how device axes
- * feed into them. Users can reassign axes via the settings UI.
- *
- * Default: 6 actions matching the 6 input axes (passthrough).
- */
-type ActionMap = Record<string, ActionBinding>;
-/** Result of applying an ActionMap to spatial data */
-type ActionValues = Record<string, number>;
 
-/** Per-device transform overrides. Any field left undefined inherits from global defaults. */
+/** Per-device configuration */
 interface DeviceConfig {
-    sensitivity?: Partial<SensitivityConfig>;
-    flip?: Partial<FlipConfig>;
+    /** Axis routing — each entry maps a device input to an output with optional flip */
+    routes?: AxisRoute[];
+    /** Scale multiplier applied to all axes (default: 1) */
+    scale?: number;
+    /** Dead zone threshold (0-1). Values below this are zeroed. */
     deadZone?: number;
+    /** Only pass the strongest axis, zero all others */
     dominant?: boolean;
-    axisRemap?: Partial<AxisMap>;
-    actionMap?: ActionMap;
-    lockPosition?: boolean;
-    lockRotation?: boolean;
 }
+/** Global configuration */
 interface InputConfig {
-    /** Global defaults applied to all devices */
-    sensitivity: SensitivityConfig;
-    flip: FlipConfig;
+    /** Default axis routes (used when device has no override) */
+    routes: AxisRoute[];
+    /** Default scale */
+    scale: number;
+    /** Dead zone threshold */
     deadZone: number;
+    /** Dominant axis mode */
     dominant: boolean;
-    axisRemap: AxisMap;
+    /** Lock translation to zero */
     lockPosition: boolean;
+    /** Lock rotation to zero */
     lockRotation: boolean;
-    /** Action map — maps input axes to named output actions. Default: passthrough. */
-    actionMap: ActionMap;
-    /**
-     * 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.
-     */
+    /** Per-device overrides keyed by device ID or pattern (e.g., "cnx-*") */
     devices: Record<string, DeviceConfig>;
 }
 
@@ -185,36 +155,17 @@ interface StorageAdapter {
 }
 
 interface InputManagerEvents {
-    /** Processed spatial data (after all transforms + action map) */
     spatialData: (data: SpatialData) => void;
-    /** Named action values from the action map */
-    actionValues: (values: ActionValues) => void;
-    /** Raw spatial data (before transforms) */
     rawSpatialData: (data: SpatialData) => void;
-    /** Button event (pass-through from connection) */
     buttonEvent: (data: ButtonEvent) => void;
-    /** Connection state changed */
     stateChange: (state: ConnectionState, protocol: TransportProtocol) => void;
-    /** Device connected/disconnected */
     deviceStatus: (event: "connected" | "disconnected", device: DeviceInfo$1) => void;
-    /** 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 per-device:
- *   deadZone → dominant → flip → axisRemap → sensitivity → lock
- *
- * 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?;
@@ -225,36 +176,25 @@ declare class InputManager extends TypedEmitter<InputManagerEvents> {
     private _config;
     get config(): InputConfig;
     constructor(config?: Partial<InputConfig>, storage?: StorageAdapter);
-    /** Add a connection to the managed set */
     addConnection(connection: SatMouseConnection): void;
-    /** Remove a connection */
     removeConnection(connection: SatMouseConnection): void;
-    /** Connect all managed connections */
     connect(): Promise<void>;
-    /** Disconnect all managed connections */
     disconnect(): void;
-    /** Fetch device info from all connections */
     fetchDeviceInfo(): Promise<DeviceInfo$1[]>;
-    /** 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. */
+    resetDeviceConfig(deviceId: string, persist?: boolean): void;
+    resetAllConfig(): void;
     onSpatialData(callback: (data: SpatialData) => void): () => void;
-    /** Register a callback for button events. Returns unsubscribe function. */
     onButtonEvent(callback: (data: ButtonEvent) => void): () => void;
-    /** Register a callback for action values. Returns unsubscribe function. */
-    onActionValues(callback: (values: ActionValues) => void): () => void;
     private wireConnection;
     private flushAccumulator;
-    /** Per-device transforms: flip, sensitivity, dead zone, dominant, axis remap */
+    /** Per-device: deadZone → dominant → routes (flip + scale + remap in one pass) */
     private processPerDevice;
-    /** Global transforms applied after per-device merge: locks + action map */
-    private applyGlobalTransforms;
+    /** Get the effective routes for a device: device config override > device axes metadata > global default */
+    private resolveRoutes;
 }
 
 interface SatMouseContextValue {

package/dist/react/index.d.ts

@@ -40,6 +40,12 @@ interface DeviceInfo$1 {
     productId?: number;
     connectionType?: "usb" | "wireless" | "bluetooth" | "unknown";
     connected?: boolean;
+    /** Axes this device provides (e.g., ["tx","ty","tz","rx","ry","rz"] or ["tx","ty","rx","ry","tz+","rz+"]) */
+    axes?: string[];
+    /** Human-readable labels for axes (same order as axes array) */
+    axisLabels?: string[];
+    /** Number of buttons this device provides */
+    buttonCount?: number;
 }
 type ConnectionState = "disconnected" | "connecting" | "connected" | "failed";
 type TransportProtocol = "webtransport" | "websocket" | "none";
@@ -104,78 +110,42 @@ declare class SatMouseConnection extends TypedEmitter<SatMouseEvents> {
     private clearReconnect;
 }
 
-interface FlipConfig {
-    tx: boolean;
-    ty: boolean;
-    tz: boolean;
-    rx: boolean;
-    ry: boolean;
-    rz: boolean;
-}
-interface SensitivityConfig {
-    translation: number;
-    rotation: number;
-}
-/** Maps each input axis to an output axis. E.g., { tx: "tz", tz: "tx" } swaps X and Z translation. */
-type AxisMap = {
-    tx: keyof Vec3;
-    ty: keyof Vec3;
-    tz: keyof Vec3;
-    rx: keyof Vec3;
-    ry: keyof Vec3;
-    rz: keyof Vec3;
-};
-
-/** Input axis identifier */
-type InputAxis = "tx" | "ty" | "tz" | "rx" | "ry" | "rz";
-/** A single action binding — maps one input axis to a named output */
-interface ActionBinding {
-    /** Which input axis drives this action */
+/** Axis identifier — full or half */
+type InputAxis = "tx" | "ty" | "tz" | "rx" | "ry" | "rz" | "tx+" | "ty+" | "tz+" | "rx+" | "ry+" | "rz+" | "tx-" | "ty-" | "tz-" | "rx-" | "ry-" | "rz-";
+/** A single axis route — reads from source, writes to target */
+interface AxisRoute {
     source: InputAxis;
-    /** Scale multiplier (default: 1) */
-    scale?: number;
-    /** Invert the value (default: false) */
-    invert?: boolean;
+    target: InputAxis;
+    /** Negate the value (default: false) */
+    flip?: boolean;
 }
-/**
- * ActionMap defines how raw 6DOF axes map to named output actions.
- *
- * Client apps declare the actions they support and how device axes
- * feed into them. Users can reassign axes via the settings UI.
- *
- * Default: 6 actions matching the 6 input axes (passthrough).
- */
-type ActionMap = Record<string, ActionBinding>;
-/** Result of applying an ActionMap to spatial data */
-type ActionValues = Record<string, number>;
 
-/** Per-device transform overrides. Any field left undefined inherits from global defaults. */
+/** Per-device configuration */
 interface DeviceConfig {
-    sensitivity?: Partial<SensitivityConfig>;
-    flip?: Partial<FlipConfig>;
+    /** Axis routing — each entry maps a device input to an output with optional flip */
+    routes?: AxisRoute[];
+    /** Scale multiplier applied to all axes (default: 1) */
+    scale?: number;
+    /** Dead zone threshold (0-1). Values below this are zeroed. */
     deadZone?: number;
+    /** Only pass the strongest axis, zero all others */
     dominant?: boolean;
-    axisRemap?: Partial<AxisMap>;
-    actionMap?: ActionMap;
-    lockPosition?: boolean;
-    lockRotation?: boolean;
 }
+/** Global configuration */
 interface InputConfig {
-    /** Global defaults applied to all devices */
-    sensitivity: SensitivityConfig;
-    flip: FlipConfig;
+    /** Default axis routes (used when device has no override) */
+    routes: AxisRoute[];
+    /** Default scale */
+    scale: number;
+    /** Dead zone threshold */
     deadZone: number;
+    /** Dominant axis mode */
     dominant: boolean;
-    axisRemap: AxisMap;
+    /** Lock translation to zero */
     lockPosition: boolean;
+    /** Lock rotation to zero */
     lockRotation: boolean;
-    /** Action map — maps input axes to named output actions. Default: passthrough. */
-    actionMap: ActionMap;
-    /**
-     * 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.
-     */
+    /** Per-device overrides keyed by device ID or pattern (e.g., "cnx-*") */
     devices: Record<string, DeviceConfig>;
 }
 
@@ -185,36 +155,17 @@ interface StorageAdapter {
 }
 
 interface InputManagerEvents {
-    /** Processed spatial data (after all transforms + action map) */
     spatialData: (data: SpatialData) => void;
-    /** Named action values from the action map */
-    actionValues: (values: ActionValues) => void;
-    /** Raw spatial data (before transforms) */
     rawSpatialData: (data: SpatialData) => void;
-    /** Button event (pass-through from connection) */
     buttonEvent: (data: ButtonEvent) => void;
-    /** Connection state changed */
     stateChange: (state: ConnectionState, protocol: TransportProtocol) => void;
-    /** Device connected/disconnected */
     deviceStatus: (event: "connected" | "disconnected", device: DeviceInfo$1) => void;
-    /** 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 per-device:
- *   deadZone → dominant → flip → axisRemap → sensitivity → lock
- *
- * 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?;
@@ -225,36 +176,25 @@ declare class InputManager extends TypedEmitter<InputManagerEvents> {
     private _config;
     get config(): InputConfig;
     constructor(config?: Partial<InputConfig>, storage?: StorageAdapter);
-    /** Add a connection to the managed set */
     addConnection(connection: SatMouseConnection): void;
-    /** Remove a connection */
     removeConnection(connection: SatMouseConnection): void;
-    /** Connect all managed connections */
     connect(): Promise<void>;
-    /** Disconnect all managed connections */
     disconnect(): void;
-    /** Fetch device info from all connections */
     fetchDeviceInfo(): Promise<DeviceInfo$1[]>;
-    /** 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. */
+    resetDeviceConfig(deviceId: string, persist?: boolean): void;
+    resetAllConfig(): void;
     onSpatialData(callback: (data: SpatialData) => void): () => void;
-    /** Register a callback for button events. Returns unsubscribe function. */
     onButtonEvent(callback: (data: ButtonEvent) => void): () => void;
-    /** Register a callback for action values. Returns unsubscribe function. */
-    onActionValues(callback: (values: ActionValues) => void): () => void;
     private wireConnection;
     private flushAccumulator;
-    /** Per-device transforms: flip, sensitivity, dead zone, dominant, axis remap */
+    /** Per-device: deadZone → dominant → routes (flip + scale + remap in one pass) */
     private processPerDevice;
-    /** Global transforms applied after per-device merge: locks + action map */
-    private applyGlobalTransforms;
+    /** Get the effective routes for a device: device config override > device axes metadata > global default */
+    private resolveRoutes;
 }
 
 interface SatMouseContextValue {