yjx-sdk-mouse 0.1.0

package/dist/protocol/packet.js

@@ -0,0 +1,294 @@
+import { Command, HANDSHAKE_PAYLOAD, MEMORY_FLAGS, PACKET_SIZE, PAYLOAD_SIZE, PollRateFromIndex, PollRateToIndex, READ_ADDRESS, REPORT_ID, WRITE_ADDRESS, } from '../constants.js';
+export function createPacket(command, payload = []) {
+    const packet = new Uint8Array(PACKET_SIZE);
+    packet[0] = REPORT_ID;
+    packet[1] = command;
+    packet.set(payload, 2);
+    return packet;
+}
+export function getReportId(packet) {
+    return packet[0] ?? REPORT_ID;
+}
+export function getPayload(packet) {
+    return packet.subarray(1, PACKET_SIZE);
+}
+export function createHandshakePacket() {
+    return createPacket(Command.Handshake, [...HANDSHAKE_PAYLOAD]);
+}
+export function createPingPacket() {
+    return createPacket(Command.Ping);
+}
+/**
+ * 原厂 bytesToString：默认仅保留可打印 ASCII（32–126）。
+ * r(bytes) → printableOnly=true；r(bytes, false) → 保留全部字节。
+ */
+function bytesToReportChars(bytes, printableOnly = true) {
+    return bytes
+        .map((byte) => {
+        if (byte < 0 || byte > 255 || !Number.isInteger(byte)) {
+            return null;
+        }
+        if (printableOnly && (byte < 32 || byte > 126)) {
+            return null;
+        }
+        return String.fromCharCode(byte);
+    })
+        .filter((char) => char !== null);
+}
+/**
+ * 解析 Ping(0x04) 上报中的固件版本。
+ * 原厂：r(o.slice(2)).slice(-5).join('')，r() 单参数时仅保留可打印字符。
+ */
+export function parsePingVersionReport(data) {
+    const view = normalizeInputReport(REPORT_ID, data);
+    if (view[0] !== Command.Ping) {
+        return null;
+    }
+    const version = bytesToReportChars(Array.from(view.slice(2)))
+        .slice(-5)
+        .join('');
+    return /^\d+\.\d+\.\d+$/.test(version) ? version : null;
+}
+export function createReadPacket(address, offset, command = Command.ReadBlock) {
+    return createPacket(command, [
+        address & 0xff,
+        (address >> 8) & 0xff,
+        offset,
+        ...MEMORY_FLAGS,
+    ]);
+}
+export function createWritePacket(address, offset, payload) {
+    return createPacket(Command.WriteBlock, [
+        address & 0xff,
+        (address >> 8) & 0xff,
+        offset,
+        ...MEMORY_FLAGS,
+        ...payload,
+    ]);
+}
+export function readDeviceInfoPacket() {
+    return createReadPacket(READ_ADDRESS, 0x2e, Command.ReadBlock);
+}
+export function readConfigPacket() {
+    return createReadPacket(READ_ADDRESS, 0x2c, Command.ReadShort);
+}
+export function readProfilePacket() {
+    return createReadPacket(READ_ADDRESS, 0x2e, Command.ReadRetry);
+}
+/** @deprecated */
+export const readProfileRetryPacket = readProfilePacket;
+export function writeProfilePacket(payload) {
+    return createWritePacket(WRITE_ADDRESS, 0x2f, payload);
+}
+export function isValidResponse(reportId, data) {
+    if (data.length < 1) {
+        return false;
+    }
+    if (reportId === REPORT_ID) {
+        return true;
+    }
+    // 部分设备/抓包层在 reportId=0 时 payload 仍带 0xF0 前缀
+    return reportId === 0 && data[0] === REPORT_ID;
+}
+/**
+ * 统一 Web HID 输入报告格式。
+ * Bus Hound 可见 `F0 0F AE ...` 共 64 字节；浏览器里 reportId 可能与首字节分离或合并。
+ */
+export function normalizeInputReport(_reportId, data) {
+    if (data.length >= 2 && data[0] === REPORT_ID) {
+        return data.subarray(1);
+    }
+    return data;
+}
+export function getResponseCommand(data) {
+    const normalized = normalizeInputReport(REPORT_ID, data);
+    return normalized[0] ?? -1;
+}
+/**
+ * 解析 0xFA 状态上报（原厂 statu 回调）
+ * 抓包：F0 FA 00 23 0A 00 00 00 10 05 04 → 档位 byte[9]=5，回报率 byte[10]=4
+ */
+export function parseStatusReport(data) {
+    const view = normalizeInputReport(REPORT_ID, data);
+    if (view[0] !== Command.StatusReport) {
+        return null;
+    }
+    let dpiByte = view[8] ?? 1;
+    let rateByte = view[9] ?? 1;
+    // byte[8] 常为 0x10 头字段；真实档位在 [9]、回报率在 [10]
+    if (dpiByte > 6 && (view[9] ?? 0) > 0 && (view[9] ?? 0) <= 6) {
+        dpiByte = view[9] ?? 1;
+        rateByte = view[10] ?? 1;
+    }
+    if (dpiByte === 0xd0) {
+        return null;
+    }
+    return {
+        dpiIndex: Math.max(0, dpiByte - 1),
+        pollRateIndex: Math.max(0, rateByte - 1),
+    };
+}
+export function toHex(data, max = PACKET_SIZE) {
+    const bytes = Array.from(data).slice(0, max);
+    return bytes.map((b) => b.toString(16).padStart(2, '0').toUpperCase()).join(' ');
+}
+function readU16(data, offset) {
+    return (data[offset] ?? 0) | ((data[offset + 1] ?? 0) << 8);
+}
+export function validateDpiValue(value) {
+    if (!Number.isFinite(value) || value < 50) {
+        return 50;
+    }
+    if (value > 50000) {
+        return 50000;
+    }
+    return Math.round(value);
+}
+const DEFAULT_DPI_LEVELS = [50, 800, 1200, 1600, 2400, 3200];
+/** AJ159 V2 SE 出厂默认配置（对齐原厂 mouse_info_aj159v2se.json） */
+const FACTORY_DPI_LEVELS = [800, 1600, 2400, 3200, 5000, 12000];
+export function createFactoryDefaultMouseConfig() {
+    return {
+        lightMode: 0,
+        pollRateIndex: 3,
+        dpiCount: 6,
+        currentIndex: 2,
+        dpiLevels: [...FACTORY_DPI_LEVELS],
+        scrollFlag: 0,
+        lodValue: 1,
+        sensorFlag: 53,
+        keyRespond: 8,
+        sleepLight: 10,
+        highspeedMode: 0,
+        statusFlags: 0x10,
+    };
+}
+export function parseMouseConfig(data) {
+    const view = normalizeInputReport(REPORT_ID, data);
+    const dpiCount = view[10] ?? 6;
+    const dpiLevels = Array.from({ length: 6 }, (_, index) => validateDpiValue(readU16(view, 12 + index * 2)));
+    return {
+        lightMode: view[8] ?? 0,
+        pollRateIndex: Math.max(0, (view[9] ?? 1) - 1),
+        dpiCount: dpiCount > 0 ? dpiCount : 6,
+        currentIndex: Math.max(0, (view[11] ?? 1) - 1),
+        dpiLevels,
+        scrollFlag: view[47] ?? 0,
+        lodValue: view[48] ?? 1,
+        sensorFlag: view[49] ?? 53,
+        keyRespond: view[50] ?? 8,
+        sleepLight: view[51] ?? 10,
+        highspeedMode: view[52] ?? 0,
+        statusFlags: view[53] ?? 0x10,
+    };
+}
+/** 构建 0x0F 写配置 payload（对齐原厂 setMouseConfigData，从 packet[8] 起） */
+export function buildMouseConfigWritePayload(config) {
+    const payload = new Array(56).fill(0);
+    payload[0] = 0x00;
+    payload[1] = config.lightMode & 0xff;
+    payload[2] = (config.pollRateIndex + 1) & 0xff;
+    payload[3] = Math.min(Math.max(config.dpiCount, 1), 6);
+    payload[4] = (config.currentIndex + 1) & 0xff;
+    for (let index = 0; index < 6; index++) {
+        const level = validateDpiValue(config.dpiLevels[index] ?? DEFAULT_DPI_LEVELS[index] ?? 800);
+        payload[5 + index * 2] = level & 0xff;
+        payload[6 + index * 2] = (level >> 8) & 0xff;
+    }
+    payload[40] = config.scrollFlag & 0xff;
+    payload[41] = config.lodValue & 0xff;
+    payload[42] = config.sensorFlag & 0xff;
+    payload[43] = config.keyRespond & 0xff;
+    payload[44] = config.sleepLight & 0xff;
+    payload[45] = config.highspeedMode & 0xff;
+    payload[46] = config.statusFlags & 0xff;
+    return payload;
+}
+export function mouseConfigToDpiProfile(config) {
+    return {
+        pollRateIndex: config.pollRateIndex,
+        slotCount: config.dpiCount,
+        currentIndex: config.currentIndex,
+        dpiLevels: config.dpiLevels.slice(0, config.dpiCount),
+    };
+}
+export function mouseConfigToPerformanceSettings(config) {
+    const wakeupFlag = (config.statusFlags >> 4) & 0x0f;
+    return {
+        pollRate: PollRateFromIndex[config.pollRateIndex] ?? 1000,
+        sleepMinutes: config.sleepLight === 0 ? 10 : config.sleepLight,
+        neverSleep: config.sleepLight === 0,
+        scrollReverse: config.scrollFlag === 1,
+        wakeOnMove: wakeupFlag === 1,
+    };
+}
+export function applyPerformanceSettingsToMouseConfig(base, settings) {
+    const wakeupFlag = settings.wakeOnMove ? 1 : 0;
+    const moveLightFlag = base.statusFlags & 0x0f;
+    return {
+        ...base,
+        pollRateIndex: PollRateToIndex[settings.pollRate] ?? base.pollRateIndex,
+        scrollFlag: settings.scrollReverse ? 1 : 0,
+        sleepLight: settings.neverSleep
+            ? 0
+            : Math.max(1, Math.min(100, Math.round(settings.sleepMinutes))),
+        statusFlags: (wakeupFlag << 4) | moveLightFlag,
+    };
+}
+export function dpiProfileToMouseConfig(profile, base) {
+    const pollRate = profile.pollRate;
+    const pollRateIndex = PollRateToIndex[pollRate] ?? base?.pollRateIndex ?? 3;
+    const levels = [...profile.levels];
+    while (levels.length < 6) {
+        levels.push(base?.dpiLevels[levels.length] ?? DEFAULT_DPI_LEVELS[levels.length] ?? 800);
+    }
+    return {
+        lightMode: base?.lightMode ?? 0,
+        pollRateIndex,
+        dpiCount: Math.min(6, Math.max(levels.length, base?.dpiCount ?? 6)),
+        currentIndex: profile.currentIndex,
+        dpiLevels: levels.map(validateDpiValue),
+        scrollFlag: base?.scrollFlag ?? 0,
+        lodValue: base?.lodValue ?? 1,
+        sensorFlag: base?.sensorFlag ?? 53,
+        keyRespond: base?.keyRespond ?? 8,
+        sleepLight: base?.sleepLight ?? 10,
+        highspeedMode: base?.highspeedMode ?? 0,
+        statusFlags: base?.statusFlags ?? 0x10,
+    };
+}
+export function parseConfigResponse(data) {
+    return mouseConfigToDpiProfile(parseMouseConfig(data));
+}
+export function buildProfilePayload(options) {
+    return buildMouseConfigWritePayload({
+        lightMode: 0,
+        pollRateIndex: options.pollRateIndex,
+        dpiCount: Math.min(options.dpiLevels.length, 6) || 6,
+        currentIndex: options.currentIndex,
+        dpiLevels: options.dpiLevels,
+        scrollFlag: 0,
+        lodValue: 1,
+        sensorFlag: 53,
+        keyRespond: 8,
+        sleepLight: 10,
+        highspeedMode: 0,
+        statusFlags: 0x10,
+    });
+}
+/** @deprecated 使用 parseConfigResponse */
+export function parseProfilePayload(data) {
+    const config = parseConfigResponse(data);
+    return {
+        pollRateCode: config.pollRateIndex + 1,
+        slotCount: config.slotCount,
+        currentIndex: config.currentIndex,
+        dpiLevels: config.dpiLevels,
+    };
+}
+export function toPayloadBuffer(packet) {
+    const buffer = new ArrayBuffer(PAYLOAD_SIZE);
+    new Uint8Array(buffer).set(getPayload(packet));
+    return buffer;
+}
+//# sourceMappingURL=packet.js.map

