@kelnishi/satmouse-client 0.9.14 → 0.10.0

package/dist/utils/index.d.cts

@@ -1,99 +1,56 @@
-import { V as Vec3, S as SpatialData, D as DeviceInfo, e as TypedEmitter, B as ButtonEvent, a as ConnectionState, d as TransportProtocol, b as SatMouseConnection } from '../connection-5KQFvHoJ.cjs';
+import { S as SpatialData, D as DeviceInfo, e as TypedEmitter, B as ButtonEvent, a as ConnectionState, d as TransportProtocol, b as SatMouseConnection } from '../connection-DQxI5qib.cjs';
 
-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;
-};
-declare const DEFAULT_AXIS_MAP: AxisMap;
-declare function applyFlip(data: SpatialData, flip: FlipConfig): SpatialData;
-declare function applySensitivity(data: SpatialData, sens: SensitivityConfig): SpatialData;
-declare function applyDominant(data: SpatialData): SpatialData;
-declare function applyDeadZone(data: SpatialData, threshold: number): SpatialData;
-declare function applyAxisRemap(data: SpatialData, map: AxisMap): SpatialData;
-
-/** 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-";
+/** The 6 full output axes */
+declare const FULL_AXES: InputAxis[];
+/** 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>;
-/** Default passthrough — each axis maps to itself */
-declare const DEFAULT_ACTION_MAP: ActionMap;
-/** Result of applying an ActionMap to spatial data */
-type ActionValues = Record<string, number>;
-/** Apply an ActionMap to SpatialData, producing named action values */
-declare function applyActionMap(data: SpatialData, map: ActionMap): ActionValues;
-/**
- * Convert ActionValues back to SpatialData.
- * Only populates tx/ty/tz/rx/ry/rz keys if they exist as actions.
- */
-declare function actionValuesToSpatialData(values: ActionValues, timestamp: number): SpatialData;
-/** Swap two action bindings */
-declare function swapActions(map: ActionMap, actionA: string, actionB: string): ActionMap;
+/** Default 6DOF passthrough */
+declare const DEFAULT_ROUTES: AxisRoute[];
+/** Build passthrough routes from a device's axis list. Half-axes target their base axis.
+ *  Negative half-axes (e.g., "ty-") get flip: true. */
+declare function buildRoutes(axes: string[]): AxisRoute[];
+/** Apply routes to SpatialData. Multiple routes targeting the same axis accumulate.
+ *  @param scale — global scale multiplier applied to all routes */
+declare function applyRoutes(data: SpatialData, routes: AxisRoute[], scale?: number): SpatialData;
 
-/** 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>;
 }
 declare const DEFAULT_CONFIG: InputConfig;
 declare function mergeConfig(base: InputConfig, partial: Partial<InputConfig>): InputConfig;
-/** Resolve the effective config for a specific device by merging global + device overrides */
+/** Resolve the effective config for a specific device */
 declare function resolveDeviceConfig(config: InputConfig, deviceId: string): InputConfig;
 
 interface StorageAdapter {
@@ -104,36 +61,17 @@ declare function saveSettings(config: InputConfig, storage?: StorageAdapter): vo
 declare function loadSettings(storage?: StorageAdapter): Partial<InputConfig> | null;
 
 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) => void;
-    /** Configuration changed */
     configChange: (config: InputConfig) => void;
 }
