diff --git a/package-lock.json b/package-lock.json
index b6c542a..7bef7bd 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -8,6 +8,9 @@
       "name": "@matrixai/logger",
       "version": "4.0.3",
       "license": "Apache-2.0",
+      "dependencies": {
+        "ink": "^5.1.0"
+      },
       "devDependencies": {
         "@swc/core": "1.3.82",
         "@swc/jest": "^0.2.29",
@@ -27,6 +30,7 @@
         "prettier": "^3.0.0",
         "shx": "^0.3.4",
         "systeminformation": "^5.18.5",
+        "ts-node": "^10.9.2",
         "tsx": "^3.12.7",
         "typedoc": "^0.24.8",
         "typescript": "^5.1.6"
@@ -41,6 +45,43 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/@alcalzone/ansi-tokenize": {
+      "version": "0.1.3",
+      "resolved": "https://registry.npmjs.org/@alcalzone/ansi-tokenize/-/ansi-tokenize-0.1.3.tgz",
+      "integrity": "sha512-3yWxPTq3UQ/FY9p1ErPxIyfT64elWaMvM9lIHnaqpyft63tkxodF5aUElYHrdisWve5cETkh1+KBw1yJuW0aRw==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^6.2.1",
+        "is-fullwidth-code-point": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=14.13.1"
+      }
+    },
+    "node_modules/@alcalzone/ansi-tokenize/node_modules/ansi-styles": {
+      "version": "6.2.1",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz",
+      "integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/@alcalzone/ansi-tokenize/node_modules/is-fullwidth-code-point": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-4.0.0.tgz",
+      "integrity": "sha512-O4L094N2/dZ7xqVdrXhh9r1KODPJpFms8B5sGdJLPy664AgvXsreZUyCQQNItZRDlYug4xStLjNp/sz3HvBowQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/@ampproject/remapping": {
       "version": "2.2.1",
       "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.2.1.tgz",
@@ -751,6 +792,30 @@
       "integrity": "sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==",
       "dev": true
     },
+    "node_modules/@cspotcode/source-map-support": {
+      "version": "0.8.1",
+      "resolved": "https://registry.npmjs.org/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz",
+      "integrity": "sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/trace-mapping": "0.3.9"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@cspotcode/source-map-support/node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.9",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz",
+      "integrity": "sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.0.3",
+        "@jridgewell/sourcemap-codec": "^1.4.10"
+      }
+    },
     "node_modules/@esbuild-kit/cjs-loader": {
       "version": "2.4.2",
       "resolved": "https://registry.npmjs.org/@esbuild-kit/cjs-loader/-/cjs-loader-2.4.2.tgz",
@@ -2183,6 +2248,34 @@
       "integrity": "sha512-myfUej5naTBWnqOCc/MdVOLVjXUXtIA+NpDrDBKJtLLg2shUjBu3cZmB/85RyitKc55+lUUyl7oRfLOvkr2hsw==",
       "dev": true
     },
+    "node_modules/@tsconfig/node10": {
+      "version": "1.0.11",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.11.tgz",
+      "integrity": "sha512-DcRjDCujK/kCk/cUe8Xz8ZSpm8mS3mNNpta+jGCA6USEDfktlNvm1+IuZ9eTcDbNk41BHwpHHeW+N1lKCz4zOw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@tsconfig/node12": {
+      "version": "1.0.11",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node12/-/node12-1.0.11.tgz",
+      "integrity": "sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@tsconfig/node14": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node14/-/node14-1.0.3.tgz",
+      "integrity": "sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@tsconfig/node16": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node16/-/node16-1.0.4.tgz",
+      "integrity": "sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/@types/babel__core": {
       "version": "7.20.1",
       "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.1.tgz",
@@ -2504,10 +2597,11 @@
       }
     },
     "node_modules/acorn": {
-      "version": "8.10.0",
-      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.10.0.tgz",
-      "integrity": "sha512-F0SAmZ8iUtS//m8DmCTA0jlh6TDKkHQyK6xc6V4KDTyZKA9dnvX9/3sRTVQrWm79glUAZbnmmNcdYwUIHWVybw==",
+      "version": "8.14.0",
+      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.14.0.tgz",
+      "integrity": "sha512-cl669nCJTZBsL97OF4kUQm5g5hC2uihk0NxY3WENAC0TYdILVkAyHymAntgxGkl7K+t0cXIrH5siy5S4XkFycA==",
       "dev": true,
+      "license": "MIT",
       "bin": {
         "acorn": "bin/acorn"
       },
@@ -2524,6 +2618,19 @@
         "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0"
       }
     },
+    "node_modules/acorn-walk": {
+      "version": "8.3.4",
+      "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.3.4.tgz",
+      "integrity": "sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "acorn": "^8.11.0"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
     "node_modules/ajv": {
       "version": "6.12.6",
       "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz",
@@ -2610,6 +2717,13 @@
         "node": ">= 8"
       }
     },
+    "node_modules/arg": {
+      "version": "4.1.3",
+      "resolved": "https://registry.npmjs.org/arg/-/arg-4.1.3.tgz",
+      "integrity": "sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/argparse": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
@@ -2741,6 +2855,18 @@
         "node": ">=8"
       }
     },
+    "node_modules/auto-bind": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/auto-bind/-/auto-bind-5.0.1.tgz",
+      "integrity": "sha512-ooviqdwwgfIfNmDwo94wlshcdzfO64XV0Cg6oDsDYBJfITDz1EngD2z7DkbvCWn+XIMsIqW27sEVF6qcpJrRcg==",
+      "license": "MIT",
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/available-typed-arrays": {
       "version": "1.0.5",
       "resolved": "https://registry.npmjs.org/available-typed-arrays/-/available-typed-arrays-1.0.5.tgz",
@@ -3082,6 +3208,18 @@
       "integrity": "sha512-0TNiGstbQmCFwt4akjjBg5pLRTSyj/PkWQ1ZoO2zntmg9yLqSRxwEa4iCfQLGjqhiqBfOJa7W/E8wfGrTDmlZQ==",
       "dev": true
     },
+    "node_modules/cli-boxes": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/cli-boxes/-/cli-boxes-3.0.0.tgz",
+      "integrity": "sha512-/lzGpEWL/8PfI0BmBOPRwp0c/wFNX1RdUML3jK/RcSBA9T8mZDdQpqYBKtCFTOfQbwPqWEOpjqW+Fnayc0969g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/cli-cursor": {
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/cli-cursor/-/cli-cursor-3.1.0.tgz",
@@ -3094,6 +3232,112 @@
         "node": ">=8"
       }
     },