package/dist/protocol/packet.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,127 @@
+export interface DeviceFilterConfig {
+    vendorId: number;
+    productId: number;
+    usagePage: number;
+    usage: number;
+}
+export interface MouseInitOptions {
+    configs: DeviceFilterConfig[];
+    usagePage?: number;
+    usage?: number;
+    /** 单条命令默认超时（毫秒） */
+    timeout?: number;
+}
+export interface MouseDeviceInfo {
+    id: string;
+    vendorId: number;
+    productId: number;
+    productName: string;
+    opened: boolean;
+    raw: HIDDevice;
+}
+export type UsbChangeType = 'connect' | 'disconnect' | 'isUpgrading_connect' | 'isUpgrading_disconnect';
+export interface UsbChangeEvent {
+    type: UsbChangeType;
+    device?: HIDDevice;
+    reconnect?: boolean;
+}
+export type EventHandler<T = unknown> = (data: T) => void;
+/** 鼠标按键切换 DPI / 回报率时的异步上报（命令 0xFA） */
+export interface MouseStatusEvent {
+    /** 当前 DPI 档位（0-based） */
+    dpiIndex: number;
+    /** 回报率档位索引 */
+    pollRateIndex: number;
+    /** 回报率 Hz */
+    pollRate: 125 | 250 | 500 | 1000;
+}
+export interface DeviceInfoPayload {
+    raw: Uint8Array;
+    boardId?: number;
+    /** 固件版本（2.4G 连接时为接收器固件版本） */
+    firmwareVersion?: string;
+    /** 接收器固件版本，与 firmwareVersion 相同 */
+    receiverFirmwareVersion?: string;
+}
+export interface DpiProfile {
+    /** 当前选中档位（0-based） */
+    currentIndex: number;
+    /** 回报率 Hz */
+    pollRate: 125 | 250 | 500 | 1000;
+    /** 各档 DPI 值 */
+    levels: number[];
+}
+export interface PerformanceSettings {
+    pollRate: 125 | 250 | 500 | 1000;
+    sleepMinutes: number;
+    neverSleep: boolean;
+    scrollReverse: boolean;
+    wakeOnMove: boolean;
+}
+export interface ButtonKeyCode {
+    button: 'left' | 'middle' | 'right' | 'back' | 'forward';
+    keyCode: number;
+}
+/** 按键映射槽位（原厂协议 4 字节） */
+export interface MouseKeyMapping {
+    index: number;
+    type: number;
+    code1: number;
+    code2: number;
+    code3: number;
+}
+export type MouseButtonSlot = 'left' | 'right' | 'middle' | 'back' | 'forward';
+export interface KeyPreset {
+    id: string;
+    label: string;
+    type: number;
+    code1: number;
+    code2: number;
+    code3: number;
+}
+export interface ButtonMapping {
+    left: MouseKeyMapping;
+    right: MouseKeyMapping;
+    middle: MouseKeyMapping;
+    back: MouseKeyMapping;
+    forward: MouseKeyMapping;
+}
+export type MacroKeyboardActionName = 'keydown' | 'keyup';
+export type MacroMouseActionName = 'mousedown' | 'mouseup';
+/** 键盘宏动作。keyCode 使用 USB HID Keyboard Usage，例如 A = 0x04。 */
+export interface MacroKeyboardAction {
+    type: 'keyboard';
+    keyCode: number;
+    action: MacroKeyboardActionName;
+    /** 动作执行后的延迟，单位毫秒；省略或设为 0 时按 2ms 写入。 */
+    delay?: number;
+}
+/** 鼠标按键宏动作。 */
+export interface MacroMouseAction {
+    type: 'mouse';
+    button: MouseButtonSlot;
+    action: MacroMouseActionName;
+    /** 动作执行后的延迟，单位毫秒；省略或设为 0 时按 2ms 写入。 */
+    delay?: number;
+}
+export type MacroAction = MacroKeyboardAction | MacroMouseAction;
+/** 单个宏定义；数组中的位置即宏索引，范围为 0..31。 */
+export interface MouseMacro {
+    actions: MacroAction[];
+}
+/**
+ * 宏按键触发模式，对应按键映射协议中的 code3。
+ * 0/2/3/4 为 AJ159 V2 SE 原厂驱动支持的模式值。
+ */
+export type MacroTriggerMode = 0 | 2 | 3 | 4;
+/** 将设备中的宏分配到鼠标按键时使用的选项。 */
+export interface MacroButtonOptions {
+    /** 宏索引，范围为 0..31。 */
+    macroIndex: number;
+    /** 重复次数，对应 code2；默认值为 1。 */
+    repeat?: number;
+    /** 触发模式，对应 code3；默认值为 0。 */
+    triggerMode?: MacroTriggerMode;
+}
+export type MacroProfileIndex = 0 | 1;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/webhid.d.ts

