node-poweredup 9.0.0 → 10.0.0

package/README.md

@@ -6,7 +6,7 @@
 
 ### Announcements
 
-* v7.1.0 adds support for SPIKE Essential, including the Technic Small Hub, Technic Small Angular Motor, and Technic 3x3 Color Matrix.
+* v10.0.0 brings node-poweredup up to date! Libraries updated, new ES style syntax, and more.
 
 ### Introduction
 
@@ -27,19 +27,16 @@ This library allows communication and control of Powered Up devices and peripher
 ### Sample Usage
 
 ```javascript
-const PoweredUP = require("node-poweredup");
-const poweredUP = new PoweredUP.PoweredUP();
+import { PoweredUP } from "node-poweredup";
+const poweredUP = new PoweredUP();
 
 poweredUP.on("discover", async (hub) => { // Wait to discover a Hub
     console.log(`Discovered ${hub.name}!`);
     await hub.connect(); // Connect to the Hub
-    const motorA = await hub.waitForDeviceAtPort("A"); // Make sure a motor is plugged into port A
     const motorB = await hub.waitForDeviceAtPort("B"); // Make sure a motor is plugged into port B
     console.log("Connected");
 
     while (true) { // Repeat indefinitely
-        console.log("Running motor B at speed 50");
-        motorB.setPower(50); // Start a motor attached to port B to run a 3/4 speed (75) indefinitely
         console.log("Running motor A at speed 100 for 2 seconds");
         motorA.setPower(100); // Run a motor attached to port A for 2 seconds at maximum speed (100) then stop
         await hub.sleep(2000);
@@ -65,15 +62,13 @@ More examples are available in the "examples" directory.
 
 ### Node.js Installation
 
-Node.js v12.0+ required.
+Node.js v18.0+ required.
 
 ```javascript
 npm install node-poweredup --save
 ```
 
-node-poweredup uses the Noble BLE library by Sandeep Mistry. On macOS everything should function out of the box. On Linux and Windows there are [certain dependencies which may need installed first](https://github.com/abandonware/noble#prerequisites).
-
-Note: node-poweredup has been tested on macOS 11.0 and Debian/Raspbian on the Raspberry Pi 3 Model B.
+`node-poweredup` relies on the `@stoprocent/noble` library. Ensure any prerequisites [documented here](https://github.com/stoprocent/noble?tab=readme-ov-file#prerequisites) are satisfied.
 
 ### Compatibility
 
@@ -120,7 +115,7 @@ In addition, the Hubs themselves have certain built-in features which this libra
 
 * The SPIKE Prime Hub does not use Bluetooth Low Energy, so is not supported via this library. It is recommended you use MicroPython to develop for this Hub using the officially provided tools and software. The SPIKE Essential Hub however is supported, as it uses Bluetooth Low Energy.
 
-* On most Unix systems, you need root permissions to access Bluetooth devices. You may want to [grant the node executable access to the Bluetooth adapter](https://github.com/abandonware/noble#running-without-rootsudo-linux-specific)
+* On most Unix systems, you need root permissions to access Bluetooth devices. You may want to [grant the node executable access to the Bluetooth adapter](https://github.com/stoprocent/noble?tab=readme-ov-file#running-without-rootsudo-linux-specific)
 
 ### Credits
 

package/dist/color.d.ts

@@ -0,0 +1,7 @@
+export declare class Color {
+    private _color;
+    private _brightness;
+    constructor(color: number, brightness?: number);
+    toValue(): number;
+}
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAEA,qBAAa,KAAK;IAEd,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAe;gBAErB,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAKxC,OAAO;CAOjB"}

package/dist/color.js

@@ -0,0 +1,15 @@
+import * as Consts from "./consts.js";
+export class Color {
+    constructor(color, brightness) {
+        this._brightness = 100;
+        this._color = color;
+        this._brightness = brightness || 100;
+    }
+    toValue() {
+        if (this._color === Consts.Color.NONE) {
+            return this._color;
+        }
+        return this._color + (Math.round(this._brightness / 10) << 4);
+    }
+}
+//# sourceMappingURL=color.js.map

package/dist/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,MAAM,OAAO,KAAK;IAKd,YAAa,KAAa,EAAE,UAAmB;QAFvC,gBAAW,GAAW,GAAG,CAAC;QAG9B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,WAAW,GAAG,UAAU,IAAI,GAAG,CAAC;IACzC,CAAC;IAEM,OAAO;QACV,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,MAAM,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC;CAEJ"}