json-as 1.0.0 → 1.0.1

package/.github/workflows/{nodejs.yml → tests.yml}

@@ -20,4 +20,4 @@ jobs:
         run: bun install
 
       - name: Run Tests
-        run: bun run test
+        run: bash ./run-tests.sh

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Change Log
 
+## 2025-03-10 - 1.0.1
+
+- docs: add comprehensive performance metrics
+
 ## 2025-03-09 - 1.0.0
 
 - fix: relative paths pointing through node_modules would create a second Source

package/README.md

@@ -6,7 +6,7 @@
 ██   ██      ██ ██    ██ ██  ██ ██       ██   ██      ██
  █████  ███████  ██████  ██   ████       ██   ██ ███████
  </span>
-    AssemblyScript - v1.0.0
+    AssemblyScript - v1.0.1
   </pre>
 </h5>
 
@@ -14,19 +14,17 @@
 
 JSON is the de-facto serialization format of modern web applications, but its serialization and deserialization remain a significant performance bottleneck, especially at scale. Traditional parsing approaches are computationally expensive, adding unnecessary overhead to both clients and servers. This library is designed to mitigate this by leveraging SIMD acceleration and highly optimized transformations.
 
-## 🚨 What's new in v1.0.0
-
-🔹Breaking changes to the way custom serializers/deserializers function (See Custom Serializers below)
+## 🔭 What's new
 
 🔹Major performance improvements and addition of SIMD
 
-🔹Extremely low memory overhead compared to pre-1.x.x versions (great for serverless workloads)
+🔹Near zero-growth allocation design and low overhead
 
-🔹Fixes to many major issues and newly discovered bugs
+🔹Support for custom serializer and deserializers
 
-🔹Full support for dynamic objects, arrays, and values
+🔹Fixes to many, many, bugs and edge cases
 
-🔹Full support for `JSON.Raw` type everywhere
+🔹Support for dynamic objects, arrays, arbitrary values, and raw types
 
 ## 📚 Contents
 
@@ -374,11 +372,13 @@ This allows custom serialization while maintaining a generic interface for the l
 
 ## ⚡ Performance
 
-The `json-as` library has been optimized to achieve near-gigabyte-per-second JSON processing speeds through SIMD acceleration and highly efficient transformations. Below are some key performance benchmarks to give you an idea of how it performs.
+The `json-as` library has been optimized to achieve near-gigabyte-per-second JSON processing speeds through SIMD acceleration and highly efficient transformations. Below are detailed statistics comparing performance metrics such as build time, operations-per-second, and throughput.
+
+### 🔍 Comparison to JavaScript
 
