@kb1rma/libcomm14cux-ts 0.0.0

package/dist/decoders/romRevision.d.ts

@@ -0,0 +1,18 @@
+import { DataOffsetRev } from '../constants.js';
+/**
+ * Tells whether the ROM uses the Rev C data layout. The first row of a fuel
+ * map never reaches 0x30, so a larger value at the old Map 1 location means it
+ * is not map data.
+ *
+ * @param oldMap1FirstRow - The 16 bytes read from 0xC23F.
+ * @returns `true` for the Rev C layout.
+ */
+export declare function isRevC(oldMap1FirstRow: Uint8Array): boolean;
+/**
+ * Distinguishes Rev A from Rev B by the first main voltage factor byte.
+ *
+ * @param voltageFactorA - The byte read from 0xC79B.
+ * @returns Rev A if it is 0xFF, otherwise Rev B.
+ */
+export declare function classifyOldRevision(voltageFactorA: number): typeof DataOffsetRev.RevA | typeof DataOffsetRev.RevB;
+//# sourceMappingURL=romRevision.d.ts.map

package/dist/decoders/romRevision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"romRevision.d.ts","sourceRoot":"","sources":["../../src/decoders/romRevision.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,eAAe,EAAE,UAAU,GAAG,OAAO,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,GACrB,OAAO,aAAa,CAAC,IAAI,GAAG,OAAO,aAAa,CAAC,IAAI,CAEvD"}

package/dist/decoders/romRevision.js