+    "node_modules/cli-truncate": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/cli-truncate/-/cli-truncate-4.0.0.tgz",
+      "integrity": "sha512-nPdaFdQ0h/GEigbPClz11D0v/ZJEwxmeVZGeMo3Z5StPtUTkA9o1lD6QwoirYiSDzbcwn2XcjwmCp68W1IS4TA==",
+      "license": "MIT",
+      "dependencies": {
+        "slice-ansi": "^5.0.0",
+        "string-width": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/cli-truncate/node_modules/ansi-regex": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.1.0.tgz",
+      "integrity": "sha512-7HSX4QQb4CspciLpVFwyRe79O3xsIZDDLER21kERQ71oaPodF8jL725AgJMFAYbooIqolJoRLuM81SpeUkpkvA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+      }
+    },
+    "node_modules/cli-truncate/node_modules/ansi-styles": {
+      "version": "6.2.1",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz",
+      "integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/cli-truncate/node_modules/emoji-regex": {
+      "version": "10.4.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.4.0.tgz",
+      "integrity": "sha512-EC+0oUMY1Rqm4O6LLrgjtYDvcVYTy7chDnM4Q7030tP4Kwj3u/pR6gP9ygnp2CJMK5Gq+9Q2oqmrFJAz01DXjw==",
+      "license": "MIT"
+    },
+    "node_modules/cli-truncate/node_modules/is-fullwidth-code-point": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-4.0.0.tgz",
+      "integrity": "sha512-O4L094N2/dZ7xqVdrXhh9r1KODPJpFms8B5sGdJLPy664AgvXsreZUyCQQNItZRDlYug4xStLjNp/sz3HvBowQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/cli-truncate/node_modules/slice-ansi": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-5.0.0.tgz",
+      "integrity": "sha512-FC+lgizVPfie0kkhqUScwRu1O/lF6NOgJmlCgK+/LYxDCTk8sGelYaHDhFcDN+Sn3Cv+3VSa4Byeo+IMCzpMgQ==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^6.0.0",
+        "is-fullwidth-code-point": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/slice-ansi?sponsor=1"
+      }
+    },
+    "node_modules/cli-truncate/node_modules/string-width": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz",
+      "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==",
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^10.3.0",
+        "get-east-asian-width": "^1.0.0",
+        "strip-ansi": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/cli-truncate/node_modules/strip-ansi": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz",
+      "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+      }
+    },
     "node_modules/cliui": {
       "version": "8.0.1",
       "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz",
@@ -3135,6 +3379,18 @@
         "node": ">= 0.12.0"
       }
     },
+    "node_modules/code-excerpt": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/code-excerpt/-/code-excerpt-4.0.0.tgz",
+      "integrity": "sha512-xxodCmBen3iy2i0WtAK8FlFNrRzjUqjRsMfho58xT/wvZU1YTM3fCnRjcy1gJPMepaRlgm/0e6w8SpWHpn3/cA==",
+      "license": "MIT",
+      "dependencies": {
+        "convert-to-spaces": "^2.0.1"
+      },
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      }
+    },
     "node_modules/collect-v8-coverage": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/collect-v8-coverage/-/collect-v8-coverage-1.0.2.tgz",
@@ -3189,6 +3445,22 @@
       "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==",
       "dev": true
     },
+    "node_modules/convert-to-spaces": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/convert-to-spaces/-/convert-to-spaces-2.0.1.tgz",
+      "integrity": "sha512-rcQ1bsQO9799wq24uE5AM2tAILy4gXGIK/njFWcVQkGNZ96edlpY+A7bjwvzjYvLDyzmG1MmMLZhpcsb+klNMQ==",
+      "license": "MIT",
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      }
+    },
+    "node_modules/create-require": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/create-require/-/create-require-1.1.1.tgz",
+      "integrity": "sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/cross-spawn": {
       "version": "7.0.3",
       "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz",
@@ -3430,6 +3702,16 @@
         "node": ">=8"
       }
     },
+    "node_modules/diff": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/diff/-/diff-4.0.2.tgz",
+      "integrity": "sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.3.1"
+      }
+    },
     "node_modules/diff-sequences": {
       "version": "29.4.3",
       "resolved": "https://registry.npmjs.org/diff-sequences/-/diff-sequences-29.4.3.tgz",
@@ -3487,6 +3769,18 @@
       "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
       "dev": true
     },
+    "node_modules/environment": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/environment/-/environment-1.1.0.tgz",
+      "integrity": "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/error-ex": {
       "version": "1.3.2",
       "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.2.tgz",
@@ -3589,6 +3883,16 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/es-toolkit": {
+      "version": "1.32.0",
+      "resolved": "https://registry.npmjs.org/es-toolkit/-/es-toolkit-1.32.0.tgz",
+      "integrity": "sha512-ZfSfHP1l6ubgW/B/FRtqb9bYdMvI6jizbOSfbwwJNcOQ1QE6TFsC3jpQkZ900uUPSR3t3SU5Ds7UWKnYz+uP8Q==",
+      "license": "MIT",
+      "workspaces": [
+        "docs",
+        "benchmarks"
+      ]
+    },
     "node_modules/esbuild": {
       "version": "0.17.19",
       "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.17.19.tgz",
@@ -4262,6 +4566,18 @@
         "node": "6.* || 8.* || >= 10.*"
       }
     },
+    "node_modules/get-east-asian-width": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.3.0.tgz",
+      "integrity": "sha512-vpeMIQKxczTD/0s2CdEWHcb0eeJe6TFjxb+J5xgX7hScxqrGuyjmv4c1D4A/gelKfyox0gJJwIHF+fLjeaM8kQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/get-intrinsic": {
       "version": "1.2.1",
       "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.2.1.tgz",
@@ -4581,6 +4897,18 @@
         "node": ">=0.8.19"
       }
     },
+    "node_modules/indent-string": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-5.0.0.tgz",
+      "integrity": "sha512-m6FAo/spmsW2Ab2fU35JTYwtOKa2yAwXSwgjSv1TJzh4Mh7mC3lzAOVLBprb72XsTrgkEIsl7YrFNAiDiRhIGg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/inflight": {
       "version": "1.0.6",
       "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
@@ -4597,6 +4925,234 @@
       "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
       "dev": true
     },
