@openmouse/protocol 0.1.0

package/dist/drivers/pulsar/pulsar-xs1-hid.js

@@ -0,0 +1,251 @@
+import { PULSAR_CONFIG_REPORT_ID as CONFIG_REPORT_ID, PULSAR_VENDOR_ID, PULSAR_XS1_DEBOUNCE_MAX_MS as DEBOUNCE_MAX_MS, PULSAR_XS1_FEATURE_REPORT_ID as REPORT_ID, PULSAR_XS1_PACKET_LENGTH as PACKET_LENGTH, PULSAR_XS1_POLLING_RATES as POLLING_RATES, PULSAR_XS1_PRODUCT_IDS, PULSAR_XS1_WIRELESS_PRODUCT_IDS, pulsarXs1DecodePollingRate, pulsarXs1DpiOptions, pulsarXs1EncodeRequest, readUint16LE, } from "@openmouse/protocol/pulsar";
+const RESPONSE_ATTEMPTS = 5;
+const RESPONSE_DELAY_MS = 25;
+const DPI_VALUE_OFFSET = 7;
+// The X3 family dongles report a generic "1K Dongle" product name from WebHID,
+// which is useless in the UI. Known product ids map to the paired model name.
+const XS1_PRODUCT_NAMES = new Map([
+    [0x5402, "Pulsar X3 M"],
+]);
+const LIFT_OFF_DISTANCES = [
+    [0x07, "Low"],
+    [0x0a, "Medium"],
+    [0x14, "High"],
+];
+const QUERY = {
+    version: [0x01, 0x87, 0x04],
+    dpi: [0x05, 0x82, 0x05],
+    stage: [0x05, 0x81, 0x02],
+    motionSync: [0x07, 0x85, 0x02],
+    rippleControl: [0x07, 0x83, 0x02],
+    angleSnapping: [0x07, 0x84, 0x02],
+    liftOffDistance: [0x07, 0x82, 0x03],
+    debounce: [0x04, 0x83, 0x03],
+    battery: [0x08, 0x81, 0x01],
+    pollingRate: [0x08, 0x85, 0x03],
+};
+const WRITE = {
+    dpi: (dpi) => [
+        0x05, 0x02, 0x05, 0x00, 0x00, 0x01,
+        dpi & 0xff, dpi >> 8, dpi & 0xff, dpi >> 8,
+    ],
+    stage: (stage) => [0x05, 0x01, 0x02, 0x00, 0x00, 0x01, stage],
+    motionSync: (enabled) => [0x07, 0x05, 0x02, 0x00, 0x00, 0x01, enabled ? 1 : 0],
+    rippleControl: (enabled) => [0x07, 0x03, 0x02, 0x00, 0x00, 0x01, enabled ? 1 : 0],
+    angleSnapping: (enabled) => [0x07, 0x04, 0x02, 0x00, 0x00, 0x01, enabled ? 1 : 0],
+    liftOffDistance: (value) => [0x07, 0x02, 0x03, 0x00, 0x00, 0x01, 0x02, value],
+    debounce: (milliseconds) => [0x04, 0x03, 0x03, 0x00, 0x00, 0x01, milliseconds],
+};
+export class PulsarXs1HidClient {
+    queue = Promise.resolve();
+    lastStatus = null;
+    deviceInfo = null;
+    device;
+    constructor(device) {
+        this.device = device;
+    }
+    static isSupported(device) {
+        if (device.vendorId !== PULSAR_VENDOR_ID || !PULSAR_XS1_PRODUCT_IDS.has(device.productId))
+            return false;
+        const hasXs1Feature = device.collections.some((collection) => collection.featureReports.some((report) => report.reportId === REPORT_ID));
+        const hasLegacyControl = device.collections.some((collection) => collection.inputReports.some((report) => report.reportId === CONFIG_REPORT_ID)
+            && collection.outputReports.some((report) => report.reportId === CONFIG_REPORT_ID));
+        return hasXs1Feature && !hasLegacyControl;
+    }
+    async open() {
+        if (!this.device.opened)
+            await this.device.open();
+    }
+    async close() {
+        if (this.device.opened)
+            await this.device.close();
+    }
+    describeCollections() {
+        return this.device.collections.map((collection) => {
+            const inputIds = collection.inputReports.map((report) => report.reportId);
+            const outputIds = collection.outputReports.map((report) => report.reportId);
+            const featureIds = collection.featureReports.map((report) => report.reportId);
+            return [
+                `usage 0x${collection.usagePage.toString(16)}:${collection.usage.toString(16)}`,
+                `in [${inputIds.join(", ") || "none"}]`,
+                `out [${outputIds.join(", ") || "none"}]`,
+                `feature [${featureIds.join(", ") || "none"}]`,
+            ].join(" · ");
+        }).join(" | ") || "No HID collections reported";
+    }
+    async readDeviceInfo() {
+        await this.open();
+        this.deviceInfo = {
+            connection: PULSAR_XS1_WIRELESS_PRODUCT_IDS.has(this.device.productId) ? "Wireless" : "Wired",
+            maximumPollingRateHz: 1000,
+        };
+        return this.deviceInfo;
+    }
+    async readStatus() {
+        await this.open();
+        const info = this.deviceInfo ?? await this.readDeviceInfo();
+        const battery = await this.query(QUERY.battery);
+        const dpiReply = await this.query(QUERY.dpi);
+        const batteryPercent = battery[6] <= 100 ? battery[6] : null;
+        const version = await this.query(QUERY.version).catch(() => null);
+        const motionSync = await this.query(QUERY.motionSync).catch(() => null);
+        const rippleControl = await this.query(QUERY.rippleControl).catch(() => null);
+        const angleSnapping = await this.query(QUERY.angleSnapping).catch(() => null);
+        const liftOffDistance = await this.query(QUERY.liftOffDistance).catch(() => null);
+        const debounce = await this.query(QUERY.debounce).catch(() => null);
+        const pollingRate = await this.query(QUERY.pollingRate).catch(() => null);
+        return this.lastStatus = {
+            brand: "Pulsar",
+            name: XS1_PRODUCT_NAMES.get(this.device.productId) ?? (this.device.productName || "Pulsar X3"),
+            ui: {
+                family: "pulsar",
+                hideUnsupportedPollingRates: true,
+                pollingReadOnly: true,
+                hideSleepCard: true,
+                hideSignalCard: true,
+                forceShowBattery: true,
+                pollingNote: "The X3 exposes its polling rate through the feature interface, but the reported value is not reliable.",
+            },
+            batteryPercent,
+            batteryState: batteryPercent === null ? "Unknown" : batteryPercent === 100 ? "Full" : "Discharging",
+            dpi: readUint16LE(dpiReply, DPI_VALUE_OFFSET),
+            pollingRateHz: pollingRate ? pulsarXs1DecodePollingRate(pollingRate[7]) ?? POLLING_RATES[3] : POLLING_RATES[3],
+            supportedPollingRates: [...POLLING_RATES],
+            activeProfile: null,
+            connectionType: info.connection,
+            connectionDetail: "XS-1 feature-report interface",
+            motionSync: motionSync ? motionSync[7] === 1 : null,
+            rippleControl: rippleControl ? rippleControl[7] === 1 : null,
+            angleSnapping: angleSnapping ? angleSnapping[7] === 1 : null,
+            debounceMs: debounce ? debounce[7] : null,
+            liftOffDistance: this.decodeLiftOffDistance(liftOffDistance ? liftOffDistance[8] : 0),
+            firmware: [this.decodeFirmware(version)],
+        };
+    }
+    getDpiOptions() {
+        return pulsarXs1DpiOptions();
+    }
+    async setDpi(dpi) {
+        if (!this.getDpiOptions().includes(dpi)) {
+            throw new Error(`${dpi.toLocaleString()} DPI is not supported by this Pulsar sensor.`);
+        }
+        await this.send(WRITE.dpi(dpi));
+        const confirmed = await this.query(QUERY.dpi);
+        const confirmedX = readUint16LE(confirmed, DPI_VALUE_OFFSET);
+        const confirmedY = readUint16LE(confirmed, DPI_VALUE_OFFSET + 2);
+        if (confirmedX !== dpi || confirmedY !== dpi) {
+            throw new Error(`The mouse kept ${confirmedX.toLocaleString()} DPI instead of ${dpi.toLocaleString()}.`);
+        }
+        this.patch({ dpi: confirmedX });
+        return confirmedX;
+    }
+    async setMotionSync(enabled) {
+        return await this.setFlag(WRITE.motionSync, QUERY.motionSync, enabled, "motionSync", "Motion Sync");
+    }
+    async setRippleControl(enabled) {
+        return await this.setFlag(WRITE.rippleControl, QUERY.rippleControl, enabled, "rippleControl", "ripple control");
+    }
+    async setAngleSnapping(enabled) {
+        return await this.setFlag(WRITE.angleSnapping, QUERY.angleSnapping, enabled, "angleSnapping", "angle snapping");
+    }
+    async setLiftOffDistance(liftOffDistance) {
+        const encoded = LIFT_OFF_DISTANCES.find(([, name]) => name === liftOffDistance);
+        if (!encoded) {
+            throw new Error(`This mouse does not support a ${liftOffDistance.toLowerCase()} lift-off distance.`);
+        }
+        await this.send(WRITE.liftOffDistance(encoded[0]));
+        const confirmed = this.decodeLiftOffDistance((await this.query(QUERY.liftOffDistance))[8]);
+        if (confirmed !== liftOffDistance) {
+            throw new Error(`The mouse kept ${confirmed ?? "an unknown"} lift-off distance instead of ${liftOffDistance.toLowerCase()}.`);
+        }
+        this.patch({ liftOffDistance: confirmed });
+        return confirmed;
+    }
+    async setDebounceTime(debounceMs) {
+        if (!Number.isInteger(debounceMs) || debounceMs < 0 || debounceMs > DEBOUNCE_MAX_MS) {
+            throw new Error(`This Pulsar model supports a debounce time from 0 to ${DEBOUNCE_MAX_MS} ms.`);
+        }
+        await this.send(WRITE.debounce(debounceMs));
+        const confirmed = (await this.query(QUERY.debounce))[7];
+        if (confirmed !== debounceMs) {
+            throw new Error(`The mouse kept ${confirmed} ms of debounce instead of ${debounceMs} ms.`);
+        }
+        this.patch({ debounceMs: confirmed });
+        return confirmed;
+    }
+    async setFlag(write, read, enabled, field, label) {
+        await this.send(write(enabled));
+        const confirmed = (await this.query(read))[7] === 1;
+        if (confirmed !== enabled)
+            throw new Error(`The mouse left ${label} ${confirmed ? "on" : "off"}.`);
+        this.patch({ [field]: confirmed });
+        return confirmed;
+    }
+    async query(command) {
+        const run = this.queue.then(() => this.exchange(command), () => this.exchange(command));
+        this.queue = run.catch(() => undefined);
+        return await run;
+    }
+    async send(command) {
+        const run = this.queue.then(() => this.write(command), () => this.write(command));
+        this.queue = run.catch(() => undefined);
+        await run;
+    }
+    async exchange(command) {
+        await this.open();
+        const packet = pulsarXs1EncodeRequest(command);
+        let lastError = null;
+        for (let attempt = 0; attempt < RESPONSE_ATTEMPTS; attempt += 1) {
+            try {
+                await this.device.sendFeatureReport(REPORT_ID, packet);
+                await this.delay(RESPONSE_DELAY_MS);
+                const reply = this.copyDataView(await this.device.receiveFeatureReport(REPORT_ID));
+                if (reply.length !== PACKET_LENGTH) {
+                    throw new Error(`The Pulsar X3 answered with ${reply.length} bytes instead of ${PACKET_LENGTH}.`);
+                }
+                return reply;
+            }
+            catch (error) {
+                lastError = error;
+                await this.delay(RESPONSE_DELAY_MS);
+            }
+        }
+        throw new Error(`The Pulsar X3 did not answer ${this.describe(command)} after ${RESPONSE_ATTEMPTS} attempts. ${this.describeError(lastError)}`);
+    }
+    async write(command) {
+        await this.open();
+        try {
+            await this.device.sendFeatureReport(REPORT_ID, pulsarXs1EncodeRequest(command));
+        }
+        catch (error) {
+            throw new Error(`Chrome could not write the Pulsar X3 feature report. ${this.describeError(error)}`);
+        }
+    }
+    delay(milliseconds) {
+        return new Promise((resolve) => window.setTimeout(resolve, milliseconds));
+    }
+    copyDataView(view) {
+        return new Uint8Array(view.buffer.slice(view.byteOffset, view.byteOffset + view.byteLength));
+    }
+    patch(changes) {
+        if (this.lastStatus)
+            this.lastStatus = { ...this.lastStatus, ...changes };
+    }
+    decodeLiftOffDistance(value) {
+        return LIFT_OFF_DISTANCES.find(([encoded]) => encoded === value)?.[1] ?? null;
+    }
+    decodeFirmware(reply) {
+        if (!reply)
+            return "Mouse firmware unavailable";
+        const major = reply[7] ?? 0;
+        const minor = reply[6] ?? 0;
+        return `Mouse v${major.toString(16).padStart(2, "0")}.${minor.toString(16).padStart(2, "0")}`;
+    }
+    describe(command) {
+        return `command 0x${command.map((byte) => byte.toString(16).padStart(2, "0")).join(" ")}`;
+    }
+    describeError(error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+}
+//# sourceMappingURL=pulsar-xs1-hid.js.map

package/dist/drivers/pulsar/pulsar-xs1-hid.js.map

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

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

@@ -0,0 +1,29 @@
+import type { MouseStatus } from "../mouse-types.ts";
+export declare class RawmHidClient {
+    readonly device: HIDDevice;
+    private stream;
+    private pending;
+    private readonly onInputReport;
+    constructor(device: HIDDevice);
+    getDpiOptions(): number[];
+    static isSupported(device: HIDDevice): boolean;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    readStatus(): Promise<MouseStatus>;
+    setDpi(dpi: number, dpiY?: number): Promise<number>;
+    setPollingRate(pollingRateHz: number): Promise<number>;
+    setLiftOffDistance(value: NonNullable<MouseStatus["liftOffDistance"]>): Promise<NonNullable<MouseStatus["liftOffDistance"]>>;
+    setMotionSync(enabled: boolean): Promise<boolean>;
+    setAngleSnapping(enabled: boolean): Promise<boolean>;
+    setRippleControl(enabled: boolean): Promise<boolean>;
+    setPerformanceMode(enabled: boolean): Promise<boolean>;
+    setAngleTuning(degrees: number): Promise<number>;
+    setDebounceTime(milliseconds: number): Promise<number>;
+    setSleepTimeout(seconds: number): Promise<number>;
+    private setBoolean;
+    private updateParams;
+    private sendCommand;
+    private query;
+    private fail;
+}
+//# sourceMappingURL=hid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/rawm/hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAiBrD,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,OAAO,CAAoI;IAEnJ,OAAO,CAAC,QAAQ,CAAC,aAAa,CAkB5B;gBAEU,MAAM,EAAE,SAAS;IAE7B,aAAa,IAAI,MAAM,EAAE;IAMzB,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IASxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAiClC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUhD,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOtD,kBAAkB,CAAC,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAQ5H,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjD,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACpD,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEpD,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAOtD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQhD,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAStD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YASzC,UAAU;YAMV,YAAY;YAQZ,WAAW;YAUX,KAAK;IAkBnB,OAAO,CAAC,IAAI;CAMb"}

package/dist/drivers/rawm/hid.js

@@ -0,0 +1,210 @@
+import { RAWM_DEVICES, RAWM_PRODUCT_IDS, RAWM_REPORT_ID, RAWM_USAGE, RAWM_USAGE_PAGE, RAWM_VENDOR_ID, buildRawmMouseParams, buildRawmQuery, buildRawmSleepCommand, frameRawmEvent, frameRawmEvents, parseRawmQueryResult, rawmEventPayload, } from "@openmouse/protocol/rawm";
+const QUERY_TIMEOUT_MS = 1_500;
+const WRITE_CHUNK_DELAY_MS = 25;
+const WRITE_SETTLE_MS = 100;
+const delay = (milliseconds) => new Promise((resolve) => { setTimeout(resolve, milliseconds); });
+const signedByte = (value) => {
+    const byte = value & 0xff;
+    return byte >= 0x80 ? byte - 0x100 : byte;
+};
+export class RawmHidClient {
+    device;
+    stream = new Uint8Array();
+    pending = null;
+    onInputReport = (event) => {
+        if (event.reportId !== RAWM_REPORT_ID)
+            return;
+        const bytes = new Uint8Array(event.data.buffer, event.data.byteOffset, event.data.byteLength);
+        const payload = rawmEventPayload(bytes, RAWM_DEVICES.get(this.device.productId)?.receiver ? 0 : undefined);
+        if (!payload)
+            return;
+        const combined = new Uint8Array(this.stream.length + payload.length);
+        combined.set(this.stream);
+        combined.set(payload, this.stream.length);
+        this.stream = combined;
+        try {
+            const identity = parseRawmQueryResult(this.stream);
+            if (!identity || !this.pending)
+                return;
+            clearTimeout(this.pending.timer);
+            const { resolve } = this.pending;
+            this.pending = null;
+            this.stream = new Uint8Array();
+            resolve(identity);
+        }
+        catch { /* A JSON result can span several input reports. */ }
+    };
+    constructor(device) { this.device = device; }
+    getDpiOptions() {
+        const values = [];
+        for (let dpi = 50; dpi <= 42_000; dpi += 50)
+            values.push(dpi);
+        return values;
+    }
+    static isSupported(device) {
+        if (device.vendorId !== RAWM_VENDOR_ID || !RAWM_PRODUCT_IDS.has(device.productId))
+            return false;
+        return device.collections.some((collection) => collection.usagePage === RAWM_USAGE_PAGE
+            && collection.usage === RAWM_USAGE
+            && collection.inputReports.some((report) => report.reportId === RAWM_REPORT_ID)
+            && collection.outputReports.some((report) => report.reportId === RAWM_REPORT_ID));
+    }
+    async open() {
+        if (!this.device.opened)
+            await this.device.open();
+        this.device.removeEventListener("inputreport", this.onInputReport);
+        this.device.addEventListener("inputreport", this.onInputReport);
+    }
+    async close() {
+        this.device.removeEventListener("inputreport", this.onInputReport);
+        this.fail(new Error("The RAWM device was closed."));
+        if (this.device.opened)
+            await this.device.close();
+    }
+    async readStatus() {
+        const identity = await this.query();
+        const definition = RAWM_DEVICES.get(this.device.productId);
+        const wireless = definition.receiver || identity.wired === false;
+        const packedDpi = identity.dpi ?? 0;
+        const dpi = (packedDpi & 0xffff) || (identity.dpiLevels?.find((value) => value > 0) ?? 0);
+        return {
+            brand: "RAWM",
+            name: identity.deviceName || definition.name,
+            ui: { family: "rawm", defaultDisplayName: definition.name, settingsReady: definition.verified === true, valuesVerified: definition.verified === true, hideUnsupportedPollingRates: true, showAdvancedSection: true },
+            batteryPercent: identity.battery ?? null,
+            batteryState: identity.charging ? "Charging" : wireless ? "Discharging" : "Unknown",
+            dpi,
+            dpiY: packedDpi > 0xffff ? packedDpi >>> 16 : undefined,
+            supportsSeparateDpiAxes: packedDpi > 0xffff,
+            dpiStages: identity.dpiLevels?.filter((value) => value > 0).map((value) => value & 0xffff),
+            pollingRateHz: identity.pollingRate ?? 0,
+            supportedPollingRates: [125, 250, 500, 1000, 2000, 4000, 8000],
+            activeProfile: 1,
+            connectionType: wireless ? "Wireless" : "Wired",
+            connectionDetail: definition.receiver ? "2.4 GHz receiver" : "USB",
+            motionSync: identity.motionSync ?? null,
+            angleSnapping: identity.angleSnapping ?? null,
+            rippleControl: identity.rippleControl ?? null,
+            performanceMode: identity.powerMode === undefined ? null : identity.powerMode >= 2,
+            angleTuning: identity.angleTuning === undefined ? null : signedByte(identity.angleTuning),
+            debounceMs: identity.keyDelay?.[0] ?? null,
+            sleepTimeout: identity.sleepTime ?? null,
+            liftOffDistance: identity.lod === undefined ? null : identity.lod <= 1 ? "Low" : "High",
+            firmware: [identity.revision, identity.sensor].filter((value) => Boolean(value)),
+        };
+    }
+    async setDpi(dpi, dpiY = dpi) {
+        if (!Number.isInteger(dpi) || !Number.isInteger(dpiY) || dpi < 50 || dpi > 42_000 || dpiY < 50 || dpiY > 42_000) {
+            throw new RangeError("RAWM DPI must be from 50 to 42000.");
+        }
+        const packed = dpi === dpiY ? dpi : ((dpi & 0xffff) | ((dpiY & 0xffff) << 16)) >>> 0;
+        const after = await this.updateParams((identity) => { identity.dpi = packed; });
+        if (after.dpi !== packed)
+            throw new Error("RAWM did not confirm the requested DPI.");
+        return (after.dpi ?? 0) & 0xffff;
+    }
+    async setPollingRate(pollingRateHz) {
+        if (![125, 250, 500, 1000, 2000, 4000, 8000].includes(pollingRateHz))
+            throw new RangeError("Unsupported RAWM polling rate.");
+        const after = await this.updateParams((identity) => { identity.pollingRate = pollingRateHz; });
+        if (after.pollingRate !== pollingRateHz)
+            throw new Error("RAWM did not confirm the requested polling rate.");
+        return after.pollingRate ?? pollingRateHz;
+    }
+    async setLiftOffDistance(value) {
+        if (value !== "Low" && value !== "High")
+            throw new RangeError("RAWM supports Low or High lift-off distance.");
+        const after = await this.updateParams((identity) => { identity.lod = value === "Low" ? 1 : 2; });
+        const confirmed = (after.lod ?? 1) <= 1 ? "Low" : "High";
+        if (confirmed !== value)
+            throw new Error("RAWM did not confirm the requested lift-off distance.");
+        return confirmed;
+    }
+    async setMotionSync(enabled) { return this.setBoolean("motionSync", enabled); }
+    async setAngleSnapping(enabled) { return this.setBoolean("angleSnapping", enabled); }
+    async setRippleControl(enabled) { return this.setBoolean("rippleControl", enabled); }
+    async setPerformanceMode(enabled) {
+        const after = await this.updateParams((identity) => { identity.powerMode = enabled ? 2 : 1; });
+        const confirmed = (after.powerMode ?? 0) >= 2;
+        if (confirmed !== enabled)
+            throw new Error("RAWM did not confirm the requested performance mode.");
+        return confirmed;
+    }
+    async setAngleTuning(degrees) {
+        if (!Number.isInteger(degrees) || degrees < -30 || degrees > 30)
+            throw new RangeError("RAWM angle tuning must be from -30 to 30 degrees.");
+        const after = await this.updateParams((identity) => { identity.angleTuning = degrees; });
+        const confirmed = after.angleTuning === undefined ? undefined : signedByte(after.angleTuning);
+        if (confirmed !== degrees)
+            throw new Error("RAWM did not confirm the requested angle tuning.");
+        return confirmed;
+    }
+    async setDebounceTime(milliseconds) {
+        if (!Number.isInteger(milliseconds) || milliseconds < 0 || milliseconds > 255)
+            throw new RangeError("RAWM debounce must fit in one byte.");
+        const after = await this.updateParams((identity) => {
+            identity.keyDelay = identity.keyDelay.map(() => milliseconds);
+        });
+        if (after.keyDelay?.[0] !== milliseconds)
+            throw new Error("RAWM did not confirm the requested debounce time.");
+        return after.keyDelay?.[0] ?? milliseconds;
+    }
+    async setSleepTimeout(seconds) {
+        const before = await this.query();
+        await this.sendCommand(buildRawmSleepCommand(seconds, before.crcSupported === true));
+        await delay(WRITE_SETTLE_MS);
+        const after = await this.query();
+        if (after.sleepTime !== seconds)
+            throw new Error("RAWM did not confirm the requested sleep timeout.");
+        return after.sleepTime ?? seconds;
+    }
+    async setBoolean(field, enabled) {
+        const after = await this.updateParams((identity) => { identity[field] = enabled; });
+        if (after[field] !== enabled)
+            throw new Error(`RAWM did not confirm ${field}.`);
+        return after[field];
+    }
+    async updateParams(change) {
+        const identity = await this.query();
+        change(identity);
+        await this.sendCommand(buildRawmMouseParams(identity));
+        await delay(WRITE_SETTLE_MS);
+        return this.query();
+    }
+    async sendCommand(command) {
+        await this.open();
+        const receiver = RAWM_DEVICES.get(this.device.productId).receiver;
+        const frames = frameRawmEvents(command, receiver ? 0 : undefined);
+        for (const [index, frame] of frames.entries()) {
+            await this.device.sendReport(RAWM_REPORT_ID, frame.buffer.slice(frame.byteOffset, frame.byteOffset + frame.byteLength));
+            if (index + 1 < frames.length)
+                await delay(WRITE_CHUNK_DELAY_MS);
+        }
+    }
+    async query() {
+        await this.open();
+        this.fail(new Error("A newer RAWM status query replaced the previous one."));
+        this.stream = new Uint8Array();
+        const receiver = RAWM_DEVICES.get(this.device.productId).receiver;
+        const result = new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                if (this.pending?.timer !== timer)
+                    return;
+                this.pending = null;
+                reject(new Error("RAWM did not answer the status query."));
+            }, QUERY_TIMEOUT_MS);
+            this.pending = { resolve, reject, timer };
+        });
+        const framed = frameRawmEvent(buildRawmQuery(), receiver ? 0 : undefined);
+        await this.device.sendReport(RAWM_REPORT_ID, framed.buffer.slice(framed.byteOffset, framed.byteOffset + framed.byteLength));
+        return await result;
+    }
+    fail(error) {
+        if (!this.pending)
+            return;
+        clearTimeout(this.pending.timer);
+        this.pending.reject(error);
+        this.pending = null;
+    }
+}
+//# sourceMappingURL=hid.js.map

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

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

