@ac-kit/format-hid 0.0.0-stage → 0.1.0

package/dist/field/hid-logical-to-physical.js

@@ -0,0 +1,27 @@
+/**
+ * Converts a logical value to the physical quantity it measures, in the field's
+ * unit: the linear map from the logical range onto the physical range, scaled
+ * by `10 ** unitExponent` (HID 1.11 §6.2.2.7).
+ *
+ * The result is a real number; {@link decodeHidUnit} names its unit. A value
+ * outside the logical range — a null value — is extrapolated, not rejected.
+ *
+ * @returns `NaN` when the logical range is a single value, which leaves the
+ *   scale undefined.
+ */
+export function hidLogicalToPhysical(field, value) {
+    const logicalSpan = field.logicalMaximum - field.logicalMinimum;
+    if (logicalSpan === 0) {
+        return Number.NaN;
+    }
+    const physical = field.physicalMinimum +
+        ((value - field.logicalMinimum) *
+            (field.physicalMaximum - field.physicalMinimum)) /
+            logicalSpan;
+    // Dividing by 10^k keeps 3 × 10^-1 at 0.3, where multiplying by 0.1 does not.
+    if (field.unitExponent < 0) {
+        return physical / 10 ** -field.unitExponent;
+    }
+    return physical * 10 ** field.unitExponent;
+}
+//# sourceMappingURL=hid-logical-to-physical.js.map

package/dist/field/hid-logical-to-physical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hid-logical-to-physical.js","sourceRoot":"","sources":["../../src/field/hid-logical-to-physical.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CACnC,KAOC,EACD,KAAa;IAEb,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;IAChE,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,GAAG,CAAC;IACnB,CAAC;IAED,MAAM,QAAQ,GACb,KAAK,CAAC,eAAe;QACrB,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC;YAC9B,CAAC,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;YAChD,WAAW,CAAC;IAEd,8EAA8E;IAC9E,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,QAAQ,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;IAC7C,CAAC;IAED,OAAO,QAAQ,GAAG,EAAE,IAAI,KAAK,CAAC,YAAY,CAAC;AAC5C,CAAC"}

package/dist/field/read-hid-field-value.d.ts

@@ -0,0 +1,18 @@
+import type { HidFieldLayout } from "./hid-field-layout.js";
+/**
+ * Reads value `index` of a field out of a report as transferred — Report ID
+ * byte included when the descriptor uses them.
+ *
+ * Values are packed little-endian, least significant bit first (HID 1.11 §5.8).
+ * A field whose `logicalMinimum` is negative is signed and its values are
+ * sign-extended; any other field reads unsigned.
+ *
+ * The result is the logical value; {@link hidLogicalToPhysical} converts it.
+ *
+ * O(1) time and memory.
+ *
+ * @throws {RangeError} When `bitSize` is not 1–32, `index` is not in `0 ≤ index
+ *   < count`, or the value lies past the end of `report`.
+ */
+export declare function readHidFieldValue(report: Uint8Array, field: HidFieldLayout, index: number): number;
+//# sourceMappingURL=read-hid-field-value.d.ts.map

package/dist/field/read-hid-field-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-hid-field-value.d.ts","sourceRoot":"","sources":["../../src/field/read-hid-field-value.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,MAAM,GACX,MAAM,CAyBR"}

package/dist/field/read-hid-field-value.js

@@ -0,0 +1,35 @@
+import { fieldValueBitPosition_ } from "./_field-value-bit-position.js";
+/**
+ * Reads value `index` of a field out of a report as transferred — Report ID
+ * byte included when the descriptor uses them.
+ *
+ * Values are packed little-endian, least significant bit first (HID 1.11 §5.8).
+ * A field whose `logicalMinimum` is negative is signed and its values are
+ * sign-extended; any other field reads unsigned.
+ *
+ * The result is the logical value; {@link hidLogicalToPhysical} converts it.
+ *
+ * O(1) time and memory.
+ *
+ * @throws {RangeError} When `bitSize` is not 1–32, `index` is not in `0 ≤ index
+ *   < count`, or the value lies past the end of `report`.
+ */
+export function readHidFieldValue(report, field, index) {
+    const { bitSize } = field;
+    let position = fieldValueBitPosition_(report, field, index, "readHidFieldValue");
+    let value = 0;
+    let bitsRead = 0;
+    while (bitsRead < bitSize) {
+        const shift = position & 7;
+        const take = Math.min(8 - shift, bitSize - bitsRead);
+        const bits = (report[position >>> 3] >>> shift) & ((1 << take) - 1);
+        value += bits * 2 ** bitsRead;
+        bitsRead += take;
+        position += take;
+    }
+    if (field.logicalMinimum < 0 && value >= 2 ** (bitSize - 1)) {
+        return value - 2 ** bitSize;
+    }
+    return value;
+}
+//# sourceMappingURL=read-hid-field-value.js.map

