@aeroswarm/codec 0.0.0-stage → 0.1.8

package/dist/index.js

@@ -0,0 +1,924 @@
+// src/surveillance/asterix/xml-loader.ts
+import { readFileSync, existsSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+var _here = dirname(fileURLToPath(import.meta.url));
+var CONFIG_DIR = [
+  join(_here, "..", "src", "config"),
+  // bundled: <pkg>/dist → <pkg>/src/config
+  join(_here, "..", "..", "config")
+  // source:  src/surveillance/asterix → src/config
+].find((p) => existsSync(p)) ?? join(_here, "..", "src", "config");
+var FILE_MAP = {
+  "10:1.1": "asterix_cat010_1_1.xml",
+  "11:1.2": "asterix_cat011_1_2.xml",
+  "19:1.2": "asterix_cat019_1_2.xml",
+  "20:1.7": "asterix_cat020_1_7.xml",
+  "21:0.26": "asterix_cat021_0_26.xml",
+  "21:1.4": "asterix_cat021_1_4.xml",
+  "21:1.8": "asterix_cat021_1_8.xml",
+  "21:2.4": "asterix_cat021_2_4.xml",
+  "23:1.2": "asterix_cat023_1_2.xml",
+  "34:1.26": "asterix_cat034_1_26.xml",
+  "34:1.27": "asterix_cat034_1_27.xml",
+  "48:1.14": "asterix_cat048_1_14.xml",
+  "48:1.21": "asterix_cat048_1_21.xml",
+  "62:0.17": "asterix_cat062_0_17.xml",
+  "62:1.7": "asterix_cat062_1_7.xml",
+  "62:1.9": "asterix_cat062_1_9.xml",
+  "62:1.16": "asterix_cat062_1_16.xml",
+  "62:1.18": "asterix_cat062_1_18.xml",
+  "63:1.3": "asterix_cat063_1_3.xml",
+  "94:0.1": "asterix_cat094_0_1.xml",
+  "247:1.2": "asterix_cat247_1_2.xml"
+};
+var _cache = /* @__PURE__ */ new Map();
+function loadDef(cat, ed) {
+  const key = `${cat}:${ed}`;
+  if (_cache.has(key)) return _cache.get(key) ?? null;
+  const filename = FILE_MAP[key];
+  if (!filename) {
+    _cache.set(key, null);
+    return null;
+  }
+  try {
+    const xml = readFileSync(join(CONFIG_DIR, filename), "utf8");
+    const def = { uap: buildUAP(xml), items: buildItems(xml) };
+    _cache.set(key, def);
+    return def;
+  } catch {
+    _cache.set(key, null);
+    return null;
+  }
+}
+function buildUAP(xml) {
+  const block = firstContent(xml, "UAP");
+  const entries = [];
+  const re = /<UAPItem\s+bit="(\d+)"\s+frn="([^"]+)"[^>]*>([^<]*)<\/UAPItem>/g;
+  let m;
+  while ((m = re.exec(block)) !== null) {
+    if (m[2] === "FX") continue;
+    const id = m[3].trim();
+    if (id === "-") continue;
+    entries.push({ bit: parseInt(m[1]), id });
+  }
+  return entries.sort((a, b) => a.bit - b.bit);
+}
+function buildItems(xml) {
+  const map = /* @__PURE__ */ new Map();
+  const re = /<DataItem\s+id="(\d+)"[^>]*>([\s\S]*?)<\/DataItem>/g;
+  let m;
+  while ((m = re.exec(xml)) !== null) {
+    const body = firstContent(m[2], "DataItemFormat") || m[2];
+    map.set(m[1], parseFormat(body));
+  }
+  if (!map.has("RE")) map.set("RE", { type: "explicit" });
+  if (!map.has("SP")) map.set("SP", { type: "explicit" });
+  return map;
+}
+function parseFormat(s) {
+  if (/<Compound[\s>]/.test(s)) return parseCompound(s);
+  if (/<Repetitive[\s>]/.test(s)) return parseRepetitive(s);
+  if (/<Variable[\s>]/.test(s)) return parseVariable(s);
+  if (/<Explicit[\s>]/.test(s)) return { type: "explicit" };
+  const m = s.match(/<Fixed\s+length="(\d+)"/);
+  return { type: "fixed", bytes: m ? parseInt(m[1]) : 0, bits: parseBits(firstContent(s, "Fixed")) };
+}
+function parseVariable(s) {
+  const inner = firstContent(s, "Variable");
+  const m = inner.match(/<Fixed\s+length="(\d+)"/);
+  return { type: "variable", chunkBytes: m ? parseInt(m[1]) : 1, bits: parseBits(firstContent(inner, "Fixed")) };
+}
+function parseBits(s) {
+  const out = [];
+  const re = /<Bits\s+([^>]*)>([\s\S]*?)<\/Bits>/g;
+  let m;
+  while ((m = re.exec(s)) !== null) {
+    const attrs = m[1];
+    const body = m[2];
+    const name = body.match(/<BitsShortName>([^<]*)<\/BitsShortName>/)?.[1]?.trim();
+    if (!name || name === "spare" || name === "-") continue;
+    let high, low;
+    const single = attrs.match(/\bbit="(\d+)"/);
+    if (single) {
+      high = low = parseInt(single[1]);
+    } else {
+      const from = attrs.match(/\bfrom="(\d+)"/);
+      const to = attrs.match(/\bto="(\d+)"/);
+      if (!from || !to) continue;
+      const a = parseInt(from[1]), b = parseInt(to[1]);
+      high = Math.max(a, b);
+      low = Math.min(a, b);
+    }
+    const encode = attrs.match(/\bencode="(\w+)"/)?.[1] ?? "unsigned";
+    const scale = parseFloat(body.match(/<BitsUnit[^>]*\bscale="([^"]+)"/)?.[1] ?? "1");
+    out.push({ name, high, low, encode, scale: Number.isFinite(scale) ? scale : 1 });
+  }
+  return out;
+}
+function parseRepetitive(s) {
+  const inner = firstContent(s, "Repetitive");
+  const repAttr = inner.match(/<Repetitive\s+rep="(\d+)"/);
+  const m = inner.match(/<Fixed\s+length="(\d+)"/);
+  return { type: "repetitive", repBytes: repAttr ? parseInt(repAttr[1]) : 1, itemBytes: m ? parseInt(m[1]) : 0 };
+}
+function parseCompound(s) {
+  const inner = firstContent(s, "Compound");
+  const varContent = firstContent(inner, "Variable");
+  const varFixed = varContent.match(/<Fixed\s+length="(\d+)"/);
+  const indicatorChunk = varFixed ? parseInt(varFixed[1]) : 1;
+  const varEnd = inner.indexOf("</Variable>");
+  const afterVar = varEnd >= 0 ? inner.slice(varEnd + "</Variable>".length) : "";
+  const subs = [];
+  const subRe = /<(Fixed|Variable|Repetitive|Explicit)\s/g;
+  let sm;
+  while ((sm = subRe.exec(afterVar)) !== null) {
+    const tag = sm[1];
+    const rest = afterVar.slice(sm.index);
+    if (tag === "Fixed") {
+      const lm = rest.match(/<Fixed\s+length="(\d+)"/);
+      if (lm) subs.push({ type: "fixed", bytes: parseInt(lm[1]) });
+    } else if (tag === "Variable") {
+      const lm = rest.match(/<Fixed\s+length="(\d+)"/);
+      subs.push({ type: "variable", chunkBytes: lm ? parseInt(lm[1]) : 1 });
+    } else if (tag === "Repetitive") {
+      const repAttr = rest.match(/<Repetitive\s+rep="(\d+)"/);
+      const lm = rest.match(/<Fixed\s+length="(\d+)"/);
+      subs.push({ type: "repetitive", repBytes: repAttr ? parseInt(repAttr[1]) : 1, itemBytes: lm ? parseInt(lm[1]) : 1 });
+    } else {
+      subs.push({ type: "explicit" });
+    }
+  }
+  return { type: "compound", indicatorChunk, subs };
+}
+function firstContent(s, tag) {
+  return s.match(new RegExp(`<${tag}[^>]*>([\\s\\S]*?)<\\/${tag}>`))?.[1] ?? "";
+}
+
+// src/surveillance/asterix/decoder.ts
+function parseFspec(buf, start = 0) {
+  const bits = [];
+  let i = start;
+  while (i < buf.length) {
+    const b = buf[i];
+    for (let bit = 7; bit >= 1; bit--) bits.push((b >> bit & 1) === 1);
+    i++;
+    if ((b & 1) === 0) break;
+  }
+  return { bits, end: i };
+}
+function skipItem(buf, off, def) {
+  if (off >= buf.length) return buf.length;
+  switch (def.type) {
+    case "fixed":
+      return Math.min(off + def.bytes, buf.length);
+    case "variable": {
+      while (off + def.chunkBytes <= buf.length) {
+        const last = buf[off + def.chunkBytes - 1];
+        off += def.chunkBytes;
+        if ((last & 1) === 0) break;
+      }
+      return Math.min(off, buf.length);
+    }
+    case "repetitive": {
+      if (off + def.repBytes > buf.length) return buf.length;
+      let rep = 0;
+      for (let i = 0; i < def.repBytes; i++) rep = rep << 8 | buf[off + i];
+      return Math.min(off + def.repBytes + rep * def.itemBytes, buf.length);
+    }
+    case "compound": {
+      const presentIdxs = [];
+      let subBit = 0;
+      while (off < buf.length) {
+        const b = buf[off];
+        off++;
+        for (let bit = 7; bit >= 1; bit--) {
+          if (b >> bit & 1) presentIdxs.push(subBit);
+          subBit++;
+        }
+        if ((b & 1) === 0) break;
+      }
+      for (const idx of presentIdxs) {
+        if (idx >= def.subs.length) break;
+        off = skipItem(buf, off, def.subs[idx]);
+      }
+      return Math.min(off, buf.length);
+    }
+    case "explicit": {
+      if (off >= buf.length) return off;
+      const len = buf[off];
+      off++;
+      return Math.min(off + len - 1, buf.length);
+    }
+  }
+}
+function decodeBlock(block, def, onField) {
+  const { bits, end } = parseFspec(block);
+  let off = end;
+  const uapMap = new Map(def.uap.map((e) => [e.bit, e.id]));
+  for (let i = 0; i < bits.length; i++) {
+    if (!bits[i]) continue;
+    if (off >= block.length) break;
+    const uapPos = i + Math.floor(i / 7);
+    const id = uapMap.get(uapPos);
+    if (id === void 0) break;
+    const itemDef = def.items.get(id);
+    if (!itemDef) break;
+    const start = off;
+    off = skipItem(block, off, itemDef);
+    onField(id, block.slice(start, off), itemDef);
+  }
+}
+
+// src/surveillance/asterix/fields.ts
+function readSigned(buf, offset, bytes) {
+  const raw = buf.readUIntBE(offset, bytes);
+  const threshold = 2 ** (bytes * 8 - 1);
+  return raw >= threshold ? raw - threshold * 2 : raw;
+}
+var ICAO6 = ` ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_ !"#$%&'()*+,-./0123456789:;<=>?`;
+function readCallsign(data) {
+  const b = Array.from({ length: 6 }, (_, i) => data[i] ?? 0);
+  const chars = [
+    b[0] >> 2 & 63,
+    (b[0] & 3) << 4 | b[1] >> 4,
+    (b[1] & 15) << 2 | b[2] >> 6,
+    b[2] & 63,
+    b[3] >> 2 & 63,
+    (b[3] & 3) << 4 | b[4] >> 4,
+    (b[4] & 15) << 2 | b[5] >> 6,
+    b[5] & 63
+  ];
+  return chars.map((c) => ICAO6[c] ?? " ").join("").trim();
+}
+function num(raw, ...names) {
+  for (const n of names) {
+    const v = raw[n];
+    if (typeof v === "number") return v;
+  }
+  return void 0;
+}
+function str(raw, ...names) {
+  for (const n of names) {
+    const v = raw[n];
+    if (typeof v === "string") return v;
+  }
+  return void 0;
+}
+function validLatLon(lat, lon) {
+  return lat >= -90 && lat <= 90 && lon >= -180 && lon <= 180;
+}
+function decodeKnownField(cat, id, data, out, raw = {}) {
+  try {
+    if (cat === 21) cat021(id, data, out, raw);
+    else if (cat === 48) cat048(id, data, out, raw);
+    else if (cat === 23) cat023(id, data, out, raw);
+    else if (cat === 20) cat020(id, data, out, raw);
+    else if (cat === 10 || cat === 11) cat010(id, data, out, raw);
+    else if (cat === 62) cat062(id, data, out, raw);
+    else if (cat === 34 || cat === 63) catServiceMsg(id, data, out, raw);
+    else if (cat === 19 || cat === 247) catSystemStatus(id, data, out, raw);
+  } catch {
+  }
+}
+function catSystemStatus(id, d, out, raw) {
+  switch (id) {
+    case "010": {
+      const sac = num(raw, "SAC"), sic = num(raw, "SIC");
+      if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
+      else if (d.length >= 2) out.dataSource = { sac: d[0], sic: d[1] };
+      break;
+    }
+    case "140": {
+      const t = num(raw, "ToD", "time_of_day");
+      if (t !== void 0) out.timeOfDay = t;
+      else if (d.length >= 3) out.timeOfDay = d.readUIntBE(0, 3) / 128;
+      break;
+    }
+  }
+}
+function cat021(id, d, out, raw) {
+  switch (id) {
+    case "010": {
+      const sac = num(raw, "SAC"), sic = num(raw, "SIC");
+      if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
+      else if (d.length >= 2) out.dataSource = { sac: d[0], sic: d[1] };
+      break;
+    }
+    case "130": {
+      const lat = num(raw, "Lat"), lon = num(raw, "Lon");
+      if (lat !== void 0 && lon !== void 0) {
+        if (validLatLon(lat, lon)) {
+          out.lat = lat;
+          out.lon = lon;
+        }
+      } else if (d.length === 6) {
+        const flat = readSigned(d, 0, 3) * (180 / 8388608);
+        const flon = readSigned(d, 3, 3) * (180 / 8388608);
+        if (validLatLon(flat, flon)) {
+          out.lat = flat;
+          out.lon = flon;
+        }
+      }
+      break;
+    }
+    case "080": {
+      const addr = str(raw, "TAddr");
+      if (addr) out.icao24 = addr.toLowerCase();
+      else if (d.length >= 3) out.icao24 = d.readUIntBE(0, 3).toString(16).padStart(6, "0");
+      break;
+    }
+    case "170": {
+      const cs = str(raw, "TId");
+      if (cs !== void 0) {
+        if (cs) out.callsign = cs;
+      } else if (d.length >= 6) out.callsign = readCallsign(d);
+      break;
+    }
+    case "140": {
+      const ft = num(raw, "GAlt", "geometric_height");
+      if (ft !== void 0) {
+        if (ft >= -2e3 && ft <= 1e5) out.altitudeFt = ft;
+      } else if (d.length >= 2) {
+        const f = readSigned(d, 0, 2) * 6.25;
+        if (f >= -2e3 && f <= 1e5) out.altitudeFt = f;
+      }
+      break;
+    }
+    case "145": {
+      if (out.altitudeFt != null) break;
+      const fl = num(raw, "FL");
+      if (fl !== void 0) out.altitudeFt = fl * 100;
+      else if (d.length >= 2) out.altitudeFt = readSigned(d, 0, 2) * 25;
+      break;
+    }
+    case "152": {
+      const hdg = num(raw, "MHdg");
+      if (hdg !== void 0) out.velocity = { ...out.velocity ?? {}, headingDeg: hdg };
+      else if (d.length >= 2) out.velocity = { ...out.velocity ?? {}, headingDeg: d.readUIntBE(0, 2) / 65536 * 360 };
+      break;
+    }
+    case "160": {
+      const gs = num(raw, "GS");
+      const ta = num(raw, "TA");
+      if (gs !== void 0 || ta !== void 0) {
+        const re = num(raw, "RE");
+        if (gs !== void 0 && re !== 1) {
+          out.velocity = { ...out.velocity ?? {}, groundSpeedKt: Math.round(gs * 3600) };
+        }
+        if (ta !== void 0 && out.velocity?.headingDeg == null) {
+          out.velocity = { ...out.velocity ?? {}, headingDeg: ta };
+        }
+      } else if (d.length >= 4) {
+        const spdRaw = d.readUIntBE(0, 2);
+        const hdgRaw = d.readUIntBE(2, 2);
+        if (!(spdRaw >> 14 & 1)) {
+          out.velocity = { ...out.velocity ?? {}, groundSpeedKt: Math.round((spdRaw & 16383) * (3600 / 16384)) };
+        }
+        if (out.velocity?.headingDeg == null) {
+          out.velocity = { ...out.velocity ?? {}, headingDeg: hdgRaw / 65536 * 360 };
+        }
+      }
+      break;
+    }
+    case "070": {
+      const sq = str(raw, "Mode3A");
+      if (sq) out.squawk = sq.padStart(4, "0").slice(-4);
+      else if (d.length >= 2) out.squawk = (d.readUIntBE(0, 2) & 4095).toString(8).padStart(4, "0");
+      break;
+    }
+    case "030": {
+      const t = num(raw, "ToD");
+      if (t !== void 0) out.timeOfDay = t;
+      else if (d.length >= 3) out.timeOfDay = d.readUIntBE(0, 3) / 128;
+      break;
+    }
+  }
+}
+function cat048(id, d, out, raw) {
+  switch (id) {
+    case "010": {
+      const sac = num(raw, "SAC"), sic = num(raw, "SIC");
+      if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
+      else if (d.length >= 2) out.dataSource = { sac: d[0], sic: d[1] };
+      break;
+    }
+    case "220": {
+      const addr = str(raw, "ACAddr", "TAddr");
+      if (addr) out.icao24 = addr.toLowerCase();
+      else if (d.length >= 3) out.icao24 = d.readUIntBE(0, 3).toString(16).padStart(6, "0");
+      break;
+    }
+    case "240": {
+      const cs = str(raw, "TId");
+      if (cs !== void 0) {
+        if (cs) out.callsign = cs;
+      } else if (d.length >= 6) out.callsign = readCallsign(d);
+      break;
+    }
+    case "042": {
+      const x = num(raw, "X"), y = num(raw, "Y");
+      if (x !== void 0 && y !== void 0) out.positionCartesian = { xNm: x, yNm: y };
+      else if (d.length >= 4) out.positionCartesian = { xNm: readSigned(d, 0, 2) / 128, yNm: readSigned(d, 2, 2) / 128 };
+      break;
+    }
+    case "040": {
+      const rho = num(raw, "RHO"), theta = num(raw, "THETA");
+      if (rho !== void 0 && theta !== void 0) out.measuredPosition = { rangeNm: rho, azimuthDeg: theta };
+      else if (d.length >= 4) {
+        out.measuredPosition = { rangeNm: d.readUIntBE(0, 2) / 256, azimuthDeg: d.readUIntBE(2, 2) / 65536 * 360 };
+      }
+      break;
+    }
+    case "200": {
+      const gs = num(raw, "CGS"), hdg = num(raw, "CHdg");
+      if (gs !== void 0 && hdg !== void 0) {
+        out.velocity = { groundSpeedKt: Math.round(gs * 3600), headingDeg: hdg };
+      } else if (d.length >= 4) {
+        out.velocity = {
+          groundSpeedKt: Math.round(d.readUIntBE(0, 2) * (3600 / 16384)),
+          headingDeg: d.readUIntBE(2, 2) / 65536 * 360
+        };
+      }
+      break;
+    }
+    case "070": {
+      const sq = str(raw, "Mode3A");
+      if (sq) out.squawk = sq.padStart(4, "0").slice(-4);
+      else if (d.length >= 2) out.squawk = (d.readUIntBE(0, 2) & 4095).toString(8).padStart(4, "0");
+      break;
+    }
+    case "090": {
+      if (out.altitudeFt != null) break;
+      const fl = num(raw, "FL");
+      if (fl !== void 0) out.altitudeFt = fl * 100;
+      else if (d.length >= 2) {
+        const rawFl = d.readUIntBE(0, 2) & 4095;
+        out.altitudeFt = (rawFl >= 2048 ? rawFl - 4096 : rawFl) * 25;
+      }
+      break;
+    }
+    case "140": {
+      const t = num(raw, "ToD");
+      if (t !== void 0) out.timeOfDay = t;
+      else if (d.length >= 3) out.timeOfDay = d.readUIntBE(0, 3) / 128;
+      break;
+    }
+  }
+}
+function cat023(id, d, out, raw) {
+  switch (id) {
+    case "000": {
+      const rt = num(raw, "report_type", "ReportType");
+      if (rt !== void 0) out.reportType = rt;
+      else if (d.length >= 1) out.reportType = d[0];
+      break;
+    }
+    case "010": {
+      const sac = num(raw, "SAC"), sic = num(raw, "SIC");
+      if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
+      else if (d.length >= 2) out.dataSource = { sac: d[0], sic: d[1] };
+      break;
+    }
+    case "070": {
+      const t = num(raw, "ToD");
+      if (t !== void 0) out.timeOfDay = t;
+      else if (d.length >= 3) out.timeOfDay = d.readUIntBE(0, 3) / 128;
+      break;
+    }
+    case "100": {
+      const nogo = num(raw, "NOGO");
+      if (nogo !== void 0) {
+        out.gsStatus = {
+          nogo: nogo === 1,
+          odp: num(raw, "ODP") === 1,
+          oxt: num(raw, "OXT") === 1,
+          msc: num(raw, "MSC") === 1,
+          tsv: num(raw, "TSV") === 1,
+          spo: num(raw, "SPO") === 1
+        };
+      } else if (d.length >= 1) {
+        const b = d[0];
+        out.gsStatus = {
+          nogo: !!(b & 128),
+          odp: !!(b & 64),
+          oxt: !!(b & 32),
+          msc: !!(b & 16),
+          tsv: !!(b & 8),
+          spo: !!(b & 4)
+        };
+      }
+      break;
+    }
+    case "200": {
+      const r = num(raw, "range", "Range", "RANGE");
+      if (r !== void 0) out.operationalRangeNm = r;
+      else if (d.length >= 1) out.operationalRangeNm = d[0];
+      break;
+    }
+  }
+}
+function cat010(id, d, out, raw) {
+  switch (id) {
+    case "010": {
+      const sac = num(raw, "SAC"), sic = num(raw, "SIC");
+      if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
+      else if (d.length >= 2) out.dataSource = { sac: d[0], sic: d[1] };
+      break;
+    }
+    case "041": {
+      const lat = num(raw, "Lat"), lon = num(raw, "Lon");
+      if (lat !== void 0 && lon !== void 0 && validLatLon(lat, lon)) {
+        out.lat = lat;
+        out.lon = lon;
+      }
+      break;
+    }
+    case "042": {
+      const x = num(raw, "X"), y = num(raw, "Y");
+      if (x !== void 0 && y !== void 0) {
+        out.positionCartesian = { xNm: x / 1852, yNm: y / 1852 };
+      }
+      break;
+    }
+    case "200": {
+      const gs = num(raw, "GS"), ta = num(raw, "TA");
+      if (gs !== void 0) out.velocity = { ...out.velocity ?? {}, groundSpeedKt: Math.round(gs * 3600) };
+      if (ta !== void 0) out.velocity = { ...out.velocity ?? {}, headingDeg: ta };
+      break;
+    }
+    case "220": {
+      const addr = str(raw, "TAddr");
+      if (addr) out.icao24 = addr.toLowerCase();
+      else if (d.length >= 3) out.icao24 = d.readUIntBE(0, 3).toString(16).padStart(6, "0");
+      break;
+    }
+    case "245": {
+      const cs = str(raw, "TId");
+      if (cs !== void 0) {
+        if (cs) out.callsign = cs;
+      } else if (d.length >= 7) out.callsign = readCallsign(d.subarray(1));
+      break;
+    }
+    case "060": {
+      const sq = str(raw, "Mode3A");
+      if (sq) out.squawk = sq.padStart(4, "0").slice(-4);
+      else if (d.length >= 2) out.squawk = (d.readUIntBE(0, 2) & 4095).toString(8).padStart(4, "0");
+      break;
+    }
+    case "161": {
+      const tn = num(raw, "TrkNb", "TRACK_NUMBER", "TrackNumber");
+      if (tn !== void 0) out.trackNumber = tn;
+      else if (d.length >= 2) out.trackNumber = d.readUIntBE(0, 2) & 4095;
+      break;
+    }
+    case "300": {
+      const vfi = num(raw, "VFI");
+      out.vehicleFleet = vfi ?? (d.length >= 1 ? d[0] : void 0);
+      out.targetType = "vehicle";
+      break;
+    }
+    case "140": {
+      const t = num(raw, "ToD");
+      if (t !== void 0) out.timeOfDay = t;
+      else if (d.length >= 3) out.timeOfDay = d.readUIntBE(0, 3) / 128;
+      break;
+    }
+  }
+}
+var MS_TO_KT = 1 / 0.514444;
+function cat062(id, d, out, raw) {
+  switch (id) {
+    case "010": {
+      const sac = num(raw, "SAC"), sic = num(raw, "SIC");
+      if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
+      else if (d.length >= 2) out.dataSource = { sac: d[0], sic: d[1] };
+      break;
+    }
+    case "105": {
+      const lat = num(raw, "Lat"), lon = num(raw, "Lon");
+      if (lat !== void 0 && lon !== void 0 && validLatLon(lat, lon)) {
+        out.lat = lat;
+        out.lon = lon;
+      }
+      break;
+    }
+    case "185": {
+      const vx = num(raw, "Vx"), vy = num(raw, "Vy");
+      if (vx !== void 0 && vy !== void 0) {
+        const speedKt = Math.round(Math.sqrt(vx * vx + vy * vy) * MS_TO_KT);
+        const headingDeg = (Math.atan2(vx, vy) * 180 / Math.PI + 360) % 360;
+        out.velocity = { groundSpeedKt: speedKt, headingDeg };
+      }
+      break;
+    }
+    case "136": {
+      const ft = num(raw, "MFL");
+      if (ft !== void 0 && ft >= -2e3 && ft <= 15e4 && out.altitudeFt == null) out.altitudeFt = ft;
+      break;
+    }
+    case "060": {
+      const sq = str(raw, "Mode3A");
+      if (sq) out.squawk = sq.padStart(4, "0").slice(-4);
+      break;
+    }
+    case "040": {
+      const tn = num(raw, "TrkN", "TrkNb");
+      if (tn !== void 0) out.trackNumber = tn;
+      else if (d.length >= 2) out.trackNumber = d.readUIntBE(0, 2);
+      break;
+    }
+    case "070": {
+      const t = num(raw, "ToD", "TOTI");
+      if (t !== void 0) out.timeOfDay = t;
+      else if (d.length >= 3) out.timeOfDay = d.readUIntBE(0, 3) / 128;
+      break;
+    }
+  }
+}
+function catServiceMsg(id, d, out, raw) {
+  if (id === "010") {
+    const sac = num(raw, "SAC"), sic = num(raw, "SIC");
+    if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
+    else if (d.length >= 2) out.dataSource = { sac: d[0], sic: d[1] };
+  } else if (id === "000" && d.length >= 1) {
+    out.reportType = d[0];
+  }
+}
+function cat020(id, d, out, raw) {
+  switch (id) {
+    case "010": {
+      const sac = num(raw, "SAC"), sic = num(raw, "SIC");
+      if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
+      else if (d.length >= 2) out.dataSource = { sac: d[0], sic: d[1] };
+      break;
+    }
+    case "220": {
+      const addr = str(raw, "TAddr", "ACAddr");
+      if (addr) out.icao24 = addr.toLowerCase();
+      else if (d.length >= 3) out.icao24 = d.readUIntBE(0, 3).toString(16).padStart(6, "0");
+      break;
+    }
+    case "041": {
+      const lat = num(raw, "Lat"), lon = num(raw, "Lon");
+      if (lat !== void 0 && lon !== void 0) {
+        if (validLatLon(lat, lon)) {
+          out.lat = lat;
+          out.lon = lon;
+        }
+      } else if (d.length >= 8) {
+        const flat = readSigned(d, 0, 4) * (180 / 33554432);
+        const flon = readSigned(d, 4, 4) * (180 / 33554432);
+        if (validLatLon(flat, flon)) {
+          out.lat = flat;
+          out.lon = flon;
+        }
+      }
+      break;
+    }
+    case "042": {
+      const x = num(raw, "X"), y = num(raw, "Y");
+      if (x !== void 0 && y !== void 0) {
+        out.positionCartesian = { xNm: x / 1852, yNm: y / 1852 };
+      } else if (d.length >= 6) {
+        out.positionCartesian = {
+          xNm: readSigned(d, 0, 3) * 0.5 / 1852,
+          yNm: readSigned(d, 3, 3) * 0.5 / 1852
+        };
+      }
+      break;
+    }
+    case "161": {
+      const tn = num(raw, "TrkNb", "TRACK_NUMBER", "TrackNumber");
+      if (tn !== void 0) out.trackNumber = tn;
+      else if (d.length >= 2) out.trackNumber = d.readUIntBE(0, 2) & 4095;
+      break;
+    }
+    case "202": {
+      let vx = num(raw, "Vx", "X"), vy = num(raw, "Vy", "Y");
+      if (vx === void 0 || vy === void 0) {
+        if (d.length >= 4) {
+          vx = readSigned(d, 0, 2) * 0.25;
+          vy = readSigned(d, 2, 2) * 0.25;
+        }
+      }
+      if (vx !== void 0 && vy !== void 0) {
+        out.velocity = {
+          groundSpeedKt: Math.round(Math.hypot(vx, vy) * 1.94384),
+          headingDeg: (Math.atan2(vx, vy) * 180 / Math.PI + 360) % 360
+        };
+      }
+      break;
+    }
+    case "090": {
+      const fl = num(raw, "FL");
+      if (fl !== void 0) out.altitudeFt = fl * 100;
+      else if (d.length >= 2) out.altitudeFt = readSigned(d, 0, 2) / 4 * 100;
+      break;
+    }
+    case "070": {
+      const sq = str(raw, "Mode3A");
+      if (sq) out.squawk = sq.padStart(4, "0").slice(-4);
+      else if (d.length >= 2) out.squawk = (d.readUIntBE(0, 2) & 4095).toString(8).padStart(4, "0");
+      break;
+    }
+    case "245": {
+      const cs = str(raw, "TId");
+      if (cs !== void 0) {
+        if (cs) out.callsign = cs;
+      } else if (d.length >= 7) out.callsign = readCallsign(d.subarray(1));
+      break;
+    }
+    case "300": {
+      const vfi = num(raw, "VFI");
+      out.vehicleFleet = vfi ?? (d.length >= 1 ? d[0] : void 0);
+      out.targetType = "vehicle";
+      break;
+    }
+    case "140": {
+      const t = num(raw, "ToD");
+      if (t !== void 0) out.timeOfDay = t;
+      else if (d.length >= 3) out.timeOfDay = d.readUIntBE(0, 3) / 128;
+      break;
+    }
+  }
+}
+
+// src/surveillance/asterix/values.ts
+var ICAO62 = ` ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_ !"#$%&'()*+,-./0123456789:;<=>?`;
+function extractBitFields(data, defs) {
+  const out = {};
+  if (data.length === 0 || defs.length === 0) return out;
+  let acc = 0n;
+  for (const b of data) acc = acc << 8n | BigInt(b);
+  const totalBits = data.length * 8;
+  for (const def of defs) {
+    if (def.high > totalBits || def.low < 1) continue;
+    const width = def.high - def.low + 1;
+    let raw = acc >> BigInt(def.low - 1) & (1n << BigInt(width)) - 1n;
+    switch (def.encode) {
+      case "signed": {
+        const sign = 1n << BigInt(width - 1);
+        if (raw & sign) raw -= sign << 1n;
+        out[def.name] = Number(raw) * def.scale;
+        break;
+      }
+      case "octal":
+        out[def.name] = Number(raw).toString(8).padStart(Math.ceil(width / 3), "0");
+        break;
+      case "hex":
+        out[def.name] = Number(raw).toString(16).padStart(Math.ceil(width / 4), "0");
+        break;
+      case "6bitschar": {
+        let s = "";
+        for (let shift = width - 6; shift >= 0; shift -= 6) {
+          s += ICAO62[Number(raw >> BigInt(shift) & 0x3fn)] ?? " ";
+        }
+        out[def.name] = s.trim();
+        break;
+      }
+      case "ascii": {
+        let s = "";
+        for (let shift = width - 8; shift >= 0; shift -= 8) {
+          s += String.fromCharCode(Number(raw >> BigInt(shift) & 0xffn));
+        }
+        out[def.name] = s.trim();
+        break;
+      }
+      default:
+        out[def.name] = Number(raw) * def.scale;
+    }
+  }
+  return out;
+}
+
+// src/surveillance/asterix/parser.ts
+var EDITIONS = {
+  10: ["1.1"],
+  11: ["1.2"],
+  19: ["1.2"],
+  20: ["1.7"],
+  21: ["2.4", "1.8", "1.4", "0.26"],
+  23: ["1.2"],
+  34: ["1.27", "1.26"],
+  48: ["1.21", "1.14"],
+  62: ["1.18", "1.16", "1.9", "1.7", "0.17"],
+  63: ["1.3"],
+  94: ["0.1"],
+  247: ["1.2"]
+};
+function parseAsterix(buf, defaultEdition) {
+  const records = [];
+  let offset = 0;
+  while (offset + 3 <= buf.length) {
+    const cat = buf[offset];
+    const len = buf[offset + 1] << 8 | buf[offset + 2];
+    if (len < 3 || offset + len > buf.length) break;
+    const block = buf.slice(offset + 3, offset + len);
+    offset += len;
+    const toTry = defaultEdition?.[cat] ? [defaultEdition[cat]] : EDITIONS[cat] ?? [];
+    let best = null;
+    for (const edition of toTry) {
+      const def = loadDef(cat, edition);
+      if (!def) continue;
+      const fields = {};
+      try {
+        decodeBlock(block, def, (id, data, itemDef) => {
+          const bits = itemDef.type === "fixed" || itemDef.type === "variable" ? itemDef.bits : void 0;
+          const bitData = itemDef.type === "variable" ? data.subarray(0, itemDef.chunkBytes) : data;
+          const raw = bits?.length ? extractBitFields(bitData, bits) : {};
+          decodeKnownField(cat, id, data, fields, raw);
+        });
+      } catch {
+        continue;
+      }
+      if (!isPlausible(fields)) continue;
+      const score = plausibilityScore(fields);
+      if (!best || score > best.score) {
+        best = { edition, fields, score };
+      }
+    }
+    if (best) records.push({ category: cat, edition: best.edition, fields: best.fields });
+  }
+  return records;
+}
+function isPlausible(f) {
+  if (f.lat !== void 0 && (f.lat < -90 || f.lat > 90)) return false;
+  if (f.lon !== void 0 && (f.lon < -180 || f.lon > 180)) return false;
+  return true;
+}
+function plausibilityScore(f) {
+  let score = Object.keys(f).length;
+  const gs = f.velocity?.groundSpeedKt;
+  if (gs !== void 0) score += gs >= 0 && gs <= 1200 ? 2 : -4;
+  const hdg = f.velocity?.headingDeg;
+  if (hdg !== void 0) score += hdg >= 0 && hdg < 360 ? 1 : -4;
+  if (f.altitudeFt !== void 0) {
+    score += f.altitudeFt >= -2e3 && f.altitudeFt <= 6e4 ? 2 : -4;
+  }
+  if (f.callsign !== void 0) {
+    const cs = f.callsign.trim();
+    score += /^[A-Z0-9 ]+$/.test(cs) && cs.length >= 2 ? 2 : -4;
+  }
+  if (f.timeOfDay !== void 0) {
+    score += f.timeOfDay >= 0 && f.timeOfDay < 86400 ? 1 : -4;
+  }
+  return score;
+}
+
+// src/surveillance/asterix/resolvers.ts
+function resolveAsterixPosition(fields, radarSite) {
+  if (typeof fields.lat === "number" && typeof fields.lon === "number") {
+    return { lat: fields.lat, lon: fields.lon };
+  }
+  if (!radarSite) return null;
+  const cart = fields.positionCartesian;
+  const polar = fields.measuredPosition;
+  let xNm;
+  let yNm;
+  if (typeof cart?.xNm === "number" && typeof cart?.yNm === "number") {
+    xNm = cart.xNm;
+    yNm = cart.yNm;
+  } else if (typeof polar?.rangeNm === "number" && typeof polar?.azimuthDeg === "number") {
+    const az = polar.azimuthDeg * Math.PI / 180;
+    xNm = polar.rangeNm * Math.sin(az);
+    yNm = polar.rangeNm * Math.cos(az);
+  }
+  if (xNm == null || yNm == null) return null;
+  return {
+    lat: radarSite.lat + yNm / 60,
+    lon: radarSite.lon + xNm / (60 * Math.cos(radarSite.lat * Math.PI / 180))
+  };
+}
+function resolveAsterixAltitudeFt(fields) {
+  return typeof fields.altitudeFt === "number" ? fields.altitudeFt : void 0;
+}
+
+// src/surveillance/adsb/index.ts
+function decodeAdsbFrame(_frame) {
+  return null;
+}
+
+// src/surveillance/ais/index.ts
+function decodeAis(_sentence) {
+  return null;
+}
+
+// src/surveillance/mlat/index.ts
+function decodeMlatFrame(_frame) {
+  return null;
+}
+
+// src/surveillance/asmgcs/index.ts
+function decodeAsmgcsFrame(_frame) {
+  return null;
+}
+export {
+  decodeAdsbFrame,
+  decodeAis,
+  decodeAsmgcsFrame,
+  decodeMlatFrame,
+  parseAsterix,
+  resolveAsterixAltitudeFt,
+  resolveAsterixPosition
+};