@potatosalad775/eqcaps-device-bridge 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (148) hide show
  1. package/LICENSE +21 -0
  2. package/NOTICE.md +54 -0
  3. package/README.md +112 -0
  4. package/dist/analysis.d.ts +34 -0
  5. package/dist/analysis.d.ts.map +1 -0
  6. package/dist/analysis.js +92 -0
  7. package/dist/analysis.js.map +1 -0
  8. package/dist/biquad.d.ts +9 -0
  9. package/dist/biquad.d.ts.map +1 -0
  10. package/dist/biquad.js +50 -0
  11. package/dist/biquad.js.map +1 -0
  12. package/dist/browser/index.d.ts +14 -0
  13. package/dist/browser/index.d.ts.map +1 -0
  14. package/dist/browser/index.js +12 -0
  15. package/dist/browser/index.js.map +1 -0
  16. package/dist/browser/stream.d.ts +15 -0
  17. package/dist/browser/stream.d.ts.map +1 -0
  18. package/dist/browser/stream.js +51 -0
  19. package/dist/browser/stream.js.map +1 -0
  20. package/dist/browser/web-apis.d.ts +136 -0
  21. package/dist/browser/web-apis.d.ts.map +1 -0
  22. package/dist/browser/web-apis.js +13 -0
  23. package/dist/browser/web-apis.js.map +1 -0
  24. package/dist/browser/webbluetooth.d.ts +30 -0
  25. package/dist/browser/webbluetooth.d.ts.map +1 -0
  26. package/dist/browser/webbluetooth.js +80 -0
  27. package/dist/browser/webbluetooth.js.map +1 -0
  28. package/dist/browser/webhid.d.ts +33 -0
  29. package/dist/browser/webhid.d.ts.map +1 -0
  30. package/dist/browser/webhid.js +90 -0
  31. package/dist/browser/webhid.js.map +1 -0
  32. package/dist/browser/webserial.d.ts +34 -0
  33. package/dist/browser/webserial.d.ts.map +1 -0
  34. package/dist/browser/webserial.js +133 -0
  35. package/dist/browser/webserial.js.map +1 -0
  36. package/dist/bytes.d.ts +40 -0
  37. package/dist/bytes.d.ts.map +1 -0
  38. package/dist/bytes.js +74 -0
  39. package/dist/bytes.js.map +1 -0
  40. package/dist/chooser.d.ts +40 -0
  41. package/dist/chooser.d.ts.map +1 -0
  42. package/dist/chooser.js +49 -0
  43. package/dist/chooser.js.map +1 -0
  44. package/dist/device.d.ts +51 -0
  45. package/dist/device.d.ts.map +1 -0
  46. package/dist/device.js +94 -0
  47. package/dist/device.js.map +1 -0
  48. package/dist/errors.d.ts +24 -0
  49. package/dist/errors.d.ts.map +1 -0
  50. package/dist/errors.js +12 -0
  51. package/dist/errors.js.map +1 -0
  52. package/dist/handler.d.ts +161 -0
  53. package/dist/handler.d.ts.map +1 -0
  54. package/dist/handler.js +3 -0
  55. package/dist/handler.js.map +1 -0
  56. package/dist/handlers/airoha.d.ts +12 -0
  57. package/dist/handlers/airoha.d.ts.map +1 -0
  58. package/dist/handlers/airoha.js +135 -0
  59. package/dist/handlers/airoha.js.map +1 -0
  60. package/dist/handlers/conexant-usb-hid.d.ts +4 -0
  61. package/dist/handlers/conexant-usb-hid.d.ts.map +1 -0
  62. package/dist/handlers/conexant-usb-hid.js +103 -0
  63. package/dist/handlers/conexant-usb-hid.js.map +1 -0
  64. package/dist/handlers/edifier-serial.d.ts +6 -0
  65. package/dist/handlers/edifier-serial.d.ts.map +1 -0
  66. package/dist/handlers/edifier-serial.js +111 -0
  67. package/dist/handlers/edifier-serial.js.map +1 -0
  68. package/dist/handlers/fiio-f110.d.ts +7 -0
  69. package/dist/handlers/fiio-f110.d.ts.map +1 -0
  70. package/dist/handlers/fiio-f110.js +101 -0
  71. package/dist/handlers/fiio-f110.js.map +1 -0
  72. package/dist/handlers/fiio-usb-hid.d.ts +39 -0
  73. package/dist/handlers/fiio-usb-hid.d.ts.map +1 -0
  74. package/dist/handlers/fiio-usb-hid.js +143 -0
  75. package/dist/handlers/fiio-usb-hid.js.map +1 -0
  76. package/dist/handlers/fiio-usb-serial.d.ts +9 -0
  77. package/dist/handlers/fiio-usb-serial.d.ts.map +1 -0
  78. package/dist/handlers/fiio-usb-serial.js +122 -0
  79. package/dist/handlers/fiio-usb-serial.js.map +1 -0
  80. package/dist/handlers/fosi-audio-usb-hid.d.ts +19 -0
  81. package/dist/handlers/fosi-audio-usb-hid.d.ts.map +1 -0
  82. package/dist/handlers/fosi-audio-usb-hid.js +165 -0
  83. package/dist/handlers/fosi-audio-usb-hid.js.map +1 -0
  84. package/dist/handlers/index.d.ts +25 -0
  85. package/dist/handlers/index.d.ts.map +1 -0
  86. package/dist/handlers/index.js +36 -0
  87. package/dist/handlers/index.js.map +1 -0
  88. package/dist/handlers/jds-labs-usb-serial.d.ts +5 -0
  89. package/dist/handlers/jds-labs-usb-serial.d.ts.map +1 -0
  90. package/dist/handlers/jds-labs-usb-serial.js +156 -0
  91. package/dist/handlers/jds-labs-usb-serial.js.map +1 -0
  92. package/dist/handlers/ktmicro-usb-hid.d.ts +20 -0
  93. package/dist/handlers/ktmicro-usb-hid.d.ts.map +1 -0
  94. package/dist/handlers/ktmicro-usb-hid.js +144 -0
  95. package/dist/handlers/ktmicro-usb-hid.js.map +1 -0
  96. package/dist/handlers/moondrop-edge-serial.d.ts +8 -0
  97. package/dist/handlers/moondrop-edge-serial.d.ts.map +1 -0
  98. package/dist/handlers/moondrop-edge-serial.js +100 -0
  99. package/dist/handlers/moondrop-edge-serial.js.map +1 -0
  100. package/dist/handlers/moondrop-old-fashioned-hid.d.ts +4 -0
  101. package/dist/handlers/moondrop-old-fashioned-hid.d.ts.map +1 -0
  102. package/dist/handlers/moondrop-old-fashioned-hid.js +102 -0
  103. package/dist/handlers/moondrop-old-fashioned-hid.js.map +1 -0
  104. package/dist/handlers/moondrop-usb-hid.d.ts +8 -0
  105. package/dist/handlers/moondrop-usb-hid.d.ts.map +1 -0
  106. package/dist/handlers/moondrop-usb-hid.js +134 -0
  107. package/dist/handlers/moondrop-usb-hid.js.map +1 -0
  108. package/dist/handlers/nothing-usb-serial.d.ts +19 -0
  109. package/dist/handlers/nothing-usb-serial.d.ts.map +1 -0
  110. package/dist/handlers/nothing-usb-serial.js +141 -0
  111. package/dist/handlers/nothing-usb-serial.js.map +1 -0
  112. package/dist/handlers/qudelix-usb-hid.d.ts +16 -0
  113. package/dist/handlers/qudelix-usb-hid.d.ts.map +1 -0
  114. package/dist/handlers/qudelix-usb-hid.js +127 -0
  115. package/dist/handlers/qudelix-usb-hid.js.map +1 -0
  116. package/dist/handlers/tanchjim-rita-serial.d.ts +5 -0
  117. package/dist/handlers/tanchjim-rita-serial.d.ts.map +1 -0
  118. package/dist/handlers/tanchjim-rita-serial.js +89 -0
  119. package/dist/handlers/tanchjim-rita-serial.js.map +1 -0
  120. package/dist/handlers/walkplay-hid.d.ts +12 -0
  121. package/dist/handlers/walkplay-hid.d.ts.map +1 -0
  122. package/dist/handlers/walkplay-hid.js +150 -0
  123. package/dist/handlers/walkplay-hid.js.map +1 -0
  124. package/dist/identity.d.ts +20 -0
  125. package/dist/identity.d.ts.map +1 -0
  126. package/dist/identity.js +30 -0
  127. package/dist/identity.js.map +1 -0
  128. package/dist/index.d.ts +18 -0
  129. package/dist/index.d.ts.map +1 -0
  130. package/dist/index.js +12 -0
  131. package/dist/index.js.map +1 -0
  132. package/dist/io.d.ts +50 -0
  133. package/dist/io.d.ts.map +1 -0
  134. package/dist/io.js +119 -0
  135. package/dist/io.js.map +1 -0
  136. package/dist/platform.d.ts +9 -0
  137. package/dist/platform.d.ts.map +1 -0
  138. package/dist/platform.js +59 -0
  139. package/dist/platform.js.map +1 -0
  140. package/dist/protocols.d.ts +52 -0
  141. package/dist/protocols.d.ts.map +1 -0
  142. package/dist/protocols.js +204 -0
  143. package/dist/protocols.js.map +1 -0
  144. package/dist/transport.d.ts +59 -0
  145. package/dist/transport.d.ts.map +1 -0
  146. package/dist/transport.js +12 -0
  147. package/dist/transport.js.map +1 -0
  148. package/package.json +38 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"web-apis.d.ts","sourceRoot":"","sources":["../../src/browser/web-apis.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ // The parts of WebHID, Web Serial and Web Bluetooth the browser transports use, declared
2
+ // structurally so the package needs no DOM types (D33). Any object of this shape works, which is
3
+ // also how the tests drive the transports.
4
+ /** The browser's device APIs, where present. */
5
+ export function browserApis() {
6
+ return (globalThis.navigator ?? {});
7
+ }
8
+ export const bytesOf = (view) => new Uint8Array(view.buffer, view.byteOffset, view.byteLength).slice();
9
+ /** A browser's chooser was dismissed: WebHID returns no device, the others throw NotFoundError. */
10
+ export const isCancel = (error) => typeof error === 'object' &&
11
+ error !== null &&
12
+ error.name === 'NotFoundError';
13
+ //# sourceMappingURL=web-apis.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"web-apis.js","sourceRoot":"","sources":["../../src/browser/web-apis.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,iGAAiG;AACjG,2CAA2C;AA2H3C,gDAAgD;AAChD,MAAM,UAAU,WAAW;IAC1B,OAAO,CAAE,UAAwC,CAAC,SAAS,IAAI,EAAE,CAAc,CAAC;AACjF,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAkB,EAAE,EAAE,CAC7C,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,CAAC;AAEvE,mGAAmG;AACnG,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAE,EAAE,CAC1C,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACb,KAA2B,CAAC,IAAI,KAAK,eAAe,CAAC"}
@@ -0,0 +1,30 @@
1
+ import { type ChooserEntry } from '../chooser.ts';
2
+ import type { DeviceIdentity } from '../identity.ts';
3
+ import type { Protocol } from '../protocols.ts';
4
+ import type { StreamTransport } from '../transport.ts';
5
+ import { type BluetoothDeviceLike, type BluetoothLike } from './web-apis.ts';
6
+ /**
7
+ * Connects to a BLE device's GATT service and wraps its TX/RX characteristics as a stream: writes
8
+ * go to TX (with response only when that's all TX supports), notifications from RX are buffered.
9
+ */
10
+ export declare function bleTransport(device: BluetoothDeviceLike, gatt: {
11
+ service: string;
12
+ tx: string;
13
+ rx: string;
14
+ }): Promise<StreamTransport>;
15
+ export interface RequestBleOptions {
16
+ /** Database entries whose BLE devices to offer by name. Without any, every device is offered. */
17
+ entries?: Iterable<ChooserEntry>;
18
+ /** Default: `navigator.bluetooth`. */
19
+ bluetooth?: BluetoothLike;
20
+ }
21
+ /** A chosen BLE device, not yet connected: the GATT layout depends on the protocol. */
22
+ export interface BleChoice {
23
+ /** For the client's `matchDevice`: the advertised name. */
24
+ identity: DeviceIdentity;
25
+ /** Connects with the GATT layout of `protocol`'s handler. */
26
+ open(protocol: Protocol): Promise<StreamTransport>;
27
+ }
28
+ /** Shows the browser's Bluetooth chooser; null if the user cancelled. */
29
+ export declare function requestBleDevice(options?: RequestBleOptions): Promise<BleChoice | null>;
30
+ //# sourceMappingURL=webbluetooth.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webbluetooth.d.ts","sourceRoot":"","sources":["../../src/browser/webbluetooth.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAIN,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAGlB,MAAM,eAAe,CAAC;AAEvB;;;GAGG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,eAAe,CAAC,CAqC1B;AAED,MAAM,WAAW,iBAAiB;IACjC,iGAAiG;IACjG,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACjC,sCAAsC;IACtC,SAAS,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,uFAAuF;AACvF,MAAM,WAAW,SAAS;IACzB,2DAA2D;IAC3D,QAAQ,EAAE,cAAc,CAAC;IACzB,6DAA6D;IAC7D,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACnD;AAED,yEAAyE;AACzE,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA2BjG"}
@@ -0,0 +1,80 @@
1
+ import { BridgeError } from "../errors.js";
2
+ import { chooserFilters } from "../chooser.js";
3
+ import { HANDLERS } from "../handlers/index.js";
4
+ import { ChunkQueue } from "./stream.js";
5
+ import { browserApis, bytesOf, isCancel } from "./web-apis.js";
6
+ /**
7
+ * Connects to a BLE device's GATT service and wraps its TX/RX characteristics as a stream: writes
8
+ * go to TX (with response only when that's all TX supports), notifications from RX are buffered.
9
+ */
10
+ export async function bleTransport(device, gatt) {
11
+ if (!device.gatt)
12
+ throw new BridgeError('transport', 'Web Bluetooth: the device has no GATT server');
13
+ let tx;
14
+ let rx;
15
+ try {
16
+ const server = await device.gatt.connect();
17
+ const service = await server.getPrimaryService(gatt.service);
18
+ tx = await service.getCharacteristic(gatt.tx);
19
+ rx = await service.getCharacteristic(gatt.rx);
20
+ await rx.startNotifications();
21
+ }
22
+ catch (cause) {
23
+ throw new BridgeError('transport', 'Web Bluetooth: GATT connection failed', { cause });
24
+ }
25
+ const queue = new ChunkQueue();
26
+ rx.addEventListener('characteristicvaluechanged', (event) => {
27
+ const value = event.target.value;
28
+ if (value)
29
+ queue.push(bytesOf(value));
30
+ });
31
+ const withResponse = !!tx.properties.write && !tx.properties.writeWithoutResponse;
32
+ const transport = {
33
+ kind: 'ble',
34
+ async write(data) {
35
+ try {
36
+ await (withResponse ? tx.writeValueWithResponse(data) : tx.writeValueWithoutResponse(data));
37
+ }
38
+ catch (cause) {
39
+ throw new BridgeError('transport', 'Web Bluetooth: write failed', { cause });
40
+ }
41
+ },
42
+ read: (timeoutMs) => queue.read(timeoutMs),
43
+ async close() {
44
+ queue.fail(new Error('closed'));
45
+ device.gatt?.disconnect();
46
+ }
47
+ };
48
+ if (device.name !== undefined)
49
+ transport.bleName = device.name;
50
+ return transport;
51
+ }
52
+ /** Shows the browser's Bluetooth chooser; null if the user cancelled. */
53
+ export async function requestBleDevice(options = {}) {
54
+ const api = options.bluetooth ?? browserApis().bluetooth;
55
+ if (!api)
56
+ throw new BridgeError('unsupported', 'Web Bluetooth is not available in this browser');
57
+ const f = chooserFilters(options.entries);
58
+ let device;
59
+ try {
60
+ device = await api.requestDevice(f.bleNames.length > 0
61
+ ? { filters: f.bleNames, optionalServices: f.gattServices }
62
+ : { acceptAllDevices: true, optionalServices: f.gattServices });
63
+ }
64
+ catch (error) {
65
+ if (isCancel(error))
66
+ return null;
67
+ throw new BridgeError('transport', 'Web Bluetooth: requestDevice failed', { cause: error });
68
+ }
69
+ return {
70
+ identity: device.name === undefined ? {} : { bluetooth: { name: device.name } },
71
+ open(protocol) {
72
+ const gatt = HANDLERS[protocol.handler].gatt;
73
+ if (!gatt) {
74
+ return Promise.reject(new BridgeError('invalid-request', `${protocol.handler} doesn't run over BLE`));
75
+ }
76
+ return bleTransport(device, gatt);
77
+ }
78
+ };
79
+ }
80
+ //# sourceMappingURL=webbluetooth.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webbluetooth.js","sourceRoot":"","sources":["../../src/browser/webbluetooth.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,33 @@
1
+ import { type ChooserEntry } from '../chooser.ts';
2
+ import type { HidCollectionInfo, HidTransport } from '../transport.ts';
3
+ import { type HidCollectionInfoLike, type HidDeviceLike, type HidLike } from './web-apis.ts';
4
+ /** The descriptor's collections in the bridge's shape (also the T1 descriptor dump). */
5
+ export declare function hidCollections(collections: readonly HidCollectionInfoLike[]): HidCollectionInfo[];
6
+ /** Wraps a WebHID device (opened if it isn't) as a bridge transport. */
7
+ export declare function hidTransport(device: HidDeviceLike): Promise<HidTransport>;
8
+ export interface RequestHidOptions {
9
+ /** Database entries whose devices to offer, on top of the vendors `guessProtocol` knows. */
10
+ entries?: Iterable<ChooserEntry>;
11
+ /** Offer every HID device: for identifying unknown devices (INSPECTOR T1). */
12
+ anyDevice?: boolean;
13
+ /** Default: `navigator.hid`. */
14
+ hid?: HidLike;
15
+ }
16
+ /**
17
+ * Shows the browser's HID chooser and returns the chosen device as a transport, or null if the
18
+ * user cancelled. A device with several HID interfaces of the same name (Qudelix 5K) may be
19
+ * chosen on its audio interface; the vendor-defined interface is preferred when it was granted
20
+ * too.
21
+ */
22
+ export declare function requestHidDevice(options?: RequestHidOptions): Promise<HidTransport | null>;
23
+ /**
24
+ * A device this site was already granted, found again without the chooser: after it was unplugged
25
+ * and plugged back in, say, or moved to a phone and back. Matches vendor id, product id and the
26
+ * exact product name, preferring the vendor-defined interface; null if it isn't connected.
27
+ */
28
+ export declare function grantedHidDevice(identity: {
29
+ vendorId: number;
30
+ productId: number;
31
+ productName: string;
32
+ }, hid?: HidLike | undefined): Promise<HidTransport | null>;
33
+ //# sourceMappingURL=webhid.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webhid.d.ts","sourceRoot":"","sources":["../../src/browser/webhid.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAiB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAGN,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAElB,KAAK,OAAO,EAEZ,MAAM,eAAe,CAAC;AAYvB,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,WAAW,EAAE,SAAS,qBAAqB,EAAE,GAAG,iBAAiB,EAAE,CASjG;AAMD,wEAAwE;AACxE,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAoB/E;AAKD,MAAM,WAAW,iBAAiB;IACjC,4FAA4F;IAC5F,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACjC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gCAAgC;IAChC,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACrC,OAAO,GAAE,iBAAsB,GAC7B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAqB9B;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACrC,QAAQ,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EACtE,GAAG,GAAE,OAAO,GAAG,SAA6B,GAC1C,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAW9B"}
@@ -0,0 +1,90 @@
1
+ import { BridgeError } from "../errors.js";
2
+ import { chooserFilters } from "../chooser.js";
3
+ import { browserApis, bytesOf } from "./web-apis.js";
4
+ function reportInfo(r) {
5
+ const bits = (r.items ?? []).reduce((sum, item) => sum + (item.reportSize ?? 0) * (item.reportCount ?? 0), 0);
6
+ const info = { reportId: r.reportId ?? 0 };
7
+ if (bits > 0)
8
+ info.size = Math.ceil(bits / 8);
9
+ return info;
10
+ }
11
+ /** The descriptor's collections in the bridge's shape (also the T1 descriptor dump). */
12
+ export function hidCollections(collections) {
13
+ return collections.map((c) => ({
14
+ usagePage: c.usagePage ?? 0,
15
+ usage: c.usage ?? 0,
16
+ inputReports: (c.inputReports ?? []).map(reportInfo),
17
+ outputReports: (c.outputReports ?? []).map(reportInfo),
18
+ featureReports: (c.featureReports ?? []).map(reportInfo),
19
+ children: hidCollections(c.children ?? [])
20
+ }));
21
+ }
22
+ const transportError = (what) => (cause) => {
23
+ throw new BridgeError('transport', `WebHID: ${what} failed`, { cause });
24
+ };
25
+ /** Wraps a WebHID device (opened if it isn't) as a bridge transport. */
26
+ export async function hidTransport(device) {
27
+ if (!device.opened)
28
+ await device.open().catch(transportError('open'));
29
+ return {
30
+ kind: 'hid',
31
+ vendorId: device.vendorId,
32
+ productId: device.productId,
33
+ productName: device.productName,
34
+ collections: hidCollections(device.collections),
35
+ sendReport: (id, data) => device.sendReport(id, data).catch(transportError('sendReport')),
36
+ sendFeatureReport: (id, data) => device.sendFeatureReport(id, data).catch(transportError('sendFeatureReport')),
37
+ receiveFeatureReport: async (id) => bytesOf(await device.receiveFeatureReport(id).catch(transportError('receiveFeatureReport'))),
38
+ onInputReport(listener) {
39
+ const handler = (e) => listener(e.reportId, bytesOf(e.data));
40
+ device.addEventListener('inputreport', handler);
41
+ return () => device.removeEventListener('inputreport', handler);
42
+ },
43
+ close: () => device.close().catch(transportError('close'))
44
+ };
45
+ }
46
+ const hasVendorCollection = (d) => d.collections.some((c) => (c.usagePage ?? 0) >= 0xff00);
47
+ /**
48
+ * Shows the browser's HID chooser and returns the chosen device as a transport, or null if the
49
+ * user cancelled. A device with several HID interfaces of the same name (Qudelix 5K) may be
50
+ * chosen on its audio interface; the vendor-defined interface is preferred when it was granted
51
+ * too.
52
+ */
53
+ export async function requestHidDevice(options = {}) {
54
+ const hid = options.hid ?? browserApis().hid;
55
+ if (!hid)
56
+ throw new BridgeError('unsupported', 'WebHID is not available in this browser');
57
+ const filters = options.anyDevice
58
+ ? []
59
+ : chooserFilters(options.entries).hidVendorIds.map((vendorId) => ({ vendorId }));
60
+ const chosen = await hid.requestDevice({ filters }).catch(transportError('requestDevice'));
61
+ let device = chosen[0];
62
+ if (!device)
63
+ return null;
64
+ if (!hasVendorCollection(device)) {
65
+ const granted = await hid.getDevices().catch(() => []);
66
+ const sibling = granted.find((d) => d !== device &&
67
+ d.vendorId === device.vendorId &&
68
+ d.productId === device.productId &&
69
+ hasVendorCollection(d));
70
+ if (sibling)
71
+ device = sibling;
72
+ }
73
+ return hidTransport(device);
74
+ }
75
+ /**
76
+ * A device this site was already granted, found again without the chooser: after it was unplugged
77
+ * and plugged back in, say, or moved to a phone and back. Matches vendor id, product id and the
78
+ * exact product name, preferring the vendor-defined interface; null if it isn't connected.
79
+ */
80
+ export async function grantedHidDevice(identity, hid = browserApis().hid) {
81
+ if (!hid)
82
+ throw new BridgeError('unsupported', 'WebHID is not available in this browser');
83
+ const granted = await hid.getDevices().catch(transportError('getDevices'));
84
+ const same = granted.filter((d) => d.vendorId === identity.vendorId &&
85
+ d.productId === identity.productId &&
86
+ d.productName === identity.productName);
87
+ const device = same.find(hasVendorCollection) ?? same[0];
88
+ return device ? hidTransport(device) : null;
89
+ }
90
+ //# sourceMappingURL=webhid.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webhid.js","sourceRoot":"","sources":["../../src/browser/webhid.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,34 @@
1
+ import { type ChooserEntry } from '../chooser.ts';
2
+ import { type DeviceIdentity } from '../identity.ts';
3
+ import type { Protocol } from '../protocols.ts';
4
+ import type { SerialPortIdentity, StreamTransport } from '../transport.ts';
5
+ import { type SerialLike, type SerialPortLike } from './web-apis.ts';
6
+ /**
7
+ * Wraps an open Web Serial port as a stream transport. One reader runs for the life of the
8
+ * transport and buffers what arrives; writes take the writer only for their duration.
9
+ */
10
+ export declare function serialTransport(port: SerialPortLike): StreamTransport;
11
+ /** The protocol's baud rate, else 9600 over Bluetooth and 115200 over USB. */
12
+ export declare function baudRateFor(identity: SerialPortIdentity, protocol?: Protocol): number;
13
+ /** A chosen serial port, not yet opened: its baud rate depends on which device it is. */
14
+ export interface SerialPortChoice {
15
+ /**
16
+ * For the client's `matchDevice`. A Bluetooth port shows only its service class, which several
17
+ * devices share: ask the user which device it is.
18
+ */
19
+ identity: DeviceIdentity;
20
+ port: SerialPortIdentity;
21
+ /** Opens the port at `baudRate`, default `baudRateFor(port, protocol)`. */
22
+ open(protocol?: Protocol, baudRate?: number): Promise<StreamTransport>;
23
+ }
24
+ export interface RequestSerialOptions {
25
+ /** Database entries whose USB serial devices to offer. Bluetooth ports are always offered. */
26
+ entries?: Iterable<ChooserEntry>;
27
+ /** Offer every serial port. */
28
+ anyDevice?: boolean;
29
+ /** Default: `navigator.serial`. */
30
+ serial?: SerialLike;
31
+ }
32
+ /** Shows the browser's serial port chooser; null if the user cancelled. */
33
+ export declare function requestSerialPort(options?: RequestSerialOptions): Promise<SerialPortChoice | null>;
34
+ //# sourceMappingURL=webserial.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webserial.d.ts","sourceRoot":"","sources":["../../src/browser/webserial.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE3E,OAAO,EAAyB,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE5F;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,eAAe,CAgErE;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAErF;AAED,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAChC;;;OAGG;IACH,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,kBAAkB,CAAC;IACzB,2EAA2E;IAC3E,IAAI,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,oBAAoB;IACpC,8FAA8F;IAC9F,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACjC,+BAA+B;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mCAAmC;IACnC,MAAM,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,2EAA2E;AAC3E,wBAAsB,iBAAiB,CACtC,OAAO,GAAE,oBAAyB,GAChC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAuClC"}
@@ -0,0 +1,133 @@
1
+ import { BridgeError } from "../errors.js";
2
+ import { chooserFilters } from "../chooser.js";
3
+ import { identityOf } from "../identity.js";
4
+ import { ChunkQueue } from "./stream.js";
5
+ import { browserApis, isCancel } from "./web-apis.js";
6
+ /**
7
+ * Wraps an open Web Serial port as a stream transport. One reader runs for the life of the
8
+ * transport and buffers what arrives; writes take the writer only for their duration.
9
+ */
10
+ export function serialTransport(port) {
11
+ const info = port.getInfo();
12
+ const serial = {};
13
+ if (info.usbVendorId !== undefined)
14
+ serial.usbVendorId = info.usbVendorId;
15
+ if (info.usbProductId !== undefined)
16
+ serial.usbProductId = info.usbProductId;
17
+ if (info.bluetoothServiceClassId) {
18
+ serial.bluetoothServiceClassId = info.bluetoothServiceClassId.toLowerCase();
19
+ }
20
+ const queue = new ChunkQueue();
21
+ const reader = port.readable?.getReader();
22
+ let closing = false;
23
+ if (reader) {
24
+ void (async () => {
25
+ try {
26
+ for (;;) {
27
+ const { value, done } = await reader.read();
28
+ if (done)
29
+ break;
30
+ if (value?.length)
31
+ queue.push(value);
32
+ }
33
+ queue.fail(new Error('the port stopped sending'));
34
+ }
35
+ catch (error) {
36
+ queue.fail(error);
37
+ }
38
+ finally {
39
+ if (!closing) {
40
+ try {
41
+ reader.releaseLock();
42
+ }
43
+ catch {
44
+ // Already released.
45
+ }
46
+ }
47
+ }
48
+ })();
49
+ }
50
+ else {
51
+ queue.fail(new Error('the port is not readable'));
52
+ }
53
+ return {
54
+ kind: 'serial',
55
+ serial,
56
+ async write(data) {
57
+ const writer = port.writable?.getWriter();
58
+ if (!writer)
59
+ throw new BridgeError('transport', 'Web Serial: the port is not writable');
60
+ try {
61
+ await writer.write(data);
62
+ }
63
+ catch (cause) {
64
+ throw new BridgeError('transport', 'Web Serial: write failed', { cause });
65
+ }
66
+ finally {
67
+ writer.releaseLock();
68
+ }
69
+ },
70
+ read: (timeoutMs) => queue.read(timeoutMs),
71
+ async close() {
72
+ closing = true;
73
+ await reader?.cancel().catch(() => { });
74
+ try {
75
+ reader?.releaseLock();
76
+ }
77
+ catch {
78
+ // Already released.
79
+ }
80
+ await port.close().catch((cause) => {
81
+ throw new BridgeError('transport', 'Web Serial: close failed', { cause });
82
+ });
83
+ }
84
+ };
85
+ }
86
+ /** The protocol's baud rate, else 9600 over Bluetooth and 115200 over USB. */
87
+ export function baudRateFor(identity, protocol) {
88
+ return protocol?.baudRate ?? (identity.bluetoothServiceClassId ? 9600 : 115200);
89
+ }
90
+ /** Shows the browser's serial port chooser; null if the user cancelled. */
91
+ export async function requestSerialPort(options = {}) {
92
+ const api = options.serial ?? browserApis().serial;
93
+ if (!api)
94
+ throw new BridgeError('unsupported', 'Web Serial is not available in this browser');
95
+ const f = chooserFilters(options.entries);
96
+ const filters = [
97
+ ...f.serialVendorIds.map((usbVendorId) => ({ usbVendorId })),
98
+ ...f.sppServiceClasses.map((bluetoothServiceClassId) => ({ bluetoothServiceClassId }))
99
+ ];
100
+ const allowedBluetoothServiceClassIds = f.sppServiceClasses;
101
+ let port;
102
+ try {
103
+ port = await api.requestPort(options.anyDevice
104
+ ? { allowedBluetoothServiceClassIds }
105
+ : { filters, allowedBluetoothServiceClassIds });
106
+ }
107
+ catch (error) {
108
+ if (isCancel(error))
109
+ return null;
110
+ throw new BridgeError('transport', 'Web Serial: requestPort failed', { cause: error });
111
+ }
112
+ const info = port.getInfo();
113
+ const identity = {};
114
+ if (info.usbVendorId !== undefined)
115
+ identity.usbVendorId = info.usbVendorId;
116
+ if (info.usbProductId !== undefined)
117
+ identity.usbProductId = info.usbProductId;
118
+ if (info.bluetoothServiceClassId)
119
+ identity.bluetoothServiceClassId = info.bluetoothServiceClassId.toLowerCase();
120
+ return {
121
+ identity: identityOf({ kind: 'serial', serial: identity }),
122
+ port: identity,
123
+ async open(protocol, baudRate) {
124
+ await port
125
+ .open({ baudRate: baudRate ?? baudRateFor(identity, protocol) })
126
+ .catch((cause) => {
127
+ throw new BridgeError('transport', 'Web Serial: open failed', { cause });
128
+ });
129
+ return serialTransport(port);
130
+ }
131
+ };
132
+ }
133
+ //# sourceMappingURL=webserial.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webserial.js","sourceRoot":"","sources":["../../src/browser/webserial.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ /** `round(value · scale)` as an integer in [min, max], or `unrepresentable`. */
2
+ export declare function wireInt(value: number, scale: number, min: number, max: number, what: string): number;
3
+ export declare const U8: readonly [0, 255];
4
+ export declare const I8: readonly [-128, 127];
5
+ export declare const U16: readonly [0, 65535];
6
+ export declare const I16: readonly [-32768, 32767];
7
+ export declare const U32: readonly [0, 4294967295];
8
+ export declare const I32: readonly [-2147483648, 2147483647];
9
+ /** Integer field: rounds `value · scale` and checks it against `range`. */
10
+ export declare function field(value: number, scale: number, range: readonly [number, number], what: string): number;
11
+ export declare const le16: (v: number) => [number, number];
12
+ export declare const be16: (v: number) => [number, number];
13
+ export declare const le32: (v: number) => [number, number, number, number];
14
+ export declare const be32: (v: number) => [number, number, number, number];
15
+ export declare const readU16le: (b: ArrayLike<number>, i: number) => number;
16
+ export declare const readU16be: (b: ArrayLike<number>, i: number) => number;
17
+ export declare const readI16le: (b: ArrayLike<number>, i: number) => number;
18
+ export declare const readI16be: (b: ArrayLike<number>, i: number) => number;
19
+ export declare const readU32le: (b: ArrayLike<number>, i: number) => number;
20
+ export declare const readI32le: (b: ArrayLike<number>, i: number) => number;
21
+ export declare const readU32be: (b: ArrayLike<number>, i: number) => number;
22
+ export declare const readI8: (b: ArrayLike<number>, i: number) => number;
23
+ /** A 32-bit float field: rounded to the nearest float, refused when out of float range. */
24
+ export declare function f32le(value: number, what?: string): [number, number, number, number];
25
+ export declare function readF32le(b: ArrayLike<number>, i: number): number;
26
+ export declare function hex(bytes: ArrayLike<number>): string;
27
+ /** Float32 values decoded from the wire, rounded to what a float32 field can mean. */
28
+ export declare function tidyF32(v: number): number;
29
+ /** The wire field `round(value · scale)` in `range`, as canonical min, max and step. */
30
+ export declare function grid(scale: number, range: readonly [number, number]): {
31
+ min: number;
32
+ max: number;
33
+ step: number;
34
+ };
35
+ /** A float32 wire field: no grid, float32 range. */
36
+ export declare const F32_FIELD: {
37
+ min: number;
38
+ max: number;
39
+ };
40
+ //# sourceMappingURL=bytes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../src/bytes.ts"],"names":[],"mappings":"AAKA,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAU3F;AAED,eAAO,MAAM,EAAE,mBAAqB,CAAC;AACrC,eAAO,MAAM,EAAE,sBAAyB,CAAC;AACzC,eAAO,MAAM,GAAG,qBAAuB,CAAC;AACxC,eAAO,MAAM,GAAG,0BAA6B,CAAC;AAC9C,eAAO,MAAM,GAAG,0BAA2B,CAAC;AAC5C,eAAO,MAAM,GAAG,oCAAqC,CAAC;AAEtD,2EAA2E;AAC3E,wBAAgB,KAAK,CACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,IAAI,EAAE,MAAM,UAGZ;AAED,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,CAAC,MAAM,EAAE,MAAM,CAAgC,CAAC;AACjF,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,CAAC,MAAM,EAAE,MAAM,CAAgC,CAAC;AACjF,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAK/D,CAAC;AACF,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAK/D,CAAC;AAIF,eAAO,MAAM,SAAS,GAAI,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,WAAmC,CAAC;AAC7F,eAAO,MAAM,SAAS,GAAI,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,WAAmC,CAAC;AAC7F,eAAO,MAAM,SAAS,GAAI,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,WAAkC,CAAC;AAC5F,eAAO,MAAM,SAAS,GAAI,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,WAAkC,CAAC;AAC5F,eAAO,MAAM,SAAS,GAAI,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,WAC4B,CAAC;AACtF,eAAO,MAAM,SAAS,GAAI,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,WAAwB,CAAC;AAClF,eAAO,MAAM,SAAS,GAAI,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,WAC4B,CAAC;AACtF,eAAO,MAAM,MAAM,GAAI,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,WAA2B,CAAC;AAElF,2FAA2F;AAC3F,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAU,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAOrF;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAEpD;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wFAAwF;AACxF,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;;;;EAEnE;AAED,oDAAoD;AACpD,eAAO,MAAM,SAAS;;;CAA8D,CAAC"}
package/dist/bytes.js ADDED
@@ -0,0 +1,74 @@
1
+ // Checked integer encoding shared by the codecs. A value is rounded onto its wire grid, then must
2
+ // fit the field; if it doesn't, the codec throws `unrepresentable` rather than clamp it (D33).
3
+ import { BridgeError } from "./errors.js";
4
+ /** `round(value · scale)` as an integer in [min, max], or `unrepresentable`. */
5
+ export function wireInt(value, scale, min, max, what) {
6
+ const raw = Math.round(value * scale);
7
+ if (!Number.isFinite(raw) || raw < min || raw > max) {
8
+ throw new BridgeError('unrepresentable', `${what} ${value} doesn't fit the wire field (${min / scale} to ${max / scale})`);
9
+ }
10
+ // Normalises -0, which some fields would otherwise encode differently from 0.
11
+ return raw === 0 ? 0 : raw;
12
+ }
13
+ export const U8 = [0, 0xff];
14
+ export const I8 = [-0x80, 0x7f];
15
+ export const U16 = [0, 0xffff];
16
+ export const I16 = [-0x8000, 0x7fff];
17
+ export const U32 = [0, 0xffffffff];
18
+ export const I32 = [-0x80000000, 0x7fffffff];
19
+ /** Integer field: rounds `value · scale` and checks it against `range`. */
20
+ export function field(value, scale, range, what) {
21
+ return wireInt(value, scale, range[0], range[1], what);
22
+ }
23
+ export const le16 = (v) => [v & 0xff, (v >> 8) & 0xff];
24
+ export const be16 = (v) => [(v >> 8) & 0xff, v & 0xff];
25
+ export const le32 = (v) => [
26
+ v & 0xff,
27
+ (v >>> 8) & 0xff,
28
+ (v >>> 16) & 0xff,
29
+ (v >>> 24) & 0xff
30
+ ];
31
+ export const be32 = (v) => [
32
+ (v >>> 24) & 0xff,
33
+ (v >>> 16) & 0xff,
34
+ (v >>> 8) & 0xff,
35
+ v & 0xff
36
+ ];
37
+ const at = (bytes, i) => bytes[i] ?? 0;
38
+ export const readU16le = (b, i) => at(b, i) | (at(b, i + 1) << 8);
39
+ export const readU16be = (b, i) => (at(b, i) << 8) | at(b, i + 1);
40
+ export const readI16le = (b, i) => (readU16le(b, i) << 16) >> 16;
41
+ export const readI16be = (b, i) => (readU16be(b, i) << 16) >> 16;
42
+ export const readU32le = (b, i) => (at(b, i) | (at(b, i + 1) << 8) | (at(b, i + 2) << 16) | (at(b, i + 3) << 24)) >>> 0;
43
+ export const readI32le = (b, i) => readU32le(b, i) | 0;
44
+ export const readU32be = (b, i) => ((at(b, i) << 24) | (at(b, i + 1) << 16) | (at(b, i + 2) << 8) | at(b, i + 3)) >>> 0;
45
+ export const readI8 = (b, i) => (at(b, i) << 24) >> 24;
46
+ /** A 32-bit float field: rounded to the nearest float, refused when out of float range. */
47
+ export function f32le(value, what = 'value') {
48
+ if (!(Math.abs(value) <= F32_FIELD.max)) {
49
+ throw new BridgeError('unrepresentable', `${what} ${value} doesn't fit a 32-bit float`);
50
+ }
51
+ const view = new DataView(new ArrayBuffer(4));
52
+ view.setFloat32(0, value, true);
53
+ return [view.getUint8(0), view.getUint8(1), view.getUint8(2), view.getUint8(3)];
54
+ }
55
+ export function readF32le(b, i) {
56
+ const view = new DataView(new ArrayBuffer(4));
57
+ for (let k = 0; k < 4; k++)
58
+ view.setUint8(k, at(b, i + k));
59
+ return view.getFloat32(0, true);
60
+ }
61
+ export function hex(bytes) {
62
+ return Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join(' ');
63
+ }
64
+ /** Float32 values decoded from the wire, rounded to what a float32 field can mean. */
65
+ export function tidyF32(v) {
66
+ return Number(v.toPrecision(7));
67
+ }
68
+ /** The wire field `round(value · scale)` in `range`, as canonical min, max and step. */
69
+ export function grid(scale, range) {
70
+ return { min: range[0] / scale, max: range[1] / scale, step: 1 / scale };
71
+ }
72
+ /** A float32 wire field: no grid, float32 range. */
73
+ export const F32_FIELD = { min: -3.4028234663852886e38, max: 3.4028234663852886e38 };
74
+ //# sourceMappingURL=bytes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bytes.js","sourceRoot":"","sources":["../src/bytes.ts"],"names":[],"mappings":"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"}