package/dist/field/read-hid-field-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-hid-field-value.js","sourceRoot":"","sources":["../../src/field/read-hid-field-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAChC,MAAkB,EAClB,KAAqB,EACrB,KAAa;IAEb,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC1B,IAAI,QAAQ,GAAG,sBAAsB,CACpC,MAAM,EACN,KAAK,EACL,KAAK,EACL,mBAAmB,CACnB,CAAC;IAEF,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,OAAO,QAAQ,GAAG,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAE,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,QAAQ,CAAC;QAC9B,QAAQ,IAAI,IAAI,CAAC;QACjB,QAAQ,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,cAAc,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC;QAC7D,OAAO,KAAK,GAAG,CAAC,IAAI,OAAO,CAAC;IAC7B,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/field/write-hid-field-value-in-place.d.ts

@@ -0,0 +1,18 @@
+import type { HidFieldLayout } from "./hid-field-layout.js";
+/**
+ * Writes value `index` of a field into a report as transferred, leaving every
+ * other bit of `report` untouched. The counterpart of {@link readHidFieldValue},
+ * with the same signedness rule: a field whose `logicalMinimum` is negative
+ * takes two's-complement values.
+ *
+ * `value` is checked against the bit width, not the logical range, so a null
+ * value outside `logicalMinimum`–`logicalMaximum` can still be written.
+ *
+ * O(1) time and memory.
+ *
+ * @throws {RangeError} When `bitSize` is not 1–32, `index` is not in `0 ≤ index
+ *   < count`, the value lies past the end of `report`, or `value` is not an
+ *   integer that fits `bitSize` bits of the field's signedness.
+ */
+export declare function writeHidFieldValueInPlace(report: Uint8Array, field: HidFieldLayout, index: number, value: number): void;
+//# sourceMappingURL=write-hid-field-value-in-place.d.ts.map

package/dist/field/write-hid-field-value-in-place.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-hid-field-value-in-place.d.ts","sourceRoot":"","sources":["../../src/field/write-hid-field-value-in-place.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACX,IAAI,CAgCN"}

package/dist/field/write-hid-field-value-in-place.js

@@ -0,0 +1,41 @@
+import { fieldValueBitPosition_ } from "./_field-value-bit-position.js";
+/**
+ * Writes value `index` of a field into a report as transferred, leaving every
+ * other bit of `report` untouched. The counterpart of {@link readHidFieldValue},
+ * with the same signedness rule: a field whose `logicalMinimum` is negative
+ * takes two's-complement values.
+ *
+ * `value` is checked against the bit width, not the logical range, so a null
+ * value outside `logicalMinimum`–`logicalMaximum` can still be written.
+ *
+ * O(1) time and memory.
+ *
+ * @throws {RangeError} When `bitSize` is not 1–32, `index` is not in `0 ≤ index
+ *   < count`, the value lies past the end of `report`, or `value` is not an
+ *   integer that fits `bitSize` bits of the field's signedness.
+ */
+export function writeHidFieldValueInPlace(report, field, index, value) {
+    const { bitSize } = field;
+    let position = fieldValueBitPosition_(report, field, index, "writeHidFieldValueInPlace");
+    const signed = field.logicalMinimum < 0;
+    const minimum = signed ? -(2 ** (bitSize - 1)) : 0;
+    const maximum = signed ? 2 ** (bitSize - 1) - 1 : 2 ** bitSize - 1;
+    if (!Number.isInteger(value) || value < minimum || value > maximum) {
+        throw new RangeError(`writeHidFieldValueInPlace: ${value} does not fit ${bitSize} ${signed ? "signed" : "unsigned"} bits`);
+    }
+    let remaining = value < 0 ? value + 2 ** bitSize : value;
+    let bitsLeft = bitSize;
+    while (bitsLeft > 0) {
+        const shift = position & 7;
+        const take = Math.min(8 - shift, bitsLeft);
+        const span = 1 << take;
+        const mask = (span - 1) << shift;
+        const byteIndex = position >>> 3;
+        report[byteIndex] =
+            (report[byteIndex] & ~mask) | ((remaining % span) << shift);
+        remaining = Math.floor(remaining / span);
+        bitsLeft -= take;
+        position += take;
+    }
+}
+//# sourceMappingURL=write-hid-field-value-in-place.js.map

