feat: ✨ add float methods

README.md

@@ -19,6 +19,7 @@ Encode and decode:
 - UUID
 - Byte
 - Boolean
+- Float
 
 ⚠️ They are all signed and big endian (As Java does)
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft-js/bufwrapper",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Encode and decode data using buffers",
   "main": "dist/index.js",
   "scripts": {

src/index.ts

@@ -328,4 +328,37 @@ export default class BufWrapper {
     this.offset += 1;
     return value;
   }
+
+  /**
+   * Write a float to the buffer
+   * @param value The value to write (number)
+   * @example
+   * ```javascript
+   * const buf = new BufWrapper();
+   * buf.writeFloat(12.34);
+   * console.log(buf.buffer); // <Buffer 41 45 70 a4>
+   * ```
+   */
+  public writeFloat(value: number): void {
+    const buf = Buffer.alloc(4);
+    buf.writeFloatBE(value);
+    this.buffer = Buffer.concat([this.buffer, buf]);
+  }
+
+  /**
+   * Read a float from the buffer
+   * @returns The float read from the buffer
+   * @example
+   * ```javascript
+   * const buffer = Buffer.from([ 0x41, 0x45, 0x70, 0xa4 ]);
+   * const buf = new BufWrapper(buffer);
+   * const decoded = buf.readFloat();
+   * console.log(decoded); // 12.34000015258789
+   * ```
+   */
+  public readFloat(): number {
+    const value = this.buffer.readFloatBE(this.offset);
+    this.offset += 4;
+    return value;
+  }
 }

test/float.test.js

@@ -0,0 +1,26 @@
+const { assert } = require('chai');
+const BufWrapper = require('../dist').default;
+
+describe('Float', () => {
+  it('Write 1', () => {
+    const buf = new BufWrapper();
+    buf.writeFloat(12.34);
+    assert.equal(buf.buffer.toString('hex'), '414570a4');
+  });
+
+  it('Write 2', () => {
+    const buf = new BufWrapper();
+    buf.writeFloat(43.21);
+    assert.equal(buf.buffer.toString('hex'), '422cd70a');
+  });
+
+  it('Read 1', () => {
+    const buf = new BufWrapper(Buffer.from([0x41, 0x45, 0x70, 0xa4]));
+    assert.equal(Math.round(buf.readFloat() * 100) / 100, 12.34);
+  });
+
+  it('Read 2', () => {
+    const buf = new BufWrapper(Buffer.from([0x42, 0x2c, 0xd7, 0x0a]));
+    assert.equal(Math.round(buf.readFloat() * 100) / 100, 43.21);
+  });
+});