+    "node_modules/ink": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/ink/-/ink-5.1.0.tgz",
+      "integrity": "sha512-3vIO+CU4uSg167/dZrg4wHy75llUINYXxN4OsdaCkE40q4zyOTPwNc2VEpLnnWsIvIQeo6x6lilAhuaSt+rIsA==",
+      "license": "MIT",
+      "dependencies": {
+        "@alcalzone/ansi-tokenize": "^0.1.3",
+        "ansi-escapes": "^7.0.0",
+        "ansi-styles": "^6.2.1",
+        "auto-bind": "^5.0.1",
+        "chalk": "^5.3.0",
+        "cli-boxes": "^3.0.0",
+        "cli-cursor": "^4.0.0",
+        "cli-truncate": "^4.0.0",
+        "code-excerpt": "^4.0.0",
+        "es-toolkit": "^1.22.0",
+        "indent-string": "^5.0.0",
+        "is-in-ci": "^1.0.0",
+        "patch-console": "^2.0.0",
+        "react-reconciler": "^0.29.0",
+        "scheduler": "^0.23.0",
+        "signal-exit": "^3.0.7",
+        "slice-ansi": "^7.1.0",
+        "stack-utils": "^2.0.6",
+        "string-width": "^7.2.0",
+        "type-fest": "^4.27.0",
+        "widest-line": "^5.0.0",
+        "wrap-ansi": "^9.0.0",
+        "ws": "^8.18.0",
+        "yoga-wasm-web": "~0.3.3"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "@types/react": ">=18.0.0",
+        "react": ">=18.0.0",
+        "react-devtools-core": "^4.19.1"
+      },
+      "peerDependenciesMeta": {
+        "@types/react": {
+          "optional": true
+        },
+        "react-devtools-core": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/ink/node_modules/ansi-escapes": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-7.0.0.tgz",
+      "integrity": "sha512-GdYO7a61mR0fOlAsvC9/rIHf7L96sBc6dEWzeOu+KAea5bZyQRPIpojrVoI4AXGJS/ycu/fBTdLrUkA4ODrvjw==",
+      "license": "MIT",
+      "dependencies": {
+        "environment": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/ink/node_modules/ansi-regex": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.1.0.tgz",
+      "integrity": "sha512-7HSX4QQb4CspciLpVFwyRe79O3xsIZDDLER21kERQ71oaPodF8jL725AgJMFAYbooIqolJoRLuM81SpeUkpkvA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+      }
+    },
+    "node_modules/ink/node_modules/ansi-styles": {
+      "version": "6.2.1",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz",
+      "integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/ink/node_modules/chalk": {
+      "version": "5.4.1",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.4.1.tgz",
+      "integrity": "sha512-zgVZuo2WcZgfUEmsn6eO3kINexW8RAE4maiQ8QNs8CtpPCSyMiYsULR3HQYkm3w8FIA3SberyMJMSldGsW+U3w==",
+      "license": "MIT",
+      "engines": {
+        "node": "^12.17.0 || ^14.13 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/chalk?sponsor=1"
+      }
+    },
+    "node_modules/ink/node_modules/cli-cursor": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/cli-cursor/-/cli-cursor-4.0.0.tgz",
+      "integrity": "sha512-VGtlMu3x/4DOtIUwEkRezxUZ2lBacNJCHash0N0WeZDBS+7Ux1dm3XWAgWYxLJFMMdOeXMHXorshEFhbMSGelg==",
+      "license": "MIT",
+      "dependencies": {
+        "restore-cursor": "^4.0.0"
+      },
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/ink/node_modules/emoji-regex": {
+      "version": "10.4.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.4.0.tgz",
+      "integrity": "sha512-EC+0oUMY1Rqm4O6LLrgjtYDvcVYTy7chDnM4Q7030tP4Kwj3u/pR6gP9ygnp2CJMK5Gq+9Q2oqmrFJAz01DXjw==",
+      "license": "MIT"
+    },
+    "node_modules/ink/node_modules/is-fullwidth-code-point": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-5.0.0.tgz",
+      "integrity": "sha512-OVa3u9kkBbw7b8Xw5F9P+D/T9X+Z4+JruYVNapTjPYZYUznQ5YfWeFkOj606XYYW8yugTfC8Pj0hYqvi4ryAhA==",
+      "license": "MIT",
+      "dependencies": {
+        "get-east-asian-width": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/ink/node_modules/restore-cursor": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/restore-cursor/-/restore-cursor-4.0.0.tgz",
+      "integrity": "sha512-I9fPXU9geO9bHOt9pHHOhOkYerIMsmVaWB0rA2AI9ERh/+x/i7MV5HKBNrg+ljO5eoPVgCcnFuRjJ9uH6I/3eg==",
+      "license": "MIT",
+      "dependencies": {
+        "onetime": "^5.1.0",
+        "signal-exit": "^3.0.2"
+      },
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/ink/node_modules/slice-ansi": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-7.1.0.tgz",
+      "integrity": "sha512-bSiSngZ/jWeX93BqeIAbImyTbEihizcwNjFoRUIY/T1wWQsfsm2Vw1agPKylXvQTU7iASGdHhyqRlqQzfz+Htg==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^6.2.1",
+        "is-fullwidth-code-point": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/slice-ansi?sponsor=1"
+      }
+    },
+    "node_modules/ink/node_modules/string-width": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz",
+      "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==",
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^10.3.0",
+        "get-east-asian-width": "^1.0.0",
+        "strip-ansi": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/ink/node_modules/strip-ansi": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz",
+      "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+      }
+    },
+    "node_modules/ink/node_modules/type-fest": {
+      "version": "4.35.0",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-4.35.0.tgz",
+      "integrity": "sha512-2/AwEFQDFEy30iOLjrvHDIH7e4HEWH+f1Yl1bI5XMqzuoCUqwYCdxachgsgv0og/JdVZUhbfjcJAoHj5L1753A==",
+      "license": "(MIT OR CC0-1.0)",
+      "engines": {
+        "node": ">=16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/ink/node_modules/wrap-ansi": {
+      "version": "9.0.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.0.tgz",
+      "integrity": "sha512-G8ura3S+3Z2G+mkgNRq8dqaFZAuxfsxpBB8OCTGRTCtp+l/v9nbFNmCUP1BZMts3G1142MsZfn6eeUKrr4PD1Q==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^6.2.1",
+        "string-width": "^7.0.0",
+        "strip-ansi": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
     "node_modules/internal-slot": {
       "version": "1.0.5",
       "resolved": "https://registry.npmjs.org/internal-slot/-/internal-slot-1.0.5.tgz",
@@ -4761,6 +5317,21 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/is-in-ci": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-in-ci/-/is-in-ci-1.0.0.tgz",
+      "integrity": "sha512-eUuAjybVTHMYWm/U+vBO1sY/JOCgoPCXRxzdju0K+K0BiGW0SChEL1MLC0PoCIR1OlPo5YAp8HuQoUlsWEICwg==",
+      "license": "MIT",
+      "bin": {
+        "is-in-ci": "cli.js"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/is-inside-container": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/is-inside-container/-/is-inside-container-1.0.0.tgz",
@@ -6019,8 +6590,7 @@
     "node_modules/js-tokens": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
-      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
-      "dev": true
+      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ=="
     },
     "node_modules/js-yaml": {
       "version": "4.1.0",
@@ -6210,6 +6780,18 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/loose-envify": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz",
+      "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==",
+      "license": "MIT",
+      "dependencies": {
+        "js-tokens": "^3.0.0 || ^4.0.0"
+      },
+      "bin": {
+        "loose-envify": "cli.js"
+      }
+    },
     "node_modules/lru-cache": {
       "version": "5.1.1",
       "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz",
@@ -6240,6 +6822,13 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/make-error": {
+      "version": "1.3.6",
+      "resolved": "https://registry.npmjs.org/make-error/-/make-error-1.3.6.tgz",
+      "integrity": "sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==",
+      "dev": true,
+      "license": "ISC"
+    },
     "node_modules/makeerror": {
       "version": "1.0.12",
       "resolved": "https://registry.npmjs.org/makeerror/-/makeerror-1.0.12.tgz",
@@ -6293,7 +6882,6 @@
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz",
       "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==",
-      "dev": true,
       "engines": {
         "node": ">=6"
       }
@@ -6477,7 +7065,6 @@
       "version": "5.1.2",
       "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz",
       "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==",
-      "dev": true,
       "dependencies": {
         "mimic-fn": "^2.1.0"
       },
@@ -6592,6 +7179,15 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/patch-console": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/patch-console/-/patch-console-2.0.0.tgz",
+      "integrity": "sha512-0YNdUceMdaQwoKce1gatDScmMo5pu/tfABfnzEqeG0gtTmd7mh/WcwgUjtAeOU7N8nFFlbQBnFK2gXW5fGvmMA==",
+      "license": "MIT",
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      }
+    },
     "node_modules/path-exists": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
@@ -6860,12 +7456,41 @@
         }
       ]
     },