package/dist/field/write-hid-field-value-in-place.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-hid-field-value-in-place.js","sourceRoot":"","sources":["../../src/field/write-hid-field-value-in-place.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,yBAAyB,CACxC,MAAkB,EAClB,KAAqB,EACrB,KAAa,EACb,KAAa;IAEb,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC1B,IAAI,QAAQ,GAAG,sBAAsB,CACpC,MAAM,EACN,KAAK,EACL,KAAK,EACL,2BAA2B,CAC3B,CAAC;IAEF,MAAM,MAAM,GAAG,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,OAAO,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;QACpE,MAAM,IAAI,UAAU,CACnB,8BAA8B,KAAK,iBAAiB,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,OAAO,CACpG,CAAC;IACH,CAAC;IAED,IAAI,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IACzD,IAAI,QAAQ,GAAG,OAAO,CAAC;IACvB,OAAO,QAAQ,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC;QACvB,MAAM,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC;QACjC,MAAM,SAAS,GAAG,QAAQ,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,SAAS,CAAC;YAChB,CAAC,MAAM,CAAC,SAAS,CAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC;QAC9D,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;QACzC,QAAQ,IAAI,IAAI,CAAC;QACjB,QAAQ,IAAI,IAAI,CAAC;IAClB,CAAC;AACF,CAAC"}

package/dist/field/write-hid-field-value.d.ts

@@ -0,0 +1,18 @@
+import type { HidFieldLayout } from "./hid-field-layout.js";
+/**
+ * Writes value `index` of a field into a report as transferred, leaving every
+ * other bit of `report` untouched. The counterpart of {@link readHidFieldValue},
+ * with the same signedness rule: a field whose `logicalMinimum` is negative
+ * takes two's-complement values.
+ *
+ * `value` is checked against the bit width, not the logical range, so a null
+ * value outside `logicalMinimum`–`logicalMaximum` can still be written.
+ *
+ * O(1) time and memory.
+ *
+ * @throws {RangeError} When `bitSize` is not 1–32, `index` is not in `0 ≤ index
+ *   < count`, the value lies past the end of `report`, or `value` is not an
+ *   integer that fits `bitSize` bits of the field's signedness.
+ */
+export declare function writeHidFieldValue(report: Uint8Array, field: HidFieldLayout, index: number, value: number): void;
+//# sourceMappingURL=write-hid-field-value.d.ts.map

package/dist/field/write-hid-field-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-hid-field-value.d.ts","sourceRoot":"","sources":["../../src/field/write-hid-field-value.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACX,IAAI,CAgCN"}

package/dist/field/write-hid-field-value.js

@@ -0,0 +1,41 @@
+import { fieldValueBitPosition_ } from "./_field-value-bit-position.js";
+/**
+ * Writes value `index` of a field into a report as transferred, leaving every
+ * other bit of `report` untouched. The counterpart of {@link readHidFieldValue},
+ * with the same signedness rule: a field whose `logicalMinimum` is negative
+ * takes two's-complement values.
+ *
+ * `value` is checked against the bit width, not the logical range, so a null
+ * value outside `logicalMinimum`–`logicalMaximum` can still be written.
+ *
+ * O(1) time and memory.
+ *
+ * @throws {RangeError} When `bitSize` is not 1–32, `index` is not in `0 ≤ index
+ *   < count`, the value lies past the end of `report`, or `value` is not an
+ *   integer that fits `bitSize` bits of the field's signedness.
+ */
+export function writeHidFieldValue(report, field, index, value) {
+    const { bitSize } = field;
+    let position = fieldValueBitPosition_(report, field, index, "writeHidFieldValue");
+    const signed = field.logicalMinimum < 0;
+    const minimum = signed ? -(2 ** (bitSize - 1)) : 0;
+    const maximum = signed ? 2 ** (bitSize - 1) - 1 : 2 ** bitSize - 1;
+    if (!Number.isInteger(value) || value < minimum || value > maximum) {
+        throw new RangeError(`writeHidFieldValue: ${value} does not fit ${bitSize} ${signed ? "signed" : "unsigned"} bits`);
+    }
+    let remaining = value < 0 ? value + 2 ** bitSize : value;
+    let bitsLeft = bitSize;
+    while (bitsLeft > 0) {
+        const shift = position & 7;
+        const take = Math.min(8 - shift, bitsLeft);
+        const span = 1 << take;
+        const mask = (span - 1) << shift;
+        const byteIndex = position >>> 3;
+        report[byteIndex] =
+            (report[byteIndex] & ~mask) | ((remaining % span) << shift);
+        remaining = Math.floor(remaining / span);
+        bitsLeft -= take;
+        position += take;
+    }
+}
+//# sourceMappingURL=write-hid-field-value.js.map

