fix lint

Author: brianignacio5

src/image/base.ts

@@ -5,11 +5,23 @@ import { checksum, ESP_CHECKSUM_MAGIC, padTo } from "../util";
 
 export const ESP_IMAGE_MAGIC = 0xe9;
 
+/**
+ * Return position aligned to size
+ * @param {number} position Position to align
+ * @param {number} size Alignment size
+ * @returns {number} Aligned position
+ */
 export function alignFilePosition(position: number, size: number): number {
   const align = size - 1 - (position % size);
   return position + align;
 }
 
+/**
+ * Read a UINT32 from a byte array (little-endian)
+ * @param {Uint8Array} data Data to read a UINT32
+ * @param {number} offset data start offset
+ * @returns {number} The read UINT32 value
+ */
 function readUInt32LE(data: Uint8Array, offset: number): number {
   return data[offset] | (data[offset + 1] << 8) | (data[offset + 2] << 16) | (data[offset + 3] << 24);
 }
@@ -233,8 +245,8 @@ export class BaseFirmwareImage {
 
   /**
    * Return ESPLoader checksum from end of just-read image
-   * @param data image to read checksum from
-   * @param offset Current offset in image
+   * @param {Uint8Array} data image to read checksum from
+   * @param {number} offset Current offset in image
    * @returns {number} checksum value
    */
   readChecksum(data: Uint8Array, offset: number): number {

src/image/index.ts

@@ -19,7 +19,7 @@ import {
 /**
  * Function to load a firmware image from a string (from FileReader)
  * @param {ROM} rom - The ROM object representing the target device
- * @param imageData Image data as a string
+ * @param {string} imageData Image data as a string
  * @returns {Promise<BaseFirmwareImage>} - A promise that resolves to the loaded firmware image
  */
 export async function loadFirmwareImage(rom: ROM, imageData: string): Promise<BaseFirmwareImage> {

src/webserial.ts

@@ -71,16 +71,15 @@ class Transport {
 
   /**
    * Set callback for when device is lost
-   * @param callback Function to call when device is lost
+   * @param {Function} callback Function to call when device is lost
    */
   setDeviceLostCallback(callback: (() => void) | null) {
     this.onDeviceLostCallback = callback;
   }
 
-
   /**
    * Update the device reference (used when re-selecting device after reset)
-   * @param newDevice New SerialPort device
+   * @param {typeof import("w3c-web-serial").SerialPort} newDevice New SerialPort device
    */
   updateDevice(newDevice: SerialPort) {
     this.device = newDevice;
@@ -407,9 +406,9 @@ class Transport {
       }
     } catch (error) {
       console.error("Error reading from serial port:", error);
-      
+
       // Check if it's a NetworkError indicating device loss
-      if (error instanceof Error && error.name === 'NetworkError' && error.message.includes('device has been lost')) {
+      if (error instanceof Error && error.name === "NetworkError" && error.message.includes("device has been lost")) {
         this.trace("Device lost detected (NetworkError)");
         if (this.onDeviceLostCallback) {
           this.onDeviceLostCallback();