@openmouse/protocol 0.1.0

package/dist/razer/v4.js

@@ -0,0 +1,51 @@
+export const RAZER_V4_REPORT_ID = 0;
+export const RAZER_V4_REPORT_LENGTH = 90;
+export const RAZER_V4_PRODUCTS = new Map([
+    [0x00e5, { wireless: false }],
+    [0x00e6, { wireless: true }],
+]);
+export const RAZER_V4_MAX_DPI_STAGES = 5;
+export const RAZER_V4_POLLING_CODES = new Map([
+    [125, 0x40], [500, 0x10], [1000, 0x08], [2000, 0x04], [4000, 0x02], [8000, 0x01],
+]);
+export function razerV4Crc(report) {
+    let crc = 0;
+    for (let index = 2; index <= 87; index += 1)
+        crc ^= report[index] ?? 0;
+    return crc;
+}
+export function buildRazerV4Report(commandClass, commandId, dataSize, args = new Uint8Array()) {
+    if (args.length > 80)
+        throw new Error("Razer command payload is too large.");
+    if (!Number.isInteger(dataSize) || dataSize < 0 || dataSize > 80)
+        throw new Error("Razer command data size is invalid.");
+    const report = new Uint8Array(RAZER_V4_REPORT_LENGTH);
+    report[1] = 0x1f;
+    report[5] = dataSize;
+    report[6] = commandClass;
+    report[7] = commandId;
+    report.set(args, 8);
+    report[88] = razerV4Crc(report);
+    return report;
+}
+export function decodeRazerV4DpiState(args) {
+    const count = Math.min(args[2] ?? 0, RAZER_V4_MAX_DPI_STAGES);
+    const stages = [];
+    for (let index = 0; index < count; index += 1) {
+        const offset = 3 + index * 7;
+        stages.push({
+            x: ((args[offset + 1] ?? 0) << 8) | (args[offset + 2] ?? 0),
+            y: ((args[offset + 3] ?? 0) << 8) | (args[offset + 4] ?? 0),
+        });
+    }
+    if (!stages.length)
+        throw new Error("The Viper V4 Pro reported no DPI stages.");
+    return { activeStage: Math.min(Math.max((args[1] ?? 1) - 1, 0), stages.length - 1), stages };
+}
+export function decodeRazerV4PollingCode(code) {
+    const rate = [...RAZER_V4_POLLING_CODES].find(([, candidate]) => candidate === code)?.[0];
+    if (!rate)
+        throw new Error(`The Viper V4 Pro reported unknown polling code 0x${(code ?? 0).toString(16)}.`);
+    return rate;
+}
+//# sourceMappingURL=v4.js.map

package/dist/razer/v4.js.map

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

package/dist/steelseries/aerox3.d.ts

