@openmouse/protocol 0.1.0

package/dist/endgame-gear/wireless.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Pure Endgame Gear WE-series (OP1we) profile protocol helpers.
+ * Used by EggWeHidClient and unit-tested without WebHID.
+ *
+ * Framing: feature report id 0x08, 16-byte payload, full report sum == 0x55.
+ * ReadEEPROM cmd 0x08 / WriteEEPROM cmd 0x07 — body [0, hi, lo, len, data…].
+ */
+export declare const WE_REPORT_ID = 8;
+export declare const WE_PAYLOAD_LEN = 16;
+export declare const WE_CHECKSUM_TARGET = 85;
+export declare const WE_CMD_GET_POWER = 4;
+export declare const WE_CMD_READ_EEPROM = 8;
+export declare const WE_CMD_WRITE_EEPROM = 7;
+export declare const WE_CMD_GET_CONNECT = 3;
+export declare const WE_CMD_GET_CUR_PROFILE = 14;
+export declare const WE_MAX_EEPROM_CHUNK = 8;
+/** Profile map (NOTES.md / OEM GetProfile logs). */
+export declare const WE_OFF: {
+    /**
+     * Header value+crc pairs (live dump: 01 54 | 04 51 | 01 54 | … | 02 53).
+     * Report-rate was briefly mis-mapped to 0x04, which is DEFLEVEL — writing “Hz”
+     * changed the active CPI stage. Correct map:
+     */
+    /** Report-rate divider: 8→125, 4→250, 2→500, 1→1000 Hz (OEM max 1000). */
+    readonly reportRate: 0;
+    readonly dpiStageCount: 2;
+    readonly activeDpiLevel: 4;
+    readonly lod: 10;
+    readonly dpiStages: 12;
+    readonly dpiStageBytes: 4;
+    readonly maxDpiStages: 8;
+    readonly debounce: 169;
+    readonly sleep: 173;
+};
+/** OEM-style rates only (upper bound 1000 Hz — no 2K/4K/8K). */
+export declare const WE_POLLING_RATES: readonly [125, 250, 500, 1000];
+export type WePollingRate = (typeof WE_POLLING_RATES)[number];
+export type WeLod = "Medium" | "High";
+export interface WeDpiStage {
+    x: number;
+    y: number;
+    flags: number;
+}
+export interface WeProfile {
+    activeDpiLevel: number;
+    dpiStageCount: number;
+    pollingRateHz: number;
+    lod: WeLod | null;
+    lodRaw: number | null;
+    debounceMs: number | null;
+    sleepRaw: number | null;
+    stages: WeDpiStage[];
+    /** Active stage CPI (X axis). */
+    dpi: number;
+}
+/** Sum of reportId + first 15 payload bytes; last payload byte is checksum. */
+export declare function weReportChecksum(reportId: number, data15: readonly number[]): number;
+/** Build 16-byte WebHID feature payload (no report id). */
+export declare function weBuildCmdPayload(cmd: number, dataAfterCmd?: readonly number[]): Uint8Array;
+export declare function weBuildReadEepromPayload(addr: number, length: number): Uint8Array;
+export declare function weBuildWriteEepromPayload(addr: number, data: readonly number[]): Uint8Array;
+/**
+ * Parse input report 9 body (WebHID omits report id).
+ * ReadEEPROM success: [cmd, status, 0, addr_lo, len, data…]
+ */
+export declare function weParseReadEepromResponse(response: Uint8Array, expectedAddr: number, expectedLen: number): Uint8Array | null;
+/** WriteEEPROM ACK: status 0 and optional echo. */
+export declare function weParseWriteEepromResponse(response: Uint8Array): boolean;
+export declare function weScalarCrc(value: number): number;
+export declare function wePackScalarPair(value: number): [number, number];
+export declare function weUnpackScalarPair(value: number, crc: number): number | null;
+/** CPI ↔ stage byte: cpi = (byte + 1) * 50  (50…12800). */
+export declare function weCpiToByte(cpi: number): number;
+export declare function weByteToCpi(byte: number): number;
+export declare function weStageCrc(x: number, y: number, flags: number): number;
+export declare function wePackDpiStage(xCpi: number, yCpi: number, flags?: number): Uint8Array;
+export declare function weUnpackDpiStage(bytes: Uint8Array | readonly number[]): WeDpiStage | null;
+export declare function weEncodeLod(value: WeLod): number;
+export declare function weDecodeLod(raw: number): WeLod | null;
+/** Divider byte → Hz (1=1000, 2=500, 4=250, 8=125). */
+export declare function weDecodeReportRate(raw: number): number | null;
+export declare function weEncodeReportRate(hz: number): number;
+export declare function weIsValidPollingRate(hz: number): hz is WePollingRate;
+/**
+ * Decode a contiguous profile memory image starting at address 0
+ * (at least through 0xB4 for full basics).
+ */
+export declare function weDecodeProfile(mem: Uint8Array): WeProfile;
+/** Patch only the selected DPI stage, preserving its protocol flags. */
+export declare function wePatchActiveDpi(mem: Uint8Array, cpi: number, activeLevel: number): void;
+export declare function wePatchScalar(mem: Uint8Array, addr: number, value: number): void;
+export declare function weIsValidCpi(cpi: number): boolean;
+//# sourceMappingURL=wireless.d.ts.map

