json-as 1.1.26 → 1.1.27

package/bench/large.bench.ts

@@ -1,126 +1,127 @@
-import { bench } from "./lib/bench.js";
+import { bench, blackbox, dumpToFile } from "./lib/bench.js";
 
-class Vec3 {
-  public x!: number;
-  public y!: number;
-  public z!: number;
+class RepoOwner {
+  login: string = "octocat";
+  id: number = 583231;
+  node_id: string = "MDQ6VXNlcjU4MzIzMQ==";
+  avatar_url: string = "https://avatars.githubusercontent.com/u/583231?v=4";
+  gravatar_id: string = "";
+  url: string = "https://api.github.com/users/octocat";
+  html_url: string = "https://github.com/octocat";
+  followers_url: string = "https://api.github.com/users/octocat/followers";
+  following_url: string = "https://api.github.com/users/octocat/following{/other_user}";
+  gists_url: string = "https://api.github.com/users/octocat/gists{/gist_id}";
+  starred_url: string = "https://api.github.com/users/octocat/starred{/owner}{/repo}";
+  subscriptions_url: string = "https://api.github.com/users/octocat/subscriptions";
+  organizations_url: string = "https://api.github.com/users/octocat/orgs";
+  repos_url: string = "https://api.github.com/users/octocat/repos";
+  events_url: string = "https://api.github.com/users/octocat/events{/privacy}";
+  received_events_url: string = "https://api.github.com/users/octocat/received_events";
+  type: string = "User";
+  user_view_type: string = "public";
+  site_admin: boolean = false;
 }
 
-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[];
+class RepoLicense {
+  key: string = "";
+  name: string = "";
+  spdx_id: string = "";
+  url: string | null = null;
+  node_id: string = "";
 }
 
-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 },
-  ],
-};
+class Repo {
+  id: number = 132935648;
+  node_id: string = "MDEwOlJlcG9zaXRvcnkxMzI5MzU2NDg=";
+  name: string = "boysenberry-repo-1";
+  full_name: string = "octocat/boysenberry-repo-1";
+  private: boolean = true;
+  owner: RepoOwner = new RepoOwner();
+  html_url: string = "https://github.com/octocat/boysenberry-repo-1";
+  description: string | null = "Testing";
+  fork: boolean = true;
+  url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1";
+  forks_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/forks";
+  keys_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/keys{/key_id}";
+  collaborators_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/collaborators{/collaborator}";
+  teams_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/teams";
+  hooks_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/hooks";
+  issue_events_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/issues/events{/number}";
+  events_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/events";
+  assignees_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/assignees{/user}";
+  branches_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/branches{/branch}";
+  tags_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/tags";
+  blobs_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/git/blobs{/sha}";
+  git_tags_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/git/tags{/sha}";
+  git_refs_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/git/refs{/sha}";
+  trees_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/git/trees{/sha}";
+  statuses_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/statuses/{sha}";
+  languages_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/languages";
+  stargazers_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/stargazers";
+  contributors_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/contributors";
+  subscribers_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/subscribers";
+  subscription_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/subscription";
+  commits_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/commits{/sha}";
+  git_commits_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/git/commits{/sha}";
+  comments_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/comments{/number}";
+  issue_comment_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/issues/comments{/number}";
+  contents_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/contents/{+path}";
+  compare_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/compare/{base}...{head}";
+  merges_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/merges";
+  archive_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/{archive_format}{/ref}";
+  downloads_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/downloads";
+  issues_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/issues{/number}";
+  pulls_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/pulls{/number}";
+  milestones_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/milestones{/number}";
+  notifications_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/notifications{?since,all,participating}";
+  labels_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/labels{/name}";
+  releases_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/releases{/id}";
+  deployments_url: string = "https://api.github.com/repos/octocat/boysenberry-repo-1/deployments";
+  created_at: string = "2018-05-10T17:51:29Z";
+  updated_at: string = "2025-05-24T02:01:19Z";
+  pushed_at: string = "2024-05-26T07:02:05Z";
+  git_url: string = "git://github.com/octocat/boysenberry-repo-1.git";
+  ssh_url: string = "git@github.com:octocat/boysenberry-repo-1.git";
+  clone_url: string = "https://github.com/octocat/boysenberry-repo-1.git";
+  svn_url: string = "https://github.com/octocat/boysenberry-repo-1";
+  homepage: string | null = "";
+  size: number = 4;
+  stargazers_count: number = 332;
+  watchers_count: number = 332;
+  language: string | null = null;
+  has_issues: boolean = false;
+  has_projects: boolean = true;
+  has_downloads: boolean = true;
+  has_wiki: boolean = true;
+  has_pages: boolean = false;
+  has_discussions: boolean = false;
+  forks_count: number = 20;
+  mirror_url: string | null = null;
+  archived: boolean = false;
+  disabled: boolean = false;
+  open_issues_count: number = 1;
+  license: RepoLicense | null = null;
+  allow_forking: boolean = true;
+  is_template: boolean = false;
+  web_commit_signoff_required: boolean = false;
+  topics: string[] = [];
+  visibility: string = "public";
+  forks: number = 20;
+  open_issues: number = 1;
+  watchers: number = 332;
+  default_branch: string = "master";
+}
+
+const v1 = new Repo();
 
