@v5x/serial 0.5.6 → 0.5.7

package/dist/index.cjs

@@ -1,5 +1,3 @@
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -7,30 +5,6 @@ var __hasOwnProp = Object.prototype.hasOwnProperty;
 function __accessProp(key) {
   return this[key];
 }
-var __toESMCache_node;
-var __toESMCache_esm;
-var __toESM = (mod, isNodeMode, target) => {
-  var canCache = mod != null && typeof mod === "object";
-  if (canCache) {
-    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
-    var cached = cache.get(mod);
-    if (cached)
-      return cached;
-  }
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  if (mod && typeof mod === "object" || typeof mod === "function") {
-    for (let key of __getOwnPropNames(mod))
-      if (!__hasOwnProp.call(to, key))
-        __defProp(to, key, {
-          get: __accessProp.bind(mod, key),
-          enumerable: true
-        });
-  }
-  if (canCache)
-    cache.set(mod, to);
-  return to;
-};
 var __toCommonJS = (from) => {
   var entry = (__moduleCache ??= new WeakMap).get(from), desc;
   if (entry)
@@ -48,7 +22,6 @@ var __toCommonJS = (from) => {
   return entry;
 };
 var __moduleCache;
-var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __returnValue = (v) => v;
 function __exportSetter(name, newValue) {
   this[name] = __returnValue.bind(null, newValue);
@@ -63,483 +36,6 @@ var __export = (target, all) => {
     });
 };
 