package/dist/endgame-gear/wireless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wireless.d.ts","sourceRoot":"","sources":["../../src/endgame-gear/wireless.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,YAAY,IAAO,CAAC;AACjC,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,kBAAkB,KAAO,CAAC;AACvC,eAAO,MAAM,gBAAgB,IAAO,CAAC;AACrC,eAAO,MAAM,kBAAkB,IAAO,CAAC;AACvC,eAAO,MAAM,mBAAmB,IAAO,CAAC;AACxC,eAAO,MAAM,kBAAkB,IAAO,CAAC;AACvC,eAAO,MAAM,sBAAsB,KAAO,CAAC;AAC3C,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,oDAAoD;AACpD,eAAO,MAAM,MAAM;IACjB;;;;OAIG;IACH,0EAA0E;;;;;;;;;;CAUlE,CAAC;AAEX,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,gCAAiC,CAAC;AAC/D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtC,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAIpF;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,SAAS,MAAM,EAAO,GAAG,UAAU,CAS/F;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAUjF;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAU3F;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,UAAU,EACpB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,UAAU,GAAG,IAAI,CASnB;AAED,mDAAmD;AACnD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAKxE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAGhE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG5E;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,UAAU,CAKhF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,MAAM,EAAE,GAAG,UAAU,GAAG,IAAI,CAQzF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAIhD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAIrD;AAED,uDAAuD;AACvD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7D;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,aAAa,CAEpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,CAyC1D;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CASxF;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIhF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/endgame-gear/wireless.js

