@openmouse/protocol 0.1.0

package/dist/drivers/glorious/classic-hid.js

@@ -0,0 +1,326 @@
+import { GLORIOUS_CLASSIC_DEBOUNCE_MAX_MS, GLORIOUS_CLASSIC_DEFAULT_RGB, GLORIOUS_CLASSIC_DPI_MAX, GLORIOUS_CLASSIC_DPI_MIN, GLORIOUS_CLASSIC_DPI_STAGE_COUNT, GLORIOUS_CLASSIC_LOD_HIGH_MM, GLORIOUS_CLASSIC_LOD_MEDIUM_MM, GLORIOUS_CLASSIC_PACKET_LENGTH, GLORIOUS_CLASSIC_POLLING_RATES, GLORIOUS_CLASSIC_PROFILE_DEFAULT, GLORIOUS_CLASSIC_REPORT_ID, buildGloriousClassicActiveStagePayload, buildGloriousClassicBatteryRequestPayload, buildGloriousClassicDebouncePayload, buildGloriousClassicDpiStagesPayload, buildGloriousClassicLiftOffPayload, buildGloriousClassicPollingRatePayload, buildGloriousClassicRgbPayload, gloriousClassicDecodePollingRate, gloriousClassicEncodePollingRate, parseGloriousClassicBatteryResponse, } from "../../glorious-classic/index.js";
+import { GLORIOUS_CLASSIC_PRODUCTS, VENDOR_ID } from "../vendors.js";
+/**
+ * Driver for Glorious's pre-Pixart "classic" line (Model O / O-, Model D /
+ * D-, Model I, Model O V2 — plus the newer "core2" 8000Hz-class mice, Model
+ * O3 Wireless and Model D 2 PRO 4K/8KHz Edition, on a reduced feature set —
+ * see the `generation` doc comment on `GLORIOUS_CLASSIC_PRODUCTS` in
+ * vendors.ts for why). The config channel is a feature report, usually 64
+ * bytes and unnumbered (id 0), but a real "Model O 2 Wired Mouse"
+ * (0x320f:0x823a) instead carries it as numbered report 7 at a 263-byte
+ * declared length. Both the report id and byte length are read from the
+ * device's own descriptor rather than assumed, so it connects - but every
+ * payload below is only reverse-engineered against the 64-byte case, and a
+ * diagnostic confirmed the mouse silently ignores a 64-byte payload just
+ * zero-padded out to 263 (WebHID's write succeeds; nothing changes on the
+ * mouse). See isConfirmedReportLength()'s doc comment: writes are refused
+ * for any length this driver hasn't confirmed a real byte layout for,
+ * rather than guessing again. See ../../glorious-classic/index.ts for the
+ * payload layout, which does not depend on the report id.
+ *
+ * DPI, polling rate, lift-off distance, and RGB are all write-only on this
+ * protocol (neither glorious-ctl nor mxw, the two tools this was ported
+ * from, implement a read for them) — like the sibling Pixart driver in
+ * ./hid.ts, this class keeps its own last-applied-settings cache so the UI
+ * has something to show. Only battery status is actually read from the
+ * mouse.
+ */
+// Config channel usage pages. Older firmware used 0xff01/0xff00; newer
+// firmware (confirmed on a Model D Wireless, 0x258a:0x2012) moved the
+// unnumbered config feature report to the 0xffff:0 collection instead.
+const CLASSIC_USAGE_PAGES = [0xff01, 0xff00, 0xffff];
+const BATTERY_RESPONSE_DELAY_MS = 60;
+const BATTERY_STATE_LABEL = {
+    Normal: "Discharging",
+    Asleep: "Unknown",
+    WakingUp: "Unknown",
+    Unknown: "Unknown",
+};
+const LIFT_OFF_DISTANCES = [
+    [GLORIOUS_CLASSIC_LOD_MEDIUM_MM, "Medium"],
+    [GLORIOUS_CLASSIC_LOD_HIGH_MM, "High"],
+];
+const DEFAULT_STATE = {
+    profileId: GLORIOUS_CLASSIC_PROFILE_DEFAULT,
+    stageDpis: [800, 1600, 3200, 6400],
+    activeStage: 0,
+    pollingIntervalMs: 1,
+    lodMm: GLORIOUS_CLASSIC_LOD_MEDIUM_MM,
+    debounceMs: 0,
+};
+export class GloriousClassicHidClient {
+    pollIntervalMs = 0;
+    device;
+    /**
+     * The vendor collection's feature report id and byte length, read from the
+     * device at connect time rather than assumed - see isConfirmedReportLength()
+     * for why a length other than 64 means writes get refused instead of guessed at.
+     */
+    reportId;
+    reportLength;
+    lastRgb = GLORIOUS_CLASSIC_DEFAULT_RGB;
+    constructor(device) {
+        this.device = device;
+        const config = GloriousClassicHidClient.findConfigReport(device);
+        this.reportId = config?.reportId ?? GLORIOUS_CLASSIC_REPORT_ID;
+        this.reportLength = config?.length ?? GLORIOUS_CLASSIC_PACKET_LENGTH;
+    }
+    static isSupported(device) {
+        if (device.vendorId !== VENDOR_ID.gloriousClassic
+            && device.vendorId !== VENDOR_ID.gloriousClassicI
+            && device.vendorId !== VENDOR_ID.gloriousClassicIWired
+            && device.vendorId !== VENDOR_ID.gloriousO3)
+            return false;
+        if (!GLORIOUS_CLASSIC_PRODUCTS.has(device.productId))
+            return false;
+        return this.findConfigReport(device) !== null;
+    }
+    /** The feature-report id and byte length carried by the config channel collection, or null. */
+    static findConfigReport(device) {
+        for (const collection of device.collections) {
+            const found = this.findConfigReportIn(collection);
+            if (found !== null)
+                return found;
+        }
+        return null;
+    }
+    static findConfigReportIn(collection) {
+        if (CLASSIC_USAGE_PAGES.includes(collection.usagePage) && collection.featureReports.length > 0) {
+            const report = collection.featureReports[0];
+            const bits = report.items.reduce((sum, item) => sum + (item.reportSize ?? 0) * (item.reportCount ?? 0), 0);
+            return { reportId: report.reportId, length: bits > 0 ? Math.ceil(bits / 8) : GLORIOUS_CLASSIC_PACKET_LENGTH };
+        }
+        for (const child of collection.children) {
+            const found = this.findConfigReportIn(child);
+            if (found !== null)
+                return found;
+        }
+        return null;
+    }
+    /** Resizes a payload (always built at GLORIOUS_CLASSIC_PACKET_LENGTH) to the device's real declared length. */
+    fitPayload(payload) {
+        if (payload.length === this.reportLength)
+            return payload;
+        const resized = new Uint8Array(this.reportLength);
+        resized.set(payload.subarray(0, Math.min(payload.length, this.reportLength)));
+        return resized;
+    }
+    async send(payload) {
+        await this.device.sendFeatureReport(this.reportId, this.fitPayload(payload));
+    }
+    async open() {
+        if (!this.device.opened)
+            await this.device.open();
+    }
+    async close() {
+        if (this.device.opened)
+            await this.device.close();
+    }
+    displayName() {
+        if (this.device.productName)
+            return this.device.productName;
+        return GLORIOUS_CLASSIC_PRODUCTS.get(this.device.productId)?.name ?? "Glorious mouse";
+    }
+    isWireless() {
+        return GLORIOUS_CLASSIC_PRODUCTS.get(this.device.productId)?.wireless ?? false;
+    }
+    /**
+     * "core2" (Model O3 Wireless, Model D 2 PRO 4K/8KHz Edition) only gets
+     * RGB/debounce/battery — see the doc comment on `GLORIOUS_CLASSIC_PRODUCTS`
+     * in vendors.ts for why DPI/polling/LOD stay off for this generation.
+     */
+    isCore2() {
+        return GLORIOUS_CLASSIC_PRODUCTS.get(this.device.productId)?.generation === "core2";
+    }
+    /**
+     * Every payload builder in glorious-classic/index.ts was reverse-engineered
+     * against the 64-byte feature report every classic-line unit confirmed so
+     * far uses. A real 0x320f:0x823a instead declares a 263-byte report;
+     * resizing our 64-byte payload to fit sends without a WebHID error, but a
+     * diagnostic confirmed the mouse ignores it outright - the firmware ACKs
+     * the write and changes nothing. A report length this driver hasn't seen a
+     * real byte layout for is therefore not writable yet, even though it
+     * connects and its report id is known - see [[glorious-classic-protocol]]
+     * in memory. Refuse instead of guessing again until a capture of the
+     * device's own official software gives the real layout.
+     */
+    isConfirmedReportLength() {
+        return this.reportLength === GLORIOUS_CLASSIC_PACKET_LENGTH;
+    }
+    assertWritable(feature) {
+        if (this.isCore2())
+            throw new Error(`${feature} is not confirmed on this mouse's newer protocol generation yet.`);
+        if (!this.isConfirmedReportLength()) {
+            throw new Error(`${feature} is not confirmed on this unit's ${this.reportLength}-byte feature report yet.`);
+        }
+    }
+    getDpiOptions() {
+        if (this.isCore2() || !this.isConfirmedReportLength())
+            return [];
+        const options = [];
+        for (let dpi = GLORIOUS_CLASSIC_DPI_MIN; dpi <= GLORIOUS_CLASSIC_DPI_MAX; dpi += 50)
+            options.push(dpi);
+        return options;
+    }
+    getSupportedPollingRates() {
+        if (this.isCore2() || !this.isConfirmedReportLength())
+            return [];
+        return GLORIOUS_CLASSIC_POLLING_RATES.map(([, hertz]) => hertz).sort((left, right) => left - right);
+    }
+    async readStatus() {
+        await this.open();
+        const state = this.loadState();
+        const battery = this.isWireless() ? await this.readBattery().catch(() => null) : null;
+        const wireless = this.isWireless();
+        const core2 = this.isCore2();
+        const restricted = core2 || !this.isConfirmedReportLength();
+        const liftOffDistance = restricted ? null : LIFT_OFF_DISTANCES.find(([mm]) => mm === state.lodMm)?.[1] ?? "Medium";
+        return {
+            brand: "Glorious",
+            name: this.displayName(),
+            ui: this.getUiHints(),
+            batteryPercent: battery?.percent ?? null,
+            batteryState: battery
+                ? (battery.state === "Normal" && battery.charging ? "Charging" : BATTERY_STATE_LABEL[battery.state])
+                : "Unknown",
+            dpi: restricted ? 0 : state.stageDpis[state.activeStage] ?? state.stageDpis[0] ?? 800,
+            pollingRateHz: restricted ? 0 : gloriousClassicDecodePollingRate(state.pollingIntervalMs) ?? 1000,
+            supportedPollingRates: this.getSupportedPollingRates(),
+            activeProfile: restricted ? null : state.profileId,
+            connectionType: wireless ? "Wireless" : "Wired",
+            connectionDetail: wireless
+                ? "2.4 GHz / Bluetooth · settings are write-only, not read back"
+                : "Wired USB · settings are write-only, not read back",
+            debounceMs: state.debounceMs,
+            liftOffDistance,
+            firmware: [],
+        };
+    }
+    async setDpi(dpi) {
+        this.assertWritable("DPI");
+        if (!Number.isFinite(dpi) || dpi < GLORIOUS_CLASSIC_DPI_MIN || dpi > GLORIOUS_CLASSIC_DPI_MAX) {
+            throw new Error(`DPI must be between ${GLORIOUS_CLASSIC_DPI_MIN} and ${GLORIOUS_CLASSIC_DPI_MAX}.`);
+        }
+        const state = this.loadState();
+        const rounded = Math.round(dpi);
+        state.stageDpis[state.activeStage] = rounded;
+        await this.open();
+        await this.send(buildGloriousClassicDpiStagesPayload(state.stageDpis, state.profileId));
+        await this.send(buildGloriousClassicActiveStagePayload(state.activeStage + 1, state.profileId));
+        this.saveState(state);
+        return rounded;
+    }
+    async setPollingRate(pollingRateHz) {
+        this.assertWritable("Polling rate");
+        const intervalMs = gloriousClassicEncodePollingRate(pollingRateHz);
+        if (intervalMs === null)
+            throw new Error(`This mouse does not support ${pollingRateHz} Hz.`);
+        const state = this.loadState();
+        await this.open();
+        await this.send(buildGloriousClassicPollingRatePayload(intervalMs));
+        state.pollingIntervalMs = intervalMs;
+        this.saveState(state);
+        return pollingRateHz;
+    }
+    async setLiftOffDistance(value) {
+        this.assertWritable("Lift-off distance");
+        const millimetres = LIFT_OFF_DISTANCES.find(([, name]) => name === value)?.[0];
+        if (!millimetres)
+            throw new Error(`This mouse does not support a ${value.toLowerCase()} lift-off distance.`);
+        const state = this.loadState();
+        await this.open();
+        await this.send(buildGloriousClassicLiftOffPayload(millimetres));
+        state.lodMm = millimetres;
+        this.saveState(state);
+        return value;
+    }
+    async setDebounceTime(milliseconds) {
+        // Unlike DPI/polling/LOD, core2 does write debounce - so this only gates
+        // on report length, not isCore2().
+        if (!this.isConfirmedReportLength()) {
+            throw new Error(`Debounce is not confirmed on this unit's ${this.reportLength}-byte feature report yet.`);
+        }
+        if (!Number.isFinite(milliseconds) || milliseconds < 0 || milliseconds > GLORIOUS_CLASSIC_DEBOUNCE_MAX_MS) {
+            throw new Error(`Debounce must be between 0 and ${GLORIOUS_CLASSIC_DEBOUNCE_MAX_MS} ms.`);
+        }
+        const state = this.loadState();
+        const clamped = Math.round(milliseconds);
+        await this.open();
+        await this.send(buildGloriousClassicDebouncePayload(clamped, state.profileId));
+        state.debounceMs = clamped;
+        this.saveState(state);
+        return clamped;
+    }
+    getRgb() {
+        return this.lastRgb;
+    }
+    async setRgb(rgb) {
+        // Unlike DPI/polling/LOD, core2 does write RGB - so this only gates on
+        // report length, not isCore2().
+        if (!this.isConfirmedReportLength()) {
+            throw new Error(`RGB is not confirmed on this unit's ${this.reportLength}-byte feature report yet.`);
+        }
+        await this.open();
+        await this.send(buildGloriousClassicRgbPayload(rgb));
+        this.lastRgb = rgb;
+        return rgb;
+    }
+    async readBattery() {
+        await this.send(buildGloriousClassicBatteryRequestPayload());
+        await this.delay(BATTERY_RESPONSE_DELAY_MS);
+        const view = await this.device.receiveFeatureReport(this.reportId);
+        const body = new Uint8Array(view.buffer, view.byteOffset, Math.min(view.byteLength, GLORIOUS_CLASSIC_PACKET_LENGTH));
+        return parseGloriousClassicBatteryResponse(body);
+    }
+    delay(milliseconds) {
+        return new Promise((resolve) => setTimeout(resolve, milliseconds));
+    }
+    getUiHints() {
+        return {
+            family: "glorious-classic",
+            hideLodLow: true,
+            hideUnsupportedPollingRates: true,
+            hideProcessingCard: true,
+            hideSleepCard: true,
+            hideSignalCard: true,
+            forceShowBattery: this.isWireless(),
+            statusNote: this.isCore2()
+                ? "This mouse's newer protocol generation only has confirmed commands for RGB, debounce, and battery — DPI, polling rate, and lift-off distance aren't wired in yet."
+                : !this.isConfirmedReportLength()
+                    ? `This mouse connects, but its ${this.reportLength}-byte feature report uses a byte layout this driver hasn't confirmed yet — no settings can be changed until a real capture is available.`
+                    : "DPI, polling rate, lift-off distance and RGB are written to this mouse but never read back.",
+        };
+    }
+    stateKey() {
+        return `openmouse-glorious-classic-state-v1:${this.device.vendorId.toString(16)}-${this.device.productId.toString(16)}`;
+    }
+    loadState() {
+        try {
+            const stored = JSON.parse(localStorage.getItem(this.stateKey()) ?? "null");
+            if (!stored)
+                throw new Error("no stored state");
+            return {
+                profileId: stored.profileId ?? DEFAULT_STATE.profileId,
+                stageDpis: Array.isArray(stored.stageDpis) && stored.stageDpis.length === GLORIOUS_CLASSIC_DPI_STAGE_COUNT
+                    ? [...stored.stageDpis]
+                    : [...DEFAULT_STATE.stageDpis],
+                activeStage: stored.activeStage ?? DEFAULT_STATE.activeStage,
+                pollingIntervalMs: stored.pollingIntervalMs ?? DEFAULT_STATE.pollingIntervalMs,
+                lodMm: stored.lodMm ?? DEFAULT_STATE.lodMm,
+                debounceMs: stored.debounceMs ?? DEFAULT_STATE.debounceMs,
+            };
+        }
+        catch {
+            return { ...DEFAULT_STATE, stageDpis: [...DEFAULT_STATE.stageDpis] };
+        }
+    }
+    saveState(state) {
+        try {
+            localStorage.setItem(this.stateKey(), JSON.stringify(state));
+        }
+        catch {
+            // Settings still reach the mouse when browser storage is unavailable.
+        }
+    }
+}
+//# sourceMappingURL=classic-hid.js.map

