@openmouse/protocol 0.1.0

package/dist/steelseries/prime-mini-wireless.js

@@ -0,0 +1,351 @@
+/**
+ * SteelSeries Prime Mini Wireless configuration protocol — pure encode/decode helpers.
+ *
+ * Reconstructed from public open-source implementations, not vendor software:
+ *
+ * - There is **no** `prime_mini_wireless.py` (nor a wired/wireless filename
+ *   pair) in rivalcfg. The Prime Mini Wireless is instead one of two models
+ *   inside the shared "Prime Wireless" profile pair:
+ *   `rivalcfg/devices/prime_wireless_wired.py` (USB-cabled mode) defines two
+ *   `models` entries — `"SteelSeries Prime Wireless (wired mode)"`
+ *   (`1038:1842`) and `"SteelSeries Prime Mini Wireless (wired mode)"`
+ *   (`1038:184A`) — sharing one `settings`/`battery_level`/`save_command`
+ *   dict. `rivalcfg/devices/prime_wireless_wireless.py` (2.4 GHz dongle mode)
+ *   mirrors that with `1038:1840` (Prime Wireless) and `1038:1848` (Prime
+ *   Mini Wireless), built by comprehending `prime_wireless_wired.py`'s
+ *   `settings`/`battery_level`/`save_command` through one `_patch_command`
+ *   helper — same transform this file implements as `applyPrimeMiniWirelessFlag`.
+ *   Both files were read in full. This module implements only the two Prime
+ *   Mini Wireless product ids (`0x184A` wired, `0x1848` 2.4 GHz) per the
+ *   scope of this change — see "Scope" below for why the plain Prime
+ *   Wireless PIDs (`0x1842`/`0x1840`) are deliberately not registered here
+ *   even though the command set is identical.
+ * - rivalcfg `rivalcfg/devices/dpi/truemove_air.py` — same TrueMove Air
+ *   sensor table as the Rival 3 Wireless and Aerox 5 Wireless — imported
+ *   from `./rival3-wireless.ts`'s `TRUEMOVE_AIR_DPI_TO_BYTE`, not re-derived.
+ * - rivalcfg `rivalcfg/handlers/multidpi_range_choice.py` — `dpi_length_byte: 1`,
+ *   `first_preset: 0` (same shape as `./aerox5-wireless.ts`, **not**
+ *   `./rival3-wireless.ts`'s `first_preset: 1`/`dpi_length_byte` via
+ *   `multidpi_range`).
+ * - rivalcfg `rivalcfg/handlers/range.py` — `sleep_timer`/`dim_timer`: the
+ *   exact same linear range-to-range mapping as `./aerox5-wireless.ts`
+ *   (`sleep_timer` = minutes × 60000 ms, `dim_timer` = seconds × 1000 ms,
+ *   both little-endian 3 bytes, `range_length_byte: 3`). Traced by hand
+ *   against `prime_wireless_wired.py`'s `output_range: [0x000000, 0x124F80, …]`
+ *   values, not assumed from the Aerox 5 Wireless precedent.
+ * - rivalcfg `rivalcfg/handlers/rgbcolor.py` — LED color: `command: [0x21, 0x01, 0x00]`
+ *   with the RGB triplet appended directly (no zone byte and no bitmask —
+ *   this is a single-LED mouse, unlike the Aerox 5 Wireless's
+ *   zone-indexed `steelseriesAerox5WirelessEncodeZoneColor`).
+ * - rivalcfg `rivalcfg/handlers/choice.py` — `polling_rate`
+ *   (`{125:0x03, 250:0x02, 500:0x01, 1000:0x00}`, byte-identical mapping to
+ *   `./aerox5-wireless.ts`'s table, confirmed by direct comparison — not
+ *   assumed) and `default_lighting` (`{"off": 0x00, "rainbow": 0x01}`).
+ * - rivalcfg `rivalcfg/handlers/buttons/buttons.py` (inferred generic
+ *   handler backing `value_type: "buttons"`) — 6 mappable buttons + scroll
+ *   up/down, `button_field_length: 5`, byte-identical ids/offsets to the
+ *   non-wireless `prime_mini.py`'s `buttons_mapping` block (confirmed by
+ *   direct comparison of both device files).
+ *
+ * ## Why wired-cable-mode and 2.4 GHz-dongle-mode share one module
+ *
+ * Same SteelSeries wireless pattern as `./aerox5-wireless.ts` and
+ * `./rival3-wireless.ts`: one physical mouse, two USB product ids depending
+ * on transport, one command set modulo a fixed transform.
+ * `prime_wireless_wireless.py`'s `_patch_command` ORs `0b01000000` (`0x40`)
+ * into `command[0]` of every setting, `battery_level`, and `save_command`
+ * inherited from `prime_wireless_wired.py`, and adds `readback_length: 64`
+ * (an expected reply length this module does not need to model — no
+ * function here reads or validates a readback payload). Every command byte
+ * in `PRIME_MINI_WIRELESS_COMMAND` below is the wired-mode value;
+ * `applyPrimeMiniWirelessFlag` produces the 2.4 GHz-mode byte from it on demand.
+ *
+ * ## Scope: Prime Mini Wireless only, not the plain Prime Wireless
+ *
+ * `prime_wireless_wired.py`/`prime_wireless_wireless.py` document the Prime
+ * Mini Wireless and the plain (non-Mini) Prime Wireless as one shared
+ * `settings` dict — genuinely the same command bytes, same DPI table, same
+ * battery shape, differing only in physical product id. This change is
+ * scoped to the Prime Mini Wireless cluster only: `./devices.ts` registers
+ * `0x184A`/`0x1848` (Prime Mini Wireless) under family
+ * `"prime-mini-wireless"` and deliberately does **not** register
+ * `0x1842`/`0x1840` (plain Prime Wireless) — even though this module's
+ * exported functions would encode identical bytes for either PID group, the
+ * plain Prime Wireless is out of scope for this change and is left for
+ * whichever future change actually verifies and ships it.
+ *
+ * ## No corroboration beyond rivalcfg was possible in this environment
+ *
+ * No local libratbag checkout was available, and OpenRGB's SteelSeries
+ * controller files were not reachable this pass — every command byte above
+ * is sourced from rivalcfg alone, same disclosure as `./aerox5-wireless.ts`.
+ * This should be treated as unverified beyond rivalcfg until corroborated
+ * or hardware-tested.
+ *
+ * Every command is an HID output report, report id `0x00`, on the vendor
+ * configuration interface (`"endpoint": 3` for every model in both rivalcfg
+ * files). DPI presets, polling rate, LED color, sleep/dim timers, default
+ * lighting, and buttons are write-only — neither rivalcfg file defines a
+ * getter for any of them. Battery level **is** readable (see below).
+ * Settings apply immediately; the save command (`11 00` wired, `51 00`
+ * wireless) persists them to onboard flash. None of this has been verified
+ * on physical hardware by this project.
+ *
+ * ## Battery read
+ *
+ * `prime_wireless_wired.py` defines a `battery_level` block byte-identical
+ * in shape to `./aerox5-wireless.ts`'s: an output-report write of `0x92`
+ * gets a 2-byte input-report reply, where `data[1] & 0b10000000` is the
+ * charging flag and `((data[1] & ~0b10000000) - 1) * 5` is the percentage
+ * (coarse 0–100 scale in steps of 5, `- 1` because the raw byte is
+ * 1-indexed). Confirmed by reading `prime_wireless_wired.py` directly — this
+ * is **not** `./rival3-wireless.ts`'s `AA 01` / 3-byte-reply /
+ * plain-percentage-byte shape; do not conflate the two. In 2.4 GHz mode the
+ * query byte is `0x92 | 0x40 = 0xD2`, produced by `applyPrimeMiniWirelessFlag`.
+ */
+import { TRUEMOVE_AIR_DPI_TO_BYTE } from "./rival3-wireless.js";
+export const PRIME_MINI_WIRELESS_REPORT_ID = 0x00;
+/** `_WIRELESS_FLAG = 0b01000000` in `prime_wireless_wireless.py`. */
+const WIRELESS_FLAG = 0b01000000;
+/** Wired-cable-mode command bytes; OR `WIRELESS_FLAG` into byte 0 for 2.4 GHz mode. */
+export const PRIME_MINI_WIRELESS_COMMAND = {
+    dpiPresets: [0x2d],
+    pollingRate: [0x2b],
+    color: [0x21, 0x01, 0x00],
+    buttonsMapping: [0x2a],
+    sleepTimer: [0x29],
+    dimTimer: [0x23, 0x0f, 0x01, 0x00, 0x00],
+    defaultLighting: [0x27],
+    batteryLevel: [0x92],
+};
+/** `11 00` wired-mode / `51 00` 2.4 GHz-mode — see `applyPrimeMiniWirelessFlag`. */
+export const PRIME_MINI_WIRELESS_SAVE_COMMAND = [0x11, 0x00];
+/**
+ * `_patch_command`: OR `0b01000000` into the command's first byte. Pass the
+ * wired-mode command bytes from `PRIME_MINI_WIRELESS_COMMAND` /
+ * `PRIME_MINI_WIRELESS_SAVE_COMMAND`; returns the 2.4 GHz-mode equivalent.
+ */
+export function applyPrimeMiniWirelessFlag(command) {
+    if (command.length === 0) {
+        throw new PrimeMiniWirelessProtocolError("Cannot apply the wireless flag to an empty command.");
+    }
+    return [command[0] | WIRELESS_FLAG, ...command.slice(1)];
+}
+export const PRIME_MINI_WIRELESS_POLLING_RATES = [125, 250, 500, 1000];
+/** Byte-identical mapping to `./aerox5-wireless.ts`'s `POLLING_RATE_TO_BYTE` — confirmed by comparison, not assumed. */
+const POLLING_RATE_TO_BYTE = new Map([
+    [1000, 0x00],
+    [500, 0x01],
+    [250, 0x02],
+    [125, 0x03],
+]);
+export const PRIME_MINI_WIRELESS_DPI_MIN = 100;
+export const PRIME_MINI_WIRELESS_DPI_MAX = 18000;
+export const PRIME_MINI_WIRELESS_DPI_STEP = 100;
+export const PRIME_MINI_WIRELESS_MAX_DPI_PRESETS = 5;
+export const PRIME_MINI_WIRELESS_BATTERY_RESPONSE_LENGTH = 2;
+const BATTERY_CHARGING_FLAG = 0b10000000;
+export class PrimeMiniWirelessProtocolError extends Error {
+}
+/** The 180 DPI values the shared TrueMove Air sensor table can express, ascending. */
+export function steelseriesPrimeMiniWirelessDpiOptions() {
+    return [...TRUEMOVE_AIR_DPI_TO_BYTE.keys()].sort((a, b) => a - b);
+}
+/**
+ * `2D <count> <selected> <v1>…<vN>` (or `6D …` in 2.4 GHz mode). One byte
+ * per DPI; `selectedIndex` is 0-based and encoded 0-based on the wire
+ * (`first_preset: 0`).
+ */
+export function steelseriesPrimeMiniWirelessEncodeDpiPresets(presets, selectedIndex, wireless) {
+    if (presets.length < 1 || presets.length > PRIME_MINI_WIRELESS_MAX_DPI_PRESETS) {
+        throw new PrimeMiniWirelessProtocolError(`SteelSeries Prime Mini Wireless supports 1–${PRIME_MINI_WIRELESS_MAX_DPI_PRESETS} DPI presets.`);
+    }
+    if (!Number.isInteger(selectedIndex) || selectedIndex < 0 || selectedIndex >= presets.length) {
+        throw new PrimeMiniWirelessProtocolError(`Selected DPI preset must be an index into the ${presets.length} presets being written.`);
+    }
+    const encoded = presets.map((dpi) => {
+        const byte = TRUEMOVE_AIR_DPI_TO_BYTE.get(dpi);
+        if (byte === undefined) {
+            throw new PrimeMiniWirelessProtocolError(`SteelSeries Prime Mini Wireless DPI must be ${PRIME_MINI_WIRELESS_DPI_MIN}–${PRIME_MINI_WIRELESS_DPI_MAX.toLocaleString()} in ${PRIME_MINI_WIRELESS_DPI_STEP} DPI steps.`);
+        }
+        return byte;
+    });
+    const command = wireless
+        ? applyPrimeMiniWirelessFlag(PRIME_MINI_WIRELESS_COMMAND.dpiPresets)
+        : PRIME_MINI_WIRELESS_COMMAND.dpiPresets;
+    return new Uint8Array([...command, presets.length, selectedIndex, ...encoded]);
+}
+/** `2B <v>` (`6B` wireless) with 1000→0x00, 500→0x01, 250→0x02, 125→0x03. */
+export function steelseriesPrimeMiniWirelessEncodePollingRate(pollingRateHz, wireless) {
+    const byte = POLLING_RATE_TO_BYTE.get(pollingRateHz);
+    if (byte === undefined) {
+        throw new PrimeMiniWirelessProtocolError("SteelSeries Prime Mini Wireless supports 125, 250, 500, or 1000 Hz polling.");
+    }
+    const command = wireless
+        ? applyPrimeMiniWirelessFlag(PRIME_MINI_WIRELESS_COMMAND.pollingRate)
+        : PRIME_MINI_WIRELESS_COMMAND.pollingRate;
+    return new Uint8Array([...command, byte]);
+}
+/**
+ * `21 01 00 <r> <g> <b>` (`61 01 00 …` wireless) — a fixed single-LED
+ * packet, no zone byte (this mouse has one LED, unlike the Aerox 5
+ * Wireless's zone-indexed color command).
+ */
+export function steelseriesPrimeMiniWirelessEncodeColor(r, g, b, wireless) {
+    for (const channel of [r, g, b]) {
+        if (!Number.isInteger(channel) || channel < 0 || channel > 255) {
+            throw new PrimeMiniWirelessProtocolError("RGB channels must be integers 0–255.");
+        }
+    }
+    const command = wireless ? applyPrimeMiniWirelessFlag(PRIME_MINI_WIRELESS_COMMAND.color) : PRIME_MINI_WIRELESS_COMMAND.color;
+    return new Uint8Array([...command, r, g, b]);
+}
+function encodeRangeLE3(value, min, max, unit, msPerUnit) {
+    if (!Number.isInteger(value) || value < min || value > max) {
+        throw new PrimeMiniWirelessProtocolError(`SteelSeries Prime Mini Wireless ${unit} must be an integer ${min}–${max}.`);
+    }
+    const ms = value * msPerUnit;
+    return [ms & 0xff, (ms >> 8) & 0xff, (ms >> 16) & 0xff];
+}
+/**
+ * `29 <ms LE24>` (`69 …` wireless) — idle minutes before sleep, `0` disables.
+ * Encoded as `minutes * 60000` milliseconds, little-endian 3 bytes.
+ */
+export function steelseriesPrimeMiniWirelessEncodeSleepTimer(minutes, wireless) {
+    const bytes = encodeRangeLE3(minutes, 0, 20, "sleep timer minutes", 60_000);
+    const command = wireless
+        ? applyPrimeMiniWirelessFlag(PRIME_MINI_WIRELESS_COMMAND.sleepTimer)
+        : PRIME_MINI_WIRELESS_COMMAND.sleepTimer;
+    return new Uint8Array([...command, ...bytes]);
+}
+/**
+ * `23 0F 01 00 00 <ms LE24>` (`63 …` wireless) — idle seconds before the LED
+ * dims, `0` disables. Encoded as `seconds * 1000` milliseconds,
+ * little-endian 3 bytes.
+ */
+export function steelseriesPrimeMiniWirelessEncodeDimTimer(seconds, wireless) {
+    const bytes = encodeRangeLE3(seconds, 0, 1200, "dim timer seconds", 1_000);
+    const command = wireless
+        ? applyPrimeMiniWirelessFlag(PRIME_MINI_WIRELESS_COMMAND.dimTimer)
+        : PRIME_MINI_WIRELESS_COMMAND.dimTimer;
+    return new Uint8Array([...command, ...bytes]);
+}
+/** `off`/`rainbow` LED-at-startup choice. */
+export const PRIME_MINI_WIRELESS_DEFAULT_LIGHTING = {
+    off: 0x00,
+    rainbow: 0x01,
+};
+/** `27 <v>` (`67 …` wireless) — what the mouse lights up as before a host ever connects. */
+export function steelseriesPrimeMiniWirelessEncodeDefaultLighting(mode, wireless) {
+    const byte = PRIME_MINI_WIRELESS_DEFAULT_LIGHTING[mode];
+    if (byte === undefined) {
+        throw new PrimeMiniWirelessProtocolError(`SteelSeries Prime Mini Wireless default lighting must be one of: ${Object.keys(PRIME_MINI_WIRELESS_DEFAULT_LIGHTING).join(", ")}.`);
+    }
+    const command = wireless
+        ? applyPrimeMiniWirelessFlag(PRIME_MINI_WIRELESS_COMMAND.defaultLighting)
+        : PRIME_MINI_WIRELESS_COMMAND.defaultLighting;
+    return new Uint8Array([...command, byte]);
+}
+/** `11 00` wired-mode / `51 00` 2.4 GHz-mode — commit the current settings to onboard flash. */
+export function steelseriesPrimeMiniWirelessSaveCommand(wireless) {
+    const command = wireless ? applyPrimeMiniWirelessFlag(PRIME_MINI_WIRELESS_SAVE_COMMAND) : PRIME_MINI_WIRELESS_SAVE_COMMAND;
+    return new Uint8Array(command);
+}
+/** `92` wired-mode / `D2` 2.4 GHz-mode — the device answers with a two-byte input report. */
+export function steelseriesPrimeMiniWirelessBatteryQuery(wireless) {
+    const command = wireless
+        ? applyPrimeMiniWirelessFlag(PRIME_MINI_WIRELESS_COMMAND.batteryLevel)
+        : PRIME_MINI_WIRELESS_COMMAND.batteryLevel;
+    return new Uint8Array(command);
+}
+/**
+ * Decode the two-byte battery response: `data[0]` is unused by rivalcfg's
+ * lambdas, `data[1]`'s top bit is the charging flag and the remaining 7 bits
+ * (1-indexed, hence `- 1`) scaled by 5 give the percentage.
+ */
+export function steelseriesPrimeMiniWirelessDecodeBattery(payload) {
+    if (payload.length < PRIME_MINI_WIRELESS_BATTERY_RESPONSE_LENGTH) {
+        throw new PrimeMiniWirelessProtocolError("SteelSeries Prime Mini Wireless battery response is shorter than two bytes.");
+    }
+    const statusByte = payload[1];
+    const isCharging = (statusByte & BATTERY_CHARGING_FLAG) !== 0;
+    const level = ((statusByte & ~BATTERY_CHARGING_FLAG) - 1) * 5;
+    return { level, isCharging };
+}
+/**
+ * `buttons_mapping.buttons` shared by `prime_wireless_wired.py` — same
+ * offsets/ids as the non-wireless `prime_mini.py`'s `buttons_mapping` block,
+ * confirmed by direct comparison of both device files, defined separately
+ * here so this family's button table stays self-contained.
+ */
+export const PRIME_MINI_WIRELESS_BUTTONS = {
+    button1: { id: 0x01, offset: 0x00 },
+    button2: { id: 0x02, offset: 0x05 },
+    button3: { id: 0x03, offset: 0x0a },
+    button4: { id: 0x04, offset: 0x0f },
+    button5: { id: 0x05, offset: 0x14 },
+    button6: { id: 0x06, offset: 0x19 },
+    scrollUp: { id: 0x31, offset: 0x1e },
+    scrollDown: { id: 0x32, offset: 0x23 },
+};
+const PRIME_MINI_WIRELESS_BUTTON_FIELD_LENGTH = 5;
+const PRIME_MINI_WIRELESS_BUTTON_DISABLE = 0x00;
+const PRIME_MINI_WIRELESS_BUTTON_DPI_SWITCH = 0x30;
+const PRIME_MINI_WIRELESS_BUTTON_KEYBOARD = 0x51;
+const PRIME_MINI_WIRELESS_BUTTON_MULTIMEDIA = 0x61;
+/**
+ * `2A` (`6A` wireless) + one 40-byte (`8 buttons × 5-byte field length`)
+ * packet, zero-filled except where a mapping is given. Unmapped buttons are
+ * left as all-zero fields (rivalcfg instead fills in per-button defaults;
+ * this codec leaves that policy to the caller — pass every button
+ * explicitly for parity with rivalcfg's default profile).
+ */
+export function steelseriesPrimeMiniWirelessEncodeButtonsMapping(mapping, wireless) {
+    const names = Object.keys(PRIME_MINI_WIRELESS_BUTTONS);
+    const packet = new Array(names.length * PRIME_MINI_WIRELESS_BUTTON_FIELD_LENGTH).fill(0x00);
+    for (const [name, action] of Object.entries(mapping)) {
+        const slot = PRIME_MINI_WIRELESS_BUTTONS[name];
+        if (!slot) {
+            throw new PrimeMiniWirelessProtocolError(`Unknown SteelSeries Prime Mini Wireless button "${name}".`);
+        }
+        const { offset } = slot;
+        switch (action.type) {
+            case "button": {
+                packet[offset] = PRIME_MINI_WIRELESS_BUTTONS[action.target].id;
+                break;
+            }
+            case "disabled": {
+                packet[offset] = PRIME_MINI_WIRELESS_BUTTON_DISABLE;
+                break;
+            }
+            case "dpiSwitch": {
+                packet[offset] = PRIME_MINI_WIRELESS_BUTTON_DPI_SWITCH;
+                break;
+            }
+            case "keyboard": {
+                if (!Number.isInteger(action.code) || action.code < 0 || action.code > 255) {
+                    throw new PrimeMiniWirelessProtocolError("Keyboard scan codes must be integers 0–255.");
+                }
+                packet[offset] = PRIME_MINI_WIRELESS_BUTTON_KEYBOARD;
+                packet[offset + 1] = action.code;
+                break;
+            }
+            case "multimedia": {
+                if (!Number.isInteger(action.code) || action.code < 0 || action.code > 255) {
+                    throw new PrimeMiniWirelessProtocolError("Multimedia key codes must be integers 0–255.");
+                }
+                packet[offset] = PRIME_MINI_WIRELESS_BUTTON_MULTIMEDIA;
+                packet[offset + 1] = action.code;
+                break;
+            }
+            default: {
+                throw new PrimeMiniWirelessProtocolError("Unsupported SteelSeries Prime Mini Wireless button action.");
+            }
+        }
+    }
+    const command = wireless
+        ? applyPrimeMiniWirelessFlag(PRIME_MINI_WIRELESS_COMMAND.buttonsMapping)
+        : PRIME_MINI_WIRELESS_COMMAND.buttonsMapping;
+    return new Uint8Array([...command, ...packet]);
+}
+//# sourceMappingURL=prime-mini-wireless.js.map