@@ -0,0 +1,242 @@
+/**
+ * Pure Endgame Gear WE-series (OP1we) profile protocol helpers.
+ * Used by EggWeHidClient and unit-tested without WebHID.
+ *
+ * Framing: feature report id 0x08, 16-byte payload, full report sum == 0x55.
+ * ReadEEPROM cmd 0x08 / WriteEEPROM cmd 0x07 — body [0, hi, lo, len, data…].
+ */
+export const WE_REPORT_ID = 0x08;
+export const WE_PAYLOAD_LEN = 16;
+export const WE_CHECKSUM_TARGET = 0x55;
+export const WE_CMD_GET_POWER = 0x04;
+export const WE_CMD_READ_EEPROM = 0x08;
+export const WE_CMD_WRITE_EEPROM = 0x07;
+export const WE_CMD_GET_CONNECT = 0x03;
+export const WE_CMD_GET_CUR_PROFILE = 0x0e;
+export const WE_MAX_EEPROM_CHUNK = 8;
+/** Profile map (NOTES.md / OEM GetProfile logs). */
+export const WE_OFF = {
+    /**
+     * Header value+crc pairs (live dump: 01 54 | 04 51 | 01 54 | … | 02 53).
+     * Report-rate was briefly mis-mapped to 0x04, which is DEFLEVEL — writing “Hz”
+     * changed the active CPI stage. Correct map:
+     */
+    /** Report-rate divider: 8→125, 4→250, 2→500, 1→1000 Hz (OEM max 1000). */
+    reportRate: 0x00,
+    dpiStageCount: 0x02, // DM
+    activeDpiLevel: 0x04, // DEFLEVEL — which CPI stage is active (not report rate!)
+    lod: 0x0a, // 1=Medium, 2=High
+    dpiStages: 0x0c, // 8 × 4-byte stages
+    dpiStageBytes: 4,
+    maxDpiStages: 8,
+    debounce: 0xa9, // ms
+    sleep: 0xad, // raw; OEM displays raw*10
+};
+/** OEM-style rates only (upper bound 1000 Hz — no 2K/4K/8K). */
+export const WE_POLLING_RATES = [125, 250, 500, 1000];
+/** Sum of reportId + first 15 payload bytes; last payload byte is checksum. */
+export function weReportChecksum(reportId, data15) {
+    let sum = reportId;
+    for (const byte of data15)
+        sum += byte & 0xff;
+    return (WE_CHECKSUM_TARGET - (sum & 0xff)) & 0xff;
+}
+/** Build 16-byte WebHID feature payload (no report id). */
+export function weBuildCmdPayload(cmd, dataAfterCmd = []) {
+    const payload = new Uint8Array(WE_PAYLOAD_LEN);
+    payload[0] = cmd & 0xff;
+    for (let i = 0; i < Math.min(14, dataAfterCmd.length); i += 1) {
+        payload[i + 1] = dataAfterCmd[i] & 0xff;
+    }
+    const data15 = [...payload.subarray(0, 15)];
+    payload[15] = weReportChecksum(WE_REPORT_ID, data15);
+    return payload;
+}
+export function weBuildReadEepromPayload(addr, length) {
+    if (!Number.isInteger(length) || length < 1 || length > WE_MAX_EEPROM_CHUNK) {
+        throw new Error(`WE ReadEEPROM length must be 1–${WE_MAX_EEPROM_CHUNK}.`);
+    }
+    if (!Number.isInteger(addr) || addr < 0 || addr > 0xffff) {
+        throw new Error("WE EEPROM address out of range.");
+    }
+    const hi = (addr >> 8) & 0xff;
+    const lo = addr & 0xff;
+    return weBuildCmdPayload(WE_CMD_READ_EEPROM, [0, hi, lo, length]);
+}
+export function weBuildWriteEepromPayload(addr, data) {
+    if (data.length < 1 || data.length > WE_MAX_EEPROM_CHUNK) {
+        throw new Error(`WE WriteEEPROM length must be 1–${WE_MAX_EEPROM_CHUNK}.`);
+    }
+    if (!Number.isInteger(addr) || addr < 0 || addr > 0xffff) {
+        throw new Error("WE EEPROM address out of range.");
+    }
+    const hi = (addr >> 8) & 0xff;
+    const lo = addr & 0xff;
+    return weBuildCmdPayload(WE_CMD_WRITE_EEPROM, [0, hi, lo, data.length, ...data.map((b) => b & 0xff)]);
+}
+/**
+ * Parse input report 9 body (WebHID omits report id).
+ * ReadEEPROM success: [cmd, status, 0, addr_lo, len, data…]
+ */
+export function weParseReadEepromResponse(response, expectedAddr, expectedLen) {
+    let data = response;
+    if (data.length > 0 && data[0] === 0x09)
+        data = data.subarray(1);
+    if (data.length < 5 + expectedLen)
+        return null;
+    if (data[0] !== WE_CMD_READ_EEPROM)
+        return null;
+    if (data[1] !== 0)
+        return null;
+    if (data[3] !== (expectedAddr & 0xff))
+        return null;
+    if (data[4] !== expectedLen)
+        return null;
+    return data.subarray(5, 5 + expectedLen);
+}
+/** WriteEEPROM ACK: status 0 and optional echo. */
+export function weParseWriteEepromResponse(response) {
+    let data = response;
+    if (data.length > 0 && data[0] === 0x09)
+        data = data.subarray(1);
+    if (data.length < 2)
+        return false;
+    return data[0] === WE_CMD_WRITE_EEPROM && data[1] === 0;
+}
+export function weScalarCrc(value) {
+    return (WE_CHECKSUM_TARGET - (value & 0xff)) & 0xff;
+}
+export function wePackScalarPair(value) {
+    const v = value & 0xff;
+    return [v, weScalarCrc(v)];
+}
+export function weUnpackScalarPair(value, crc) {
+    if (weScalarCrc(value) !== (crc & 0xff))
+        return null;
+    return value & 0xff;
+}
+/** CPI ↔ stage byte: cpi = (byte + 1) * 50  (50…12800). */
+export function weCpiToByte(cpi) {
+    if (!Number.isInteger(cpi) || cpi < 50 || cpi > 12800 || cpi % 50 !== 0) {
+        throw new Error("WE CPI must be 50–12,800 in steps of 50.");
+    }
+    return cpi / 50 - 1;
+}
+export function weByteToCpi(byte) {
+    return ((byte & 0xff) + 1) * 50;
+}
+export function weStageCrc(x, y, flags) {
+    return (WE_CHECKSUM_TARGET - ((x + y + flags) & 0xff)) & 0xff;
+}
+export function wePackDpiStage(xCpi, yCpi, flags = 0) {
+    const x = weCpiToByte(xCpi);
+    const y = weCpiToByte(yCpi);
+    const f = flags & 0xff;
+    return new Uint8Array([x, y, f, weStageCrc(x, y, f)]);
+}
+export function weUnpackDpiStage(bytes) {
+    if (bytes.length < 4)
+        return null;
+    const x = bytes[0] & 0xff;
+    const y = bytes[1] & 0xff;
+    const flags = bytes[2] & 0xff;
+    const crc = bytes[3] & 0xff;
+    if (weStageCrc(x, y, flags) !== crc)
+        return null;
+    return { x: weByteToCpi(x), y: weByteToCpi(y), flags };
+}
+export function weEncodeLod(value) {
+    if (value === "Medium")
+        return 1;
+    if (value === "High")
+        return 2;
+    throw new Error("OP1we LOD supports Medium (1 mm class) or High only.");
+}
+export function weDecodeLod(raw) {
+    if (raw === 1)
+        return "Medium";
+    if (raw === 2)
+        return "High";
+    return null;
+}
+/** Divider byte → Hz (1=1000, 2=500, 4=250, 8=125). */
+export function weDecodeReportRate(raw) {
+    const map = { 1: 1000, 2: 500, 4: 250, 8: 125 };
+    return map[raw & 0xff] ?? null;
+}
+export function weEncodeReportRate(hz) {
+    const map = { 1000: 1, 500: 2, 250: 4, 125: 8 };
+    if (!(hz in map)) {
+        throw new Error("OP1we supports 125, 250, 500, or 1000 Hz report rate.");
+    }
+    return map[hz];
+}
+export function weIsValidPollingRate(hz) {
+    return WE_POLLING_RATES.includes(hz);
+}
+/**
+ * Decode a contiguous profile memory image starting at address 0
+ * (at least through 0xB4 for full basics).
+ */
+export function weDecodeProfile(mem) {
+    const pair = (addr) => {
+        if (mem.length < addr + 2)
+            return null;
+        return weUnpackScalarPair(mem[addr], mem[addr + 1]);
+    };
+    const activeDpiLevel = pair(WE_OFF.activeDpiLevel) ?? 0;
+    let dpiStageCount = pair(WE_OFF.dpiStageCount) ?? 1;
+    dpiStageCount = Math.min(Math.max(dpiStageCount, 1), WE_OFF.maxDpiStages);
+    const rateRaw = pair(WE_OFF.reportRate);
+    const pollingRateHz = rateRaw !== null ? (weDecodeReportRate(rateRaw) ?? 1000) : 1000;
+    const lodRaw = pair(WE_OFF.lod);
+    const debounceMs = pair(WE_OFF.debounce);
+    const sleepRaw = pair(WE_OFF.sleep);
+    const stages = [];
+    for (let i = 0; i < WE_OFF.maxDpiStages; i += 1) {
+        const off = WE_OFF.dpiStages + i * WE_OFF.dpiStageBytes;
+        if (mem.length < off + 4)
+            break;
+        const stage = weUnpackDpiStage(mem.subarray(off, off + 4));
+        if (stage)
+            stages.push(stage);
+        else
+            stages.push({ x: 800, y: 800, flags: 0 });
+    }
+    const level = Math.min(Math.max(activeDpiLevel, 0), Math.max(stages.length - 1, 0));
+    const active = stages[level] ?? stages[0];
+    const dpi = active?.x ?? 800;
+    return {
+        activeDpiLevel: level,
+        dpiStageCount,
+        pollingRateHz,
+        lod: lodRaw !== null ? weDecodeLod(lodRaw) : null,
+        lodRaw,
+        debounceMs,
+        sleepRaw,
+        stages,
+        dpi,
+    };
+}
+/** Patch only the selected DPI stage, preserving its protocol flags. */
+export function wePatchActiveDpi(mem, cpi, activeLevel) {
+    if (!Number.isInteger(activeLevel) || activeLevel < 0 || activeLevel >= WE_OFF.maxDpiStages) {
+        throw new Error("WE active DPI stage is out of range.");
+    }
+    const off = WE_OFF.dpiStages + activeLevel * WE_OFF.dpiStageBytes;
+    if (mem.length < off + WE_OFF.dpiStageBytes)
+        throw new Error("WE profile is missing the active DPI stage.");
+    const existing = weUnpackDpiStage(mem.subarray(off, off + WE_OFF.dpiStageBytes));
+    if (!existing)
+        throw new Error("WE active DPI stage checksum is invalid.");
+    mem.set(wePackDpiStage(cpi, cpi, existing.flags), off);
+}
+export function wePatchScalar(mem, addr, value) {
+    const [v, c] = wePackScalarPair(value);
+    mem[addr] = v;
+    mem[addr + 1] = c;
+}
+export function weIsValidCpi(cpi) {
+    return Number.isInteger(cpi) && cpi >= 50 && cpi <= 12800 && cpi % 50 === 0;
+}
+//# sourceMappingURL=wireless.js.map

