@openmouse/protocol 0.1.0

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

@@ -0,0 +1,74 @@
+import type { MouseStatus } from "../mouse-types.ts";
+import { type KsnakeKeyBinding } from "../../ksnake/index.js";
+/** Rejected when a command gets no inputreport within the timeout. Retried by writes. */
+export declare class KsnakeTimeoutError extends Error {
+    constructor();
+}
+export interface KsnakeClientOptions {
+    replyTimeoutMs?: number;
+    settleAfterWriteMs?: number;
+}
+/**
+ * K-snake X11 vendor HID control.
+ *
+ * Transport: output report 0 (64 bytes starting with 0x55); the reply
+ * arrives as the next `inputreport`. A tiny queue serializes concurrent
+ * calls like the vendor panel's commandQueueWrapper.
+ *
+ * Evidence: vendor panel at https://x1a11.yjx2012.com/, the X11 user manual
+ * (6 factory DPI steps, 1000 Hz in 2.4G/wired, 125 Hz in BT, PAW3311), plus
+ * retail-hardware verification — 2.4 GHz dongle (VID 0xA8A5, Vendor 0xFF01
+ * interface, PARTIAL as expected since this protocol never uses feature
+ * reports), FW 2.1.7, read/set/confirm round-trips for DPI and polling.
+ */
+export declare class KsnakeHidClient {
+    readonly device: HIDDevice;
+    private queue;
+    private readonly replyTimeoutMs;
+    private readonly settleAfterWriteMs;
+    /** Last config that passed validation (see readStatus). */
+    private lastGoodConfig;
+    constructor(device: HIDDevice, options?: KsnakeClientOptions);
+    static isSupported(device: HIDDevice): boolean;
+    get supportedPollingRates(): number[];
+    getDpiOptions(): number[];
+    open(): Promise<void>;
+    close(): Promise<void>;
+    private run;
+    private exchange;
+    /** Same as exchange, but resends on timeout (a sleeping dongle often drops the first). Non-timeout errors throw immediately. SETs are idempotent full-config writes, so resending is safe. */
+    private exchangeRetrying;
+    /** Best-effort config read for post-write confirmation; null when the mouse stays silent. */
+    private readBackConfig;
+    /**
+     * Reads with one retry when the reply fails validation. The dongle can emit
+     * unsolicited reports that a queued exchange mistakes for its answer, so a
+     * single failed decode is worth one resend before giving up.
+     */
+    private readValidated;
+    readStatus(): Promise<MouseStatus>;
+    setDpi(dpi: number): Promise<number>;
+    setActiveDpiStage(stage: number): Promise<number>;
+    setDpiStageValue(stage: number, dpi: number): Promise<number>;
+    /** Read-only dump of the 7 button slots (GET_KEYS, reply[8..35]). */
+    getKeys(): Promise<KsnakeKeyBinding[] | null>;
+    /**
+     * Remap slots 0-5 (SET_KEYS). Only catalog types (mouse/special/media) are
+     * accepted — macro references and other opaque bindings are rejected rather
+     * than risk bricking them. Confirms by reading the map back.
+     */
+    setKeys(keys: readonly KsnakeKeyBinding[]): Promise<KsnakeKeyBinding[]>;
+    /** Best-effort key-map read for post-write confirmation. */
+    private readBackKeys;
+    /**
+     * Remap one button by display label (generic `setButtonMapping` interface).
+     * SET_KEYS always carries all six remappable slots, so the current map is
+     * re-read and the single slot replaced — confirmed by setKeys' read-back.
+     * Slot "Left" is locked (the vendor panel refuses drops there too); opaque
+     * slots elsewhere abort the write rather than risk bricking macros.
+     */
+    setButtonMapping(button: string, actionLabel: string): Promise<void>;
+    setLiftOffDistance(value: NonNullable<MouseStatus["liftOffDistance"]>): Promise<NonNullable<MouseStatus["liftOffDistance"]>>;
+    setPollingRate(rate: number): Promise<number>;
+}
+//# sourceMappingURL=hid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/ksnake/hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EA6BL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAO/B,yFAAyF;AACzF,qBAAa,kBAAmB,SAAQ,KAAK;;CAK5C;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,2DAA2D;IAC3D,OAAO,CAAC,cAAc,CAA6B;gBAEvC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,mBAAwB;IAMhE,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAU9C,IAAI,qBAAqB,IAAI,MAAM,EAAE,CAEpC;IAED,aAAa,IAAI,MAAM,EAAE;IAOnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAId,GAAG;YAMH,QAAQ;IAwBtB,8LAA8L;YAChL,gBAAgB;IAa9B,6FAA6F;YAC/E,cAAc;IAS5B;;;;OAIG;YACW,aAAa;IAWrB,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAwElC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBpC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBjD,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBnE,qEAAqE;IAC/D,OAAO,IAAI,OAAO,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAcnD;;;;OAIG;IACG,OAAO,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAsB7E,4DAA4D;YAC9C,YAAY;IAS1B;;;;;;OAMG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAapE,kBAAkB,CACtB,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,GACjD,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAcjD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAapD"}