package/dist/field/write-hid-field-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-hid-field-value.js","sourceRoot":"","sources":["../../src/field/write-hid-field-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CACjC,MAAkB,EAClB,KAAqB,EACrB,KAAa,EACb,KAAa;IAEb,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC1B,IAAI,QAAQ,GAAG,sBAAsB,CACpC,MAAM,EACN,KAAK,EACL,KAAK,EACL,oBAAoB,CACpB,CAAC;IAEF,MAAM,MAAM,GAAG,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,OAAO,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;QACpE,MAAM,IAAI,UAAU,CACnB,uBAAuB,KAAK,iBAAiB,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,OAAO,CAC7F,CAAC;IACH,CAAC;IAED,IAAI,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IACzD,IAAI,QAAQ,GAAG,OAAO,CAAC;IACvB,OAAO,QAAQ,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC;QACvB,MAAM,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC;QACjC,MAAM,SAAS,GAAG,QAAQ,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,SAAS,CAAC;YAChB,CAAC,MAAM,CAAC,SAAS,CAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC;QAC9D,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;QACzC,QAAQ,IAAI,IAAI,CAAC;QACjB,QAAQ,IAAI,IAAI,CAAC;IAClB,CAAC;AACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export * from "./descriptor/hid-field-usage.js";
+export * from "./descriptor/hid-report-descriptor.js";
+export * from "./descriptor/parse-hid-report-descriptor.js";
+export * from "./errors.js";
+export * from "./field/create-hid-report.js";
+export * from "./field/hid-field-layout.js";
+export * from "./field/hid-logical-to-physical.js";
+export * from "./field/read-hid-field-value.js";
+export * from "./field/write-hid-field-value-in-place.js";
+export * from "./item/decode-hid-items.js";
+export * from "./item/encode-hid-items.js";
+export * from "./item/hid-item-tag.js";
+export * from "./item/hid-item-value.js";
+export * from "./item/hid-item.js";
+export * from "./unit/decode-hid-unit.js";
+export * from "./unit/encode-hid-unit.js";
+export * from "./unit/hid-unit.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,aAAa,CAAC;AAC5B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+export * from "./descriptor/hid-field-usage.js";
+export * from "./descriptor/hid-report-descriptor.js";
+export * from "./descriptor/parse-hid-report-descriptor.js";
+export * from "./errors.js";
+export * from "./field/create-hid-report.js";
+export * from "./field/hid-field-layout.js";
+export * from "./field/hid-logical-to-physical.js";
+export * from "./field/read-hid-field-value.js";
+export * from "./field/write-hid-field-value-in-place.js";
+export * from "./item/decode-hid-items.js";
+export * from "./item/encode-hid-items.js";
+export * from "./item/hid-item-tag.js";
+export * from "./item/hid-item-value.js";
+export * from "./item/hid-item.js";
+export * from "./unit/decode-hid-unit.js";
+export * from "./unit/encode-hid-unit.js";
+export * from "./unit/hid-unit.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,aAAa,CAAC;AAC5B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC"}

package/dist/item/_read-hid-item.d.ts

@@ -0,0 +1,18 @@
+import type { ByteReader } from "@ac-kit/core";
+import type { HidItem, HidItemType } from "./hid-item.js";
+/** Prefix byte of a long item (HID 1.11 §6.2.2.3). */
+export declare const LONG_ITEM_PREFIX_ = 254;
+/** `bType` codes in prefix order (HID 1.11 §6.2.2.2). */
+export declare const ITEM_TYPES_: readonly HidItemType[];
+/**
+ * Reads one item at the cursor and advances past it. The cursor kernel behind
+ * both {@link decodeHidItems} and the descriptor parser, which needs the item's
+ * start offset for its own errors.
+ *
+ * `data` is a view over the reader's bytes, not a copy.
+ *
+ * @throws {HidDescriptorError} When the item runs past the end of the bytes;
+ *   `offset` is the item's prefix byte.
+ */
+export declare function readHidItem_(reader: ByteReader): HidItem;
+//# sourceMappingURL=_read-hid-item.d.ts.map

package/dist/item/_read-hid-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_read-hid-item.d.ts","sourceRoot":"","sources":["../../src/item/_read-hid-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE1D,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,MAAO,CAAC;AAEtC,yDAAyD;AACzD,eAAO,MAAM,WAAW,EAAE,SAAS,WAAW,EAK7C,CAAC;AAKF;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAkCxD"}

package/dist/item/_read-hid-item.js

@@ -0,0 +1,48 @@
+import { HidDescriptorError } from "../errors.js";
+/** Prefix byte of a long item (HID 1.11 §6.2.2.3). */
+export const LONG_ITEM_PREFIX_ = 0xfe;
+/** `bType` codes in prefix order (HID 1.11 §6.2.2.2). */
+export const ITEM_TYPES_ = [
+    "main",
+    "global",
+    "local",
+    "reserved",
+];
+/** `bSize` code 3 means four bytes, not three (HID 1.11 §6.2.2.2). */
+const SHORT_DATA_LENGTHS_ = [0, 1, 2, 4];
+/**
+ * Reads one item at the cursor and advances past it. The cursor kernel behind
+ * both {@link decodeHidItems} and the descriptor parser, which needs the item's
+ * start offset for its own errors.
+ *
+ * `data` is a view over the reader's bytes, not a copy.
+ *
+ * @throws {HidDescriptorError} When the item runs past the end of the bytes;
+ *   `offset` is the item's prefix byte.
+ */
+export function readHidItem_(reader) {
+    const offset = reader.position;
+    const prefix = reader.readByte();
+    if (prefix === LONG_ITEM_PREFIX_) {
+        if (reader.remaining < 2) {
+            throw new HidDescriptorError("Truncated long item header", offset);
+        }
+        const length = reader.readByte();
+        const tag = reader.readByte();
+        if (reader.remaining < length) {
+            throw new HidDescriptorError(`Long item declares ${length} data bytes, only ${reader.remaining} remain`, offset);
+        }
+        return { kind: "long", tag, data: reader.read(length) };
+    }
+    const length = SHORT_DATA_LENGTHS_[prefix & 0b11];
+    if (reader.remaining < length) {
+        throw new HidDescriptorError(`Short item declares ${length} data bytes, only ${reader.remaining} remain`, offset);
+    }
+    return {
+        kind: "short",
+        type: ITEM_TYPES_[(prefix >>> 2) & 0b11],
+        tag: prefix >>> 4,
+        data: reader.read(length),
+    };
+}
+//# sourceMappingURL=_read-hid-item.js.map

