V12 JavaScript/TypeScript Runtime

Please mind that this is currently in development! It is not fast like bun, widely supported like node, im still working on making it better!

TODO: Add support for imports es5 and es6

Table of Contents

• Description
• Features
• Prerequisites
• Usage
• Project Structure
• Example
• Installation
• Contributing
• License

Description

V12 is a Rust-based engine designed to process and execute JavaScript and TypeScript files. It uses the Boa JavaScript engine for script execution and provides a simple interface for running scripts and displaying information about the engine.

Features

• TypeScript to JavaScript Conversion: Strips TypeScript types and converts .ts files to .js files.
• JavaScript Execution: Executes JavaScript files using the Boa engine.
• Temporary File Management: Creates and deletes temporary JavaScript files generated from TypeScript files.
• Engine Information: Displays information about the V12 engine.
• Debugger: Provides a simple debugger for debugging JavaScript files. Just add the word debug to the end of your V12 command!

V12 examples/test.ts debug

Prerequisites

• Rust (latest stable version)
• Cargo (latest stable version)

Usage

1. Run a JavaScript file:

   cargo run path/to/yourfile.js

2. Run a TypeScript file:

   cargo run path/to/yourfile.ts

3. Display engine information:

   cargo run version

Project Structure

• src/main.rs: Entry point of the application.
• src/engine/engine.rs: Contains the Engine struct and methods for running and interpreting JavaScript.
• src/utils/typescript.rs: Functions for processing TypeScript files.
• src/utils/helper.rs: Helper functions for utils and more.
• src/utils/logutil.rs: Log util for debugging and logging on V12. (Not the JS/TS being executed)

Example

cargo run examples/test.ts

Installation

1. Clone the repository:

   git clone https://github.com/Thoq-jar/V12.git
   cd V12

2. Build the project:

3. cargo build --release

4. Add the executable generated in target/release to your path and reload terminal!

5. Run v12 version or V12 version to confim its installed!

Linux/macOS only install:

rm -rf V12
git clone https://github.com/Thoq-jar/V12.git
cd V12
cargo build --release
sudo rm -rf /usr/local/bin/V12
sudo rm -rf /usr/local/bin/v12
sudo cp target/release/V12 /usr/local/bin/V12
sudo cp target/release/V12 /usr/local/bin/v12
cd ..
rm -rf V12

Contributing

1. Fork the repository.
2. Create a new branch (git checkout -b feature-branch).
3. Commit your changes (git commit -am 'Add new feature').
4. Push to the branch (git push origin feature-branch).
5. Create a new Pull Request.

License

This project is licensed under the MIT License. See the LICENSE file for details.