package/dist/endgame-gear/wireless.js.map

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

package/dist/fantech/index.d.ts

@@ -0,0 +1,9 @@
+export interface FantechProduct {
+    model: string;
+    wireless: boolean;
+    pollingRates: readonly number[];
+    maxDpi?: number;
+}
+export declare const FANTECH_VENDOR_ID = 12625;
+export declare const FANTECH_PRODUCTS: ReadonlyMap<number, FantechProduct>;
+//# sourceMappingURL=index.d.ts.map

package/dist/fantech/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fantech/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAO/D,CAAC"}

package/dist/fantech/index.js

@@ -0,0 +1,11 @@
+const RATES_8K = [125, 250, 500, 1000, 2000, 4000, 8000];
+export const FANTECH_VENDOR_ID = 0x3151;
+export const FANTECH_PRODUCTS = new Map([
+    [0x503d, {
+            model: "WG14P Yari Pro Wireless 8K Gaming Mouse",
+            wireless: true,
+            pollingRates: RATES_8K,
+            maxDpi: 42000,
+        }],
+]);
+//# sourceMappingURL=index.js.map

package/dist/fantech/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fantech/index.ts"],"names":[],"mappings":"AAOA,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAElE,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAExC,MAAM,CAAC,MAAM,gBAAgB,GAAwC,IAAI,GAAG,CAAC;IAC3E,CAAC,MAAM,EAAE;YACP,KAAK,EAAE,yCAAyC;YAChD,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,QAAQ;YACtB,MAAM,EAAE,KAAK;SACd,CAAC;CACH,CAAC,CAAC"}

