@microbit/microbit-connection 0.9.0-apps.alpha.9 → 1.0.0-beta.1

package/build/esm/events.d.ts

@@ -1,110 +1,10 @@
-/**
- * Copyright (c) 2022 Jonas "DerZade" Schade
- *
- * SPDX-License-Identifier: MIT
- *
- * https://github.com/DerZade/typescript-event-target/blob/master/src/TypedEventTarget.ts
- */
-/**
- * A function that can be passed to the `listener` parameter of {@link TypedEventTarget.addEventListener} and {@link TypedEventTarget.removeEventListener}.
- *
- * @template M A map of event types to their respective event classes.
- * @template T The type of event to listen for (has to be keyof `M`).
- */
-export type TypedEventListener<M, T extends keyof M> = (evt: M[T]) => void | Promise<void>;
-/**
- * An object that can be passed to the `listener` parameter of {@link TypedEventTarget.addEventListener} and {@link TypedEventTarget.removeEventListener}.
- *
- * @template M A map of event types to their respective event classes.
- * @template T The type of event to listen for (has to be keyof `M`).
- */
-export interface TypedEventListenerObject<M, T extends keyof M> {
-    handleEvent: (evt: M[T]) => void | Promise<void>;
-}
-/**
- * Type of parameter `listener` in {@link TypedEventTarget.addEventListener} and {@link TypedEventTarget.removeEventListener}.
- *
- * The object that receives a notification (an object that implements the Event interface) when an event of the specified type occurs.
- *
- * Can be either an object with a handleEvent() method, or a JavaScript function.
- *
- * @template M A map of event types to their respective event classes.
- * @template T The type of event to listen for (has to be keyof `M`).
- */
-export type TypedEventListenerOrEventListenerObject<M, T extends keyof M> = TypedEventListener<M, T> | TypedEventListenerObject<M, T>;
-export type ValueIsEvent<T> = {
-    [key in keyof T]: Event;
-};
-/**
- * Typescript friendly version of {@link EventTarget}
- *
- * @template M A map of event types to their respective event classes.
- *
- * @example
- * ```typescript
- * interface MyEventMap {
- *     hello: Event;
- *     time: CustomEvent<number>;
- * }
- *
- * const eventTarget = new TypedEventTarget<MyEventMap>();
- *
- * eventTarget.addEventListener('time', (event) => {
- *     // event is of type CustomEvent<number>
- * });
- * ```
- */
-export interface TypedEventTarget<M extends ValueIsEvent<M>> {
-    /** Appends an event listener for events whose type attribute value is type.
-     * The callback argument sets the callback that will be invoked when the event
-     * is dispatched.
-     *
-     * The options argument sets listener-specific options. For compatibility this
-     * can be a boolean, in which case the method behaves exactly as if the value
-     * was specified as options's capture.
-     *
-     * When set to true, options's capture prevents callback from being invoked
-     * when the event's eventPhase attribute value is BUBBLING_PHASE. When false
-     * (or not present), callback will not be invoked when event's eventPhase
-     * attribute value is CAPTURING_PHASE. Either way, callback will be invoked if
-     * event's eventPhase attribute value is AT_TARGET.
-     *
-     * When set to true, options's passive indicates that the callback will not
-     * cancel the event by invoking preventDefault(). This is used to enable
-     * performance optimizations described in § 2.8 Observing event listeners.
-     *
-     * When set to true, options's once indicates that the callback will only be
-     * invoked once after which the event listener will be removed.
-     *
-     * The event listener is appended to target's event listener list and is not
-     * appended if it has the same type, callback, and capture. */
-    addEventListener: <T extends keyof M & string>(type: T, listener: TypedEventListenerOrEventListenerObject<M, T> | null, options?: boolean | AddEventListenerOptions) => void;
-    /** Removes the event listener in target's event listener list with the same
-     * type, callback, and options. */
-    removeEventListener: <T extends keyof M & string>(type: T, callback: TypedEventListenerOrEventListenerObject<M, T> | null, options?: EventListenerOptions | boolean) => void;
-    /**
-     * Dispatches a synthetic event event to target and returns true if either
-     * event's cancelable attribute value is false or its preventDefault() method
-     * was not invoked, and false otherwise.
-     * @deprecated To ensure type safety use `dispatchTypedEvent` instead.
-     */
-    dispatchEvent: (event: Event) => boolean;
-}
-export declare class TrackingEventTarget extends EventTarget {
-    private activeEventTracking;
-    addEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: AddEventListenerOptions | boolean): void;
-    removeEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: EventListenerOptions | boolean): void;
-    dispatchEvent(event: Event): boolean;
-    private filterRegistrations;
-    protected eventActivated(type: string): void;
-    protected eventDeactivated(type: string): void;
+export type Listener<T> = (data: T) => void;
+export declare class TypedEventTarget<M> {
+    private listeners;
+    addEventListener<K extends keyof M & string>(type: K, listener: Listener<M[K]>): void;
+    removeEventListener<K extends keyof M & string>(type: K, listener: Listener<M[K]>): void;
+    protected dispatchEvent<K extends keyof M & string>(type: K, ...[data]: M[K] extends void ? [] : [data: M[K]]): void;
+    protected eventActivated(_type: string): void;
+    protected eventDeactivated(_type: string): void;
     protected getActiveEvents(): string[];
 }