package/dist/item/_read-hid-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_read-hid-item.js","sourceRoot":"","sources":["../../src/item/_read-hid-item.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,sDAAsD;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC,yDAAyD;AACzD,MAAM,CAAC,MAAM,WAAW,GAA2B;IAClD,MAAM;IACN,QAAQ;IACR,OAAO;IACP,UAAU;CACV,CAAC;AAEF,sEAAsE;AACtE,MAAM,mBAAmB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,MAAkB;IAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAEjC,IAAI,MAAM,KAAK,iBAAiB,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,kBAAkB,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,SAAS,GAAG,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,kBAAkB,CAC3B,sBAAsB,MAAM,qBAAqB,MAAM,CAAC,SAAS,SAAS,EAC1E,MAAM,CACN,CAAC;QACH,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,GAAG,IAAI,CAAE,CAAC;IACnD,IAAI,MAAM,CAAC,SAAS,GAAG,MAAM,EAAE,CAAC;QAC/B,MAAM,IAAI,kBAAkB,CAC3B,uBAAuB,MAAM,qBAAqB,MAAM,CAAC,SAAS,SAAS,EAC3E,MAAM,CACN,CAAC;IACH,CAAC;IAED,OAAO;QACN,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,WAAW,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,GAAG,IAAI,CAAE;QACzC,GAAG,EAAE,MAAM,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;KACzB,CAAC;AACH,CAAC"}

package/dist/item/decode-hid-items.d.ts

@@ -0,0 +1,16 @@
+import type { HidItem } from "./hid-item.js";
+/**
+ * Splits a report descriptor into its raw items, with no interpretation — the
+ * wire face, exact enough that {@link encodeHidItems} gives the same bytes back.
+ *
+ * Use {@link parseHidReportDescriptor} for the reports and fields the items
+ * describe. Every item's `data` is a view over `bytes`, not a copy, so mutating
+ * `bytes` afterwards changes the items too.
+ *
+ * O(n) time in `bytes.length`; one item object per item.
+ *
+ * @throws {HidDescriptorError} When the last item runs past the end of `bytes`;
+ *   `offset` is that item's prefix byte.
+ */
+export declare function decodeHidItems(bytes: Uint8Array): HidItem[];
+//# sourceMappingURL=decode-hid-items.d.ts.map

package/dist/item/decode-hid-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-hid-items.d.ts","sourceRoot":"","sources":["../../src/item/decode-hid-items.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,EAAE,CAQ3D"}

package/dist/item/decode-hid-items.js

@@ -0,0 +1,24 @@
+import { ByteReader } from "@ac-kit/core";
+import { readHidItem_ } from "./_read-hid-item.js";
+/**
+ * Splits a report descriptor into its raw items, with no interpretation — the
+ * wire face, exact enough that {@link encodeHidItems} gives the same bytes back.
+ *
+ * Use {@link parseHidReportDescriptor} for the reports and fields the items
+ * describe. Every item's `data` is a view over `bytes`, not a copy, so mutating
+ * `bytes` afterwards changes the items too.
+ *
+ * O(n) time in `bytes.length`; one item object per item.
+ *
+ * @throws {HidDescriptorError} When the last item runs past the end of `bytes`;
+ *   `offset` is that item's prefix byte.
+ */
+export function decodeHidItems(bytes) {
+    const reader = new ByteReader(bytes);
+    const items = [];
+    while (!reader.atEnd) {
+        items.push(readHidItem_(reader));
+    }
+    return items;
+}
+//# sourceMappingURL=decode-hid-items.js.map

package/dist/item/decode-hid-items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-hid-items.js","sourceRoot":"","sources":["../../src/item/decode-hid-items.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC/C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/item/encode-hid-items.d.ts