-// ../../node_modules/.bun/neverthrow@8.2.0/node_modules/neverthrow/dist/index.cjs.js
-var require_index_cjs = __commonJS(function(exports2) {
-  var defaultErrorConfig = {
-    withStackTrace: false
-  };
-  var createNeverThrowError = (message, result, config = defaultErrorConfig) => {
-    const data = result.isOk() ? { type: "Ok", value: result.value } : { type: "Err", value: result.error };
-    const maybeStack = config.withStackTrace ? new Error().stack : undefined;
-    return {
-      data,
-      message,
-      stack: maybeStack
-    };
-  };
-  function __awaiter(thisArg, _arguments, P, generator) {
-    function adopt(value) {
-      return value instanceof P ? value : new P(function(resolve) {
-        resolve(value);
-      });
-    }
-    return new (P || (P = Promise))(function(resolve, reject) {
-      function fulfilled(value) {
-        try {
-          step(generator.next(value));
-        } catch (e) {
-          reject(e);
-        }
-      }
-      function rejected(value) {
-        try {
-          step(generator["throw"](value));
-        } catch (e) {
-          reject(e);
-        }
-      }
-      function step(result) {
-        result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected);
-      }
-      step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-  }
-  function __values(o) {
-    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
-    if (m)
-      return m.call(o);
-    if (o && typeof o.length === "number")
-      return {
-        next: function() {
-          if (o && i >= o.length)
-            o = undefined;
-          return { value: o && o[i++], done: !o };
-        }
-      };
-    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
-  }
-  function __await(v) {
-    return this instanceof __await ? (this.v = v, this) : new __await(v);
-  }
-  function __asyncGenerator(thisArg, _arguments, generator) {
-    if (!Symbol.asyncIterator)
-      throw new TypeError("Symbol.asyncIterator is not defined.");
-    var g = generator.apply(thisArg, _arguments || []), i, q = [];
-    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function() {
-      return this;
-    }, i;
-    function awaitReturn(f) {
-      return function(v) {
-        return Promise.resolve(v).then(f, reject);
-      };
-    }
-    function verb(n, f) {
-      if (g[n]) {
-        i[n] = function(v) {
-          return new Promise(function(a, b) {
-            q.push([n, v, a, b]) > 1 || resume(n, v);
-          });
-        };
-        if (f)
-          i[n] = f(i[n]);
-      }
-    }
-    function resume(n, v) {
-      try {
-        step(g[n](v));
-      } catch (e) {
-        settle(q[0][3], e);
-      }
-    }
-    function step(r) {
-      r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r);
-    }
-    function fulfill(value) {
-      resume("next", value);
-    }
-    function reject(value) {
-      resume("throw", value);
-    }
-    function settle(f, v) {
-      if (f(v), q.shift(), q.length)
-        resume(q[0][0], q[0][1]);
-    }
-  }
-  function __asyncDelegator(o) {
-    var i, p;
-    return i = {}, verb("next"), verb("throw", function(e) {
-      throw e;
-    }), verb("return"), i[Symbol.iterator] = function() {
-      return this;
-    }, i;
-    function verb(n, f) {
-      i[n] = o[n] ? function(v) {
-        return (p = !p) ? { value: __await(o[n](v)), done: false } : f ? f(v) : v;
-      } : f;
-    }
-  }
-  function __asyncValues(o) {
-    if (!Symbol.asyncIterator)
-      throw new TypeError("Symbol.asyncIterator is not defined.");
-    var m = o[Symbol.asyncIterator], i;
-    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function() {
-      return this;
-    }, i);
-    function verb(n) {
-      i[n] = o[n] && function(v) {
-        return new Promise(function(resolve, reject) {
-          v = o[n](v), settle(resolve, reject, v.done, v.value);
-        });
-      };
-    }
-    function settle(resolve, reject, d, v) {
-      Promise.resolve(v).then(function(v2) {
-        resolve({ value: v2, done: d });
-      }, reject);
-    }
-  }
-
-  class ResultAsync {
-    constructor(res) {
-      this._promise = res;
-    }
-    static fromSafePromise(promise) {
-      const newPromise = promise.then((value) => new Ok(value));
-      return new ResultAsync(newPromise);
-    }
-    static fromPromise(promise, errorFn) {
-      const newPromise = promise.then((value) => new Ok(value)).catch((e) => new Err(errorFn(e)));
-      return new ResultAsync(newPromise);
-    }
-    static fromThrowable(fn, errorFn) {
-      return (...args) => {
-        return new ResultAsync((() => __awaiter(this, undefined, undefined, function* () {
-          try {
-            return new Ok(yield fn(...args));
-          } catch (error) {
-            return new Err(errorFn ? errorFn(error) : error);
-          }
-        }))());
-      };
-    }
-    static combine(asyncResultList) {
-      return combineResultAsyncList(asyncResultList);
-    }
-    static combineWithAllErrors(asyncResultList) {
-      return combineResultAsyncListWithAllErrors(asyncResultList);
-    }
-    map(f) {
-      return new ResultAsync(this._promise.then((res) => __awaiter(this, undefined, undefined, function* () {
-        if (res.isErr()) {
-          return new Err(res.error);
-        }
-        return new Ok(yield f(res.value));
-      })));
-    }
-    andThrough(f) {
-      return new ResultAsync(this._promise.then((res) => __awaiter(this, undefined, undefined, function* () {
-        if (res.isErr()) {
-          return new Err(res.error);
-        }
-        const newRes = yield f(res.value);
-        if (newRes.isErr()) {
-          return new Err(newRes.error);
-        }
-        return new Ok(res.value);
-      })));
-    }
-    andTee(f) {
-      return new ResultAsync(this._promise.then((res) => __awaiter(this, undefined, undefined, function* () {
-        if (res.isErr()) {
-          return new Err(res.error);
-        }
-        try {
-          yield f(res.value);
-        } catch (e) {}
-        return new Ok(res.value);
-      })));
-    }
-    orTee(f) {
-      return new ResultAsync(this._promise.then((res) => __awaiter(this, undefined, undefined, function* () {
-        if (res.isOk()) {
-          return new Ok(res.value);
-        }
-        try {
-          yield f(res.error);
-        } catch (e) {}
-        return new Err(res.error);
-      })));
-    }
-    mapErr(f) {
-      return new ResultAsync(this._promise.then((res) => __awaiter(this, undefined, undefined, function* () {
-        if (res.isOk()) {
-          return new Ok(res.value);
-        }
-        return new Err(yield f(res.error));
-      })));
-    }
-    andThen(f) {
-      return new ResultAsync(this._promise.then((res) => {
-        if (res.isErr()) {
-          return new Err(res.error);
-        }
-        const newValue = f(res.value);
-        return newValue instanceof ResultAsync ? newValue._promise : newValue;
-      }));
-    }
-    orElse(f) {
-      return new ResultAsync(this._promise.then((res) => __awaiter(this, undefined, undefined, function* () {
-        if (res.isErr()) {
-          return f(res.error);
-        }
-        return new Ok(res.value);
-      })));
-    }
-    match(ok2, _err) {
-      return this._promise.then((res) => res.match(ok2, _err));
-    }
-    unwrapOr(t) {
-      return this._promise.then((res) => res.unwrapOr(t));
-    }
-    safeUnwrap() {
-      return __asyncGenerator(this, arguments, function* safeUnwrap_1() {
-        return yield __await(yield __await(yield* __asyncDelegator(__asyncValues(yield __await(this._promise.then((res) => res.safeUnwrap()))))));
-      });
-    }
-    then(successCallback, failureCallback) {
-      return this._promise.then(successCallback, failureCallback);
-    }
-    [Symbol.asyncIterator]() {
-      return __asyncGenerator(this, arguments, function* _a() {
-        const result = yield __await(this._promise);
-        if (result.isErr()) {
-          yield yield __await(errAsync(result.error));
-        }
-        return yield __await(result.value);
-      });
-    }
-  }
-  function okAsync(value) {
-    return new ResultAsync(Promise.resolve(new Ok(value)));
-  }
-  function errAsync(err2) {
-    return new ResultAsync(Promise.resolve(new Err(err2)));
-  }
-  var fromPromise = ResultAsync.fromPromise;
-  var fromSafePromise = ResultAsync.fromSafePromise;
-  var fromAsyncThrowable = ResultAsync.fromThrowable;
-  var combineResultList = (resultList) => {
-    let acc = ok([]);
-    for (const result of resultList) {
-      if (result.isErr()) {
-        acc = err(result.error);
-        break;
-      } else {
-        acc.map((list) => list.push(result.value));
-      }
-    }
-    return acc;
-  };
-  var combineResultAsyncList = (asyncResultList) => ResultAsync.fromSafePromise(Promise.all(asyncResultList)).andThen(combineResultList);
-  var combineResultListWithAllErrors = (resultList) => {
-    let acc = ok([]);
-    for (const result of resultList) {
-      if (result.isErr() && acc.isErr()) {
-        acc.error.push(result.error);
-      } else if (result.isErr() && acc.isOk()) {
-        acc = err([result.error]);
-      } else if (result.isOk() && acc.isOk()) {
-        acc.value.push(result.value);
-      }
-    }
-    return acc;
-  };
-  var combineResultAsyncListWithAllErrors = (asyncResultList) => ResultAsync.fromSafePromise(Promise.all(asyncResultList)).andThen(combineResultListWithAllErrors);
-  exports2.Result = undefined;
-  (function(Result) {
-    function fromThrowable2(fn, errorFn) {
-      return (...args) => {
-        try {
-          const result = fn(...args);
-          return ok(result);
-        } catch (e) {
-          return err(errorFn ? errorFn(e) : e);
-        }
-      };
-    }
-    Result.fromThrowable = fromThrowable2;
-    function combine(resultList) {
-      return combineResultList(resultList);
-    }
-    Result.combine = combine;
-    function combineWithAllErrors(resultList) {
-      return combineResultListWithAllErrors(resultList);
-    }
-    Result.combineWithAllErrors = combineWithAllErrors;
-  })(exports2.Result || (exports2.Result = {}));
-  function ok(value) {
-    return new Ok(value);
-  }
-  function err(err2) {
-    return new Err(err2);
-  }
-  function safeTry(body) {
-    const n = body().next();
-    if (n instanceof Promise) {
-      return new ResultAsync(n.then((r) => r.value));
-    }
-    return n.value;
-  }
-
-  class Ok {
-    constructor(value) {
-      this.value = value;
-    }
-    isOk() {
-      return true;
-    }
-    isErr() {
-      return !this.isOk();
-    }
-    map(f) {
-      return ok(f(this.value));
-    }
-    mapErr(_f) {
-      return ok(this.value);
-    }
-    andThen(f) {
-      return f(this.value);
-    }
-    andThrough(f) {
-      return f(this.value).map((_value) => this.value);
-    }
-    andTee(f) {
-      try {
-        f(this.value);
-      } catch (e) {}
-      return ok(this.value);
-    }
-    orTee(_f) {
-      return ok(this.value);
-    }
-    orElse(_f) {
-      return ok(this.value);
-    }
-    asyncAndThen(f) {
-      return f(this.value);
-    }
-    asyncAndThrough(f) {
-      return f(this.value).map(() => this.value);
-    }
-    asyncMap(f) {
-      return ResultAsync.fromSafePromise(f(this.value));
-    }
-    unwrapOr(_v) {
-      return this.value;
-    }
-    match(ok2, _err) {
-      return ok2(this.value);
-    }
-    safeUnwrap() {
-      const value = this.value;
-      return function* () {
-        return value;
-      }();
-    }
-    _unsafeUnwrap(_) {
-      return this.value;
-    }
-    _unsafeUnwrapErr(config) {
-      throw createNeverThrowError("Called `_unsafeUnwrapErr` on an Ok", this, config);
-    }
-    *[Symbol.iterator]() {
-      return this.value;
-    }
-  }
-
-  class Err {
-    constructor(error) {
-      this.error = error;
-    }
-    isOk() {
-      return false;
-    }
-    isErr() {
-      return !this.isOk();
-    }
-    map(_f) {
-      return err(this.error);
-    }
-    mapErr(f) {
-      return err(f(this.error));
-    }
-    andThrough(_f) {
-      return err(this.error);
-    }
-    andTee(_f) {
-      return err(this.error);
-    }
-    orTee(f) {
-      try {
-        f(this.error);
-      } catch (e) {}
-      return err(this.error);
-    }
-    andThen(_f) {
-      return err(this.error);
-    }
-    orElse(f) {
-      return f(this.error);
-    }
-    asyncAndThen(_f) {
-      return errAsync(this.error);
-    }
-    asyncAndThrough(_f) {
-      return errAsync(this.error);
-    }
-    asyncMap(_f) {
-      return errAsync(this.error);
-    }
-    unwrapOr(v) {
-      return v;
-    }
-    match(_ok, err2) {
-      return err2(this.error);
-    }
-    safeUnwrap() {
-      const error = this.error;
-      return function* () {
-        yield err(error);
-        throw new Error("Do not use this generator out of `safeTry`");
-      }();
-    }
-    _unsafeUnwrap(config) {
-      throw createNeverThrowError("Called `_unsafeUnwrap` on an Err", this, config);
-    }
-    _unsafeUnwrapErr(_) {
-      return this.error;
-    }
-    *[Symbol.iterator]() {
-      const self = this;
-      yield self;
-      return self;
-    }
-  }
-  var fromThrowable = exports2.Result.fromThrowable;
-  exports2.Err = Err;
-  exports2.Ok = Ok;
-  exports2.ResultAsync = ResultAsync;
-  exports2.err = err;
-  exports2.errAsync = errAsync;
-  exports2.fromAsyncThrowable = fromAsyncThrowable;
-  exports2.fromPromise = fromPromise;
-  exports2.fromSafePromise = fromSafePromise;
-  exports2.fromThrowable = fromThrowable;
-  exports2.ok = ok;
-  exports2.okAsync = okAsync;
-  exports2.safeTry = safeTry;
-});
-
 // src/index.ts
 var exports_src = {};
 __export(exports_src, {
@@ -757,6 +253,7 @@ var AckType;
   AckType2[AckType2["CDC2_NACK_FILE_SYS_FULL"] = 220] = "CDC2_NACK_FILE_SYS_FULL";
   AckType2[AckType2["TIMEOUT"] = 256] = "TIMEOUT";
   AckType2[AckType2["WRITE_ERROR"] = 257] = "WRITE_ERROR";
+  AckType2[AckType2["NOT_CONNECTED"] = 258] = "NOT_CONNECTED";
 })(AckType ||= {});
 var SmartDeviceType;
 ((SmartDeviceType2) => {
@@ -939,8 +436,15 @@ class VexEventEmitter {
     this.handlerMap.set(eventName, listeners);
   }
   emit(eventName, data) {
+    const listeners = this.handlerMap.get(eventName);
+    if (listeners === undefined || listeners.length === 0)
+      return;
+    if (listeners.length === 1) {
+      listeners[0](data);
+      return;
+    }
     const errors = [];
-    for (const callback of [...this.handlerMap.get(eventName) ?? []]) {
+    for (const callback of [...listeners]) {
       try {
         callback(data);
       } catch (error) {
@@ -964,24 +468,21 @@ class VexEventTarget {
     this.emitter = new VexEventEmitter;
   }
   emit(eventName, data) {
-    this.emitter.emit(this.normalizeEventName(eventName), data);
+    this.emitter.emit(eventName, data);
   }
   on(eventName, listener) {
-    this.emitter.on(this.normalizeEventName(eventName), listener);
+    this.emitter.on(eventName, listener);
   }
   remove(eventName, listener) {
-    this.emitter.remove(this.normalizeEventName(eventName), listener);
+    this.emitter.remove(eventName, listener);
   }
   clearListeners() {
     this.emitter.clearListeners();
   }
-  normalizeEventName(eventName) {
-    return String(eventName);
-  }
 }
 
 // src/VexConnection.ts
-var import_neverthrow = __toESM(require_index_cjs(), 1);
+var import_neverthrow = require("neverthrow");
 
 // src/VexPacketBase.ts
 var MATCH_STATUS_ALT_ACK = 167;
@@ -1076,79 +577,115 @@ class CrcGenerator {
   }
 }
 
-// src/VexPacketModels.ts
-var exports_VexPacketModels = {};
-__export(exports_VexPacketModels, {
-  WriteKeyValueReplyD2HPacket: () => WriteKeyValueReplyD2HPacket,
-  WriteKeyValueH2DPacket: () => WriteKeyValueH2DPacket,
-  WriteFileReplyD2HPacket: () => WriteFileReplyD2HPacket,
-  WriteFileH2DPacket: () => WriteFileH2DPacket,
-  UpdateMatchModeH2DPacket: () => UpdateMatchModeH2DPacket,
-  SystemVersionReplyD2HPacket: () => SystemVersionReplyD2HPacket,
-  SystemVersionH2DPacket: () => SystemVersionH2DPacket,
-  SendDashTouchReplyD2HPacket: () => SendDashTouchReplyD2HPacket,
-  SendDashTouchH2DPacket: () => SendDashTouchH2DPacket,
-  SelectDashReplyD2HPacket: () => SelectDashReplyD2HPacket,
-  SelectDashH2DPacket: () => SelectDashH2DPacket,
-  ScreenCaptureReplyD2HPacket: () => ScreenCaptureReplyD2HPacket,
-  ScreenCaptureH2DPacket: () => ScreenCaptureH2DPacket,
-  ReadLogPageReplyD2HPacket: () => ReadLogPageReplyD2HPacket,
-  ReadLogPageH2DPacket: () => ReadLogPageH2DPacket,
-  ReadKeyValueReplyD2HPacket: () => ReadKeyValueReplyD2HPacket,
-  ReadKeyValueH2DPacket: () => ReadKeyValueH2DPacket,
-  ReadFileReplyD2HPacket: () => ReadFileReplyD2HPacket,
-  ReadFileH2DPacket: () => ReadFileH2DPacket,
-  Query1ReplyD2HPacket: () => Query1ReplyD2HPacket,
-  Query1H2DPacket: () => Query1H2DPacket,
-  MatchStatusReplyD2HPacket: () => MatchStatusReplyD2HPacket,
-  MatchModeReplyD2HPacket: () => MatchModeReplyD2HPacket,
-  LoadFileActionReplyD2HPacket: () => LoadFileActionReplyD2HPacket,
-  LoadFileActionH2DPacket: () => LoadFileActionH2DPacket,
-  LinkFileReplyD2HPacket: () => LinkFileReplyD2HPacket,
-  LinkFileH2DPacket: () => LinkFileH2DPacket,
-  InitFileTransferReplyD2HPacket: () => InitFileTransferReplyD2HPacket,
-  InitFileTransferH2DPacket: () => InitFileTransferH2DPacket,
-  GetSystemStatusReplyD2HPacket: () => GetSystemStatusReplyD2HPacket,
-  GetSystemStatusH2DPacket: () => GetSystemStatusH2DPacket,
-  GetSystemFlagsReplyD2HPacket: () => GetSystemFlagsReplyD2HPacket,
-  GetSystemFlagsH2DPacket: () => GetSystemFlagsH2DPacket,
-  GetSlot5to8InfoReplyD2HPacket: () => GetSlot5to8InfoReplyD2HPacket,
-  GetSlot5to8InfoH2DPacket: () => GetSlot5to8InfoH2DPacket,
-  GetSlot1to4InfoReplyD2HPacket: () => GetSlot1to4InfoReplyD2HPacket,
-  GetSlot1to4InfoH2DPacket: () => GetSlot1to4InfoH2DPacket,
-  GetRadioStatusReplyD2HPacket: () => GetRadioStatusReplyD2HPacket,
-  GetRadioStatusH2DPacket: () => GetRadioStatusH2DPacket,
-  GetRadioModeH2DPacket: () => GetRadioModeH2DPacket,
-  GetProgramSlotInfoReplyD2HPacket: () => GetProgramSlotInfoReplyD2HPacket,
-  GetProgramSlotInfoH2DPacket: () => GetProgramSlotInfoH2DPacket,
-  GetMatchStatusH2DPacket: () => GetMatchStatusH2DPacket,
-  GetLogCountReplyD2HPacket: () => GetLogCountReplyD2HPacket,
-  GetLogCountH2DPacket: () => GetLogCountH2DPacket,
-  GetFileMetadataReplyD2HPacket: () => GetFileMetadataReplyD2HPacket,
-  GetFileMetadataH2DPacket: () => GetFileMetadataH2DPacket,
-  GetFdtStatusReplyD2HPacket: () => GetFdtStatusReplyD2HPacket,
-  GetFdtStatusH2DPacket: () => GetFdtStatusH2DPacket,
-  GetDirectoryFileCountReplyD2HPacket: () => GetDirectoryFileCountReplyD2HPacket,
-  GetDirectoryFileCountH2DPacket: () => GetDirectoryFileCountH2DPacket,
-  GetDirectoryEntryReplyD2HPacket: () => GetDirectoryEntryReplyD2HPacket,
-  GetDirectoryEntryH2DPacket: () => GetDirectoryEntryH2DPacket,
-  GetDeviceStatusReplyD2HPacket: () => GetDeviceStatusReplyD2HPacket,
-  GetDeviceStatusH2DPacket: () => GetDeviceStatusH2DPacket,
-  FileFormatReplyD2HPacket: () => FileFormatReplyD2HPacket,
-  FileFormatH2DPacket: () => FileFormatH2DPacket,
-  FileControlReplyD2HPacket: () => FileControlReplyD2HPacket,
-  FileControlH2DPacket: () => FileControlH2DPacket,
-  FileClearUpReplyD2HPacket: () => FileClearUpReplyD2HPacket,
-  FileClearUpH2DPacket: () => FileClearUpH2DPacket,
-  FactoryStatusReplyD2HPacket: () => FactoryStatusReplyD2HPacket,
-  FactoryStatusH2DPacket: () => FactoryStatusH2DPacket,
-  FactoryEnableReplyD2HPacket: () => FactoryEnableReplyD2HPacket,
-  FactoryEnableH2DPacket: () => FactoryEnableH2DPacket,
-  ExitFileTransferReplyD2HPacket: () => ExitFileTransferReplyD2HPacket,
-  ExitFileTransferH2DPacket: () => ExitFileTransferH2DPacket,
-  EraseFileReplyD2HPacket: () => EraseFileReplyD2HPacket,
-  EraseFileH2DPacket: () => EraseFileH2DPacket
-});
+// src/VexPacketEncoder.ts
+var textEncoder = new TextEncoder;
+var HEADER_TO_DEVICE = Uint8Array.of(201, 54, 184, 71);
+function encodeFixedText(value, field, maxBytes) {
+  const encoded = textEncoder.encode(value);
+  if (encoded.byteLength > maxBytes) {
+    throw new RangeError(`${field} must be at most ${maxBytes} UTF-8 bytes`);
+  }
+  return encoded;
+}
+
+class PacketEncoder {
+  static HEADERS_LENGTH = 4;
+  static HEADER_TO_DEVICE = [201, 54, 184, 71];
+  static HEADER_TO_HOST = [170, 85];
+  static J2000_EPOCH = 946684800;
+  vexVersion = 0;
+  crcgen = new CrcGenerator;
+  allPacketsTable = new Map;
+  static getInstance() {
+    Packet.ENCODER ??= new PacketEncoder;
+    return Packet.ENCODER;
+  }
+  constructor() {}
+  registerPacketTypes(types) {
+    for (const type of types) {
+      let byExtendedId = this.allPacketsTable.get(type.COMMAND_ID);
+      if (byExtendedId === undefined) {
+        byExtendedId = new Map;
+        this.allPacketsTable.set(type.COMMAND_ID, byExtendedId);
+      }
+      byExtendedId.set(type.COMMAND_EXTENDED_ID, type);
+    }
+  }
+  getPacketType(commandId, commandExtendedId) {
+    if (commandId === undefined)
+      return;
+    return this.allPacketsTable.get(commandId)?.get(commandExtendedId);
+  }
+  createHeader(buf) {
+    if (buf === undefined || buf.byteLength < PacketEncoder.HEADERS_LENGTH) {
+      buf = new ArrayBuffer(PacketEncoder.HEADERS_LENGTH);
+    }
+    const h = new Uint8Array(buf);
+    h.set(HEADER_TO_DEVICE);
+    return h;
+  }
+  cdcCommand(cmd) {
+    const h = new Uint8Array(5);
+    h.set(HEADER_TO_DEVICE);
+    h[4] = cmd;
+    return h;
+  }
+  cdcCommandWithData(cmd, data) {
+    const h = new Uint8Array(6 + data.length);
+    h.set(HEADER_TO_DEVICE);
+    h[4] = cmd;
+    h[5] = data.length;
+    h.set(data, 6);
+    return h;
+  }
+  cdc2Command(cmd, ext) {
+    const h = new Uint8Array(9);
+    h.set(HEADER_TO_DEVICE);
+    h[4] = cmd;
+    h[5] = ext;
+    h[6] = 0;
+    this.appendCrc16(h);
+    return h;
+  }
+  cdc2CommandBufferLength(data) {
+    return PacketEncoder.HEADERS_LENGTH + data.length + 5 + (data.length > 127 ? 1 : 0);
+  }
+  cdc2CommandWithData(cmd, ext, data) {
+    const h = new Uint8Array(this.cdc2CommandBufferLength(data));
+    h.set(HEADER_TO_DEVICE);
+    h[4] = cmd;
+    h[5] = ext;
+    if (data.length < 128) {
+      h[6] = data.length;
+      h.set(data, 7);
+    } else {
+      h[6] = data.length >>> 8 | 128;
+      h[7] = data.length & 255;
+      h.set(data, 8);
+    }
+    this.appendCrc16(h);
+    return h;
+  }
+  appendCrc16(h) {
+    const crc = this.crcgen.crc16(h.subarray(0, h.length - 2), 0);
+    h[h.length - 2] = crc >>> 8;
+    h[h.length - 1] = crc & 255;
+  }
+  validateHeader(data) {
+    return data[0] === PacketEncoder.HEADER_TO_HOST[0] && data[1] === PacketEncoder.HEADER_TO_HOST[1];
+  }
+  validateMessageCdc(data) {
+    const crc = (data[data.byteLength - 2] << 8) + data[data.byteLength - 1];
+    return this.crcgen.crc16(data.subarray(0, data.byteLength - 2), 0) === crc;
+  }
+  getPayloadSize(data) {
+    const a = data[3];
+    return (a & 128) === 0 ? a : ((a & 127) << 8) + data[4];
+  }
+  getHostHeaderLength(data) {
+    return (data[3] & 128) === 0 ? 4 : 5;
+  }
+}
 
 // src/VexFirmwareVersion.ts
 class VexFirmwareVersion {
@@ -1219,7 +756,7 @@ class PacketView extends DataView {
     super(buffer, offset, length);
   }
   static fromPacket(packet) {
-    const view = new PacketView(packet.data.buffer, packet.data.byteOffset);
+    const view = new PacketView(packet.data.buffer, packet.data.byteOffset, packet.data.byteLength);
     view.position = packet.ackIndex + 1;
     return view;
   }
@@ -1281,12 +818,12 @@ class PacketView extends DataView {
 }
 
 // src/VexPacketModels.ts
-var textEncoder = new TextEncoder;
+var textEncoder2 = new TextEncoder;
 function filePayload(a, b, fileName) {
   const payload = new Uint8Array(26);
   payload[0] = a;
   payload[1] = b;
-  payload.set(encodeFixedText(fileName, "Filename", 23), 2);
+  payload.set(encodeFixedText(fileName, "Filename", 24), 2);
   return payload;
 }
 var clamp100 = (value) => value !== undefined && value > 100 ? 100 : value;
@@ -1354,7 +891,7 @@ class InitFileTransferH2DPacket extends DeviceBoundPacket {
     const timestamp = (Date.now() / 1000 >>> 0) - PacketEncoder.J2000_EPOCH;
     view.setUint32(20, timestamp, true);
     payload.set(version.toUint8Array(), 24);
-    payload.set(encodeFixedText(name, "Filename", 23), 28);
+    payload.set(encodeFixedText(name, "Filename", 24), 28);
     super(payload);
   }
 }
@@ -1549,7 +1086,7 @@ class WriteKeyValueH2DPacket extends DeviceBoundPacket {
   static COMMAND_EXTENDED_ID = 47;
   constructor(key, value) {
     const strk = encodeFixedText(key, "Key", 31);
-    const strv = textEncoder.encode(value);
+    const strv = textEncoder2.encode(value);
     if (strk.byteLength + strv.byteLength + 20 > 32767) {
       throw new RangeError("Key and value are too large for a protocol packet");
     }
@@ -1712,7 +1249,7 @@ class ReadFileReplyD2HPacket extends HostBoundPacket {
     const view = PacketView.fromPacket(this);
     this.addr = view.nextUint32();
     this.length = this.payloadSize - 8;
-    this.buf = this.data.slice(view.position, view.position + this.length).buffer;
+    this.buf = this.data.subarray(view.position, view.position + this.length);
   }
 }
 
@@ -1994,203 +1531,113 @@ class GetRadioStatusReplyD2HPacket extends HostBoundPacket {
 class ScreenCaptureReplyD2HPacket extends HostBoundPacket {
   static COMMAND_ID = 86;
   static COMMAND_EXTENDED_ID = 40;
-}
-
-class SendDashTouchReplyD2HPacket extends HostBoundPacket {
-  static COMMAND_ID = 86;
-  static COMMAND_EXTENDED_ID = 42;
-}
-
-class SelectDashReplyD2HPacket extends HostBoundPacket {
-  static COMMAND_ID = 86;
-  static COMMAND_EXTENDED_ID = 43;
-}
-
-class ReadKeyValueReplyD2HPacket extends HostBoundPacket {
-  static COMMAND_ID = 86;
-  static COMMAND_EXTENDED_ID = 46;
-  value;
-  constructor(data) {
-    super(data);
-    this.value = PacketView.fromPacket(this).nextVarNTBS(255);
-  }
-}
-
-class WriteKeyValueReplyD2HPacket extends HostBoundPacket {
-  static COMMAND_ID = 86;
-  static COMMAND_EXTENDED_ID = 47;
-}
-
-class GetSlot1to4InfoReplyD2HPacket extends HostBoundPacket {
-  static COMMAND_ID = 86;
-  static COMMAND_EXTENDED_ID = 49;
-  slotFlags;
-  slots;
-  constructor(data, start = 1) {
-    super(data);
-    const view = PacketView.fromPacket(this);
-    this.slotFlags = view.nextUint8();
-    this.slots = [];
-    for (let i = 0;i < 4; i++) {
-      if ((this.slotFlags & 1 << start - 1 + i) === 0)
-        continue;
-      const icon = view.nextUint16();
-      const nameLen = view.nextUint8();
-      this.slots.push({
-        slot: start + i,
-        icon,
-        name: view.nextString(nameLen)
-      });
-    }
-  }
-}
-
-class GetSlot5to8InfoReplyD2HPacket extends GetSlot1to4InfoReplyD2HPacket {
-  static COMMAND_ID = 86;
-  static COMMAND_EXTENDED_ID = 50;
-  slotStartIndex = 5;
-  constructor(data) {
-    super(data, 5);
-  }
-}
-
-class FactoryStatusReplyD2HPacket extends HostBoundPacket {
-  static COMMAND_ID = 86;
-  static COMMAND_EXTENDED_ID = 241;
-  status;
-  percent;
-  constructor(data) {
-    super(data);
-    const view = PacketView.fromPacket(this);
-    this.status = view.nextUint8();
-    this.percent = view.nextUint8();
-  }
-}
-
-class FactoryEnableReplyD2HPacket extends HostBoundPacket {
-  static COMMAND_ID = 86;
-  static COMMAND_EXTENDED_ID = 255;
-}
-
-// src/VexPacketEncoder.ts
-var textEncoder2 = new TextEncoder;
-var HEADER_TO_DEVICE = Uint8Array.of(201, 54, 184, 71);
-function encodeFixedText(value, field, maxBytes) {
-  const encoded = textEncoder2.encode(value);
-  if (encoded.byteLength > maxBytes) {
-    throw new RangeError(`${field} must be at most ${maxBytes} UTF-8 bytes`);
-  }
-  return encoded;
-}
-
-class PacketEncoder {
-  static HEADERS_LENGTH = 4;
-  static HEADER_TO_DEVICE = [201, 54, 184, 71];
-  static HEADER_TO_HOST = [170, 85];
-  static J2000_EPOCH = 946684800;
-  vexVersion = 0;
-  crcgen = new CrcGenerator;
-  allPacketsTable = new Map;
-  static getInstance() {
-    Packet.ENCODER ??= new PacketEncoder;
-    return Packet.ENCODER;
-  }
-  constructor() {
-    for (const packet of Object.values(exports_VexPacketModels)) {
-      if (typeof packet === "function" && packet.prototype instanceof HostBoundPacket) {
-        const type = packet;
-        let byExtendedId = this.allPacketsTable.get(type.COMMAND_ID);
-        if (byExtendedId === undefined) {
-          byExtendedId = new Map;
-          this.allPacketsTable.set(type.COMMAND_ID, byExtendedId);
-        }
-        byExtendedId.set(type.COMMAND_EXTENDED_ID, type);
-      }
-    }
-  }
-  getPacketType(commandId, commandExtendedId) {
-    if (commandId === undefined)
-      return;
-    return this.allPacketsTable.get(commandId)?.get(commandExtendedId);
-  }
-  createHeader(buf) {
-    if (buf === undefined || buf.byteLength < PacketEncoder.HEADERS_LENGTH) {
-      buf = new ArrayBuffer(PacketEncoder.HEADERS_LENGTH);
-    }
-    const h = new Uint8Array(buf);
-    h.set(HEADER_TO_DEVICE);
-    return h;
-  }
-  cdcCommand(cmd) {
-    const h = new Uint8Array(5);
-    h.set(HEADER_TO_DEVICE);
-    h[4] = cmd;
-    return h;
-  }
-  cdcCommandWithData(cmd, data) {
-    const h = new Uint8Array(6 + data.length);
-    h.set(HEADER_TO_DEVICE);
-    h[4] = cmd;
-    h[5] = data.length;
-    h.set(data, 6);
-    return h;
-  }
-  cdc2Command(cmd, ext) {
-    const h = new Uint8Array(9);
-    h.set(HEADER_TO_DEVICE);
-    h[4] = cmd;
-    h[5] = ext;
-    h[6] = 0;
-    this.appendCrc16(h);
-    return h;
-  }
-  cdc2CommandBufferLength(data) {
-    return PacketEncoder.HEADERS_LENGTH + data.length + 5 + (data.length > 127 ? 1 : 0);
-  }
-  cdc2CommandWithData(cmd, ext, data) {
-    const h = new Uint8Array(this.cdc2CommandBufferLength(data));
-    h.set(HEADER_TO_DEVICE);
-    h[4] = cmd;
-    h[5] = ext;
-    if (data.length < 128) {
-      h[6] = data.length;
-      h.set(data, 7);
-    } else {
-      h[6] = data.length >>> 8 | 128;
-      h[7] = data.length & 255;
-      h.set(data, 8);
-    }
-    this.appendCrc16(h);
-    return h;
-  }
-  appendCrc16(h) {
-    const crc = this.crcgen.crc16(h.subarray(0, h.length - 2), 0);
-    h[h.length - 2] = crc >>> 8;
-    h[h.length - 1] = crc & 255;
-  }
-  validateHeader(data) {
-    return data[0] === PacketEncoder.HEADER_TO_HOST[0] && data[1] === PacketEncoder.HEADER_TO_HOST[1];
+}
+
+class SendDashTouchReplyD2HPacket extends HostBoundPacket {
+  static COMMAND_ID = 86;
+  static COMMAND_EXTENDED_ID = 42;
+}
+
+class SelectDashReplyD2HPacket extends HostBoundPacket {
+  static COMMAND_ID = 86;
+  static COMMAND_EXTENDED_ID = 43;
+}
+
+class ReadKeyValueReplyD2HPacket extends HostBoundPacket {
+  static COMMAND_ID = 86;
+  static COMMAND_EXTENDED_ID = 46;
+  value;
+  constructor(data) {
+    super(data);
+    this.value = PacketView.fromPacket(this).nextVarNTBS(255);
   }
-  validateMessageCdc(data) {
-    const crc = (data[data.byteLength - 2] << 8) + data[data.byteLength - 1];
-    return this.crcgen.crc16(data.subarray(0, data.byteLength - 2), 0) === crc;
+}
+
+class WriteKeyValueReplyD2HPacket extends HostBoundPacket {
+  static COMMAND_ID = 86;
+  static COMMAND_EXTENDED_ID = 47;
+}
+
+class GetSlot1to4InfoReplyD2HPacket extends HostBoundPacket {
+  static COMMAND_ID = 86;
+  static COMMAND_EXTENDED_ID = 49;
+  slotFlags;
+  slots;
+  constructor(data, start = 1) {
+    super(data);
+    const view = PacketView.fromPacket(this);
+    this.slotFlags = view.nextUint8();
+    this.slots = [];
+    for (let i = 0;i < 4; i++) {
+      if ((this.slotFlags & 1 << start - 1 + i) === 0)
+        continue;
+      const icon = view.nextUint16();
+      const nameLen = view.nextUint8();
+      this.slots.push({
+        slot: start + i,
+        icon,
+        name: view.nextString(nameLen)
+      });
+    }
   }
-  getPayloadSize(data) {
-    const a = data[3];
-    return (a & 128) === 0 ? a : ((a & 127) << 8) + data[4];
+}
+
+class GetSlot5to8InfoReplyD2HPacket extends GetSlot1to4InfoReplyD2HPacket {
+  static COMMAND_ID = 86;
+  static COMMAND_EXTENDED_ID = 50;
+  slotStartIndex = 5;
+  constructor(data) {
+    super(data, 5);
   }
-  getHostHeaderLength(data) {
-    return (data[3] & 128) === 0 ? 4 : 5;
+}
+
+class FactoryStatusReplyD2HPacket extends HostBoundPacket {
+  static COMMAND_ID = 86;
+  static COMMAND_EXTENDED_ID = 241;
+  status;
+  percent;
+  constructor(data) {
+    super(data);
+    const view = PacketView.fromPacket(this);
+    this.status = view.nextUint8();
+    this.percent = view.nextUint8();
   }
 }
 
-// src/VexConnection.ts
-var thePacketEncoder = PacketEncoder.getInstance();
+class FactoryEnableReplyD2HPacket extends HostBoundPacket {
+  static COMMAND_ID = 86;
+  static COMMAND_EXTENDED_ID = 255;
+}
+
+// src/VexScreenCapture.ts
 var SCREEN_CAPTURE_HEIGHT = 272;
 var SCREEN_CAPTURE_WIDTH = 480;
 var SCREEN_CAPTURE_CHANNELS = 3;
 var SCREEN_CAPTURE_MESSAGE_WIDTH = 512;
 var SCREEN_CAPTURE_MESSAGE_CHANNELS = 4;
+var SCREEN_CAPTURE_FRAMEBUFFER_SIZE = SCREEN_CAPTURE_MESSAGE_WIDTH * SCREEN_CAPTURE_HEIGHT * SCREEN_CAPTURE_MESSAGE_CHANNELS;
+function convertScreenCapture(framebuffer) {
+  if (framebuffer.length !== SCREEN_CAPTURE_FRAMEBUFFER_SIZE) {
+    throw new Error(`bad screen capture framebuffer size: ${framebuffer.length}; expected ${SCREEN_CAPTURE_FRAMEBUFFER_SIZE}`);
+  }
+  const pixels = new Uint8Array(SCREEN_CAPTURE_WIDTH * SCREEN_CAPTURE_HEIGHT * SCREEN_CAPTURE_CHANNELS);
+  let source = 0;
+  let target = 0;
+  for (let row = 0;row < SCREEN_CAPTURE_HEIGHT; row++) {
+    for (let column = 0;column < SCREEN_CAPTURE_WIDTH; column++) {
+      pixels[target] = framebuffer[source + 2];
+      pixels[target + 1] = framebuffer[source + 1];
+      pixels[target + 2] = framebuffer[source];
+      source += SCREEN_CAPTURE_MESSAGE_CHANNELS;
+      target += SCREEN_CAPTURE_CHANNELS;
+    }
+    source += (SCREEN_CAPTURE_MESSAGE_WIDTH - SCREEN_CAPTURE_WIDTH) * SCREEN_CAPTURE_MESSAGE_CHANNELS;
+  }
+  return pixels;
+}
+
+// src/VexConnection.ts
+var thePacketEncoder = PacketEncoder.getInstance();
 
 class VexSerialConnection extends VexEventTarget {
   filters = [{ usbVendorId: 10376 }];
@@ -2198,12 +1645,31 @@ class VexSerialConnection extends VexEventTarget {
   reader;
   port;
   serial;
-  callbacksQueue = [];
+  pendingCallbacks = new Map;
+  rawCallbacks = {
+    head: undefined,
+    tail: undefined
+  };
+  pendingCommandTails = new Map;
   _onPortDisconnect = null;
   _closePromise = null;
+  _openPromise = null;
+  _isClosing = false;
   _wasConnected = false;
   fileTransferTail = Promise.resolve();
   fileTransferDepth = 0;
+  get callbacksQueue() {
+    const callbacks = [];
+    for (const queue of this.pendingCallbacks.values()) {
+      for (let callback = queue.head;callback; callback = callback.next) {
+        callbacks.push(callback);
+      }
+    }
+    for (let callback = this.rawCallbacks.head;callback; callback = callback.next) {
+      callbacks.push(callback);
+    }
+    return callbacks;
+  }
   get isConnected() {
     return this.port !== undefined && this.reader !== undefined && this.writer !== undefined;
   }
@@ -2215,27 +1681,45 @@ class VexSerialConnection extends VexEventTarget {
     this.serial = serial;
   }
   reportWarning(message, details) {
-    this.emit("warning", { message, details });
+    this.emitSafely("warning", {
+      message,
+      details
+    });
+  }
+  emitSafely(eventName, data) {
+    try {
+      this.emit(eventName, data);
+    } catch {}
   }
   async close() {
     if (this._closePromise)
       return this._closePromise;
-    if (!this._hasOpenResources())
-      return;
-    this._closePromise = this._doClose();
+    this._isClosing = true;
+    const closing = this._closeAfterOpen();
+    this._closePromise = closing;
     try {
-      await this._closePromise;
+      await closing;
     } finally {
-      this._closePromise = null;
+      if (this._closePromise === closing)
+        this._closePromise = null;
+      this._isClosing = false;
     }
   }
+  async _closeAfterOpen() {
+    const opening = this._openPromise;
+    if (opening !== null)
+      await opening;
+    if (!this._hasOpenResources())
+      return;
+    await this._doClose();
+  }
   _hasOpenResources() {
-    return this.port !== undefined || this.reader !== undefined || this.writer !== undefined || this._onPortDisconnect !== null || this.callbacksQueue.length > 0;
+    return this.port !== undefined || this.reader !== undefined || this.writer !== undefined || this._onPortDisconnect !== null || this.hasPendingCallbacks();
   }
   async _doClose() {
-    for (const callback of this.callbacksQueue.splice(0)) {
+    for (const callback of this.drainPendingCallbacks()) {
       clearTimeout(callback.timeout);
-      callback.callback(255 /* CDC2_NACK */);
+      callback.callback(258 /* NOT_CONNECTED */);
     }
     const onDisconnect = this._onPortDisconnect;
     this._onPortDisconnect = null;
@@ -2284,11 +1768,22 @@ class VexSerialConnection extends VexEventTarget {
     }
     if (this._wasConnected) {
       this._wasConnected = false;
-      this.emit("disconnected", undefined);
+      this.emitSafely("disconnected", undefined);
     }
   }
   open(use = 0, askUser = true) {
-    return new import_neverthrow.ResultAsync(this._open(use, askUser));
+    if (this._openPromise !== null)
+      return new import_neverthrow.ResultAsync(this._openPromise);
+    const opening = this._open(use, askUser);
+    this._openPromise = opening;
+    opening.then(() => {
+      if (this._openPromise === opening)
+        this._openPromise = null;
+    }, () => {
+      if (this._openPromise === opening)
+        this._openPromise = null;
+    });
+    return new import_neverthrow.ResultAsync(opening);
   }
   async _open(use, askUser) {
     if (this._closePromise !== null)
@@ -2321,38 +1816,63 @@ class VexSerialConnection extends VexEventTarget {
       this.reader = this.port.readable.getReader();
       this.startReader();
       this._wasConnected = true;
-      this.emit("connected", undefined);
+      this.emitSafely("connected", undefined);
       return import_neverthrow.ok("opened");
     } catch (e) {
-      await this.close();
+      await this._doClose();
       return import_neverthrow.err(toVexSerialError(e, "io"));
     }
   }
   async writeDataAsync(rawData, timeout = 1000) {
+    if (rawData instanceof DeviceBoundPacket) {
+      return this.serializeCommand(rawData.commandId, rawData.commandExtendedId, () => this.writeDataAsyncUnserialized(rawData, timeout));
+    }
+    return this.writeDataAsyncUnserialized(rawData, timeout);
+  }
+  async serializeCommand(commandId, commandExtendedId, operation) {
+    const key = `${commandId}:${commandExtendedId ?? ""}`;
+    const previous = this.pendingCommandTails.get(key) ?? Promise.resolve();
+    let release = () => {};
+    const current = new Promise((resolve) => {
+      release = resolve;
+    });
+    this.pendingCommandTails.set(key, current);
+    await previous;
+    try {
+      return await operation();
+    } finally {
+      release();
+      if (this.pendingCommandTails.get(key) === current) {
+        this.pendingCommandTails.delete(key);
+      }
+    }
+  }
+  async writeDataAsyncUnserialized(rawData, timeout) {
     return new Promise((resolve) => {
-      if (this.writer === undefined) {
-        resolve(255 /* CDC2_NACK */);
+      if (this.writer === undefined || this._isClosing) {
+        resolve(258 /* NOT_CONNECTED */);
         return;
       }
       const data = rawData instanceof DeviceBoundPacket ? rawData.data : rawData;
+      const queue = rawData instanceof DeviceBoundPacket ? this.getPendingQueue(rawData.commandId, rawData.commandExtendedId, true) : this.rawCallbacks;
       const cb = {
+        active: true,
         callback: resolve,
         timeout: setTimeout(() => {
-          const index = this.callbacksQueue.indexOf(cb);
-          if (index === -1)
+          if (!this.removePendingCallback(cb))
             return;
-          this.callbacksQueue.splice(index, 1);
           cb.callback(256 /* TIMEOUT */);
         }, timeout),
+        next: undefined,
+        previous: undefined,
+        queue,
         wantedCommandId: rawData instanceof DeviceBoundPacket ? rawData.commandId : undefined,
         wantedCommandExId: rawData instanceof DeviceBoundPacket ? rawData.commandExtendedId : undefined
       };
-      this.callbacksQueue.push(cb);
+      this.enqueuePendingCallback(cb);
       this.writer.write(data).catch(() => {
-        const index = this.callbacksQueue.indexOf(cb);
-        if (index === -1)
+        if (!this.removePendingCallback(cb))
           return;
-        this.callbacksQueue.splice(index, 1);
         clearTimeout(cb.timeout);
         resolve(257 /* WRITE_ERROR */);
       });
@@ -2363,6 +1883,9 @@ class VexSerialConnection extends VexEventTarget {
       const result = await this.writeDataAsync(packet, timeout);
       if (result instanceof ReplyType)
         return import_neverthrow.ok(result);
+      if (result === 258 /* NOT_CONNECTED */) {
+        return import_neverthrow.err(new VexNotConnectedError);
+      }
       return import_neverthrow.err(new VexProtocolError(expectedReplyMessage(packet, ReplyType, result), typeof result === "number" ? result : undefined));
     })());
   }
@@ -2373,56 +1896,48 @@ class VexSerialConnection extends VexEventTarget {
       const { value: readData, done: isDone } = await this.reader.read();
       if (isDone)
         throw new Error("No data");
-      cache = binaryArrayJoin(cache, readData);
+      cache.append(readData);
     }
-    return cache;
   }
   async startReader() {
-    let cache = new Uint8Array([]);
+    const cache = new ReceiveBuffer;
     let sliceIdx = 0;
     for (;; )
       try {
-        cache = await this.readData(cache, 5);
+        await this.readData(cache, 5);
         sliceIdx = 0;
-        while (!thePacketEncoder.validateHeader(cache)) {
-          const nextHeader = cache.findIndex((byte, index) => index > 0 && byte === PacketEncoder.HEADER_TO_HOST[0] && cache[index + 1] === PacketEncoder.HEADER_TO_HOST[1]);
+        while (!thePacketEncoder.validateHeader(cache.bytes)) {
+          const bytes = cache.bytes;
+          const nextHeader = bytes.findIndex((byte, index) => index > 0 && byte === PacketEncoder.HEADER_TO_HOST[0] && bytes[index + 1] === PacketEncoder.HEADER_TO_HOST[1]);
           if (nextHeader >= 0) {
-            cache = cache.slice(nextHeader);
+            cache.discard(nextHeader);
           } else {
-            cache = cache.slice(cache.at(-1) === PacketEncoder.HEADER_TO_HOST[0] ? -1 : cache.length);
+            cache.discard(bytes.at(-1) === PacketEncoder.HEADER_TO_HOST[0] ? -1 : bytes.length);
           }
-          cache = await this.readData(cache, 5);
+          await this.readData(cache, 5);
         }
-        const payloadExpectedSize = thePacketEncoder.getPayloadSize(cache);
-        const n = thePacketEncoder.getHostHeaderLength(cache);
+        const payloadExpectedSize = thePacketEncoder.getPayloadSize(cache.bytes);
+        const n = thePacketEncoder.getHostHeaderLength(cache.bytes);
         const totalSize = n + payloadExpectedSize;
-        cache = await this.readData(cache, totalSize);
+        await this.readData(cache, totalSize);
         sliceIdx = totalSize;
-        const cmdId = cache[2];
+        const packet = cache.copy(totalSize);
+        const cmdId = packet[2];
         const hasExtId = cmdId === 88 || cmdId === 86;
-        const cmdExId = hasExtId ? cache[n] : undefined;
-        const ack = cache[n + 1];
+        const cmdExId = hasExtId ? packet[n] : undefined;
+        const ack = packet[n + 1];
         if (hasExtId) {
-          if (!thePacketEncoder.validateMessageCdc(cache))
-            throw new Error("Invalid message CDC");
-        }
-        let matchIdx = -1;
-        let untypedIdx = -1;
-        for (let i = 0;i < this.callbacksQueue.length; i++) {
-          const candidate = this.callbacksQueue[i];
-          if (candidate.wantedCommandId === undefined && candidate.wantedCommandExId === undefined) {
-            if (untypedIdx === -1)
-              untypedIdx = i;
+          if (!thePacketEncoder.validateMessageCdc(packet)) {
+            this.reportWarning("discarding a reply with an invalid CDC CRC", {
+              commandId: cmdId,
+              commandExtendedId: cmdExId,
+              ack
+            });
             continue;
           }
-          if ((candidate.wantedCommandId === undefined || candidate.wantedCommandId === cmdId) && (candidate.wantedCommandExId === undefined || candidate.wantedCommandExId === cmdExId)) {
-            matchIdx = i;
-            break;
-          }
         }
-        if (matchIdx === -1)
-          matchIdx = untypedIdx;
-        if (matchIdx === -1) {
+        const callbackInfo = this.shiftPendingCallback(cmdId, cmdExId) ?? this.shiftRawCallback();
+        if (callbackInfo === undefined) {
           this.reportWarning("received a reply with no matching request", {
             commandId: cmdId,
             commandExtendedId: cmdExId,
@@ -2430,38 +1945,117 @@ class VexSerialConnection extends VexEventTarget {
           });
           continue;
         }
-        const callbackInfo = this.callbacksQueue[matchIdx];
         const wantedCmdId = callbackInfo.wantedCommandId;
         const wantedCmdExId = callbackInfo.wantedCommandExId;
-        const data = cache.slice(0, sliceIdx);
         const PackageType = thePacketEncoder.getPacketType(wantedCmdId, wantedCmdExId);
         if (wantedCmdId === undefined || PackageType === undefined) {
           if (wantedCmdId !== undefined) {
             this.reportWarning("no packet class is registered for the wanted command", { commandId: wantedCmdId, commandExtendedId: wantedCmdExId });
           }
-          callbackInfo.callback(data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength));
+          callbackInfo.callback(packet.buffer);
         } else {
-          if (!hasExtId || PackageType.isValidPacket(data, n)) {
-            callbackInfo.callback(new PackageType(data));
+          if (PackageType.isValidPacket(packet, n)) {
+            callbackInfo.callback(new PackageType(packet));
           } else {
             this.reportWarning("reply failed packet validation; delivering its ack instead", { commandId: cmdId, commandExtendedId: cmdExId, ack });
             callbackInfo.callback(ack);
           }
         }
         clearTimeout(callbackInfo.timeout);
-        this.callbacksQueue.splice(matchIdx, 1);
       } catch (e) {
         if (!(e instanceof Error && e.message === "No data")) {
           this.reportWarning("reader loop stopped by a read error", {
             error: e,
-            pendingBytes: cache
+            pendingBytes: cache.bytes
           });
         }
         await this.close();
         break;
       } finally {
-        cache = cache.slice(sliceIdx);
+        cache.discard(sliceIdx);
+      }
+  }
+  pendingKey(commandId, commandExtendedId) {
+    return `${commandId}:${commandExtendedId ?? ""}`;
+  }
+  getPendingQueue(commandId, commandExtendedId, create) {
+    const key = this.pendingKey(commandId, commandExtendedId);
+    let queue = this.pendingCallbacks.get(key);
+    if (queue === undefined && create) {
+      const created = { head: undefined, tail: undefined };
+      this.pendingCallbacks.set(key, created);
+      queue = created;
+    }
+    return queue ?? { head: undefined, tail: undefined };
+  }
+  enqueuePendingCallback(callback) {
+    const tail = callback.queue.tail;
+    callback.previous = tail;
+    if (tail === undefined)
+      callback.queue.head = callback;
+    else
+      tail.next = callback;
+    callback.queue.tail = callback;
+  }
+  removePendingCallback(callback) {
+    if (!callback.active)
+      return false;
+    callback.active = false;
+    const { queue, previous, next } = callback;
+    if (previous === undefined)
+      queue.head = next;
+    else
+      previous.next = next;
+    if (next === undefined)
+      queue.tail = previous;
+    else
+      next.previous = previous;
+    callback.previous = undefined;
+    callback.next = undefined;
+    if (queue !== this.rawCallbacks && queue.head === undefined && callback.wantedCommandId !== undefined) {
+      this.pendingCallbacks.delete(this.pendingKey(callback.wantedCommandId, callback.wantedCommandExId));
+    }
+    return true;
+  }
+  shiftPendingCallback(commandId, commandExtendedId) {
+    const queue = this.getPendingQueue(commandId, commandExtendedId, false);
+    const callback = queue.head;
+    if (callback !== undefined)
+      this.removePendingCallback(callback);
+    return callback;
+  }
+  shiftRawCallback() {
+    const callback = this.rawCallbacks.head;
+    if (callback !== undefined)
+      this.removePendingCallback(callback);
+    return callback;
+  }
+  hasPendingCallbacks() {
+    return this.pendingCallbacks.size > 0 || this.rawCallbacks.head !== undefined;
+  }
+  drainPendingCallbacks() {
+    const callbacks = [];
+    for (const queue of this.pendingCallbacks.values()) {
+      for (let callback = queue.head;callback; ) {
+        const next = callback.next;
+        callback.active = false;
+        callback.previous = undefined;
+        callback.next = undefined;
+        callbacks.push(callback);
+        callback = next;
       }
+    }
+    for (let callback = this.rawCallbacks.head;callback; ) {
+      const next = callback.next;
+      callback.active = false;
+      callback.previous = undefined;
+      callback.next = undefined;
+      callbacks.push(callback);
+      callback = next;
+    }
+    this.pendingCallbacks.clear();
+    this.rawCallbacks = { head: undefined, tail: undefined };
+    return callbacks;
   }
   query1() {
     return this.request(new Query1H2DPacket, Query1ReplyD2HPacket, 100);
@@ -2579,7 +2173,9 @@ class V5SerialConnection extends VexSerialConnection {
       let bufferOffset = 0;
       const fileBuf = new Uint8Array(fileSize);
       while (bufferOffset < fileSize) {
-        const requestedSize = Math.min(bufferChunkSize, fileSize - bufferOffset);
+        const remainingSize = fileSize - bufferOffset;
+        const chunkSize = Math.min(bufferChunkSize, remainingSize);
+        const requestedSize = chunkSize + 3 & ~3;
         const p2Result = await this.request(new ReadFileH2DPacket(nextAddress, requestedSize), ReadFileReplyD2HPacket, 3000);
         if (p2Result.isErr())
           throw p2Result.error;
@@ -2590,9 +2186,10 @@ class V5SerialConnection extends VexSerialConnection {
         if (p2.length <= 0 || p2.length > requestedSize || p2.buf.byteLength !== p2.length) {
           throw new VexTransferError(`ReadFileReplyD2HPacket returned invalid length ${p2.length}`);
         }
-        fileBuf.set(new Uint8Array(p2.buf), bufferOffset);
-        bufferOffset += p2.length;
-        nextAddress += p2.length;
+        const receivedSize = Math.min(p2.length, remainingSize);
+        fileBuf.set(p2.buf.subarray(0, receivedSize), bufferOffset);
+        bufferOffset += receivedSize;
+        nextAddress += receivedSize;
         progressCallback?.(bufferOffset, fileSize);
       }
       transferFailed = false;
@@ -2747,7 +2344,7 @@ class V5SerialConnection extends VexSerialConnection {
       filename: "screen",
       vendor: 15 /* SYS */,
       loadAddress: 0,
-      size: SCREEN_CAPTURE_MESSAGE_WIDTH * SCREEN_CAPTURE_HEIGHT * SCREEN_CAPTURE_MESSAGE_CHANNELS
+      size: SCREEN_CAPTURE_FRAMEBUFFER_SIZE
     }, 2 /* FILE_TARGET_CBUF */, progressCallback);
     if (framebuffer.isErr())
       return import_neverthrow.err(framebuffer.error);
@@ -2772,34 +2369,60 @@ class V5SerialConnection extends VexSerialConnection {
     return this.request(new SelectDashH2DPacket(screen, port), SelectDashReplyD2HPacket);
   }
 }
-function binaryArrayJoin(left, right) {
-  const leftSize = left != null ? left.byteLength : 0;
-  const rightSize = right != null ? right.byteLength : 0;
-  const all = new Uint8Array(leftSize + rightSize);
-  if (all.length === 0)
-    return new Uint8Array;
-  if (left != null)
-    all.set(new Uint8Array(left), 0);
-  if (right != null)
-    all.set(new Uint8Array(right), leftSize);
-  return all;
+
+class ReceiveBuffer {
+  storage = new Uint8Array(0);
+  start = 0;
+  end = 0;
+  get byteLength() {
+    return this.end - this.start;
+  }
+  get bytes() {
+    return this.storage.subarray(this.start, this.end);
+  }
+  append(chunk) {
+    this.reserve(chunk.byteLength);
+    this.storage.set(chunk, this.end);
+    this.end += chunk.byteLength;
+  }
+  copy(length) {
+    return this.bytes.slice(0, length);
+  }
+  discard(length) {
+    this.start += length < 0 ? this.byteLength + length : length;
+    if (this.start < 0)
+      this.start = 0;
+    if (this.start > this.end)
+      this.start = this.end;
+    if (this.start === this.end) {
+      this.start = 0;
+      this.end = 0;
+    } else if (this.start >= 4096 && this.start * 2 >= this.storage.length) {
+      this.storage.copyWithin(0, this.start, this.end);
+      this.end -= this.start;
+      this.start = 0;
+    }
+  }
+  reserve(additional) {
+    const required = this.byteLength + additional;
+    if (this.storage.length - this.end >= additional)
+      return;
+    if (this.storage.length >= required) {
+      this.storage.copyWithin(0, this.start, this.end);
+      this.end = this.byteLength;
+      this.start = 0;
+      return;
+    }
+    const storage = new Uint8Array(Math.max(required, Math.max(64, this.storage.length * 2)));
+    storage.set(this.bytes);
+    this.end = this.byteLength;
+    this.start = 0;
+    this.storage = storage;
+  }
 }
 function getTransferChunkSize(windowSize) {
   return windowSize > 0 && windowSize <= USER_PROG_CHUNK_SIZE ? windowSize : USER_PROG_CHUNK_SIZE;
 }
-function convertScreenCapture(framebuffer) {
-  const pixels = new Uint8Array(SCREEN_CAPTURE_WIDTH * SCREEN_CAPTURE_HEIGHT * SCREEN_CAPTURE_CHANNELS);
-  for (let row = 0;row < SCREEN_CAPTURE_HEIGHT; row++) {
-    for (let column = 0;column < SCREEN_CAPTURE_WIDTH; column++) {
-      const source = (row * SCREEN_CAPTURE_MESSAGE_WIDTH + column) * SCREEN_CAPTURE_MESSAGE_CHANNELS;
-      const target = (row * SCREEN_CAPTURE_WIDTH + column) * SCREEN_CAPTURE_CHANNELS;
-      pixels[target] = framebuffer[source + 2] ?? 0;
-      pixels[target + 1] = framebuffer[source + 1] ?? 0;
-      pixels[target + 2] = framebuffer[source] ?? 0;
-    }
-  }
-  return pixels;
-}
 function wrapTransfer(conn, operation) {
   return new import_neverthrow.ResultAsync(conn.withFileTransfer(async () => {
     try {
@@ -2823,10 +2446,10 @@ function ackTypeName(ackType) {
   return `AckType.${AckType[ackType] ?? "UNKNOWN"} (${ackType})`;
 }
 // src/VexDeviceState.ts
-var import_neverthrow4 = __toESM(require_index_cjs(), 1);
+var import_neverthrow4 = require("neverthrow");
 
 // src/VexFirmware.ts
-var import_neverthrow2 = __toESM(require_index_cjs(), 1);
+var import_neverthrow2 = require("neverthrow");
 var MAX_CATALOG_BYTES = 4 * 1024;
 var MAX_VEXOS_BYTES = 64 * 1024 * 1024;
 var MAX_FIRMWARE_IMAGE_BYTES = 32 * 1024 * 1024;
@@ -2974,7 +2597,7 @@ async function flashFactoryImage(conn, options, pcb) {
     autoRun: true,
     linkedFile: undefined
   };
-  const upload = await conn.uploadFileToDevice(writeRequest, (c, t) => {
+  const upload = await conn.uploadFileToDeviceUnlocked(writeRequest, (c, t) => {
     pcb(`UPLOAD ${label}`, c, t);
   });
   if (upload.isErr())
@@ -3101,34 +2724,40 @@ async function runUploadFirmware(state, publicUrl, usingVersion, progressCallbac
   }
   pcb("UNZIP VEXOS", 1, 1);
   return state.withRefreshPaused(async () => {
-    const boot = images.find((image) => image.name.endsWith("BOOT.bin"));
-    if (boot === undefined) {
-      return import_neverthrow2.err(new VexFirmwareError("VEXos archive is missing BOOT.bin"));
-    }
-    const assertImage = images.find((image) => image.name.endsWith("assets.bin"));
-    if (assertImage === undefined) {
-      return import_neverthrow2.err(new VexFirmwareError("VEXos archive is missing assets.bin"));
+    try {
+      return await conn.withFileTransfer(async () => {
+        const boot = images.find((image) => image.name.endsWith("BOOT.bin"));
+        if (boot === undefined) {
+          return import_neverthrow2.err(new VexFirmwareError("VEXos archive is missing BOOT.bin"));
+        }
+        const assertImage = images.find((image) => image.name.endsWith("assets.bin"));
+        if (assertImage === undefined) {
+          return import_neverthrow2.err(new VexFirmwareError("VEXos archive is missing assets.bin"));
+        }
+        const bootFlash = await flashFactoryImage(conn, {
+          image: boot,
+          label: "BOOT",
+          downloadTarget: 14 /* FILE_TARGET_B1 */
+        }, pcb);
+        if (bootFlash.isErr())
+          return import_neverthrow2.err(bootFlash.error);
+        const assetsFlash = await flashFactoryImage(conn, {
+          image: assertImage,
+          label: "ASSETS",
+          downloadTarget: 13 /* FILE_TARGET_A1 */
+        }, pcb);
+        if (assetsFlash.isErr())
+          return import_neverthrow2.err(assetsFlash.error);
+        return import_neverthrow2.ok(true);
+      });
+    } catch (e) {
+      return import_neverthrow2.err(toVexSerialError(e, "firmware"));
     }
-    const bootFlash = await flashFactoryImage(conn, {
-      image: boot,
-      label: "BOOT",
-      downloadTarget: 14 /* FILE_TARGET_B1 */
-    }, pcb);
-    if (bootFlash.isErr())
-      return import_neverthrow2.err(bootFlash.error);
-    const assetsFlash = await flashFactoryImage(conn, {
-      image: assertImage,
-      label: "ASSETS",
-      downloadTarget: 13 /* FILE_TARGET_A1 */
-    }, pcb);
-    if (assetsFlash.isErr())
-      return import_neverthrow2.err(assetsFlash.error);
-    return import_neverthrow2.ok(true);
   });
 }
 
 // src/VexTransfers.ts
-var import_neverthrow3 = __toESM(require_index_cjs(), 1);
+var import_neverthrow3 = require("neverthrow");
 function getValue(state, key) {
   return new import_neverthrow3.ResultAsync((async () => {
     const conn = state._instance.connection;
@@ -3662,7 +3291,7 @@ class V5Radio {
 }
 
 // src/VexDevice.ts
-var import_neverthrow5 = __toESM(require_index_cjs(), 1);
+var import_neverthrow5 = require("neverthrow");
 function unrefTimerIfPossible(timer) {
   if (typeof timer !== "object" || timer === null || !("unref" in timer))
     return;
@@ -3670,6 +3299,11 @@ function unrefTimerIfPossible(timer) {
   if (typeof unref === "function")
     unref.call(timer);
 }
+function describePort(port) {
+  const info = port.getInfo();
+  const identifier = info.path ?? info.id ?? info.serialNumber;
+  return typeof identifier === "string" ? identifier : undefined;
+}
 
 class V5SerialDevice extends VexSerialDevice {
   autoReconnect = true;
@@ -3679,8 +3313,11 @@ class V5SerialDevice extends VexSerialDevice {
   _refreshInterval;
   state = new V5SerialDeviceState(this);
   _disposed = false;
+  _lifecycleGeneration = 0;
+  _disconnectListener;
   _refreshGeneration = 0;
   _autoRefresh = false;
+  _refreshIntervalMs = 200;
   _isLastRefreshComplete = true;
   _brain = new V5Brain(this.state);
   _controllers = [
@@ -3689,8 +3326,15 @@ class V5SerialDevice extends VexSerialDevice {
   ];
   _radio = new V5Radio(this.state);
   _deviceFacades = [];
-  constructor(defaultSerial, autoRefresh = false) {
+  _emitSafely(eventName, data) {
+    try {
+      this.emit(eventName, data);
+    } catch {}
+  }
+  constructor(defaultSerial, options = false) {
     super(defaultSerial);
+    const autoRefresh = typeof options === "boolean" ? options : options.autoRefresh ?? false;
+    this.refreshIntervalMs = typeof options === "boolean" ? 200 : options.refreshIntervalMs ?? 200;
     this.autoRefresh = autoRefresh;
   }
   get autoRefresh() {
@@ -3706,6 +3350,21 @@ class V5SerialDevice extends VexSerialDevice {
       this._stopRefreshInterval();
     }
   }
+  get refreshIntervalMs() {
+    return this._refreshIntervalMs;
+  }
+  set refreshIntervalMs(value) {
+    if (!Number.isFinite(value) || value <= 0) {
+      throw new VexInvalidArgumentError("refreshIntervalMs must be a positive finite number");
+    }
+    if (this._refreshIntervalMs === value)
+      return;
+    this._refreshIntervalMs = value;
+    if (this._refreshInterval !== undefined) {
+      this._stopRefreshInterval();
+      this._startRefreshInterval();
+    }
+  }
   _startRefreshInterval() {
     if (this._refreshInterval !== undefined || this._disposed)
       return;
@@ -3723,16 +3382,16 @@ class V5SerialDevice extends VexSerialDevice {
             try {
               const r = await this.refresh();
               if (r.isErr())
-                this.emit("error", r.error);
+                this._emitSafely("error", r.error);
             } catch (error) {
-              this.emit("error", error);
+              this._emitSafely("error", error);
             } finally {
               this._isLastRefreshComplete = true;
             }
           })();
         }
       }
-    }, 200);
+    }, this._refreshIntervalMs);
     unrefTimerIfPossible(this._refreshInterval);
   }
   _stopRefreshInterval() {
@@ -3795,58 +3454,125 @@ class V5SerialDevice extends VexSerialDevice {
     })());
   }
   connect(conn) {
-    return new import_neverthrow5.ResultAsync(this._connect(conn));
+    if (this._disposed) {
+      return new import_neverthrow5.ResultAsync(Promise.resolve(this._staleLifecycleResult()));
+    }
+    if (this.isConnected)
+      return new import_neverthrow5.ResultAsync(Promise.resolve(import_neverthrow5.ok(undefined)));
+    const generation = ++this._lifecycleGeneration;
+    return new import_neverthrow5.ResultAsync(this._connect(conn, generation));
   }
-  async _connect(conn) {
+  async _connect(conn, generation = this._lifecycleGeneration) {
+    if (!this._isLifecycleCurrent(generation)) {
+      return this._staleLifecycleResult();
+    }
     if (this.isConnected)
       return import_neverthrow5.ok(undefined);
     if (conn != null) {
       if (!conn.isConnected) {
         const opened = await conn.open();
+        if (!this._isLifecycleCurrent(generation)) {
+          await conn.close();
+          return this._staleLifecycleResult();
+        }
         if (opened.isErr() || opened.value !== "opened") {
           return import_neverthrow5.err(new VexIoError("failed to open the supplied connection"));
         }
       }
       const q = await conn.query1();
+      if (!this._isLifecycleCurrent(generation)) {
+        await conn.close();
+        return this._staleLifecycleResult();
+      }
       if (q.isErr()) {
         await conn.close();
         return import_neverthrow5.err(q.error);
       }
-      this.connection = conn;
+      if (!this._commitConnection(conn, generation)) {
+        await conn.close();
+        return this._staleLifecycleResult();
+      }
     } else {
       let tryIdx = 0;
+      let canRequestPort = true;
+      const attemptedPorts = new Set;
+      const attemptedPortNames = [];
       while (true) {
-        const c = new V5SerialConnection(this.defaultSerial);
-        const result = await c.open(tryIdx++, true);
+        if (!this._isLifecycleCurrent(generation)) {
+          return this._staleLifecycleResult();
+        }
+        const c = this.createConnection();
+        let result = await c.open(tryIdx++, false);
+        if (!this._isLifecycleCurrent(generation)) {
+          await c.close();
+          return this._staleLifecycleResult();
+        }
+        if (result.isOk() && result.value === "no-port" && canRequestPort) {
+          canRequestPort = false;
+          result = await c.open(tryIdx, true);
+          if (!this._isLifecycleCurrent(generation)) {
+            await c.close();
+            return this._staleLifecycleResult();
+          }
+        }
         if (result.isErr()) {
           await c.close();
           return import_neverthrow5.err(result.error);
         }
         if (result.value === "no-port") {
-          return import_neverthrow5.err(new VexNotConnectedError("no V5 device was found"));
+          const attempted = attemptedPortNames.length ? `; attempted ${attemptedPortNames.join(", ")}` : "";
+          return import_neverthrow5.err(new VexNotConnectedError(`no responsive V5 device was found${attempted}`));
         }
         if (result.value === "busy") {
           await c.close();
-          continue;
+          return import_neverthrow5.err(new VexNotConnectedError("the selected V5 serial port is busy"));
+        }
+        const port = c.port;
+        if (port !== undefined && attemptedPorts.has(port)) {
+          await c.close();
+          const portName = describePort(port);
+          return import_neverthrow5.err(new VexNotConnectedError(portName === undefined ? "the selected serial port did not respond as a V5 device" : `serial port ${portName} did not respond as a V5 device`));
+        }
+        if (port !== undefined) {
+          attemptedPorts.add(port);
+          const portName = describePort(port);
+          if (portName !== undefined)
+            attemptedPortNames.push(portName);
         }
         const q = await c.query1();
+        if (!this._isLifecycleCurrent(generation)) {
+          await c.close();
+          return this._staleLifecycleResult();
+        }
         if (q.isErr()) {
           await c.close();
           continue;
         }
-        this.connection = c;
+        if (!this._commitConnection(c, generation)) {
+          await c.close();
+          return this._staleLifecycleResult();
+        }
         break;
       }
     }
-    if (!this.isConnected)
+    const connection = this.connection;
+    if (!this._isLifecycleCurrent(generation) || connection == null) {
+      return this._staleLifecycleResult();
+    }
+    if (!connection.isConnected)
       return import_neverthrow5.err(new VexNotConnectedError);
-    await this.doAfterConnect();
+    const initialized = await this.doAfterConnect(connection, generation);
+    if (initialized.isErr())
+      return initialized;
     return import_neverthrow5.ok(undefined);
   }
   async disconnect() {
+    this._lifecycleGeneration++;
+    this._refreshGeneration++;
     this._isDisconnecting = true;
     const connection = this.connection;
     this.connection = undefined;
+    this._detachDisconnectListener();
     try {
       await connection?.close();
     } finally {
@@ -3860,9 +3586,21 @@ class V5SerialDevice extends VexSerialDevice {
     await this.disconnect();
   }
   reconnect(timeout = 0) {
-    return new import_neverthrow5.ResultAsync(this._reconnect(timeout));
+    if (this._disposed) {
+      return new import_neverthrow5.ResultAsync(Promise.resolve(this._staleLifecycleResult()));
+    }
+    if (timeout < 0) {
+      return new import_neverthrow5.ResultAsync(Promise.resolve(import_neverthrow5.err(new VexInvalidArgumentError("timeout must be non-negative"))));
+    }
+    if (this.isConnected)
+      return new import_neverthrow5.ResultAsync(Promise.resolve(import_neverthrow5.ok(undefined)));
+    const generation = this._isReconnecting ? this._lifecycleGeneration : ++this._lifecycleGeneration;
+    return new import_neverthrow5.ResultAsync(this._reconnect(timeout, generation));
   }
-  async _reconnect(timeout) {
+  async _reconnect(timeout, generation = this._lifecycleGeneration) {
+    if (!this._isLifecycleCurrent(generation)) {
+      return this._staleLifecycleResult();
+    }
     if (this.isConnected)
       return import_neverthrow5.ok(undefined);
     if (timeout < 0) {
@@ -3878,6 +3616,9 @@ class V5SerialDevice extends VexSerialDevice {
           return import_neverthrow5.err(new VexNotConnectedError);
         }
       }
+      if (!this._isLifecycleCurrent(generation)) {
+        return this._staleLifecycleResult();
+      }
       if (this.isConnected)
         return import_neverthrow5.ok(undefined);
     }
@@ -3886,8 +3627,15 @@ class V5SerialDevice extends VexSerialDevice {
       while (timeout === 0 || Date.now() < endTime) {
         let tryIdx = 0;
         while (true) {
-          const c = new V5SerialConnection(this.defaultSerial);
+          if (!this._isLifecycleCurrent(generation)) {
+            return this._staleLifecycleResult();
+          }
+          const c = this.createConnection();
           const result = await c.open(tryIdx++, false);
+          if (!this._isLifecycleCurrent(generation)) {
+            await c.close();
+            return this._staleLifecycleResult();
+          }
           if (result.isErr()) {
             await c.close();
             return import_neverthrow5.err(result.error);
@@ -3899,6 +3647,10 @@ class V5SerialDevice extends VexSerialDevice {
             continue;
           }
           const status = await c.getSystemStatus(200);
+          if (!this._isLifecycleCurrent(generation)) {
+            await c.close();
+            return this._staleLifecycleResult();
+          }
           if (status.isErr()) {
             await c.close();
             continue;
@@ -3907,23 +3659,38 @@ class V5SerialDevice extends VexSerialDevice {
             await c.close();
             continue;
           }
-          this.connection = c;
+          if (!this._commitConnection(c, generation)) {
+            await c.close();
+            return this._staleLifecycleResult();
+          }
           break;
         }
         if (this.isConnected)
           break;
         const getPortCount = async () => (await this.defaultSerial.getPorts()).length;
         const portsCount = await getPortCount();
+        if (!this._isLifecycleCurrent(generation)) {
+          return this._staleLifecycleResult();
+        }
         await sleepUntilAsync(async () => await getPortCount() !== portsCount, 1000);
+        if (!this._isLifecycleCurrent(generation)) {
+          return this._staleLifecycleResult();
+        }
       }
     } catch (e) {
       return import_neverthrow5.err(toVexSerialError(e));
     } finally {
       this._isReconnecting = false;
     }
-    if (!this.isConnected)
+    const connection = this.connection;
+    if (!this._isLifecycleCurrent(generation) || connection == null) {
+      return this._staleLifecycleResult();
+    }
+    if (!connection.isConnected)
       return import_neverthrow5.err(new VexNotConnectedError);
-    await this.doAfterConnect();
+    const initialized = await this.doAfterConnect(connection, generation);
+    if (initialized.isErr())
+      return initialized;
     return import_neverthrow5.ok(undefined);
   }
   async waitForReconnectToFinish() {
@@ -3933,18 +3700,69 @@ class V5SerialDevice extends VexSerialDevice {
         return;
     }
   }
-  async doAfterConnect() {
-    if (this.connection == null)
-      return;
-    this.connection.on("disconnected", (_data) => {
-      if (this._isDisconnecting)
+  createConnection() {
+    return new V5SerialConnection(this.defaultSerial);
+  }
+  _isLifecycleCurrent(generation) {
+    return generation === this._lifecycleGeneration && !this._disposed;
+  }
+  _staleLifecycleResult() {
+    return import_neverthrow5.err(new VexNotConnectedError("connection attempt was superseded"));
+  }
+  _commitConnection(connection, generation) {
+    if (!this._isLifecycleCurrent(generation))
+      return false;
+    this._detachDisconnectListener();
+    this.connection = connection;
+    return true;
+  }
+  _detachDisconnectListener() {
+    const subscription = this._disconnectListener;
+    this._disconnectListener = undefined;
+    subscription?.connection.remove("disconnected", subscription.listener);
+  }
+  async doAfterConnect(connection, generation) {
+    if (!this._isLifecycleCurrent(generation) || this.connection !== connection) {
+      return this._staleLifecycleResult();
+    }
+    const listener = () => {
+      if (this._isDisconnecting || !this._isLifecycleCurrent(generation) || this.connection !== connection) {
         return;
-      this.emit("disconnected", undefined);
-      if (this.autoReconnect) {
-        this.reconnect().mapErr((e) => this.emit("error", e));
       }
-    });
-    await this.refresh();
+      this._lifecycleGeneration++;
+      this._refreshGeneration++;
+      this.connection = undefined;
+      this._detachDisconnectListener();
+      this._emitSafely("disconnected", undefined);
+      if (this.autoReconnect && !this._disposed) {
+        this.reconnect().mapErr((error) => this._emitSafely("error", error));
+      }
+    };
+    connection.on("disconnected", listener);
+    this._disconnectListener = { connection, listener };
+    const refreshed = await this.refresh();
+    if (!this._isLifecycleCurrent(generation) || this.connection !== connection || !connection.isConnected) {
+      return this._staleLifecycleResult();
+    }
+    if (refreshed.isErr()) {
+      await this._discardConnection(connection, generation);
+      return import_neverthrow5.err(refreshed.error);
+    }
+    if (!refreshed.value) {
+      await this._discardConnection(connection, generation);
+      return import_neverthrow5.err(new VexNotConnectedError("initial device refresh did not produce a current snapshot"));
+    }
+    return import_neverthrow5.ok(undefined);
+  }
+  async _discardConnection(connection, generation) {
+    if (!this._isLifecycleCurrent(generation) || this.connection !== connection) {
+      return;
+    }
+    this._lifecycleGeneration++;
+    this._refreshGeneration++;
+    this.connection = undefined;
+    this._detachDisconnectListener();
+    await connection.close();
   }
   refresh() {
     return new import_neverthrow5.ResultAsync(this._refresh());
@@ -3958,31 +3776,15 @@ class V5SerialDevice extends VexSerialDevice {
       this._applySnapshotIfCurrent(generation, { isAvailable: false });
       return import_neverthrow5.ok(false);
     }
-    const ssPacket = await conn.getSystemStatus();
-    if (generation !== this._refreshGeneration || this._disposed)
-      return import_neverthrow5.ok(false);
-    if (ssPacket.isErr()) {
-      this._applySnapshotIfCurrent(generation, { isAvailable: false });
-      return import_neverthrow5.ok(false);
-    }
-    const sfPacket = await conn.getSystemFlags();
-    if (generation !== this._refreshGeneration || this._disposed)
-      return import_neverthrow5.ok(false);
-    if (sfPacket.isErr()) {
-      this._applySnapshotIfCurrent(generation, { isAvailable: false });
-      return import_neverthrow5.ok(false);
-    }
-    const rdPacket = await conn.getRadioStatus();
-    if (generation !== this._refreshGeneration || this._disposed)
-      return import_neverthrow5.ok(false);
-    if (rdPacket.isErr()) {
-      this._applySnapshotIfCurrent(generation, { isAvailable: false });
-      return import_neverthrow5.ok(false);
-    }
-    const dsPacket = await conn.getDeviceStatus();
+    const [ssPacket, sfPacket, rdPacket, dsPacket] = await Promise.all([
+      conn.getSystemStatus(),
+      conn.getSystemFlags(),
+      conn.getRadioStatus(),
+      conn.getDeviceStatus()
+    ]);
     if (generation !== this._refreshGeneration || this._disposed)
       return import_neverthrow5.ok(false);
-    if (dsPacket.isErr()) {
+    if (ssPacket.isErr() || sfPacket.isErr() || rdPacket.isErr() || dsPacket.isErr()) {
       this._applySnapshotIfCurrent(generation, { isAvailable: false });
       return import_neverthrow5.ok(false);
     }
@@ -4039,7 +3841,7 @@ class V5SerialDevice extends VexSerialDevice {
         {
           battery: controller1Battery,
           isAvailable: controller1Available,
-          isCharging: (flags2 & 128) !== 0
+          isCharging: undefined
         }
       ],
       radio: {
@@ -4066,7 +3868,26 @@ class V5SerialDevice extends VexSerialDevice {
     }
     this.state.matchMode = snapshot.matchMode;
     this.state.isFieldControllerConnected = snapshot.isFieldControllerConnected;
-    Object.assign(this.state.brain, snapshot.brain);
+    const brain = this.state.brain;
+    brain.activeProgram = snapshot.brain.activeProgram;
+    brain.battery.batteryPercent = snapshot.brain.battery.batteryPercent;
+    brain.battery.isCharging = snapshot.brain.battery.isCharging;
+    brain.button.isPressed = snapshot.brain.button.isPressed;
+    brain.button.isDoublePressed = snapshot.brain.button.isDoublePressed;
+    if (brain.cpu0Version.compare(snapshot.brain.cpu0Version) !== 0) {
+      brain.cpu0Version = snapshot.brain.cpu0Version;
+    }
+    if (brain.cpu1Version.compare(snapshot.brain.cpu1Version) !== 0) {
+      brain.cpu1Version = snapshot.brain.cpu1Version;
+    }
+    brain.isAvailable = snapshot.brain.isAvailable;
+    brain.settings.isScreenReversed = snapshot.brain.settings.isScreenReversed;
+    brain.settings.isWhiteTheme = snapshot.brain.settings.isWhiteTheme;
+    brain.settings.usingLanguage = snapshot.brain.settings.usingLanguage;
+    if (brain.systemVersion.compare(snapshot.brain.systemVersion) !== 0) {
+      brain.systemVersion = snapshot.brain.systemVersion;
+    }
+    brain.uniqueId = snapshot.brain.uniqueId;
     Object.assign(this.state.controllers[0], snapshot.controllers[0]);
     Object.assign(this.state.controllers[1], snapshot.controllers[1]);
     Object.assign(this.state.radio, snapshot.radio);
@@ -4075,10 +3896,18 @@ class V5SerialDevice extends VexSerialDevice {
       if (device != null)
         next[device.port] = device;
     }
-    this.state.devices = next;
+    if (!sameSmartDeviceSlots(this.state.devices, next)) {
+      this.state.devices = next;
+    }
     return true;
   }
 }
+function sameSmartDeviceSlots(left, right) {
+  return left.length === right.length && left.every((device, index) => {
+    const next = right[index];
+    return device === next || device !== undefined && next !== undefined && device.port === next.port && device.type === next.type && device.status === next.status && device.betaversion === next.betaversion && device.version === next.version && device.bootversion === next.bootversion;
+  });
+}
 // src/VexIniConfig.ts
 class BaseIniBuilder {
   str = "";
@@ -4087,7 +3916,7 @@ class BaseIniBuilder {
 `;
   }
   addComment(comment) {
-    this.addLine("; " + comment);
+    this.addLine(comment.length === 0 ? ";" : "; " + comment);
     return this;
   }
   getContent() {
@@ -4105,18 +3934,23 @@ class IniSectionBuilder extends BaseIniBuilder {
     this.object = object;
     this.keyTransform = keyTransform;
   }
-  addSingleObjProperty(key, maxValueLength) {
-    const value = this.object[key];
-    if (value == null || value.toString().length === 0)
+  addSingleObjProperty(key, maxValueLength, omitIfEmpty = false) {
+    const rawValue = this.object[key];
+    if (rawValue == null)
+      return;
+    const value = rawValue.toString();
+    if (omitIfEmpty && value.length === 0)
       return;
+    if (/["\u0000-\u001f\u007f]/.test(value)) {
+      throw new Error(`INI value for ${this.name}.${String(key)} contains an unsupported character`);
+    }
     const formattedKey = this.keyTransform(key).padEnd(12).slice(0, 12);
-    const trimmedVal = value.toString().slice(0, maxValueLength);
-    const escapedVal = trimmedVal.replace(/["\\\u0000-\u001f\u007f]/g, (character) => `\\x${character.charCodeAt(0).toString(16).padStart(2, "0")}`);
-    this.addLine(`${formattedKey} = "${escapedVal}"`);
+    const trimmedValue = value.slice(0, maxValueLength);
+    this.addLine(`${formattedKey} = "${trimmedValue}"`);
   }
-  addObjProperty(key, maxValueLength) {
+  addObjProperty(key, maxValueLength, omitIfEmpty = false) {
     for (const k of Array.isArray(key) ? key : [key]) {
-      this.addSingleObjProperty(k, maxValueLength);
+      this.addSingleObjProperty(k, maxValueLength, omitIfEmpty);
     }
     return this;
   }
@@ -4134,6 +3968,11 @@ class IniFileBuilder extends BaseIniBuilder {
     this.str += section.getContent();
     return this;
   }
+  addOptionalSection(section) {
+    if (section.getContent().length === 0)
+      return this;
+    return this.addComment("").addSection(section);
+  }
 }
 
 class ProgramIniConfig {
@@ -4164,12 +4003,12 @@ class ProgramIniConfig {
     if (this.program.date.length === 0) {
       this.setProgramDate(new Date);
     }
-    return new IniFileBuilder().addComment("").addComment("VEX program ini file").addComment("Generated by Vex V5 Serial Protocol Library").addComment("").addSection(new IniSectionBuilder("project", this.project).addObjProperty("ide", 16)).addComment("").addSection(new IniSectionBuilder("program", this.program).addObjProperty("name", 32).addObjProperty("description", 256).addObjProperty("icon", 16).addObjProperty("iconalt", 16).addObjProperty("slot", 16)).addComment("").addSection(new IniSectionBuilder("config", this.config, (k) => "port_" + this.dec2(k)).addAllObjProps()).addComment("").addSection(new IniSectionBuilder("controller_1", this.controller1).addAllObjProps()).addComment("").addSection(new IniSectionBuilder("controller_2", this.controller2).addAllObjProps()).getContent();
+    return new IniFileBuilder().addComment("").addComment("VEX program ini file").addComment("Generated by Vex V5 Serial Protocol Library").addComment("").addSection(new IniSectionBuilder("project", this.project).addObjProperty("version").addObjProperty("ide", 16).addObjProperty("file")).addComment("").addSection(new IniSectionBuilder("program", this.program).addObjProperty("version").addObjProperty("name", 32).addObjProperty("slot").addObjProperty("icon", 16).addObjProperty("iconalt", 16, true).addObjProperty("description", 256).addObjProperty("date").addObjProperty("timezone")).addComment("").addSection(new IniSectionBuilder("config", this.config, (k) => "port_" + this.dec2(k)).addAllObjProps()).addOptionalSection(new IniSectionBuilder("controller_1", this.controller1).addAllObjProps()).addOptionalSection(new IniSectionBuilder("controller_2", this.controller2).addAllObjProps()).getContent();
   }
   dec2(value) {
     return (value % 100).toString(10).padStart(2, "0").toUpperCase();
   }
 }
 
-//# debugId=6C653363AF816C0D64756E2164756E21
+//# debugId=60E9322CE95DA15264756E2164756E21
 //# sourceMappingURL=index.cjs.map