@typecad/hal 1.0.0-alpha.12 → 1.0.0-alpha.13

package/dist/gpio.d.ts

@@ -7,6 +7,19 @@ export declare class OutputPin {
     low(): void;
     toggle(): void;
     write(value: number | boolean): void;
+    /**
+     * Returns the level the program last drove onto this output pin.
+     *
+     * The transpiler tracks every write (high/low/write/toggle and the
+     * asOutput initial value) and lowers this to a compile-time constant
+     * when the state is statically known, or to a tracked shadow variable
+     * the generated writes keep updated. No hardware pin read is performed —
+     * reading back an OUTPUT-only pin is not portable (e.g. Zephyr), so this
+     * reports software truth, not electrical truth.
+     */
+    read(): boolean;
+    isHigh(): boolean;
+    isLow(): boolean;
     pulse(durationMs: number): void;
     tone(frequency: number): ToneChain;
     toneFor(frequency: number, duration: number): void;

package/dist/gpio.js

@@ -19,6 +19,25 @@ export class OutputPin {
     write(value) {
         gpioWrite(this._pin, value);
     }
+    /**
+     * Returns the level the program last drove onto this output pin.
+     *
+     * The transpiler tracks every write (high/low/write/toggle and the
+     * asOutput initial value) and lowers this to a compile-time constant
+     * when the state is statically known, or to a tracked shadow variable
+     * the generated writes keep updated. No hardware pin read is performed —
+     * reading back an OUTPUT-only pin is not portable (e.g. Zephyr), so this
+     * reports software truth, not electrical truth.
+     */
+    read() {
+        return gpioRead(this._pin);
+    }
+    isHigh() {
+        return this.read();
+    }
+    isLow() {
+        return !this.read();
+    }
     pulse(durationMs) {
         gpioWrite(this._pin, 1);
         rawCpp(`delay(${durationMs});`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typecad/hal",
-  "version": "1.0.0-alpha.12",
+  "version": "1.0.0-alpha.13",
   "description": "TypeCAD hardware abstraction layer — GPIO, I2C, SPI, UART as regular TypeScript",
   "type": "module",
   "main": "./dist/index.js",
@@ -50,9 +50,9 @@
   },
   "author": "typecad0",
   "devDependencies": {
-    "@typecad/expect": "1.0.0-alpha.12",
-    "@typecad/board-arduino-uno": "1.0.0-alpha.12",
-    "@typecad/mcu-atmega328p": "1.0.0-alpha.12"
+    "@typecad/expect": "1.0.0-alpha.13",
+    "@typecad/board-arduino-uno": "1.0.0-alpha.13",
+    "@typecad/mcu-atmega328p": "1.0.0-alpha.13"
   },
   "sideEffects": false,
   "exports": {

package/src/gpio.ts

@@ -29,6 +29,28 @@ export class OutputPin {
     gpioWrite(this._pin, value);
   }
 
+  /**
+   * Returns the level the program last drove onto this output pin.
+   *
+   * The transpiler tracks every write (high/low/write/toggle and the
+   * asOutput initial value) and lowers this to a compile-time constant
+   * when the state is statically known, or to a tracked shadow variable
+   * the generated writes keep updated. No hardware pin read is performed —
+   * reading back an OUTPUT-only pin is not portable (e.g. Zephyr), so this
+   * reports software truth, not electrical truth.
+   */
+  read(): boolean {
+    return gpioRead(this._pin) as unknown as boolean;
+  }
+
+  isHigh(): boolean {
+    return this.read();
+  }
+
+  isLow(): boolean {
+    return !this.read();
+  }
+
   pulse(durationMs: number): void {
     gpioWrite(this._pin, 1);
     rawCpp(`delay(${durationMs});`);