@aeroswarm/codec 0.1.11 → 0.1.13

package/dist/index.js

@@ -87,7 +87,11 @@ function parseFormat(s) {
 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")) };
+  const chunks = [];
+  const re = /<Fixed\s+length="\d+"[^>]*>([\s\S]*?)<\/Fixed>/g;
+  let c;
+  while ((c = re.exec(inner)) !== null) chunks.push(parseBits(c[1]));
+  return { type: "variable", chunkBytes: m ? parseInt(m[1]) : 1, bits: chunks[0] ?? parseBits(firstContent(inner, "Fixed")), chunks };
 }
 function parseBits(s) {
   const out = [];
@@ -116,11 +120,15 @@ function parseBits(s) {
   }
   return out;
 }
+function repetitionBytes(body, fallback) {
+  if (/<BDS[\s/>]/.test(body)) return 8;
+  const m = body.match(/<Fixed\s+length="(\d+)"/);
+  return m ? parseInt(m[1]) : fallback;
+}
 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 };
+  return { type: "repetitive", repBytes: repAttr ? parseInt(repAttr[1]) : 1, itemBytes: repetitionBytes(inner, 0) };
 }
 function parseCompound(s) {
   const inner = firstContent(s, "Compound");
@@ -139,7 +147,7 @@ function parseCompound(s) {
       subs.push({ type: "variable", chunkBytes: first ? parseInt(first[1]) : 1 });
     } else if (child.tag === "Repetitive") {
       const repAttr = child.open.match(/rep="(\d+)"/);
-      subs.push({ type: "repetitive", repBytes: repAttr ? parseInt(repAttr[1]) : 1, itemBytes: first ? parseInt(first[1]) : 1 });
+      subs.push({ type: "repetitive", repBytes: repAttr ? parseInt(repAttr[1]) : 1, itemBytes: repetitionBytes(child.body, 1) });
     } else {
       subs.push({ type: "explicit" });
     }
@@ -188,23 +196,23 @@ function parseFspec(buf, start = 0) {
   return { bits, end: i };
 }
 function skipItem(buf, off, def) {
-  if (off >= buf.length) return buf.length;
+  if (off >= buf.length) return buf.length + 1;
   switch (def.type) {
     case "fixed":
-      return Math.min(off + def.bytes, buf.length);
+      return off + def.bytes;
     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);
+      return off;
     }
     case "repetitive": {
-      if (off + def.repBytes > buf.length) return buf.length;
+      if (off + def.repBytes > buf.length) return buf.length + 1;
       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);
+      return off + def.repBytes + rep * def.itemBytes;
     }
     case "compound": {
       const presentIdxs = [];
@@ -222,13 +230,12 @@ function skipItem(buf, off, def) {
         if (idx >= def.subs.length) break;
         off = skipItem(buf, off, def.subs[idx]);
       }
-      return Math.min(off, buf.length);
+      return off;
     }
     case "explicit": {
-      if (off >= buf.length) return off;
+      if (off >= buf.length) return buf.length + 1;
       const len = buf[off];
-      off++;
-      return Math.min(off + len - 1, buf.length);
+      return off + Math.max(len, 1);
     }
   }
 }
@@ -238,17 +245,18 @@ function decodeBlock(block, def, onField) {
   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) return { end: block.length, complete: true };
+    if (off >= block.length) return { end: block.length, complete: true, overrun: true };
     const uapPos = i + Math.floor(i / 7);
     const id = uapMap.get(uapPos);
-    if (id === void 0) return { end: off, complete: false };
+    if (id === void 0) return { end: off, complete: false, overrun: false };
     const itemDef = def.items.get(id);
-    if (!itemDef) return { end: off, complete: false };
+    if (!itemDef) return { end: off, complete: false, overrun: false };
     const start = off;
     off = skipItem(block, off, itemDef);
-    onField(id, block.slice(start, off), itemDef);
+    onField(id, block.slice(start, Math.min(off, block.length)), itemDef);
+    if (off > block.length) return { end: block.length, complete: true, overrun: true };
   }
