@openmouse/protocol 0.1.0

package/dist/drivers/fantech/hid.js

@@ -0,0 +1,295 @@
+import { VENDOR_ID } from "../vendors.js";
+import { GEARHUB_PRODUCTS } from "@openmouse/protocol/gearhub";
+// Fantech command IDs (from GearHub qmk.top protocol)
+export const CMD = {
+    // Family B (older Fantech mice) command set
+    GET_ALL_PARAMS: 159, // Get all parameters (profile, report rate, etc.)
+    GET_DPI: 144, // Get DPI settings (SENSORDPI)
+    SET_DPI: 16, // Set DPI settings
+    GET_REPORT_RATE: 131, // Get report/polling rate
+    SET_REPORT_RATE: 8, // Set report/polling rate
+    GET_DEBOUNCE: 132, // Get debounce time
+    SET_DEBOUNCE: 4, // Set debounce time
+    SET_PROFILE: 2, // Set current profile
+};
+/**
+ * Report rate encoding for Fantech mice.
+ *
+ * This table is also the single source of truth for `supportedPollingRates`:
+ * a rate the driver cannot encode must never reach the UI, which renders one
+ * button per advertised rate and would throw on click. 250 Hz is deliberately
+ * absent — Fantech's own spec sheet lists it for the WG14P, but its wire
+ * encoding has never been captured, and inventing a code byte would silently
+ * set some other rate. Add it here, and nowhere else, once a capture confirms
+ * the value.
+ */
+export const REPORT_RATE_ENCODE = {
+    8000: 0,
+    4000: 1,
+    2000: 2,
+    1000: 3,
+    500: 4,
+    125: 5,
+};
+export const REPORT_RATE_DECODE = Object.fromEntries(Object.entries(REPORT_RATE_ENCODE).map(([k, v]) => [v, Number(k)]));
+export const FANTECH_REPORT_ID = 0x00;
+export const FANTECH_REPORT_SIZE = 64;
+/** DPI slots the Family B report layout has room for (bytes [8..23] X, [24..39] Y). */
+export const FANTECH_MAX_DPI_SLOTS = 8;
+/** First byte of the per-slot X DPI array, in both a GET_DPI response and a SET_DPI command. */
+const DPI_X_OFFSET = 8;
+/** First byte of the per-slot Y DPI array, immediately after the X array. */
+const DPI_Y_OFFSET = DPI_X_OFFSET + FANTECH_MAX_DPI_SLOTS * 2;
+/** One past the end of the Y array; the whole DPI table is [DPI_X_OFFSET, DPI_END). */
+const DPI_END = DPI_Y_OFFSET + FANTECH_MAX_DPI_SLOTS * 2;
+function rejectionMessage(result) {
+    return result.reason instanceof Error ? result.reason.message : String(result.reason);
+}
+/**
+ * Fantech vendor HID control.
+ *
+ * Transport: vendor usage page 0xFFFF, usage 0x02 under VID 0x3151.
+ * The WG14P Yari Pro exposes a 64-byte feature report on this interface
+ * for DPI and configuration settings.
+ *
+ * Protocol: Fantech command-based protocol (Family B).
+ * - Send command as first byte of 64-byte feature report
+ * - Read response as 64-byte feature report
+ * - DPI stored as LE uint16 in bytes [8+h*2..9+h*2] (X) and [24+h*2..25+h*2] (Y)
+ * - Report rate encoded as 0=8000, 1=4000, 2=2000, 3=1000, 4=500, 5=125
+ *
+ * NOT every VID 0x3151 mouse speaks Family B, and the ones that do not are
+ * indistinguishable from the ones that do until you ask them something. The
+ * 2.4G receiver sold as PID 0x402D presents byte-for-byte the interface
+ * described above — vendor page 0xFFFF, usage 0x02, one unnumbered 64-byte
+ * feature report — and ACKs every SET_FEATURE write without error, yet
+ * answers GET_DPI, GET_REPORT_RATE, GET_ALL_PARAMS and GET_DEBOUNCE alike
+ * with 64 zero bytes (measured on Windows across 0-500ms read delays and
+ * three different command layouts).
+ *
+ * Reading those zeros as data is worse than failing outright: byte 2 of a
+ * blank response decodes to report-rate code 0 = 8000 Hz, and a zero DPI used
+ * to fall back to 1600, so `readStatus()` returned a perfectly plausible
+ * "ready" mouse whose every number was invented. Each read below therefore
+ * rejects a blank response, and `readStatus()` throws when nothing answers at
+ * all — the caller treats that as "try the next candidate driver" (see
+ * `connectToInterface()` in the desktop app under `src/native-hid/scan.ts`).
+ */
+export class FantechHidClient {
+    device;
+    currentProfile = 0;
+    constructor(device) {
+        this.device = device;
+    }
+    static isSupported(device) {
+        if (device.vendorId !== VENDOR_ID.fantech)
+            return false;
+        // 0x3151 is the MicLink/mlzn ODM vendor id, not Fantech's own, and the
+        // GearHub-V5 mice (Lingbao M5 Pro, Attack Shark R2, …) answer on the
+        // identical 0xFFFF/0x02 interface while speaking a different dialect
+        // entirely (2.4G relay + Bit7 checksum). They have their own driver;
+        // leave their product ids to it, or driverFor() would hand this one a
+        // device it cannot read.
+        if (GEARHUB_PRODUCTS.has(device.productId))
+            return false;
+        const hasVendorConfig = (collections) => collections.some((collection) => (collection.usagePage === 0xffff &&
+            collection.usage === 0x02) ||
+            hasVendorConfig(collection.children));
+        return hasVendorConfig(device.collections);
+    }
+    /**
+     * Only the rates this driver can actually put on the wire. Derived from
+     * REPORT_RATE_ENCODE so the list the UI renders and the list
+     * `setReportRate()` accepts cannot drift apart.
+     */
+    get supportedPollingRates() {
+        return Object.keys(REPORT_RATE_ENCODE)
+            .map(Number)
+            .sort((a, b) => a - b);
+    }
+    getDpiOptions() {
+        return [
+            400, 800, 1200, 1600, 2000, 2400, 3200, 4000, 4800, 5600, 6400, 8000,
+            10000, 12000, 16000, 20000, 26000, 30000,
+        ];
+    }
+    async open() {
+        if (!this.device.opened)
+            await this.device.open();
+    }
+    async close() {
+        if (this.device.opened)
+            await this.device.close();
+    }
+    // ---------------------------------------------------------------------------
+    // Command I/O
+    // ---------------------------------------------------------------------------
+    /** Send a command and return the raw response, answered or not. */
+    async sendCommand(cmd, ...payload) {
+        const buf = new Uint8Array(FANTECH_REPORT_SIZE);
+        buf[0] = cmd;
+        for (let i = 0; i < payload.length && i + 1 < buf.length; i++) {
+            buf[i + 1] = payload[i];
+        }
+        await this.device.sendFeatureReport(FANTECH_REPORT_ID, buf);
+        return this.readResponse();
+    }
+    /**
+     * Send a command that must be answered, rejecting a response that carries no
+     * answer at all. A device on a different protocol family still ACKs the
+     * feature write and hands back a zero-filled buffer, which is exactly what
+     * used to be decoded into invented DPI and polling-rate readings — see the
+     * class docs.
+     */
+    async sendQuery(cmd, ...payload) {
+        const resp = await this.sendCommand(cmd, ...payload);
+        if (resp.length < FANTECH_REPORT_SIZE) {
+            throw new Error(`Fantech command ${cmd} returned ${resp.length} bytes, expected ${FANTECH_REPORT_SIZE}.`);
+        }
+        if (resp.every((byte) => byte === 0)) {
+            throw new Error(`Fantech command ${cmd} was not answered (all-zero response); this device does not speak the Family B protocol.`);
+        }
+        return resp;
+    }
+    /** Read a response report. */
+    async readResponse() {
+        const view = await this.device.receiveFeatureReport(FANTECH_REPORT_ID);
+        return new Uint8Array(view.buffer.slice(view.byteOffset, view.byteOffset + view.byteLength));
+    }
+    // ---------------------------------------------------------------------------
+    // DPI Protocol
+    // ---------------------------------------------------------------------------
+    /**
+     * Read current DPI settings for the active slot. Throws when the device does
+     * not answer, or answers without a usable DPI — a caller must never be handed
+     * a fabricated default it cannot tell apart from a real reading.
+     */
+    async getDpi() {
+        await this.open();
+        const resp = await this.sendQuery(CMD.GET_DPI, this.currentProfile);
+        // Response structure (Family B):
+        // Byte 2: current DPI slot index
+        // Byte 3: number of DPI slots
+        // Bytes [8..23]: X DPI per slot (LE uint16, up to 8 slots)
+        // Bytes [24..39]: Y DPI per slot (LE uint16, up to 8 slots)
+        const slot = resp[2] >= FANTECH_MAX_DPI_SLOTS ? 0 : resp[2];
+        const numSlots = resp[3] || 1;
+        const dpiX = resp[DPI_X_OFFSET + slot * 2] | (resp[DPI_X_OFFSET + 1 + slot * 2] << 8);
+        const dpiY = resp[DPI_Y_OFFSET + slot * 2] | (resp[DPI_Y_OFFSET + 1 + slot * 2] << 8);
+        if (!dpiX) {
+            throw new Error(`Fantech GET_DPI answered, but slot ${slot} carries no DPI value.`);
+        }
+        return { dpiX, dpiY: dpiY || dpiX, slot, numSlots };
+    }
+    /** Set DPI for a specific slot, leaving every other slot exactly as it was. */
+    async setDpiForSlot(dpiX, dpiY, slot = 0) {
+        await this.open();
+        // Read current state first. SET_DPI carries the WHOLE per-slot DPI table,
+        // so every slot that is not being written has to be echoed back unchanged;
+        // sending a freshly zeroed buffer wiped the other DPI stages.
+        const readResp = await this.sendQuery(CMD.GET_DPI, this.currentProfile);
+        const numSlots = readResp[3] || 1;
+        const target = slot >= FANTECH_MAX_DPI_SLOTS ? 0 : slot;
+        // Build the Set DPI command
+        const buf = new Uint8Array(FANTECH_REPORT_SIZE);
+        buf[0] = CMD.SET_DPI;
+        buf[1] = this.currentProfile;
+        buf[2] = target;
+        buf[3] = numSlots;
+        // Carry every slot's existing X and Y over before overwriting the target's.
+        buf.set(readResp.subarray(DPI_X_OFFSET, DPI_END), DPI_X_OFFSET);
+        // Write X DPI as LE uint16
+        buf[DPI_X_OFFSET + target * 2] = dpiX & 0xff;
+        buf[DPI_X_OFFSET + 1 + target * 2] = (dpiX >> 8) & 0xff;
+        // Write Y DPI as LE uint16
+        buf[DPI_Y_OFFSET + target * 2] = dpiY & 0xff;
+        buf[DPI_Y_OFFSET + 1 + target * 2] = (dpiY >> 8) & 0xff;
+        await this.device.sendFeatureReport(FANTECH_REPORT_ID, buf);
+        return dpiX;
+    }
+    // ---------------------------------------------------------------------------
+    // Report Rate Protocol
+    // ---------------------------------------------------------------------------
+    /** Get current report/polling rate. Throws when the device does not answer. */
+    async getReportRate() {
+        await this.open();
+        const resp = await this.sendQuery(CMD.GET_REPORT_RATE);
+        const code = resp[2];
+        const hz = REPORT_RATE_DECODE[code];
+        if (hz === undefined) {
+            throw new Error(`Fantech GET_REPORT_RATE returned unknown rate code ${code}.`);
+        }
+        return hz;
+    }
+    /** Set report/polling rate. */
+    async setReportRate(hz) {
+        if (!(hz in REPORT_RATE_ENCODE)) {
+            throw new Error(`Unsupported rate ${hz} Hz. Supported: ${this.supportedPollingRates.join(", ")}`);
+        }
+        await this.open();
+        const code = REPORT_RATE_ENCODE[hz];
+        const buf = new Uint8Array(FANTECH_REPORT_SIZE);
+        buf[0] = CMD.SET_REPORT_RATE;
+        buf[1] = code;
+        await this.device.sendFeatureReport(FANTECH_REPORT_ID, buf);
+        return hz;
+    }
+    // ---------------------------------------------------------------------------
+    // High-Level API
+    // ---------------------------------------------------------------------------
+    async readStatus() {
+        await this.open();
+        const [dpiResult, pollRate] = await Promise.allSettled([
+            this.getDpi(),
+            this.getReportRate(),
+        ]);
+        // Nothing answered at all: this interface is not a Family B control
+        // channel, so fail instead of returning a status assembled from defaults.
+        if (dpiResult.status === "rejected" && pollRate.status === "rejected") {
+            throw new Error(`Fantech control interface did not answer. ${rejectionMessage(dpiResult)} ${rejectionMessage(pollRate)}`);
+        }
+        const dpiData = dpiResult.status === "fulfilled" ? dpiResult.value : null;
+        const pollRateVal = pollRate.status === "fulfilled" ? pollRate.value : 1000;
+        return {
+            brand: "Fantech",
+            name: this.device.productName || "Fantech Mouse",
+            ui: {
+                family: "fantech",
+                settingsReady: dpiData !== null,
+                hideLodLow: true,
+                hideUnsupportedPollingRates: true,
+                hideProcessingCard: true,
+                defaultDisplayName: this.device.productName || "Fantech Mouse",
+            },
+            batteryPercent: null,
+            batteryState: "Unknown",
+            dpi: dpiData?.dpiX ?? 1600,
+            dpiY: dpiData?.dpiY ?? dpiData?.dpiX ?? 1600,
+            pollingRateHz: pollRateVal,
+            supportedPollingRates: this.supportedPollingRates,
+            activeProfile: this.currentProfile,
+            // connectionType/connectionDetail are deliberately unset. Family B
+            // carries no link information, and VID 0x3151 covers both wired mice and
+            // 2.4G receivers, so the "Wired (USB)" that used to be hardcoded here
+            // mislabelled every wireless one. OverviewPage hides the row when absent.
+            liftOffDistance: null,
+            // No firmware command is implemented; an empty list hides the row instead
+            // of showing the placeholder string that used to sit here.
+            firmware: [],
+        };
+    }
+    async setDpi(dpi, dpiY = dpi) {
+        await this.open();
+        const current = await this.getDpi();
+        await this.setDpiForSlot(dpi, dpiY, current.slot);
+        return dpi;
+    }
+    async setPollingRate(rate) {
+        if (!this.supportedPollingRates.includes(rate)) {
+            throw new Error(`Fantech supports ${this.supportedPollingRates.join(", ")} Hz.`);
+        }
+        await this.setReportRate(rate);
+        return rate;
+    }
+}
+//# sourceMappingURL=hid.js.map

