@openmouse/protocol 0.1.0

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

@@ -0,0 +1,33 @@
+import type { MouseStatus } from "../mouse-types.ts";
+export declare class VgnF2HidClient {
+    readonly device: HIDDevice;
+    private waiter;
+    private readonly onInputReport;
+    constructor(device: HIDDevice);
+    static isSupported(device: HIDDevice): boolean;
+    get pollIntervalMs(): number;
+    isWirelessPath(): boolean;
+    getDpiOptions(): number[];
+    open(): Promise<void>;
+    readStatus(): Promise<MouseStatus>;
+    setDpi(dpi: number): Promise<number>;
+    setPollingRate(rate: 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>;
+    setDebounceTime(value: number): Promise<number>;
+    setSleepTimeout(value: number): Promise<number>;
+    close(): Promise<void>;
+    private setBoolean;
+    private readProfile;
+    private read;
+    private writeScalar;
+    private write;
+    private transact;
+    private version;
+    private failWaiter;
+    private static reportLength;
+}
+//# sourceMappingURL=hid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/vgn/hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAuBrD,qBAAa,cAAc;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,OAAO,CAAC,MAAM,CAKE;IAEhB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAU5B;gBAEU,MAAM,EAAE,SAAS;IAI7B,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAS9C,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,cAAc,IAAI,OAAO;IAIzB,aAAa,IAAI,MAAM,EAAE;IAMnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IA0ClC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASpC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO7C,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;IACpD,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEtD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM/C,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAMd,UAAU;YAKV,WAAW;YAYX,IAAI;YAOJ,WAAW;YAWX,KAAK;YAOL,QAAQ;IAmBtB,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,MAAM,CAAC,YAAY;CAG5B"}

package/dist/drivers/vgn/hid.js

@@ -0,0 +1,213 @@
+import { VGN_ADDRESS, VGN_COMMAND, VGN_REPORT_ID, vgnBuildReadPayload, vgnBuildSimplePayload, vgnBuildWritePayload, vgnBuildWriteScalarPayload, vgnDecodeProfile, vgnEncodeDpi, vgnEncodePollingRate, vgnParseBattery, vgnParseReadResponse, vgnReportChecksumIsValid, } from "@openmouse/protocol/vgn";
+const VGN_VENDOR_ID = 0x3554;
+const VGN_RECEIVER_PID = 0xfb56;
+const VGN_WIRED_PID = 0xfb57;
+const RESPONSE_TIMEOUT_MS = 700;
+const SUPPORTED_POLLING_RATES = [125, 250, 500, 1000, 2000, 4000, 8000];
+export class VgnF2HidClient {
+    device;
+    waiter = null;
+    onInputReport = (event) => {
+        if (event.reportId !== VGN_REPORT_ID)
+            return;
+        const response = new Uint8Array(event.data.buffer.slice(event.data.byteOffset, event.data.byteOffset + event.data.byteLength));
+        const waiter = this.waiter;
+        if (!waiter || response[0] !== waiter.command)
+            return;
+        window.clearTimeout(waiter.timer);
+        this.waiter = null;
+        waiter.resolve(response);
+    };
+    constructor(device) {
+        this.device = device;
+    }
+    static isSupported(device) {
+        if (device.vendorId !== VGN_VENDOR_ID)
+            return false;
+        if (device.productId !== VGN_RECEIVER_PID && device.productId !== VGN_WIRED_PID)
+            return false;
+        return device.collections.some((collection) => collection.usagePage === 0xff02
+            && collection.inputReports.some((report) => report.reportId === VGN_REPORT_ID && this.reportLength(report) === 16)
+            && collection.outputReports.some((report) => report.reportId === VGN_REPORT_ID && this.reportLength(report) === 16));
+    }
+    get pollIntervalMs() {
+        return this.isWirelessPath() ? 10_000 : 30_000;
+    }
+    isWirelessPath() {
+        return this.device.productId === VGN_RECEIVER_PID;
+    }
+    getDpiOptions() {
+        const values = [];
+        for (let dpi = 50; dpi <= 26_000; dpi += 50)
+            values.push(dpi);
+        return values;
+    }
+    async open() {
+        if (!this.device.opened)
+            await this.device.open();
+        this.device.removeEventListener("inputreport", this.onInputReport);
+        this.device.addEventListener("inputreport", this.onInputReport);
+    }
+    async readStatus() {
+        await this.open();
+        const batteryResponse = await this.transact(vgnBuildSimplePayload(VGN_COMMAND.battery));
+        const firmwareResponse = await this.transact(vgnBuildSimplePayload(VGN_COMMAND.firmware));
+        const profile = await this.readProfile();
+        const battery = vgnParseBattery(batteryResponse);
+        const settings = vgnDecodeProfile(profile);
+        const firmware = this.version(firmwareResponse);
+        const wireless = this.isWirelessPath();
+        return {
+            brand: "VGN",
+            name: "VGN Dragonfly F2 Master+",
+            batteryPercent: battery?.percent ?? null,
+            batteryVoltageMv: battery?.voltageMv ?? null,
+            batteryState: battery
+                ? battery.charging ? (battery.percent >= 99 ? "Full" : "Charging") : "Discharging"
+                : "Unknown",
+            dpi: settings.dpi,
+            pollingRateHz: settings.pollingRateHz,
+            supportedPollingRates: SUPPORTED_POLLING_RATES,
+            activeProfile: null,
+            connectionType: wireless ? "Wireless" : "Wired",
+            connectionDetail: wireless ? "2.4 GHz receiver · 8K protocol" : "USB · 8K protocol",
+            motionSync: settings.motionSync,
+            debounceMs: settings.debounceMs,
+            sleepTimeout: settings.sleepTimeout === null ? null : settings.sleepTimeout / 10,
+            angleSnapping: settings.angleSnapping,
+            rippleControl: settings.rippleControl,
+            performanceMode: settings.performanceMode,
+            liftOffDistance: settings.liftOffDistance,
+            firmware: firmware ? [`Mouse ${firmware}`] : [],
+            ui: {
+                family: "vgn-f2",
+                hideUnsupportedPollingRates: true,
+                forceShowBattery: true,
+                pollingNote: "F2 Master+ supports 125 Hz through 8,000 Hz over its captured 8K protocol.",
+                defaultDisplayName: "VGN Dragonfly F2 Master+",
+            },
+        };
+    }
+    async setDpi(dpi) {
+        const profile = vgnDecodeProfile(await this.readProfile());
+        const address = VGN_ADDRESS.dpiStages + profile.activeDpiStage * 4;
+        await this.write(address, [...vgnEncodeDpi(dpi)]);
+        const confirmed = vgnDecodeProfile(await this.readProfile()).dpi;
+        if (confirmed !== dpi)
+            throw new Error(`The VGN mouse kept ${confirmed} DPI instead of ${dpi} DPI.`);
+        return confirmed;
+    }
+    async setPollingRate(rate) {
+        await this.writeScalar(VGN_ADDRESS.pollingRate, vgnEncodePollingRate(rate));
+        const confirmed = vgnDecodeProfile(await this.readProfile()).pollingRateHz;
+        if (confirmed !== rate)
+            throw new Error(`The VGN mouse kept ${confirmed} Hz instead of ${rate} Hz.`);
+        return confirmed;
+    }
+    async setLiftOffDistance(value) {
+        const raw = value === "Low" ? 3 : value === "Medium" ? 1 : 2;
+        await this.writeScalar(VGN_ADDRESS.lod, raw);
+        const confirmed = vgnDecodeProfile(await this.readProfile()).liftOffDistance;
+        if (confirmed !== value)
+            throw new Error(`The VGN mouse kept ${confirmed ?? "unknown"} LOD instead of ${value}.`);
+        return confirmed;
+    }
+    async setMotionSync(enabled) { return this.setBoolean(VGN_ADDRESS.motionSync, enabled); }
+    async setAngleSnapping(enabled) { return this.setBoolean(VGN_ADDRESS.angleSnapping, enabled); }
+    async setRippleControl(enabled) { return this.setBoolean(VGN_ADDRESS.rippleControl, enabled); }
+    async setPerformanceMode(enabled) { return this.setBoolean(VGN_ADDRESS.performanceMode, enabled); }
+    async setDebounceTime(value) {
+        if (!Number.isInteger(value) || value < 0 || value > 30)
+            throw new Error("VGN debounce must be 0–30 ms.");
+        await this.writeScalar(VGN_ADDRESS.debounce, value);
+        return value;
+    }
+    async setSleepTimeout(value) {
+        if (![1, 3, 6, 12, 30, 60, 180].includes(value))
+            throw new Error("VGN sleep timeout is not supported.");
+        await this.writeScalar(VGN_ADDRESS.sleep, value);
+        return value;
+    }
+    async close() {
+        this.failWaiter(new Error("The VGN device was closed."));
+        this.device.removeEventListener("inputreport", this.onInputReport);
+        if (this.device.opened)
+            await this.device.close();
+    }
+    async setBoolean(address, enabled) {
+        await this.writeScalar(address, enabled ? 1 : 0);
+        return enabled;
+    }
+    async readProfile() {
+        const profile = new Uint8Array(0xb7);
+        for (const [start, end] of [[0, 0x2c], [0xa8, 0xb7]]) {
+            for (let address = start; address < end; address += 10) {
+                const length = Math.min(10, end - address);
+                profile.set(await this.read(address, length), address);
+                if (this.isWirelessPath())
+                    await new Promise((resolve) => window.setTimeout(resolve, 10));
+            }
+        }
+        return profile;
+    }
+    async read(address, length) {
+        const response = await this.transact(vgnBuildReadPayload(address, length));
+        const data = vgnParseReadResponse(response, address, length);
+        if (!data)
+            throw new Error(`VGN flash read failed at 0x${address.toString(16)}.`);
+        return data;
+    }
+    async writeScalar(address, value) {
+        const response = await this.transact(vgnBuildWriteScalarPayload(address, value));
+        if (!vgnReportChecksumIsValid(response) || response[0] !== VGN_COMMAND.write || response[1] !== 0) {
+            throw new Error(`VGN flash write failed at 0x${address.toString(16)}.`);
+        }
+        const confirmed = await this.read(address, 2);
+        if (confirmed[0] !== value || ((confirmed[0] + confirmed[1]) & 0xff) !== 0x55) {
+            throw new Error(`The VGN mouse did not retain the value written at 0x${address.toString(16)}.`);
+        }
+    }
+    async write(address, data) {
+        const response = await this.transact(vgnBuildWritePayload(address, data));
+        if (!vgnReportChecksumIsValid(response) || response[0] !== VGN_COMMAND.write || response[1] !== 0) {
+            throw new Error(`VGN flash write failed at 0x${address.toString(16)}.`);
+        }
+    }
+    async transact(payload) {
+        await this.open();
+        this.failWaiter(new Error("Superseded by another VGN request."));
+        const command = payload[0];
+        const response = new Promise((resolve, reject) => {
+            const timer = window.setTimeout(() => {
+                if (this.waiter?.resolve === resolve)
+                    this.waiter = null;
+                reject(new Error(`Timed out waiting for VGN command 0x${command.toString(16)}.`));
+            }, RESPONSE_TIMEOUT_MS);
+            this.waiter = { command, resolve, reject, timer };
+        });
+        try {
+            await this.device.sendReport(VGN_REPORT_ID, new Uint8Array(payload).buffer);
+        }
+        catch (error) {
+            this.failWaiter(error instanceof Error ? error : new Error(String(error)));
+        }
+        return response;
+    }
+    version(response) {
+        if (!vgnReportChecksumIsValid(response) || response[0] !== VGN_COMMAND.firmware || response[1] !== 0)
+            return null;
+        return `v${response[5] ?? 0}.${(response[6] ?? 0).toString(16).padStart(2, "0")}`;
+    }
+    failWaiter(error) {
+        const waiter = this.waiter;
+        if (!waiter)
+            return;
+        window.clearTimeout(waiter.timer);
+        this.waiter = null;
+        waiter.reject(error);
+    }
+    static reportLength(report) {
+        return report.items.reduce((sum, item) => sum + item.reportSize * item.reportCount, 0) / 8;
+    }
+}
+//# sourceMappingURL=hid.js.map

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

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

package/dist/drivers/wallhack/keyboard-hid.d.ts

@@ -0,0 +1,28 @@
+import type { MouseStatus } from "../mouse-types.ts";
+/**
+ * WALLHACK K-001 analog keyboard — read-only WebHID identity (stage one).
+ *
+ * OpenMouse is a mouse control panel, so the K-001's actuation / rapid-trigger /
+ * SOCD surface has no home in the settings grid yet. Like the Wooting stage-one
+ * driver, this recognises the board on its 0xFFA0 command interface, connects,
+ * and reports what it is — `ui.settingsReady = false`, no setters. The keyboard's
+ * per-firmware config protocol (the app ships it as versioned modules) is not
+ * decoded here, so this makes no config reads and changes nothing.
+ */
+export declare class WallhackKeyboardHidClient {
+    readonly device: HIDDevice;
+    constructor(device: HIDDevice);
+    /**
+     * K-001 identity: either WALLHACK vendor id, the keyboard product id, and the
+     * 0xFFA0 command collection. Both vendor ids are accepted because some units
+     * enumerate under the switch-matrix MCU's vendor id.
+     */
+    static isSupported(device: HIDDevice): boolean;
+    private static commandCollection;
+    /** Part of the shared client contract; a keyboard has no mouse DPI options. */
+    getDpiOptions(): number[];
+    open(): Promise<void>;
+    close(): Promise<void>;
+    readStatus(): Promise<MouseStatus>;
+}
+//# sourceMappingURL=keyboard-hid.d.ts.map

package/dist/drivers/wallhack/keyboard-hid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/wallhack/keyboard-hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AASrD;;;;;;;;;GASG;AAEH,qBAAa,yBAAyB;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;gBAEf,MAAM,EAAE,SAAS;IAI7B;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAQ9C,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAchC,+EAA+E;IAC/E,aAAa,IAAI,MAAM,EAAE;IAInB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;CAwBzC"}

package/dist/drivers/wallhack/keyboard-hid.js

@@ -0,0 +1,80 @@
+import { wallhackKeyboardName, WALLHACK_KEYBOARD_ALT_VENDOR_ID, WALLHACK_KEYBOARD_PRODUCT_IDS, WALLHACK_KEYBOARD_USAGE_PAGE, WALLHACK_VENDOR_ID, } from "@openmouse/protocol/wallhack";
+/**
+ * WALLHACK K-001 analog keyboard — read-only WebHID identity (stage one).
+ *
+ * OpenMouse is a mouse control panel, so the K-001's actuation / rapid-trigger /
+ * SOCD surface has no home in the settings grid yet. Like the Wooting stage-one
+ * driver, this recognises the board on its 0xFFA0 command interface, connects,
+ * and reports what it is — `ui.settingsReady = false`, no setters. The keyboard's
+ * per-firmware config protocol (the app ships it as versioned modules) is not
+ * decoded here, so this makes no config reads and changes nothing.
+ */
+export class WallhackKeyboardHidClient {
+    device;
+    constructor(device) {
+        this.device = device;
+    }
+    /**
+     * K-001 identity: either WALLHACK vendor id, the keyboard product id, and the
+     * 0xFFA0 command collection. Both vendor ids are accepted because some units
+     * enumerate under the switch-matrix MCU's vendor id.
+     */
+    static isSupported(device) {
+        const vendorOk = device.vendorId === WALLHACK_VENDOR_ID
+            || device.vendorId === WALLHACK_KEYBOARD_ALT_VENDOR_ID;
+        if (!vendorOk)
+            return false;
+        if (!WALLHACK_KEYBOARD_PRODUCT_IDS.has(device.productId))
+            return false;
+        return WallhackKeyboardHidClient.commandCollection(device.collections) !== null;
+    }
+    static commandCollection(collections) {
+        // Matched on usage page alone, mirroring the WALLHACK app's `ec()`.
+        for (const collection of collections) {
+            if (collection.usagePage === WALLHACK_KEYBOARD_USAGE_PAGE) {
+                return collection;
+            }
+            const nested = WallhackKeyboardHidClient.commandCollection(collection.children);
+            if (nested)
+                return nested;
+        }
+        return null;
+    }
+    /** Part of the shared client contract; a keyboard has no mouse DPI options. */
+    getDpiOptions() {
+        return [];
+    }
+    async open() {
+        if (!this.device.opened)
+            await this.device.open();
+    }
+    async close() {
+        if (this.device.opened)
+            await this.device.close();
+    }
+    async readStatus() {
+        await this.open();
+        return {
+            brand: "WALLHACK",
+            name: wallhackKeyboardName(this.device.productId),
+            ui: {
+                family: "wallhack-keyboard",
+                // Analog-keyboard controls have no place in the mouse settings grid yet.
+                settingsReady: false,
+                defaultDisplayName: wallhackKeyboardName(this.device.productId),
+            },
+            batteryPercent: null,
+            batteryState: "Unknown",
+            // Placeholder mouse fields the shared status shape requires; the grid is
+            // hidden, so these are never shown.
+            dpi: 0,
+            pollingRateHz: 0,
+            activeProfile: null,
+            connectionType: "Wired",
+            connectionDetail: "USB",
+            liftOffDistance: null,
+            firmware: [wallhackKeyboardName(this.device.productId)],
+        };
+    }
+}
+//# sourceMappingURL=keyboard-hid.js.map

package/dist/drivers/wallhack/keyboard-hid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-hid.js","sourceRoot":"","sources":["../../../src/drivers/wallhack/keyboard-hid.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,+BAA+B,EAC/B,6BAA6B,EAC7B,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;GASG;AAEH,MAAM,OAAO,yBAAyB;IAC3B,MAAM,CAAY;IAE3B,YAAY,MAAiB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,MAAiB;QAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,KAAK,kBAAkB;eAClD,MAAM,CAAC,QAAQ,KAAK,+BAA+B,CAAC;QACzD,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5B,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;YAAE,OAAO,KAAK,CAAC;QACvE,OAAO,yBAAyB,CAAC,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAClF,CAAC;IAEO,MAAM,CAAC,iBAAiB,CAC9B,WAAyC;QAEzC,oEAAoE;QACpE,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,UAAU,CAAC,SAAS,KAAK,4BAA4B,EAAE,CAAC;gBAC1D,OAAO,UAAU,CAAC;YACpB,CAAC;YACD,MAAM,MAAM,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAChF,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+EAA+E;IAC/E,aAAa;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO;YACL,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YACjD,EAAE,EAAE;gBACF,MAAM,EAAE,mBAAmB;gBAC3B,yEAAyE;gBACzE,aAAa,EAAE,KAAK;gBACpB,kBAAkB,EAAE,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;aAChE;YACD,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,SAAS;YACvB,yEAAyE;YACzE,oCAAoC;YACpC,GAAG,EAAE,CAAC;YACN,aAAa,EAAE,CAAC;YAChB,aAAa,EAAE,IAAI;YACnB,cAAc,EAAE,OAAO;YACvB,gBAAgB,EAAE,KAAK;YACvB,eAAe,EAAE,IAAI;YACrB,QAAQ,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;SACxD,CAAC;IACJ,CAAC;CACF"}

package/dist/drivers/wallhack/mouse-hid.d.ts

@@ -0,0 +1,45 @@
+import type { MouseStatus } from "../mouse-types.ts";
+export declare class WallhackMouseHidClient {
+    readonly device: HIDDevice;
+    private responseWaiter;
+    private readonly onInputReport;
+    private listening;
+    constructor(device: HIDDevice);
+    /** M-001 VID/PID with the mouse command collection (usage page 0xFF1C). */
+    static isSupported(device: HIDDevice): boolean;
+    private static commandCollection;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    /** Selectable polling rates, in Hz. Same list wired or wireless. */
+    getDpiOptions(): number[];
+    getPollingRateOptions(): number[];
+    readStatus(): Promise<MouseStatus>;
+    setDpi(dpi: number): Promise<number>;
+    setPollingRate(hz: number): Promise<number>;
+    setLiftOffDistance(lod: "Low" | "Medium" | "High"): Promise<"Low" | "Medium" | "High">;
+    setMotionSync(enabled: boolean): Promise<boolean>;
+    setAngleSnapping(enabled: boolean): Promise<boolean>;
+    setRippleControl(enabled: boolean): Promise<boolean>;
+    setDebounceTime(debounceMs: number): Promise<number>;
+    setSleepTimeout(minutes: number): Promise<number>;
+    setGameMode(enabled: boolean): Promise<boolean>;
+    setActiveProfile(profile: number): Promise<number>;
+    /** Re-pair the mouse to its receiver. */
+    pair(): Promise<void>;
+    clearPairing(): Promise<void>;
+    factoryReset(): Promise<void>;
+    /** Read one config byte at `address`, or null if the mouse did not answer. */
+    private readByte;
+    /** Read the active DPI stage's value from the DPI-stage block. */
+    private readDpi;
+    private writeByte;
+    private writeVerifiedByte;
+    private writeVerifiedBoolean;
+    /** Read a command's reply once, tolerating a device that does not answer. */
+    private command;
+    /** Send a report and wait for the input report that echoes `expectCommand`. */
+    private exchange;
+    private send;
+    private firmwareLines;
+}
+//# sourceMappingURL=mouse-hid.d.ts.map

package/dist/drivers/wallhack/mouse-hid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mouse-hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/wallhack/mouse-hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAwCrD,qBAAa,sBAAsB;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAE3B,OAAO,CAAC,cAAc,CAIN;IAEhB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAS5B;IAEF,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,SAAS;IAI7B,2EAA2E;IAC3E,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAM9C,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAe1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B,oEAAoE;IACpE,aAAa,IAAI,MAAM,EAAE;IAOzB,qBAAqB,IAAI,MAAM,EAAE;IAI3B,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IA6DlC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUpC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY3C,kBAAkB,CAAC,GAAG,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAStF,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjD,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOpD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYjD,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/C,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxD,yCAAyC;IACnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnC,8EAA8E;YAChE,QAAQ;IAMtB,kEAAkE;YACpD,OAAO;YASP,SAAS;YAIT,iBAAiB;YAcjB,oBAAoB;IAKlC,6EAA6E;YAC/D,OAAO;IAIrB,+EAA+E;YACjE,QAAQ;YA2BR,IAAI;IAIlB,OAAO,CAAC,aAAa;CAUtB"}