-/** A connected device paired with its resolved configuration */
 interface DeviceWithConfig {
     device: DeviceInfo;
     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?;
@@ -144,36 +82,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[]>;
-    /** 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;
 }
 
-export { type ActionBinding, type ActionMap, type ActionValues, type AxisMap, DEFAULT_ACTION_MAP, DEFAULT_AXIS_MAP, DEFAULT_CONFIG, type DeviceConfig, type DeviceWithConfig, type FlipConfig, type InputAxis, type InputConfig, InputManager, type InputManagerEvents, type SensitivityConfig, type StorageAdapter, actionValuesToSpatialData, applyActionMap, applyAxisRemap, applyDeadZone, applyDominant, applyFlip, applySensitivity, loadSettings, mergeConfig, resolveDeviceConfig, saveSettings, swapActions };
+export { type AxisRoute, DEFAULT_CONFIG, DEFAULT_ROUTES, type DeviceConfig, type DeviceWithConfig, FULL_AXES, type InputAxis, type InputConfig, InputManager, type InputManagerEvents, type StorageAdapter, applyRoutes, buildRoutes, loadSettings, mergeConfig, resolveDeviceConfig, saveSettings };

package/dist/utils/index.d.ts

@@ -1,99 +1,56 @@
-import { V as Vec3, S as SpatialData, D as DeviceInfo, e as TypedEmitter, B as ButtonEvent, a as ConnectionState, d as TransportProtocol, b as SatMouseConnection } from '../connection-5KQFvHoJ.js';
+import { S as SpatialData, D as DeviceInfo, e as TypedEmitter, B as ButtonEvent, a as ConnectionState, d as TransportProtocol, b as SatMouseConnection } from '../connection-DQxI5qib.js';
 
-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;
-};
-declare const DEFAULT_AXIS_MAP: AxisMap;
-declare function applyFlip(data: SpatialData, flip: FlipConfig): SpatialData;
-declare function applySensitivity(data: SpatialData, sens: SensitivityConfig): SpatialData;
-declare function applyDominant(data: SpatialData): SpatialData;
-declare function applyDeadZone(data: SpatialData, threshold: number): SpatialData;
-declare function applyAxisRemap(data: SpatialData, map: AxisMap): SpatialData;
-
-/** 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-";
+/** The 6 full output axes */
+declare const FULL_AXES: InputAxis[];
+/** 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>;
-/** Default passthrough — each axis maps to itself */
-declare const DEFAULT_ACTION_MAP: ActionMap;
-/** Result of applying an ActionMap to spatial data */
-type ActionValues = Record<string, number>;
-/** Apply an ActionMap to SpatialData, producing named action values */
-declare function applyActionMap(data: SpatialData, map: ActionMap): ActionValues;
-/**
- * Convert ActionValues back to SpatialData.
- * Only populates tx/ty/tz/rx/ry/rz keys if they exist as actions.
- */
-declare function actionValuesToSpatialData(values: ActionValues, timestamp: number): SpatialData;
-/** Swap two action bindings */
-declare function swapActions(map: ActionMap, actionA: string, actionB: string): ActionMap;
+/** Default 6DOF passthrough */
+declare const DEFAULT_ROUTES: AxisRoute[];
+/** Build passthrough routes from a device's axis list. Half-axes target their base axis.
+ *  Negative half-axes (e.g., "ty-") get flip: true. */
+declare function buildRoutes(axes: string[]): AxisRoute[];
+/** Apply routes to SpatialData. Multiple routes targeting the same axis accumulate.
+ *  @param scale — global scale multiplier applied to all routes */
+declare function applyRoutes(data: SpatialData, routes: AxisRoute[], scale?: number): SpatialData;
 
-/** 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>;
 }
 declare const DEFAULT_CONFIG: InputConfig;
 declare function mergeConfig(base: InputConfig, partial: Partial<InputConfig>): InputConfig;
-/** Resolve the effective config for a specific device by merging global + device overrides */
+/** Resolve the effective config for a specific device */
 declare function resolveDeviceConfig(config: InputConfig, deviceId: string): InputConfig;
 
 interface StorageAdapter {
@@ -104,36 +61,17 @@ declare function saveSettings(config: InputConfig, storage?: StorageAdapter): vo
 declare function loadSettings(storage?: StorageAdapter): Partial<InputConfig> | null;
 
 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) => void;
-    /** Configuration changed */
     configChange: (config: InputConfig) => void;
 }
-/** A connected device paired with its resolved configuration */
 interface DeviceWithConfig {
     device: DeviceInfo;
     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?;
@@ -144,36 +82,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[]>;
-    /** 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;
 }
 
-export { type ActionBinding, type ActionMap, type ActionValues, type AxisMap, DEFAULT_ACTION_MAP, DEFAULT_AXIS_MAP, DEFAULT_CONFIG, type DeviceConfig, type DeviceWithConfig, type FlipConfig, type InputAxis, type InputConfig, InputManager, type InputManagerEvents, type SensitivityConfig, type StorageAdapter, actionValuesToSpatialData, applyActionMap, applyAxisRemap, applyDeadZone, applyDominant, applyFlip, applySensitivity, loadSettings, mergeConfig, resolveDeviceConfig, saveSettings, swapActions };
+export { type AxisRoute, DEFAULT_CONFIG, DEFAULT_ROUTES, type DeviceConfig, type DeviceWithConfig, FULL_AXES, type InputAxis, type InputConfig, InputManager, type InputManagerEvents, type StorageAdapter, applyRoutes, buildRoutes, loadSettings, mergeConfig, resolveDeviceConfig, saveSettings };