-Note: the AssemblyScript benches are run using a _bump allocator_ so that Garbage Collection does not interfere with results. Also note that ideally, I would use [d8](https://v8.dev/docs/d8), but until that is done, these results serve as a temporary performance comparison.
+These benchmarks compare this library to JavaScript's native `JSON.stringify` and `JSON.parse` functions.
 
-**Table 1** - _AssemblyScript_
+**Table 1** - _AssemblyScript (LLVM)_
 
 | Test Case       | Size       | Serialization (ops/s) | Deserialization (ops/s) | Serialization (MB/s) | Deserialization (MB/s) |
 | --------------- | ---------- | --------------------- | ----------------------- | -------------------- | ---------------------- |
@@ -388,7 +388,7 @@ Note: the AssemblyScript benches are run using a _bump allocator_ so that Garbag
 | Medium Object   | 494 bytes  | 4,060,913 ops/s       | 1,396,160 ops/s         | 2,006 MB/s           | 689.7 MB/s             |
 | Large Object    | 3374 bytes | 614,754 ops/s         | 132,802 ops/s           | 2,074 MB/s           | 448.0 MB/s             |
 
-**Table 2** - _JavaScript_
+**Table 2** - _JavaScript (V8)_
 
 | Test Case       | Size       | Serialization (ops/s) | Deserialization (ops/s) | Serialization (MB/s) | Deserialization (MB/s) |
 | --------------- | ---------- | --------------------- | ----------------------- | -------------------- | ---------------------- |
@@ -398,6 +398,54 @@ Note: the AssemblyScript benches are run using a _bump allocator_ so that Garbag
 | Medium Object   | 494 bytes  | 2,395,210 ops/s       | 1,381,693 ops/s         | 1,183 MB/s           | 682.5 MB/s             |
 | Large Object    | 3374 bytes | 222,222 ops/s         | 117,233 ops/s           | 749.7 MB/s           | 395.5 MB/s             |
 
+**📌 Insights**
+
+- JSON-AS consistently outperforms JavaScript's native implementation.
+
+- **Serialization Speed:**
+  - JSON-AS achieves speeds up to `2,133 MB/s`, significantly faster than JavaScript's peak of `1,416 MB/s`.
+  - Large objects see the biggest improvement, with JSON-AS at `2,074 MB/s` vs. JavaScript’s `749.7 MB/s`.
+
+- **Deserialization Speed:**
+  - JSON-AS reaches `1,986 MB/s`, while JavaScript caps at `1,592 MB/s`.
+  - Small and medium objects see the most significant performance boost overall.
+
+### 📈 Comparison to v0.9.x version
+
+**Table 1** - _v1.0.0_
+
+| Test Case       | Size       | Serialization (ops/s) | Deserialization (ops/s) | Serialization (MB/s) | Deserialization (MB/s) |
+| --------------- | ---------- | --------------------- | ----------------------- | -------------------- | ---------------------- |
+| Vector3 Object  | 38 bytes   | 35,714,285 ops/s      | 35,435,552 ops/s        | 1,357 MB/s           | 1,348 MB/s             |
+| Alphabet String | 104 bytes  | 13,617,021 ops/s      | 18,390,804 ops/s        | 1,416 MB/s           | 1,986 MB/s             |
+| Small Object    | 88 bytes   | 24,242,424 ops/s      | 12,307,692 ops/s        | 2,133 MB/s           | 1,083 MB/s             |
+| Medium Object   | 494 bytes  | 4,060,913 ops/s       | 1,396,160 ops/s         | 2,006 MB/s           | 689.7 MB/s             |
+| Large Object    | 3374 bytes | 614,754 ops/s         | 132,802 ops/s           | 2,074 MB/s           | 448.0 MB/s             |
+
+**Table 2** - _v0.9.29_
+
+| Test Case       | Size       | Serialization (ops/s) | Deserialization (ops/s) | Serialization (MB/s) | Deserialization (MB/s) |
+| --------------- | ---------- | --------------------- | ----------------------- | -------------------- | ---------------------- |
+| Vector3 Object  | 38 bytes   | 6,896,551 ops/s       | 10,958,904 ops/s        | 262.1 MB/s           | 416.4 MB/s             |
+| Alphabet String | 104 bytes  | 5,128,205 ops/s       | 8,695,652 ops/s         | 533.3 MB/s           | 939.1 MB/s             |
+| Small Object    | 88 bytes   | 4,953,560 ops/s       | 3,678,160 ops/s         | 435.9 MB/s           | 323.7 MB/s             |
+| Medium Object   | 494 bytes  | 522,193 ops/s         | 508,582 ops/s           | 258.0 MB/s           | 251.2 MB/s             |
+| Large Object    | 3374 bytes | 51,229 ops/s          | 65,585 ops/s            | 172.8 MB/s           | 221.3 MB/s             |
+
+**📌 Insights:**
+
+- Massive performance improvements in JSON-AS `v1.0.0`:
+- Serialization is **2-12x faster** (e.g., Large Object: `2,074 MB/s` vs. `172.8 MB/s`).
+- Deserialization is **2-3x faster** (e.g., Large Object: `1,348 MB/s` vs. `221.3 MB/s`).
+- Vector3 Object serialization improved from `416 MB/s` to `1,357 MB/s`--a **3x benefit** through new code generation techniques.
+
+## 🔭 What's Next
+
+- Theorize plans to keep key-order in generated schemas
+- Generate optimized deserialization methods
+- Inline specific hot code paths
+- Implement error handling implementation
+
 ## 📃 License
 
 This project is distributed under an open source license. You can view the full license using the following link: [License](./LICENSE)

package/assembly/__benches__/abc.bench.ts

@@ -0,0 +1,21 @@
+import { JSON } from "..";
+import { bench } from "../custom/bench";
+
+const v1 = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+const v2 = '"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"';
+
+bench(
+  "Serialize Alphabet",
+  () => {
+    JSON.stringify(v1);
+  },
+  1_000_00,
+);
+
+bench(
+  "Deserialize Alphabet",
+  () => {
+    JSON.parse<string>(v2);
+  },
+  1_000_00,
+);

package/assembly/__benches__/large.bench.ts

@@ -0,0 +1,174 @@
+import { JSON } from "..";
+import { bench } from "../custom/bench";
+
+
+@json
+class Vec3 {
+  public x!: i32;
+  public y!: i32;
+  public z!: i32;
+
+  @inline __SERIALIZE(ptr: usize): void {
+    bs.proposeSize(98);
+    store<u64>(bs.offset, 9570664606466171, 0); // {"x"
+    store<u16>(bs.offset, 58, 8); // :
+    bs.offset += 10;
+    JSON.__serialize<i32>(load<i32>(ptr, offsetof<this>("x")));
+    store<u64>(bs.offset, 9570668901433388, 0); // ,"y"
+    store<u16>(bs.offset, 58, 8); // :
+    bs.offset += 10;
+    JSON.__serialize<i32>(load<i32>(ptr, offsetof<this>("y")));
+    store<u64>(bs.offset, 9570673196400684, 0); // ,"z"
+    store<u16>(bs.offset, 58, 8); // :
+    bs.offset += 10;
+    JSON.__serialize<i32>(load<i32>(ptr, offsetof<this>("z")));
+    store<u16>(bs.offset, 125, 0); // }
+    bs.offset += 2;
+  }
+
+  @inline __INITIALIZE(): this {
+    return this;
+  }
+
+  @inline __DESERIALIZE(keyStart: usize, keyEnd: usize, valStart: usize, valEnd: usize, ptr: usize): void {
+    switch (load<u16>(keyStart)) {
+      case 120: {
+        // x
+        store<i32>(ptr, JSON.__deserialize<i32>(valStart, valEnd, 0), offsetof<this>("x"));
+        return;
+      }
+      case 121: {
+        // y
+        store<i32>(ptr, JSON.__deserialize<i32>(valStart, valEnd, 0), offsetof<this>("y"));
+        return;
+      }
+      case 122: {
+        // z
+        store<i32>(ptr, JSON.__deserialize<i32>(valStart, valEnd, 0), offsetof<this>("z"));
+        return;
+      }
+    }
+    return;
+  }
+}
+
+
+@json
+class LargeJSON {
+  public id!: i32;
+  public name!: string;
+  public age!: i32;
+  public email!: string;
+  public street!: string;
+  public city!: string;
+  public state!: string;
+  public zip!: string;
+  public tags!: string[];
+  public theme!: string;
+  public notifications!: boolean;
+  public language!: string;
+  public movement!: Vec3[];
+}
+
+const v1: LargeJSON = {
+  id: 2,
+  name: "Medium Object",
+  age: 18,
+  email: "me@jairus.dev",
+  street: "I don't want to say my street",
+  city: "I don't want to say this either",
+  state: "It really depends",
+  zip: "I forget what it is",
+  tags: ["me", "dogs", "mountains", "bar", "foo"],
+  theme: "Hyper Term Black",
+  notifications: true,
+  language: "en-US",
+  movement: [
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+  ],
+};
+
+const v2 = `{"id":2,"name":"Medium Object","age":18,"email":"me@jairus.dev","street":"I don't want to say my street","city":"I don't want to say this either","state":"It really depends","zip":"I forget what it is","tags":["me","dogs","mountains","bar","foo"],"theme":"Hyper Term Black","notifications":true,"language":"en-US","movement":[{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3}]}`;
+
+bench(
+  "Serialize Medium Object",
+  () => {
+    JSON.stringify(v1);
+  },
+  3_000_00,
+);
+
+bench(
+  "Deserialize Medium Object",
+  () => {
+    JSON.parse<LargeJSON>(v2);
+  },
+  3_000_00,
+);

package/assembly/__benches__/lib/index.ts

@@ -0,0 +1,26 @@
+export function describe(description: string, routine: () => void): void {
+  routine();
+}
+
+export function it(description: string, routine: () => void): void {
+  routine();
+}
+
+export function expect(left: string): Expectation {
+  return new Expectation(left);
+}
+
+class Expectation {
+  public left: string;
+
+  constructor(left: string) {
+    this.left = left;
+  }
+  toBe(right: string): void {
+    if (this.left != right) {
+      console.log("  (expected) -> " + right);
+      console.log("  (received) -> " + this.left);
+      process.exit(1);
+    }
+  }
+}

package/assembly/__benches__/medium.bench.ts

@@ -0,0 +1,46 @@
+import { JSON } from "..";
+import { bench } from "../custom/bench";
+
+
+@json
+class MediumJSON {
+  public id!: i32;
+  public name!: string;
+  public age!: i32;
+  public email!: string;
+  public street!: string;
+  public city!: string;
+  public state!: string;
+  public zip!: string;
+  public tags!: string[];
+}
+
+const v1: MediumJSON = {
+  id: 2,
+  name: "Medium Object",
+  age: 18,
+  email: "me@jairus.dev",
+  street: "I don't want to say my street",
+  city: "I don't want to say this either",
+  state: "It really depends",
+  zip: "I forget what it is",
+  tags: ["me", "dogs", "mountains", "bar", "foo"],
+};
+
+const v2 = `{"id":2,"name":"Medium Object","age":18,"email":"me@jairus.dev","street":"I don't want to say my street","city":"I don't want to say this either","state":"It really depends","zip":"I forget what it is","tags":["me","dogs","mountains","bar","foo"]}`;
+
+bench(
+  "Serialize Medium Object",
+  () => {
+    JSON.stringify(v1);
+  },
+  8_000_00,
+);
+
+bench(
+  "Deserialize Medium Object",
+  () => {
+    JSON.parse<MediumJSON>(v2);
+  },
+  8_000_00,
+);

package/assembly/__benches__/small.bench.ts

@@ -0,0 +1,33 @@
+import { JSON } from "..";
+import { bench } from "../custom/bench";
+
+
+@json
+class SmallJSON {
+  public id!: i32;
+  public name!: string;
+  public active!: boolean;
+}
+
+const v1: SmallJSON = {
+  id: 1,
+  name: "Small Object",
+  active: true,
+};
+const v2 = '{"id":1,"name":"Small Object","active":true}';
+
+bench(
+  "Serialize Small Object",
+  () => {
+    JSON.stringify(v1);
+  },
+  16_000_00,
+);
+
+bench(
+  "Deserialize Small Object",
+  () => {
+    JSON.parse<SmallJSON>(v2);
+  },
+  16_000_00,
+);

package/assembly/__benches__/vec3.bench.ts

@@ -0,0 +1,72 @@
+import { JSON } from "..";
+import { bench } from "../custom/bench";
+
+
+@json
+class Vec3 {
+  public x!: i32;
+  public y!: i32;
+  public z!: i32;
+
+  @inline __SERIALIZE(ptr: usize): void {
+    bs.proposeSize(98);
+    store<u64>(bs.offset, 9570664606466171, 0); // {"x"
+    store<u16>(bs.offset, 58, 8); // :
+    bs.offset += 10;
+    JSON.__serialize<i32>(load<i32>(ptr, offsetof<this>("x")));
+    store<u64>(bs.offset, 9570668901433388, 0); // ,"y"
+    store<u16>(bs.offset, 58, 8); // :
+    bs.offset += 10;
+    JSON.__serialize<i32>(load<i32>(ptr, offsetof<this>("y")));
+    store<u64>(bs.offset, 9570673196400684, 0); // ,"z"
+    store<u16>(bs.offset, 58, 8); // :
+    bs.offset += 10;
+    JSON.__serialize<i32>(load<i32>(ptr, offsetof<this>("z")));
+    store<u16>(bs.offset, 125, 0); // }
+    bs.offset += 2;
+  }
+
+  @inline __INITIALIZE(): this {
+    return this;
+  }
+
+  @inline __DESERIALIZE(keyStart: usize, keyEnd: usize, valStart: usize, valEnd: usize, ptr: usize): void {
+    switch (load<u16>(keyStart)) {
+      case 120: {
+        // x
+        store<i32>(ptr, JSON.__deserialize<i32>(valStart, valEnd, 0), offsetof<this>("x"));
+        return;
+      }
+      case 121: {
+        // y
+        store<i32>(ptr, JSON.__deserialize<i32>(valStart, valEnd, 0), offsetof<this>("y"));
+        return;
+      }
+      case 122: {
+        // z
+        store<i32>(ptr, JSON.__deserialize<i32>(valStart, valEnd, 0), offsetof<this>("z"));
+        return;
+      }
+    }
+    return;
+  }
+}
+
+const v1: Vec3 = { x: 1, y: 2, z: 3 };
+const v2 = '{"x":1,"y":2,"z":3}';
+
+bench(
+  "Serialize Vec3",
+  () => {
+    JSON.stringify(v1);
+  },
+  16_000_00,
+);
+
+bench(
+  "Deserialize Vec3",
+  () => {
+    JSON.parse<Vec3>(v2);
+  },
+  16_000_00,
+);

package/bench/abc.bench.ts

@@ -0,0 +1,20 @@
+import { bench } from "./lib/bench";
+
+const v1 = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+const v2 = '"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"';
+
+bench(
+  "Serialize Alphabet",
+  () => {
+    JSON.stringify(v1);
+  },
+  64_000_00,
+);
+
+bench(
+  "Deserialize Alphabet",
+  () => {
+    JSON.parse(v2);
+  },
+  64_000_00,
+);

package/bench/large.bench.ts

@@ -0,0 +1,126 @@
+import { bench } from "./lib/bench";
+
+class Vec3 {
+  public x!: number;
+  public y!: number;
+  public z!: number;
+}
+
+class LargeJSON {
+  public id!: number;
+  public name!: string;
+  public age!: number;
+  public email!: string;
+  public street!: string;
+  public city!: string;
+  public state!: string;
+  public zip!: string;
+  public tags!: string[];
+  public theme!: string;
+  public notifications!: boolean;
+  public language!: string;
+  public movement!: Vec3[];
+}
+
+const v1: LargeJSON = {
+  id: 2,
+  name: "Medium Object",
+  age: 18,
+  email: "me@jairus.dev",
+  street: "I don't want to say my street",
+  city: "I don't want to say this either",
+  state: "It really depends",
+  zip: "I forget what it is",
+  tags: ["me", "dogs", "mountains", "bar", "foo"],
+  theme: "Hyper Term Black",
+  notifications: true,
+  language: "en-US",
+  movement: [
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+    { x: 1, y: 2, z: 3 },
+  ],
+};
+
+const v2 = `{"id":2,"name":"Medium Object","age":18,"email":"me@jairus.dev","street":"I don't want to say my street","city":"I don't want to say this either","state":"It really depends","zip":"I forget what it is","tags":["me","dogs","mountains","bar","foo"],"theme":"Hyper Term Black","notifications":true,"language":"en-US","movement":[{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3},{"x":1,"y":2,"z":3}]}`;
+
+bench(
+  "Serialize Medium Object",
+  () => {
+    JSON.stringify(v1);
+  },
+  3_000_00,
+);
+
+bench(
+  "Deserialize Medium Object",
+  () => {
+    JSON.parse(v2);
+  },
+  3_000_00,
+);

package/bench/medium.bench.ts

@@ -0,0 +1,43 @@
+import { bench } from "./lib/bench";
+
+class MediumJSON {
+  public id!: number;
+  public name!: string;
+  public age!: number;
+  public email!: string;
+  public street!: string;
+  public city!: string;
+  public state!: string;
+  public zip!: string;
+  public tags!: string[];
+}
+
+const v1: MediumJSON = {
+  id: 2,
+  name: "Medium Object",
+  age: 18,
+  email: "me@jairus.dev",
+  street: "I don't want to say my street",
+  city: "I don't want to say this either",
+  state: "It really depends",
+  zip: "I forget what it is",
+  tags: ["me", "dogs", "mountains", "bar", "foo"],
+};
+
+const v2 = `{"id":2,"name":"Medium Object","age":18,"email":"me@jairus.dev","street":"I don't want to say my street","city":"I don't want to say this either","state":"It really depends","zip":"I forget what it is","tags":["me","dogs","mountains","bar","foo"]}`;
+
+bench(
+  "Serialize Medium Object",
+  () => {
+    JSON.stringify(v1);
+  },
+  8_000_00,
+);
+
+bench(
+  "Deserialize Medium Object",
+  () => {
+    JSON.parse(v2);
+  },
+  8_000_00,
+);

package/bench/small.bench.ts

@@ -0,0 +1,30 @@
+import { bench } from "./lib/bench";
+
+class SmallJSON {
+  public id!: number;
+  public name!: string;
+  public active!: boolean;
+}
+
+const v1: SmallJSON = {
+  id: 1,
+  name: "Small Object",
+  active: true,
+};
+const v2 = '{"id":1,"name":"Small Object","active":true}';
+
+bench(
+  "Serialize Small Object",
+  () => {
+    JSON.stringify(v1);
+  },
+  16_000_00,
+);
+
+bench(
+  "Deserialize Small Object",
+  () => {
+    JSON.parse(v2);
+  },
+  16_000_00,
+);

package/bench/vec3.bench.ts

@@ -0,0 +1,26 @@
+import { bench } from "./lib/bench";
+
+class Vec3 {
+  public x!: number;
+  public y!: number;
+  public z!: number;
+}
+
+const v1: Vec3 = { x: 1, y: 2, z: 3 };
+const v2 = '{"x":1,"y":2,"z":3}';
+
+bench(
+  "Serialize Vec3",
+  () => {
+    JSON.stringify(v1);
+  },
+  16_000_00,
+);
+
+bench(
+  "Deserialize Vec3",
+  () => {
+    JSON.parse(v2);
+  },
+  16_000_00,
+);

package/package.json

@@ -1,26 +1,41 @@
 {
   "name": "json-as",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "author": "Jairus Tanaka",
+  "description": "The only JSON library you'll need for AssemblyScript. SIMD enabled",
+  "types": "assembly/index.ts",
+  "main": "transform/lib/index.js",
+  "homepage": "https://github.com/JairusSW/json-as#readme",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/JairusSW/json-as.git"
   },
-  "main": "transform/lib/index.js",
+  "bugs": {
+    "url": "https://github.com/JairusSW/json-as/issues"
+  },
+  "scripts": {
+    "test": "bash ./run-tests.sh",
+    "bench:as": "bash ./run-bench.as.sh",
+    "bench:js": "bash ./run-bench.js.sh",
+    "build:time": "time npx asc ./assembly/__benches__/abc.bench.ts --transform ./transform -o ./build/abc.bench.wasm --optimizeLevel 3 --shrinkLevel 0 --converge --noAssert --uncheckedBehavior always --runtime stub --enable simd --enable bulk-memory",
+    "build:test": "rm -rf ./build/ && JSON_DEBUG=true asc --lib ./lib/ assembly/test.ts --transform ./transform -o ./build/test.wasm --textFile ./build/test.wat --optimizeLevel 3 --shrinkLevel 0",
+    "build:test:simd": "rm -rf ./build/ && JSON_DEBUG=true asc assembly/test.ts --transform ./transform -o ./build/test.wasm --textFile ./build/test.wat --optimizeLevel 3 --shrinkLevel 0 --enable simd",
+    "test:wasmtime": "wasmtime ./build/test.wasm",
+    "test:wasmer": "wasmer ./build/test.wasm",
+    "build:transform": "tsc -p ./transform",
+    "bench:wasmer": "wasmer ./build/bench.wasm --llvm",
+    "prettier": "prettier -w ."
+  },
   "devDependencies": {
     "@assemblyscript/wasi-shim": "^0.1.0",
     "@types/node": "^22.13.1",
-    "as-bench": "JairusSW/as-bench",
-    "as-console": "^7.0.0",
-    "as-test": "^0.4.0-beta.3",
     "assemblyscript": "^0.27.34",
     "assemblyscript-prettier": "^3.0.1",
     "prettier": "^3.5.0",
+    "tsx": "^4.19.3",
     "typescript": "^5.7.3"
   },
-  "bugs": {
-    "url": "https://github.com/JairusSW/json-as/issues"
-  },
   "contributors": [
     "DogWhich",
     "Romdotdog",
@@ -31,8 +46,6 @@
     "Matt Johnson-Pint",
     "Tomáš Hromada"
   ],
-  "description": "The only JSON library you'll need for AssemblyScript. SIMD enabled",
-  "homepage": "https://github.com/JairusSW/json-as#readme",
   "keywords": [
     "assemblyscript",
     "json",
@@ -48,24 +61,8 @@
     "fast",
     "algorithm"
   ],
-  "license": "MIT",
-  "overrides": {
-    "assemblyscript": "$assemblyscript"
-  },
   "publishConfig": {
     "@JairusSW:registry": "https://npm.pkg.github.com"
   },
-  "scripts": {
-    "test": "bash ./run-tests.sh",
-    "build:bench": "rm -rf ./build/ && JSON_DEBUG=true asc --lib ./lib/ assembly/__benches__/string.bench.ts -o ./build/bench.wasm --textFile ./build/bench.wat --transform ./transform --optimizeLevel 3 --shrinkLevel 0 --converge --noAssert --uncheckedBehavior always --runtime stub --enable simd --enable bulk-memory",
-    "build:test": "rm -rf ./build/ && JSON_DEBUG=true asc --lib ./lib/ assembly/test.ts --transform ./transform -o ./build/test.wasm --textFile ./build/test.wat --optimizeLevel 3 --shrinkLevel 0",
-    "build:test:simd": "rm -rf ./build/ && JSON_DEBUG=true asc assembly/test.ts --transform ./transform -o ./build/test.wasm --textFile ./build/test.wat --optimizeLevel 3 --shrinkLevel 0 --enable simd",
-    "test:wasmtime": "wasmtime ./build/test.wasm",
-    "test:wasmer": "wasmer ./build/test.wasm",
-    "build:transform": "tsc -p ./transform",
-    "bench:wasmer": "wasmer ./build/bench.wasm --llvm",
-    "prettier": "prettier -w ."
-  },
-  "type": "module",
-  "types": "assembly/index.ts"
+  "type": "module"
 }