package/dist/drivers/glorious/classic-hid.js.map

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

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

@@ -0,0 +1,39 @@
+import type { GloriousLighting, GloriousSettings } from "../../glorious/index.ts";
+import type { MouseStatus, MouseUiHints } from "../mouse-types.ts";
+type LiftOffDistance = NonNullable<MouseStatus["liftOffDistance"]>;
+export declare class GloriousHidClient {
+    /** Write-only protocol — there is nothing to poll. */
+    readonly pollIntervalMs = 0;
+    readonly device: HIDDevice;
+    constructor(device: HIDDevice);
+    static isSupported(device: HIDDevice): boolean;
+    private static hasConfigReport;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    displayName(): string;
+    isWireless(): boolean;
+    getDpiOptions(): number[];
+    getSupportedPollingRates(): number[];
+    readStatus(): Promise<MouseStatus>;
+    setDpi(dpi: number): Promise<number>;
+    setPollingRate(pollingRateHz: number): Promise<number>;
+    setLiftOffDistance(value: LiftOffDistance): Promise<LiftOffDistance>;
+    setDebounceTime(milliseconds: number): Promise<number>;
+    setSleepTimeout(_seconds: number): Promise<number>;
+    /** Last known onboard settings (write-only protocol: nothing to poll). */
+    getSettings(): GloriousSettings;
+    /** Validates and pushes a full settings payload, returning the stored copy. */
+    applySettings(settings: GloriousSettings): Promise<GloriousSettings>;
+    /** Firmware never reports lighting back; this returns the last applied state. */
+    getLighting(): GloriousLighting;
+    setLighting(lighting: GloriousLighting): Promise<GloriousLighting>;
+    getUiHints(): MouseUiHints;
+    private pushSettings;
+    private statusFromState;
+    private stateKey;
+    private lightingKey;
+    private loadState;
+    private saveState;
+}
+export {};
+//# sourceMappingURL=hid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/glorious/hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAmBlF,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWnE,KAAK,eAAe,GAAG,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAOnE,qBAAa,iBAAiB;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,cAAc,KAAK;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;gBAEf,MAAM,EAAE,SAAS;IAI7B,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAQ9C,OAAO,CAAC,MAAM,CAAC,eAAe;IAMxB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,WAAW,IAAI,MAAM;IAMrB,UAAU,IAAI,OAAO;IAIrB,aAAa,IAAI,MAAM,EAAE;IAMzB,wBAAwB,IAAI,MAAM,EAAE;IAI9B,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAKlC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQpC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWtD,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IASpE,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUtD,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxD,0EAA0E;IAC1E,WAAW,IAAI,gBAAgB;IAI/B,+EAA+E;IACzE,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAM1E,iFAAiF;IACjF,WAAW,IAAI,gBAAgB;IAQzB,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAcxE,UAAU,IAAI,YAAY;YASZ,YAAY;IAU1B,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,SAAS;CAOlB"}