package/dist/drivers/fantech/hid.js.map

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

package/dist/drivers/finalmouse/hid.d.ts

@@ -0,0 +1,31 @@
+import type { MouseStatus } from "../mouse-types.js";
+export declare const FINALMOUSE_VENDOR_ID = 13853;
+export declare const FINALMOUSE_ULX_DONGLE_PRODUCT_ID = 256;
+export declare const FINALMOUSE_DISPLAY_NAME = "Finalmouse UltralightX";
+export declare class FinalmouseHidClient {
+    readonly device: HIDDevice;
+    private telemetry;
+    private reportRevision;
+    private listenerAttached;
+    private readonly reportWaiters;
+    private readonly onInputReport;
+    constructor(device: HIDDevice);
+    static isSupported(device: HIDDevice): boolean;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    displayName(): string;
+    get pollIntervalMs(): number;
+    getDpiOptions(): number[];
+    readStatus(): Promise<MouseStatus>;
+    setDpi(dpi: number): Promise<number>;
+    setPollingRate(pollingRateHz: number): Promise<number>;
+    setMotionSync(enabled: boolean): Promise<boolean>;
+    setLiftOffDistance(value: NonNullable<MouseStatus["liftOffDistance"]>): Promise<NonNullable<MouseStatus["liftOffDistance"]>>;
+    setDongleLedMode(mode: number): Promise<number>;
+    setTournamentScrollMode(mode: number): Promise<number>;
+    setTournamentScrollTimeout(milliseconds: number): Promise<number>;
+    private writeU16;
+    private write;
+    private waitForReport;
+}
+//# sourceMappingURL=hid.d.ts.map

