dualsense-ts

# Changelog All notable changes to `dualsense-ts` are documented here. This project uses [Semantic Versioning](https://semver.org/). ## [6.15.0] - 2026-04-15 ### Added - **DualSense Access profile-mapped inputs**: `DualsenseAccess` now exposes a full DualSense-compatible input layer driven by the controller's active profile - Mapped sticks (`left.analog`, `right.analog`), triggers (`left.trigger`, `right.trigger`), bumpers (`left.bumper`, `right.bumper`), face buttons (`cross`, `circle`, `square`, `triangle`), D-pad, touchpad button, `options`, `create`, and `mute` - Same property names and types as `Dualsense` - code written for one works on both - Bluetooth limited mode (Report 0x01) now parses the mapped header, providing mapped inputs before Feature Report 0x05 triggers full mode - **Documentation app**: expanded Access section with 7 pages - Overview (with DualSense comparison table), Access Playground (interactive demo with all inputs and LED controls), Hardware Inputs, Profile Inputs, LED Control, Profile Management (WIP), and Expansion Slots (WIP) - Updated README with profile-mapped input examples and revised comparison table ## [6.14.0] - 2026-04-14 ### Added - **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 - **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 - **Documentation app**: new Access controller page with connect button, button state grid, stick visualization, and interactive LED controls - Hardware verification script (`scripts/verify_access.ts`) for walking through all input/output stages with a physical controller - Diagnostic scripts for BT LED protocol research (`scripts/access_led_demo.ts`, `scripts/access_bt_led_sweep.ts`, `scripts/access_bt_init_find.ts`) ### Fixed - `Dualsense` constructor used `params.square` instead of `params.connection` when configuring the connection input (copy-paste bug, no practical effect since `InputParams` only controls icon/name/threshold) ## [6.13.0] - 2026-04-13 ### 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 - 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 ## [6.12.0] - 2026-04-14 ### Added - **IMU calibration**:gyroscope and accelerometer readings now use per-unit factory calibration data (Feature Report 0x05) read automatically on connection. Removes gyro bias drift, corrects accelerometer zero-point offset, and normalises per-axis sensitivity so all three axes report consistent values for the same physical input - `controller.calibration` exposes the resolved calibration factors for inspection and diagnostics ## [6.11.0] - 2026-04-13 ### Added - **Power save control**: `controller.powerSave` allows selectively disabling touch, motion, haptics, or audio processing on the controller to conserve battery. Supports individual property setters, bulk `set()`, and `reset()` ## [6.10.0] - 2026-04-13 ### Added - **Sensor timestamp**: `controller.sensorTimestamp` exposes the 32-bit monotonic microsecond counter from each input report, enabling precise time deltas for gyroscope integration and frame-rate-independent motion processing - `ByteArray.readUint32LE` for reading 32-bit little-endian values from HID reports ### Changed - **TypeScript 6.0**: upgraded from 5.8; migrated to `module: "Node16"` / `moduleResolution: "Node16"` with explicit `types` declarations and `isolatedModules: true` - **ESLint 10**: upgraded from 9; added `@eslint/js` as explicit dependency (unbundled in ESLint 10) - Bumped CI actions: `actions/checkout` v6, `actions/setup-node` v6, `actions/download-artifact` v8, `dependabot/fetch-metadata` v3 ## [6.9.10] - 2026-04-13 ### Fixed - Fix for rendering docs pages in unsupported browsers ### Added - `null_hid_provider` to simplify compatibility for incompatible browser environments ## [6.9.5] - 2026-04-13 ### Added - A new interactive documentation app is now available for your enjoyment ## [6.9.4] - 2026-04-13 ### Fixed - Input events no longer fire when there are no listeners, improving performance by 11% ### Added - A new benchmarking script is provided to set performance baselines for the package ## [6.9.3] - 2026-04-13 ### Fixed - Cleaned up npm bundling, reducing package size by over 50% ## [6.9.0] - 2026-04-12 ### Added - `dispose()` method on `Dualsense` and `DualsenseHID` for proper cleanup - `exports` field in package.json for modern bundler/ESM resolution ### Changed - Upgraded Node 16 → 22, TypeScript 4.6 → 5.8, Jest 27 → 29, ESLint 8 → 9 - Migrated ESLint to flat config (`eslint.config.mjs`) - Replaced `ts-node` with `tsx` for dev scripts - Removed unused webpack dev server setup and 6 excess devDependencies - Trimmed npm package from 437 files to ~170 (whitelist via `files` field) - Updated CI workflow: modern action versions, `--frozen-lockfile`, build artifacts - Expanded test suite from 26 to 200 tests across 25 suites ### Fixed - Timer leak in `Dualsense` and `DualsenseHID` (intervals not cleared on dispose) - README syntax errors in code examples ## [6.8.0] - 2026-04-12 ### Changed - License changed to LGPL-v3 ## [6.7.0] - 2026-04-11 ### Added - Audio support (speaker output) ### Fixed - Fixes for node-hid compatibility issues - Fixes for rumble quirks ## [6.6.0] - 2026-04-11 ### Added - Mute LED override support ## [6.5.0] - 2026-04-11 ### Added - EventEmitter-style listener management (`on`, `off`, `once`, etc.) ## [6.4.0] - 2026-04-11 ### Added - Firmware version lookup - Improved multi-controller behavior ## [6.3.0] - 2026-04-04 ### Added - Microphone and headphone detection ## [6.2.0] - 2026-04-04 ### Added - Multiplayer support (connect and manage multiple controllers) - Seamless switching between wired and wireless connections ### Fixed - Bad browser fallback in demo app ### Changed - Improved the WebHID example/demo app ## [6.1.0] - 2026-04-03 ### Added - Light bar control (player LEDs and light bar color) - Battery level readings ## [6.0.0] - 2026-04-02 ### Added - Trigger haptic feedback (adaptive triggers) - Haptic feedback support over Bluetooth and WebHID ### Changed - **Breaking:** Haptics API restructured for trigger feedback support ## [5.5.0] - 2023-11-26 ### Added - Gyroscope and accelerometer (motion sensor) support ## [5.4.0] - 2023-11-19 ### Fixed - HID report mapping for all report styles (USB, Bluetooth, WebHID) - D-pad input conflicts resolved ## [5.3.0] - 2023-11-16 ### Added - Debugging tools for inspecting controller state ### Fixed - GitHub Pages deployment for the demo app ## [5.2.0] - 2023-11-15 ### Added - Wired/wireless connection detection in WebHID mode ## [5.1.0] - 2023-03-04 ### Added - Rumble (haptic motor) support - Tool for forcing wired/wireless behavior ### Changed - Enabled `@typescript-eslint/strict` for stricter type checking ### Fixed - Undefined `window` check for HID provider ## [5.0.0] - 2022-10-10 ### Changed - **Breaking:** No-throw constructor; the `Dualsense` constructor no longer throws when a controller is not connected - New connection state interface for monitoring controller connectivity ### Fixed - Reduced excess analog input events - Improved analog input handling ## [4.0.0] - 2022-10-01 ### Changed - **Breaking:** `node-hid` is now a peer dependency (consumers must install it themselves) ### Fixed - Excessive HID reconnect attempts - Overhauled WebHID connection strategy for improved reliability - Fixed bad HID connection check ## [3.1.0] - 2022-09-03 ### Added - Scaled deadzone for analog inputs (sticks and triggers) ## [3.0.0] - 2022-07-15 ### Added - **Breaking:** Browser support via WebHID API - Tests and fixed default analog threshold ## [2.2.0] - 2022-06-24 ### Changed - Improved analog threshold setting - Improved README examples ## [2.1.39] - 2022-06-21 Initial tagged release. Basic DualSense controller support via `node-hid` with button, stick, and trigger inputs.