@@ -0,0 +1,17 @@
+import type { HidItem } from "./hid-item.js";
+/**
+ * Spells items back into report descriptor bytes — the inverse of
+ * {@link decodeHidItems}, byte for byte.
+ *
+ * Every item is written with exactly the data it carries: a value is never
+ * shortened to fewer bytes, so a descriptor that spells `Logical Maximum (255)`
+ * with two bytes keeps both.
+ *
+ * O(n) time and memory in the total encoded length.
+ *
+ * @throws {RangeError} When an item cannot be spelled: a short item's data is
+ *   not 0, 1, 2 or 4 bytes, a long item's is over 255, a tag is out of range,
+ *   or a reserved short item would produce the long-item prefix `0xFE`.
+ */
+export declare function encodeHidItems(items: readonly HidItem[]): Uint8Array<ArrayBuffer>;
+//# sourceMappingURL=encode-hid-items.d.ts.map

package/dist/item/encode-hid-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-hid-items.d.ts","sourceRoot":"","sources":["../../src/item/encode-hid-items.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,eAAe,CAAC;AA+D1D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC7B,KAAK,EAAE,SAAS,OAAO,EAAE,GACvB,UAAU,CAAC,WAAW,CAAC,CAuBzB"}

package/dist/item/encode-hid-items.js

@@ -0,0 +1,74 @@
+import { ITEM_TYPES_, LONG_ITEM_PREFIX_ } from "./_read-hid-item.js";
+const SHORT_SIZE_CODES_ = {
+    0: 0,
+    1: 1,
+    2: 2,
+    4: 3,
+};
+function itemByteLength_(item, index) {
+    if (item.kind === "long") {
+        if (!Number.isInteger(item.tag) || item.tag < 0 || item.tag > 0xff) {
+            throw new RangeError(`encodeHidItems: item ${index} long tag ${item.tag} is not 0–255`);
+        }
+        if (item.data.length > 0xff) {
+            throw new RangeError(`encodeHidItems: item ${index} long data of ${item.data.length} bytes exceeds 255`);
+        }
+        return 3 + item.data.length;
+    }
+    if (!Number.isInteger(item.tag) || item.tag < 0 || item.tag > 0xf) {
+        throw new RangeError(`encodeHidItems: item ${index} tag ${item.tag} is not 0–15`);
+    }
+    if (!ITEM_TYPES_.includes(item.type)) {
+        throw new RangeError(`encodeHidItems: item ${index} type "${String(item.type)}" is unknown`);
+    }
+    if (SHORT_SIZE_CODES_[item.data.length] === undefined) {
+        throw new RangeError(`encodeHidItems: item ${index} short data of ${item.data.length} bytes is not 0, 1, 2 or 4`);
+    }
+    if (shortPrefix_(item.type, item.tag, item.data.length) === LONG_ITEM_PREFIX_) {
+        throw new RangeError(`encodeHidItems: item ${index} would spell 0xFE, which always reads back as a long item`);
+    }
+    return 1 + item.data.length;
+}
+function shortPrefix_(type, tag, dataLength) {
+    return ((tag << 4) |
+        (ITEM_TYPES_.indexOf(type) << 2) |
+        SHORT_SIZE_CODES_[dataLength]);
+}
+/**
+ * Spells items back into report descriptor bytes — the inverse of
+ * {@link decodeHidItems}, byte for byte.
+ *
+ * Every item is written with exactly the data it carries: a value is never
+ * shortened to fewer bytes, so a descriptor that spells `Logical Maximum (255)`
+ * with two bytes keeps both.
+ *
+ * O(n) time and memory in the total encoded length.
+ *
+ * @throws {RangeError} When an item cannot be spelled: a short item's data is
+ *   not 0, 1, 2 or 4 bytes, a long item's is over 255, a tag is out of range,
+ *   or a reserved short item would produce the long-item prefix `0xFE`.
+ */
+export function encodeHidItems(items) {
+    let byteLength = 0;
+    for (const [index, item] of items.entries()) {
+        byteLength += itemByteLength_(item, index);
+    }
+    const bytes = new Uint8Array(byteLength);
+    let offset = 0;
+    for (const item of items) {
+        if (item.kind === "long") {
+            bytes[offset] = LONG_ITEM_PREFIX_;
+            bytes[offset + 1] = item.data.length;
+            bytes[offset + 2] = item.tag;
+            offset += 3;
+        }
+        else {
+            bytes[offset] = shortPrefix_(item.type, item.tag, item.data.length);
+            offset += 1;
+        }
+        bytes.set(item.data, offset);
+        offset += item.data.length;
+    }
+    return bytes;
+}
+//# sourceMappingURL=encode-hid-items.js.map

package/dist/item/encode-hid-items.js.map

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

package/dist/item/hid-item-tag.d.ts