@@ -0,0 +1,26 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Derived from libcomm14cux (https://github.com/colinbourassa/libcomm14cux)
+// Copyright (C) Colin Bourassa. Licensed under the GNU GPL v3.
+// Ported to TypeScript and modified for comm14cux-ts, 2026.
+import { DataOffsetRev } from '../constants.js';
+/**
+ * Tells whether the ROM uses the Rev C data layout. The first row of a fuel
+ * map never reaches 0x30, so a larger value at the old Map 1 location means it
+ * is not map data.
+ *
+ * @param oldMap1FirstRow - The 16 bytes read from 0xC23F.
+ * @returns `true` for the Rev C layout.
+ */
+export function isRevC(oldMap1FirstRow) {
+    return oldMap1FirstRow.some((value) => value > 0x30);
+}
+/**
+ * Distinguishes Rev A from Rev B by the first main voltage factor byte.
+ *
+ * @param voltageFactorA - The byte read from 0xC79B.
+ * @returns Rev A if it is 0xFF, otherwise Rev B.
+ */
+export function classifyOldRevision(voltageFactorA) {
+    return voltageFactorA === 0xff ? DataOffsetRev.RevA : DataOffsetRev.RevB;
+}
+//# sourceMappingURL=romRevision.js.map

package/dist/decoders/romRevision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"romRevision.js","sourceRoot":"","sources":["../../src/decoders/romRevision.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,4EAA4E;AAC5E,+DAA+D;AAC/D,4DAA4D;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,eAA2B;IAChD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,cAAsB;IAEtB,OAAO,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;AAC3E,CAAC","sourcesContent":["// SPDX-License-Identifier: GPL-3.0-only\n// Derived from libcomm14cux (https://github.com/colinbourassa/libcomm14cux)\n// Copyright (C) Colin Bourassa. Licensed under the GNU GPL v3.\n// Ported to TypeScript and modified for comm14cux-ts, 2026.\n\nimport { DataOffsetRev } from '../constants.js';\n\n/**\n * Tells whether the ROM uses the Rev C data layout. The first row of a fuel\n * map never reaches 0x30, so a larger value at the old Map 1 location means it\n * is not map data.\n *\n * @param oldMap1FirstRow - The 16 bytes read from 0xC23F.\n * @returns `true` for the Rev C layout.\n */\nexport function isRevC(oldMap1FirstRow: Uint8Array): boolean {\n  return oldMap1FirstRow.some((value) => value > 0x30);\n}\n\n/**\n * Distinguishes Rev A from Rev B by the first main voltage factor byte.\n *\n * @param voltageFactorA - The byte read from 0xC79B.\n * @returns Rev A if it is 0xFF, otherwise Rev B.\n */\nexport function classifyOldRevision(\n  voltageFactorA: number,\n): typeof DataOffsetRev.RevA | typeof DataOffsetRev.RevB {\n  return voltageFactorA === 0xff ? DataOffsetRev.RevA : DataOffsetRev.RevB;\n}\n"]}

package/dist/decoders/temperature.d.ts

@@ -0,0 +1,12 @@
+/** ADC count to degrees Fahrenheit (`temperature_adc_to_degrees_f`). */
+export declare const TEMPERATURE_ADC_TO_DEGREES_F: readonly number[];
+/**
+ * Converts a coolant or fuel temperature sensor ADC count to degrees
+ * Fahrenheit.
+ *
+ * @param adcCount - The byte read from the sensor location, 0 to 255.
+ * @returns Temperature in degrees Fahrenheit.
+ * @throws {@link InvalidReadingError} if `adcCount` is not 0 to 255.
+ */
+export declare function decodeTemperatureF(adcCount: number): number;
+//# sourceMappingURL=temperature.d.ts.map

package/dist/decoders/temperature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temperature.d.ts","sourceRoot":"","sources":["../../src/decoders/temperature.ts"],"names":[],"mappings":"AAMA,wEAAwE;AACxE,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAgBzD,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ3D"}

package/dist/decoders/temperature.js

@@ -0,0 +1,39 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Derived from libcomm14cux (https://github.com/colinbourassa/libcomm14cux)
+// Copyright (C) Colin Bourassa. Licensed under the GNU GPL v3.
+// Ported to TypeScript and modified for comm14cux-ts, 2026.
+import { InvalidReadingError } from '../errors.js';
+/** ADC count to degrees Fahrenheit (`temperature_adc_to_degrees_f`). */
+export const TEMPERATURE_ADC_TO_DEGREES_F = [
+    266, 264, 260, 258, 255, 253, 249, 248, 244, 242, 239, 237, 233, 231, 228,
+    226, 222, 221, 219, 217, 215, 213, 212, 210, 208, 206, 204, 203, 201, 199,
+    197, 195, 194, 192, 190, 188, 186, 185, 183, 181, 179, 177, 176, 174, 172,
+    170, 168, 167, 165, 163, 161, 159, 158, 158, 156, 154, 152, 150, 149, 147,
+    145, 145, 143, 141, 140, 138, 138, 136, 136, 134, 132, 132, 131, 131, 129,
+    129, 127, 125, 125, 123, 123, 122, 122, 120, 120, 118, 118, 116, 116, 114,
+    114, 113, 113, 111, 111, 109, 109, 107, 107, 105, 105, 104, 104, 102, 102,
+    100, 100, 98, 98, 96, 96, 95, 95, 95, 93, 93, 91, 91, 89, 89, 87, 87, 86, 86,
+    84, 84, 82, 82, 82, 82, 80, 80, 78, 78, 78, 77, 77, 75, 75, 73, 73, 73, 71,
+    71, 71, 69, 69, 68, 68, 66, 66, 64, 64, 62, 62, 60, 60, 59, 59, 57, 57, 57,
+    55, 55, 53, 53, 51, 51, 50, 50, 48, 48, 46, 46, 44, 44, 44, 44, 42, 42, 42,
+    41, 41, 41, 39, 39, 37, 37, 37, 35, 35, 35, 35, 33, 33, 32, 32, 31, 31, 29,
+    29, 27, 27, 25, 25, 23, 23, 22, 22, 22, 20, 20, 18, 18, 18, 16, 16, 14, 14,
+    13, 13, 13, 11, 11, 11, 9, 9, 7, 7, 5, 5, 4, 4, 2, 2, 0, 0, -2, -2, -4, -4,
+    -4, -5, -5, -7, -7, -7, -9, -9, -9, -11, -11, -11, -13, -13, -13,
+];
+/**
+ * Converts a coolant or fuel temperature sensor ADC count to degrees
+ * Fahrenheit.
+ *
+ * @param adcCount - The byte read from the sensor location, 0 to 255.
+ * @returns Temperature in degrees Fahrenheit.
+ * @throws {@link InvalidReadingError} if `adcCount` is not 0 to 255.
+ */
+export function decodeTemperatureF(adcCount) {
+    const degrees = TEMPERATURE_ADC_TO_DEGREES_F[adcCount];
+    if (degrees === undefined) {
+        throw new InvalidReadingError(`Invalid temperature ADC count: ${adcCount}`);
+    }
+    return degrees;
+}
+//# sourceMappingURL=temperature.js.map

package/dist/decoders/temperature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temperature.js","sourceRoot":"","sources":["../../src/decoders/temperature.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,4EAA4E;AAC5E,+DAA+D;AAC/D,4DAA4D;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,wEAAwE;AACxE,MAAM,CAAC,MAAM,4BAA4B,GAAsB;IAC7D,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IACzE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IACzE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IACzE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IACzE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IACzE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IACzE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IACzE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;IAC5E,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;IAC1E,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;IAC1E,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;IAC1E,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;IAC1E,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;IAC1E,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE;CACjE,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,OAAO,GAAG,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAEvD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,mBAAmB,CAAC,kCAAkC,QAAQ,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["// SPDX-License-Identifier: GPL-3.0-only\n// Derived from libcomm14cux (https://github.com/colinbourassa/libcomm14cux)\n// Copyright (C) Colin Bourassa. Licensed under the GNU GPL v3.\n// Ported to TypeScript and modified for comm14cux-ts, 2026.\nimport { InvalidReadingError } from '../errors.js';\n\n/** ADC count to degrees Fahrenheit (`temperature_adc_to_degrees_f`). */\nexport const TEMPERATURE_ADC_TO_DEGREES_F: readonly number[] = [\n  266, 264, 260, 258, 255, 253, 249, 248, 244, 242, 239, 237, 233, 231, 228,\n  226, 222, 221, 219, 217, 215, 213, 212, 210, 208, 206, 204, 203, 201, 199,\n  197, 195, 194, 192, 190, 188, 186, 185, 183, 181, 179, 177, 176, 174, 172,\n  170, 168, 167, 165, 163, 161, 159, 158, 158, 156, 154, 152, 150, 149, 147,\n  145, 145, 143, 141, 140, 138, 138, 136, 136, 134, 132, 132, 131, 131, 129,\n  129, 127, 125, 125, 123, 123, 122, 122, 120, 120, 118, 118, 116, 116, 114,\n  114, 113, 113, 111, 111, 109, 109, 107, 107, 105, 105, 104, 104, 102, 102,\n  100, 100, 98, 98, 96, 96, 95, 95, 95, 93, 93, 91, 91, 89, 89, 87, 87, 86, 86,\n  84, 84, 82, 82, 82, 82, 80, 80, 78, 78, 78, 77, 77, 75, 75, 73, 73, 73, 71,\n  71, 71, 69, 69, 68, 68, 66, 66, 64, 64, 62, 62, 60, 60, 59, 59, 57, 57, 57,\n  55, 55, 53, 53, 51, 51, 50, 50, 48, 48, 46, 46, 44, 44, 44, 44, 42, 42, 42,\n  41, 41, 41, 39, 39, 37, 37, 37, 35, 35, 35, 35, 33, 33, 32, 32, 31, 31, 29,\n  29, 27, 27, 25, 25, 23, 23, 22, 22, 22, 20, 20, 18, 18, 18, 16, 16, 14, 14,\n  13, 13, 13, 11, 11, 11, 9, 9, 7, 7, 5, 5, 4, 4, 2, 2, 0, 0, -2, -2, -4, -4,\n  -4, -5, -5, -7, -7, -7, -9, -9, -9, -11, -11, -11, -13, -13, -13,\n];\n\n/**\n * Converts a coolant or fuel temperature sensor ADC count to degrees\n * Fahrenheit.\n *\n * @param adcCount - The byte read from the sensor location, 0 to 255.\n * @returns Temperature in degrees Fahrenheit.\n * @throws {@link InvalidReadingError} if `adcCount` is not 0 to 255.\n */\nexport function decodeTemperatureF(adcCount: number): number {\n  const degrees = TEMPERATURE_ADC_TO_DEGREES_F[adcCount];\n\n  if (degrees === undefined) {\n    throw new InvalidReadingError(`Invalid temperature ADC count: ${adcCount}`);\n  }\n\n  return degrees;\n}\n"]}

package/dist/decoders/throttle.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Rejects a raw throttle reading above the 10-bit maximum.
+ *
+ * @param raw - The raw reading.
+ * @throws {@link InvalidReadingError} if `raw` is above 1023.
+ */
+export declare function assertThrottleReading(raw: number): void;
+/**
+ * Decodes the throttle position.
+ *
+ * @param raw - The 10-bit reading, 0 to 1023.
+ * @param minimum - 0 for an absolute reading, or the ECU's stored minimum for a
+ * corrected reading.
+ * @returns Position as a fraction from 0 (closed) to 1 (wide open).
+ * @throws {@link InvalidReadingError} if `raw` is above 1023.
+ */
+export declare function decodeThrottlePosition(raw: number, minimum: number): number;
+//# sourceMappingURL=throttle.d.ts.map

package/dist/decoders/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/decoders/throttle.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM3E"}

package/dist/decoders/throttle.js

@@ -0,0 +1,33 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Derived from libcomm14cux (https://github.com/colinbourassa/libcomm14cux)
+// Copyright (C) Colin Bourassa. Licensed under the GNU GPL v3.
+// Ported to TypeScript and modified for comm14cux-ts, 2026.
+import { InvalidReadingError } from '../errors.js';
+const MAX_READING = 1023;
+/**
+ * Rejects a raw throttle reading above the 10-bit maximum.
+ *
+ * @param raw - The raw reading.
+ * @throws {@link InvalidReadingError} if `raw` is above 1023.
+ */
+export function assertThrottleReading(raw) {
+    if (raw > MAX_READING) {
+        throw new InvalidReadingError(`Throttle reading out of range: ${raw}`);
+    }
+}
+/**
+ * Decodes the throttle position.
+ *
+ * @param raw - The 10-bit reading, 0 to 1023.
+ * @param minimum - 0 for an absolute reading, or the ECU's stored minimum for a
+ * corrected reading.
+ * @returns Position as a fraction from 0 (closed) to 1 (wide open).
+ * @throws {@link InvalidReadingError} if `raw` is above 1023.
+ */
+export function decodeThrottlePosition(raw, minimum) {
+    assertThrottleReading(raw);
+    // A glitch can put the reading below the stored minimum; report zero
+    // (this also avoids dividing by zero when the minimum is 1023).
+    return raw > minimum ? (raw - minimum) / (MAX_READING - minimum) : 0;
+}
+//# sourceMappingURL=throttle.js.map

package/dist/decoders/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../src/decoders/throttle.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,4EAA4E;AAC5E,+DAA+D;AAC/D,4DAA4D;AAE5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,GAAG,IAAI,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,IAAI,GAAG,GAAG,WAAW,EAAE,CAAC;QACtB,MAAM,IAAI,mBAAmB,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW,EAAE,OAAe;IACjE,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAE3B,qEAAqE;IACrE,gEAAgE;IAChE,OAAO,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC","sourcesContent":["// SPDX-License-Identifier: GPL-3.0-only\n// Derived from libcomm14cux (https://github.com/colinbourassa/libcomm14cux)\n// Copyright (C) Colin Bourassa. Licensed under the GNU GPL v3.\n// Ported to TypeScript and modified for comm14cux-ts, 2026.\n\nimport { InvalidReadingError } from '../errors.js';\n\nconst MAX_READING = 1023;\n\n/**\n * Rejects a raw throttle reading above the 10-bit maximum.\n *\n * @param raw - The raw reading.\n * @throws {@link InvalidReadingError} if `raw` is above 1023.\n */\nexport function assertThrottleReading(raw: number): void {\n  if (raw > MAX_READING) {\n    throw new InvalidReadingError(`Throttle reading out of range: ${raw}`);\n  }\n}\n\n/**\n * Decodes the throttle position.\n *\n * @param raw - The 10-bit reading, 0 to 1023.\n * @param minimum - 0 for an absolute reading, or the ECU's stored minimum for a\n * corrected reading.\n * @returns Position as a fraction from 0 (closed) to 1 (wide open).\n * @throws {@link InvalidReadingError} if `raw` is above 1023.\n */\nexport function decodeThrottlePosition(raw: number, minimum: number): number {\n  assertThrottleReading(raw);\n\n  // A glitch can put the reading below the stored minimum; report zero\n  // (this also avoids dividing by zero when the minimum is 1023).\n  return raw > minimum ? (raw - minimum) / (MAX_READING - minimum) : 0;\n}\n"]}

package/dist/decoders/tuneRevision.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Tune identification stored in the ROM.
+ */
+export interface TuneRevision {
+    /**
+     * Decimal tune number decoded from two BCD bytes.
+     */
+    tuneNumber: number;
+    /**
+     * Checksum fixer byte.
+     */
+    checksumFixer: number;
+    /**
+     * Ident word, which differentiates builds of the same tune number.
+     */
+    tuneIdent: number;
+}
+/**
+ * Decodes the five tune identification bytes.
+ *
+ * @param bytes - The bytes read from 0xFFE9.
+ * @returns The tune number, checksum fixer and ident word.
+ */
+export declare function decodeTuneRevision(bytes: Uint8Array): TuneRevision;
+//# sourceMappingURL=tuneRevision.d.ts.map

package/dist/decoders/tuneRevision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuneRevision.d.ts","sourceRoot":"","sources":["../../src/decoders/tuneRevision.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAQlE"}

package/dist/decoders/tuneRevision.js

@@ -0,0 +1,22 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Derived from libcomm14cux (https://github.com/colinbourassa/libcomm14cux)
+// Copyright (C) Colin Bourassa. Licensed under the GNU GPL v3.
+// Ported to TypeScript and modified for comm14cux-ts, 2026.
+function bcd(byte) {
+    return (byte >> 4) * 10 + (byte & 0x0f);
+}
+/**
+ * Decodes the five tune identification bytes.
+ *
+ * @param bytes - The bytes read from 0xFFE9.
+ * @returns The tune number, checksum fixer and ident word.
+ */
+export function decodeTuneRevision(bytes) {
+    const [b0 = 0, b1 = 0, fixer = 0, identHigh = 0, identLow = 0] = bytes;
+    return {
+        tuneNumber: bcd(b0) * 100 + bcd(b1),
+        checksumFixer: fixer,
+        tuneIdent: (identHigh << 8) | identLow,
+    };
+}
+//# sourceMappingURL=tuneRevision.js.map

package/dist/decoders/tuneRevision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuneRevision.js","sourceRoot":"","sources":["../../src/decoders/tuneRevision.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,4EAA4E;AAC5E,+DAA+D;AAC/D,4DAA4D;AAoB5D,SAAS,GAAG,CAAC,IAAY;IACvB,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,SAAS,GAAG,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IAEvE,OAAO;QACL,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC;QACnC,aAAa,EAAE,KAAK;QACpB,SAAS,EAAE,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,QAAQ;KACvC,CAAC;AACJ,CAAC","sourcesContent":["// SPDX-License-Identifier: GPL-3.0-only\n// Derived from libcomm14cux (https://github.com/colinbourassa/libcomm14cux)\n// Copyright (C) Colin Bourassa. Licensed under the GNU GPL v3.\n// Ported to TypeScript and modified for comm14cux-ts, 2026.\n\n/**\n * Tune identification stored in the ROM.\n */\nexport interface TuneRevision {\n  /**\n   * Decimal tune number decoded from two BCD bytes.\n   */\n  tuneNumber: number;\n  /**\n   * Checksum fixer byte.\n   */\n  checksumFixer: number;\n  /**\n   * Ident word, which differentiates builds of the same tune number.\n   */\n  tuneIdent: number;\n}\n\nfunction bcd(byte: number): number {\n  return (byte >> 4) * 10 + (byte & 0x0f);\n}\n\n/**\n * Decodes the five tune identification bytes.\n *\n * @param bytes - The bytes read from 0xFFE9.\n * @returns The tune number, checksum fixer and ident word.\n */\nexport function decodeTuneRevision(bytes: Uint8Array): TuneRevision {\n  const [b0 = 0, b1 = 0, fixer = 0, identHigh = 0, identLow = 0] = bytes;\n\n  return {\n    tuneNumber: bcd(b0) * 100 + bcd(b1),\n    checksumFixer: fixer,\n    tuneIdent: (identHigh << 8) | identLow,\n  };\n}\n"]}