t-ruby 0.0.34 → 0.0.36

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aaa0445c84cb0a6685e788645a19fee5d30d2f1e6f79052122fb16e8a3f08e91
-  data.tar.gz: 446845b5b1e470964f664d590197262f0e3555b82dd59f7b75a484324b99ec63
+  metadata.gz: f8847929796ade811f3b9c3cd3ddcb86448e18927e40c2318e562dc9c35e312b
+  data.tar.gz: 526a69c0dc752147ed3a29b208ebb85cd019a20b03efbd21ed28a25d5badc37b
 SHA512:
-  metadata.gz: e422c5535edcb5085efd7018825c1675b06b3c2bb3657da1c6d9f6b07202233b53c03c145888fbdc221fc78df4873d18c2d0f4326d19ede16134eda409fb7418
-  data.tar.gz: 0d988eaa6c08a586af4c965447087467e500cc75de4d7bc879c239c3f6924caf504123fc3117ed9be4e676b0ae2715bdadf888218e8072702c1a66bbb329a288
+  metadata.gz: 55d2c62ad5fd9071da3bfd363fad13e14d08f340c9ed8b19ab1c5b677db4a4e583dc8f183f67006efbfa44a2fbd1e0c77f14c6dd7af39b6c2d745978b938dcdf
+  data.tar.gz: 93d96b65f461f68dc3833a1be714b51a616edefc1b01e97d56016cddbba7a48843f098efa49634d3a55043c8ffca21bd47cad660200cd63fd75e5deb92a2811e

data/README.md

@@ -138,7 +138,7 @@ We still love Ruby, and we want this to be
 gem install t-ruby
 
 # from source
-git clone https://github.com/pyhyun/t-ruby
+git clone https://github.com/type-ruby/t-ruby
 cd t-ruby && bundle install
 ```
 
@@ -152,10 +152,21 @@ trc --version
 
 ## Quick start
 
-### 1. Write `.trb`
+### 1. Initialize project
+
+```bash
+trc --init
+```
+
+This creates:
+- `trbconfig.yml` — project configuration
+- `src/` — source directory
+- `build/` — output directory
+
+### 2. Write `.trb`
 
 ```trb
-# hello.trb
+# src/hello.trb
 def greet(name: String): String
   "Hello, #{name}!"
 end
@@ -163,19 +174,69 @@ end
 puts greet("world")
 ```
 
-### 2. Compile
+### 3. Compile
 
 ```bash