+    "node_modules/react": {
+      "version": "18.3.1",
+      "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz",
+      "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "loose-envify": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/react-is": {
       "version": "18.2.0",
       "resolved": "https://registry.npmjs.org/react-is/-/react-is-18.2.0.tgz",
       "integrity": "sha512-xWGDIW6x921xtzPkhiULtthJHoJvBbF3q26fzloPCK0hsvxtPVelvftw3zjbHWSkR2km9Z+4uxbDDK/6Zw9B8w==",
       "dev": true
     },
+    "node_modules/react-reconciler": {
+      "version": "0.29.2",
+      "resolved": "https://registry.npmjs.org/react-reconciler/-/react-reconciler-0.29.2.tgz",
+      "integrity": "sha512-zZQqIiYgDCTP/f1N/mAR10nJGrPD2ZR+jDSEsKWJHYC7Cm2wodlwbR3upZRdC3cjIjSlTLNVyO7Iu0Yy7t2AYg==",
+      "license": "MIT",
+      "dependencies": {
+        "loose-envify": "^1.1.0",
+        "scheduler": "^0.23.2"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      },
+      "peerDependencies": {
+        "react": "^18.3.1"
+      }
+    },
     "node_modules/rechoir": {
       "version": "0.6.2",
       "resolved": "https://registry.npmjs.org/rechoir/-/rechoir-0.6.2.tgz",
@@ -7077,6 +7702,15 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/scheduler": {
+      "version": "0.23.2",
+      "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.23.2.tgz",
+      "integrity": "sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==",
+      "license": "MIT",
+      "dependencies": {
+        "loose-envify": "^1.1.0"
+      }
+    },
     "node_modules/semver": {
       "version": "7.5.4",
       "resolved": "https://registry.npmjs.org/semver/-/semver-7.5.4.tgz",
@@ -7193,8 +7827,7 @@
     "node_modules/signal-exit": {
       "version": "3.0.7",
       "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz",
-      "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==",
-      "dev": true
+      "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ=="
     },
     "node_modules/sisteransi": {
       "version": "1.0.5",
@@ -7257,7 +7890,6 @@
       "version": "2.0.6",
       "resolved": "https://registry.npmjs.org/stack-utils/-/stack-utils-2.0.6.tgz",
       "integrity": "sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ==",
-      "dev": true,
       "dependencies": {
         "escape-string-regexp": "^2.0.0"
       },
@@ -7269,7 +7901,6 @@
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-2.0.0.tgz",
       "integrity": "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w==",
-      "dev": true,
       "engines": {
         "node": ">=8"
       }
@@ -7513,6 +8144,50 @@
         "node": ">=8.0"
       }
     },
+    "node_modules/ts-node": {
+      "version": "10.9.2",
+      "resolved": "https://registry.npmjs.org/ts-node/-/ts-node-10.9.2.tgz",
+      "integrity": "sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@cspotcode/source-map-support": "^0.8.0",
+        "@tsconfig/node10": "^1.0.7",
+        "@tsconfig/node12": "^1.0.7",
+        "@tsconfig/node14": "^1.0.0",
+        "@tsconfig/node16": "^1.0.2",
+        "acorn": "^8.4.1",
+        "acorn-walk": "^8.1.1",
+        "arg": "^4.1.0",
+        "create-require": "^1.1.0",
+        "diff": "^4.0.1",
+        "make-error": "^1.1.1",
+        "v8-compile-cache-lib": "^3.0.1",
+        "yn": "3.1.1"
+      },
+      "bin": {
+        "ts-node": "dist/bin.js",
+        "ts-node-cwd": "dist/bin-cwd.js",
+        "ts-node-esm": "dist/bin-esm.js",
+        "ts-node-script": "dist/bin-script.js",
+        "ts-node-transpile-only": "dist/bin-transpile.js",
+        "ts-script": "dist/bin-script-deprecated.js"
+      },
+      "peerDependencies": {
+        "@swc/core": ">=1.2.50",
+        "@swc/wasm": ">=1.2.50",
+        "@types/node": "*",
+        "typescript": ">=2.7"
+      },
+      "peerDependenciesMeta": {
+        "@swc/core": {
+          "optional": true
+        },
+        "@swc/wasm": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/tsconfig-paths": {
       "version": "3.14.2",
       "resolved": "https://registry.npmjs.org/tsconfig-paths/-/tsconfig-paths-3.14.2.tgz",
@@ -7833,6 +8508,13 @@
         "uuid": "dist/bin/uuid"
       }
     },
+    "node_modules/v8-compile-cache-lib": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz",
+      "integrity": "sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/v8-to-istanbul": {
       "version": "9.1.0",
       "resolved": "https://registry.npmjs.org/v8-to-istanbul/-/v8-to-istanbul-9.1.0.tgz",
@@ -7924,6 +8606,71 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/widest-line": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/widest-line/-/widest-line-5.0.0.tgz",
+      "integrity": "sha512-c9bZp7b5YtRj2wOe6dlj32MK+Bx/M/d+9VB2SHM1OtsUHR0aV0tdP6DWh/iMt0kWi1t5g1Iudu6hQRNd1A4PVA==",
+      "license": "MIT",
+      "dependencies": {
+        "string-width": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/widest-line/node_modules/ansi-regex": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.1.0.tgz",
+      "integrity": "sha512-7HSX4QQb4CspciLpVFwyRe79O3xsIZDDLER21kERQ71oaPodF8jL725AgJMFAYbooIqolJoRLuM81SpeUkpkvA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+      }
+    },
+    "node_modules/widest-line/node_modules/emoji-regex": {
+      "version": "10.4.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.4.0.tgz",
+      "integrity": "sha512-EC+0oUMY1Rqm4O6LLrgjtYDvcVYTy7chDnM4Q7030tP4Kwj3u/pR6gP9ygnp2CJMK5Gq+9Q2oqmrFJAz01DXjw==",
+      "license": "MIT"
+    },
+    "node_modules/widest-line/node_modules/string-width": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz",
+      "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==",
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^10.3.0",
+        "get-east-asian-width": "^1.0.0",
+        "strip-ansi": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/widest-line/node_modules/strip-ansi": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz",
+      "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+      }
+    },
     "node_modules/wrap-ansi": {
       "version": "6.2.0",
       "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-6.2.0.tgz",
@@ -7957,6 +8704,27 @@
         "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
       }
     },
