@kelnishi/satmouse-client 0.9.4 → 0.9.5

package/dist/react/index.d.cts

@@ -119,6 +119,29 @@ type AxisMap = {
     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 */
+    source: InputAxis;
+    /** Scale multiplier (default: 1) */
+    scale?: number;
+    /** Invert the value (default: false) */
+    invert?: 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. */
 interface DeviceConfig {
     sensitivity?: Partial<SensitivityConfig>;
@@ -126,6 +149,7 @@ interface DeviceConfig {
     deadZone?: number;
     dominant?: boolean;
     axisRemap?: Partial<AxisMap>;
+    actionMap?: ActionMap;
     lockPosition?: boolean;
     lockRotation?: boolean;
 }
@@ -138,6 +162,8 @@ interface InputConfig {
     axisRemap: AxisMap;
     lockPosition: boolean;
     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-*").
@@ -152,8 +178,10 @@ interface StorageAdapter {
 }
 
 interface InputManagerEvents {
-    /** Processed spatial data (after all transforms) */
+    /** 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) */
@@ -209,6 +237,8 @@ declare class InputManager extends TypedEmitter<InputManagerEvents> {
     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 processSpatialData;
 }

package/dist/react/index.d.ts

@@ -119,6 +119,29 @@ type AxisMap = {
     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 */
+    source: InputAxis;
+    /** Scale multiplier (default: 1) */
+    scale?: number;
+    /** Invert the value (default: false) */
+    invert?: 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. */
 interface DeviceConfig {
     sensitivity?: Partial<SensitivityConfig>;
@@ -126,6 +149,7 @@ interface DeviceConfig {
     deadZone?: number;
     dominant?: boolean;
     axisRemap?: Partial<AxisMap>;
+    actionMap?: ActionMap;
     lockPosition?: boolean;
     lockRotation?: boolean;
 }
@@ -138,6 +162,8 @@ interface InputConfig {
     axisRemap: AxisMap;
     lockPosition: boolean;
     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-*").
@@ -152,8 +178,10 @@ interface StorageAdapter {
 }
 
 interface InputManagerEvents {
-    /** Processed spatial data (after all transforms) */
+    /** 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) */
@@ -209,6 +237,8 @@ declare class InputManager extends TypedEmitter<InputManagerEvents> {
     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 processSpatialData;
 }

package/dist/react/index.js

@@ -425,6 +425,57 @@ function launchSatMouse(options) {
   });
 }
 
+// src/utils/action-map.ts
+var DEFAULT_ACTION_MAP = {
+  tx: { source: "tx" },
+  ty: { source: "ty" },
+  tz: { source: "tz" },
+  rx: { source: "rx" },
+  ry: { source: "ry" },
+  rz: { source: "rz" }
+};
+function readAxis(data, axis) {
+  switch (axis) {
+    case "tx":
+      return data.translation.x;
+    case "ty":
+      return data.translation.y;
+    case "tz":
+      return data.translation.z;
+    case "rx":
+      return data.rotation.x;
+    case "ry":
+      return data.rotation.y;
+    case "rz":
+      return data.rotation.z;
+  }
+}
+function applyActionMap(data, map) {
+  const result = {};
+  for (const [action, binding] of Object.entries(map)) {
+    let value = readAxis(data, binding.source);
+    if (binding.invert) value = -value;
+    value *= binding.scale ?? 1;
+    result[action] = value;
+  }
+  return result;
+}
+function actionValuesToSpatialData(values, timestamp) {
+  return {
+    translation: {
+      x: values.tx ?? 0,
+      y: values.ty ?? 0,
+      z: values.tz ?? 0
+    },
+    rotation: {
+      x: values.rx ?? 0,
+      y: values.ry ?? 0,
+      z: values.rz ?? 0
+    },
+    timestamp
+  };
+}
+
 // src/utils/config.ts
 var DEFAULT_CONFIG = {
   sensitivity: { translation: 1e-3, rotation: 1e-3 },
@@ -434,6 +485,7 @@ var DEFAULT_CONFIG = {
   axisRemap: { tx: "x", ty: "y", tz: "z", rx: "x", ry: "y", rz: "z" },
   lockPosition: false,
   lockRotation: false,
+  actionMap: { ...DEFAULT_ACTION_MAP },
   devices: {}
 };
 function mergeConfig(base, partial) {
@@ -443,6 +495,7 @@ function mergeConfig(base, partial) {
     sensitivity: { ...base.sensitivity, ...partial.sensitivity },
     flip: { ...base.flip, ...partial.flip },
     axisRemap: { ...base.axisRemap, ...partial.axisRemap },
+    actionMap: partial.actionMap ? { ...base.actionMap, ...partial.actionMap } : { ...base.actionMap },
     devices: { ...base.devices }
   };
   if (partial.devices) {
@@ -482,6 +535,7 @@ function resolveDeviceConfig(config, deviceId) {
     deadZone: deviceOverride.deadZone ?? config.deadZone,
     dominant: deviceOverride.dominant ?? config.dominant,
     axisRemap: { ...config.axisRemap, ...deviceOverride.axisRemap },
+    actionMap: deviceOverride.actionMap ? { ...config.actionMap, ...deviceOverride.actionMap } : config.actionMap,
     lockPosition: deviceOverride.lockPosition ?? config.lockPosition,
     lockRotation: deviceOverride.lockRotation ?? config.lockRotation
   };
@@ -648,6 +702,7 @@ var InputManager = class extends TypedEmitter {
       deadZone: resolved.deadZone,
       dominant: resolved.dominant,
       axisRemap: resolved.axisRemap,
+      actionMap: resolved.actionMap,
       lockPosition: resolved.lockPosition,
       lockRotation: resolved.lockRotation
     };
@@ -677,11 +732,17 @@ var InputManager = class extends TypedEmitter {
     this.on("buttonEvent", callback);
     return () => this.off("buttonEvent", callback);
   }
+  /** Register a callback for action values. Returns unsubscribe function. */
+  onActionValues(callback) {
+    this.on("actionValues", callback);
+    return () => this.off("actionValues", callback);
+  }
   wireConnection(connection) {
     connection.on("spatialData", (raw) => {
       this.emit("rawSpatialData", raw);
-      const processed = this.processSpatialData(raw);
-      if (processed) this.emit("spatialData", processed);
+      const { spatial, actions } = this.processSpatialData(raw);
+      if (spatial) this.emit("spatialData", spatial);
+      if (actions) this.emit("actionValues", actions);
     });
     connection.on("buttonEvent", (event) => this.emit("buttonEvent", event));
     connection.on("stateChange", (state, proto) => this.emit("stateChange", state, proto));
@@ -705,7 +766,9 @@ var InputManager = class extends TypedEmitter {
     if (cfg.lockRotation) {
       data = { ...data, rotation: { x: 0, y: 0, z: 0 } };
     }
-    return data;
+    const actions = applyActionMap(data, cfg.actionMap);
+    const spatial = actionValuesToSpatialData(actions, data.timestamp);
+    return { spatial, actions };
   }
 };
 var SatMouseContext = createContext(null);