package/dist/drivers/razer/cobra-hid.d.ts

@@ -0,0 +1,63 @@
+import type { MouseLighting, MouseStatus } from "../mouse-types.ts";
+import { type RazerCommand, type RazerExtendedEffect } from "@openmouse/protocol/razer";
+export declare const COBRA_PRODUCT_ID = 163;
+/**
+ * Transaction id this mouse answers reads on — the Chroma-era group's original
+ * one, shared with the Viper Mini and the DeathAdder Essential family.
+ */
+export declare const COBRA_TRANSACTION_ID = 255;
+export declare const COBRA_DPI_READ: RazerCommand;
+/**
+ * Lighting writes answer on the extended-matrix `0x1f` transaction id, unlike
+ * this mouse's DPI and polling reads, which use `0xff`. A mismatch is silent:
+ * the mouse never replies and the write times out.
+ *
+ * OpenRazer's `matrix_effect_breath` lists the Cobra on `0x3f`, but that sits
+ * in a block of classic-matrix mice whose other effects also use `0x3f`; this
+ * mouse's spectrum, static, reactive and none all answer on `0x1f`, so `0x1f`
+ * is kept for breathing too — a single id for a single firmware generation.
+ */
+export declare const COBRA_EFFECT_TRANSACTION_ID = 31;
+/**
+ * Razer's extended effect list is a superset of Synapse's modes; only the
+ * single-colour breathing mode maps to a different id (a colour tuple of zeroes
+ * instead of its own id).
+ */
+export declare function cobraLightingEffect(lighting: Pick<MouseLighting, "mode">): RazerExtendedEffect | null;
+export declare class RazerCobraHidClient {
+    private queue;
+    private readonly staticReads;
+    /**
+     * Razer exposes no way to read the current effect back, so the driver keeps
+     * the last value it wrote here, mirroring how Synapse's settings window
+     * starts from whatever it last applied rather than from the device.
+     */
+    private lighting;
+    readonly device: HIDDevice;
+    constructor(device: HIDDevice);
+    static isSupported(device: HIDDevice): boolean;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    displayName(): string;
+    isWireless(): boolean;
+    maxDpi(): number;
+    getSupportedPollingRates(): number[];
+    /** Every whole value, because the control validates entries against this list. */
+    getDpiOptions(): number[];
+    readStatus(): Promise<MouseStatus>;
+    setDpi(dpi: number, dpiY?: number): Promise<number>;
+    setPollingRate(pollingRateHz: number): Promise<number>;
+    /**
+     * Writes a lighting zone. The effect commands have no read back, so unlike
+     * DPI and polling there is nothing to confirm against; the value written is
+     * cached and returned as the current state.
+     */
+    setLighting(lighting: MouseLighting): Promise<MouseLighting>;
+    private lightingFromCache;
+    private once;
+    private request;
+    private exchange;
+    private copyDataView;
+    private delay;
+}
+//# sourceMappingURL=cobra-hid.d.ts.map

package/dist/drivers/razer/cobra-hid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cobra-hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/razer/cobra-hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGpE,OAAO,EAgBL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAEzB,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,gBAAgB,MAAS,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,oBAAoB,MAA0B,CAAC;AAG5D,eAAO,MAAM,cAAc,EAAE,YAK5B,CAAC;AA0BF;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,KAA0B,CAAC;AAenE;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GACpC,mBAAmB,GAAG,IAAI,CAmB5B;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;IAE7E;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAA8B;IAE9C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;gBAEf,MAAM,EAAE,SAAS;IAI7B,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAMxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,WAAW,IAAI,MAAM;IAIrB,UAAU,IAAI,OAAO;IAIrB,MAAM,IAAI,MAAM;IAIhB,wBAAwB,IAAI,MAAM,EAAE;IAIpC,kFAAkF;IAClF,aAAa,IAAI,MAAM,EAAE;IAMnB,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAwClC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAexD,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY5D;;;;OAIG;IACG,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAmBlE,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,IAAI;YASE,OAAO;YAYP,QAAQ;IAgBtB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,KAAK;CAGd"}