package/run-bench.as.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+
+mkdir -p ./build
+
+for file in ./assembly/__benches__/*.bench.ts; do
+  filename=$(basename -- "$file")
+  output="./build/${filename%.ts}.wasm"
+
+  start_time=$(date +%s%3N)
+  npx asc "$file" --transform ./transform -o "$output" --optimizeLevel 3 --shrinkLevel 0 --converge --noAssert --uncheckedBehavior always --runtime stub --enable simd --enable bulk-memory || { echo "Build failed"; exit 1; }
+  end_time=$(date +%s%3N)
+
+  build_time=$((end_time - start_time))
+
+  if [ "$build_time" -ge 60000 ]; then
+    formatted_time="$(bc <<< "scale=2; $build_time/60000")m"
+  elif [ "$build_time" -ge 1000 ]; then
+    formatted_time="$(bc <<< "scale=2; $build_time/1000")s"
+  else
+    formatted_time="${build_time}ms"
+  fi
+
+  echo -e "$filename (built in $formatted_time)\n"
+  wasmer "$output" --llvm || { echo "Benchmarked failed."; exit 1; }
+done
+
+echo "Finished benchmarks."

package/run-bench.js.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+
+mkdir -p ./build
+
+for file in ./bench/*.bench.ts; do
+  filename=$(basename -- "$file")
+
+  echo -e "$filename\n"
+  npx tsx "$file" || { echo "Benchmark failed."; exit 1; }
+done
+
+echo "Finished benchmarks."

package/run-tests.sh

@@ -6,9 +6,21 @@ for file in ./assembly/__tests__/*.spec.ts; do
   filename=$(basename -- "$file")
   output="./build/${filename%.ts}.wasm"
 
-  asc "$file" --transform ./transform --lib ./lib/ -o "$output" || { echo "Tests failed"; exit 1; }
+  start_time=$(date +%s%3N)
+  npx asc "$file" --transform ./transform --lib ./lib/ -o "$output" || { echo "Tests failed"; exit 1; }
+  end_time=$(date +%s%3N) 
 
-  echo " -> $filename"
+  build_time=$((end_time - start_time))
+
+  if [ "$build_time" -ge 60000 ]; then
+    formatted_time="$(bc <<< "scale=2; $build_time/60000")m"
+  elif [ "$build_time" -ge 1000 ]; then
+    formatted_time="$(bc <<< "scale=2; $build_time/1000")s"
+  else
+    formatted_time="${build_time}ms"
+  fi
+
+  echo " -> $filename (built in $formatted_time)"
   wasmtime "$output" || { echo "Tests failed"; exit 1; }
 done
 

package/assembly/__benches__/misc.bench.ts

@@ -1,47 +0,0 @@
-import { bench } from "as-bench/assembly";
-import { JSON } from "..";
-import { Vec3 } from "./schemas";
-import { serializeString_SIMD } from "../serialize/simd/string";
-import { serializeString } from "../serialize/simple/string";
-import { deserializeString } from "../deserialize/simple/string";
-import { bytes } from "../util";
-import { deserializeString_SIMD } from "../deserialize/simd/string";
-
-const vec: Vec3 = {
-  x: 1,
-  y: 2,
-  z: 3
-}
-
-bs.ensureSize(4096);
-// bench("Serialize Vector3", () => {
-//   JSON.stringify(vec);
-// });
-
-// bench("Deserialize Vector3", () => {
-//   JSON.parse<Vec3>('{"x":1,"y":2,"z":3}');
-// });
-
-// bench("Serialize String SIMD", () => {
-//   serializeString_SIMD("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789~`!@#$%^&*()-_=+{[}]|\\:;\"'?/>.<,'\"}");
-//   bs.offset = changetype<usize>(bs.buffer);
-//   bs.stackSize = 0;
-// });
-
-// bench("Serialize String", () => {
-//   serializeString("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789~`!@#$%^&*()-_=+{[}]|\\:;\"'?/>.<,'\"}");
-//   bs.offset = changetype<usize>(bs.buffer);
-//   bs.stackSize = 0;
-// });
-
-const src = '"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789~`!@#$%^&*()-_=+{[}]|\\\\:;\\"\'?/>.<,\'\\"}"';
-const srcStart = changetype<usize>(src);
-const srcEnd = srcStart + bytes(src);
-const out = changetype<usize>(new ArrayBuffer(256));
-bench("Deserialize String", () => {
-  deserializeString(srcStart, srcEnd, out);
-});
-
-bench("Deserialize String SIMD", () => {
-  deserializeString_SIMD(srcStart, srcEnd, out);
-})

package/assembly/__benches__/schemas.ts

@@ -1,25 +0,0 @@
-import { JSON } from "..";
-
-@json
-export class Vec3 {
-  public x!: i32;
-  public y!: i32;
-  public z!: i32;
-  __DESERIALIZE(keyStart: usize, keyEnd: usize, valStart: usize, valEnd: usize, ptr: usize): void {
-    switch (load<u16>(keyStart)) {
-      case 120: { // x
-        store<i32>(ptr, JSON.__deserialize<i32>(valStart, valEnd, 0), offsetof<this>("x"));
-        return;
-      }
-      case 121: { // y
-        store<i32>(ptr, JSON.__deserialize<i32>(valStart, valEnd, 0), offsetof<this>("y"));
-        return;
-      }
-      case 122: { // z
-        store<i32>(ptr, JSON.__deserialize<i32>(valStart, valEnd, 0), offsetof<this>("z"));
-        return;
-      }
-    }
-    return;
-  }
-}

package/assembly/__benches__/string.bench.ts

@@ -1,23 +0,0 @@
-import {JSON} from "..";
-import {Vec3} from "./schemas";
-import {bench} from "../custom/bench";
-import {serializeString_SIMD} from "../serialize/simd/string";
-import {deserializeString_SIMD} from "../deserialize/simd/string";
-import {serializeString} from "../serialize/simple/string";
-import {deserializeString} from "../deserialize/simple/string";
-
-const vec: Vec3 = {x: 1, y: 2, z: 3};
-
-bs.ensureSize(4096);
-
-bench(
-  "Serialize String (Simple)",
-  () => {
-    serializeString("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789~`!@#$%^&*()-_=+{[}]|\\:;\"'?/>.<,'\"}");
-  },
-  25_000_000
-);
-
-// bench("Deserialize String Simple", () => {
-//   deserializeString_SIMD("\"hello world\"")
-// });

package/assembly/__benches__/struct.bench.ts

@@ -1,21 +0,0 @@
-import {JSON} from "..";
-import {Vec3} from "./schemas";
-import {bench} from "./bench";
-
-const vec: Vec3 = {x: 1, y: 2, z: 3};
-
-bs.ensureSize(4096);
-bench(
-  "Serialize Vector3",
-  () => {
-    // JSON.__serialize(vec);
-    // bs.offset = changetype<usize>(bs.buffer);
-    // bs.stackSize = 0;
-    JSON.stringify(vec);
-  },
-  25_000_000
-);
-
-// bench("Deserialize Vector3", () => {
-//   JSON.parse<Vec3>('{"x":1,"y":2,"z":3}');
-// });

package/bench/schemas.ts

@@ -1,5 +0,0 @@
-export class Vec3 {
-  public x!: number;
-  public y!: number;
-  public z!: number;
-}

package/bench/string.bench.ts

@@ -1,16 +0,0 @@
-import { bench } from "./bench";
-import { Vec3 } from "./schemas";
-
-const vec: Vec3 = {
-  x: 1,
-  y: 2,
-  z: 3,
-};
-
-bench("Serialize Vector3", () => {
-  JSON.stringify(vec);
-}, 25_000_000);
-
-bench("Deserialize Vector3", () => {
-  JSON.parse('{"x":1,"y":2,"z":3}');
-}, 25_000_000);