package/dist/finalmouse/index.d.ts

@@ -0,0 +1,41 @@
+export declare const FINALMOUSE_REPORT: {
+    readonly dongle: 2;
+    readonly dongleInput: 3;
+    readonly main: 4;
+    readonly mainInput: 5;
+};
+export declare const FINALMOUSE_COMMAND: {
+    readonly dpi: 16;
+    readonly pollingRate: 17;
+    readonly motionSync: 18;
+    readonly dongleLed: 20;
+    readonly liftOffDistance: 21;
+    readonly tournamentScrollMode: 23;
+    readonly tournamentScrollTimeout: 24;
+    readonly wakeAll: 96;
+    readonly dongleInfo: 10;
+};
+export interface FinalmouseTelemetry {
+    dpi?: number;
+    pollingRateHz?: number;
+    batteryVoltageMv?: number;
+    batteryPercent?: number;
+    rssiDbm?: number;
+    liftOffDistanceMm?: number;
+    motionSync?: boolean;
+    dongleLedMode?: number;
+    tournamentScrollMode?: number;
+    tournamentScrollTimeoutMs?: number;
+    chargingState?: number;
+    mouseFirmware?: string;
+    dongleRfFirmware?: string;
+    dongleUsbFirmware?: string;
+    mouseSerial?: string;
+}
+/** Build xpanel's 63-byte WebHID payload. The browser supplies reportId separately. */
+export declare function buildFinalmouseReport(command: number, payload?: Uint8Array<ArrayBuffer>): Uint8Array;
+/** Decode one WebHID input payload after the browser has removed the report ID. */
+export declare function decodeFinalmouseReport(reportId: number, data: Uint8Array): Partial<FinalmouseTelemetry> | null;
+/** Finalmouse's ULX battery-voltage calibration curve from xpanel. */
+export declare function finalmouseBatteryPercent(millivolts: number): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/finalmouse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/finalmouse/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;;;;;;;;CAUrB,CAAC;AAIX,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,0BAAmB,GAAG,UAAU,CAS7F;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,CA2C9G;AAED,sEAAsE;AACtE,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAenE"}