package/dist/drivers/glorious/hid.js

@@ -0,0 +1,203 @@
+import { GLORIOUS_CONFIG_REPORT_ID, GLORIOUS_DEFAULT_LIGHTING, GLORIOUS_DEFAULT_SETTINGS, GLORIOUS_DEBOUNCE_MAX_MS, GLORIOUS_DPI_MAX, GLORIOUS_DPI_MIN, GLORIOUS_DPI_UNIT, GLORIOUS_POLLING_RATES, buildGloriousLightingPayload, buildGloriousSettingsPayload, gloriousDecodePolling, gloriousEncodePolling, gloriousIsSupportedDpi, gloriousNormalizeLighting, gloriousNormalizeSettings, gloriousSanitizeDebounce, } from "../../glorious/index.js";
+import { VENDOR_ID, GLORIOUS_PRODUCTS } from "../vendors.js";
+/**
+ * Driver for the write-only Pixart configuration interface of the Glorious
+ * Model O 2 / I 2 family. See glorious/index.ts for the payload layout;
+ * this file only handles HID plumbing, validation, and local state caching.
+ */
+const VENDOR_USAGE_PAGE = 0xff00;
+const LIFT_OFF_DISTANCES = [
+    [1, "Medium"],
+    [2, "High"],
+];
+export class GloriousHidClient {
+    /** Write-only protocol — there is nothing to poll. */
+    pollIntervalMs = 0;
+    device;
+    constructor(device) {
+        this.device = device;
+    }
+    static isSupported(device) {
+        if (device.vendorId !== VENDOR_ID.glorious)
+            return false;
+        const named = GLORIOUS_PRODUCTS.has(device.productId)
+            || /model\s+[odi]\s*2/i.test(device.productName || "");
+        if (!named)
+            return false;
+        return device.collections.some((collection) => this.hasConfigReport(collection));
+    }
+    static hasConfigReport(collection) {
+        return collection.usagePage === VENDOR_USAGE_PAGE
+            && collection.featureReports.some((report) => report.reportId === GLORIOUS_CONFIG_REPORT_ID)
+            || collection.children.some((child) => this.hasConfigReport(child));
+    }
+    async open() {
+        if (!this.device.opened)
+            await this.device.open();
+    }
+    async close() {
+        if (this.device.opened)
+            await this.device.close();
+    }
+    displayName() {
+        if (this.device.productName)
+            return this.device.productName;
+        const known = GLORIOUS_PRODUCTS.get(this.device.productId);
+        return known ? `Glorious ${known.name}` : "Glorious mouse";
+    }
+    isWireless() {
+        return GLORIOUS_PRODUCTS.get(this.device.productId)?.wireless ?? false;
+    }
+    getDpiOptions() {
+        const options = [];
+        for (let dpi = GLORIOUS_DPI_MIN; dpi <= GLORIOUS_DPI_MAX; dpi += GLORIOUS_DPI_UNIT)
+            options.push(dpi);
+        return options;
+    }
+    getSupportedPollingRates() {
+        return GLORIOUS_POLLING_RATES.map(([, hertz]) => hertz).sort((left, right) => left - right);
+    }
+    async readStatus() {
+        await this.open();
+        return this.statusFromState(this.loadState());
+    }
+    async setDpi(dpi) {
+        if (!gloriousIsSupportedDpi(dpi))
+            throw new Error(`${dpi.toLocaleString()} is not a supported DPI value.`);
+        const settings = this.loadState();
+        settings.stageDpis[settings.activeStage] = dpi;
+        await this.pushSettings(settings);
+        return dpi;
+    }
+    async setPollingRate(pollingRateHz) {
+        const encoded = gloriousEncodePolling(pollingRateHz);
+        if (!encoded || !this.getSupportedPollingRates().includes(pollingRateHz)) {
+            throw new Error(`This mouse does not support ${pollingRateHz} Hz.`);
+        }
+        const settings = this.loadState();
+        settings.pollingCode = encoded;
+        await this.pushSettings(settings);
+        return pollingRateHz;
+    }
+    async setLiftOffDistance(value) {
+        const millimetres = LIFT_OFF_DISTANCES.find(([, name]) => name === value)?.[0];
+        if (!millimetres)
+            throw new Error(`This mouse does not support a ${value.toLowerCase()} lift-off distance.`);
+        const settings = this.loadState();
+        settings.lodMm = millimetres;
+        await this.pushSettings(settings);
+        return value;
+    }
+    async setDebounceTime(milliseconds) {
+        if (!Number.isInteger(milliseconds)) {
+            throw new Error(`Debounce must be an even number of milliseconds between 0 and ${GLORIOUS_DEBOUNCE_MAX_MS}.`);
+        }
+        const settings = this.loadState();
+        settings.debounceMs = gloriousSanitizeDebounce(milliseconds);
+        await this.pushSettings(settings);
+        return settings.debounceMs;
+    }
+    async setSleepTimeout(_seconds) {
+        throw new Error("Auto sleep is not exposed by this device's protocol.");
+    }
+    /** Last known onboard settings (write-only protocol: nothing to poll). */
+    getSettings() {
+        return this.loadState();
+    }
+    /** Validates and pushes a full settings payload, returning the stored copy. */
+    async applySettings(settings) {
+        const normalized = gloriousNormalizeSettings(settings);
+        await this.pushSettings(normalized);
+        return this.loadState();
+    }
+    /** Firmware never reports lighting back; this returns the last applied state. */
+    getLighting() {
+        try {
+            return gloriousNormalizeLighting(JSON.parse(localStorage.getItem(this.lightingKey()) ?? "{}"));
+        }
+        catch {
+            return { ...GLORIOUS_DEFAULT_LIGHTING, colors: [...GLORIOUS_DEFAULT_LIGHTING.colors] };
+        }
+    }
+    async setLighting(lighting) {
+        await this.open();
+        for (const fragment of buildGloriousLightingPayload(lighting)) {
+            await this.device.sendFeatureReport(GLORIOUS_CONFIG_REPORT_ID, fragment.slice(1));
+        }
+        const normalized = gloriousNormalizeLighting(lighting);
+        try {
+            localStorage.setItem(this.lightingKey(), JSON.stringify(normalized));
+        }
+        catch {
+            // Lighting still reaches the mouse when browser storage is unavailable.
+        }
+        return normalized;
+    }
+    getUiHints() {
+        return {
+            family: "glorious",
+            hideLodLow: true,
+            hideUnsupportedPollingRates: true,
+            hideProcessingCard: true,
+        };
+    }
+    async pushSettings(settings) {
+        await this.open();
+        for (const fragment of buildGloriousSettingsPayload(settings)) {
+            // Fragments follow the C/hidapi layout where byte 0 is the report ID.
+            // WebHID takes the ID separately and prepends it, so only send the body.
+            await this.device.sendFeatureReport(GLORIOUS_CONFIG_REPORT_ID, fragment.slice(1));
+        }
+        this.saveState(settings);
+    }
+    statusFromState(settings) {
+        const wireless = this.isWireless();
+        const liftOffDistance = LIFT_OFF_DISTANCES.find(([millimetres]) => millimetres === settings.lodMm)?.[1]
+            ?? "Medium";
+        return {
+            brand: "Glorious",
+            name: this.displayName(),
+            ui: this.getUiHints(),
+            batteryPercent: null,
+            batteryState: "Unknown",
+            dpi: settings.stageDpis[settings.activeStage] || 800,
+            pollingRateHz: gloriousDecodePolling(settings.pollingCode) ?? 1000,
+            supportedPollingRates: this.getSupportedPollingRates(),
+            activeProfile: settings.activeStage + 1,
+            connectionType: wireless ? "Wireless" : "Wired",
+            connectionDetail: wireless
+                ? "2.4 GHz receiver · write-only config"
+                : "Wired USB · write-only config",
+            debounceMs: settings.debounceMs,
+            liftOffDistance,
+            firmware: [],
+        };
+    }
+    stateKey() {
+        return `openmouse-glorious-state-v1:${this.device.vendorId.toString(16)}-${this.device.productId.toString(16)}`;
+    }
+    lightingKey() {
+        return `openmouse-glorious-lighting-v1:${this.device.vendorId.toString(16)}-${this.device.productId.toString(16)}`;
+    }
+    loadState() {
+        try {
+            return gloriousNormalizeSettings(JSON.parse(localStorage.getItem(this.stateKey()) ?? "{}"));
+        }
+        catch {
+            return {
+                ...GLORIOUS_DEFAULT_SETTINGS,
+                stageDpis: [...GLORIOUS_DEFAULT_SETTINGS.stageDpis],
+                stageColors: [...GLORIOUS_DEFAULT_SETTINGS.stageColors],
+            };
+        }
+    }
+    saveState(settings) {
+        try {
+            localStorage.setItem(this.stateKey(), JSON.stringify(settings));
+        }
+        catch {
+            // Settings still reach the mouse when browser storage is unavailable.
+        }
+    }
+}
+//# sourceMappingURL=hid.js.map

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

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

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

@@ -0,0 +1,27 @@
+import type { MouseStatus } from "../mouse-types.ts";
+export declare class GWolvesHidClient {
+    readonly device: HIDDevice;
+    private waiter;
+    private readonly onInputReport;
+    constructor(device: HIDDevice);
+    static isSupported(device: HIDDevice): boolean;
+    private get product();
+    isWirelessPath(): boolean;
+    get pollIntervalMs(): number;
+    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"]>>;
+    close(): Promise<void>;
+    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/gwolves/hid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/gwolves/hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAyCrD,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,OAAO,CAAC,MAAM,CAKE;IAEhB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAU5B;gBAEU,MAAM,EAAE,SAAS;IAO7B,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAS9C,OAAO,KAAK,OAAO,GAOlB;IAED,cAAc,IAAI,OAAO;IAIzB,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,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;IAY7C,kBAAkB,CAAC,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAQ5H,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAMd,WAAW;YAWX,IAAI;YAOJ,WAAW;YAWX,KAAK;YAOL,QAAQ;IAmBtB,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,MAAM,CAAC,YAAY;CAG5B"}