@@ -0,0 +1,37 @@
+/** Tags of main items (HID 1.11 §6.2.2.4). */
+export declare enum HidMainTag {
+    INPUT = 8,
+    OUTPUT = 9,
+    COLLECTION = 10,
+    FEATURE = 11,
+    END_COLLECTION = 12
+}
+/** Tags of global items (HID 1.11 §6.2.2.7). */
+export declare enum HidGlobalTag {
+    USAGE_PAGE = 0,
+    LOGICAL_MINIMUM = 1,
+    LOGICAL_MAXIMUM = 2,
+    PHYSICAL_MINIMUM = 3,
+    PHYSICAL_MAXIMUM = 4,
+    UNIT_EXPONENT = 5,
+    UNIT = 6,
+    REPORT_SIZE = 7,
+    REPORT_ID = 8,
+    REPORT_COUNT = 9,
+    PUSH = 10,
+    POP = 11
+}
+/** Tags of local items (HID 1.11 §6.2.2.8). Tag 6 is reserved. */
+export declare enum HidLocalTag {
+    USAGE = 0,
+    USAGE_MINIMUM = 1,
+    USAGE_MAXIMUM = 2,
+    DESIGNATOR_INDEX = 3,
+    DESIGNATOR_MINIMUM = 4,
+    DESIGNATOR_MAXIMUM = 5,
+    STRING_INDEX = 7,
+    STRING_MINIMUM = 8,
+    STRING_MAXIMUM = 9,
+    DELIMITER = 10
+}
+//# sourceMappingURL=hid-item-tag.d.ts.map

package/dist/item/hid-item-tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hid-item-tag.d.ts","sourceRoot":"","sources":["../../src/item/hid-item-tag.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,oBAAY,UAAU;IACrB,KAAK,IAAM;IACX,MAAM,IAAM;IACZ,UAAU,KAAM;IAChB,OAAO,KAAM;IACb,cAAc,KAAM;CACpB;AAED,gDAAgD;AAChD,oBAAY,YAAY;IACvB,UAAU,IAAM;IAChB,eAAe,IAAM;IACrB,eAAe,IAAM;IACrB,gBAAgB,IAAM;IACtB,gBAAgB,IAAM;IACtB,aAAa,IAAM;IACnB,IAAI,IAAM;IACV,WAAW,IAAM;IACjB,SAAS,IAAM;IACf,YAAY,IAAM;IAClB,IAAI,KAAM;IACV,GAAG,KAAM;CACT;AAED,kEAAkE;AAClE,oBAAY,WAAW;IACtB,KAAK,IAAM;IACX,aAAa,IAAM;IACnB,aAAa,IAAM;IACnB,gBAAgB,IAAM;IACtB,kBAAkB,IAAM;IACxB,kBAAkB,IAAM;IACxB,YAAY,IAAM;IAClB,cAAc,IAAM;IACpB,cAAc,IAAM;IACpB,SAAS,KAAM;CACf"}

package/dist/item/hid-item-tag.js

@@ -0,0 +1,40 @@
+/** Tags of main items (HID 1.11 §6.2.2.4). */
+export var HidMainTag;
+(function (HidMainTag) {
+    HidMainTag[HidMainTag["INPUT"] = 8] = "INPUT";
+    HidMainTag[HidMainTag["OUTPUT"] = 9] = "OUTPUT";
+    HidMainTag[HidMainTag["COLLECTION"] = 10] = "COLLECTION";
+    HidMainTag[HidMainTag["FEATURE"] = 11] = "FEATURE";
+    HidMainTag[HidMainTag["END_COLLECTION"] = 12] = "END_COLLECTION";
+})(HidMainTag || (HidMainTag = {}));
+/** Tags of global items (HID 1.11 §6.2.2.7). */
+export var HidGlobalTag;
+(function (HidGlobalTag) {
+    HidGlobalTag[HidGlobalTag["USAGE_PAGE"] = 0] = "USAGE_PAGE";
+    HidGlobalTag[HidGlobalTag["LOGICAL_MINIMUM"] = 1] = "LOGICAL_MINIMUM";
+    HidGlobalTag[HidGlobalTag["LOGICAL_MAXIMUM"] = 2] = "LOGICAL_MAXIMUM";
+    HidGlobalTag[HidGlobalTag["PHYSICAL_MINIMUM"] = 3] = "PHYSICAL_MINIMUM";
+    HidGlobalTag[HidGlobalTag["PHYSICAL_MAXIMUM"] = 4] = "PHYSICAL_MAXIMUM";
+    HidGlobalTag[HidGlobalTag["UNIT_EXPONENT"] = 5] = "UNIT_EXPONENT";
+    HidGlobalTag[HidGlobalTag["UNIT"] = 6] = "UNIT";
+    HidGlobalTag[HidGlobalTag["REPORT_SIZE"] = 7] = "REPORT_SIZE";
+    HidGlobalTag[HidGlobalTag["REPORT_ID"] = 8] = "REPORT_ID";
+    HidGlobalTag[HidGlobalTag["REPORT_COUNT"] = 9] = "REPORT_COUNT";
+    HidGlobalTag[HidGlobalTag["PUSH"] = 10] = "PUSH";
+    HidGlobalTag[HidGlobalTag["POP"] = 11] = "POP";
+})(HidGlobalTag || (HidGlobalTag = {}));
+/** Tags of local items (HID 1.11 §6.2.2.8). Tag 6 is reserved. */
+export var HidLocalTag;
+(function (HidLocalTag) {
+    HidLocalTag[HidLocalTag["USAGE"] = 0] = "USAGE";
+    HidLocalTag[HidLocalTag["USAGE_MINIMUM"] = 1] = "USAGE_MINIMUM";
+    HidLocalTag[HidLocalTag["USAGE_MAXIMUM"] = 2] = "USAGE_MAXIMUM";
+    HidLocalTag[HidLocalTag["DESIGNATOR_INDEX"] = 3] = "DESIGNATOR_INDEX";
+    HidLocalTag[HidLocalTag["DESIGNATOR_MINIMUM"] = 4] = "DESIGNATOR_MINIMUM";
+    HidLocalTag[HidLocalTag["DESIGNATOR_MAXIMUM"] = 5] = "DESIGNATOR_MAXIMUM";
+    HidLocalTag[HidLocalTag["STRING_INDEX"] = 7] = "STRING_INDEX";
+    HidLocalTag[HidLocalTag["STRING_MINIMUM"] = 8] = "STRING_MINIMUM";
+    HidLocalTag[HidLocalTag["STRING_MAXIMUM"] = 9] = "STRING_MAXIMUM";
+    HidLocalTag[HidLocalTag["DELIMITER"] = 10] = "DELIMITER";
+})(HidLocalTag || (HidLocalTag = {}));
+//# sourceMappingURL=hid-item-tag.js.map