@@ -0,0 +1,51 @@
+export {};
+declare global {
+    interface HIDDeviceFilter {
+        vendorId?: number;
+        productId?: number;
+        usagePage?: number;
+        usage?: number;
+    }
+    interface HIDReportInfo {
+        reportId: number;
+        reportSize?: number;
+    }
+    interface HIDCollectionInfo {
+        usagePage: number;
+        usage: number;
+        inputReports?: HIDReportInfo[];
+        outputReports?: HIDReportInfo[];
+        featureReports?: HIDReportInfo[];
+    }
+    interface HIDDevice {
+        readonly opened: boolean;
+        readonly vendorId: number;
+        readonly productId: number;
+        readonly productName: string;
+        readonly collections: HIDCollectionInfo[];
+        open(): Promise<void>;
+        close(): Promise<void>;
+        sendReport(reportId: number, data: BufferSource): Promise<void>;
+        addEventListener(type: 'inputreport', listener: (event: HIDInputReportEvent) => void, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener(type: 'inputreport', listener: (event: HIDInputReportEvent) => void, options?: boolean | EventListenerOptions): void;
+    }
+    interface HIDInputReportEvent extends Event {
+        readonly data: DataView;
+        readonly device: HIDDevice;
+        readonly reportId: number;
+    }
+    interface HID {
+        getDevices(): Promise<HIDDevice[]>;
+        requestDevice(options: {
+            filters: HIDDeviceFilter[];
+        }): Promise<HIDDevice[]>;
+        addEventListener(type: 'connect' | 'disconnect', listener: (event: HIDConnectionEvent) => void, options?: boolean | AddEventListenerOptions): void;
+    }
+    interface HIDConnectionEvent extends Event {
+        readonly device: HIDDevice;
+    }
+    interface Navigator {
+        readonly hid: HID;
+    }
+}
+//# sourceMappingURL=webhid.d.ts.map

package/dist/webhid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhid.d.ts","sourceRoot":"","sources":["../src/webhid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC;AAEV,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,eAAe;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;IAED,UAAU,aAAa;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAED,UAAU,iBAAiB;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC;QAC/B,aAAa,CAAC,EAAE,aAAa,EAAE,CAAC;QAChC,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;KAClC;IAED,UAAU,SAAS;QACjB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,WAAW,EAAE,iBAAiB,EAAE,CAAC;QAC1C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAChE,gBAAgB,CACd,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,EAC9C,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC1C,IAAI,CAAC;QACR,mBAAmB,CACjB,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,EAC9C,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,GACvC,IAAI,CAAC;KACT;IAED,UAAU,mBAAoB,SAAQ,KAAK;QACzC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;QAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B;IAED,UAAU,GAAG;QACX,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QACnC,aAAa,CAAC,OAAO,EAAE;YAAE,OAAO,EAAE,eAAe,EAAE,CAAA;SAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7E,gBAAgB,CACd,IAAI,EAAE,SAAS,GAAG,YAAY,EAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,EAC7C,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC1C,IAAI,CAAC;KACT;IAED,UAAU,kBAAmB,SAAQ,KAAK;QACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;KAC5B;IAED,UAAU,SAAS;QACjB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;KACnB;CACF"}

package/dist/webhid.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=webhid.js.map

package/dist/webhid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhid.js","sourceRoot":"","sources":["../src/webhid.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "yjx-sdk-mouse",
+  "version": "0.1.0",
+  "description": "永佳新鼠标 WebHID SDK，支持 DPI、回报率、按键映射和宏配置",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "webhid",
+    "hid",
+    "mouse",
+    "sdk",
+    "dpi",
+    "macro"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "prepack": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.2"
+  }
+}