@@ -0,0 +1,236 @@
+/**
+ * SteelSeries Aerox 3 configuration protocol — pure encode/decode helpers.
+ *
+ * Reconstructed from public open-source implementations, not vendor software:
+ *
+ * - rivalcfg `rivalcfg/devices/aerox3.py` — the primary source for every
+ *   command byte and default here.
+ * - rivalcfg `rivalcfg/handlers/multidpi_range_choice.py` (DPI presets, shared
+ *   with Rival 3 Gen 1 but with a one-byte command prefix instead of two) and
+ *   `rivalcfg/devices/dpi/truemove_core.py` (the DPI byte table — reused from
+ *   `./rival3.ts`'s `TRUEMOVE_CORE_DPI_TO_BYTE`, not re-derived, since both
+ *   devices use the same TrueMove Core sensor and rivalcfg quotes the same
+ *   table for both).
+ * - rivalcfg `rivalcfg/handlers/rgbcolor.py` and `reactive_rgbcolor.py` — RGB
+ *   value encoding (`[r,g,b]`, and `[0x01,0x00,r,g,b]` / `[0x00,0x00,0x00,0x00,0x00]`
+ *   for the on/off reactive-color field).
+ * - rivalcfg `rivalcfg/handlers/range.py` and `choice.py` — LED brightness
+ *   (linear 0–100 passthrough) and the rainbow-effect/default-lighting
+ *   choice tables.
+ * - rivalcfg `rivalcfg/handlers/buttons/buttons.py` — the fixed-width button
+ *   field layout (5 bytes/button, zero-filled, `offset`/`id` per button).
+ * - rivalcfg `rivalcfg/devices/rival3_gen2.py` — corroborates that `0x1038:0x1870`
+ *   (Rival 3 Gen 2) shares the Aerox 3's color/brightness/rainbow/buttons/
+ *   default-lighting/save commands, but see the PR #269 note below: its DPI
+ *   command differs, so this module intentionally does not claim that PID.
+ *
+ * ## PR #269 reconciliation (SteelSeries Rival 3 Gen 2, `1038:1870`)
+ *
+ * flozz/rivalcfg#269 (closed, hardware-confirmed by its author for DPI,
+ * polling, and RGB) claims the Rival 3 Gen 2 uses "the identical Aerox 3
+ * protocol" at `1038:1870`, endpoint 3. rivalcfg's own mainline
+ * `devices/rival3_gen2.py` does ship that exact vendor/product/endpoint
+ * triple, confirming the PID half of the PR's claim. **The protocols are not
+ * byte-identical, though**: Aerox 3's DPI-preset command is `0x2D` using the
+ * `multidpi_range_choice` handler (one DPI byte per preset), while mainline
+ * Rival 3 Gen 2 uses command `0x34` with the `multidpi_range_choice_xy`
+ * handler (independent X/Y DPI per preset, `"xy_mapping": "xyxy"`, two bytes
+ * per axis pair). Every other setting (polling rate `0x2B`, RGB zones `0x21`,
+ * reactive color `0x26`, brightness `0x23`, rainbow `0x22`, buttons `0x2A`,
+ * default lighting `0x27`, save `0x11 0x00`) is byte-identical between the
+ * two mainline device files. Per this rollout's instructions, rivalcfg's
+ * mainline file is treated as authoritative over the PR description, and
+ * because the DPI command genuinely differs, `1038:0x1870` is **not** added
+ * to this module's or any registry's product table here — a Rival 3 Gen 2
+ * driver needs its own DPI encoder and is out of scope for this cluster
+ * (Aerox 3 only). Nothing in this file claims or matches that PID.
+ *
+ * Every command is an HID **output report** with report id 0x00 on the
+ * vendor configuration interface (hidapi `endpoint` / `interface_number ==
+ * 3`, per the `"endpoint": 3` model entry — same interface convention as
+ * Rival 3 Gen 1). 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, like Rival 3 Gen 1.** `aerox3.py` defines no
+ * getter for any setting and no firmware-query command (Rival 3 Gen 1's
+ * `10 00` has no Aerox 3 counterpart in rivalcfg, libratbag, or the OpenRGB
+ * SteelSeries controller files checked for this device). There is nothing to
+ * probe the mouse with, so the HID client cannot use a firmware read as a
+ * connectivity check the way `SteelSeriesRival3HidClient` does; it must treat
+ * a successful `open()` as the only available signal. Session state must be
+ * tracked client-side with `valuesVerified: false`, exactly as Rival 3 does.
+ *
+ * Settings apply immediately; the save command (`11 00`, distinct from Rival
+ * 3 Gen 1's `09 00` — do not confuse the two) persists them to onboard flash.
+ * None of this has been verified on physical Aerox 3 hardware by this
+ * project.
+ *
+ * ## RGB zone command layout
+ *
+ * All three zone-color settings share one underlying packet shape, visible
+ * once the escalating prefixes in `aerox3.py` are read against the LED_ID
+ * bitmask comment preserved in rivalcfg's `rival3_gen2.py` (same command
+ * family): `21 <LED_ID bitmask> <zone1 r,g,b> <zone2 r,g,b> <zone3 r,g,b>`.
+ * `LED_ID` selects which zone(s) the device should actually update; the RGB
+ * slots for zones the bitmask does not select are sent as zero padding and
+ * ignored by the device. That is why `z1_color`'s command is `[0x21,0x01]`
+ * (bitmask `0b001`, immediately followed by that zone's RGB — no padding
+ * needed, its slot is first), `z2_color`'s is `[0x21,0x02,0x00,0x00,0x00]`
+ * (bitmask `0b010`, three zero bytes filling the skipped zone-1 slot before
+ * zone 2's RGB), and `z3_color`'s is `[0x21,0x04,0x00,0x00,0x00,0x00,0x00,0x00]`
+ * (bitmask `0b100`, six zero bytes filling the skipped zone-1 and zone-2
+ * slots before zone 3's RGB). This module exposes one `steelseriesAerox3EncodeZoneColor`
+ * function parameterized on zone 1–3 rather than three near-duplicate
+ * functions, producing byte-identical output to each `aerox3.py` command.
+ *
+ * ## Button mapping — deliberately reduced scope
+ *
+ * rivalcfg's `buttons` handler supports remapping to another mouse button,
+ * a disable/DPI-switch/scroll special action, or a keyboard/multimedia key
+ * chosen from large per-layout tables (`handlers/buttons/layout_qwerty.py`,
+ * `layout_multimedia.py`). This module implements the exact 5-byte/button,
+ * zero-filled packet shape and the mouse-button/disable/DPI-switch/scroll
+ * 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 rather than
+ * name strings, matching `button_keyboard: 0x51` / `button_multimedia: 0x61`
+ * verbatim. This is the same kind of scope line `rival3.ts` draws around
+ * lighting effects it documents but does not implement.
+ */
+export declare const AEROX3_REPORT_ID = 0;
+/** One-byte command prefixes; the payload is the prefix plus its arguments. */
+export declare const AEROX3_COMMAND: {
+    readonly dpiPresets: readonly [45];
+    readonly pollingRate: readonly [43];
+    readonly reactiveColor: readonly [38];
+    readonly ledBrightness: readonly [35];
+    readonly rainbowEffect: readonly [34];
+    readonly buttonsMapping: readonly [42];
+    readonly defaultLighting: readonly [39];
+    readonly zoneColor: readonly [33];
+};
+/** `11 00` — distinct from Rival 3 Gen 1's `09 00`; do not reuse across families. */
+export declare const AEROX3_SAVE_COMMAND: readonly [17, 0];
+export declare const AEROX3_POLLING_RATES: readonly [125, 250, 500, 1000];
+export declare const AEROX3_DPI_MIN = 200;
+export declare const AEROX3_DPI_MAX = 8500;
+export declare const AEROX3_DPI_STEP = 100;
+export declare const AEROX3_MAX_DPI_PRESETS = 5;
+export declare class Aerox3ProtocolError extends Error {
+}
+/** The 84 DPI values the shared TrueMove Core sensor table can express, ascending. */
+export declare function steelseriesAerox3DpiOptions(): number[];
+/**
+ * `2D <count> <selected> <v1>…<vN>` — replaces the mouse's whole preset
+ * table. One byte per DPI (`dpi_length_byte: 1`); `selectedIndex` is 0-based
+ * here and encoded 1-based on the wire (`first_preset: 1`).
+ */
+export declare function steelseriesAerox3EncodeDpiPresets(presets: readonly number[], selectedIndex: number): Uint8Array;
+/** `2B <v>` with 1000→0x01, 500→0x02, 250→0x03, 125→0x04. */
+export declare function steelseriesAerox3EncodePollingRate(pollingRateHz: number): Uint8Array;
+export type Aerox3Zone = 1 | 2 | 3;
+/**
+ * `21 <bitmask> <padding for skipped zones> <r> <g> <b>` — see the module
+ * doc comment for how the zero-padding length grows with the zone number.
+ * Zone 1 = top LED, zone 2 = middle LED, zone 3 = bottom LED (strip order,
+ * per `aerox3.py`'s CLI flag labels).
+ */
+export declare function steelseriesAerox3EncodeZoneColor(zone: Aerox3Zone, r: number, g: number, b: number): Uint8Array;
+/**
+ * `26 00 00 00 00 00` when disabled, `26 01 00 <r> <g> <b>` when enabled —
+ * the color the LEDs flash to in reaction to a button click.
+ */
+export declare function steelseriesAerox3EncodeReactiveColor(color: {
+    r: number;
+    g: number;
+    b: number;
+} | null): Uint8Array;
+/** `23 <v>` — linear 0–100 passthrough (`output_range` matches `input_range`). */
+export declare function steelseriesAerox3EncodeLedBrightness(percent: number): Uint8Array;
+export declare const AEROX3_RAINBOW_ZONES: {
+    readonly all: 7;
+    readonly bottom: 4;
+    readonly middle: 2;
+    readonly top: 1;
+    readonly "bottom-middle": 6;
+    readonly "middle-top": 3;
+    readonly "bottom-top": 5;
+};
+export type Aerox3RainbowZones = keyof typeof AEROX3_RAINBOW_ZONES;
+/** `22 <bitmask>` — rainbow effect on the selected zone(s); cleared by setting a color. */
+export declare function steelseriesAerox3EncodeRainbowEffect(zones: Aerox3RainbowZones): Uint8Array;
+export declare const AEROX3_DEFAULT_LIGHTING: {
+    readonly off: readonly [0, 0];
+    readonly reactive: readonly [0, 1];
+    readonly rainbow: readonly [1, 0];
+    readonly "reactive-rainbow": readonly [1, 1];
+};
+export type Aerox3DefaultLighting = keyof typeof AEROX3_DEFAULT_LIGHTING;
+/** `27 <v1> <v2>` — what the mouse lights up as before a host ever connects. */
+export declare function steelseriesAerox3EncodeDefaultLighting(mode: Aerox3DefaultLighting): Uint8Array;
+/** `11 00` — commit the current settings to onboard flash. */
+export declare function steelseriesAerox3SaveCommand(): Uint8Array;
+/** `buttons_mapping.buttons` from `aerox3.py`, id + byte offset into the packet. */
+export declare const AEROX3_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;
+    };
+    readonly scrollUp: {
+        readonly id: 49;
+        readonly offset: 30;
+    };
+    readonly scrollDown: {
+        readonly id: 50;
+        readonly offset: 35;
+    };
+};
+export type Aerox3ButtonName = keyof typeof AEROX3_BUTTONS;
+/**
+ * One button's target. `scrollUp`/`scrollDown` cannot be remap *targets*
+ * (`button_scroll_up`/`button_scroll_down` are `None` in `aerox3.py`) — only
+ * sources; attempting to target them is rejected.
+ */
+export type Aerox3ButtonAction = {
+    type: "button";
+    target: Exclude<Aerox3ButtonName, "scrollUp" | "scrollDown">;
+} | {
+    type: "disabled";
+} | {
+    type: "dpiSwitch";
+} | {
+    type: "keyboard";
+    code: number;
+} | {
+    type: "multimedia";
+    code: number;
+};
+/**
+ * `2A` + 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 declare function steelseriesAerox3EncodeButtonsMapping(mapping: Partial<Record<Aerox3ButtonName, Aerox3ButtonAction>>): Uint8Array;
+//# sourceMappingURL=aerox3.d.ts.map

package/dist/steelseries/aerox3.d.ts.map

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

package/dist/steelseries/aerox3.js

@@ -0,0 +1,311 @@
+/**
+ * SteelSeries Aerox 3 configuration protocol — pure encode/decode helpers.
+ *
+ * Reconstructed from public open-source implementations, not vendor software:
+ *
+ * - rivalcfg `rivalcfg/devices/aerox3.py` — the primary source for every
+ *   command byte and default here.
+ * - rivalcfg `rivalcfg/handlers/multidpi_range_choice.py` (DPI presets, shared
+ *   with Rival 3 Gen 1 but with a one-byte command prefix instead of two) and
+ *   `rivalcfg/devices/dpi/truemove_core.py` (the DPI byte table — reused from
+ *   `./rival3.ts`'s `TRUEMOVE_CORE_DPI_TO_BYTE`, not re-derived, since both
+ *   devices use the same TrueMove Core sensor and rivalcfg quotes the same
+ *   table for both).
+ * - rivalcfg `rivalcfg/handlers/rgbcolor.py` and `reactive_rgbcolor.py` — RGB
+ *   value encoding (`[r,g,b]`, and `[0x01,0x00,r,g,b]` / `[0x00,0x00,0x00,0x00,0x00]`
+ *   for the on/off reactive-color field).
+ * - rivalcfg `rivalcfg/handlers/range.py` and `choice.py` — LED brightness
+ *   (linear 0–100 passthrough) and the rainbow-effect/default-lighting
+ *   choice tables.
+ * - rivalcfg `rivalcfg/handlers/buttons/buttons.py` — the fixed-width button
+ *   field layout (5 bytes/button, zero-filled, `offset`/`id` per button).
+ * - rivalcfg `rivalcfg/devices/rival3_gen2.py` — corroborates that `0x1038:0x1870`
+ *   (Rival 3 Gen 2) shares the Aerox 3's color/brightness/rainbow/buttons/
+ *   default-lighting/save commands, but see the PR #269 note below: its DPI
+ *   command differs, so this module intentionally does not claim that PID.
+ *
+ * ## PR #269 reconciliation (SteelSeries Rival 3 Gen 2, `1038:1870`)
+ *
+ * flozz/rivalcfg#269 (closed, hardware-confirmed by its author for DPI,
+ * polling, and RGB) claims the Rival 3 Gen 2 uses "the identical Aerox 3
+ * protocol" at `1038:1870`, endpoint 3. rivalcfg's own mainline
+ * `devices/rival3_gen2.py` does ship that exact vendor/product/endpoint
+ * triple, confirming the PID half of the PR's claim. **The protocols are not
+ * byte-identical, though**: Aerox 3's DPI-preset command is `0x2D` using the
+ * `multidpi_range_choice` handler (one DPI byte per preset), while mainline
+ * Rival 3 Gen 2 uses command `0x34` with the `multidpi_range_choice_xy`
+ * handler (independent X/Y DPI per preset, `"xy_mapping": "xyxy"`, two bytes
+ * per axis pair). Every other setting (polling rate `0x2B`, RGB zones `0x21`,
+ * reactive color `0x26`, brightness `0x23`, rainbow `0x22`, buttons `0x2A`,
+ * default lighting `0x27`, save `0x11 0x00`) is byte-identical between the
+ * two mainline device files. Per this rollout's instructions, rivalcfg's
+ * mainline file is treated as authoritative over the PR description, and
+ * because the DPI command genuinely differs, `1038:0x1870` is **not** added
+ * to this module's or any registry's product table here — a Rival 3 Gen 2
+ * driver needs its own DPI encoder and is out of scope for this cluster
+ * (Aerox 3 only). Nothing in this file claims or matches that PID.
+ *
+ * Every command is an HID **output report** with report id 0x00 on the
+ * vendor configuration interface (hidapi `endpoint` / `interface_number ==
+ * 3`, per the `"endpoint": 3` model entry — same interface convention as
+ * Rival 3 Gen 1). 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, like Rival 3 Gen 1.** `aerox3.py` defines no
+ * getter for any setting and no firmware-query command (Rival 3 Gen 1's
+ * `10 00` has no Aerox 3 counterpart in rivalcfg, libratbag, or the OpenRGB
+ * SteelSeries controller files checked for this device). There is nothing to
+ * probe the mouse with, so the HID client cannot use a firmware read as a
+ * connectivity check the way `SteelSeriesRival3HidClient` does; it must treat
+ * a successful `open()` as the only available signal. Session state must be
+ * tracked client-side with `valuesVerified: false`, exactly as Rival 3 does.
+ *
+ * Settings apply immediately; the save command (`11 00`, distinct from Rival
+ * 3 Gen 1's `09 00` — do not confuse the two) persists them to onboard flash.
+ * None of this has been verified on physical Aerox 3 hardware by this
+ * project.
+ *
+ * ## RGB zone command layout
+ *
+ * All three zone-color settings share one underlying packet shape, visible
+ * once the escalating prefixes in `aerox3.py` are read against the LED_ID
+ * bitmask comment preserved in rivalcfg's `rival3_gen2.py` (same command
+ * family): `21 <LED_ID bitmask> <zone1 r,g,b> <zone2 r,g,b> <zone3 r,g,b>`.
+ * `LED_ID` selects which zone(s) the device should actually update; the RGB
+ * slots for zones the bitmask does not select are sent as zero padding and
+ * ignored by the device. That is why `z1_color`'s command is `[0x21,0x01]`
+ * (bitmask `0b001`, immediately followed by that zone's RGB — no padding
+ * needed, its slot is first), `z2_color`'s is `[0x21,0x02,0x00,0x00,0x00]`
+ * (bitmask `0b010`, three zero bytes filling the skipped zone-1 slot before
+ * zone 2's RGB), and `z3_color`'s is `[0x21,0x04,0x00,0x00,0x00,0x00,0x00,0x00]`
+ * (bitmask `0b100`, six zero bytes filling the skipped zone-1 and zone-2
+ * slots before zone 3's RGB). This module exposes one `steelseriesAerox3EncodeZoneColor`
+ * function parameterized on zone 1–3 rather than three near-duplicate
+ * functions, producing byte-identical output to each `aerox3.py` command.
+ *
+ * ## Button mapping — deliberately reduced scope
+ *
+ * rivalcfg's `buttons` handler supports remapping to another mouse button,
+ * a disable/DPI-switch/scroll special action, or a keyboard/multimedia key
+ * chosen from large per-layout tables (`handlers/buttons/layout_qwerty.py`,
+ * `layout_multimedia.py`). This module implements the exact 5-byte/button,
+ * zero-filled packet shape and the mouse-button/disable/DPI-switch/scroll
+ * 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 rather than
+ * name strings, matching `button_keyboard: 0x51` / `button_multimedia: 0x61`
+ * verbatim. This is the same kind of scope line `rival3.ts` draws around
+ * lighting effects it documents but does not implement.
+ */
+import { TRUEMOVE_CORE_DPI_TO_BYTE } from "./rival3.js";
+export const AEROX3_REPORT_ID = 0x00;
+/** One-byte command prefixes; the payload is the prefix plus its arguments. */
+export const AEROX3_COMMAND = {
+    dpiPresets: [0x2d],
+    pollingRate: [0x2b],
+    reactiveColor: [0x26],
+    ledBrightness: [0x23],
+    rainbowEffect: [0x22],
+    buttonsMapping: [0x2a],
+    defaultLighting: [0x27],
+    zoneColor: [0x21],
+};
+/** `11 00` — distinct from Rival 3 Gen 1's `09 00`; do not reuse across families. */
+export const AEROX3_SAVE_COMMAND = [0x11, 0x00];
+export const AEROX3_POLLING_RATES = [125, 250, 500, 1000];
+const POLLING_RATE_TO_BYTE = new Map([
+    [1000, 0x01],
+    [500, 0x02],
+    [250, 0x03],
+    [125, 0x04],
+]);
+export const AEROX3_DPI_MIN = 200;
+export const AEROX3_DPI_MAX = 8500;
+export const AEROX3_DPI_STEP = 100;
+export const AEROX3_MAX_DPI_PRESETS = 5;
+export class Aerox3ProtocolError extends Error {
+}
+/** The 84 DPI values the shared TrueMove Core sensor table can express, ascending. */
+export function steelseriesAerox3DpiOptions() {
+    return [...TRUEMOVE_CORE_DPI_TO_BYTE.keys()].sort((a, b) => a - b);
+}
+/**
+ * `2D <count> <selected> <v1>…<vN>` — replaces the mouse's whole preset
+ * table. One byte per DPI (`dpi_length_byte: 1`); `selectedIndex` is 0-based
+ * here and encoded 1-based on the wire (`first_preset: 1`).
+ */
+export function steelseriesAerox3EncodeDpiPresets(presets, selectedIndex) {
+    if (presets.length < 1 || presets.length > AEROX3_MAX_DPI_PRESETS) {
+        throw new Aerox3ProtocolError(`SteelSeries Aerox 3 supports 1–${AEROX3_MAX_DPI_PRESETS} DPI presets.`);
+    }
+    if (!Number.isInteger(selectedIndex) || selectedIndex < 0 || selectedIndex >= presets.length) {
+        throw new Aerox3ProtocolError(`Selected DPI preset must be an index into the ${presets.length} presets being written.`);
+    }
+    const encoded = presets.map((dpi) => {
+        const byte = TRUEMOVE_CORE_DPI_TO_BYTE.get(dpi);
+        if (byte === undefined) {
+            throw new Aerox3ProtocolError(`SteelSeries Aerox 3 DPI must be ${AEROX3_DPI_MIN}–${AEROX3_DPI_MAX.toLocaleString()} in ${AEROX3_DPI_STEP} DPI steps.`);
+        }
+        return byte;
+    });
+    return new Uint8Array([...AEROX3_COMMAND.dpiPresets, presets.length, selectedIndex + 1, ...encoded]);
+}
+/** `2B <v>` with 1000→0x01, 500→0x02, 250→0x03, 125→0x04. */
+export function steelseriesAerox3EncodePollingRate(pollingRateHz) {
+    const byte = POLLING_RATE_TO_BYTE.get(pollingRateHz);
+    if (byte === undefined) {
+        throw new Aerox3ProtocolError("SteelSeries Aerox 3 supports 125, 250, 500, or 1000 Hz polling.");
+    }
+    return new Uint8Array([...AEROX3_COMMAND.pollingRate, byte]);
+}
+function encodeRgb(r, g, b) {
+    for (const channel of [r, g, b]) {
+        if (!Number.isInteger(channel) || channel < 0 || channel > 255) {
+            throw new Aerox3ProtocolError("RGB channels must be integers 0–255.");
+        }
+    }
+    return [r, g, b];
+}
+/**
+ * `21 <bitmask> <padding for skipped zones> <r> <g> <b>` — see the module
+ * doc comment for how the zero-padding length grows with the zone number.
+ * Zone 1 = top LED, zone 2 = middle LED, zone 3 = bottom LED (strip order,
+ * per `aerox3.py`'s CLI flag labels).
+ */
+export function steelseriesAerox3EncodeZoneColor(zone, r, g, b) {
+    const [red, green, blue] = encodeRgb(r, g, b);
+    if (zone === 1) {
+        return new Uint8Array([...AEROX3_COMMAND.zoneColor, 0x01, red, green, blue]);
+    }
+    if (zone === 2) {
+        return new Uint8Array([...AEROX3_COMMAND.zoneColor, 0x02, 0x00, 0x00, 0x00, red, green, blue]);
+    }
+    if (zone === 3) {
+        return new Uint8Array([
+            ...AEROX3_COMMAND.zoneColor, 0x04, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, red, green, blue,
+        ]);
+    }
+    throw new Aerox3ProtocolError("SteelSeries Aerox 3 has zones 1 (top), 2 (middle), and 3 (bottom) only.");
+}
+/**
+ * `26 00 00 00 00 00` when disabled, `26 01 00 <r> <g> <b>` when enabled —
+ * the color the LEDs flash to in reaction to a button click.
+ */
+export function steelseriesAerox3EncodeReactiveColor(color) {
+    if (color === null) {
+        return new Uint8Array([...AEROX3_COMMAND.reactiveColor, 0x00, 0x00, 0x00, 0x00, 0x00]);
+    }
+    const [r, g, b] = encodeRgb(color.r, color.g, color.b);
+    return new Uint8Array([...AEROX3_COMMAND.reactiveColor, 0x01, 0x00, r, g, b]);
+}
+/** `23 <v>` — linear 0–100 passthrough (`output_range` matches `input_range`). */
+export function steelseriesAerox3EncodeLedBrightness(percent) {
+    if (!Number.isInteger(percent) || percent < 0 || percent > 100) {
+        throw new Aerox3ProtocolError("SteelSeries Aerox 3 LED brightness must be an integer 0–100.");
+    }
+    return new Uint8Array([...AEROX3_COMMAND.ledBrightness, percent]);
+}
+export const AEROX3_RAINBOW_ZONES = {
+    all: 0b111,
+    bottom: 0b100,
+    middle: 0b010,
+    top: 0b001,
+    "bottom-middle": 0b110,
+    "middle-top": 0b011,
+    "bottom-top": 0b101,
+};
+/** `22 <bitmask>` — rainbow effect on the selected zone(s); cleared by setting a color. */
+export function steelseriesAerox3EncodeRainbowEffect(zones) {
+    const byte = AEROX3_RAINBOW_ZONES[zones];
+    if (byte === undefined) {
+        throw new Aerox3ProtocolError(`SteelSeries Aerox 3 rainbow zones must be one of: ${Object.keys(AEROX3_RAINBOW_ZONES).join(", ")}.`);
+    }
+    return new Uint8Array([...AEROX3_COMMAND.rainbowEffect, byte]);
+}
+export const AEROX3_DEFAULT_LIGHTING = {
+    off: [0x00, 0x00],
+    reactive: [0x00, 0x01],
+    rainbow: [0x01, 0x00],
+    "reactive-rainbow": [0x01, 0x01],
+};
+/** `27 <v1> <v2>` — what the mouse lights up as before a host ever connects. */
+export function steelseriesAerox3EncodeDefaultLighting(mode) {
+    const bytes = AEROX3_DEFAULT_LIGHTING[mode];
+    if (bytes === undefined) {
+        throw new Aerox3ProtocolError(`SteelSeries Aerox 3 default lighting must be one of: ${Object.keys(AEROX3_DEFAULT_LIGHTING).join(", ")}.`);
+    }
+    return new Uint8Array([...AEROX3_COMMAND.defaultLighting, ...bytes]);
+}
+/** `11 00` — commit the current settings to onboard flash. */
+export function steelseriesAerox3SaveCommand() {
+    return new Uint8Array(AEROX3_SAVE_COMMAND);
+}
+/** `buttons_mapping.buttons` from `aerox3.py`, id + byte offset into the packet. */
+export const AEROX3_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 AEROX3_BUTTON_FIELD_LENGTH = 5;
+const AEROX3_BUTTON_DISABLE = 0x00;
+const AEROX3_BUTTON_DPI_SWITCH = 0x30;
+const AEROX3_BUTTON_KEYBOARD = 0x51;
+const AEROX3_BUTTON_MULTIMEDIA = 0x61;
+/**
+ * `2A` + 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 steelseriesAerox3EncodeButtonsMapping(mapping) {
+    const names = Object.keys(AEROX3_BUTTONS);
+    const packet = new Array(names.length * AEROX3_BUTTON_FIELD_LENGTH).fill(0x00);
+    for (const [name, action] of Object.entries(mapping)) {
+        const slot = AEROX3_BUTTONS[name];
+        if (!slot) {
+            throw new Aerox3ProtocolError(`Unknown SteelSeries Aerox 3 button "${name}".`);
+        }
+        const { offset } = slot;
+        switch (action.type) {
+            case "button": {
+                packet[offset] = AEROX3_BUTTONS[action.target].id;
+                break;
+            }
+            case "disabled": {
+                packet[offset] = AEROX3_BUTTON_DISABLE;
+                break;
+            }
+            case "dpiSwitch": {
+                packet[offset] = AEROX3_BUTTON_DPI_SWITCH;
+                break;
+            }
+            case "keyboard": {
+                if (!Number.isInteger(action.code) || action.code < 0 || action.code > 255) {
+                    throw new Aerox3ProtocolError("Keyboard scan codes must be integers 0–255.");
+                }
+                packet[offset] = AEROX3_BUTTON_KEYBOARD;
+                packet[offset + 1] = action.code;
+                break;
+            }
+            case "multimedia": {
+                if (!Number.isInteger(action.code) || action.code < 0 || action.code > 255) {
+                    throw new Aerox3ProtocolError("Multimedia key codes must be integers 0–255.");
+                }
+                packet[offset] = AEROX3_BUTTON_MULTIMEDIA;
+                packet[offset + 1] = action.code;
+                break;
+            }
+            default: {
+                throw new Aerox3ProtocolError(`Unsupported SteelSeries Aerox 3 button action.`);
+            }
+        }
+    }
+    return new Uint8Array([...AEROX3_COMMAND.buttonsMapping, ...packet]);
+}
+//# sourceMappingURL=aerox3.js.map

package/dist/steelseries/aerox3.js.map

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