-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}]}`;
+const v2 = `{"id":132935648,"node_id":"MDEwOlJlcG9zaXRvcnkxMzI5MzU2NDg=","name":"boysenberry-repo-1","full_name":"octocat/boysenberry-repo-1","private":true,"owner":{"login":"octocat","id":583231,"node_id":"MDQ6VXNlcjU4MzIzMQ==","avatar_url":"https://avatars.githubusercontent.com/u/583231?v=4","gravatar_id":"","url":"https://api.github.com/users/octocat","html_url":"https://github.com/octocat","followers_url":"https://api.github.com/users/octocat/followers","following_url":"https://api.github.com/users/octocat/following{/other_user}","gists_url":"https://api.github.com/users/octocat/gists{/gist_id}","starred_url":"https://api.github.com/users/octocat/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/octocat/subscriptions","organizations_url":"https://api.github.com/users/octocat/orgs","repos_url":"https://api.github.com/users/octocat/repos","events_url":"https://api.github.com/users/octocat/events{/privacy}","received_events_url":"https://api.github.com/users/octocat/received_events","type":"User","user_view_type":"public","site_admin":false},"html_url":"https://github.com/octocat/boysenberry-repo-1","description":"Testing","fork":true,"url":"https://api.github.com/repos/octocat/boysenberry-repo-1","forks_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/forks","keys_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/keys{/key_id}","collaborators_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/teams","hooks_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/hooks","issue_events_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/issues/events{/number}","events_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/events","assignees_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/assignees{/user}","branches_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/branches{/branch}","tags_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/tags","blobs_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/git/refs{/sha}","trees_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/git/trees{/sha}","statuses_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/statuses/{sha}","languages_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/languages","stargazers_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/stargazers","contributors_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/contributors","subscribers_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/subscribers","subscription_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/subscription","commits_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/commits{/sha}","git_commits_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/git/commits{/sha}","comments_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/comments{/number}","issue_comment_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/issues/comments{/number}","contents_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/contents/{+path}","compare_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/compare/{base}...{head}","merges_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/merges","archive_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/downloads","issues_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/issues{/number}","pulls_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/pulls{/number}","milestones_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/milestones{/number}","notifications_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/labels{/name}","releases_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/releases{/id}","deployments_url":"https://api.github.com/repos/octocat/boysenberry-repo-1/deployments","created_at":"2018-05-10T17:51:29Z","updated_at":"2025-05-24T02:01:19Z","pushed_at":"2024-05-26T07:02:05Z","git_url":"git://github.com/octocat/boysenberry-repo-1.git","ssh_url":"git@github.com:octocat/boysenberry-repo-1.git","clone_url":"https://github.com/octocat/boysenberry-repo-1.git","svn_url":"https://github.com/octocat/boysenberry-repo-1","homepage":"","size":4,"stargazers_count":332,"watchers_count":332,"language":null,"has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"has_discussions":false,"forks_count":20,"mirror_url":null,"archived":false,"disabled":false,"open_issues_count":1,"license":null,"allow_forking":true,"is_template":false,"web_commit_signoff_required":false,"topics":[],"visibility":"public","forks":20,"open_issues":1,"watchers":332,"default_branch":"master"}`;
 
-bench(
-  "Serialize Large Object",
-  () => {
-    JSON.stringify(v1);
-  },
-  3_000_00,
-);
+bench("Serialize Large API Response", () => {
+  blackbox(JSON.stringify(v1));
+}, 100_000, 10502);
+dumpToFile("large", "serialize")
 
-bench(
-  "Deserialize Large Object",
-  () => {
-    JSON.parse(v2);
-  },
-  3_000_00,
-);
+bench("Deserialize Large API Response", () => {
+  blackbox(JSON.parse(v2));
+}, 100_000, 10502);
+dumpToFile("large", "deserialize")

package/bench/lib/bench.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Benchmark a routine under V8.
+ *
+ * @param description Human-readable benchmark name
+ * @param routine Function to benchmark (must be side-effect safe)
+ * @param ops Number of operations to execute (default: 1,000,000)
+ * @param bytesPerOp Bytes processed per operation (used for MB/s reporting)
+ */
+export function bench(
+  description: string,
+  routine: () => void,
+  ops?: number,
+  bytesPerOp?: number
+): void;
+
+/**
+ * Prevents V8 from optimizing away a value.
+ *
+ * This relies on the V8 intrinsic %PerformMicrotaskCheckpoint and therefore
+ * only works under d8 / V8 with --allow-natives-syntax.
+ *
+ * @param x Value to blackbox
+ * @returns The same value
+ */
+export function blackbox<T>(x: T): T;
+
+export function dumpToFile(suite: string, type: string): void;

package/bench/lib/bench.js

@@ -0,0 +1,53 @@
+let result = {};
+export function bench(description, routine, ops = 1_000_000, bytesPerOp = 0) {
+    console.log(" - Benchmarking " + description);
+    let warmup = Math.floor(ops / 10);
+    while (warmup-- > 0) {
+        routine();
+    }
+    const start = performance.now();
+    let count = ops;
+    while (count-- > 0) {
+        routine();
+    }
+    const end = performance.now();
+    const elapsed = Math.max(1, end - start);
+    const opsPerSecond = (ops * 1000) / elapsed;
+    let log = `   Completed benchmark in ${formatNumber(Math.round(elapsed))}ms at ${formatNumber(Math.round(opsPerSecond))} ops/s`;
+    let mbPerSec = 0;
+    if (bytesPerOp > 0) {
+        const totalBytes = bytesPerOp * ops;
+        mbPerSec = totalBytes / (elapsed / 1000) / (1000 * 1000);
+        log += ` @ ${formatNumber(Math.round(mbPerSec))}MB/s`;
+    }
+    result = {
+        language: "javascript",
+        description,
+        elapsed,
+        bytes: bytesPerOp,
+        operations: ops,
+        features: [],
+        mbps: mbPerSec
+    };
+    console.log(log + "\n");
+}
+export function dumpToFile(suite, type) {
+    writeFile("./build/logs/js/" + suite+"."+type+".js.json", JSON.stringify(result));
+}
+function formatNumber(n) {
+    let str = n.toString();
+    let len = str.length;
+    let result = "";
+    let commaOffset = len % 3;
+    for (let i = 0; i < len; i++) {
+        if (i > 0 && (i - commaOffset) % 3 === 0)
+            result += ",";
+        result += str.charAt(i);
+    }
+    return result;
+}
+
+export function blackbox(x) {
+    %PerformMicrotaskCheckpoint();
+    return x;
+}

package/bench/lib/chart.ts

@@ -0,0 +1,217 @@
+// chartplot.ts (Bun/ESNext compatible)
+import { readFileSync, writeFileSync } from "fs";
+import { basename } from "path";
+
+type RawBench = {
+  description: string;
+  elapsed: number; // ms
+  bytes: number; // bytes per operation
+  operations: number;
+  features: string[];
+};
+
+type BenchmarkResult = {
+  library: string;
+  payload: string; // e.g., "small", "medium", "large", "abc", "vec3"
+  gbPerSec: number;
+};
+
+type ChartData = {
+  title: string;
+  payloads: string[]; // ordered list of payload names
+  results: BenchmarkResult[];
+};
+
+if (import.meta.main) {
+  const args = process.argv.slice(2);
+  if (!args.length) {
+    console.error(
+      "Usage:\n bun ./chartplot.ts <bench1.json> <bench2.json> [...] [-o output.svg]"
+    );
+    process.exit(1);
+  }
+
+  let outputFile = "benchmark-chart.svg";
+  const inputFiles: string[] = [];
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "-o") {
+      if (i + 1 >= args.length) {
+        console.error("Error: -o requires a filename");
+        process.exit(1);
+      }
+      outputFile = args[++i];
+    } else {
+      inputFiles.push("./build/logs/" +args[i]);
+    }
+  }
+
+  if (!inputFiles.length) {
+    console.error("Error: no input files provided");
+    process.exit(1);
+  }
+
+  generateBarChartFromFiles(inputFiles, outputFile);
+}
+
+function generateBarChartFromFiles(files: string[], outputFile: string) {
+  const results: BenchmarkResult[] = [];
+
+  for (const file of files) {
+    const raw: RawBench = JSON.parse(readFileSync(file, "utf-8"));
+    const impl = inferImplementation(file);
+    const payload = inferPayload(file);
+
+    const gbPerSec = (raw.bytes * raw.operations) / (raw.elapsed * 1e6);
+
+    results.push({ library: impl, payload, gbPerSec });
+  }
+
+  // Group by payload and sort payloads logically
+  const payloadOrder = ["abc", "vec3", "small", "medium", "large"];
+  const uniquePayloads = [...new Set(results.map(r => r.payload))].sort(
+    (a, b) => payloadOrder.indexOf(a) - payloadOrder.indexOf(b)
+  );
+
+  const uniqueLibraries = [...new Set(results.map(r => r.library))];
+  const colors = ["#3b82f6", "#10b981", "#f59e0b", "#ef4444", "#8b5cf6"];
+
+  const chart: ChartData = {
+    title: "JSON Throughput by Payload Size",
+    payloads: uniquePayloads,
+    results,
+  };
+
+  const svg = generateGroupedBarSVG(chart, uniqueLibraries, colors);
+  writeFileSync(outputFile, svg, "utf-8");
+  console.log(`✅ Bar chart written to ${outputFile}`);
+}
+
+function inferImplementation(file: string): string {
+  return basename(file)
+    .replace(".log.json", "")
+    .replace(/\.bench\./g, " ")
+    .replace(/\./g, " ")
+    .trim();
+}
+
+function inferPayload(file: string): string {
+  const name = basename(file);
+  if (name.includes("abc.bench")) return "abc";
+  if (name.includes("vec3.bench")) return "vec3";
+  if (name.includes("small.bench")) return "small";
+  if (name.includes("medium.bench")) return "medium";
+  if (name.includes("large.bench")) return "large";
+  return "unknown";
+}
+
+function generateGroupedBarSVG(
+  data: ChartData,
+  libraries: string[],
+  colors: string[]
+): string {
+  const width = 900;
+  const height = 550;
+  const padding = { top: 80, right: 200, bottom: 80, left: 80 };
+  const chartWidth = width - padding.left - padding.right;
+  const chartHeight = height - padding.top - padding.bottom;
+
+  const barPadding = 0.1; // space between groups
+  const groupWidth = chartWidth / data.payloads.length;
+  const barWidth = groupWidth / libraries.length * (1 - barPadding);
+
+  const allValues = data.results.map(r => r.gbPerSec);
+  const yMax = Math.max(...allValues, 0.1) * 1.1;
+
+  const yScale = (v: number) =>
+    padding.top + chartHeight - (v / yMax) * chartHeight;
+
+  let svg = `<?xml version="1.0" encoding="UTF-8"?>
+<svg width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" xmlns="http://www.w3.org/2000/svg">
+<defs>
+<style>
+  .title { font: bold 20px sans-serif; fill: #1f2937; }
+  .axis-label { font: 14px sans-serif; fill: #374151; }
+  .tick { font: 12px sans-serif; fill: #6b7280; }
+  .grid { stroke: #e5e7eb; stroke-dasharray: 3,3; }
+  .axis { stroke: #9ca3af; stroke-width: 1.5; }
+  .bar-label { font: bold 11px sans-serif; fill: white; text-anchor: middle; }
+  .legend-text { font: 13px sans-serif; fill: #374151; }
+</style>
+</defs>
+
+<rect width="${width}" height="${height}" fill="#fff"/>
+
+<!-- Title -->
+<text x="${width / 2}" y="40" text-anchor="middle" class="title">
+${data.title}
+</text>
+
+<!-- Y Axis Grid & Labels -->
+`;
+  for (let i = 0; i <= 8; i++) {
+    const v = (yMax / 8) * i;
+    const y = yScale(v);
+    svg += `
+<line x1="${padding.left}" y1="${y}" x2="${width - padding.right}" y2="${y}" class="grid"/>
+<text x="${padding.left - 10}" y="${y + 4}" text-anchor="end" class="tick">
+${v.toFixed(2)} GB/s
+</text>`;
+  }
+
+  // X Axis Labels (Payloads)
+  data.payloads.forEach((payload, i) => {
+    const x = padding.left + groupWidth * (i + 0.5);
+    svg += `<text x="${x}" y="${height - padding.bottom + 40}" text-anchor="middle" class="tick">
+${payload.toUpperCase()}
+</text>`;
+  });
+
+  // Axes
+  svg += `
+<line x1="${padding.left}" y1="${padding.top}" x2="${padding.left}" y2="${height - padding.bottom}" class="axis"/>
+<line x1="${padding.left}" y1="${height - padding.bottom}" x2="${width - padding.right}" y2="${height - padding.bottom}" class="axis"/>
+
+<text x="${width / 2}" y="${height - 20}" text-anchor="middle" class="axis-label">
+Payload Type
+</text>
+<text x="-${height / 2}" y="20" transform="rotate(-90)" text-anchor="middle" class="axis-label">
+Throughput (GB/s)
+</text>
+`;
+
+  // Bars
+  data.payloads.forEach((payload, payloadIdx) => {
+    const groupX = padding.left + groupWidth * payloadIdx;
+
+    libraries.forEach((lib, libIdx) => {
+      const result = data.results.find(r => r.payload === payload && r.library === lib);
+      if (!result) return;
+
+      const x = groupX + (libIdx + 0.1) * (groupWidth / libraries.length);
+      const barHeight = chartHeight - yScale(result.gbPerSec);
+      const y = yScale(result.gbPerSec);
+
+      const color = colors[libIdx % colors.length];
+
+      svg += `<rect x="${x}" y="${y}" width="${barWidth}" height="${barHeight}" fill="${color}" rx="4"/>
+<text x="${x + barWidth / 2}" y="${y + 16}" class="bar-label">
+${result.gbPerSec.toFixed(2)}
+</text>`;
+    });
+  });
+
+  // Legend
+  libraries.forEach((lib, i) => {
+    const y = padding.top + i * 30;
+    const color = colors[i % colors.length];
+    svg += `
+<rect x="${width - padding.right + 20}" y="${y - 10}" width="18" height="18" fill="${color}" rx="4"/>
+<text x="${width - padding.right + 50}" y="${y + 5}" class="legend-text">
+${lib}
+</text>`;
+  });
+
+  return svg + "</svg>";
+}
+// bun ./bench/lib/chart.ts   abc.bench.incremental.simd.as.log.json   vec3.bench.incremental.simd.as.log.json   small.bench.incremental.simd.as.log.json   medium.bench.incremental.simd.as.log.json   large.bench.incremental.simd.as.log.json   -o throughput-comparison.svg