ultimatedarktower 4.0.1 → 4.1.0

package/dist/esm/index.mjs

@@ -9,8 +9,13 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   if (typeof require !== "undefined") return require.apply(this, arguments);
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+var __esm = (fn, res, err) => function __init() {
+  if (err) throw err[0];
+  try {
+    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+  } catch (e) {
+    throw err = [e], e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -862,6 +867,52 @@ var init_NodeBluetoothAdapter = __esm({
   }
 });
 
+// src/adapters/NoopBluetoothAdapter.ts
+var NoopBluetoothAdapter_exports = {};
+__export(NoopBluetoothAdapter_exports, {
+  NoopBluetoothAdapter: () => NoopBluetoothAdapter
+});
+var NoopBluetoothAdapter;
+var init_NoopBluetoothAdapter = __esm({
+  "src/adapters/NoopBluetoothAdapter.ts"() {
+    "use strict";
+    init_udtBluetoothAdapter();
+    NoopBluetoothAdapter = class {
+      async connect(_deviceName, _serviceUuids) {
+        void _deviceName;
+        void _serviceUuids;
+        throw new BluetoothError("Bluetooth is disabled (platform: none)");
+      }
+      async disconnect() {
+      }
+      isConnected() {
+        return false;
+      }
+      isGattConnected() {
+        return false;
+      }
+      async writeCharacteristic(_data) {
+        void _data;
+        throw new BluetoothError("Bluetooth is disabled (platform: none)");
+      }
+      onCharacteristicValueChanged(callback) {
+        this.characteristicCallback = callback;
+      }
+      onDisconnect(callback) {
+        this.disconnectCallback = callback;
+      }
+      onBluetoothAvailabilityChanged(callback) {
+        this.availabilityCallback = callback;
+      }
+      async readDeviceInformation() {
+        return {};
+      }
+      async cleanup() {
+      }
+    };
+  }
+});
+
 // src/UltimateDarkTower.ts
 init_udtConstants();
 
@@ -1457,9 +1508,8 @@ var TowerResponseProcessor = class {
         return [towerCommand.name, commandToPacketString(command)];
       case TC.BATTERY: {
         const millivolts = getMilliVoltsFromTowerResponse(command);
-        const retval = [towerCommand.name, milliVoltsToPercentage(millivolts)];
+        const retval = [towerCommand.name, `${milliVoltsToPercentage(millivolts)} (${(millivolts / 1e3).toFixed(2)}mv)`];
         if (this.logDetail) {
-          retval.push(`${millivolts}mv`);
           retval.push(commandToPacketString(command));
         }
         return retval;
@@ -1500,11 +1550,12 @@ var TowerResponseProcessor = class {
 };
 
 // src/udtBluetoothAdapterFactory.ts
-var BluetoothPlatform = /* @__PURE__ */ ((BluetoothPlatform3) => {
-  BluetoothPlatform3["WEB"] = "web";
-  BluetoothPlatform3["NODE"] = "node";
-  BluetoothPlatform3["AUTO"] = "auto";
-  return BluetoothPlatform3;
+var BluetoothPlatform = /* @__PURE__ */ ((BluetoothPlatform2) => {
+  BluetoothPlatform2["WEB"] = "web";
+  BluetoothPlatform2["NODE"] = "node";
+  BluetoothPlatform2["AUTO"] = "auto";
+  BluetoothPlatform2["NONE"] = "none";
+  return BluetoothPlatform2;
 })(BluetoothPlatform || {});
 var BluetoothAdapterFactory = class {
   /**
@@ -1523,6 +1574,10 @@ var BluetoothAdapterFactory = class {
         const { NodeBluetoothAdapter: NodeBluetoothAdapter2 } = (init_NodeBluetoothAdapter(), __toCommonJS(NodeBluetoothAdapter_exports));
         return new NodeBluetoothAdapter2();
       }
+      case "none" /* NONE */: {
+        const { NoopBluetoothAdapter: NoopBluetoothAdapter2 } = (init_NoopBluetoothAdapter(), __toCommonJS(NoopBluetoothAdapter_exports));
+        return new NoopBluetoothAdapter2();
+      }
       default:
         throw new Error(`Unsupported Bluetooth platform: ${detectedPlatform}`);
     }
@@ -1559,6 +1614,12 @@ var UdtBleConnection = class {
     // higher-level state (command queue, tower state, broken seals) at the
     // moment a disconnect cause fires.
     this.snapshotProviders = null;
+    // Bluetooth adapter (platform-agnostic).
+    // Null until an adapter is provided or lazily created on first connect() —
+    // construction never triggers platform detection, so creating an
+    // UltimateDarkTower in a non-Bluetooth environment (e.g. iOS Safari) does
+    // not throw. The detection error, if any, surfaces at connect() time.
+    this.bluetoothAdapter = null;
     // Connection state
     this.isConnected = false;
     this.isDisposed = false;
@@ -1604,17 +1665,41 @@ var UdtBleConnection = class {
     this.callbacks = callbacks;
     this.responseProcessor = new TowerResponseProcessor();
     this.recorder = recorder ?? null;
-    this.bluetoothAdapter = adapter || BluetoothAdapterFactory.create("auto" /* AUTO */);
-    this.bluetoothAdapter.onCharacteristicValueChanged((data) => {
+    if (adapter) {
+      this.bluetoothAdapter = adapter;
+      this.wireAdapterCallbacks(adapter);
+    }
+  }
+  /**
+   * Wires this connection's internal handlers onto a Bluetooth adapter.
+   * Called when an adapter is supplied at construction, or when one is
+   * lazily created on first connect().
+   */
+  wireAdapterCallbacks(adapter) {
+    adapter.onCharacteristicValueChanged((data) => {
       this.onRxData(data);
     });
-    this.bluetoothAdapter.onDisconnect(() => {
+    adapter.onDisconnect(() => {
       this.onTowerDeviceDisconnected();
     });
-    this.bluetoothAdapter.onBluetoothAvailabilityChanged((available) => {
+    adapter.onBluetoothAvailabilityChanged((available) => {
       this.bleAvailabilityChange(available);
     });
   }
+  /**
+   * Returns the Bluetooth adapter, lazily creating one via platform
+   * auto-detection on first use. Platform-detection errors (e.g. no Web
+   * Bluetooth on iOS) surface here, at connect time, rather than at
+   * construction.
+   */
+  ensureAdapter() {
+    if (!this.bluetoothAdapter) {
+      const adapter = BluetoothAdapterFactory.create("auto" /* AUTO */);
+      this.bluetoothAdapter = adapter;
+      this.wireAdapterCallbacks(adapter);
+    }
+    return this.bluetoothAdapter;
+  }
   setDiagnosticsSnapshotProviders(providers) {
     this.snapshotProviders = providers;
   }
@@ -1650,7 +1735,8 @@ var UdtBleConnection = class {
     }
     this.logger.info("Looking for Tower...", "[UDT]");
     try {
-      await this.bluetoothAdapter.connect(
+      const adapter = this.ensureAdapter();
+      await adapter.connect(
         TOWER_DEVICE_NAME,
         [UART_SERVICE_UUID, DIS_SERVICE_UUID]
       );
@@ -1675,8 +1761,9 @@ var UdtBleConnection = class {
     if (this.isConnected) {
       this.recordIncident("user_initiated");
     }
-    if (this.bluetoothAdapter.isConnected()) {
-      await this.bluetoothAdapter.disconnect();
+    const adapter = this.bluetoothAdapter;
+    if (adapter?.isConnected()) {
+      await adapter.disconnect();
       this.logger.info("Tower disconnected", "[UDT]");
     }
     this.handleDisconnection();
@@ -1686,8 +1773,12 @@ var UdtBleConnection = class {
    * Used by UdtTowerCommands instead of direct characteristic access.
    */
   async writeCommand(command) {
+    const adapter = this.bluetoothAdapter;
+    if (!adapter) {
+      throw new Error("Cannot write command: not connected (no Bluetooth adapter)");
+    }
     this.recorder?.recordCommandPayload("cmd_sent", command, { len: command.length });
-    return await this.bluetoothAdapter.writeCharacteristic(command);
+    return await adapter.writeCharacteristic(command);
   }
   /**
    * Processes received data from the RX characteristic (platform-agnostic).
@@ -1732,7 +1823,7 @@ var UdtBleConnection = class {
   }
   handleTowerStateResponse(receivedData) {
     const dataSkullDropCount = receivedData[SKULL_DROP_COUNT_POS];
-    const state = rtdt_unpack_state(receivedData);
+    const state = rtdt_unpack_state(receivedData.slice(TOWER_STATE_DATA_OFFSET, TOWER_STATE_RESPONSE_MIN_LENGTH));
     this.logger.debug(`Tower State: ${JSON.stringify(state)} `, "[UDT][BLE]");
     this.recorder?.recordEvent("tower_state_response");
     if (this.performingCalibration) {
@@ -1812,7 +1903,7 @@ var UdtBleConnection = class {
     if (!this.isConnected) {
       return;
     }
-    if (!this.bluetoothAdapter.isGattConnected()) {
+    if (!(this.bluetoothAdapter?.isGattConnected() ?? false)) {
       this.logger.warn("GATT connection lost detected during health check", "[UDT][BLE]");
       this.recordIncident("gatt_health_check");
       this.handleDisconnection();
@@ -1830,7 +1921,7 @@ var UdtBleConnection = class {
         }
         if (this.batteryHeartbeatVerifyConnection) {
           this.logger.info("Verifying tower connection status before triggering disconnection...", "[UDT][BLE]");
-          if (this.bluetoothAdapter.isGattConnected()) {
+          if (this.bluetoothAdapter?.isGattConnected() ?? false) {
             this.logger.info("GATT connection still available - heartbeat timeout may be temporary", "[UDT][BLE]");
             this.recorder?.recordEvent("heartbeat_late", {
               sinceMs: timeSinceLastBatteryHeartbeat,
@@ -1878,7 +1969,7 @@ var UdtBleConnection = class {
     if (!this.isConnected) {
       return false;
     }
-    return this.bluetoothAdapter.isGattConnected();
+    return this.bluetoothAdapter?.isGattConnected() ?? false;
   }
   getConnectionStatus() {
     const now = Date.now();
@@ -1886,7 +1977,7 @@ var UdtBleConnection = class {
     const timeSinceLastCommand = this.lastSuccessfulCommand ? now - this.lastSuccessfulCommand : -1;
     return {
       isConnected: this.isConnected,
-      isGattConnected: this.bluetoothAdapter.isGattConnected(),
+      isGattConnected: this.bluetoothAdapter?.isGattConnected() ?? false,
       lastBatteryHeartbeatMs: timeSinceLastBattery,
       lastCommandResponseMs: timeSinceLastCommand,
       batteryHeartbeatHealthy: timeSinceLastBattery >= 0 && timeSinceLastBattery < this.batteryHeartbeatTimeout,
@@ -1901,9 +1992,11 @@ var UdtBleConnection = class {
     return { ...this.deviceInformation };
   }
   async readDeviceInformation() {
+    const adapter = this.bluetoothAdapter;
+    if (!adapter) return;
     try {
       this.logger.info("Reading device information service...", "[UDT][BLE]");
-      this.deviceInformation = await this.bluetoothAdapter.readDeviceInformation();
+      this.deviceInformation = await adapter.readDeviceInformation();
       for (const [key, value] of Object.entries(this.deviceInformation)) {
         if (key !== "lastUpdated" && value) {
           this.logger.info(`Device ${key}: ${value}`, "[UDT][BLE]");
@@ -1921,7 +2014,7 @@ var UdtBleConnection = class {
     if (this.isConnected) {
       await this.disconnect();
     }
-    await this.bluetoothAdapter.cleanup();
+    await this.bluetoothAdapter?.cleanup();
   }
 };
 
@@ -3126,6 +3219,15 @@ var UltimateDarkTower = class {
       void oldState;
       void source;
     };
+    /**
+     * Called with the raw bytes of every non-battery tower notification (e.g.
+     * tower-state responses). Use this when you need the verbatim packet rather
+     * than the decoded `TowerState` from {@link onTowerStateUpdate} — for example
+     * a relay forwarding the tower's exact 20-byte state to other consumers.
+     */
+    this.onTowerResponse = (response) => {
+      void response;
+    };
     // utility
     this._logDetail = false;
     this.initializeLogger();
@@ -3162,7 +3264,7 @@ var UltimateDarkTower = class {
     let adapter;
     if (config?.adapter) {
       adapter = config.adapter;
-    } else if (config?.platform) {
+    } else if (config?.platform && config.platform !== "auto" /* AUTO */) {
       adapter = BluetoothAdapterFactory.create(config.platform);
     }
     this.towerEventCallbacks = this.createTowerEventCallbacks();
@@ -3213,6 +3315,7 @@ var UltimateDarkTower = class {
           this.updateTowerStateFromResponse(stateData);
         }
       }
+      this.onTowerResponse(response);
     };
   }
   /**
@@ -4339,6 +4442,95 @@ function dumpSeedChars(seed) {
   return { seed: normalized, chars };
 }
 
+// src/udtHeroes.ts
+var HEROES = [
+  // Base (4)
+  { id: "brutal-warlord", name: "Brutal Warlord", source: "base" },
+  { id: "orphaned-scion", name: "Orphaned Scion", source: "base" },
+  { id: "relic-hunter", name: "Relic Hunter", source: "base" },
+  { id: "spymaster", name: "Spymaster", source: "base" },
+  // Alliances (2)
+  { id: "archwright", name: "Archwright", source: "alliances" },
+  { id: "haunted-recluse", name: "Haunted Recluse", source: "alliances" },
+  // Covenant (4)
+  { id: "devious-swindler", name: "Devious Swindler", source: "covenant" },
+  { id: "relentless-warden", name: "Relentless Warden", source: "covenant" },
+  { id: "reverent-astromancer", name: "Reverent Astromancer", source: "covenant" },
+  { id: "undaunted-aegis", name: "Undaunted Aegis", source: "covenant" },
+  // Expeditions (4, unreleased — provisional)
+  { id: "jocular-druid", name: "Jocular Druid", source: "expeditions" },
+  { id: "grizzled-mariner", name: "Grizzled Mariner", source: "expeditions" },
+  { id: "clever-tinkerer", name: "Clever Tinkerer", source: "expeditions" },
+  { id: "enlightened-ascetic", name: "Enlightened Ascetic", source: "expeditions" }
+];
+var HERO_BY_ID = Object.freeze(
+  HEROES.reduce((acc, hero) => {
+    acc[hero.id] = hero;
+    return acc;
+  }, {})
+);
+
+// src/udtMonuments.ts
+var MONUMENTS = [
+  { id: "arch-of-the-golden-sun", name: "Arch of the Golden Sun", source: "covenant" },
+  { id: "argent-oak", name: "Argent Oak", source: "covenant" },
+  { id: "cenotaph-of-the-first-prophet", name: "Cenotaph of the First Prophet", source: "covenant" },
+  { id: "colossus-of-bjorn", name: "Colossus of Bjorn", source: "covenant" },
+  { id: "endless-necropolis", name: "Endless Necropolis", source: "covenant" },
+  { id: "moonstone-temple", name: "Moonstone Temple", source: "covenant" },
+  { id: "nightmare-cage", name: "Nightmare Cage", source: "covenant" },
+  { id: "tower-shard", name: "Tower Shard", source: "covenant" }
+];
+var MONUMENT_BY_ID = Object.freeze(
+  MONUMENTS.reduce((acc, monument) => {
+    acc[monument.id] = monument;
+    return acc;
+  }, {})
+);
+
+// src/udtFoes.ts
+var FOE_STATUSES = ["panicked", "unsteady", "ready", "savage", "lethal"];
+var FOES = [
+  // Tier 1 — level 2
+  { id: "brigands", name: "Brigands", kind: "foe", level: 2, tier: 1, source: "base" },
+  { id: "oreks", name: "Oreks", kind: "foe", level: 2, tier: 1, source: "base" },
+  { id: "shadow-wolves", name: "Shadow Wolves", kind: "foe", level: 2, tier: 1, source: "base" },
+  { id: "spine-fiends", name: "Spine Fiends", kind: "foe", level: 2, tier: 1, source: "base" },
+  // Tier 2 — level 3
+  { id: "frost-trolls", name: "Frost Trolls", kind: "foe", level: 3, tier: 2, source: "base" },
+  { id: "clan-of-neuri", name: "Clan of Neuri", kind: "foe", level: 3, tier: 2, source: "base" },
+  { id: "lemures", name: "Lemures", kind: "foe", level: 3, tier: 2, source: "base" },
+  { id: "widowmade-spiders", name: "Widowmade Spiders", kind: "foe", level: 3, tier: 2, source: "base" },
+  // Tier 3 — level 4
+  { id: "dragons", name: "Dragons", kind: "foe", level: 4, tier: 3, source: "base" },
+  { id: "mormos", name: "Mormos", kind: "foe", level: 4, tier: 3, source: "base" },
+  { id: "striga", name: "Striga", kind: "foe", level: 4, tier: 3, source: "base" },
+  { id: "titans", name: "Titans", kind: "foe", level: 4, tier: 3, source: "base" }
+];
+var ADVERSARY_ROSTER = [
+  { id: "ashstrider", name: "Ashstrider", kind: "adversary", level: 5, source: "base" },
+  { id: "bane-of-omens", name: "Bane of Omens", kind: "adversary", level: 5, source: "base" },
+  { id: "empress-of-shades", name: "Empress of Shades", kind: "adversary", level: 5, source: "base" },
+  { id: "gaze-eternal", name: "Gaze Eternal", kind: "adversary", level: 5, source: "base" },
+  { id: "gravemaw", name: "Gravemaw", kind: "adversary", level: 5, source: "base" },
+  { id: "isa-the-exile", name: "Isa the Exile", kind: "adversary", level: 5, source: "base" },
+  { id: "lingering-rot", name: "Lingering Rot", kind: "adversary", level: 5, source: "base" },
+  { id: "utuk-ku", name: "Utuk'Ku", kind: "adversary", level: 5, source: "base" }
+];
+var ALL_FOES = [...FOES, ...ADVERSARY_ROSTER];
+var FOE_BY_ID = Object.freeze(
+  ALL_FOES.reduce((acc, foe) => {
+    acc[foe.id] = foe;
+    return acc;
+  }, {})
+);
+var FOE_BY_NAME = Object.freeze(
+  ALL_FOES.reduce((acc, foe) => {
+    acc[foe.name] = foe;
+    return acc;
+  }, {})
+);
+
 // src/udtSystemRandom.ts
 var INT32_MAX = 2147483647;
 var MSEED = 161803398;
@@ -4529,14 +4721,729 @@ var BOARD_LOCATIONS = [
 ];
 var BOARD_LOCATION_BY_NAME = Object.fromEntries(BOARD_LOCATIONS.map((loc) => [loc.name, loc]));
 
+// src/udtBoardAnchors.ts
+var BOARD_IMAGE_INFO = {
+  width: 4096,
+  height: 4096,
+  centerX: 0.5,
+  centerY: 0.5,
+  radius: 0.5,
+  northHeadingDegrees: 135
+};
+var BOARD_ANCHORS = {
+  "Broken Lands": {
+    hero: { x: 0.80599, y: 0.51238 },
+    foe: { x: 0.8355, y: 0.50648 },
+    marker: { x: 0.81451, y: 0.53009 }
+  },
+  Dayside: {
+    building: { x: 0.74564, y: 0.7754 },
+    skull: { x: 0.75351, y: 0.77147 },
+    hero: { x: 0.78708, y: 0.84542 },
+    foe: { x: 0.82397, y: 0.81232 },
+    marker: { x: 0.79742, y: 0.81818 }
+  },
+  "Egan's End": {
+    building: { x: 0.57088, y: 0.9152 },
+    skull: { x: 0.57506, y: 0.92844 },
+    hero: { x: 0.65606, y: 0.89196 },
+    foe: { x: 0.66675, y: 0.91679 },
+    marker: { x: 0.63365, y: 0.91644 }
+  },
+  Fivepint: {
+    marker: { x: 0.84691, y: 0.76433 },
+    hero: { x: 0.82, y: 0.75615 },
+    foe: { x: 0.83838, y: 0.73603 }
+  },
+  "Green Bridge": {
+    hero: { x: 0.73574, y: 0.71149 },
+    foe: { x: 0.77097, y: 0.67222 },
+    marker: { x: 0.76259, y: 0.69647 }
+  },
+  "Lodestone Mountains": {
+    hero: { x: 0.90983, y: 0.54979 },
+    foe: { x: 0.93133, y: 0.52482 },
+    marker: { x: 0.92439, y: 0.57164 }
+  },
+  "Lower Ice Fangs": {
+    hero: { x: 0.644, y: 0.75336 },
+    foe: { x: 0.60986, y: 0.76715 },
+    marker: { x: 0.65399, y: 0.77853 }
+  },
+  "Muted Forest": {
+    hero: { x: 0.72254, y: 0.57754 },
+    foe: { x: 0.71006, y: 0.53557 },
+    marker: { x: 0.74474, y: 0.54875 }
+  },
+  "Peaks of the Djinn": {
+    hero: { x: 0.52263, y: 0.73716 },
+    foe: { x: 0.53056, y: 0.76095 },
+    marker: { x: 0.53401, y: 0.78715 }
+  },
+  "Pearl of the North": {
+    marker: { x: 0.90091, y: 0.66962 },
+    hero: { x: 0.89715, y: 0.69647 },
+    foe: { x: 0.91852, y: 0.64046 }
+  },
+  "Radiant Mountains": {
+    building: { x: 0.82063, y: 0.64652 },
+    skull: { x: 0.82727, y: 0.64883 },
+    hero: { x: 0.81081, y: 0.6058 },
+    foe: { x: 0.82294, y: 0.57982 },
+    marker: { x: 0.85182, y: 0.59425 }
+  },
+  Rimeweald: {
+    hero: { x: 0.58228, y: 0.83094 },
+    foe: { x: 0.54746, y: 0.84576 },
+    marker: { x: 0.614, y: 0.84852 }
+  },
+  "The Tundra": {
+    hero: { x: 0.71123, y: 0.84955 },
+    foe: { x: 0.69675, y: 0.82094 },
+    marker: { x: 0.72778, y: 0.87369 }
+  },
+  "Tower Scar Desert": {
+    marker: { x: 0.63365, y: 0.57476 },
+    hero: { x: 0.64227, y: 0.53994 },
+    foe: { x: 0.58642, y: 0.61028 }
+  },
+  "Upper Ice Fangs": {
+    building: { x: 0.68089, y: 0.66613 },
+    skull: { x: 0.68571, y: 0.66096 },
+    foe: { x: 0.5478, y: 0.67889 },
+    hero: { x: 0.63882, y: 0.7044 },
+    marker: { x: 0.59159, y: 0.67578 }
+  },
+  "Big Sister": {
+    hero: { x: 0.29269, y: 0.60241 },
+    foe: { x: 0.28651, y: 0.56064 },
+    marker: { x: 0.26136, y: 0.54023 }
+  },
+  "Bleak Wastes": {
+    marker: { x: 0.45929, y: 0.67741 },
+    hero: { x: 0.44885, y: 0.64751 },
+    foe: { x: 0.47163, y: 0.65937 }
+  },
+  "Copper Grove": {
+    hero: { x: 0.34044, y: 0.8742 },
+    foe: { x: 0.37074, y: 0.91984 },
+    marker: { x: 0.3369, y: 0.90017 }
+  },
+  "Dragontooth Lake": {
+    marker: { x: 0.43784, y: 0.75253 },
+    hero: { x: 0.38955, y: 0.70385 },
+    foe: { x: 0.38599, y: 0.7367 }
+  },
+  Duwani: {
+    building: { x: 0.21975, y: 0.79014 },
+    skull: { x: 0.22094, y: 0.79251 },
+    hero: { x: 0.20946, y: 0.83367 },
+    foe: { x: 0.18729, y: 0.76599 },
+    marker: { x: 0.16988, y: 0.77905 }
+  },
+  "Forest of Shades": {
+    hero: { x: 0.36184, y: 0.57047 },
+    foe: { x: 0.35393, y: 0.54355 },
+    marker: { x: 0.37965, y: 0.6053 }
+  },
+  "Greater Tombstones": {
+    building: { x: 0.31989, y: 0.66902 },
+    skull: { x: 0.32384, y: 0.66467 },
+    hero: { x: 0.27041, y: 0.67773 },
+    foe: { x: 0.22133, y: 0.66546 },
+    marker: { x: 0.25933, y: 0.65675 }
+  },
+  "Inner Kinghills": {
+    building: { x: 0.4061, y: 0.83461 },
+    skull: { x: 0.41279, y: 0.83658 },
+    hero: { x: 0.45685, y: 0.81494 },
+    foe: { x: 0.43364, y: 0.87592 },
+    marker: { x: 0.46236, y: 0.84169 }
+  },
+  "Jewel Hills": {
+    marker: { x: 0.26293, y: 0.86082 },
+    foe: { x: 0.29301, y: 0.81688 },
+    hero: { x: 0.27599, y: 0.84063 }
+  },
+  "Lake of Songs": {
+    hero: { x: 0.1157, y: 0.71675 },
+    foe: { x: 0.14498, y: 0.72862 },
+    marker: { x: 0.10778, y: 0.68825 }
+  },
+  "Lesser Tombstones": {
+    hero: { x: 0.19169, y: 0.5889 },
+    foe: { x: 0.18179, y: 0.6178 },
+    marker: { x: 0.1715, y: 0.655 }
+  },
+  "Outer Kinghills": {
+    hero: { x: 0.49606, y: 0.90673 },
+    foe: { x: 0.44183, y: 0.91306 },
+    marker: { x: 0.46242, y: 0.9289 }
+  },
+  "The Decaying Wilds": {
+    marker: { x: 0.34526, y: 0.79037 },
+    hero: { x: 0.31399, y: 0.77414 },
+    foe: { x: 0.33339, y: 0.76503 }
+  },
+  "Three Rivers": {
+    building: { x: 0.10461, y: 0.59524 },
+    skull: { x: 0.10976, y: 0.59445 },
+    hero: { x: 0.10066, y: 0.56159 },
+    foe: { x: 0.05672, y: 0.60869 },
+    marker: { x: 0.07216, y: 0.56516 }
+  },
+  "Utar's Barrows": {
+    hero: { x: 0.21227, y: 0.72268 },
+    foe: { x: 0.27322, y: 0.75554 },
+    marker: { x: 0.25502, y: 0.73416 }
+  },
+  Archmont: {
+    marker: { x: 0.28906, y: 0.28849 },
+    hero: { x: 0.2475, y: 0.26474 },
+    foe: { x: 0.22375, y: 0.24297 }
+  },
+  "Azkol's Bane": {
+    hero: { x: 0.31755, y: 0.2026 },
+    foe: { x: 0.35515, y: 0.20339 },
+    marker: { x: 0.2851, y: 0.22002 }
+  },
+  "Bone Hills": {
+    marker: { x: 0.26112, y: 0.1386 },
+    hero: { x: 0.23354, y: 0.15298 },
+    foe: { x: 0.28374, y: 0.10136 }
+  },
+  "Howling Desert": {
+    building: { x: 0.46416, y: 0.25928 },
+    skull: { x: 0.46145, y: 0.25218 },
+    hero: { x: 0.41951, y: 0.22546 },
+    foe: { x: 0.47464, y: 0.2011 },
+    marker: { x: 0.44488, y: 0.20009 }
+  },
+  Irontops: {
+    hero: { x: 0.44934, y: 0.35744 },
+    foe: { x: 0.46636, y: 0.32986 },
+    marker: { x: 0.425, y: 0.33632 }
+  },
+  "Little Sister": {
+    hero: { x: 0.23451, y: 0.34805 },
+    foe: { x: 0.21272, y: 0.32604 },
+    marker: { x: 0.19827, y: 0.36466 }
+  },
+  "Middle Sister": {
+    hero: { x: 0.16203, y: 0.46453 },
+    foe: { x: 0.1493, y: 0.49904 },
+    marker: { x: 0.15513, y: 0.43088 }
+  },
+  "Mountains of the Watchers": {
+    hero: { x: 0.49023, y: 0.12066 },
+    foe: { x: 0.45633, y: 0.09633 },
+    marker: { x: 0.4994, y: 0.18246 }
+  },
+  "Pine Barrens": {
+    hero: { x: 0.06957, y: 0.49147 },
+    foe: { x: 0.07316, y: 0.4185 },
+    marker: { x: 0.06957, y: 0.45478 }
+  },
+  "Sands of Madness": {
+    building: { x: 0.27133, y: 0.44721 },
+    skull: { x: 0.26256, y: 0.44561 },
+    hero: { x: 0.28249, y: 0.39777 },
+    foe: { x: 0.30083, y: 0.33636 },
+    marker: { x: 0.29964, y: 0.37464 }
+  },
+  "Southern Wastes": {
+    marker: { x: 0.16607, y: 0.22512 },
+    building: { x: 0.16248, y: 0.29211 },
+    skull: { x: 0.1553, y: 0.28931 },
+    hero: { x: 0.16686, y: 0.24466 },
+    foe: { x: 0.17723, y: 0.19242 }
+  },
+  "The Cloister": {
+    hero: { x: 0.35027, y: 0.30566 },
+    foe: { x: 0.39692, y: 0.28014 },
+    marker: { x: 0.36862, y: 0.28254 }
+  },
+  "The Emerald Expanse": {
+    building: { x: 0.3746, y: 0.14179 },
+    skull: { x: 0.37699, y: 0.14817 },
+    hero: { x: 0.34071, y: 0.08955 },
+    foe: { x: 0.43121, y: 0.05407 },
+    marker: { x: 0.38177, y: 0.08357 }
+  },
+  "The Throne": {
+    marker: { x: 0.35865, y: 0.43166 },
+    hero: { x: 0.36782, y: 0.38979 },
+    foe: { x: 0.33991, y: 0.46236 }
+  },
+  "Ulamel's Hollow": {
+    foe: { x: 0.10307, y: 0.38022 },
+    hero: { x: 0.11981, y: 0.34872 },
+    marker: { x: 0.0935, y: 0.34952 }
+  },
+  Anza: {
+    building: { x: 0.69519, y: 0.13269 },
+    skull: { x: 0.69876, y: 0.1242 },
+    hero: { x: 0.67642, y: 0.16664 },
+    foe: { x: 0.72244, y: 0.16888 },
+    marker: { x: 0.74656, y: 0.14609 }
+  },
+  Arkartus: {
+    building: { x: 0.81849, y: 0.28504 },
+    skull: { x: 0.82832, y: 0.27789 },
+    hero: { x: 0.81983, y: 0.23544 },
+    foe: { x: 0.87702, y: 0.25376 },
+    marker: { x: 0.84753, y: 0.24036 }
+  },
+  "Ash Hills": {
+    hero: { x: 0.68312, y: 0.44364 },
+    foe: { x: 0.69161, y: 0.46732 },
+    marker: { x: 0.71618, y: 0.45347 }
+  },
+  Cloudhold: {
+    marker: { x: 0.80375, y: 0.41683 },
+    hero: { x: 0.77694, y: 0.42041 },
+    foe: { x: 0.79124, y: 0.44274 }
+  },
+  Delmsmire: {
+    foe: { x: 0.83994, y: 0.34892 },
+    hero: { x: 0.86675, y: 0.32703 },
+    marker: { x: 0.89221, y: 0.31631 }
+  },
+  "Hissing Groves": {
+    marker: { x: 0.67151, y: 0.33865 },
+    building: { x: 0.70502, y: 0.3869 },
+    skull: { x: 0.71127, y: 0.38422 },
+    hero: { x: 0.66436, y: 0.38645 },
+    foe: { x: 0.64783, y: 0.36054 }
+  },
+  "Idran Forest": {
+    hero: { x: 0.54105, y: 0.21221 },
+    foe: { x: 0.54865, y: 0.23455 },
+    marker: { x: 0.58394, y: 0.22294 }
+  },
+  "Lonelight Hills": {
+    marker: { x: 0.58573, y: 0.30291 },
+    hero: { x: 0.58662, y: 0.32524 },
+    foe: { x: 0.54507, y: 0.30112 }
+  },
+  "Lost Lands": {
+    hero: { x: 0.56339, y: 0.08935 },
+    foe: { x: 0.57813, y: 0.10633 },
+    marker: { x: 0.57367, y: 0.0688 }
+  },
+  "Plains of Plovo": {
+    marker: { x: 0.92348, y: 0.42532 },
+    building: { x: 0.88238, y: 0.39717 },
+    skull: { x: 0.89042, y: 0.3936 },
+    hero: { x: 0.89221, y: 0.43158 },
+    foe: { x: 0.91053, y: 0.44632 }
+  },
+  "Plains of Woldra": {
+    hero: { x: 0.62862, y: 0.12107 },
+    foe: { x: 0.57322, y: 0.15815 },
+    marker: { x: 0.60851, y: 0.16798 }
+  },
+  "The Empty Glade": {
+    hero: { x: 0.72646, y: 0.29352 },
+    foe: { x: 0.78052, y: 0.34982 },
+    marker: { x: 0.74746, y: 0.32078 }
+  },
+  "The Grass Sea": {
+    hero: { x: 0.57099, y: 0.37662 },
+    foe: { x: 0.62281, y: 0.43426 },
+    marker: { x: 0.60181, y: 0.40343 }
+  },
+  "Weeping Waters": {
+    hero: { x: 0.64202, y: 0.24795 },
+    foe: { x: 0.65453, y: 0.23053 },
+    marker: { x: 0.67464, y: 0.24393 }
+  },
+  Yellowpike: {
+    marker: { x: 0.76533, y: 0.22338 },
+    hero: { x: 0.79348, y: 0.19792 },
+    foe: { x: 0.81492, y: 0.17379 }
+  }
+};
+
+// src/udtBoardAdjacency.ts
+var BOARD_ADJACENCY = {
+  "Howling Desert": [
+    "Azkol's Bane",
+    "Idran Forest",
+    "Irontops",
+    "Lonelight Hills",
+    "Mountains of the Watchers",
+    "The Cloister",
+    "The Emerald Expanse"
+  ],
+  "Mountains of the Watchers": [
+    "Howling Desert",
+    "Idran Forest",
+    "Lost Lands",
+    "Plains of Woldra",
+    "The Emerald Expanse"
+  ],
+  "The Emerald Expanse": [
+    "Azkol's Bane",
+    "Bone Hills",
+    "Howling Desert",
+    "Lost Lands",
+    "Mountains of the Watchers"
+  ],
+  "Azkol's Bane": [
+    "Archmont",
+    "Bone Hills",
+    "Howling Desert",
+    "The Cloister",
+    "The Emerald Expanse"
+  ],
+  "The Cloister": [
+    "Archmont",
+    "Azkol's Bane",
+    "Howling Desert",
+    "Irontops",
+    "Sands of Madness",
+    "The Throne"
+  ],
+  Irontops: ["Howling Desert", "Lonelight Hills", "The Cloister", "The Grass Sea", "The Throne"],
+  "Idran Forest": [
+    "Anza",
+    "Howling Desert",
+    "Lonelight Hills",
+    "Mountains of the Watchers",
+    "Plains of Woldra",
+    "Weeping Waters"
+  ],
+  "Lonelight Hills": [
+    "Hissing Groves",
+    "Howling Desert",
+    "Idran Forest",
+    "Irontops",
+    "The Grass Sea",
+    "Weeping Waters"
+  ],
+  "The Grass Sea": [
+    "Ash Hills",
+    "Hissing Groves",
+    "Irontops",
+    "Lonelight Hills",
+    "Tower Scar Desert"
+  ],
+  "The Throne": [
+    "Big Sister",
+    "Forest of Shades",
+    "Irontops",
+    "Sands of Madness",
+    "The Cloister"
+  ],
+  "Sands of Madness": [
+    "Archmont",
+    "Big Sister",
+    "Little Sister",
+    "Middle Sister",
+    "The Cloister",
+    "The Throne"
+  ],
+  Archmont: [
+    "Azkol's Bane",
+    "Bone Hills",
+    "Little Sister",
+    "Sands of Madness",
+    "Southern Wastes",
+    "The Cloister"
+  ],
+  "Bone Hills": ["Archmont", "Azkol's Bane", "Southern Wastes", "The Emerald Expanse"],
+  "Little Sister": [
+    "Archmont",
+    "Middle Sister",
+    "Sands of Madness",
+    "Southern Wastes",
+    "Ulamel's Hollow"
+  ],
+  "Forest of Shades": [
+    "Big Sister",
+    "Bleak Wastes",
+    "Dragontooth Lake",
+    "Greater Tombstones",
+    "The Throne"
+  ],
+  "Big Sister": [
+    "Forest of Shades",
+    "Greater Tombstones",
+    "Lesser Tombstones",
+    "Middle Sister",
+    "Sands of Madness",
+    "The Throne"
+  ],
+  "Middle Sister": [
+    "Big Sister",
+    "Lesser Tombstones",
+    "Little Sister",
+    "Pine Barrens",
+    "Sands of Madness",
+    "Three Rivers",
+    "Ulamel's Hollow"
+  ],
+  "Southern Wastes": ["Archmont", "Bone Hills", "Little Sister", "Ulamel's Hollow"],
+  "Ulamel's Hollow": ["Little Sister", "Middle Sister", "Pine Barrens", "Southern Wastes"],
+  "Pine Barrens": ["Middle Sister", "Three Rivers", "Ulamel's Hollow"],
+  "Plains of Woldra": ["Anza", "Idran Forest", "Lost Lands", "Mountains of the Watchers"],
+  "Lost Lands": ["Mountains of the Watchers", "Plains of Woldra", "The Emerald Expanse"],
+  "Weeping Waters": [
+    "Anza",
+    "Hissing Groves",
+    "Idran Forest",
+    "Lonelight Hills",
+    "The Empty Glade",
+    "Yellowpike"
+  ],
+  Anza: ["Idran Forest", "Plains of Woldra", "Weeping Waters", "Yellowpike"],
+  "Hissing Groves": [
+    "Ash Hills",
+    "Cloudhold",
+    "Lonelight Hills",
+    "The Empty Glade",
+    "The Grass Sea",
+    "Weeping Waters"
+  ],
+  "Ash Hills": [
+    "Broken Lands",
+    "Cloudhold",
+    "Hissing Groves",
+    "Muted Forest",
+    "The Grass Sea",
+    "Tower Scar Desert"
+  ],
+  "The Empty Glade": [
+    "Arkartus",
+    "Cloudhold",
+    "Delmsmire",
+    "Hissing Groves",
+    "Weeping Waters",
+    "Yellowpike"
+  ],
+  Yellowpike: ["Anza", "Arkartus", "The Empty Glade", "Weeping Waters"],
+  Arkartus: ["Delmsmire", "The Empty Glade", "Yellowpike"],
+  Delmsmire: ["Arkartus", "Cloudhold", "Plains of Plovo", "The Empty Glade"],
+  Cloudhold: [
+    "Ash Hills",
+    "Broken Lands",
+    "Delmsmire",
+    "Hissing Groves",
+    "Plains of Plovo",
+    "The Empty Glade"
+  ],
+  "Plains of Plovo": ["Broken Lands", "Cloudhold", "Delmsmire", "Lodestone Mountains"],
+  "Lodestone Mountains": [
+    "Broken Lands",
+    "Pearl of the North",
+    "Plains of Plovo",
+    "Radiant Mountains"
+  ],
+  "Broken Lands": [
+    "Ash Hills",
+    "Cloudhold",
+    "Lodestone Mountains",
+    "Muted Forest",
+    "Plains of Plovo",
+    "Radiant Mountains"
+  ],
+  "Muted Forest": [
+    "Ash Hills",
+    "Broken Lands",
+    "Green Bridge",
+    "Radiant Mountains",
+    "Tower Scar Desert",
+    "Upper Ice Fangs"
+  ],
+  "Tower Scar Desert": [
+    "Ash Hills",
+    "Bleak Wastes",
+    "Muted Forest",
+    "The Grass Sea",
+    "Upper Ice Fangs"
+  ],
+  "Radiant Mountains": [
+    "Broken Lands",
+    "Fivepint",
+    "Green Bridge",
+    "Lodestone Mountains",
+    "Muted Forest",
+    "Pearl of the North"
+  ],
+  "Pearl of the North": ["Fivepint", "Lodestone Mountains", "Radiant Mountains"],
+  "Green Bridge": [
+    "Dayside",
+    "Fivepint",
+    "Lower Ice Fangs",
+    "Muted Forest",
+    "Radiant Mountains",
+    "Upper Ice Fangs"
+  ],
+  Fivepint: ["Dayside", "Green Bridge", "Pearl of the North", "Radiant Mountains"],
+  Dayside: ["Fivepint", "Green Bridge", "Lower Ice Fangs", "The Tundra"],
+  "Upper Ice Fangs": [
+    "Bleak Wastes",
+    "Green Bridge",
+    "Lower Ice Fangs",
+    "Muted Forest",
+    "Peaks of the Djinn",
+    "Tower Scar Desert"
+  ],
+  "Bleak Wastes": [
+    "Dragontooth Lake",
+    "Forest of Shades",
+    "Peaks of the Djinn",
+    "Tower Scar Desert",
+    "Upper Ice Fangs"
+  ],
+  "Lower Ice Fangs": [
+    "Dayside",
+    "Green Bridge",
+    "Peaks of the Djinn",
+    "Rimeweald",
+    "The Tundra",
+    "Upper Ice Fangs"
+  ],
+  "Peaks of the Djinn": [
+    "Bleak Wastes",
+    "Dragontooth Lake",
+    "Inner Kinghills",
+    "Lower Ice Fangs",
+    "Rimeweald",
+    "Upper Ice Fangs"
+  ],
+  Rimeweald: [
+    "Egan's End",
+    "Inner Kinghills",
+    "Lower Ice Fangs",
+    "Outer Kinghills",
+    "Peaks of the Djinn",
+    "The Tundra"
+  ],
+  "Egan's End": ["Outer Kinghills", "Rimeweald", "The Tundra"],
+  "The Tundra": ["Dayside", "Egan's End", "Lower Ice Fangs", "Rimeweald"],
+  "Outer Kinghills": ["Copper Grove", "Egan's End", "Inner Kinghills", "Rimeweald"],
+  "Inner Kinghills": [
+    "Copper Grove",
+    "Dragontooth Lake",
+    "Outer Kinghills",
+    "Peaks of the Djinn",
+    "Rimeweald",
+    "The Decaying Wilds"
+  ],
+  "Copper Grove": ["Inner Kinghills", "Jewel Hills", "Outer Kinghills", "The Decaying Wilds"],
+  "The Decaying Wilds": [
+    "Copper Grove",
+    "Dragontooth Lake",
+    "Greater Tombstones",
+    "Inner Kinghills",
+    "Jewel Hills",
+    "Utar's Barrows"
+  ],
+  "Dragontooth Lake": [
+    "Bleak Wastes",
+    "Forest of Shades",
+    "Greater Tombstones",
+    "Inner Kinghills",
+    "Peaks of the Djinn",
+    "The Decaying Wilds"
+  ],
+  "Greater Tombstones": [
+    "Big Sister",
+    "Dragontooth Lake",
+    "Forest of Shades",
+    "Lesser Tombstones",
+    "The Decaying Wilds",
+    "Utar's Barrows"
+  ],
+  "Jewel Hills": ["Copper Grove", "Duwani", "The Decaying Wilds", "Utar's Barrows"],
+  "Utar's Barrows": [
+    "Duwani",
+    "Greater Tombstones",
+    "Jewel Hills",
+    "Lake of Songs",
+    "Lesser Tombstones",
+    "The Decaying Wilds"
+  ],
+  Duwani: ["Jewel Hills", "Lake of Songs", "Utar's Barrows"],
+  "Lesser Tombstones": [
+    "Big Sister",
+    "Greater Tombstones",
+    "Lake of Songs",
+    "Middle Sister",
+    "Three Rivers",
+    "Utar's Barrows"
+  ],
+  "Lake of Songs": ["Duwani", "Lesser Tombstones", "Three Rivers", "Utar's Barrows"],
+  "Three Rivers": ["Lake of Songs", "Lesser Tombstones", "Middle Sister", "Pine Barrens"]
+};
+function neighborsOf(loc) {
+  return BOARD_ADJACENCY[loc] ?? [];
+}
+function stepDistance(a, b) {
+  if (a === b) return 0;
+  const visited = /* @__PURE__ */ new Set([a]);
+  let frontier = [a];
+  let dist = 0;
+  while (frontier.length > 0) {
+    dist++;
+    const next = [];
+    for (const node of frontier) {
+      for (const n of neighborsOf(node)) {
+        if (n === b) return dist;
+        if (!visited.has(n)) {
+          visited.add(n);
+          next.push(n);
+        }
+      }
+    }
+    frontier = next;
+  }
+  return Infinity;
+}
+function shortestPath(a, b) {
+  if (a === b) return [a];
+  const prev = /* @__PURE__ */ new Map();
+  const visited = /* @__PURE__ */ new Set([a]);
+  let frontier = [a];
+  while (frontier.length > 0) {
+    const next = [];
+    for (const node of frontier) {
+      for (const n of neighborsOf(node)) {
+        if (visited.has(n)) continue;
+        visited.add(n);
+        prev.set(n, node);
+        if (n === b) {
+          const path = [b];
+          let cur = b;
+          while (cur !== void 0 && cur !== a) {
+            cur = prev.get(cur);
+            if (cur !== void 0) path.push(cur);
+          }
+          return path.reverse();
+        }
+        next.push(n);
+      }
+    }
+    frontier = next;
+  }
+  return [];
+}
+
 // src/index.ts
 var index_default = UltimateDarkTower_default;
 export {
   ADVERSARIES,
+  ADVERSARY_ROSTER,
   ALLIES,
+  ALL_FOES,
   AUDIO_COMMAND_POS,
   BATTERY_STATUS_FREQUENCY,
+  BOARD_ADJACENCY,
+  BOARD_ANCHORS,
   BOARD_GROUPINGS,
+  BOARD_IMAGE_INFO,
   BOARD_LOCATIONS,
   BOARD_LOCATION_BY_NAME,
   BluetoothAdapterFactory,
@@ -4565,8 +5472,14 @@ export {
   DIS_SYSTEM_ID_UUID,
   DOMOutput,
   DRUM_PACKETS,
+  FOES,
+  FOE_BY_ID,
+  FOE_BY_NAME,
+  FOE_STATUSES,
   GAME_SOURCES,
   GLYPHS,
+  HEROES,
+  HERO_BY_ID,
   InMemorySink,
   IndexedDBSink,
   LAYER_TO_POSITION,
@@ -4575,6 +5488,8 @@ export {
   LIGHT_EFFECTS,
   LIGHT_INDEX_TO_DIRECTION,
   Logger,
+  MONUMENTS,
+  MONUMENT_BY_ID,
   RING_LIGHT_POSITIONS,
   SKULL_DROP_COUNT_POS,
   STATE_DATA_LENGTH,
@@ -4619,9 +5534,12 @@ export {
   logger,
   milliVoltsToPercentage,
   milliVoltsToPercentageNumber,
+  neighborsOf,
   parseDifferentialReadings,
   rtdt_pack_state,
   rtdt_unpack_state,
+  shortestPath,
+  stepDistance,
   validateSeed,
   valueToChar
 };