binary-structures-values 0.1.0 → 0.1.1

package/dist/cjs/bit-stream-reader.d.ts

@@ -23,6 +23,7 @@ export declare class BitStreamReader {
     readInt16(): number;
     readInt32(): number;
     readBigInt(): bigint;
+    readBigFloat(): number | [bigint, bigint];
     readFloat32(): number;
     readFloat64(): number;
     readString(): string;

package/dist/cjs/bit-stream-reader.js

@@ -227,6 +227,32 @@ class BitStreamReader {
         this.bitPosition = currentBitPos;
         return (result & 1n) === 0n ? result >> 1n : -((result + 1n) >> 1n);
     }
+    readBigFloat() {
+        const mantissa = this.readBigInt();
+        if (mantissa === 0n)
+            return 0;
+        const exponent = this.readBigInt();
+        // Fast path for common cases
+        if (exponent === 0n) {
+            const numValue = Number(mantissa);
+            return BigInt(numValue) === mantissa ? numValue : [mantissa, exponent];
+        }
+        if (exponent > 0n) {
+            const value = mantissa * (10n ** exponent);
+            const numValue = Number(value);
+            return BigInt(numValue) === value ? numValue : [mantissa, exponent];
+        }
+        // Negative exponent
+        const denom = 10n ** (-exponent);
+        const numValue = mantissa % denom === 0n
+            ? Number(mantissa / denom)
+            : Number(mantissa) / Number(denom);
+        // Exact check via reconstruction
+        return (Number.isFinite(numValue) &&
+            BigInt(Math.round(numValue * Number(denom))) === mantissa)
+            ? numValue
+            : [mantissa, exponent];
+    }
     readFloat32() {
         const data = this.byteArray;
         let pos = this.bitPosition;

package/dist/cjs/bit-stream-writer.d.ts

@@ -22,6 +22,7 @@ export declare class BitStreamWriter {
     writeInt16(value: number): void;
     writeInt32(value: number): void;
     writeBigInt(value: bigint): void;
+    writeBigFloat(value: number | string | [bigint, bigint] | [number, bigint] | [number, number]): void;
     dumpBytes(label: string, bytes: Uint8Array): void;
     writeFloat32(value: number): void;
     writeFloat64(value: number): void;

package/dist/cjs/bit-stream-writer.js

@@ -208,6 +208,39 @@ class BitStreamWriter {
         } while (val !== 0n);
         this.bitPosition = currentBitPos;
     }
+    writeBigFloat(value) {
+        // slightly slower
+        let mantissa;
+        let exponent;
+        if (typeof value === 'number') {
+            const str = value.toExponential();
+            const match = str.match(/^(-?)(\d+\.?\d*)e([+-]?\d+)$/);
+            if (!match)
+                throw new Error(`Invalid number format: ${str}`);
+            const [, sign, man, exp] = match;
+            mantissa = BigInt(sign + man.replace('.', ''));
+            exponent = BigInt(parseInt(exp) - (man.includes('.') ? man.split('.')[1].length : 0));
+        }
+        else if (typeof value === 'string') {
+            const match = value.match(/^(-?)(\d+)\.(\d+)$/);
+            if (!match)
+                throw new Error(`Invalid string number format, expected decimal like 123.456: ${value}`);
+            const [, sign, intPart, fracPart] = match;
+            const mantissaStr = sign + intPart + fracPart;
+            exponent = BigInt(-fracPart.length);
+            mantissa = BigInt(mantissaStr);
+        }
+        else if (Array.isArray(value)) {
+            const [man, exp] = value;
+            mantissa = typeof man === 'bigint' ? man : BigInt(man);
+            exponent = typeof exp === 'bigint' ? exp : BigInt(exp);
+        }
+        else {
+            throw new Error(`Unsupported value type for writeBigFloat: ${typeof value}`);
+        }
+        this.writeBigInt(mantissa);
+        this.writeBigInt(exponent);
+    }
     dumpBytes(label, bytes) {
         console.log(label, Array.from(bytes).map(b => b.toString(2).padStart(8, '0')).join(' '));
     }

package/dist/esm/bit-stream-reader.d.ts

@@ -23,6 +23,7 @@ export declare class BitStreamReader {
     readInt16(): number;
     readInt32(): number;
     readBigInt(): bigint;
+    readBigFloat(): number | [bigint, bigint];
     readFloat32(): number;
     readFloat64(): number;
     readString(): string;

package/dist/esm/bit-stream-reader.js

@@ -224,6 +224,32 @@ export class BitStreamReader {
         this.bitPosition = currentBitPos;
         return (result & 1n) === 0n ? result >> 1n : -((result + 1n) >> 1n);
     }
+    readBigFloat() {
+        const mantissa = this.readBigInt();
+        if (mantissa === 0n)
+            return 0;
+        const exponent = this.readBigInt();
+        // Fast path for common cases
+        if (exponent === 0n) {
+            const numValue = Number(mantissa);
+            return BigInt(numValue) === mantissa ? numValue : [mantissa, exponent];
+        }
+        if (exponent > 0n) {
+            const value = mantissa * (10n ** exponent);
+            const numValue = Number(value);
+            return BigInt(numValue) === value ? numValue : [mantissa, exponent];
+        }
+        // Negative exponent
+        const denom = 10n ** (-exponent);
+        const numValue = mantissa % denom === 0n
+            ? Number(mantissa / denom)
+            : Number(mantissa) / Number(denom);
+        // Exact check via reconstruction
+        return (Number.isFinite(numValue) &&
+            BigInt(Math.round(numValue * Number(denom))) === mantissa)
+            ? numValue
+            : [mantissa, exponent];
+    }
     readFloat32() {
         const data = this.byteArray;
         let pos = this.bitPosition;

package/dist/esm/bit-stream-writer.d.ts

@@ -22,6 +22,7 @@ export declare class BitStreamWriter {
     writeInt16(value: number): void;
     writeInt32(value: number): void;
     writeBigInt(value: bigint): void;
+    writeBigFloat(value: number | string | [bigint, bigint] | [number, bigint] | [number, number]): void;
     dumpBytes(label: string, bytes: Uint8Array): void;
     writeFloat32(value: number): void;
     writeFloat64(value: number): void;

package/dist/esm/bit-stream-writer.js

@@ -209,6 +209,39 @@ export class BitStreamWriter {
         } while (val !== 0n);
         this.bitPosition = currentBitPos;
     }
+    writeBigFloat(value) {
+        // slightly slower
+        let mantissa;
+        let exponent;
+        if (typeof value === 'number') {
+            const str = value.toExponential();
+            const match = str.match(/^(-?)(\d+\.?\d*)e([+-]?\d+)$/);
+            if (!match)
+                throw new Error(`Invalid number format: ${str}`);
+            const [, sign, man, exp] = match;
+            mantissa = BigInt(sign + man.replace('.', ''));
+            exponent = BigInt(parseInt(exp) - (man.includes('.') ? man.split('.')[1].length : 0));
+        }
+        else if (typeof value === 'string') {
+            const match = value.match(/^(-?)(\d+)\.(\d+)$/);
+            if (!match)
+                throw new Error(`Invalid string number format, expected decimal like 123.456: ${value}`);
+            const [, sign, intPart, fracPart] = match;
+            const mantissaStr = sign + intPart + fracPart;
+            exponent = BigInt(-fracPart.length);
+            mantissa = BigInt(mantissaStr);
+        }
+        else if (Array.isArray(value)) {
+            const [man, exp] = value;
+            mantissa = typeof man === 'bigint' ? man : BigInt(man);
+            exponent = typeof exp === 'bigint' ? exp : BigInt(exp);
+        }
+        else {
+            throw new Error(`Unsupported value type for writeBigFloat: ${typeof value}`);
+        }
+        this.writeBigInt(mantissa);
+        this.writeBigInt(exponent);
+    }
     dumpBytes(label, bytes) {
         console.log(label, Array.from(bytes).map(b => b.toString(2).padStart(8, '0')).join(' '));
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "binary-structures-values",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "main": "./dist/cjs/index.js",
   "scripts": {
     "build": "tsc && tsc -p tsconfig.cjs.json",