-trc hello.trb
+trc src/hello.trb
 ```
 
-### 3. Run
+### 4. Run
 
 ```bash
 ruby build/hello.rb
 # => Hello, world!
 ```
 
+### 5. Watch mode
+
+```bash
+trc -w           # Watch directories from trbconfig.yml (default: src/)
+trc -w lib/      # Watch specific directory
+```
+
+Files are automatically recompiled on change.
+
+---
+
+## Configuration
+
+`trc --init` generates a `trbconfig.yml` file with all available options:
+
+```yaml
+# T-Ruby configuration file
+# See: https://type-ruby.github.io/docs/getting-started/project-configuration
+
+source:
+  include:
+    - src
+  exclude: []
+  extensions:
+    - ".trb"
+    - ".rb"
+
+output:
+  ruby_dir: build
+  # rbs_dir: sig  # Optional: separate directory for .rbs files
+  preserve_structure: true
+  # clean_before_build: false
+
+compiler:
+  strictness: standard  # strict | standard | permissive
+  generate_rbs: true
+  target_ruby: "3.0"
+  # experimental: []
+  # checks:
+  #   no_implicit_any: false
+  #   no_unused_vars: false
+  #   strict_nil: false
+
+watch:
+  # paths: []  # Additional paths to watch
+  debounce: 100
+  # clear_screen: false
+  # on_success: "bundle exec rspec"
+```
+
 ---
 
 ## Features
@@ -191,10 +252,11 @@ ruby build/hello.rb
 
 ---
 
-## Quick links
+## Links
 
-**Getting Started**
-- [VS Code Extension](./docs/vscode/en/getting-started.md)
+**IDE Support**
+- [VS Code Extension (and Cursor)](./docs/vscode/en/getting-started.md)
+- [JetBrains Plugin](./docs/jetbrains/en/getting-started.md)
 - [Vim Setup](./docs/vim/en/getting-started.md)
 - [Neovim Setup](./docs/neovim/en/getting-started.md)
 

data/lib/t_ruby/benchmark.rb

@@ -60,11 +60,11 @@ module TRuby
     # Export results to JSON
     def export_json(path = "benchmark_results.json")
       File.write(path, JSON.pretty_generate({
-        timestamp: Time.now.iso8601,
-        ruby_version: RUBY_VERSION,
-        platform: RUBY_PLATFORM,
-        results: @results
-      }))
+                                              timestamp: Time.now.iso8601,
+                                              ruby_version: RUBY_VERSION,
+                                              platform: RUBY_PLATFORM,
+                                              results: @results,
+                                            }))
     end
 
     # Export results to Markdown
@@ -86,7 +86,7 @@ module TRuby
         benchmarks.each do |name, data|
           time_ms = (data[:avg_time] * 1000).round(2)
           memory_kb = (data[:memory] || 0).round(2)
-          ips = data[:avg_time] > 0 ? (1.0 / data[:avg_time]).round(2) : 0
+          ips = data[:avg_time].positive? ? (1.0 / data[:avg_time]).round(2) : 0
           md << "| #{name} | #{time_ms} | #{memory_kb} | #{ips} |"
         end
         md << ""
@@ -116,7 +116,7 @@ module TRuby
             current: data[:avg_time],
             previous: prev_data[:avg_time],
             diff_percent: diff,
-            improved: diff < 0
+            improved: diff.negative?,
           }
         end
       end
@@ -255,7 +255,7 @@ module TRuby
         print_result(:incremental_single, results[:incremental_single])
 
         # Calculate speedup
-        if results[:full_compile][:avg_time] > 0
+        if results[:full_compile][:avg_time].positive?
           speedup = results[:full_compile][:avg_time] / results[:incremental_single][:avg_time]
           puts "  Incremental speedup: #{speedup.round(2)}x"
         end
@@ -317,7 +317,7 @@ module TRuby
         print_result(:parallel_4, results[:parallel_4])
 
         # Print speedups
-        if results[:sequential][:avg_time] > 0
+        if results[:sequential][:avg_time].positive?
           puts "  Parallel(2) speedup: #{(results[:sequential][:avg_time] / results[:parallel_2][:avg_time]).round(2)}x"
           puts "  Parallel(4) speedup: #{(results[:sequential][:avg_time] / results[:parallel_4][:avg_time]).round(2)}x"
         end
@@ -332,7 +332,7 @@ module TRuby
 
       # Baseline memory
       GC.start
-      baseline = get_memory_usage
+      get_memory_usage
 
       # Parser memory
       content = generate_test_content(0)
@@ -374,20 +374,20 @@ module TRuby
           small_file: generate_test_content(0, lines: 10),
           medium_file: generate_test_content(0, lines: 100),
           large_file: generate_test_content(0, lines: 500),
-          complex_types: generate_complex_types_content
+          complex_types: generate_complex_types_content,
         }
       when :type_checking
         {
           simple_types: generate_simple_types_content,
           generic_types: generate_generic_types_content,
           union_types: generate_union_types_content,
-          interface_types: generate_interface_types_content
+          interface_types: generate_interface_types_content,
         }
       when :compilation
         {
           minimal: "def hello: void; end",
           with_types: generate_test_content(0, lines: 50),
-          with_interfaces: generate_interface_types_content
+          with_interfaces: generate_interface_types_content,
         }
       else
         {}
@@ -396,7 +396,7 @@ module TRuby
 
     def generate_test_content(seed, lines: 50, modified: false)
       content = []
-      content << "# Test file #{seed}#{modified ? ' (modified)' : ''}"
+      content << "# Test file #{seed}#{" (modified)" if modified}"
       content << ""
       content << "type CustomType#{seed} = String | Integer | nil"
       content << ""
@@ -522,7 +522,7 @@ module TRuby
         min_time: min,
         max_time: max,
         std_dev: std_dev,
-        iterations: times.length
+        iterations: times.length,
       }
     end
 
@@ -571,7 +571,7 @@ module TRuby
       iterations.times do
         start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
         yield
-        times << Process.clock_gettime(Process::CLOCK_MONOTONIC) - start
+        times << (Process.clock_gettime(Process::CLOCK_MONOTONIC) - start)
       end
 
       avg = times.sum / times.length

data/lib/t_ruby/bundler_integration.rb

@@ -42,7 +42,7 @@ module TRuby
       installed_gems = parse_gemfile_lock
       type_packages = {}
 
-      installed_gems.each do |gem_name, version|
+      installed_gems.each_key do |gem_name|
         type_gem = find_type_gem(gem_name)
         type_packages[gem_name] = type_gem if type_gem
       end
@@ -93,7 +93,7 @@ module TRuby
         types_group: TYPES_GROUP.to_s,
         type_gems: list_type_gems,
         local_types: list_local_types,
-        generated_at: Time.now.iso8601
+        generated_at: Time.now.iso8601,
       }
 
       manifest_path = File.join(@project_dir, ".trb-bundle.json")
@@ -128,15 +128,15 @@ module TRuby
 
         next unless base_version && type_version
 
-        unless versions_compatible?(base_version, type_version)
-          issues << {
-            gem: base_gem,
-            gem_version: base_version,
-            type_gem: type_info[:name],
-            type_version: type_version,
-            message: "Version mismatch: #{base_gem}@#{base_version} vs #{type_info[:name]}@#{type_version}"
-          }
-        end
+        next if versions_compatible?(base_version, type_version)
+
+        issues << {
+          gem: base_gem,
+          gem_version: base_version,
+          type_gem: type_info[:name],
+          type_version: type_version,
+          message: "Version mismatch: #{base_gem}@#{base_version} vs #{type_info[:name]}@#{type_version}",
+        }
       end
 
       issues
@@ -201,21 +201,21 @@ module TRuby
 
       # Create a sample .d.trb file
       sample_path = File.join(types_dir, "custom.d.trb")
-      unless File.exist?(sample_path)
-        File.write(sample_path, <<~TRB)
-          # Custom type definitions for your project
-          # These types are available throughout your T-Ruby code
-
-          # Example type alias
-          # type UserId = String
-
-          # Example interface
-          # interface Serializable
-          #   to_json: String
-          #   from_json: (String) -> self
-          # end
-        TRB
-      end
+      return if File.exist?(sample_path)
+
+      File.write(sample_path, <<~TRB)
+        # Custom type definitions for your project
+        # These types are available throughout your T-Ruby code
+
+        # Example type alias
+        # type UserId = String
+
+        # Example interface
+        # interface Serializable
+        #   to_json: String
+        #   from_json: (String) -> self
+        # end
+      TRB
     end
 
     def append_to_gemfile(gem_name, version, group:)
@@ -276,7 +276,7 @@ module TRuby
       # This is a simplified check - in production would query RubyGems API
       {
         name: type_gem_name,
-        available: check_gem_availability(type_gem_name)
+        available: check_gem_availability(type_gem_name),
       }
     end
 
@@ -305,7 +305,7 @@ module TRuby
           name: name,
           base_gem: base_gem,
           version: version,
-          path: find_gem_path(name, version)
+          path: find_gem_path(name, version),
         }
       end
     end
@@ -315,7 +315,7 @@ module TRuby
       possible_paths = [
         File.join(ENV["GEM_HOME"] || "", "gems", "#{gem_name}-#{version}"),
         File.join(Dir.home, ".gem", "ruby", "*", "gems", "#{gem_name}-#{version}"),
-        File.join(@project_dir, "vendor", "bundle", "**", "gems", "#{gem_name}-#{version}")
+        File.join(@project_dir, "vendor", "bundle", "**", "gems", "#{gem_name}-#{version}"),
       ]
 
       possible_paths.each do |pattern|
@@ -398,7 +398,7 @@ module TRuby
         {
           name: gem_info[:name],
           base_gem: gem_info[:base_gem],
-          version: gem_info[:version]
+          version: gem_info[:version],
         }
       end
     end
@@ -553,11 +553,9 @@ module TRuby
       migrated = []
 
       # Read existing T-Ruby manifest
-      if @manifest
-        @manifest.dependencies.each do |name, version|
-          result = @bundler.add_type_gem(name, version: version)
-          migrated << result
-        end
+      @manifest&.dependencies&.each do |name, version|
+        result = @bundler.add_type_gem(name, version: version)
+        migrated << result
       end
 
       # Generate new bundle manifest

data/lib/t_ruby/cache.rb

@@ -32,7 +32,7 @@ module TRuby
         key: @key,
         value: @value,
         created_at: @created_at.to_i,
-        hits: @hits
+        hits: @hits,
       }
     end
   end
@@ -96,6 +96,7 @@ module TRuby
     def hit_rate
       total = @hits + @misses
       return 0.0 if total.zero?
+
       @hits.to_f / total
     end
 
@@ -105,7 +106,7 @@ module TRuby
         max_size: @max_size,
         hits: @hits,
         misses: @misses,
-        hit_rate: hit_rate
+        hit_rate: hit_rate,
       }
     end
 
@@ -160,7 +161,7 @@ module TRuby
 
     def delete(key)
       path = cache_path(key)
-      File.delete(path) if File.exist?(path)
+      FileUtils.rm_f(path)
     end
 
     def clear
@@ -260,7 +261,7 @@ module TRuby
   # Declaration file cache
   class DeclarationCache
     def initialize(cache_dir: ".t-ruby-cache/declarations")
-      @file_cache = FileCache.new(cache_dir: cache_dir, max_age: 86400) # 24 hours
+      @file_cache = FileCache.new(cache_dir: cache_dir, max_age: 86_400) # 24 hours
       @memory_cache = MemoryCache.new(max_size: 200)
     end
 
@@ -368,6 +369,7 @@ module TRuby
 
     def file_hash(file_path)
       return nil unless File.exist?(file_path)
+
       Digest::SHA256.hexdigest(File.read(file_path))
     end
   end
@@ -412,7 +414,11 @@ module TRuby
       threads = @thread_count.times.map do
         Thread.new do
           loop do
-            file = queue.pop(true) rescue break
+            file = begin
+              queue.pop(true)
+            rescue StandardError
+              break
+            end
             result = block.call(file)
             mutex.synchronize { results << result }
           end
@@ -428,7 +434,7 @@ module TRuby
     def determine_thread_count
       # Use number of CPU cores, max 8
       [Etc.nprocessors, 8].min
-    rescue
+    rescue StandardError
       4
     end
 
@@ -443,8 +449,8 @@ module TRuby
 
     def initialize(type_checker: nil)
       @type_checker = type_checker || TypeChecker.new
-      @file_types = {}  # file_path => { types: [], functions: [], interfaces: [] }
-      @global_registry = {}  # name => { file: path, kind: :type/:func/:interface, definition: ... }
+      @file_types = {} # file_path => { types: [], functions: [], interfaces: [] }
+      @global_registry = {} # name => { file: path, kind: :type/:func/:interface, definition: ... }
       @errors = []
       @warnings = []
     end
@@ -489,7 +495,7 @@ module TRuby
       {
         success: @errors.empty?,
         errors: @errors,
-        warnings: @warnings
+        warnings: @warnings,
       }
     end
 
@@ -502,24 +508,20 @@ module TRuby
         when IR::MethodDef
           # Check parameter types
           decl.params.each do |param|
-            if param.type_annotation
-              unless type_exists?(param.type_annotation)
-                file_errors << {
-                  file: file_path,
-                  message: "Unknown type '#{type_name(param.type_annotation)}' in parameter '#{param.name}'"
-                }
-              end
-            end
+            next unless param.type_annotation && !type_exists?(param.type_annotation)
+
+            file_errors << {
+              file: file_path,
+              message: "Unknown type '#{type_name(param.type_annotation)}' in parameter '#{param.name}'",
+            }
           end
 
           # Check return type
-          if decl.return_type
-            unless type_exists?(decl.return_type)
-              file_errors << {
-                file: file_path,
-                message: "Unknown return type '#{type_name(decl.return_type)}' in function '#{decl.name}'"
-              }
-            end
+          if decl.return_type && !type_exists?(decl.return_type)
+            file_errors << {
+              file: file_path,
+              message: "Unknown return type '#{type_name(decl.return_type)}' in function '#{decl.name}'",
+            }
           end
         end
       end
@@ -552,7 +554,7 @@ module TRuby
         # Duplicate definition from different file
         @warnings << {
           message: "#{kind.to_s.capitalize} '#{name}' defined in multiple files",
-          files: [@global_registry[name][:file], file_path]
+          files: [@global_registry[name][:file], file_path],
         }
       end
 
@@ -568,7 +570,7 @@ module TRuby
         duplicates.each do |name|
           @errors << {
             file: file,
-            message: "Duplicate definition of '#{name}'"
+            message: "Duplicate definition of '#{name}'",
           }
         end
       end
@@ -580,12 +582,12 @@ module TRuby
         info[:types].each do |type_info|
           referenced_types = extract_type_references(type_info[:definition])
           referenced_types.each do |ref|
-            unless type_exists_by_name?(ref)
-              @errors << {
-                file: file_path,
-                message: "Unresolved type reference '#{ref}' in type alias '#{type_info[:name]}'"
-              }
-            end
+            next if type_exists_by_name?(ref)
+
+            @errors << {
+              file: file_path,
+              message: "Unresolved type reference '#{ref}' in type alias '#{type_info[:name]}'",
+            }
           end
         end
       end
@@ -608,13 +610,15 @@ module TRuby
       when IR::NullableType
         type_exists?(type_node.inner_type)
       else
-        true  # Assume valid for unknown types
+        true # Assume valid for unknown types
       end
     end
 
     def type_exists_by_name?(name)
-      return true if %w[String Integer Float Boolean Array Hash Symbol void nil Object Numeric Enumerable].include?(name)
+      return true if %w[String Integer Float Boolean Array Hash Symbol void nil Object Numeric
+                        Enumerable].include?(name)
       return true if @global_registry[name]
+
       false
     end
 
@@ -655,7 +659,7 @@ module TRuby
 
     def initialize(compiler, cache: nil, enable_cross_file: true)
       super(compiler, cache: cache)
-      @ir_cache = {}  # file_path => IR::Program
+      @ir_cache = {} # file_path => IR::Program
       @cross_file_checker = CrossFileTypeChecker.new if enable_cross_file
     end
 
@@ -685,11 +689,9 @@ module TRuby
 
       # First pass: compile and register all files
       file_paths.each do |file_path|
-        begin
-          results[file_path] = compile_with_ir(file_path)
-        rescue => e
-          errors << { file: file_path, error: e.message }
-        end
+        results[file_path] = compile_with_ir(file_path)
+      rescue StandardError => e
+        errors << { file: file_path, error: e.message }
       end
 
       # Second pass: cross-file type checking
@@ -701,7 +703,7 @@ module TRuby
       {
         results: results,
         errors: errors,
-        success: errors.empty?
+        success: errors.empty?,
       }
     end
 
@@ -721,6 +723,7 @@ module TRuby
 
     def file_hash(file_path)
       return nil unless File.exist?(file_path)
+
       Digest::SHA256.hexdigest(File.read(file_path))
     end
   end
@@ -751,7 +754,7 @@ module TRuby
       @timings.sort_by { |_, v| -v }.each do |name, time|
         calls = @call_counts[name]
         avg = time / calls
-        puts "#{name}: #{format('%.3f', time)}s total, #{calls} calls, #{format('%.3f', avg * 1000)}ms avg"
+        puts "#{name}: #{format("%.3f", time)}s total, #{calls} calls, #{format("%.3f", avg * 1000)}ms avg"
       end
     end
 
@@ -766,7 +769,7 @@ module TRuby
           name: name,
           total_time: time,
           call_count: @call_counts[name],
-          avg_time: time / @call_counts[name]
+          avg_time: time / @call_counts[name],
         }
       end
     end

data/lib/t_ruby/cli.rb

@@ -2,7 +2,7 @@
 
 module TRuby
   class CLI
-    HELP_TEXT = <<~HELP
+    HELP_TEXT = <<~HELP.freeze
       t-ruby compiler (trc) v#{VERSION}
 
       Usage:
@@ -145,10 +145,10 @@ module TRuby
 
       # Output results
       if created.any?
-        puts "Created: #{created.join(', ')}"
+        puts "Created: #{created.join(", ")}"
       end
       if skipped.any?
-        puts "Skipped (already exists): #{skipped.join(', ')}"
+        puts "Skipped (already exists): #{skipped.join(", ")}"
       end
       if created.empty? && skipped.any?
         puts "Project already initialized."