-  return { end: off, complete: true };
+  return { end: off, complete: true, overrun: false };
 }
 
 // src/surveillance/asterix/fields.ts
@@ -293,6 +301,60 @@ function trdFlags(raw, out) {
   if (num(raw, "TST") === 1) out.testTarget = true;
   if (num(raw, "RAB") === 1) out.fixedTransponder = true;
   if (num(raw, "SIM") === 1) out.simulated = true;
+  const gbs = num(raw, "GBS");
+  if (gbs !== void 0) out.onGround = gbs === 1;
+}
+function compoundSubfields(d, sizeOf) {
+  const present = [];
+  let at = 0;
+  let sub = 0;
+  while (at < d.length) {
+    const b = d[at++];
+    for (let bit = 7; bit >= 1; bit--) {
+      if (b >> bit & 1) present.push(sub);
+      sub++;
+    }
+    if ((b & 1) === 0) break;
+  }
+  const offsets = /* @__PURE__ */ new Map();
+  let off = at;
+  for (const index of present) {
+    const size = sizeOf(index, d, off);
+    if (size === void 0) break;
+    offsets.set(index, off);
+    off += size;
+  }
+  return offsets;
+}
+function derivedDataSize(index, d, off) {
+  if (index < 7) return [3, 6, 2, 2, 2, 2, 2][index];
+  if (index === 7) {
+    let n = 1;
+    while (off + n - 1 < d.length && (d[off + n - 1] & 1) === 1) n++;
+    return n;
+  }
+  if (index === 8) return off < d.length ? 1 + 15 * d[off] : void 0;
+  if (index === 9 || index === 10) return 2;
+  return void 0;
+}
+function flightPlanSize(index) {
+  return [2, 7, 4, 1, 4, 1, 4, 4][index];
+}
+function asciiAt(d, off, len) {
+  if (off === void 0 || d.length < off + len) return void 0;
+  const text = d.subarray(off, off + len).toString("latin1").trim();
+  return text.length > 0 && /^[A-Z0-9 ]+$/.test(text) ? text : void 0;
+}
+function targetSize(raw, out) {
+  const lengthM = num(raw, "Len", "Length");
+  const widthM = num(raw, "WIDTH", "Width");
+  const orientationDeg = num(raw, "ORI", "Ori");
+  if (lengthM === void 0 && widthM === void 0 && orientationDeg === void 0) return;
+  out.targetSize = {
+    ...lengthM !== void 0 && { lengthM },
+    ...widthM !== void 0 && { widthM },
+    ...orientationDeg !== void 0 && { orientationDeg }
+  };
 }
 function decodeKnownField(cat, id, data, out, raw = {}) {
   try {
@@ -329,6 +391,21 @@ function cat021(id, d, out, raw) {
       trdFlags(raw, out);
       break;
     // I021/040 TRD
+    case "020": {
+      const ecat = num(raw, "ECAT");
+      if (ecat !== void 0) out.emitterCategory = ecat;
+      break;
+    }
+    case "155": {
+      const v = num(raw, "BVR");
+      if (v !== void 0) out.verticalRateFpm = v;
+      break;
+    }
+    case "157": {
+      const v = num(raw, "GVR");
+      if (v !== void 0 && out.verticalRateFpm === void 0) out.verticalRateFpm = v;
+      break;
+    }
     case "010": {
       const sac = num(raw, "SAC"), sic = num(raw, "SIC");
       if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
@@ -570,6 +647,10 @@ function cat010(id, d, out, raw) {
       trdFlags(raw, out);
       break;
     // I010/020 TRD
+    case "270":
+      targetSize(raw, out);
+      break;
+    // I010/270 Target Size and Orientation
     case "010": {
       const sac = num(raw, "SAC"), sic = num(raw, "SIC");
       if (sac !== void 0 && sic !== void 0) out.dataSource = { sac, sic };
@@ -637,19 +718,6 @@ function cat010(id, d, out, raw) {
   }
 }
 var MS_TO_KT = 1 / 0.514444;
-function flightPlanCallsign(d) {
-  let indicators = 0;
-  while (indicators < d.length) {
-    indicators++;
-    if ((d[indicators - 1] & 1) === 0) break;
-  }
-  const first = d[0] ?? 0;
-  if ((first & 64) === 0) return void 0;
-  const at = indicators + ((first & 128) !== 0 ? 2 : 0);
-  if (d.length < at + 7) return void 0;
-  const text = d.subarray(at, at + 7).toString("latin1").trim();
-  return text.length > 0 && /^[A-Z0-9 ]+$/.test(text) ? text : void 0;
-}
 function cat062(id, d, out, raw) {
   switch (id) {
     case "080":
@@ -695,6 +763,15 @@ function cat062(id, d, out, raw) {
       else if (d.length >= 2) out.trackNumber = d.readUIntBE(0, 2);
       break;
     }
+    case "220": {
+      const roc = num(raw, "RoC");
+      if (roc !== void 0) out.verticalRateFpm = roc;
+      break;
+    }
+    case "270":
+      targetSize(raw, out);
+      break;
+    // Target Size and Orientation
     case "300": {
       const vfi = num(raw, "VFI");
       out.vehicleFleet = vfi ?? (d.length >= 1 ? d[0] : void 0);
@@ -708,27 +785,30 @@ function cat062(id, d, out, raw) {
       break;
     }
     case "390": {
-      if (out.callsign === void 0) {
-        const csn = flightPlanCallsign(d);
-        if (csn) out.callsign = csn;
-      }
+      const at = compoundSubfields(d, flightPlanSize);
+      const csn = asciiAt(d, at.get(1), 7);
+      if (csn && out.callsign === void 0) out.callsign = csn;
+      const tac = asciiAt(d, at.get(4), 4);
+      if (tac) out.aircraftType = tac;
+      const wtc = asciiAt(d, at.get(5), 1);
+      if (wtc) out.wakeTurbulence = wtc;
+      const dep = asciiAt(d, at.get(6), 4);
+      if (dep) out.departureAirport = dep;
+      const dst = asciiAt(d, at.get(7), 4);
+      if (dst) out.destinationAirport = dst;
       break;
     }
     case "380": {
-      let fsLen = 0;
-      while (fsLen < d.length) {
-        fsLen++;
-        if ((d[fsLen - 1] & 1) === 0) break;
-      }
-      let at = fsLen;
-      if (fsLen < d.length && (d[0] & 128) !== 0 && d.length >= at + 3) {
-        out.icao24 = d.readUIntBE(at, 3).toString(16).padStart(6, "0");
-        at += 3;
-      }
-      if (fsLen < d.length && (d[0] & 64) !== 0 && d.length >= at + 6 && out.callsign === void 0) {
-        const id2 = readCallsign(d.subarray(at, at + 6));
-        if (id2) out.callsign = id2;
+      const at = compoundSubfields(d, derivedDataSize);
+      const adr = at.get(0);
+      if (adr !== void 0 && d.length >= adr + 3) out.icao24 = d.readUIntBE(adr, 3).toString(16).padStart(6, "0");
+      const id2 = at.get(1);
+      if (id2 !== void 0 && d.length >= id2 + 6 && out.callsign === void 0) {
+        const name = readCallsign(d.subarray(id2, id2 + 6));
+        if (name) out.callsign = name;
       }
+      const sab = at.get(10);
+      if (sab !== void 0 && sab < d.length) out.onGround = (d[sab] >> 1 & 1) === 1;
       break;
     }
     case "070": {
@@ -936,12 +1016,12 @@ function parseAsterixBlocks(buf, defaultEdition) {
     for (const edition of toTry) {
       const def = loadDef(cat, edition);
       if (!def) continue;
-      const { all, consumed } = decodeRecords(block, def, cat);
+      const { all, consumed, full } = decodeRecords(block, def, cat);
       const first = all[0];
       if (!first) continue;
       const score = plausibilityScore(first);
-      if (!best || score > best.score) {
-        best = { edition, all, consumed, score };
+      if (!best || full && !best.full || full === best.full && score > best.score) {
+        best = { edition, all, consumed, score, full };
       }
     }
     blocks.push({
@@ -949,36 +1029,53 @@ function parseAsterixBlocks(buf, defaultEdition) {
       edition: best?.edition ?? null,
       length: block.length,
       consumed: best?.consumed ?? 0,
+      clean: best?.full ?? false,
       records: best?.all ?? []
     });
   }
   return blocks;
 }
 function decodeRecords(block, def, cat) {
-  const out = [];
+  const records = [];
   let pos = 0;
-  let consumed = 0;
+  let clean = false;
   while (pos < block.length) {
     const fields = {};
     let result;
     try {
       result = decodeBlock(block.subarray(pos), 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);
+        decodeKnownField(cat, id, data, fields, extractItemBits(itemDef, data));
       });
     } catch {
       break;
     }
     if (!isPlausible(fields)) break;
-    if (out.length > 0 && Object.keys(fields).length === 0) break;
-    out.push(fields);
-    if (!result.complete || result.end <= 0) break;
+    if (result.overrun && records.length > 0) break;
+    records.push({ fields, end: pos + result.end });
+    if (!result.complete || result.end <= 0 || result.overrun) break;
     pos += result.end;
-    consumed = pos;
+    clean = pos >= block.length;
+  }
+  if (clean) {
+    const kept = records.filter((r, i) => i === 0 || Object.keys(r.fields).length > 0).map((r) => r.fields);
+    return { all: kept, consumed: block.length, full: true };
   }
-  return { all: out, consumed };
+  const firstEmpty = records.findIndex((r, i) => i > 0 && Object.keys(r.fields).length === 0);
+  const usable = firstEmpty === -1 ? records : records.slice(0, firstEmpty);
+  return { all: usable.map((r) => r.fields), consumed: usable.length > 0 ? usable[usable.length - 1].end : 0, full: false };
+}
+function extractItemBits(itemDef, data) {
+  if (itemDef.type === "fixed") return itemDef.bits?.length ? extractBitFields(data, itemDef.bits) : {};
+  if (itemDef.type !== "variable") return {};
+  const chunks = itemDef.chunks?.length ? itemDef.chunks : itemDef.bits ? [itemDef.bits] : [];
+  const out = {};
+  for (let i = 0; i < chunks.length; i++) {
+    const start = i * itemDef.chunkBytes;
+    if (start + itemDef.chunkBytes > data.length) break;
+    const part = extractBitFields(data.subarray(start, start + itemDef.chunkBytes), chunks[i]);
+    for (const [name, value] of Object.entries(part)) if (!(name in out)) out[name] = value;
+  }
+  return out;
 }
 function isPlausible(f) {
   if (f.lat !== void 0 && (f.lat < -90 || f.lat > 90)) return false;
@@ -1333,6 +1430,7 @@ export {
   decodeMlatFrame,
   parseAftn,
   parseAsterix,
+  parseAsterixBlocks,
   resolveAsterixAltitudeFt,
   resolveAsterixPosition,
   splitAftnStream

package/dist/surveillance/asterix/decoder.d.ts

@@ -4,16 +4,21 @@ export declare function parseFspec(buf: Buffer, start?: number): {
     bits: boolean[];
     end: number;
 };
-/** Advance offset past one DataItem, returning new offset. */
+/**
+ * Advance offset past one DataItem, returning new offset. The result is NOT clamped to the buffer: an offset past
+ * `buf.length` means the item needs more octets than there are (an overrun), which `decodeBlock` reports.
+ */
 export declare function skipItem(buf: Buffer, off: number, def: ItemDef): number;
 /**
  * Decode ONE record at the start of `block` (a data block can carry many records back to back, each with its own
  * FSPEC). Calls `onField(id, bytes, itemDef)` for each present DataItem. Returns where the record ended, so the caller
  * can go on with the next one, and whether that position can be trusted: `complete` is false when an item the
- * definition does not know stopped the decode (the length of what follows is then unknown).
+ * definition does not know stopped the decode (the length of what follows is then unknown); `overrun` is true when an
+ * item needed more octets than the block has (the record is cut short or an item was sized wrongly).
  */
 export declare function decodeBlock(block: Buffer, def: AsterixDef, onField: (id: string, data: Buffer, itemDef: ItemDef) => void): {
     end: number;
     complete: boolean;
+    overrun: boolean;
 };
 //# sourceMappingURL=decoder.d.ts.map

package/dist/surveillance/asterix/decoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/decoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI3D,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG;IAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAUnF;AAID,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAiDvE;AAID;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,GAC5D;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CA0BpC"}
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/decoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI3D,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG;IAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAUnF;AAID;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAiDvE;AAID;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,GAC5D;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA2BtD"}

package/dist/surveillance/asterix/descriptor-fields.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=descriptor-fields.test.d.ts.map

package/dist/surveillance/asterix/descriptor-fields.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-fields.test.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/descriptor-fields.test.ts"],"names":[],"mappings":""}

package/dist/surveillance/asterix/fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAoE7C,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,GAAE,SAAc,GAAG,IAAI,CAWrH"}
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAwI7C,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,GAAE,SAAc,GAAG,IAAI,CAWrH"}

package/dist/surveillance/asterix/index.d.ts

@@ -1,4 +1,5 @@
-export { parseAsterix } from './parser.js';
+export { parseAsterix, parseAsterixBlocks } from './parser.js';
+export type { AsterixBlockInfo } from './parser.js';
 export { resolveAsterixPosition, resolveAsterixAltitudeFt } from './resolvers.js';
 export type { RadarSite } from './resolvers.js';
 export type { AsterixRecord, AsterixFields } from './types.js';

package/dist/surveillance/asterix/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAClF,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAClF,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/surveillance/asterix/parser.d.ts

@@ -19,8 +19,10 @@ export interface AsterixBlockInfo {
     edition: string | null;
     /** Octets of the block after its 3-octet header. */
     length: number;
-    /** Octets taken up by the decoded records. Less than `length` means an item was sized wrongly or the tail was not understood. */
+    /** Octets taken up by the decoded records. */
     consumed: number;
+    /** The records tile the block exactly: no octets left over, none missing, no item that ran past the end. False points at an item sized wrongly or a tail that was not understood. */
+    clean: boolean;
     records: AsterixFields[];
 }
 /**

package/dist/surveillance/asterix/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAsB/D;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,aAAa,EAAE,CAOjB;AAED,iJAAiJ;AACjJ,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,iIAAiI;IACjI,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,gBAAgB,EAAE,CAwCpB"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAsB/D;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,aAAa,EAAE,CAOjB;AAED,iJAAiJ;AACjJ,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,qLAAqL;IACrL,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,gBAAgB,EAAE,CA2CpB"}

package/dist/surveillance/asterix/repetitive.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=repetitive.test.d.ts.map

package/dist/surveillance/asterix/repetitive.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repetitive.test.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/repetitive.test.ts"],"names":[],"mappings":""}

package/dist/surveillance/asterix/types.d.ts

@@ -41,6 +41,25 @@ export interface AsterixFields {
     vehicleFleet?: number;
     /** Sensor-assigned local track number */
     trackNumber?: number;
+    /** Ground bit: true = the target reports being on the ground, false = not. Undefined = not reported (CAT010/020/021 descriptor, CAT062 I062/380 SAB). */
+    onGround?: boolean;
+    /** ICAO aircraft type designator, e.g. "A320" (CAT062 I062/390 TAC) */
+    aircraftType?: string;
+    /** Wake turbulence category: L, M, H or J (CAT062 I062/390 WTC) */
+    wakeTurbulence?: string;
+    /** Departure and destination aerodrome, ICAO (CAT062 I062/390 DEP, DST) */
+    departureAirport?: string;
+    destinationAirport?: string;
+    /** Rate of climb (+) or descent (-), ft/min (CAT062 I062/220, CAT021 I021/155 baro, else I021/157 geometric) */
+    verticalRateFpm?: number;
+    /** Size and heading of the target on the surface (CAT062 I062/270, CAT010 I010/270) */
+    targetSize?: {
+        lengthM?: number;
+        widthM?: number;
+        orientationDeg?: number;
+    };
+    /** Emitter category of an ADS-B target (CAT021 I021/020 ECAT) */
+    emitterCategory?: number;
     /** TST bit — test target */
     testTarget?: boolean;
     /** RAB bit — report from a fixed field-monitor transponder (MLAT RPU etc.) */

package/dist/surveillance/asterix/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,iBAAiB,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,gBAAgB,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,UAAU,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAE1C,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;IACnG,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,0EAA0E;IAC1E,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAChD,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,iBAAiB,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,gBAAgB,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,UAAU,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAE1C,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;IACnG,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,0EAA0E;IAC1E,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAChD,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yJAAyJ;IACzJ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gHAAgH;IAChH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,UAAU,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;CACvB"}

package/dist/surveillance/asterix/xml-loader.d.ts

@@ -13,10 +13,12 @@ export type FixedDef = {
     bytes: number;
     bits?: BitFieldDef[];
 };
+/** `bits` = the first octet's fields; `chunks` = the fields of every octet in order (the first extension re-numbers from bit 1). */
 export type VariableDef = {
     type: 'variable';
     chunkBytes: number;
     bits?: BitFieldDef[];
+    chunks?: BitFieldDef[][];
 };
 export type RepDef = {
     type: 'repetitive';

package/dist/surveillance/asterix/xml-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xml-loader.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/xml-loader.ts"],"names":[],"mappings":"AAgBA;kEACkE;AAClE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;IACxE,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,QAAQ,GAAQ;IAAE,IAAI,EAAE,OAAO,CAAC;IAAM,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AACxF,MAAM,MAAM,WAAW,GAAK;IAAE,IAAI,EAAE,UAAU,CAAC;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AAC7F,MAAM,MAAM,MAAM,GAAU;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AACxF,MAAM,MAAM,WAAW,GAAK;IAAE,IAAI,EAAE,UAAU,CAAC;IAAG,cAAc,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAC/F,MAAM,MAAM,WAAW,GAAK;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AACjD,MAAM,MAAM,UAAU,GAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAC1E,MAAM,MAAM,OAAO,GAAS,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;AAExF,MAAM,WAAW,QAAQ;IACvB,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7B;AAgCD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAgBlE"}
+{"version":3,"file":"xml-loader.d.ts","sourceRoot":"","sources":["../../../src/surveillance/asterix/xml-loader.ts"],"names":[],"mappings":"AAgBA;kEACkE;AAClE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;IACxE,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,QAAQ,GAAQ;IAAE,IAAI,EAAE,OAAO,CAAC;IAAM,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AACxF,oIAAoI;AACpI,MAAM,MAAM,WAAW,GAAK;IAAE,IAAI,EAAE,UAAU,CAAC;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,EAAE,EAAE,CAAA;CAAE,CAAC;AACvH,MAAM,MAAM,MAAM,GAAU;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AACxF,MAAM,MAAM,WAAW,GAAK;IAAE,IAAI,EAAE,UAAU,CAAC;IAAG,cAAc,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAC/F,MAAM,MAAM,WAAW,GAAK;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AACjD,MAAM,MAAM,UAAU,GAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAC1E,MAAM,MAAM,OAAO,GAAS,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;AAExF,MAAM,WAAW,QAAQ;IACvB,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7B;AAgCD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAgBlE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aeroswarm/codec",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",