dualsense-ts 6.15.0 → 6.15.38

package/CHANGELOG.md

@@ -19,7 +19,7 @@ All notable changes to `dualsense-ts` are documented here. This project uses [Se
 
 - **DualSense Access controller support**: new `DualsenseAccess` class with full input reading and LED control over USB and Bluetooth
   - **Inputs**: 8 hardware buttons (B1–B8), center button, PS button, profile cycle button, analog stick (X/Y/click), battery level and charge status, active profile ID (1–3)
-  - **LED output**: RGB lightbar, 3-segment profile LEDs (off/on/fade/sweep), 6-segment player indicator (patterns 1–4), white status LED — all controllable over both USB and BT
+  - **LED output**: RGB lightbar, 3-segment profile LEDs (off/on/fade/sweep), 6-segment player indicator (patterns 1–4), white status LED - all controllable over both USB and BT
   - **Bluetooth**: full Report 0x31 support with automatic firmware animation dismiss on connect, CRC32 output reports, and Feature Report 0x05 mode switch
   - **Transports**: `AccessNodeHIDProvider` (node-hid) with multi-device enumeration and serial number targeting, `AccessWebHIDProvider` (WebHID) with permission dialog and device replacement, `AccessNullHIDProvider` (headless/testing)
   - **Identity**: firmware version, factory info (serial number, body color, board revision), and MAC address loaded automatically on connect with retry/backoff
@@ -36,10 +36,10 @@ All notable changes to `dualsense-ts` are documented here. This project uses [Se
 ### Added
 
 - **Orientation tracking**: `controller.orientation` provides fused 3D orientation (pitch, yaw, roll, quaternion) via a zero-dependency Madgwick AHRS filter, plus accelerometer-only `tiltPitch`/`tiltRoll` for drift-free gravity-reference applications. Filter gain (`beta`) is tunable at runtime
-- **Shake detection**: `controller.shake` detects shake intensity, frequency, and active state using per-axis Goertzel frequency analysis on first-difference signals. Reports both `frequency` (reversal rate) and `fundamental` (oscillation frequency), with a live `spectrum` of frequency bin powers. Configurable `threshold`, `windowSize`, `sustain`, `freqStep`, `freqMin`, and `freqMax` — all tunable at runtime
+- **Shake detection**: `controller.shake` detects shake intensity, frequency, and active state using per-axis Goertzel frequency analysis on first-difference signals. Reports both `frequency` (reversal rate) and `fundamental` (oscillation frequency), with a live `spectrum` of frequency bin powers. Configurable `threshold`, `windowSize`, `sustain`, `freqStep`, `freqMin`, and `freqMax` - all tunable at runtime
 - Axis remapping from DualSense Y-up to Madgwick Z-up convention for correct symmetric tilt behavior
 - Zero-gradient guard in the Madgwick filter to prevent NaN when gravity is already aligned
-- New `motion/` module: `Orientation`, `ShakeDetector`, `MadgwickFilter`, quaternion math — all zero-dependency
+- New `motion/` module: `Orientation`, `ShakeDetector`, `MadgwickFilter`, quaternion math - all zero-dependency
 
 ## [6.12.0] - 2026-04-14
 

package/README.md

@@ -11,7 +11,7 @@ Check out the **[interactive docs](https://nsfm.github.io/dualsense-ts/)**! Conn
 - **Automatic connection and reconnection** even when connection type changes
 - **[Multiplayer support](https://nsfm.github.io/dualsense-ts/multiplayer)**, allowing up to 31 connected controllers at a time
 - **Lighting control** covering [RGB light bars](https://nsfm.github.io/dualsense-ts/outputs/lightbar), [player LEDs](https://nsfm.github.io/dualsense-ts/outputs/player-leds), and [mute button](https://nsfm.github.io/dualsense-ts/outputs/mute-led)
-- **Full haptics control** over independent [left/right rumble](https://nsfm.github.io/dualsense-ts/outputs/rumble) plus complete [trigger haptics](https://nsfm.github.io/dualsense-ts/outputs/trigger-effects)
+- **Full haptics control** over independent [left/right rumble](https://nsfm.github.io/dualsense-ts/outputs/rumble) and [trigger haptics](https://nsfm.github.io/dualsense-ts/outputs/trigger-effects)
 - **[Touchpad support](https://nsfm.github.io/dualsense-ts/inputs/touchpad)** with full multi-touch handling
 - **[Motion tracking](https://nsfm.github.io/dualsense-ts/inputs/motion)** via factory-calibrated gyroscope and accelerometer, with built-in [orientation tracking](https://nsfm.github.io/dualsense-ts/api/orientation) and [shake detection](https://nsfm.github.io/dualsense-ts/api/shake-detector)
 - **[Battery status](https://nsfm.github.io/dualsense-ts/inputs/battery)** including level and charging state
@@ -61,7 +61,7 @@ controller.connection.active; // returns true while the controller is available
 controller.wireless; // returns true while connected over bluetooth
 ```
 
-When the user switches from wired to wireless or vice versa, `dualsense-ts` will reconnect to the same device seamlessly.
+When the user switches from wired to wireless or vice versa, `dualsense-ts` reconnects to the same device.
 
 ### [Input APIs](https://nsfm.github.io/dualsense-ts/inputs)
 
@@ -197,7 +197,7 @@ controller.accelerometer.z.on("change", ({ magnitude }) => {
 });
 ```
 
-Gyroscope and accelerometer readings are automatically calibrated using each controller's factory calibration data, which removes gyro bias drift and accelerometer zero-point offset. Calibration is applied transparently — you can inspect the resolved factors via `controller.calibration`. See [Factory Calibration](https://nsfm.github.io/dualsense-ts/inputs/motion) in the docs for details on bias removal, zero-point correction, and per-axis sensitivity normalization.
+Gyroscope and accelerometer readings are automatically calibrated using each controller's factory calibration data, which removes gyro bias drift and accelerometer zero-point offset. You can inspect the resolved calibration factors via `controller.calibration`, and the [Factory Calibration](https://nsfm.github.io/dualsense-ts/inputs/motion) docs cover the details.
 
 #### [Orientation Tracking](https://nsfm.github.io/dualsense-ts/api/orientation)
 
@@ -210,7 +210,7 @@ const { pitch, yaw, roll } = controller.orientation;
 // Quaternion for 3D rendering
 const [w, x, y, z] = controller.orientation.quaternion;
 
-// Accelerometer-only tilt — no drift, no yaw
+// Accelerometer-only tilt - no drift, no yaw
 const steer = controller.orientation.tiltRoll;
 
 // Tune the filter: lower beta = smoother, higher = less drift
@@ -277,7 +277,7 @@ controller.battery.level.on("change", ({ state }) => {
 });
 ```
 
-After connection it may take a second for these values to populate. Please note that the battery level is not a precise reading - it changes in 10% increments and is prone to flip-flopping. `dualsense-ts` makes an attempt to buffer and normalize these values.
+After connection it may take a second for these values to populate. The battery level is not a precise reading - it changes in 10% increments and is prone to flip-flopping. `dualsense-ts` makes an attempt to buffer and normalize these values.
 
 #### [Rumble](https://nsfm.github.io/dualsense-ts/outputs/rumble)
 
@@ -315,7 +315,7 @@ controller.right.trigger.feedback.set({
   strength: 0.8,
 });
 
-// Weapon trigger — resistance with snap release
+// Weapon trigger - resistance with snap release
 controller.right.trigger.feedback.set({
   effect: TriggerEffect.Weapon,
   start: 0.2,
@@ -342,7 +342,7 @@ console.log(controller.right.trigger.feedback.config);
 console.log(controller.right.trigger.feedback.effect); // TriggerEffect.Off
 ```
 
-Feedback state is automatically restored if the controller disconnects and reconnects - no handling required on your end.
+If the controller disconnects and reconnects, your feedback settings are restored automatically.
 
 #### Trigger effects
 
@@ -356,7 +356,7 @@ Feedback state is automatically restored if the controller disconnects and recon
 | `TriggerEffect.Vibration` | Zone-based oscillation with amplitude and frequency        |
 | `TriggerEffect.Machine`   | Dual-amplitude vibration with frequency and period control |
 
-Each effect accepts a unique set of configuration options; your editor's type hints will guide you through the available parameters for each effect. The [interactive docs](https://nsfm.github.io/dualsense-ts/outputs/trigger-effects) include full slider controls for every effect and parameter, making it a great tool for finding the right values.
+Each effect accepts its own set of configuration options - your editor's type hints will show you what's available. To find the right values, try the [interactive docs](https://nsfm.github.io/dualsense-ts/outputs/trigger-effects), which have slider controls for every effect and parameter.
 
 Effect names are based on [Nielk1's DualSense trigger effect documentation](https://gist.github.com/Nielk1/6d54cc2c00d2201ccb8c2720ad7538db).
 
@@ -367,17 +367,17 @@ You can control the controller's lightbar as well as the [player indicator](http
 ```typescript
 import { PlayerID, Brightness } from "dualsense-ts";
 
-// Light bar — set color with {r, g, b} (0–255 per channel)
+// Light bar - set color with {r, g, b} (0–255 per channel)
 controller.lightbar.set({ r: 255, g: 0, b: 128 });
 controller.lightbar.color; // { r: 255, g: 0, b: 128 }
 
-// Light bar pulse effects — firmware-driven one-shot animations
+// Light bar pulse effects - firmware-driven one-shot animations
 // This overrides your custom color
 controller.lightbar.fadeBlue(); // Fades to blue and holds
 // You must call `fadeOut()` to restore custom lightbar colors
 controller.lightbar.fadeOut(); // Fades to black, then returns to set color
 
-// Player indicator LEDs — 5 white LEDs, individually addressable
+// Player indicator LEDs - 5 white LEDs, individually addressable
 controller.playerLeds.set(PlayerID.Player1); // Use a preset pattern
 controller.playerLeds.setLed(0, true); // Toggle individual LEDs (0–4)
 controller.playerLeds.setLed(4, true);
@@ -516,7 +516,7 @@ The output report exposes per-subsystem power save flags. The **mute flags** (ha
 // Mute haptic output (confirmed working)
 controller.powerSave.hapticsMuted = true;
 
-// Send disable flags (advisory — no confirmed observable effect)
+// Send disable flags (advisory - no confirmed observable effect)
 controller.powerSave.set({ motion: false, touch: false });
 
 // Re-enable everything
@@ -537,7 +537,7 @@ import { Dualsense, type Input } from "dualsense-ts";
 const controller = new Dualsense();
 export const ControllerContext = createContext(controller);
 
-// Hook — subscribes to any input, re-renders on change
+// Hook - subscribes to any input, re-renders on change
 function useControllerInput<T extends Input<T>>(
   selector: (c: Dualsense) => T,
 ): T {
@@ -595,8 +595,8 @@ This only applies to the first connection for each controller.
 ### Accessing controllers
 
 ```typescript
-manager.controllers; // readonly Dualsense[] — all managed controllers
-manager.get(0); // Dualsense | undefined — by slot index
+manager.controllers; // readonly Dualsense[] - all managed controllers
+manager.get(0); // Dualsense | undefined - by slot index
 manager.count; // number of managed slots (including disconnected)
 manager.state.active; // number of currently connected controllers
 
@@ -702,7 +702,7 @@ controller.left.analog.on("change", (s) => move(s.x.state, s.y.state));
 controller.dpad.up.on("press", () => selectPrevious());
 ```
 
-Available mapped inputs: `left` / `right` ([Unisense](https://nsfm.github.io/dualsense-ts/api/unisense) — stick, trigger, bumper), `dpad`, `cross`, `circle`, `square`, `triangle`, `touchpad` (button only), `options`, `create`, `mute`.
+Available mapped inputs: `left` / `right` ([Unisense](https://nsfm.github.io/dualsense-ts/api/unisense) - stick, trigger, bumper), `dpad`, `cross`, `circle`, `square`, `triangle`, `touchpad` (button only), `options`, `create`, `mute`.
 
 ### [LED control](https://nsfm.github.io/dualsense-ts/access/led-control)
 
@@ -714,12 +714,12 @@ import { AccessProfileLedMode, AccessPlayerIndicator } from "dualsense-ts";
 // RGB lightbar (same API as DualSense)
 access.lightbar.set({ r: 255, g: 0, b: 128 });
 
-// Profile LEDs — 3-segment arc
+// Profile LEDs - 3-segment arc
 access.profileLeds.set(AccessProfileLedMode.Sweep);
 access.profileLeds.set(AccessProfileLedMode.Fade);
 access.profileLeds.set(AccessProfileLedMode.Off);
 
-// Player indicator — 6-segment ring
+// Player indicator - 6-segment ring
 access.playerIndicator.set(AccessPlayerIndicator.Player1);
 access.playerIndicator.set(AccessPlayerIndicator.Off);
 
@@ -743,7 +743,7 @@ console.log(`Board: ${access.factoryInfo.boardRevision}`);
 
 ### Browser usage
 
-In Node.js, `new DualsenseAccess()` auto-connects — no extra setup needed. In the browser, WebHID requires a one-time user gesture to grant device permission:
+In Node.js, `new DualsenseAccess()` auto-connects without any extra setup. In the browser, WebHID requires a one-time user gesture to grant device permission:
 
 ```typescript
 import { DualsenseAccess } from "dualsense-ts";
@@ -819,7 +819,7 @@ sudo modprobe hidp
 sudo systemctl restart bluetooth
 ```
 
-This is a BlueZ-specific issue — Windows and macOS handle pairing seamlessly. The standard DualSense is not affected.
+This is a BlueZ-specific issue; Windows and macOS pair without any fuss. The standard DualSense is not affected.
 
 ## Migration Guide
 

package/dist/dualsense.d.ts

@@ -102,7 +102,7 @@ export declare class Dualsense extends Input<Dualsense> {
      */
     readonly shake: ShakeDetector;
     /** Monotonic sensor timestamp in microseconds from the controller's clock.
-     *  Updated with each input report — useful for correlating motion sensor
+     *  Updated with each input report - useful for correlating motion sensor
      *  readings with other inputs across frames. Wraps at 2^32 (~71.6 minutes). */
     sensorTimestamp: number;
     /** Previous sensor timestamp for computing dt (microseconds). */
@@ -129,7 +129,7 @@ export declare class Dualsense extends Input<Dualsense> {
     /**
      * IMU calibration factors derived from the controller's factory calibration
      * data (Feature Report 0x05).  Applied automatically to gyroscope and
-     * accelerometer readings — exposed here for inspection and diagnostics.
+     * accelerometer readings - exposed here for inspection and diagnostics.
      */
     get calibration(): ResolvedCalibration;
     /** A virtual button representing whether or not a controller is connected */
@@ -152,8 +152,8 @@ export declare class Dualsense extends Input<Dualsense> {
     /**
      * Play a built-in test tone via the onboard DSP.
      * Works over both USB and Bluetooth. Call `stopTestTone()` to stop.
-     * @param target Output destination — "speaker" (default) or "headphone"
-     * @param tone Which tone to play — "1khz" (default), "100hz", or "both"
+     * @param target Output destination - "speaker" (default) or "headphone"
+     * @param tone Which tone to play - "1khz" (default), "100hz", or "both"
      */
     startTestTone(target?: "speaker" | "headphone", tone?: "1khz" | "100hz" | "both"): Promise<void>;
     /** Stop the DSP test tone */

package/dist/dualsense.js

@@ -24,7 +24,7 @@ class Dualsense extends input_1.Input {
     /**
      * IMU calibration factors derived from the controller's factory calibration
      * data (Feature Report 0x05).  Applied automatically to gyroscope and
-     * accelerometer readings — exposed here for inspection and diagnostics.
+     * accelerometer readings - exposed here for inspection and diagnostics.
      */
     get calibration() {
         return this.hid.calibration;
@@ -60,7 +60,7 @@ class Dualsense extends input_1.Input {
         /** Per-subsystem power save controls (disable touch, motion, haptics, audio) */
         this.powerSave = new elements_1.PowerSaveControl();
         /** Monotonic sensor timestamp in microseconds from the controller's clock.
-         *  Updated with each input report — useful for correlating motion sensor
+         *  Updated with each input report - useful for correlating motion sensor
          *  readings with other inputs across frames. Wraps at 2^32 (~71.6 minutes). */
         this.sensorTimestamp = 0;
         /** Previous sensor timestamp for computing dt (microseconds). */
@@ -164,7 +164,7 @@ class Dualsense extends input_1.Input {
         this.connection[input_1.InputSet](false);
         // If a HID instance was supplied externally (e.g. by DualsenseManager),
         // the owner is responsible for driving discovery + reconnection.
-        // `hid: null` creates a headless instance with no provider — useful for
+        // `hid: null` creates a headless instance with no provider - useful for
         // placeholder controllers in UIs where WebHID may not be available.
         // Otherwise, construct a default platform provider and run our own
         // discovery loop.
@@ -324,8 +324,8 @@ class Dualsense extends input_1.Input {
     /**
      * Play a built-in test tone via the onboard DSP.
      * Works over both USB and Bluetooth. Call `stopTestTone()` to stop.
-     * @param target Output destination — "speaker" (default) or "headphone"
-     * @param tone Which tone to play — "1khz" (default), "100hz", or "both"
+     * @param target Output destination - "speaker" (default) or "headphone"
+     * @param tone Which tone to play - "1khz" (default), "100hz", or "both"
      */
     async startTestTone(target = "speaker", tone = "1khz") {
         return this.hid.startTestTone(target, tone);

package/dist/dualsense_access.d.ts

@@ -93,27 +93,27 @@ export declare class DualsenseAccess extends Input<DualsenseAccess> {
     readonly profile: Momentary;
     /** Analog stick (x, y, button = stick click) */
     readonly stick: Analog;
-    /** Left stick, trigger (L2), and bumper (L1) — profile-mapped */
+    /** Left stick, trigger (L2), and bumper (L1) - profile-mapped */
     readonly left: Unisense;
-    /** Right stick, trigger (R2), and bumper (R1) — profile-mapped */
+    /** Right stick, trigger (R2), and bumper (R1) - profile-mapped */
     readonly right: Unisense;
-    /** D-pad — profile-mapped */
+    /** D-pad - profile-mapped */
     readonly dpad: Dpad;
-    /** Cross button — profile-mapped */
+    /** Cross button - profile-mapped */
     readonly cross: Momentary;
-    /** Circle button — profile-mapped */
+    /** Circle button - profile-mapped */
     readonly circle: Momentary;
-    /** Square button — profile-mapped */
+    /** Square button - profile-mapped */
     readonly square: Momentary;
-    /** Triangle button — profile-mapped */
+    /** Triangle button - profile-mapped */
     readonly triangle: Momentary;
-    /** Touchpad (button only, contacts stay at neutral) — profile-mapped */
+    /** Touchpad (button only, contacts stay at neutral) - profile-mapped */
     readonly touchpad: Touchpad;
-    /** Options button — profile-mapped */
+    /** Options button - profile-mapped */
     readonly options: Momentary;
-    /** Create button — profile-mapped */
+    /** Create button - profile-mapped */
     readonly create: Momentary;
-    /** Mute button — profile-mapped */
+    /** Mute button - profile-mapped */
     readonly mute: Mute;
     /** Battery level and charging status */
     readonly battery: Battery;

package/dist/dualsense_access.js

@@ -204,7 +204,7 @@ class DualsenseAccess extends input_1.Input {
             this.pendingBattery.peakLevel = 0;
         }, 1000));
         // Output loop (30Hz)
-        // When any subsystem changes, send all 4 in one report — the Access
+        // When any subsystem changes, send all 4 in one report - the Access
         // controller over BT requires combined mutator + LED_FLAGS_1.
         this.timers.push(setInterval(() => {
             if (!this.connection.active)

package/dist/elements/trigger_feedback.d.ts

@@ -1,6 +1,6 @@
 /** Canonical trigger effect types from the DualSense firmware */
 export declare enum TriggerEffect {
-    /** No resistance — default linear feel */
+    /** No resistance - default linear feel */
     Off = "off",
     /** Zone-based continuous resistance */
     Feedback = "feedback",

package/dist/elements/trigger_feedback.js

@@ -5,7 +5,7 @@ exports.buildTriggerEffectBlock = buildTriggerEffectBlock;
 /** Canonical trigger effect types from the DualSense firmware */
 var TriggerEffect;
 (function (TriggerEffect) {
-    /** No resistance — default linear feel */
+    /** No resistance - default linear feel */
     TriggerEffect["Off"] = "off";
     /** Zone-based continuous resistance */
     TriggerEffect["Feedback"] = "feedback";

package/dist/hid/access/access_node_hid_provider.d.ts

@@ -20,9 +20,9 @@ export declare class AccessNodeHIDProvider extends AccessHIDProvider {
     wireless?: boolean;
     buffer?: Buffer;
     private connecting;
-    /** Target device path — mutable so the manager can update it */
+    /** Target device path - mutable so the manager can update it */
     targetPath?: string;
-    /** Target serial number — stable identifier for reconnection */
+    /** Target serial number - stable identifier for reconnection */
     targetSerial?: string;
     constructor(options?: AccessNodeHIDProviderOptions);
     /** List all available DualSense Access controllers */

package/dist/hid/access/access_node_hid_provider.js

@@ -50,7 +50,7 @@ class AccessNodeHIDProvider extends access_hid_provider_1.AccessHIDProvider {
             const { HID, devices } = nodeHid;
             const allDevices = devices(access_hid_provider_1.AccessHIDProvider.vendorId, access_hid_provider_1.AccessHIDProvider.productId);
             // Filter to the correct HID usage (gamepad). BT devices expose
-            // multiple hidraw nodes — only one has the right usagePage/usage.
+            // multiple hidraw nodes - only one has the right usagePage/usage.
             const controllers = allDevices.filter((d) => d.usagePage === access_hid_provider_1.AccessHIDProvider.usagePage &&
                 d.usage === access_hid_provider_1.AccessHIDProvider.usage);
             // Find a suitable controller: targeted path, then serial match, then first unclaimed
@@ -77,12 +77,12 @@ class AccessNodeHIDProvider extends access_hid_provider_1.AccessHIDProvider {
             this.serialNumber = target.serialNumber ?? undefined;
             access_hid_provider_1.AccessHIDProvider.claimedDevices.add(target.path);
             // Read Feature Report 0x05 to trigger BT full mode (same as DualSense).
-            // No IMU calibration to parse — Access has no IMU.
+            // No IMU calibration to parse - Access has no IMU.
             try {
                 device.getFeatureReport(0x05, 41);
             }
             catch {
-                /* non-fatal — USB doesn't strictly need this */
+                /* non-fatal - USB doesn't strictly need this */
             }
             device.on("data", (arg) => {
                 this.buffer = arg;

package/dist/hid/access_hid.d.ts

@@ -172,7 +172,7 @@ export declare const AccessMutator: {
     /** Combined: all LED subsystems */
     readonly ALL_LEDS: 21;
 };
-/** Scope B flag bits (AccessOutput.SCOPE_B byte) — needed for BT output */
+/** Scope B flag bits (AccessOutput.SCOPE_B byte) - needed for BT output */
 export declare const AccessScopeB: {
     /** Required for lightbar RGB over BT (both this AND AccessMutator.LED must be set) */
     readonly LED: 4;

package/dist/hid/access_hid.js

@@ -181,7 +181,7 @@ exports.AccessMutator = {
     /** Combined: all LED subsystems */
     ALL_LEDS: 0x15, // STATUS_LED | LED | PLAYER_INDICATOR_LED
 };
-/** Scope B flag bits (AccessOutput.SCOPE_B byte) — needed for BT output */
+/** Scope B flag bits (AccessOutput.SCOPE_B byte) - needed for BT output */
 exports.AccessScopeB = {
     /** Required for lightbar RGB over BT (both this AND AccessMutator.LED must be set) */
     LED: 0x04,

package/dist/hid/calibration.d.ts

@@ -69,7 +69,7 @@ export declare const DefaultResolvedCalibration: ResolvedCalibration;
  * Parse Feature Report 0x05 into an {@link IMUCalibration}.
  *
  * The report may or may not include the report-ID byte as the first
- * element depending on platform — the parser auto-detects.
+ * element depending on platform - the parser auto-detects.
  */
 export declare function parseIMUCalibration(buf: Uint8Array): IMUCalibration;
 /**

package/dist/hid/calibration.js

@@ -44,7 +44,7 @@ function readInt16LE(buf, offset) {
  * Parse Feature Report 0x05 into an {@link IMUCalibration}.
  *
  * The report may or may not include the report-ID byte as the first
- * element depending on platform — the parser auto-detects.
+ * element depending on platform - the parser auto-detects.
  */
 function parseIMUCalibration(buf) {
     const off = buf[0] === REPORT_ID ? 1 : 0;

package/dist/hid/command.d.ts

@@ -26,7 +26,7 @@ export declare enum PlayerID {
     Player4 = 27,
     All = 31
 }
-/** Audio output routing — controls how L/R channels map to headphone and speaker */
+/** Audio output routing - controls how L/R channels map to headphone and speaker */
 export declare enum AudioOutput {
     /** Stereo L+R to headphone, speaker muted */
     Headphone = 0,
@@ -49,7 +49,7 @@ export declare enum MicFlag {
     EchoCancellation = 4,
     NoiseCancellation = 8
 }
-/** Microphone input mode — bits 6-7 of audio flags */
+/** Microphone input mode - bits 6-7 of audio flags */
 export declare enum MicMode {
     /** Default mode */
     Default = 0,
@@ -58,7 +58,7 @@ export declare enum MicMode {
     /** Automatic speech recognition mode */
     ASR = 128
 }
-/** Power save control — per-subsystem mute/disable flags (byte 10) */
+/** Power save control - per-subsystem mute/disable flags (byte 10) */
 export declare enum PowerSave {
     DisableTouch = 1,
     DisableMotion = 2,
@@ -95,9 +95,9 @@ type Intensity = number;
 export interface DualsenseCommand extends Uint8Array {
     /** Packet type */
     [0]: 0x2;
-    /** Scope A — which subsystems are affected */
+    /** Scope A - which subsystems are affected */
     [1]: CommandScopeA | 0xff;
-    /** Scope B — which subsystems are affected */
+    /** Scope B - which subsystems are affected */
     [2]: CommandScopeB | (0x1 | 0x2 | 0x4 | 0x10 | 0x40);
     /** Right rumble intensity */
     [3]: Intensity;
@@ -113,7 +113,7 @@ export interface DualsenseCommand extends Uint8Array {
     [8]: number;
     /** Mute button LED mode */
     [9]: MuteLedMode;
-    /** Power save control — per-subsystem mute/disable bitfield */
+    /** Power save control - per-subsystem mute/disable bitfield */
     [10]: PowerSave | 0x00;
     [11]: number;
     [12]: number;

package/dist/hid/command.js

@@ -34,7 +34,7 @@ var PlayerID;
     PlayerID[PlayerID["Player4"] = 27] = "Player4";
     PlayerID[PlayerID["All"] = 31] = "All";
 })(PlayerID || (exports.PlayerID = PlayerID = {}));
-/** Audio output routing — controls how L/R channels map to headphone and speaker */
+/** Audio output routing - controls how L/R channels map to headphone and speaker */
 var AudioOutput;
 (function (AudioOutput) {
     /** Stereo L+R to headphone, speaker muted */
@@ -60,7 +60,7 @@ var MicFlag;
     MicFlag[MicFlag["EchoCancellation"] = 4] = "EchoCancellation";
     MicFlag[MicFlag["NoiseCancellation"] = 8] = "NoiseCancellation";
 })(MicFlag || (exports.MicFlag = MicFlag = {}));
-/** Microphone input mode — bits 6-7 of audio flags */
+/** Microphone input mode - bits 6-7 of audio flags */
 var MicMode;
 (function (MicMode) {
     /** Default mode */
@@ -70,7 +70,7 @@ var MicMode;
     /** Automatic speech recognition mode */
     MicMode[MicMode["ASR"] = 128] = "ASR";
 })(MicMode || (exports.MicMode = MicMode = {}));
-/** Power save control — per-subsystem mute/disable flags (byte 10) */
+/** Power save control - per-subsystem mute/disable flags (byte 10) */
 var PowerSave;
 (function (PowerSave) {
     PowerSave[PowerSave["DisableTouch"] = 1] = "DisableTouch";

package/dist/hid/dsp.d.ts

@@ -33,7 +33,7 @@ export declare enum DspDevice {
     Memory = 3,
     AnalogData = 4,
     Touch = 5,
-    /** Audio DSP — test tone, codec, mic calibration */
+    /** Audio DSP - test tone, codec, mic calibration */
     Audio = 6,
     AdaptiveTrigger = 7,
     Bullet = 8,
@@ -63,7 +63,7 @@ export declare enum AudioAction {
      *
      * Both tones can play simultaneously ([1, 1, 1]).
      * No other byte values (0–255) produce additional tones.
-     * Write-only — returns no response data.
+     * Write-only - returns no response data.
      */
     WaveoutCtrl = 2,
     /**
@@ -78,7 +78,7 @@ export declare enum AudioAction {
      *   Headphone: params[4] = 4, params[6] = 6
      *   All other bytes: zero in reference impl, no effect found in sweep (0–10).
      *
-     * Write-only — returns no response data.
+     * Write-only - returns no response data.
      */
     SetPathSelector = 4,
     /** Speaker compensation (EQ/filter). Write-only. */
@@ -97,13 +97,13 @@ export declare enum AudioAction {
     TryMicCalibGain = 11,
     /** Set compensation status. Write-only. */
     SetCompStatus = 12,
-    /** Get compensation status. No response observed — may require prior SetCompStatus. */
+    /** Get compensation status. No response observed - may require prior SetCompStatus. */
     GetCompStatus = 13,
     /** Execute forced compensation. Write-only. */
     ExecForceComp = 14,
     /** Set auto-calibration status. Write-only. */
     SetAutoCalibStatus = 15,
-    /** Get auto-calibration status. No response observed — may require prior SetAutoCalibStatus. */
+    /** Get auto-calibration status. No response observed - may require prior SetAutoCalibStatus. */
     GetAutoCalibStatus = 16,
     /**
      * Direct register write to ALC5524 codec. Write-only.
@@ -123,7 +123,7 @@ export declare enum DspStatus {
     Idle = 0,
     Running = 1,
     Complete = 2,
-    /** Multi-part response — more data follows */
+    /** Multi-part response - more data follows */
     CompleteMulti = 3,
     Timeout = 255
 }

package/dist/hid/dsp.js

@@ -37,7 +37,7 @@ var DspDevice;
     DspDevice[DspDevice["Memory"] = 3] = "Memory";
     DspDevice[DspDevice["AnalogData"] = 4] = "AnalogData";
     DspDevice[DspDevice["Touch"] = 5] = "Touch";
-    /** Audio DSP — test tone, codec, mic calibration */
+    /** Audio DSP - test tone, codec, mic calibration */
     DspDevice[DspDevice["Audio"] = 6] = "Audio";
     DspDevice[DspDevice["AdaptiveTrigger"] = 7] = "AdaptiveTrigger";
     DspDevice[DspDevice["Bullet"] = 8] = "Bullet";
@@ -68,7 +68,7 @@ var AudioAction;
      *
      * Both tones can play simultaneously ([1, 1, 1]).
      * No other byte values (0–255) produce additional tones.
-     * Write-only — returns no response data.
+     * Write-only - returns no response data.
      */
     AudioAction[AudioAction["WaveoutCtrl"] = 2] = "WaveoutCtrl";
     /**
@@ -83,7 +83,7 @@ var AudioAction;
      *   Headphone: params[4] = 4, params[6] = 6
      *   All other bytes: zero in reference impl, no effect found in sweep (0–10).
      *
-     * Write-only — returns no response data.
+     * Write-only - returns no response data.
      */
     AudioAction[AudioAction["SetPathSelector"] = 4] = "SetPathSelector";
     /** Speaker compensation (EQ/filter). Write-only. */
@@ -102,13 +102,13 @@ var AudioAction;
     AudioAction[AudioAction["TryMicCalibGain"] = 11] = "TryMicCalibGain";
     /** Set compensation status. Write-only. */
     AudioAction[AudioAction["SetCompStatus"] = 12] = "SetCompStatus";
-    /** Get compensation status. No response observed — may require prior SetCompStatus. */
+    /** Get compensation status. No response observed - may require prior SetCompStatus. */
     AudioAction[AudioAction["GetCompStatus"] = 13] = "GetCompStatus";
     /** Execute forced compensation. Write-only. */
     AudioAction[AudioAction["ExecForceComp"] = 14] = "ExecForceComp";
     /** Set auto-calibration status. Write-only. */
     AudioAction[AudioAction["SetAutoCalibStatus"] = 15] = "SetAutoCalibStatus";
-    /** Get auto-calibration status. No response observed — may require prior SetAutoCalibStatus. */
+    /** Get auto-calibration status. No response observed - may require prior SetAutoCalibStatus. */
     AudioAction[AudioAction["GetAutoCalibStatus"] = 16] = "GetAutoCalibStatus";
     /**
      * Direct register write to ALC5524 codec. Write-only.
@@ -129,7 +129,7 @@ var DspStatus;
     DspStatus[DspStatus["Idle"] = 0] = "Idle";
     DspStatus[DspStatus["Running"] = 1] = "Running";
     DspStatus[DspStatus["Complete"] = 2] = "Complete";
-    /** Multi-part response — more data follows */
+    /** Multi-part response - more data follows */
     DspStatus[DspStatus["CompleteMulti"] = 3] = "CompleteMulti";
     DspStatus[DspStatus["Timeout"] = 255] = "Timeout";
 })(DspStatus || (exports.DspStatus = DspStatus = {}));

package/dist/hid/dualsense_hid.d.ts

@@ -53,7 +53,7 @@ export declare class DualsenseHID {
     on(type: string, callback: ErrorCallback): void;
     /**
      * Subscribe to notification when firmware/factory info finishes loading
-     * after a connect. Fires once per connection — either when identity has
+     * after a connect. Fires once per connection - either when identity has
      * been resolved, or when we've given up retrying. If identity is already
      * resolved at the time of subscription, the callback fires synchronously.
      */
@@ -155,15 +155,15 @@ export declare class DualsenseHID {
      * Start a DSP test tone on speaker or headphone.
      * Sets volume routing via the standard output report before triggering.
      *
-     * @param target Output destination — "speaker" (default) or "headphone"
-     * @param tone Which tone to play — "1khz" (default), "100hz", or "both"
+     * @param target Output destination - "speaker" (default) or "headphone"
+     * @param tone Which tone to play - "1khz" (default), "100hz", or "both"
      */
     startTestTone(target?: "speaker" | "headphone", tone?: "1khz" | "100hz" | "both"): Promise<void>;
     /** Stop the DSP test tone */
     stopTestTone(): Promise<void>;
     /**
      * Send a raw DSP test command (Feature Report 0x80).
-     * For experimentation — lets you send arbitrary device/action/params.
+     * For experimentation - lets you send arbitrary device/action/params.
      */
     sendTestCommand(deviceId: number, actionId: number, params?: Uint8Array): Promise<void>;
     /** Feature report ID for DSP test responses */