+    "node_modules/ws": {
+      "version": "8.18.0",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.18.0.tgz",
+      "integrity": "sha512-8VbfWfHLbbwu3+N6OKsOMpBdT4kXPDDB9cJk2bJ6mh9ucxdlnNvH1e+roYkKmN9Nxw2yjz7VzeO9oOz2zJ04Pw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/xml": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/xml/-/xml-1.0.1.tgz",
@@ -8005,6 +8773,16 @@
         "node": ">=12"
       }
     },
+    "node_modules/yn": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/yn/-/yn-3.1.1.tgz",
+      "integrity": "sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
     "node_modules/yocto-queue": {
       "version": "0.1.0",
       "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz",
@@ -8016,6 +8794,12 @@
       "funding": {
         "url": "https://github.com/sponsors/sindresorhus"
       }
+    },
+    "node_modules/yoga-wasm-web": {
+      "version": "0.3.3",
+      "resolved": "https://registry.npmjs.org/yoga-wasm-web/-/yoga-wasm-web-0.3.3.tgz",
+      "integrity": "sha512-N+d4UJSJbt/R3wqY7Coqs5pcV0aUj2j9IaQ3rNj9bVCLld8tTGKRa2USARjnvZJWVx1NDmQev8EknoczaOQDOA==",
+      "license": "MIT"
     }
   }
-}
+}
\ No newline at end of file
diff --git a/package.json b/package.json
index a64b749..00712b6 100644
--- a/package.json
+++ b/package.json
@@ -59,4 +59,4 @@
     "typedoc": "^0.24.8",
     "typescript": "^5.1.6"
   }
-}
+}
\ No newline at end of file
diff --git a/spans.json b/spans.json
new file mode 100644
index 0000000..4cf022c
--- /dev/null
+++ b/spans.json
@@ -0,0 +1,57 @@
+[
+  {
+    "spanId": "span-1740997147711-c4j4n",
+    "name": "Root Span",
+    "startTime": 1740997147711,
+    "endTime": 1740997155715,
+    "parentSpanId": null,
+    "isCompleted": true,
+    "children": [
+      {
+        "spanId": "span-1740997148715-wle8c",
+        "name": "Parent span ends earlier",
+        "startTime": 1740997148715,
+        "endTime": 1740997150717,
+        "parentSpanId": "span-1740997147711-c4j4n",
+        "isCompleted": true,
+        "children": []
+      },
+      {
+        "spanId": "span-1740997149716-2u7wc",
+        "name": "Forking",
+        "startTime": 1740997149716,
+        "endTime": 1740997153718,
+        "parentSpanId": "span-1740997147711-c4j4n",
+        "isCompleted": true,
+        "children": []
+      }
+    ]
+  },
+  {
+    "spanId": "span-1740997148715-wle8c",
+    "name": "Parent span ends earlier",
+    "startTime": 1740997148715,
+    "endTime": 1740997150717,
+    "parentSpanId": "span-1740997147711-c4j4n",
+    "isCompleted": true,
+    "children": []
+  },
+  {
+    "spanId": "span-1740997149716-2u7wc",
+    "name": "Forking",
+    "startTime": 1740997149716,
+    "endTime": 1740997153718,
+    "parentSpanId": "span-1740997147711-c4j4n",
+    "isCompleted": true,
+    "children": []
+  },
+  {
+    "spanId": "span-1740997150715-7a1qz",
+    "name": "Orphan",
+    "startTime": 1740997150715,
+    "endTime": 1740997154717,
+    "parentSpanId": null,
+    "isCompleted": true,
+    "children": []
+  }
+]
\ No newline at end of file
diff --git a/src/Logger.ts b/src/Logger.ts
index 8281bb4..118b282 100644
--- a/src/Logger.ts
+++ b/src/Logger.ts
@@ -3,6 +3,8 @@ import type Handler from './Handler.js';
 import { LogLevel } from './types.js';
 import ConsoleErrHandler from './handlers/ConsoleErrHandler.js';
 import * as utils from './utils.js';