package/dist/steelseries/prime-mini-wireless.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prime-mini-wireless.js","sourceRoot":"","sources":["../../src/steelseries/prime-mini-wireless.ts"],"names":[],"mappings":"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"}

package/dist/steelseries/prime-plus.d.ts

@@ -0,0 +1,179 @@
+/**
+ * SteelSeries Prime+ configuration protocol — pure encode/decode helpers.
+ *
+ * Reconstructed from public open-source implementations, not vendor software:
+ *
+ * - rivalcfg `rivalcfg/devices/prime_plus.py` — the primary source for every
+ *   command byte and default here. `1038:182C`, endpoint 0.
+ * - rivalcfg `rivalcfg/devices/prime.py` (plain Prime, `1038:182E` plus two
+ *   limited-edition PIDs) was read only to confirm Prime+ genuinely warrants
+ *   its own module rather than reusing Prime's. **Surprising finding: it does
+ *   not, protocol-wise.** `prime.py` and `prime_plus.py` are byte-identical
+ *   in every setting (sensitivity `0x61`, polling `0x5D`, color `0x62 0x01`,
+ *   brightness `0x5F`, buttons `0x5B`, save `0x59`) — the only diff is the
+ *   model name/PID list. **rivalcfg's Prime+ profile has no OLED/display
+ *   setting**, contrary to this rollout's assumption that Prime+ has one
+ *   because the physical mouse has an OLED status screen. Neither rivalcfg,
+ *   libratbag, nor the OpenRGB SteelSeries controller sources reachable from
+ *   this environment (see corroboration gap below) expose any command for it.
+ *   Prime+ is still implemented as its own module/PID/family rather than
+ *   folded into a shared "Prime" module, per this rollout's instruction to
+ *   add Prime+ only and not touch plain Prime — but the wire protocol
+ *   implemented here is not distinguishable from plain Prime's, and a reader
+ *   should not infer an OLED command exists just because this module exists.
+ * - rivalcfg `rivalcfg/handlers/multidpi_range.py` (DPI presets: `merge_bytes(
+ *   count, selected_preset, ...values)`, `count_mode: "number"`, 2-byte
+ *   little-endian DPI values here vs. Aerox 3's 1-byte) and
+ *   `rivalcfg/handlers/range.py` (the range→range linear rounding both
+ *   `multidpi_range` and `range` build on).
+ * - rivalcfg `rivalcfg/handlers/rgbcolor.py` — RGB value encoding (`[r,g,b]`).
+ * - rivalcfg `rivalcfg/handlers/range.py` (again, for `led_brightness`: a
+ *   0–256 linear passthrough, 2-byte little-endian — note the input range's
+ *   upper bound is genuinely `256`, not `255`, in `prime_plus.py`; not a typo
+ *   introduced here).
+ * - rivalcfg `rivalcfg/handlers/buttons/buttons.py` — the fixed-width button
+ *   field layout (5 bytes/button, zero-filled, `offset`/`id` per button),
+ *   same shape as Aerox 3's but only 6 buttons/slots (no scroll-wheel source
+ *   entries — `prime_plus.py`'s `buttons_mapping.buttons` table lists only
+ *   `Button1`..`Button6`).
+ * - rivalcfg `rivalcfg/mouse.py` (`_exec_command`) — confirms wire assembly
+ *   order is `command ++ process_value(value) ++ command_suffix`, which is
+ *   how the color command's 16-byte suffix (15 zero bytes then `0xFF`)
+ *   attaches after the `[r,g,b]` triple.
+ *
+ * ## Corroboration gap (must read before trusting this file)
+ *
+ * libratbag's `src/driver-steelseries.c` (fetched from
+ * `libratbag/libratbag@master`) contains **no reference at all** to Prime,
+ * Prime+, PID `0x182C`, or any OLED/display command — it does not implement
+ * this device family. The OpenRGB SteelSeries controller sources could not be
+ * located at their expected path in this environment (404) and a GitHub code
+ * search for "Prime+", `0x182C`, and "SteelSeriesPrime" against
+ * `CalcProgrammer1/OpenRGB` returned zero results, so OpenRGB could not be
+ * checked either. **rivalcfg is therefore the only source this module is
+ * corroborated against.** Nothing here has been verified on physical Prime+
+ * hardware by this project.
+ *
+ * Every command is an HID **output report** with report id 0x00 (`"endpoint":
+ * 0` in `prime_plus.py`, the vendor configuration interface). The functions
+ * here build the report *payload* — the bytes after the report id — unpadded,
+ * matching rivalcfg's `usbhid.py` writes.
+ *
+ * **This device is write-only.** `prime_plus.py` defines no getter for any
+ * setting and no firmware-query command, so there is nothing to probe the
+ * mouse with beyond a successful `open()` — same honesty policy as Aerox 3:
+ * session state must be tracked client-side with `valuesVerified: false`.
+ *
+ * Settings apply immediately; the save command (`0x59`, a single byte with
+ * **no** `0x00` suffix — distinct from Aerox 3's `11 00` and Rival 3 Gen 1's
+ * `09 00`; do not confuse the three) persists them to onboard flash.
+ *
+ * ## Button mapping — deliberately reduced scope
+ *
+ * Same scope line drawn in `./aerox3.ts`: this module implements the exact
+ * 5-byte/button, zero-filled packet shape and the mouse-button/disable/
+ * DPI-switch/scroll-wheel special actions, but does not re-implement
+ * rivalcfg's QWERTY or multimedia key-name tables — keyboard and multimedia
+ * targets are taken here as raw `{ type: "keyboard" | "multimedia", code }`
+ * scan-code bytes, matching `button_keyboard: 0x51` / `button_multimedia:
+ * 0x61` verbatim. Unlike Aerox 3, Prime+'s `buttons` table has no `ScrollUp`/
+ * `ScrollDown` *source* button entries (only 6 physical buttons are mapped),
+ * but `button_scroll_up: 0x31` / `button_scroll_down: 0x32` are still valid
+ * *target* special actions for any of the 6 buttons, exposed here as
+ * `{ type: "scrollUp" }` / `{ type: "scrollDown" }`.
+ */
+export declare const PRIME_PLUS_REPORT_ID = 0;
+/** One-byte command prefixes; the payload is the prefix plus its arguments. */
+export declare const PRIME_PLUS_COMMAND: {
+    readonly sensitivity: readonly [97];
+    readonly pollingRate: readonly [93];
+    readonly color: readonly [98, 1];
+    readonly ledBrightness: readonly [95];
+    readonly buttonsMapping: readonly [91];
+};
+/** `0x59` — a single byte, no `0x00` suffix. Distinct from Aerox 3's `11 00`. */
+export declare const PRIME_PLUS_SAVE_COMMAND: readonly [89];
+export declare const PRIME_PLUS_POLLING_RATES: readonly [125, 250, 500, 1000];
+export declare const PRIME_PLUS_DPI_MIN = 50;
+export declare const PRIME_PLUS_DPI_MAX = 18000;
+export declare const PRIME_PLUS_DPI_STEP = 50;
+export declare const PRIME_PLUS_MAX_DPI_PRESETS = 5;
+export declare const PRIME_PLUS_LED_BRIGHTNESS_MAX = 256;
+export declare class PrimePlusProtocolError extends Error {
+}
+/** The 360 DPI values the linear `sensitivity` range can express, ascending. */
+export declare function steelseriesPrimePlusDpiOptions(): number[];
+/**
+ * `61 <count> <selectedPreset> <v1_lo> <v1_hi> … <vN_lo> <vN_hi>` — replaces
+ * the mouse's whole preset table. Two bytes per DPI, little-endian
+ * (`dpi_length_byte: 2`); `selectedIndex` is 0-based both here and on the
+ * wire (`first_preset: 0`, unlike Aerox 3's `first_preset: 1`).
+ */
+export declare function steelseriesPrimePlusEncodeDpiPresets(presets: readonly number[], selectedIndex: number): Uint8Array;
+/** `5D <v>` with 1000→0x01, 500→0x02, 250→0x03, 125→0x04. */
+export declare function steelseriesPrimePlusEncodePollingRate(pollingRateHz: number): Uint8Array;
+/** `62 01 <r> <g> <b>` plus the fixed 16-byte suffix — the scroll-wheel LED color. */
+export declare function steelseriesPrimePlusEncodeColor(r: number, g: number, b: number): Uint8Array;
+/**
+ * `5F <v_lo> <v_hi>` — linear 0–256 passthrough, 2-byte little-endian
+ * (`range_length_byte: 2`). Note the upper bound is genuinely 256, matching
+ * `prime_plus.py`'s `input_range`/`output_range`.
+ */
+export declare function steelseriesPrimePlusEncodeLedBrightness(level: number): Uint8Array;
+/** `59` — commit the current settings to onboard flash. */
+export declare function steelseriesPrimePlusSaveCommand(): Uint8Array;
+/** `buttons_mapping.buttons` from `prime_plus.py`, id + byte offset into the packet. */
+export declare const PRIME_PLUS_BUTTONS: {
+    readonly button1: {
+        readonly id: 1;
+        readonly offset: 0;
+    };
+    readonly button2: {
+        readonly id: 2;
+        readonly offset: 5;
+    };
+    readonly button3: {
+        readonly id: 3;
+        readonly offset: 10;
+    };
+    readonly button4: {
+        readonly id: 4;
+        readonly offset: 15;
+    };
+    readonly button5: {
+        readonly id: 5;
+        readonly offset: 20;
+    };
+    readonly button6: {
+        readonly id: 6;
+        readonly offset: 25;
+    };
+};
+export type PrimePlusButtonName = keyof typeof PRIME_PLUS_BUTTONS;
+/** One button's target. */
+export type PrimePlusButtonAction = {
+    type: "button";
+    target: PrimePlusButtonName;
+} | {
+    type: "disabled";
+} | {
+    type: "dpiSwitch";
+} | {
+    type: "scrollUp";
+} | {
+    type: "scrollDown";
+} | {
+    type: "keyboard";
+    code: number;
+} | {
+    type: "multimedia";
+    code: number;
+};
+/**
+ * `5B` + one 30-byte (`6 buttons × 5-byte field length`) packet, zero-filled
+ * except where a mapping is given. Unmapped buttons are left as all-zero
+ * fields — pass every button explicitly for parity with rivalcfg's default
+ * profile, same policy as `./aerox3.ts`.
+ */
+export declare function steelseriesPrimePlusEncodeButtonsMapping(mapping: Partial<Record<PrimePlusButtonName, PrimePlusButtonAction>>): Uint8Array;
+//# sourceMappingURL=prime-plus.d.ts.map