package/dist/item/hid-item-tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hid-item-tag.js","sourceRoot":"","sources":["../../src/item/hid-item-tag.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,CAAN,IAAY,UAMX;AAND,WAAY,UAAU;IACrB,6CAAW,CAAA;IACX,+CAAY,CAAA;IACZ,wDAAgB,CAAA;IAChB,kDAAa,CAAA;IACb,gEAAoB,CAAA;AACrB,CAAC,EANW,UAAU,KAAV,UAAU,QAMrB;AAED,gDAAgD;AAChD,MAAM,CAAN,IAAY,YAaX;AAbD,WAAY,YAAY;IACvB,2DAAgB,CAAA;IAChB,qEAAqB,CAAA;IACrB,qEAAqB,CAAA;IACrB,uEAAsB,CAAA;IACtB,uEAAsB,CAAA;IACtB,iEAAmB,CAAA;IACnB,+CAAU,CAAA;IACV,6DAAiB,CAAA;IACjB,yDAAe,CAAA;IACf,+DAAkB,CAAA;IAClB,gDAAU,CAAA;IACV,8CAAS,CAAA;AACV,CAAC,EAbW,YAAY,KAAZ,YAAY,QAavB;AAED,kEAAkE;AAClE,MAAM,CAAN,IAAY,WAWX;AAXD,WAAY,WAAW;IACtB,+CAAW,CAAA;IACX,+DAAmB,CAAA;IACnB,+DAAmB,CAAA;IACnB,qEAAsB,CAAA;IACtB,yEAAwB,CAAA;IACxB,yEAAwB,CAAA;IACxB,6DAAkB,CAAA;IAClB,iEAAoB,CAAA;IACpB,iEAAoB,CAAA;IACpB,wDAAe,CAAA;AAChB,CAAC,EAXW,WAAW,KAAX,WAAW,QAWtB"}

package/dist/item/hid-item-value.d.ts

@@ -0,0 +1,20 @@
+import type { HidItem } from "./hid-item.js";
+/**
+ * The item's data read as a little-endian unsigned integer — how HID 1.11
+ * §6.2.2.7 reads Usage Page, Report Size, Report Count, Report ID and Unit.
+ *
+ * Use {@link hidItemSigned} for Logical/Physical Minimum and other signed
+ * values. An empty data field reads as 0.
+ *
+ * @throws {RangeError} When the data is longer than 4 bytes (a long item).
+ */
+export declare function hidItemUnsigned(item: HidItem): number;
+/**
+ * The item's data read as a little-endian two's-complement integer of its own
+ * width — 1, 2 or 4 bytes — as HID 1.11 §6.2.2.7 reads Logical and Physical
+ * Minimum. An empty data field reads as 0.
+ *
+ * @throws {RangeError} When the data is longer than 4 bytes (a long item).
+ */
+export declare function hidItemSigned(item: HidItem): number;
+//# sourceMappingURL=hid-item-value.d.ts.map

package/dist/item/hid-item-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hid-item-value.d.ts","sourceRoot":"","sources":["../../src/item/hid-item-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAcrD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAQnD"}