package/dist/drivers/finalmouse/hid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/finalmouse/hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AASrD,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAC3C,eAAO,MAAM,gCAAgC,MAAS,CAAC;AACvD,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAUhE,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IAEvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAO5B;gBAEU,MAAM,EAAE,SAAS;IAI7B,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAMxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,WAAW,IAAI,MAAM;IAIrB,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,aAAa,IAAI,MAAM,EAAE;IAInB,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAqDlC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOpC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOtD,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAMjD,kBAAkB,CAAC,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAQ5H,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO/C,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOtD,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAOzD,QAAQ;YAIR,KAAK;YAML,aAAa;CAa5B"}

package/dist/drivers/finalmouse/hid.js

@@ -0,0 +1,181 @@
+import { buildFinalmouseReport, decodeFinalmouseReport, FINALMOUSE_COMMAND, FINALMOUSE_REPORT, } from "@openmouse/protocol/finalmouse";
+export const FINALMOUSE_VENDOR_ID = 0x361d;
+export const FINALMOUSE_ULX_DONGLE_PRODUCT_ID = 0x0100;
+export const FINALMOUSE_DISPLAY_NAME = "Finalmouse UltralightX";
+const POLLING_RATES = [500, 1000, 2000, 4000, 8000];
+const DPI_MIN = 50;
+const DPI_MAX = 26000;
+function pause(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+export class FinalmouseHidClient {
+    device;
+    telemetry = {};
+    reportRevision = 0;
+    listenerAttached = false;
+    reportWaiters = new Set();
+    onInputReport = (event) => {
+        const bytes = new Uint8Array(event.data.buffer.slice(event.data.byteOffset, event.data.byteOffset + event.data.byteLength));
+        const update = decodeFinalmouseReport(event.reportId, bytes);
+        if (!update)
+            return;
+        Object.assign(this.telemetry, update);
+        this.reportRevision += 1;
+        for (const finish of [...this.reportWaiters])
+            finish();
+    };
+    constructor(device) {
+        this.device = device;
+    }
+    static isSupported(device) {
+        return device.vendorId === FINALMOUSE_VENDOR_ID
+            && device.productId === FINALMOUSE_ULX_DONGLE_PRODUCT_ID
+            && device.collections.some((collection) => collection.usagePage === 0xff00 && collection.usage === 0x0001);
+    }
+    async open() {
+        if (!this.device.opened)
+            await this.device.open();
+        if (!this.listenerAttached) {
+            this.device.addEventListener("inputreport", this.onInputReport);
+            this.listenerAttached = true;
+        }
+    }
+    async close() {
+        if (this.listenerAttached) {
+            this.device.removeEventListener("inputreport", this.onInputReport);
+            this.listenerAttached = false;
+        }
+        if (this.device.opened)
+            await this.device.close();
+    }
+    displayName() {
+        return FINALMOUSE_DISPLAY_NAME;
+    }
+    get pollIntervalMs() {
+        return 10_000;
+    }
+    getDpiOptions() {
+        return Array.from({ length: DPI_MAX - DPI_MIN + 1 }, (_, index) => DPI_MIN + index);
+    }
+    async readStatus() {
+        await this.open();
+        const revision = this.reportRevision;
+        await this.write(FINALMOUSE_REPORT.main, FINALMOUSE_COMMAND.liftOffDistance);
+        await this.write(FINALMOUSE_REPORT.main, FINALMOUSE_COMMAND.wakeAll);
+        await this.write(FINALMOUSE_REPORT.dongle, FINALMOUSE_COMMAND.dongleInfo);
+        await this.waitForReport(revision, 1000);
+        // Status arrives as a short burst of separate feature reports.
+        await pause(75);
+        const state = this.telemetry;
+        if (state.dpi === undefined || state.pollingRateHz === undefined) {
+            throw new Error("The Finalmouse UltralightX did not return its current settings. Make sure the mouse is on and close xpanel or other Finalmouse software.");
+        }
+        const firmware = [
+            state.mouseFirmware ? `Mouse ${state.mouseFirmware}` : null,
+            state.dongleRfFirmware ? `Dongle RF ${state.dongleRfFirmware}` : null,
+            state.dongleUsbFirmware ? `Dongle USB ${state.dongleUsbFirmware}` : null,
+        ].filter((value) => value !== null);
+        const connectionDetail = [
+            "2.4 GHz receiver",
+            state.rssiDbm === undefined ? null : `${state.rssiDbm} dBm`,
+        ].filter((value) => value !== null).join(" · ");
+        return {
+            brand: "Finalmouse",
+            name: this.displayName(),
+            ui: {
+                family: "finalmouse-ulx",
+                defaultDisplayName: FINALMOUSE_DISPLAY_NAME,
+                hideUnsupportedPollingRates: true,
+                forceShowBattery: true,
+            },
+            batteryPercent: state.batteryPercent ?? null,
+            batteryVoltageMv: state.batteryVoltageMv ?? null,
+            batteryState: state.chargingState === 1 ? "Charging" : state.chargingState === undefined ? "Unknown" : "Discharging",
+            dpi: state.dpi,
+            pollingRateHz: state.pollingRateHz,
+            supportedPollingRates: [...POLLING_RATES],
+            activeProfile: null,
+            unitId: state.mouseSerial ?? null,
+            connectionType: "Wireless",
+            connectionDetail,
+            motionSync: state.motionSync ?? null,
+            liftOffDistance: state.liftOffDistanceMm === 1 ? "Medium" : state.liftOffDistanceMm === 2 ? "High" : null,
+            supportedLiftOffDistances: ["Medium", "High"],
+            finalmouseDongleLedMode: state.dongleLedMode ?? null,
+            finalmouseTournamentScrollMode: state.tournamentScrollMode ?? null,
+            finalmouseTournamentScrollTimeoutMs: state.tournamentScrollTimeoutMs ?? null,
+            firmware,
+        };
+    }
+    async setDpi(dpi) {
+        if (!Number.isInteger(dpi) || dpi < DPI_MIN || dpi > DPI_MAX)
+            throw new Error("Finalmouse UltralightX DPI must be between 50 and 26,000.");
+        await this.writeU16(FINALMOUSE_COMMAND.dpi, dpi);
+        this.telemetry.dpi = dpi;
+        return dpi;
+    }
+    async setPollingRate(pollingRateHz) {
+        if (!POLLING_RATES.includes(pollingRateHz))
+            throw new Error("Unsupported Finalmouse UltralightX polling rate.");
+        await this.writeU16(FINALMOUSE_COMMAND.pollingRate, pollingRateHz);
+        this.telemetry.pollingRateHz = pollingRateHz;
+        return pollingRateHz;
+    }
+    async setMotionSync(enabled) {
+        await this.write(FINALMOUSE_REPORT.main, FINALMOUSE_COMMAND.motionSync, new Uint8Array([enabled ? 1 : 0]));
+        this.telemetry.motionSync = enabled;
+        return enabled;
+    }
+    async setLiftOffDistance(value) {
+        const millimeters = value === "Medium" ? 1 : value === "High" ? 2 : null;
+        if (millimeters === null)
+            throw new Error("Finalmouse UltralightX lift-off distance must be 1 mm or 2 mm.");
+        await this.write(FINALMOUSE_REPORT.main, FINALMOUSE_COMMAND.liftOffDistance, new Uint8Array([millimeters]));
+        this.telemetry.liftOffDistanceMm = millimeters;
+        return value;
+    }
+    async setDongleLedMode(mode) {
+        if (![0, 1, 2].includes(mode))
+            throw new Error("Unsupported Finalmouse dongle LED mode.");
+        await this.write(FINALMOUSE_REPORT.main, FINALMOUSE_COMMAND.dongleLed, new Uint8Array([mode]));
+        this.telemetry.dongleLedMode = mode;
+        return mode;
+    }
+    async setTournamentScrollMode(mode) {
+        if (![0, 1, 2, 3].includes(mode))
+            throw new Error("Unsupported Finalmouse tournament scroll mode.");
+        await this.write(FINALMOUSE_REPORT.main, FINALMOUSE_COMMAND.tournamentScrollMode, new Uint8Array([mode]));
+        this.telemetry.tournamentScrollMode = mode;
+        return mode;
+    }
+    async setTournamentScrollTimeout(milliseconds) {
+        if (![100, 500, 1000, 1500].includes(milliseconds))
+            throw new Error("Unsupported Finalmouse tournament scroll timeout.");
+        await this.write(FINALMOUSE_REPORT.main, FINALMOUSE_COMMAND.tournamentScrollTimeout, new Uint8Array([milliseconds / 100]));
+        this.telemetry.tournamentScrollTimeoutMs = milliseconds;
+        return milliseconds;
+    }
+    async writeU16(command, value) {
+        await this.write(FINALMOUSE_REPORT.main, command, new Uint8Array([value & 0xff, value >> 8]));
+    }
+    async write(reportId, command, payload = new Uint8Array()) {
+        await this.open();
+        const report = buildFinalmouseReport(command, payload);
+        await this.device.sendReport(reportId, report.buffer);
+    }
+    async waitForReport(afterRevision, timeoutMs) {
+        if (this.reportRevision > afterRevision)
+            return;
+        await new Promise((resolve) => {
+            let timer = 0;
+            const finish = () => {
+                clearTimeout(timer);
+                this.reportWaiters.delete(finish);
+                resolve();
+            };
+            timer = setTimeout(finish, timeoutMs);
+            this.reportWaiters.add(finish);
+        });
+    }
+}
+//# sourceMappingURL=hid.js.map

package/dist/drivers/finalmouse/hid.js.map

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