package/dist/steelseries/prime-plus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prime-plus.d.ts","sourceRoot":"","sources":["../../src/steelseries/prime-plus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AAEH,eAAO,MAAM,oBAAoB,IAAO,CAAC;AAEzC,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC;AAYX,iFAAiF;AACjF,eAAO,MAAM,uBAAuB,eAAkB,CAAC;AAEvD,eAAO,MAAM,wBAAwB,gCAAiC,CAAC;AASvE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,qBAAa,sBAAuB,SAAQ,KAAK;CAAG;AAkBpD,gFAAgF;AAChF,wBAAgB,8BAA8B,IAAI,MAAM,EAAE,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,aAAa,EAAE,MAAM,GACpB,UAAU,CAiBZ;AAED,6DAA6D;AAC7D,wBAAgB,qCAAqC,CAAC,aAAa,EAAE,MAAM,GAAG,UAAU,CAMvF;AAWD,sFAAsF;AACtF,wBAAgB,+BAA+B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAG3F;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAOjF;AAED,2DAA2D;AAC3D,wBAAgB,+BAA+B,IAAI,UAAU,CAE5D;AASD,wFAAwF;AACxF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;CAOyB,CAAC;AAEzD,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAUlE,2BAA2B;AAC3B,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,CAAC,GACnE,UAAU,CA0DZ"}