+import { openSpan, closeSpan } from "./lib/tracingManager.js";
+
 
 class Logger {
   public readonly key: string;
@@ -107,89 +109,84 @@ class Logger {
     delete this.filter;
   }
 
-  public debug(msg?: ToString, format?: LogFormatter): void;
-  public debug(
-    msg: ToString | undefined,
-    data: LogData,
-    format?: LogFormatter,
-  ): void;
-  public debug(
-    msg?: ToString,
-    formatOrData?: LogFormatter | LogData,
-    format?: LogFormatter,
-  ): void {
-    if (formatOrData == null || typeof formatOrData === 'function') {
-      return this.log(msg, {}, LogLevel.DEBUG, formatOrData as LogFormatter);
-    } else {
-      return this.log(msg, formatOrData, LogLevel.DEBUG, format);
-    }
+    public debug(
+      msg?: ToString,
+      formatOrData?: LogFormatter | LogData,
+      format?: LogFormatter,
+      parentSpanId?: string | undefined
+  ): string {
+      if (formatOrData == null || typeof formatOrData === 'function') {
+          return this.log(msg, {}, LogLevel.DEBUG, formatOrData as LogFormatter, parentSpanId);
+      } else {
+          return this.log(msg, formatOrData, LogLevel.DEBUG, format, parentSpanId);
+      }
   }
 
-  public info(msg?: ToString, format?: LogFormatter): void;
-  public info(
-    msg: ToString | undefined,
-    data: LogData,
-    format?: LogFormatter,
-  ): void;
+
   public info(
     msg?: ToString,
     formatOrData?: LogFormatter | LogData,
     format?: LogFormatter,
-  ): void {
+    parentSpanId?: string | undefined
+  ): string {
     if (formatOrData == null || typeof formatOrData === 'function') {
-      return this.log(msg, {}, LogLevel.INFO, formatOrData as LogFormatter);
+        return this.log(msg, {}, LogLevel.INFO, formatOrData as LogFormatter, parentSpanId);
     } else {
-      return this.log(msg, formatOrData, LogLevel.INFO, format);
+        return this.log(msg, formatOrData, LogLevel.INFO, format, parentSpanId);
     }
   }
 
-  public warn(msg?: ToString, format?: LogFormatter): void;
-  public warn(
-    msg: ToString | undefined,
-    data: LogData,
-    format?: LogFormatter,
-  ): void;
-  public warn(
-    msg?: ToString,
-    formatOrData?: LogFormatter | LogData,
-    format?: LogFormatter,
-  ): void {
-    if (formatOrData == null || typeof formatOrData === 'function') {
-      return this.log(msg, {}, LogLevel.WARN, formatOrData as LogFormatter);
-    } else {
-      return this.log(msg, formatOrData, LogLevel.WARN, format);
-    }
+
+
+    public warn(
+      msg?: ToString,
+      formatOrData?: LogFormatter | LogData,
+      format?: LogFormatter,
+      parentSpanId?: string | undefined
+  ): string {
+      if (formatOrData == null || typeof formatOrData === 'function') {
+          return this.log(msg, {}, LogLevel.WARN, formatOrData as LogFormatter, parentSpanId);
+      } else {
+          return this.log(msg, formatOrData, LogLevel.WARN, format, parentSpanId);
+      }
   }
 
-  public error(msg?: ToString, format?: LogFormatter): void;
-  public error(
-    msg: ToString | undefined,
-    data: LogData,
-    format?: LogFormatter,
-  ): void;
-  public error(
-    msg?: ToString,
-    formatOrData?: LogFormatter | LogData,
-    format?: LogFormatter,
-  ): void {
-    if (formatOrData == null || typeof formatOrData === 'function') {
-      return this.log(msg, {}, LogLevel.ERROR, formatOrData as LogFormatter);
-    } else {
-      return this.log(msg, formatOrData, LogLevel.ERROR, format);
-    }
+
+
+    public error(
+      msg?: ToString,
+      formatOrData?: LogFormatter | LogData,
+      format?: LogFormatter,
+      parentSpanId?: string | undefined
+  ): string {
+      if (formatOrData == null || typeof formatOrData === 'function') {
+          return this.log(msg, {}, LogLevel.ERROR, formatOrData as LogFormatter, parentSpanId);
+      } else {
+          return this.log(msg, formatOrData, LogLevel.ERROR, format, parentSpanId);
+      }
   }
 
+
+
   protected log(
     msg: ToString | undefined,
     data: LogData,
     level: LogLevel,
     format?: LogFormatter,
-  ): void {
+    parentSpanId?: string // Optional parent span
+): string {
     // Filter on level before making a record
-    if (level < this.getEffectiveLevel()) return;
+    if (level < this.getEffectiveLevel()) return "";
+
+    const spanId = openSpan(msg?.toString() || 'Log Event', parentSpanId);
+
     const record = this.makeRecord(msg, data, level);
     this.callHandlers(record, level, format);
-  }
+
+    closeSpan(spanId);
+    return spanId
+}
+
 
   /**
    * Constructs a `LogRecord`
diff --git a/src/bin/SpanTree.tsx b/src/bin/SpanTree.tsx
new file mode 100644
index 0000000..6da8b5c
--- /dev/null
+++ b/src/bin/SpanTree.tsx
@@ -0,0 +1,112 @@
+import React, { FC } from 'react';
+import { Box, Text } from 'ink';
+import { Span } from "../lib/span.js";
+
+// Props for handling both root and child spans
+interface SpanTreeProps {
+  spans: Span[];
+  sampleMode: string;
+}
+
+/**
+ * Sort spans based on the selected sampling mode.
+ */
+const sortSpans = (spans: Span[], mode: string): Span[] => {
+  if (mode === "logical") {
+    const spanMap = new Map<string, Span>();
+
+    // Step 1: Convert raw objects to Span instances
+    spans.forEach(span => {
+      if (!spanMap.has(span.spanId)) {
+        const newSpan = new Span(span.name, span.parentSpanId);
+        Object.assign(newSpan, span);
+        newSpan.children = [];
+        spanMap.set(span.spanId, newSpan);
+      }
+    });
+
+    const rootSpans: Span[] = [];
+
+    // Step 2: Link children to parents
+    spans.forEach(span => {
+      if (span.parentSpanId && spanMap.has(span.parentSpanId)) {
+        spanMap.get(span.parentSpanId)!.children.push(spanMap.get(span.spanId)!);
+      }
+    });
+
+    // Step 3: Collect only true root spans (avoiding duplicates)
+    spans.forEach(span => {
+      if (!span.parentSpanId) {
+        const rootSpan = spanMap.get(span.spanId);
+        if (rootSpan) {
+          rootSpans.push(rootSpan);
+        }
+      }
+    });
+
+    return rootSpans;
+  } else {
+    return spans
+      .map(span => new Span(span.name, span.parentSpanId)) // Convert to Span instances
+      .sort((a, b) => a.startTime - b.startTime); // Sort purely by start time
+  }
+};
+
+
+/**
+ * **Recursive Renderer**
+ * - Uses box-drawing characters (│ ├ └) for structured layout.
+ */
+const RecursiveSpanTree: FC<{ span: Span; prefix: string; isLastChild: boolean }> = ({
+  span,
+  prefix,
+  isLastChild,
+}) => {
+  const connector = isLastChild ? '└── ' : '├── ';
+  const newPrefix = prefix + (isLastChild ? '    ' : '│   '); // Maintain vertical structure
+
+  return (
+    <Box flexDirection="column">
+      <Text>
+        {prefix}
+        {connector}
+        {span.name}
+      </Text>
+
+      {span.children.map((child, idx) => (
+        <RecursiveSpanTree
+          key={child.spanId}
+          span={child}
+          prefix={newPrefix}
+          isLastChild={idx === span.children.length - 1}
+        />
+      ))}
+    </Box>
+  );
+};
+
+/**
+ * **Main Component** (Sorts & Passes Data)
+ */
+const SpanTree: FC<SpanTreeProps> = ({ spans, sampleMode }) => {
+  const sortedSpans = sortSpans(spans, sampleMode);
+
+  return (
+    <Box flexDirection="column">
+      {sortedSpans.length === 0 ? (
+        <Text>No spans to display</Text>
+      ) : (
+        sortedSpans.map((span, idx) => (
+          <RecursiveSpanTree
+            key={span.spanId}
+            span={span}
+            prefix=""
+            isLastChild={idx === sortedSpans.length - 1}
+          />
+        ))
+      )}
+    </Box>
+  );
+};
+
+export default SpanTree;
diff --git a/src/bin/TimeLineView.tsx b/src/bin/TimeLineView.tsx
new file mode 100644
index 0000000..e709d27
--- /dev/null
+++ b/src/bin/TimeLineView.tsx
@@ -0,0 +1,111 @@
+// TimelineView.tsx
+import React, { FC } from 'react';
+import { Box, Text } from 'ink';
+
+interface Span {
+  spanId: string;
+  name: string;
+  parentSpanId: string | null;
+  startTime: number;
+  endTime: number | null;
+}
+
+// We make each row = 1000 ms
+const TIME_STEP_MS = 1000;
+
+function timeToRow(timeMs: number, baseTimeMs: number) {
+  return Math.floor((timeMs - baseTimeMs) / TIME_STEP_MS);
+}
+
+function assignLanes(spans: Span[]): Map<string, number> {
+  // Sort spans by startTime ascending
+  const sorted = [...spans].sort((a, b) => a.startTime - b.startTime);
+  const laneMap = new Map<string, number>();
+  const laneEndTime: number[] = [];
+
+  for (const span of sorted) {
+    let assignedLane = -1;
+    for (let i = 0; i < laneEndTime.length; i++) {
+      if (laneEndTime[i] <= span.startTime) {
+        assignedLane = i;
+        break;
+      }
+    }
+    if (assignedLane < 0) {
+      assignedLane = laneEndTime.length;
+      laneEndTime.push(0);
+    }
+    laneMap.set(span.spanId, assignedLane);
+
+    const realEnd = span.endTime ?? (span.startTime + 3000);
+    laneEndTime[assignedLane] = Math.max(laneEndTime[assignedLane], realEnd);
+  }
+  return laneMap;
+}
+
+const TimelineView: FC<{ spans: Span[] }> = ({ spans }) => {
+  if (!spans.length) {
+    return <Text>No spans</Text>;
+  }
+
+  const laneMap = assignLanes(spans);
+  let earliest = Math.min(...spans.map(s => s.startTime));
+  let latest = Math.max(...spans.map(s => s.endTime ?? (s.startTime + 3000)));
+
+  // Round earliest down
+  earliest = Math.floor(earliest / TIME_STEP_MS) * TIME_STEP_MS;
+  const maxLane = Math.max(...laneMap.values());
+  const rowCount = 1 + timeToRow(latest, earliest);
+
+  // Initialize a 2D grid: rowCount rows x (maxLane+1) lanes
+  const grid: string[][] = Array.from({ length: rowCount }, () =>
+    Array(maxLane + 1).fill('   ')
+  );
+
+  // Fill each lane with vertical bars and optional slash
+  for (const span of spans) {
+    const lane = laneMap.get(span.spanId)!;
+    const startRow = timeToRow(span.startTime, earliest);
+    const endRow = timeToRow(span.endTime ?? span.startTime + 3000, earliest);
+
+    // Vertical bars
+    for (let r = startRow; r <= endRow; r++) {
+      grid[r][lane] = ' | ';
+    }
+
+    // Insert the span name at the start row
+    grid[startRow][lane] = grid[startRow][lane].replace(' | ', ` | (${span.name})`);
+
+    // If parent ended earlier, place a slash
+    if (span.parentSpanId) {
+      const parent = spans.find(s => s.spanId === span.parentSpanId);
+      if (parent) {
+        const parentLane = laneMap.get(parent.spanId)!;
+        const parentEnd = timeToRow(parent.endTime ?? parent.startTime, earliest);
+
+        if (parentLane !== lane || parentEnd < endRow) {
+          if (parentLane < lane) {
+            grid[parentEnd][parentLane] = '  \\';
+          } else if (parentLane > lane) {
+            grid[parentEnd][parentLane] = ' / ';
+          }
+        }
+      }
+    }
+  }
+
+  const lines = grid.map(cols => cols.join(''));
+
+  return (
+    <Box flexDirection="column">
+      {lines.map((line, idx) => (
+        <Box key={idx}>
+          <Text>{line}</Text>
+        </Box>
+      ))}
+    </Box>
+  );  
+};
+
+export default TimelineView;
+
diff --git a/src/bin/cli.tsx b/src/bin/cli.tsx
new file mode 100644
index 0000000..4bb6af3
--- /dev/null
+++ b/src/bin/cli.tsx
@@ -0,0 +1,60 @@
+import React, { useEffect, useState } from 'react';
+import { render, Box, Text } from 'ink';
+import fs from 'fs';
+import SpanTree from './SpanTree.js';
+import { Span } from '../lib/span.js';
+
+const SPAN_FILE = 'spans.json';
+
+
+const sampleArgIndex = process.argv.indexOf("--sample");
+const sampleMode =
+  sampleArgIndex !== -1 && process.argv.length > sampleArgIndex + 1
+    ? process.argv[sampleArgIndex + 1].trim() === "logical"
+      ? "logical"
+      : "time"
+    : "time"; 
+
+console.log(`Received CLI arguments: ${process.argv.join(" ")}`);
+console.log(`Running in ${sampleMode} mode`);
+
+
+function loadSpans(): Span[] {
+  if (!fs.existsSync(SPAN_FILE)) return [];
+  return JSON.parse(fs.readFileSync(SPAN_FILE, 'utf8'));
+}
+
+const App = () => {
+  const [spans, setSpans] = useState<Span[]>([]);
+
+  useEffect(() => {
+    const id = setInterval(() => {
+      setSpans(loadSpans());
+    }, 1000);
+
+    const handleExit = () => {
+      console.log("Stopping CLI...");
+      clearInterval(id);
+      process.exit(0);
+    };
+
+    process.on("SIGINT", handleExit);
+    process.on("SIGTERM", handleExit);
+
+    return () => clearInterval(id);
+  }, []);
+
+  return (
+    <Box flexDirection="column">
+      <Text color="cyan">Real-Time Concurrency Timeline ({sampleMode}-based)</Text>
+      <Box height={1} />
+      {spans.length > 0 ? (
+        <SpanTree spans={spans} sampleMode={sampleMode} />
+      ) : (
+        <Text>No spans available</Text>
+      )}
+    </Box>
+  );
+};
+
+render(<App />);
diff --git a/src/bin/simple-cli.tsx b/src/bin/simple-cli.tsx
new file mode 100644
index 0000000..70c0a08
--- /dev/null
+++ b/src/bin/simple-cli.tsx
@@ -0,0 +1,7 @@
+import { getTraceJSON } from "../lib/tracingManager.js";
+
+setInterval(() => {
+    console.clear();
+    console.log("🚀 Live Spans (Tail Mode):\n");
+    console.log(getTraceJSON());
+}, 1000);
diff --git a/src/index.ts b/src/index.ts
index 2bb7f2e..e880460 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -4,3 +4,6 @@ export * as formatting from './formatting.js';
 export * from './handlers/index.js';
 export * from './utils.js';
 export * from './types.js';
+export { Span } from "./lib/span.js";
+export { openSpan, closeSpan, getTraceJSON } from "./lib/tracingManager.js";
+
diff --git a/src/lib/span.ts b/src/lib/span.ts
new file mode 100644
index 0000000..a1a6cf2
--- /dev/null
+++ b/src/lib/span.ts
@@ -0,0 +1,38 @@
+export class Span {
+    spanId: string;
+    name: string;
+    startTime: number;
+    endTime: number | null;
+    parentSpanId: string | null;
+    children: Span[];
+
+    constructor(name: string, parentSpanId: string | null = null) {
+        this.spanId = `span-${Date.now()}-${Math.random().toString(36).substr(2, 5)}`;
+        this.name = name;
+        this.startTime = Date.now();
+        this.endTime = null;
+        this.parentSpanId = parentSpanId;
+        this.children = [];
+    }
+
+    close(): void {
+        this.endTime = Date.now();
+    }
+
+    isCompleted(): boolean {
+        return this.endTime !== null;
+    }
+
+    // Convert span object to JSON-friendly format
+    toJSON(): Record<string, any> {
+        return {
+            spanId: this.spanId,
+            name: this.name,
+            startTime: this.startTime,
+            endTime: this.endTime,
+            parentSpanId: this.parentSpanId,
+            isCompleted: this.isCompleted(),
+            children: this.children.map(child => child.toJSON())
+        };
+    }
+}
diff --git a/src/lib/tracingManager.ts b/src/lib/tracingManager.ts
new file mode 100644
index 0000000..a167d7a
--- /dev/null
+++ b/src/lib/tracingManager.ts
@@ -0,0 +1,104 @@
+import { Span } from "../lib/span.js";
+import fs from "fs";
+
+const SPAN_FILE = "spans.json";
+
+const activeSpans: Record<string, Span> = {};
+
+/**
+ * Opens a new span and associates it with a parent (if provided).
+ * @param name - Name of the span.
+ * @param parentSpanId - (Optional) ID of the parent span.
+ * @returns The unique ID of the created span.
+ */
+
+function saveSpansToFile() {
+    fs.writeFileSync(SPAN_FILE, JSON.stringify(Object.values(activeSpans), null, 2));
+}
+
+export function openSpan(name: string, parentSpanId: string | null = null): string {
+    const newSpan = new Span(name, parentSpanId);
+    activeSpans[newSpan.spanId] = newSpan;
+
+    saveSpansToFile(); 
+
+    console.log("Opened span:", newSpan);
+
+    // If it's a child span, add it to the parent
+    if (parentSpanId && activeSpans[parentSpanId]) {
+        activeSpans[parentSpanId].children.push(newSpan);
+    }
+
+    return newSpan.spanId;
+}
+
+/**
+ * Closes a span by marking its end time.
+ * @param spanId - The ID of the span to close.
+ * @returns The completed span or null if the span doesn't exist.
+ */
+export function closeSpan(spanId: string): Span | null {
+    if (activeSpans[spanId]) {
+        activeSpans[spanId].close();
+        saveSpansToFile();
+        console.log("Closed span:", activeSpans[spanId]);
+        return activeSpans[spanId];
+    }
+    return null;
+}
+
+/**
+ * Retrieves all active spans.
+ * @returns An array of active spans.
+ */
+
+export function getActiveSpans(): Span[] {
+    console.log("Checking Active Spans at Time:", Date.now());
+
+    if (fs.existsSync(SPAN_FILE)) {
+        const fileData = fs.readFileSync(SPAN_FILE, "utf8");
+        const rawSpans = JSON.parse(fileData);
+
+        function reconstructSpan(spanData: any): Span {
+
+            delete spanData.isCompleted;
+
+            const reconstructedSpan = Object.assign(
+                new Span(spanData.name, spanData.parentSpanId),
+                spanData
+            );
+            reconstructedSpan.children = (spanData.children || []).map(reconstructSpan);
+            return reconstructedSpan;
+        }
+
+        return rawSpans.map(reconstructSpan);
+    }
+
+    console.log("Stored Active Spans:", Object.values(activeSpans));
+    return Object.values(activeSpans);
+}
+
+
+
+/**
+ * Retrieves the entire trace structure as JSON.
+ * @returns JSON representation of all spans.
+ */
+export function getTraceJSON(): string {
+    const activeSpans = getActiveSpans();
+
+    console.log("Debug: Active Spans Before JSON Conversion:", activeSpans);
+
+    return JSON.stringify(
+        activeSpans.map(span => span.toJSON()),
+        null,
+        2
+    );
+}
+
+
+
+
+
+
+
diff --git a/tests/asciinemaTest.ts b/tests/asciinemaTest.ts
new file mode 100644
index 0000000..992132e
--- /dev/null
+++ b/tests/asciinemaTest.ts
@@ -0,0 +1,44 @@
+import { openSpan, closeSpan } from '../src/lib/tracingManager.js';
+
+// 1) Root Span: starts at t=0, ends at t=8000ms
+const rootSpanId = openSpan('Root Span');
+console.log('Opened Root Span:', rootSpanId);
+
+// 2) Start a child “Parent span ends earlier” at t=1000ms, end at t=3000ms
+setTimeout(() => {
+  const earlyChildId = openSpan('Parent span ends earlier', rootSpanId);
+  console.log('Opened early child:', earlyChildId);
+
+  setTimeout(() => {
+    closeSpan(earlyChildId);
+    console.log('Closed early child:', earlyChildId);
+  }, 2000);
+}, 1000);
+
+// 3) Another child “Forking” at t=2000ms, ends at t=6000ms
+setTimeout(() => {
+  const forkingId = openSpan('Forking', rootSpanId);
+  console.log('Opened Forking child:', forkingId);
+
+  setTimeout(() => {
+    closeSpan(forkingId);
+    console.log('Closed Forking child:', forkingId);
+  }, 4000);
+}, 2000);
+
+// 4) An “Orphan” (no parent) at t=3000ms, ends at t=7000ms
+setTimeout(() => {
+  const orphanId = openSpan('Orphan', null);
+  console.log('Opened Orphan:', orphanId);
+
+  setTimeout(() => {
+    closeSpan(orphanId);
+    console.log('Closed Orphan:', orphanId);
+  }, 4000);
+}, 3000);
+
+// Finally, close root at t=8000ms
+setTimeout(() => {
+  closeSpan(rootSpanId);
+  console.log('Closed Root Span:', rootSpanId);
+}, 8000);
diff --git a/tsconfig.json b/tsconfig.json
index 0eeb862..28138ae 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -1,5 +1,6 @@
 {
   "compilerOptions": {
+    "jsx": "react-jsx",
     "outDir": "./dist",
     "tsBuildInfoFile": "./dist/tsbuildinfo",
     "incremental": true,
@@ -13,7 +14,7 @@
     "resolveJsonModule": true,
     "isolatedModules": true,
     "moduleResolution": "NodeNext",
-    "module": "ESNext",
+    "module": "NodeNext",
     "target": "ES2022",
     "baseUrl": "./src",
     "paths": {