package/dist/finalmouse/index.js

@@ -0,0 +1,106 @@
+export const FINALMOUSE_REPORT = {
+    dongle: 0x02,
+    dongleInput: 0x03,
+    main: 0x04,
+    mainInput: 0x05,
+};
+export const FINALMOUSE_COMMAND = {
+    dpi: 16,
+    pollingRate: 17,
+    motionSync: 18,
+    dongleLed: 20,
+    liftOffDistance: 21,
+    tournamentScrollMode: 23,
+    tournamentScrollTimeout: 24,
+    wakeAll: 96,
+    dongleInfo: 10,
+};
+const OUTPUT_REPORT_LENGTH = 63;
+/** Build xpanel's 63-byte WebHID payload. The browser supplies reportId separately. */
+export function buildFinalmouseReport(command, payload = new Uint8Array()) {
+    if (!Number.isInteger(command) || command < 0 || command > 0x7f)
+        throw new Error("Invalid Finalmouse command.");
+    if (payload.length > OUTPUT_REPORT_LENGTH - 3)
+        throw new Error("Finalmouse command payload is too large.");
+    const report = new Uint8Array(OUTPUT_REPORT_LENGTH);
+    report[0] = 2 + payload.length;
+    report[1] = 0x80 | command;
+    report[2] = payload.length;
+    report.set(payload, 3);
+    return report;
+}
+/** Decode one WebHID input payload after the browser has removed the report ID. */
+export function decodeFinalmouseReport(reportId, data) {
+    if ((reportId !== FINALMOUSE_REPORT.dongleInput && reportId !== FINALMOUSE_REPORT.mainInput) || data.length < 3)
+        return null;
+    const innerLength = Math.min(data[0] ?? 0, data.length - 1);
+    const body = data.subarray(1, innerLength + 1);
+    if (body.length < 2)
+        return null;
+    const command = body[0] ?? -1;
+    const payloadLength = Math.min(body[1] ?? 0, Math.max(0, body.length - 2));
+    const payload = body.subarray(2, 2 + payloadLength);
+    if (reportId === FINALMOUSE_REPORT.dongleInput) {
+        return command === FINALMOUSE_COMMAND.dongleInfo
+            ? { dongleUsbFirmware: decodeAscii(payload, payloadLength - 1) }
+            : null;
+    }
+    switch (command) {
+        case 3: {
+            const dpi = u16le(payload);
+            return dpi === null ? null : { dpi };
+        }
+        case 4: {
+            const pollingRateHz = u16le(payload);
+            return pollingRateHz === null ? null : { pollingRateHz };
+        }
+        case 5: {
+            const millivolts = u16le(payload);
+            return millivolts === null ? null : {
+                batteryVoltageMv: millivolts,
+                batteryPercent: finalmouseBatteryPercent(millivolts),
+            };
+        }
+        case 11: return { dongleRfFirmware: decodeAscii(payload, payloadLength - 1) };
+        case 12: return { mouseFirmware: decodeAscii(payload, payloadLength - 1) };
+        case 13: return payload.length < 1 ? null : { rssiDbm: payload[0] > 127 ? payload[0] - 256 : payload[0] };
+        case 14: return { mouseSerial: decodeAscii(payload, payloadLength - 1) };
+        case 18: return payload.length < 1 ? null : { motionSync: payload[0] === 1 };
+        case 20: return payload.length < 1 ? null : { dongleLedMode: payload[0] };
+        case 21: return payload.length < 1 ? null : { liftOffDistanceMm: payload[0] };
+        case 23: return payload.length < 1 ? null : { tournamentScrollMode: payload[0] };
+        case 24: return payload.length < 1 ? null : { tournamentScrollTimeoutMs: payload[0] * 100 };
+        case 37: return payload.length < 1 ? null : { chargingState: payload[0] };
+        default: return null;
+    }
+}
+/** Finalmouse's ULX battery-voltage calibration curve from xpanel. */
+export function finalmouseBatteryPercent(millivolts) {
+    if (millivolts <= 0)
+        return 0;
+    const voltage = millivolts / 1000;
+    const voltages = [3, 3.62, 3.66, 3.74, 3.88, 4.17, 4.38];
+    const percentages = [0.2, 5, 10, 25, 50, 75, 100];
+    if (voltage >= voltages.at(-1))
+        return 100;
+    if (voltage <= voltages[0])
+        return 0;
+    for (let index = 0; index < voltages.length - 1; index += 1) {
+        const low = voltages[index];
+        const high = voltages[index + 1];
+        if (voltage < low || voltage > high)
+            continue;
+        const fraction = (voltage - low) / (high - low);
+        return Math.round(percentages[index] + (percentages[index + 1] - percentages[index]) * fraction);
+    }
+    return 0;
+}
+function u16le(payload) {
+    return payload.length < 2 ? null : payload[0] | (payload[1] << 8);
+}
+function decodeAscii(payload, length) {
+    if (length <= 0)
+        return "";
+    return new TextDecoder("ascii").decode(payload.subarray(0, Math.min(length, payload.length))).replace(/[\0 ]+$/, "");
+}
+//# sourceMappingURL=index.js.map

package/dist/finalmouse/index.js.map

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