@zebbedaja/er-save-parser 0.1.3 → 0.1.4

package/dist/index.d.mts

@@ -143,6 +143,12 @@ interface EventFlag {
   location?: string;
   state?: boolean;
 }
+interface BitDifference {
+  offset: number;
+  bitIndex: number;
+  oldBit: 0 | 1;
+  newBit: 0 | 1;
+}
 //#endregion
 //#region src/parser.d.ts
 /**
@@ -218,5 +224,26 @@ declare const getEventFlagState: (bstMap: Map<number, number>, eventFlags: Uint8
  * @returns The event ID corresponding to the given position
  */
 declare const getEventIdFromPosition: (bstMap: Map<number, number>, bytePos: number, bitIndex: number) => number;
+/**
+ * Compares two Uint8Arrays and returns all bit-level differences.
+ *
+ * Arrays of different lengths are supported — missing bytes in the shorter
+ * array are treated as `0`.
+ *
+ * @param a - The original Uint8Array.
+ * @param b - The Uint8Array to compare against.
+ * @returns An array of {@link BitDifference} objects, one per differing bit.
+ *
+ * @example
+ * const a = new Uint8Array([0b00001111, 0b11110000]);
+ * const b = new Uint8Array([0b00001111, 0b10110001]);
+ *
+ * const diffs = compareUint8Arrays(a, b);
+ * // [
+ * //   { offset: 1, bitIndex: 0, oldBit: 0, newBit: 1 },
+ * //   { offset: 1, bitIndex: 6, oldBit: 1, newBit: 0 },
+ * // ]
+ */
+declare const compareUint8Arrays: (a: Uint8Array, b: Uint8Array) => BitDifference[];
 //#endregion
-export { type Character, type EventFlag, type LogLevel, type ParseOptions, type ProfileSummary, type Save, type Settings, type Slot, arrayBuffersEqual, getBstMap, getEventFlagState, getEventIdFromPosition, parse, parseToMap, stringToBytes, toHexString, trim };
+export { type BitDifference, type Character, type EventFlag, type LogLevel, type ParseOptions, type ProfileSummary, type Save, type Settings, type Slot, arrayBuffersEqual, compareUint8Arrays, getBstMap, getEventFlagState, getEventIdFromPosition, parse, parseToMap, stringToBytes, toHexString, trim };

package/dist/index.mjs

@@ -12030,6 +12030,44 @@ const getEventIdFromPosition = (bstMap, bytePos, bitIndex) => {
 	}
 	throw new Error(`Byte position ${bytePos} not found in any known block`);
 };
+/**
+* Compares two Uint8Arrays and returns all bit-level differences.
+*
+* Arrays of different lengths are supported — missing bytes in the shorter
+* array are treated as `0`.
+*
+* @param a - The original Uint8Array.
+* @param b - The Uint8Array to compare against.
+* @returns An array of {@link BitDifference} objects, one per differing bit.
+*
+* @example
+* const a = new Uint8Array([0b00001111, 0b11110000]);
+* const b = new Uint8Array([0b00001111, 0b10110001]);
+*
+* const diffs = compareUint8Arrays(a, b);
+* // [
+* //   { offset: 1, bitIndex: 0, oldBit: 0, newBit: 1 },
+* //   { offset: 1, bitIndex: 6, oldBit: 1, newBit: 0 },
+* // ]
+*/
+const compareUint8Arrays = (a, b) => {
+	const differences = [];
+	const length = Math.max(a.length, b.length);
+	for (let offset = 0; offset < length; offset++) {
+		const byteA = offset < a.length ? a[offset] : 0;
+		const byteB = offset < b.length ? b[offset] : 0;
+		if (byteA !== byteB) {
+			const xor = byteA ^ byteB;
+			for (let bitIndex = 0; bitIndex < 8; bitIndex++) if (xor & 1 << bitIndex) differences.push({
+				offset,
+				bitIndex,
+				oldBit: byteA >> bitIndex & 1,
+				newBit: byteB >> bitIndex & 1
+			});
+		}
+	}
+	return differences;
+};
 //#endregion
 //#region src/event-flags.ts
 const eventFlags = [
@@ -18819,4 +18857,4 @@ function parse(buffer, options = {
 	return save;
 }
 //#endregion
-export { arrayBuffersEqual, getBstMap, getEventFlagState, getEventIdFromPosition, parse, parseToMap, stringToBytes, toHexString, trim };
+export { arrayBuffersEqual, compareUint8Arrays, getBstMap, getEventFlagState, getEventIdFromPosition, parse, parseToMap, stringToBytes, toHexString, trim };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zebbedaja/er-save-parser",
   "type": "module",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "A parser for Elden Ring save files written in TypesScript.",
   "author": "zebbedaja",
   "license": "MIT",