TechScript v1.0.5 - High Performance Rust Engine & Enhanced Visuals (Sanitized)

Author: Tanmoy

.gitignore

@@ -0,0 +1,39 @@
+# Contributing to TechScript
+
+Thank you for your interest in TechScript!
+
+TechScript is natively written in Rust. The project is structured as a standard Cargo Workspace.
+
+## Project Structure
+
+* `crates/techscript-core/`: The core library. Contains Lexer, Parser, AST, Compiler, VM, Builtins, and standard library (`stdlib/`).
+* `crates/techscript-cli/`: The `tech` binary. Includes runner, REPL, formatter, linter, package manager (`tech install`), and testing framework (`tech test`).
+* `crates/techscript-lsp/`: Language Server Protocol implementation for IDEs (like VSCode).
+* `vscode-extension/`: The official Visual Studio Code syntax highlighting and snippet extension.
+
+## Building from Source
+
+Prerequisites:
+- [Rust toolchain](https://rustup.rs/) (stable)
+
+```bash
+git clone https://github.com/techscript/techscript.git
+cd techscript
+
+# Build the workspace
+cargo build --release
+
+# Run the test suite
+cargo test --workspace
+```
+
+## Creating Pull Requests
+
+1. Fork the repository
+2. Create a new feature branch (`git checkout -b feature/cool-idea`)
+3. Make your changes in the respective `.rs` files.
+4. Add tests to `crates/techscript-core/tests/` (we use snapshot testing).
+5. Run `cargo fmt` and `cargo clippy`.
+6. Submit your PR!
+
+All PRs must pass the GitHub Actions CI pipeline which runs formatting, linting, and full tests across Linux, Windows, and macOS.

CONTRIBUTOR_GUIDE.md

@@ -0,0 +1,95 @@
+# TechScript Language Specification (v1.0.5)
+
+TechScript is a highly readable, dynamically typed but gradually typed, system-level scripting language written in pure Rust.
+
+## Types
+
+TechScript supports the following native data types:
+* `int`: 64-bit signed integer (`42`, `0xFF`, `0b1010`)
+* `float`: 64-bit floating point (`3.14`)
+* `string`: UTF-8 string, optionally f-strings (`"Hello"`, `f"Hello {name}"`)
+* `bool`: Boolean (`true` or `false`)
+* `none`: The null type (`none`)
+* `list`: dynamic array (`[1, 2, 3]`)
+* `map`: hash map (`{"key": "value"}`)
+* `function`: First-class callable objects
+* `class`, `instance`: Object-oriented constructs
+
+## Core Syntax
+
+### Variables
+```techscript
+make x = 10         # Mutable by default
+keep PI = 3.1415    # Immutable constant
+make y: int = 20    # Gradual typing annotation
+```
+
+### Functions
+```techscript
+build greeting(name: string) {
+    say f"Hello, {name}!"
+    send true
+}
+```
+
+### Async & Concurrency
+```techscript
+async build fetch_data() {
+    # Async background logic
+}
+make data = await fetch_data()
+
+# Fire and forget concurrent thread
+spawn fetch_data()
+```
+
+### Control Flow
+```techscript
+when x > 10 {
+    say "Large"
+} elif x == 10 {
+    say "Exact"
+} else {
+    say "Small"
+}
+
+repeat x < 20 {
+    x = x + 1
+}
+
+each item in [1, 2, 3] {
+    say item
+}
+```
+
+### Pattern Matching
+```techscript
+match value {
+    case 1 { say "One" }
+    case 2 { say "Two" }
+    case _ { say "Other" }
+}
+```
+
+### Object Oriented
+```techscript
+model Person {
+    build init(self, name) {
+        self.name = name
+    }
+    build greet(self) {
+        say f"Hi, I am {self.name}"
+    }
+}
+```
+
+### Error Handling
+```techscript
+attempt {
+    make content = read_file("missing.txt")
+} catch error {
+    say f"Failed: {error}"
+} finally {
+    say "Cleanup"
+}
+```

LANGUAGE_SPEC.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TechScript Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.