package/dist/drivers/ksnake/hid.js

@@ -0,0 +1,368 @@
+import { KSNAKE_BUTTON_ACTIONS, KSNAKE_BUTTON_NAMES, KSNAKE_PRODUCT_ID, KSNAKE_POLLING_RATES, KSNAKE_REPORT_ID, KSNAKE_USAGE, KSNAKE_USAGE_PAGE, KSNAKE_USB_VENDOR_ID, ksnakeDecodeBattery, ksnakeDecodeConfig, ksnakeDecodeKeys, ksnakeDecodeLiftOff, ksnakeDecodePollingRate, ksnakeDecodeVersion, ksnakeEncodeLiftOff, ksnakeEncodePollingRate, ksnakeEncodeSetConfig, ksnakeEncodeSetKeys, ksnakeGetBatteryRequest, ksnakeGetConfigRequest, ksnakeGetKeysRequest, ksnakeGetVersionRequest, ksnakeBindingLabel, ksnakeFindButtonAction, ksnakeIsKnownKeyType, ksnakeIsValidDpi, ksnakeKeysLookPlausible, } from "../../ksnake/index.js";
+import { VENDOR_ID } from "../vendors.js";
+const REPLY_TIMEOUT_MS = 800;
+/** Pause after a SET before reading back, so the mouse can commit to flash. */
+const SETTLE_AFTER_WRITE_MS = 250;
+/** Rejected when a command gets no inputreport within the timeout. Retried by writes. */
+export class KsnakeTimeoutError extends Error {
+    constructor() {
+        super("The mouse did not answer — it may be asleep or out of range.");
+        this.name = "KsnakeTimeoutError";
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * K-snake X11 vendor HID control.
+ *
+ * Transport: output report 0 (64 bytes starting with 0x55); the reply
+ * arrives as the next `inputreport`. A tiny queue serializes concurrent
+ * calls like the vendor panel's commandQueueWrapper.
+ *
+ * Evidence: vendor panel at https://x1a11.yjx2012.com/, the X11 user manual
+ * (6 factory DPI steps, 1000 Hz in 2.4G/wired, 125 Hz in BT, PAW3311), plus
+ * retail-hardware verification — 2.4 GHz dongle (VID 0xA8A5, Vendor 0xFF01
+ * interface, PARTIAL as expected since this protocol never uses feature
+ * reports), FW 2.1.7, read/set/confirm round-trips for DPI and polling.
+ */
+export class KsnakeHidClient {
+    device;
+    queue = Promise.resolve();
+    replyTimeoutMs;
+    settleAfterWriteMs;
+    /** Last config that passed validation (see readStatus). */
+    lastGoodConfig = null;
+    constructor(device, options = {}) {
+        this.device = device;
+        this.replyTimeoutMs = options.replyTimeoutMs ?? REPLY_TIMEOUT_MS;
+        this.settleAfterWriteMs = options.settleAfterWriteMs ?? SETTLE_AFTER_WRITE_MS;
+    }
+    static isSupported(device) {
+        if (device.productId !== KSNAKE_PRODUCT_ID)
+            return false;
+        if (device.vendorId !== VENDOR_ID.ksnakeUsb && device.vendorId !== VENDOR_ID.ksnakeDongle)
+            return false;
+        const search = (list) => list.some((c) => (c.usagePage === KSNAKE_USAGE_PAGE && c.usage === KSNAKE_USAGE) || search(c.children));
+        return search(device.collections);
+    }
+    get supportedPollingRates() {
+        return [...KSNAKE_POLLING_RATES];
+    }
+    getDpiOptions() {
+        // PAW3311, vendor slider 200–12000. Defaults: 800/1200/1600/3200/5000/12000.
+        const options = [];
+        for (let dpi = 200; dpi <= 12000; dpi += 100)
+            options.push(dpi);
+        return options;
+    }
+    async open() {
+        if (!this.device.opened)
+            await this.device.open();
+    }
+    async close() {
+        if (this.device.opened)
+            await this.device.close();
+    }
+    async run(task) {
+        const started = this.queue.then(task, task);
+        this.queue = started.catch(() => undefined);
+        return started;
+    }
+    async exchange(body) {
+        const timeoutMs = this.replyTimeoutMs;
+        return this.run(async () => {
+            await this.open();
+            return new Promise((resolve, reject) => {
+                const timer = setTimeout(() => {
+                    this.device.removeEventListener("inputreport", listener);
+                    reject(new KsnakeTimeoutError());
+                }, timeoutMs);
+                const listener = (event) => {
+                    clearTimeout(timer);
+                    this.device.removeEventListener("inputreport", listener);
+                    resolve(copyDataView(event.data));
+                };
+                this.device.addEventListener("inputreport", listener);
+                this.device.sendReport(KSNAKE_REPORT_ID, new Uint8Array(body.slice(0, 64)).buffer).catch((error) => {
+                    clearTimeout(timer);
+                    this.device.removeEventListener("inputreport", listener);
+                    reject(error);
+                });
+            });
+        });
+    }
+    /** Same as exchange, but resends on timeout (a sleeping dongle often drops the first). Non-timeout errors throw immediately. SETs are idempotent full-config writes, so resending is safe. */
+    async exchangeRetrying(body, attempts) {
+        let lastError = null;
+        for (let attempt = 0; attempt < attempts; attempt++) {
+            try {
+                return await this.exchange(body);
+            }
+            catch (error) {
+                if (!(error instanceof KsnakeTimeoutError))
+                    throw error;
+                lastError = error;
+            }
+        }
+        throw lastError;
+    }
+    /** Best-effort config read for post-write confirmation; null when the mouse stays silent. */
+    async readBackConfig(attempts) {
+        for (let attempt = 0; attempt < attempts; attempt++) {
+            const reply = await this.exchange(ksnakeGetConfigRequest()).catch(() => null);
+            const config = reply ? ksnakeDecodeConfig(reply) : null;
+            if (config)
+                return config;
+        }
+        return null;
+    }
+    /**
+     * Reads with one retry when the reply fails validation. The dongle can emit
+     * unsolicited reports that a queued exchange mistakes for its answer, so a
+     * single failed decode is worth one resend before giving up.
+     */
+    async readValidated(read, valid) {
+        for (let attempt = 0; attempt < 2; attempt++) {
+            const value = await read().catch(() => null);
+            if (value !== null && valid(value))
+                return value;
+        }
+        return null;
+    }
+    async readStatus() {
+        await this.open();
+        const [freshConfig, battery, version] = await Promise.all([
+            this.readValidated(() => this.exchange(ksnakeGetConfigRequest()).then((r) => ksnakeDecodeConfig(r)), (c) => ksnakeDecodePollingRate(c.reportRate) !== null && c.dpiIndex >= 0 && c.dpiIndex < c.stages.length),
+            this.readValidated(() => this.exchange(ksnakeGetBatteryRequest()).then((r) => ksnakeDecodeBattery(r)), (b) => b.percent <= 100),
+            this.readValidated(() => this.exchange(ksnakeGetVersionRequest()).then((r) => ksnakeDecodeVersion(r)), (v) => v.length > 0),
+        ]);
+        // Sequential on purpose: parallel reads on this dongle collide into
+        // crossed reports, and keys are the least critical of the four.
+        const keys = await this.getKeys().catch(() => null);
+        // Last-good cache: a failed poll read must not blank the stages/DPI in
+        // the UI until the next poll (the panel re-renders on every change).
+        if (freshConfig)
+            this.lastGoodConfig = freshConfig;
+        const config = freshConfig ?? this.lastGoodConfig;
+        const stages = config?.stages ?? [];
+        const activeStage = config ? Math.min(Math.max(config.dpiIndex, 0), Math.max(stages.length - 1, 0)) : 0;
+        const dpi = stages[activeStage] ?? 1600;
+        const pollingRateHz = config ? (ksnakeDecodePollingRate(config.reportRate) ?? 1000) : 1000;
+        return {
+            brand: "K-snake",
+            name: this.device.productName || "K-snake X11",
+            ui: {
+                family: "ksnake",
+                settingsReady: config !== null,
+                hideUnsupportedPollingRates: true,
+                hideProcessingCard: true,
+                defaultDisplayName: this.device.productName || "K-snake X11",
+                dpiStageEditor: {
+                    maxStages: 6,
+                    countEditable: false,
+                    minDpi: 200,
+                    maxDpi: 12000,
+                    stepDpi: 100,
+                },
+            },
+            batteryPercent: battery ? Math.min(battery.percent, 100) : null,
+            batteryState: battery ? (battery.charging !== 0 ? "Charging" : "Discharging") : "Unknown",
+            dpi,
+            dpiStages: stages.length ? stages : undefined,
+            activeDpiStage: stages.length ? activeStage : undefined,
+            pollingRateHz,
+            supportedPollingRates: this.supportedPollingRates,
+            activeProfile: null,
+            connectionType: this.device.vendorId === KSNAKE_USB_VENDOR_ID ? "Wired" : "Wireless",
+            connectionDetail: this.device.vendorId === KSNAKE_USB_VENDOR_ID ? "Wired USB" : "2.4 GHz receiver",
+            liftOffDistance: config ? ksnakeDecodeLiftOff(config.lodValue) : null,
+            supportedLiftOffDistances: ["Low", "High"],
+            // Generic remap interface: the shared ButtonMappingCard renders these
+            // with no brand-specific code. Opaque slots surface as "Custom (…)" and
+            // stay selectable-visible; setButtonMapping refuses to rewrite them.
+            buttonMappings: keys
+                ? Object.fromEntries(keys.slice(0, KSNAKE_BUTTON_NAMES.length).map((binding, index) => [
+                    KSNAKE_BUTTON_NAMES[index],
+                    ksnakeBindingLabel(binding) ?? `Custom (${binding.type},${binding.code1},${binding.code2},${binding.code3})`,
+                ]))
+                : undefined,
+            buttonOptions: KSNAKE_BUTTON_ACTIONS.map((action) => action.label),
+            firmware: version ? [`X11 ${version}`] : ["K-snake X11"],
+        };
+    }
+    async setDpi(dpi) {
+        if (!ksnakeIsValidDpi(dpi)) {
+            throw new Error(`DPI must be a whole number between 200 and 12000 for the K-snake X11 (got ${dpi}).`);
+        }
+        const raw = await this.exchangeRetrying(ksnakeGetConfigRequest(), 3).catch(() => null);
+        const config = raw ? ksnakeDecodeConfig(raw) : null;
+        if (!config)
+            throw new Error("Could not read the current config from the mouse.");
+        const stages = [...config.stages];
+        const index = Math.min(Math.max(config.dpiIndex, 0), stages.length - 1);
+        stages[index] = dpi;
+        await this.exchangeRetrying(ksnakeEncodeSetConfig({ ...config, stages }), 2);
+        await sleep(this.settleAfterWriteMs);
+        const confirmed = await this.readBackConfig(3);
+        const got = confirmed?.stages[Math.min(Math.max(confirmed.dpiIndex, 0), confirmed.stages.length - 1)];
+        if (got !== dpi)
+            throw new Error(`The mouse kept ${got ?? "?"} DPI instead of ${dpi}.`);
+        return dpi;
+    }
+    async setActiveDpiStage(stage) {
+        const raw = await this.exchangeRetrying(ksnakeGetConfigRequest(), 3).catch(() => null);
+        const config = raw ? ksnakeDecodeConfig(raw) : null;
+        if (!config)
+            throw new Error("Could not read the current config from the mouse.");
+        if (!Number.isInteger(stage) || stage < 0 || stage >= config.stages.length) {
+            throw new Error(`DPI stage must be between 1 and ${config.stages.length}.`);
+        }
+        await this.exchangeRetrying(ksnakeEncodeSetConfig({ ...config, dpiIndex: stage }), 2);
+        await sleep(this.settleAfterWriteMs);
+        const confirmed = await this.readBackConfig(3);
+        if (confirmed?.dpiIndex !== stage) {
+            throw new Error(`The mouse kept DPI stage ${(confirmed?.dpiIndex ?? 0) + 1} instead of ${stage + 1}.`);
+        }
+        return stage;
+    }
+    async setDpiStageValue(stage, dpi) {
+        if (!ksnakeIsValidDpi(dpi)) {
+            throw new Error(`DPI must be a whole number between 200 and 12000 for the K-snake X11 (got ${dpi}).`);
+        }
+        const raw = await this.exchangeRetrying(ksnakeGetConfigRequest(), 3).catch(() => null);
+        const config = raw ? ksnakeDecodeConfig(raw) : null;
+        if (!config)
+            throw new Error("Could not read the current config from the mouse.");
+        if (!Number.isInteger(stage) || stage < 0 || stage >= config.stages.length) {
+            throw new Error(`DPI stage must be between 1 and ${config.stages.length}.`);
+        }
+        const stages = [...config.stages];
+        stages[stage] = dpi;
+        await this.exchangeRetrying(ksnakeEncodeSetConfig({ ...config, stages }), 2);
+        await sleep(this.settleAfterWriteMs);
+        const confirmed = await this.readBackConfig(3);
+        if (confirmed?.stages[stage] !== dpi) {
+            throw new Error(`The mouse kept ${confirmed?.stages[stage] ?? "?"} DPI instead of ${dpi}.`);
+        }
+        return dpi;
+    }
+    /** Read-only dump of the 7 button slots (GET_KEYS, reply[8..35]). */
+    async getKeys() {
+        // Consensus, not first-plausible: a crossed report from another command
+        // can decode to plausible-but-wrong slots, and two strays never agree.
+        const seen = [];
+        for (let attempt = 0; attempt < 5; attempt++) {
+            const reply = await this.exchange(ksnakeGetKeysRequest()).catch(() => null);
+            const keys = reply ? ksnakeDecodeKeys(reply) : null;
+            if (!keys || !ksnakeKeysLookPlausible(keys))
+                continue;
+            if (seen.some((prev) => equalKeyMaps(prev, keys)))
+                return keys;
+            seen.push(keys);
+        }
+        return null;
+    }
+    /**
+     * Remap slots 0-5 (SET_KEYS). Only catalog types (mouse/special/media) are
+     * accepted — macro references and other opaque bindings are rejected rather
+     * than risk bricking them. Confirms by reading the map back.
+     */
+    async setKeys(keys) {
+        const slots = [...keys].slice(0, 6);
+        if (slots.length !== 6)
+            throw new Error(`Exactly 6 button bindings are required (got ${keys.length}).`);
+        for (const [index, key] of slots.entries()) {
+            const bytes = [key.type, key.code1, key.code2, key.code3];
+            if (!bytes.every((b) => Number.isInteger(b) && b >= 0 && b <= 255)) {
+                throw new Error(`Button ${index + 1}: binding bytes must be 0-255.`);
+            }
+            if (!ksnakeIsKnownKeyType(key.type)) {
+                throw new Error(`Button ${index + 1}: type ${key.type} is not remappable (macro/custom bindings are preserved, not rewritten).`);
+            }
+        }
+        await this.exchangeRetrying(ksnakeEncodeSetKeys(slots), 2);
+        await sleep(this.settleAfterWriteMs);
+        const confirmed = await this.readBackKeys(3);
+        if (!confirmed || !slots.every((key, index) => equalBinding(confirmed[index], key))) {
+            const seen = confirmed ? JSON.stringify(confirmed) : "no readable reply";
+            throw new Error(`The mouse did not keep the new button map (read back ${seen}).`);
+        }
+        return slots;
+    }
+    /** Best-effort key-map read for post-write confirmation. */
+    async readBackKeys(attempts) {
+        for (let attempt = 0; attempt < attempts; attempt++) {
+            const reply = await this.exchange(ksnakeGetKeysRequest()).catch(() => null);
+            const keys = reply ? ksnakeDecodeKeys(reply) : null;
+            if (keys && ksnakeKeysLookPlausible(keys))
+                return keys;
+        }
+        return null;
+    }
+    /**
+     * Remap one button by display label (generic `setButtonMapping` interface).
+     * SET_KEYS always carries all six remappable slots, so the current map is
+     * re-read and the single slot replaced — confirmed by setKeys' read-back.
+     * Slot "Left" is locked (the vendor panel refuses drops there too); opaque
+     * slots elsewhere abort the write rather than risk bricking macros.
+     */
+    async setButtonMapping(button, actionLabel) {
+        const index = KSNAKE_BUTTON_NAMES.indexOf(button);
+        if (index < 0)
+            throw new Error(`This mouse has no "${button}" button.`);
+        if (index === 0)
+            throw new Error("Left Click is fixed and cannot be reassigned.");
+        const binding = ksnakeFindButtonAction(actionLabel);
+        if (!binding)
+            throw new Error(`Unknown button action "${actionLabel}".`);
+        const current = await this.getKeys();
+        if (!current)
+            throw new Error("Could not read the current button map from the mouse.");
+        const slots = current.slice(0, KSNAKE_BUTTON_NAMES.length).map((slot) => ({ ...slot }));
+        slots[index] = binding;
+        await this.setKeys(slots);
+    }
+    async setLiftOffDistance(value) {
+        const encoded = ksnakeEncodeLiftOff(value);
+        if (encoded === null)
+            throw new Error(`This mouse does not support a ${value.toLowerCase()} lift-off distance.`);
+        const raw = await this.exchangeRetrying(ksnakeGetConfigRequest(), 3).catch(() => null);
+        const config = raw ? ksnakeDecodeConfig(raw) : null;
+        if (!config)
+            throw new Error("Could not read the current config from the mouse.");
+        await this.exchangeRetrying(ksnakeEncodeSetConfig({ ...config, lodValue: encoded }), 2);
+        await sleep(this.settleAfterWriteMs);
+        const confirmed = await this.readBackConfig(3);
+        const back = confirmed ? ksnakeDecodeLiftOff(confirmed.lodValue) : null;
+        if (back !== value)
+            throw new Error(`The mouse kept a ${String(back).toLowerCase()} lift-off distance instead of ${value.toLowerCase()}.`);
+        return value;
+    }
+    async setPollingRate(rate) {
+        const index = ksnakeEncodePollingRate(rate);
+        if (index === null)
+            throw new Error(`This mouse does not support ${rate} Hz.`);
+        const raw = await this.exchangeRetrying(ksnakeGetConfigRequest(), 3).catch(() => null);
+        const config = raw ? ksnakeDecodeConfig(raw) : null;
+        if (!config)
+            throw new Error("Could not read the current config from the mouse.");
+        await this.exchangeRetrying(ksnakeEncodeSetConfig({ ...config, reportRate: index }), 2);
+        await sleep(this.settleAfterWriteMs);
+        const confirmed = await this.readBackConfig(3);
+        const back = confirmed ? ksnakeDecodePollingRate(confirmed.reportRate) : null;
+        if (back !== rate)
+            throw new Error(`The mouse kept ${back ?? "?"} Hz instead of ${rate} Hz.`);
+        return rate;
+    }
+}
+function copyDataView(view) {
+    return new Uint8Array(view.buffer.slice(view.byteOffset, view.byteOffset + view.byteLength));
+}
+function equalBinding(a, b) {
+    return a !== undefined && a.type === b.type && a.code1 === b.code1 && a.code2 === b.code2 && a.code3 === b.code3;
+}
+function equalKeyMaps(a, b) {
+    return a.length === b.length && a.every((key, index) => equalBinding(key, b[index]));
+}
+//# sourceMappingURL=hid.js.map

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

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

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

@@ -0,0 +1,58 @@
+import type { MouseStatus } from "../mouse-types.ts";
+import { type CompaxDpiStage } from "@openmouse/protocol/lamzu";
+type LiftOffDistance = NonNullable<MouseStatus["liftOffDistance"]>;
+export type LamzuDpiStage = CompaxDpiStage;
+export declare class LamzuHidClient {
+    readonly canDisableSleep = false;
+    private queue;
+    private readonly staticReads;
+    private lastStatus;
+    private notifier;
+    private notifyListener;
+    private activeProfile;
+    readonly device: HIDDevice;
+    constructor(device: HIDDevice);
+    static isSupported(device: HIDDevice): boolean;
+    private profile;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    startNotifications(onChange: () => void): Promise<boolean>;
+    private once;
+    displayName(): string;
+    deviceBrand(): MouseStatus["brand"];
+    maxDpi(): number;
+    getSleepOptions(): readonly number[];
+    getDebounceMaxMs(): number;
+    getSupportedPollingRates(): number[];
+    getDpiOptions(): number[];
+    isWireless(): boolean;
+    readStatus(live?: boolean): Promise<MouseStatus>;
+    private readLiveStatus;
+    setPollingRate(pollingRateHz: number): Promise<number>;
+    setLiftOffDistance(value: LiftOffDistance): Promise<LiftOffDistance>;
+    setAngleSnapping(enabled: boolean): Promise<boolean>;
+    setMotionSync(enabled: boolean): Promise<boolean>;
+    setPerformanceMode(enabled: boolean): Promise<boolean>;
+    setHyperMode(enabled: boolean): Promise<boolean>;
+    setRippleControl(enabled: boolean): Promise<boolean>;
+    private setFlag;
+    setDebounceTime(milliseconds: number): Promise<number>;
+    setSleepTimeout(seconds: number): Promise<number>;
+    setDpi(dpi: number, dpiY?: number): Promise<number>;
+    private currentProfile;
+    private write;
+    private patch;
+    private stageIndex;
+    private request;
+    private exchange;
+    private describe;
+    private decodeDpiStages;
+    private decodePollingRate;
+    private decodeLiftOffDistance;
+    private decodeSleepTimeout;
+    private decodeFirmware;
+    private copyDataView;
+    private delay;
+}
+export {};
+//# sourceMappingURL=hid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/lamzu/hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAcL,KAAK,cAAc,EAEpB,MAAM,2BAA2B,CAAC;AA2BnC,KAAK,eAAe,GAAG,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAgEnE,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC;AAE3C,qBAAa,cAAc;IACzB,QAAQ,CAAC,eAAe,SAAS;IAEjC,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;IAC7E,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,cAAc,CAAuD;IAC7E,OAAO,CAAC,aAAa,CAAK;IAE1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;gBAEf,MAAM,EAAE,SAAS;IAI7B,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAS9C,OAAO,CAAC,OAAO;IAIT,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IA0BhE,OAAO,CAAC,IAAI;IASZ,WAAW,IAAI,MAAM;IAKrB,WAAW,IAAI,WAAW,CAAC,OAAO,CAAC;IAInC,MAAM,IAAI,MAAM;IAIhB,eAAe,IAAI,SAAS,MAAM,EAAE;IAIpC,gBAAgB,IAAI,MAAM;IAI1B,wBAAwB,IAAI,MAAM,EAAE;IAMpC,aAAa,IAAI,MAAM,EAAE;IAMzB,UAAU,IAAI,OAAO;IAMf,UAAU,CAAC,IAAI,UAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;YA6DtC,cAAc;IAWtB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAetD,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAapE,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjD,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhD,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YAI5C,OAAO;IAiBf,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IActD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAejD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,CAAC;YAwBhD,cAAc;YAMd,KAAK;IAKnB,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,UAAU;YAIJ,OAAO;YAMP,QAAQ;IAwBtB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,KAAK;CAGd"}