-export declare class TypedEventTarget<M extends ValueIsEvent<M>> extends TrackingEventTarget {
-    /**
-     * Dispatches a synthetic event event to target and returns true if either
-     * event's cancelable attribute value is false or its preventDefault() method
-     * was not invoked, and false otherwise.
-     */
-    dispatchTypedEvent<T extends keyof M>(_type: T, event: M[T]): boolean;
-}

package/build/esm/events.js

@@ -1,104 +1,44 @@
-/**
- * Copyright (c) 2022 Jonas "DerZade" Schade
- *
- * SPDX-License-Identifier: MIT
- *
- * https://github.com/DerZade/typescript-event-target/blob/master/src/TypedEventTarget.ts
- */
-// We've added this in to keep track of what events are active.
-// Having done this it's questionable whether it's worth the reimplementation
-// just to use an EventTarget API.
-export class TrackingEventTarget extends EventTarget {
+export class TypedEventTarget {
     constructor() {
-        super(...arguments);
-        Object.defineProperty(this, "activeEventTracking", {
+        Object.defineProperty(this, "listeners", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: new Map()
         });
     }
-    addEventListener(type, callback, options) {
-        if (callback !== null) {
-            const registrations = this.activeEventTracking.get(type) ?? [];
-            const wasEmpty = registrations.length === 0;
-            const registration = new Registration(callback, options ?? false);
-            if (!registrations.find((r) => r.eq(registration))) {
-                registrations.push(registration);
-                this.activeEventTracking.set(type, registrations);
-                if (wasEmpty) {
-                    this.eventActivated(type);
-                }
-            }
+    addEventListener(type, listener) {
+        let set = this.listeners.get(type);
+        const wasEmpty = !set || set.size === 0;
+        if (!set) {
+            set = new Set();
+            this.listeners.set(type, set);
         }
-        super.addEventListener(type, callback, options);
-    }
-    removeEventListener(type, callback, options) {
-        if (callback !== null) {
-            const registration = new Registration(callback, options ?? false);
-            this.filterRegistrations(type, (r) => !r.eq(registration));
+        if (!set.has(listener)) {
+            set.add(listener);
+            if (wasEmpty)
+                this.eventActivated(type);
         }
-        super.removeEventListener(type, callback, options);
-    }
-    dispatchEvent(event) {
-        const result = super.dispatchEvent(event);
-        this.filterRegistrations(event.type, (r) => !r.isOnce());
-        return result;
     }
-    filterRegistrations(type, predicate) {
-        let registrations = this.activeEventTracking.get(type) ?? [];
-        registrations = registrations.filter(predicate);
-        if (registrations.length === 0) {
-            this.activeEventTracking.delete(type);
+    removeEventListener(type, listener) {
+        const set = this.listeners.get(type);
+        if (set?.delete(listener) && set.size === 0) {
+            this.listeners.delete(type);
             this.eventDeactivated(type);
         }
-        else {
-            this.activeEventTracking.set(type, registrations);
+    }
+    dispatchEvent(type, ...[data]) {
+        const set = this.listeners.get(type);
+        if (set) {
+            for (const listener of set) {
+                listener(data);
+            }
         }
     }
-    eventActivated(type) { }
-    eventDeactivated(type) { }
+    eventActivated(_type) { }
+    eventDeactivated(_type) { }
     getActiveEvents() {
-        return [...this.activeEventTracking.keys()];
-    }
-}
-// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
-export class TypedEventTarget extends TrackingEventTarget {
-    /**
-     * Dispatches a synthetic event event to target and returns true if either
-     * event's cancelable attribute value is false or its preventDefault() method
-     * was not invoked, and false otherwise.
-     */
-    dispatchTypedEvent(_type, event) {
-        return super.dispatchEvent(event);
-    }
-}
-class Registration {
-    constructor(callback, options) {
-        Object.defineProperty(this, "callback", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: callback
-        });
-        Object.defineProperty(this, "options", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: options
-        });
-    }
-    isOnce() {
-        return typeof this.options === "object" && this.options.once === true;
-    }
-    eq(other) {
-        return (other.callback === this.callback &&
-            eqUseCapture(this.options, other.options));
+        return [...this.listeners.keys()];
     }
 }
-const eqUseCapture = (left, right) => {
-    const leftValue = typeof left === "boolean" ? left : left.capture ?? false;
-    const rightValue = typeof right === "boolean" ? right : right.capture ?? false;
-    return leftValue === rightValue;
-};
 //# sourceMappingURL=events.js.map

package/build/esm/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../lib/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAgB;IAA7B;QACU;;;;mBAAY,IAAI,GAAG,EAA8B;WAAC;IA8C5D,CAAC;IA5CC,gBAAgB,CACd,IAAO,EACP,QAAwB;QAExB,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAClB,IAAI,QAAQ;gBAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,mBAAmB,CACjB,IAAO,EACP,QAAwB;QAExB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAES,aAAa,CACrB,IAAO,EACP,GAAG,CAAC,IAAI,CAAwC;QAEhD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,GAAG,EAAE,CAAC;YACR,KAAK,MAAM,QAAQ,IAAI,GAAG,EAAE,CAAC;gBAC3B,QAAQ,CAAC,IAAY,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAES,cAAc,CAAC,KAAa,IAAS,CAAC;IACtC,gBAAgB,CAAC,KAAa,IAAS,CAAC;IACxC,eAAe;QACvB,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAa,CAAC;IAChD,CAAC;CACF"}

package/build/esm/hex-util.d.ts

@@ -0,0 +1 @@
+export declare const truncateHexAfterEof: (hex: string) => string;

package/build/esm/hex-util.js

@@ -0,0 +1,11 @@
+// MakeCode hex files may contain embedded source in custom record types
+// (type 0x0E) after the EOF record, and older files may have trailing blank
+// lines. The nrf-intel-hex parser rejects any data after EOF, so we truncate.
+export const truncateHexAfterEof = (hex) => {
+    // The EOF record is :00000001FF (case-insensitive per the Intel HEX spec).
+    const eofIdx = hex.search(/:00000001FF/i);
+    if (eofIdx < 0)
+        return hex;
+    return hex.slice(0, eofIdx + ":00000001FF".length) + "\n";
+};
+//# sourceMappingURL=hex-util.js.map

package/build/esm/hex-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex-util.js","sourceRoot":"","sources":["../../src/hex-util.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,4EAA4E;AAC5E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAU,EAAE;IACzD,2EAA2E;IAC3E,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC1C,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC3B,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AAC5D,CAAC,CAAC"}

package/build/esm/index.d.ts

@@ -1,17 +1,9 @@
-import { AccelerometerData, AccelerometerDataEvent } from "./accelerometer.js";
-import { createWebBluetoothConnection, MicrobitWebBluetoothConnection, MicrobitWebBluetoothConnectionOptions } from "./bluetooth.js";
-import { BoardId } from "./board-id.js";
-import { ButtonEvent, ButtonEventType, ButtonState } from "./buttons.js";
-import { AfterRequestDevice, BackgroundErrorEvent, BeforeRequestDevice, BoardVersion, ConnectOptions, ConnectionAvailabilityStatus, ConnectionStatus, ConnectionStatusEvent, DeviceConnection, DeviceConnectionEventMap, DeviceError, DeviceErrorCode, FlashDataError, FlashDataSource, FlashOptions, ProgressCallback, ProgressStage } from "./device.js";
-import { TypedEventTarget } from "./events.js";
-import { createUniversalHexFlashDataSource } from "./hex-flash-data-source.js";
-import { LedMatrix } from "./led.js";
+/**
+ * @module @microbit/microbit-connection
+ */
+import { BackgroundErrorData, BoardVersion, BondMode, ConnectOptions, ConnectionAvailabilityStatus, ConnectionStatus, ConnectionStatusChange, DeviceConnection, DeviceError, DeviceErrorCode, FlashDataError, FlashDataSource, FlashOptions, ProgressCallback, ProgressStage, assertConnected } from "./device.js";
 import { Logging, LoggingEvent } from "./logging.js";
-import { MagnetometerData, MagnetometerDataEvent } from "./magnetometer.js";
-import { FlashEvent, SerialConnectionEventMap, SerialDataEvent, SerialErrorEvent, SerialResetEvent } from "./serial-events.js";
-import { ServiceConnectionEventMap } from "./service-events.js";
-import { UARTDataEvent } from "./uart.js";
-import { createRadioBridgeConnection, MicrobitRadioBridgeConnection, MicrobitRadioBridgeConnectionOptions } from "./usb-radio-bridge.js";
-import { createWebUSBConnection, DeviceSelectionMode, MicrobitWebUSBConnection, MicrobitWebUSBConnectionOptions } from "./usb.js";
-export { AfterRequestDevice, BackgroundErrorEvent, BeforeRequestDevice, BoardId, ConnectionStatus, ConnectionStatusEvent, createRadioBridgeConnection, createUniversalHexFlashDataSource, createWebBluetoothConnection, createWebUSBConnection, DeviceConnectionEventMap, DeviceSelectionMode, DeviceError, FlashDataError, FlashEvent, ProgressStage, SerialConnectionEventMap, SerialDataEvent, SerialErrorEvent, SerialResetEvent, ServiceConnectionEventMap, TypedEventTarget, UARTDataEvent, };
-export type { AccelerometerData, AccelerometerDataEvent, BoardVersion, ConnectionAvailabilityStatus, ButtonEvent, ButtonEventType, ButtonState, ConnectOptions, DeviceConnection, DeviceErrorCode, FlashDataSource, FlashOptions, LedMatrix, Logging, LoggingEvent, MagnetometerData, MagnetometerDataEvent, MicrobitRadioBridgeConnection, MicrobitRadioBridgeConnectionOptions, MicrobitWebBluetoothConnection, MicrobitWebBluetoothConnectionOptions, MicrobitWebUSBConnection, MicrobitWebUSBConnectionOptions, ProgressCallback, };
+import { AccelerometerData, ButtonActionData, ButtonData, ButtonActionType, ButtonState, GestureData, MicrobitEventData, PinValue, PinData, LedMatrix, MagnetometerData, TemperatureData, UartData } from "./service-events.js";
+import { ButtonAction, GestureEvent } from "./microbit-events.js";
+export { ButtonAction, ButtonState, ConnectionStatus, DeviceError, FlashDataError, GestureEvent, assertConnected, ProgressStage, };
+export type { AccelerometerData, BackgroundErrorData, BoardVersion, BondMode, ButtonActionData, ButtonData, ButtonActionType, ConnectOptions, ConnectionAvailabilityStatus, ConnectionStatusChange, DeviceConnection, DeviceErrorCode, FlashDataSource, FlashOptions, GestureData, MicrobitEventData, PinValue, PinData, LedMatrix, Logging, LoggingEvent, MagnetometerData, ProgressCallback, TemperatureData, UartData, };

package/build/esm/index.js

@@ -1,12 +1,8 @@
-import { createWebBluetoothConnection, } from "./bluetooth.js";
-import { BoardId } from "./board-id.js";
-import { AfterRequestDevice, BackgroundErrorEvent, BeforeRequestDevice, ConnectionStatus, ConnectionStatusEvent, DeviceConnectionEventMap, DeviceError, FlashDataError, ProgressStage, } from "./device.js";
-import { TypedEventTarget } from "./events.js";
-import { createUniversalHexFlashDataSource } from "./hex-flash-data-source.js";
-import { FlashEvent, SerialConnectionEventMap, SerialDataEvent, SerialErrorEvent, SerialResetEvent, } from "./serial-events.js";
-import { ServiceConnectionEventMap } from "./service-events.js";
-import { UARTDataEvent } from "./uart.js";
-import { createRadioBridgeConnection, } from "./usb-radio-bridge.js";
-import { createWebUSBConnection, DeviceSelectionMode, } from "./usb.js";
-export { AfterRequestDevice, BackgroundErrorEvent, BeforeRequestDevice, BoardId, ConnectionStatus, ConnectionStatusEvent, createRadioBridgeConnection, createUniversalHexFlashDataSource, createWebBluetoothConnection, createWebUSBConnection, DeviceConnectionEventMap, DeviceSelectionMode, DeviceError, FlashDataError, FlashEvent, ProgressStage, SerialConnectionEventMap, SerialDataEvent, SerialErrorEvent, SerialResetEvent, ServiceConnectionEventMap, TypedEventTarget, UARTDataEvent, };
+/**
+ * @module @microbit/microbit-connection
+ */
+import { ConnectionStatus, DeviceError, FlashDataError, ProgressStage, assertConnected, } from "./device.js";
+import { ButtonState, } from "./service-events.js";
+import { ButtonAction, GestureEvent } from "./microbit-events.js";
+export { ButtonAction, ButtonState, ConnectionStatus, DeviceError, FlashDataError, GestureEvent, assertConnected, ProgressStage, };
 //# sourceMappingURL=index.js.map

package/build/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,4BAA4B,GAG7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EAInB,gBAAgB,EAChB,qBAAqB,EAErB,wBAAwB,EACxB,WAAW,EAEX,cAAc,EAId,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAC;AAI/E,OAAO,EACL,UAAU,EACV,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,2BAA2B,GAG5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GAGpB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,OAAO,EACP,gBAAgB,EAChB,qBAAqB,EACrB,2BAA2B,EAC3B,iCAAiC,EACjC,4BAA4B,EAC5B,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,UAAU,EACV,aAAa,EACb,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,gBAAgB,EAChB,aAAa,GACd,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAML,gBAAgB,EAGhB,WAAW,EAEX,cAAc,EAId,aAAa,EACb,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAKL,WAAW,GASZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EACL,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,GACd,CAAC"}

package/build/esm/logging.js.map

@@ -1 +1 @@
-{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../lib/logging.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,MAAoB;QACxB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,KAAK,CAAC,EAAU,EAAE,EAAW;QAC3B,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACxB,CAAC;IACD,GAAG,CAAC,EAAO;QACT,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;CACF"}
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/logging.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,MAAoB;QACxB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,KAAK,CAAC,EAAU,EAAE,EAAW;QAC3B,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACxB,CAAC;IACD,GAAG,CAAC,EAAO;QACT,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;CACF"}

package/build/esm/microbit-events.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Well-known micro:bit message bus event source IDs and values.
+ *
+ * Source IDs differ between V1 (DAL) and V2 (CODAL). Event values are
+ * identical across versions (V2 adds TwoG to gesture values).
+ *
+ * @see https://lancaster-university.github.io/microbit-docs/
+ */
+/**
+ * Event source IDs for micro:bit V1 (DAL).
+ */
+export declare const V1Source: {
+    readonly ButtonA: 1;
+    readonly ButtonB: 2;
+    readonly ButtonAB: 26;
+    readonly Gesture: 27;
+};
+/**
+ * Event source IDs for micro:bit V2 (CODAL).
+ */
+export declare const V2Source: {
+    readonly ButtonA: 1;
+    readonly ButtonB: 2;
+    readonly ButtonAB: 3;
+    readonly Gesture: 13;
+    readonly Logo: 121;
+};
+export declare const EventSource: {
+    readonly v1: {
+        readonly ButtonA: 1;
+        readonly ButtonB: 2;
+        readonly ButtonAB: 26;
+        readonly Gesture: 27;
+    };
+    readonly v2: {
+        readonly ButtonA: 1;
+        readonly ButtonB: 2;
+        readonly ButtonAB: 3;
+        readonly Gesture: 13;
+        readonly Logo: 121;
+    };
+};
+export declare const GestureEvent: {
+    readonly TiltUp: 1;
+    readonly TiltDown: 2;
+    readonly TiltLeft: 3;
+    readonly TiltRight: 4;
+    readonly FaceUp: 5;
+    readonly FaceDown: 6;
+    readonly Freefall: 7;
+    readonly Acceleration3g: 8;
+    readonly Acceleration6g: 9;
+    readonly Acceleration8g: 10;
+    readonly Shake: 11;
+    /** V2 only. */
+    readonly Acceleration2g: 12;
+};
+export type GestureEvent = (typeof GestureEvent)[keyof typeof GestureEvent];
+export declare const ButtonAction: {
+    readonly Down: 1;
+    readonly Up: 2;
+    readonly Click: 3;
+    readonly LongClick: 4;
+    readonly Hold: 5;
+    readonly DoubleClick: 6;
+};
+export type ButtonAction = (typeof ButtonAction)[keyof typeof ButtonAction];

package/build/esm/microbit-events.js

@@ -0,0 +1,52 @@
+/**
+ * Well-known micro:bit message bus event source IDs and values.
+ *
+ * Source IDs differ between V1 (DAL) and V2 (CODAL). Event values are
+ * identical across versions (V2 adds TwoG to gesture values).
+ *
+ * @see https://lancaster-university.github.io/microbit-docs/
+ */
+/**
+ * Event source IDs for micro:bit V1 (DAL).
+ */
+export const V1Source = {
+    ButtonA: 1,
+    ButtonB: 2,
+    ButtonAB: 26,
+    Gesture: 27,
+};
+/**
+ * Event source IDs for micro:bit V2 (CODAL).
+ */
+export const V2Source = {
+    ButtonA: 1,
+    ButtonB: 2,
+    ButtonAB: 3,
+    Gesture: 13,
+    Logo: 121,
+};
+export const EventSource = { v1: V1Source, v2: V2Source };
+export const GestureEvent = {
+    TiltUp: 1,
+    TiltDown: 2,
+    TiltLeft: 3,
+    TiltRight: 4,
+    FaceUp: 5,
+    FaceDown: 6,
+    Freefall: 7,
+    Acceleration3g: 8,
+    Acceleration6g: 9,
+    Acceleration8g: 10,
+    Shake: 11,
+    /** V2 only. */
+    Acceleration2g: 12,
+};
+export const ButtonAction = {
+    Down: 1,
+    Up: 2,
+    Click: 3,
+    LongClick: 4,
+    Hold: 5,
+    DoubleClick: 6,
+};
+//# sourceMappingURL=microbit-events.js.map

package/build/esm/microbit-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"microbit-events.js","sourceRoot":"","sources":["../../src/microbit-events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,EAAE;CACH,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,EAAE;IACX,IAAI,EAAE,GAAG;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAW,CAAC;AAEnE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,cAAc,EAAE,CAAC;IACjB,cAAc,EAAE,CAAC;IACjB,cAAc,EAAE,EAAE;IAClB,KAAK,EAAE,EAAE;IACT,eAAe;IACf,cAAc,EAAE,EAAE;CACV,CAAC;AAGX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,CAAC;IACP,EAAE,EAAE,CAAC;IACL,KAAK,EAAE,CAAC;IACR,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;IACP,WAAW,EAAE,CAAC;CACN,CAAC"}

package/build/esm/radio-bridge/connection.d.ts

@@ -0,0 +1,52 @@
+/**
+ * (c) 2023, Center for Computational Thinking and Design at Aarhus University and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+import { BackgroundErrorData, ConnectionStatusChange, DeviceConnection } from "../device.js";
+import { Logging } from "../logging.js";
+import { AccelerometerData, ButtonData } from "../service-events.js";
+import { MicrobitUSBConnection } from "../usb/connection.js";
+export interface MicrobitRadioBridgeConnectionOptions {
+    logging?: Logging;
+}
+/**
+ * A connection to a remote micro:bit via a USB-connected micro:bit running
+ * radio bridge firmware. Sensor data is relayed over a serial protocol.
+ *
+ * @experimental This connection type has limited service support compared to
+ * direct Bluetooth connections:
+ *
+ * - `accelerometerdatachanged`, `buttonachanged`, `buttonbchanged` events
+ *   are supported.
+ * - `flash` is not supported.
+ */
+export interface MicrobitRadioBridgeConnection extends DeviceConnection {
+    readonly type: "radio-bridge";
+    addEventListener(type: "status", listener: (data: ConnectionStatusChange) => void): void;
+    addEventListener(type: "backgrounderror", listener: (data: BackgroundErrorData) => void): void;
+    addEventListener(type: "beforerequestdevice", listener: () => void): void;
+    addEventListener(type: "afterrequestdevice", listener: () => void): void;
+    addEventListener(type: "flash", listener: () => void): void;
+    addEventListener(type: "accelerometerdatachanged", listener: (data: AccelerometerData) => void): void;
+    addEventListener(type: "buttonachanged" | "buttonbchanged", listener: (data: ButtonData) => void): void;
+    removeEventListener(type: "status", listener: (data: ConnectionStatusChange) => void): void;
+    removeEventListener(type: "backgrounderror", listener: (data: BackgroundErrorData) => void): void;
+    removeEventListener(type: "beforerequestdevice", listener: () => void): void;
+    removeEventListener(type: "afterrequestdevice", listener: () => void): void;
+    removeEventListener(type: "flash", listener: () => void): void;
+    removeEventListener(type: "accelerometerdatachanged", listener: (data: AccelerometerData) => void): void;
+    removeEventListener(type: "buttonachanged" | "buttonbchanged", listener: (data: ButtonData) => void): void;
+    /**
+     * Sets remote device.
+     *
+     * @param deviceId The device id of remote micro:bit.
+     */
+    setRemoteDeviceId(deviceId: number): void;
+}
+/**
+ * A radio bridge connection factory.
+ *
+ * @experimental See {@link MicrobitRadioBridgeConnection} for limitations.
+ */
+export declare const createRadioBridgeConnection: (delegate: MicrobitUSBConnection, options?: MicrobitRadioBridgeConnectionOptions) => MicrobitRadioBridgeConnection;