Merge branch 'main' of https://github.com/theevenstarspace/byteform

Author: SergiiSharpov

README.md

@@ -1,8 +1,8 @@
 # Byteform
 
-![GitHub branch check runs](https://img.shields.io/github/check-runs/theevenstarspace/byteform/main?style=flat)
-![npm package minimized gzipped size (scoped)](https://img.shields.io/bundlejs/size/%40evenstar/byteform?style=flat)
-![NPM Version](https://img.shields.io/npm/v/%40evenstar%2Fbyteform?style=flat)
+![GitHub branch check runs][checks]
+[![Build Size][build-size]][build-size-url]
+[![NPM Package][npm]][npm-url]
 
 **Byteform** is a lightweight and versatile TypeScript library designed for encoding and decoding binary data. It provides an intuitive API to work with binary structures, making it an excellent choice for developers dealing with low-level data operations in both browser and Node.js environments.
 
@@ -70,12 +70,12 @@ const Player = new Struct({
 ### Encode data
 
 ```typescript
-import { BinaryEncoder } from '@evenstar/byteform';
+import { ByteStreamWriter } from '@evenstar/byteform';
 
-const encoder = BinaryEncoder.create(1024); // 1KB buffer
+const encoder = new ByteStreamWriter(1024); // 1KB buffer
 
 // Encode a Player instance
-encoder.encode(Player, {
+encoder.writeSchema(Player, {
   name: 'Alice',
   level: 10,
   position: { x: 1.0, y: 2.0, z: 3.0 },
@@ -97,19 +97,25 @@ encoder.encode(Player, {
  * Get the encoded binary data
  * Send the buffer over the network, save it to a file, etc.
  */
-const buffer = encoder.commit();
+const { buffer } = encoder.commit();
 ```
 
 ### Decode data
 
 ```typescript
-import { BinaryDecoder } from '@evenstar/byteform';
+import { ByteStreamReader } from '@evenstar/byteform';
 
-const decoder = BinaryDecoder.fromArrayBuffer(buffer);
-const player = decoder.decode(Player);
+const decoder = new ByteStreamReader(buffer);
+const player = decoder.readSchema(Player);
 
 console.log(player);
 ```
 
 ## Contributing
 Contributions are welcome! Please open an issue or submit a pull request to get involved.
+
+[npm]: https://img.shields.io/npm/v/@evenstar/byteform?style=flat-square
+[npm-url]: https://www.npmjs.com/package/@evenstar/byteform
+[build-size]: https://flat.badgen.net/bundlephobia/minzip/@evenstar/byteform
+[build-size-url]: https://bundlephobia.com/result?p=@evenstar/byteform
+[checks]: https://img.shields.io/github/check-runs/theevenstarspace/byteform/main?style=flat-square

benchmark/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evenstar/byteform-benchmark",
-  "version": "0.9.2",
+  "version": "1.0.0",
   "description": "Byteform benchmark space",
   "main": "src/index.ts",
   "scripts": {
@@ -18,7 +18,7 @@
     "tsx": "^4.19.2"
   },
   "dependencies": {
-    "@evenstar/byteform": "^0.9.2",
+    "@evenstar/byteform": "link:../",
     "benny": "^3.7.1",
     "bson": "^6.10.0",
     "flatbuffers": "^24.3.25",

benchmark/results/player-decoding.json …rk/results/byteform/player-decoding.jsonbenchmark/results/player-decoding.json renamed to benchmark/results/byteform/player-decoding.json benchmark/results/player-decoding.json renamed to benchmark/results/byteform/player-decoding.json

@@ -1,37 +1,37 @@
 {
   "name": "Player decoding",
-  "date": "2024-11-29T22:51:54.323Z",
-  "version": "0.9.2",
+  "date": "2024-12-15T17:15:05.805Z",
+  "version": "1.0.0",
   "results": [
     {
       "name": "Byteform",
-      "ops": 1911408,
-      "margin": 0.27,
-      "percentSlower": 21.49
+      "ops": 1312033,
+      "margin": 2.51,
+      "percentSlower": 26.69
     },
     {
       "name": "JSON",
-      "ops": 682279,
-      "margin": 0.2,
-      "percentSlower": 71.98
+      "ops": 515914,
+      "margin": 0.56,
+      "percentSlower": 71.17
     },
     {
       "name": "Msgpack-lite",
-      "ops": 182240,
-      "margin": 0.33,
-      "percentSlower": 92.51
+      "ops": 136780,
+      "margin": 0.4,
+      "percentSlower": 92.36
     },
     {
       "name": "Flatbuffers",
-      "ops": 2434659,
-      "margin": 0.22,
+      "ops": 1789599,
+      "margin": 1.1,
       "percentSlower": 0
     },
     {
       "name": "BSON",
-      "ops": 724156,
-      "margin": 0.25,
-      "percentSlower": 70.26
+      "ops": 525847,
+      "margin": 1.23,
+      "percentSlower": 70.62
     }
   ],
   "fastest": {

benchmark/results/byteform/player-encoding.json

@@ -0,0 +1,45 @@
+{
+  "name": "Player encoding",
+  "date": "2024-12-15T17:16:48.999Z",
+  "version": "1.0.0",
+  "results": [
+    {
+      "name": "Byteform",
+      "ops": 814927,
+      "margin": 0.64,
+      "percentSlower": 0
+    },
+    {
+      "name": "JSON",
+      "ops": 705122,
+      "margin": 0.53,
+      "percentSlower": 13.47
+    },
+    {
+      "name": "Msgpack-lite",
+      "ops": 281329,
+      "margin": 0.89,
+      "percentSlower": 65.48
+    },
+    {
+      "name": "Flatbuffers",
+      "ops": 705143,
+      "margin": 0.42,
+      "percentSlower": 13.47
+    },
+    {
+      "name": "BSON",
+      "ops": 151379,
+      "margin": 2.01,
+      "percentSlower": 81.42
+    }
+  ],
+  "fastest": {
+    "name": "Byteform",
+    "index": 0
+  },
+  "slowest": {
+    "name": "BSON",
+    "index": 4
+  }
+}

benchmark/results/js/buffer-slice.json

@@ -0,0 +1,27 @@
+{
+  "name": "Buffer Slice",
+  "date": "2024-12-15T17:15:16.599Z",
+  "version": "1.0.0",
+  "results": [
+    {
+      "name": "ArrayBuffer",
+      "ops": 1986177,
+      "margin": 2.37,
+      "percentSlower": 38.99
+    },
+    {
+      "name": "Uint8Array",
+      "ops": 3255680,
+      "margin": 2.79,
+      "percentSlower": 0
+    }
+  ],
+  "fastest": {
+    "name": "Uint8Array",
+    "index": 1
+  },
+  "slowest": {
+    "name": "ArrayBuffer",
+    "index": 0
+  }
+}

benchmark/results/js/string-decoding.json

@@ -0,0 +1,27 @@
+{
+  "name": "String Decoding",
+  "date": "2024-12-15T17:15:48.943Z",
+  "version": "1.0.0",
+  "results": [
+    {
+      "name": "TextDecoder",
+      "ops": 9980192,
+      "margin": 0.84,
+      "percentSlower": 0
+    },
+    {
+      "name": "Manual utf8",
+      "ops": 4057171,
+      "margin": 1.17,
+      "percentSlower": 59.35
+    }
+  ],
+  "fastest": {
+    "name": "TextDecoder",
+    "index": 0
+  },
+  "slowest": {
+    "name": "Manual utf8",
+    "index": 1
+  }
+}

benchmark/results/js/string-encoding.json

@@ -0,0 +1,39 @@
+{
+  "name": "String Encoding",
+  "date": "2024-12-15T17:15:38.233Z",
+  "version": "1.0.0",
+  "results": [
+    {
+      "name": "TextEncoder Direct",
+      "ops": 15270747,
+      "margin": 1.71,
+      "percentSlower": 0
+    },
+    {
+      "name": "TextEncoder Indirect (Set)",
+      "ops": 2691057,
+      "margin": 1.24,
+      "percentSlower": 82.38
+    },
+    {
+      "name": "TextEncoder Indirect (Manual)",
+      "ops": 2117128,
+      "margin": 1.29,
+      "percentSlower": 86.14
+    },
+    {
+      "name": "Manual utf8",
+      "ops": 11836180,
+      "margin": 0.91,
+      "percentSlower": 22.49
+    }
+  ],
+  "fastest": {
+    "name": "TextEncoder Direct",
+    "index": 0
+  },
+  "slowest": {
+    "name": "TextEncoder Indirect (Manual)",
+    "index": 2
+  }
+}