t-ruby 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a2d09e81c109f428cb4a54a04ccc0452d250a9eff67b7b9adac4e6fac6820f42
+  data.tar.gz: 0aee866da3cc83444597f253e6fc64efad43eb06b967ab4b082acf4c70650030
+SHA512:
+  metadata.gz: ffd79b3ed0fb4add13d728b27f3f4d0d3a222d39fdfecd73dda352bdec084a7dcc85aabc7f761565afacc73fe3eae839bd7b45a53a83c9010fb45ed10956d173
+  data.tar.gz: 6ed1a4d1f6fb88b8872f8db14b9519875689583221257f9e45ffebf35b1d4d80e17c2482d11392a1167a9cf7f1ad27535cd55cfb59476afee35e2baea2f28955

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 type-ruby
+
+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.

data/README.md

@@ -0,0 +1,221 @@
+<p align="center">
+  <img src="https://avatars.githubusercontent.com/u/248530250" alt="T-Ruby" height="170">
+</p>
+
+<h1 align="center">T-Ruby</h1>
+
+<p align="center">
+  <strong>TypeScript-style types for Ruby</strong>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/CI-passing-brightgreen" alt="CI: passing" />
+  <img src="https://img.shields.io/badge/ruby-3.0+-cc342d" alt="Ruby 3.0+" />
+  <img src="https://img.shields.io/badge/gem-v0.1.0-blue" alt="Gem: v0.1.0" />
+  <img src="https://img.shields.io/badge/downloads-0-lightgrey" alt="Downloads" />
+  <img src="https://img.shields.io/badge/coverage-90%25-brightgreen" alt="Coverage: 90%" />
+</p>
+
+<p align="center">
+  <a href="#install">Install</a>
+  &nbsp;&nbsp;•&nbsp;&nbsp;
+  <a href="#quick-start">Quick Start</a>
+  &nbsp;&nbsp;•&nbsp;&nbsp;
+  <a href="#features">Features</a>
+  &nbsp;&nbsp;•&nbsp;&nbsp;
+  <a href="./ROADMAP.md">Roadmap</a>
+  &nbsp;&nbsp;•&nbsp;&nbsp;
+  <a href="./README.ko.md">한국어</a>
+  &nbsp;&nbsp;•&nbsp;&nbsp;
+  <a href="./README.ja.md">日本語</a>
+</p>
+
+---
+
+## What is T-Ruby?
+
+T-Ruby is a typed layer for Ruby, inspired by TypeScript.
+It ships as a single executable called `trc`.
+
+Write `.trb` files with type annotations, compile to standard `.rb` files.
+Types are erased at compile time — your Ruby code runs everywhere Ruby runs.
+
+```bash
+trc hello.trb                  # Compile to Ruby
+```
+
+The `trc` compiler also generates `.rbs` signature files for tools like
+Steep and Ruby LSP. Gradually adopt types in existing Ruby projects
+with zero runtime overhead.
+
+```bash
+trc --watch src/               # Watch mode
+trc --emit-rbs src/            # Generate .rbs files
+trc --check src/               # Type check without compiling
+```
+
+---
+
+## Why T-Ruby?
+
+We are friends of Ruby — Rubyists who still use and love Ruby.
+
+We know Ruby has duck typing and dynamic types in its DNA.
+But we couldn't ignore that static type systems are becoming
+essential in real-world production environments.
+
+The Ruby ecosystem has debated this for years,
+yet hasn't quite found its answer.
+
+### Existing Approaches
+
+**1) Sorbet**
+- Types are written like comments above your code.
+- It feels like writing JSDoc and hoping the IDE catches errors.
+
+```ruby
+# Sorbet
+extend T::Sig
+
+sig { params(name: String).returns(String) }
+def greet(name)
+  "Hello, #{name}!"
+end
+```
+
+**2) RBS**
+- Ruby's official approach, where `.rbs` files are separate type definition files like TypeScript's `.d.ts`.
+- But in Ruby, you have to write them manually or rely on "implicit inference + manual fixes" — still cumbersome.
+
+```rbs
+# greet.rbs (separate file)
+def greet: (String name) -> String
+```
+
+```ruby
+# greet.rb (no type info)
+def greet(name)
+  "Hello, #{name}!"
+end
+```
+
+### T-Ruby
+- Like TypeScript, types live inside your code.
+- Write `.trb`, and `trc` generates both `.rb` and `.rbs`.
+
+```ruby
+# greet.trb
+def greet(name: String): String
+  "Hello, #{name}!"
+end
+```
+
+```bash
+trc greet.trb
+# => build/greet.rb
+#  + build/greet.rbs
+```
+
+### Others...
+There are new languages like **Crystal**, but strictly speaking, it's a different language from Ruby.
+
+We still love Ruby, and we want this to be
+**progress within the Ruby ecosystem, not an escape from it.**
+
+---
+
+## Install
+
+```bash
+# with RubyGems (recommended)
+gem install t-ruby
+
+# from source
+git clone https://github.com/pyhyun/t-ruby
+cd t-ruby && bundle install
+```
+
+### Verify installation
+
+```bash
+trc --version
+```
+
+---
+
+## Quick start
+
+### 1. Write `.trb`
+
+```ruby
+# hello.trb
+def greet(name: String): String
+  "Hello, #{name}!"
+end
+
+puts greet("world")
+```
+
+### 2. Compile
+
+```bash
+trc hello.trb
+```
+
+### 3. Run
+
+```bash
+ruby build/hello.rb
+# => Hello, world!
+```
+
+---
+
+## Features
+
+- **Type annotations** — Parameter and return types, erased at compile time
+- **Union types** — `String | Integer | nil`
+- **Generics** — `Array<User>`, `Hash<String, Integer>`
+- **Interfaces** — Define contracts between objects
+- **Type aliases** — `type UserID = Integer`
+- **RBS generation** — Works with Steep, Ruby LSP, Sorbet
+- **IDE support** — VS Code, Neovim with LSP
+- **Watch mode** — Recompile on file changes
+
+---
+
+## Quick links
+
+**Getting Started**
+- [VS Code Extension](./docs/vscode/en/getting-started.md)
+- [Vim Setup](./docs/vim/en/getting-started.md)
+- [Neovim Setup](./docs/neovim/en/getting-started.md)
+
+**Guides**
+- [Syntax Highlighting](./docs/syntax-highlighting/en/guide.md)
+
+---
+
+## Status
+
+> **Experimental** — T-Ruby is under active development.
+> APIs may change. Not recommended for production use yet.
+
+| Milestone | Status |
+|-----------|--------|
+| Type Parsing & Erasure | ✅ |
+| Core Type System | ✅ |
+| LSP & IDE Support | ✅ |
+| Advanced Features | ✅ |
+
+See [ROADMAP.md](./ROADMAP.md) for details.
+
+---
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit issues and pull requests.
+
+## License
+
+[MIT](./LICENSE)

data/bin/trc

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/t_ruby"
+
+TRuby::CLI.run(ARGV)