konpeito 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1fe9ef9f2b988dc2d9751cecb6f53c2828e1e0d412cecc897557d7988e967b48
-  data.tar.gz: 68b6e211a60e31b48b61858b62902229b0980e786147b2e4427688f169c0caea
+  metadata.gz: b625a264d0c1f052c3cde2b8bcc08d7dff02f4a292f462d73e218c2fb9af7e59
+  data.tar.gz: 3fd87bf5f8e81ac6959d0daa8b68f6f48fbf13aedfb6adb68848d1f6e9a569c8
 SHA512:
-  metadata.gz: 9dbf1f9e6edffb5e9e91af5398620fa96218f2ddde0cddebfa31ab4b90a42c0206cc71d24a6e2035dfd34f3695b7ba5265aef606c91af1b3cdee430609f537de
-  data.tar.gz: 7e595a3ec330e9f359bd5dc412b7d3c9fe9e9a3bef0fde8632f7b35fbe4f9902b174a93a25b11a5ea1e5364983f4ec8d1a92ff3e78a0aa5ebeeaf015bf2dd821
+  metadata.gz: 5372d88aaca539699920771d4a8dce41589ee8074910a65f2170e71fb7e32775cfc9d397230ee83148587a8665093367c1c264138bf53c30ff1924ce4d6aa724
+  data.tar.gz: 3381123783ab44d4cc6ebfacc0aaa7afc829fe4b97c2d5e222866bda75ec181f3a76c03a0430538e93411adbc86b5e5c899c606afab8b842b78a4af026485ca4

data/CHANGELOG.md

@@ -5,6 +5,41 @@ All notable changes to Konpeito will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0] - 2026-03-08
+
+### Added
+- **mruby backend**: standalone executable generation (`konpeito build --target mruby`)
+  - CRuby-compatible C wrappers (`mruby_helpers.c`) — same LLVM IR for both runtimes
+  - Block/yield, Proc, Fiber, exception handling support
+  - Static linking for FFI libraries
+  - Compilation caching for `konpeito run --target mruby`
+- **Cross-compilation**: `--cross` + `--cross-mruby` + zig cc for targeting other platforms
+- **raylib stdlib**: zero-boilerplate game development for mruby backend
+  - 87 cfunc bindings (window, drawing, text, keyboard, mouse, colors, keys, random)
+  - Auto-detected when `module Raylib` is referenced — no manual setup needed
+- **Game examples**: Breakout and catch game demos (`examples/mruby_breakout/`, `examples/mruby_stdlib_demo/`)
+- Documentation: mruby backend, raylib stdlib, and cross-compilation guides
+
+### Fixed
+- MergedAST handling in stdlib auto-detection
+- Float/double ABI mismatch in mruby runtime
+- mruby truthiness check compatibility
+- Skip stdlib tests when native extension build fails on CI
+
+## [0.3.1] - 2026-03-07
+
+### Added
+- Compilation caching for `konpeito run` — cached artifacts in `.konpeito_cache/run/`
+- Jekyll/GitHub Pages documentation site with just-the-docs theme
+
+### Fixed
+- GitHub Pages baseurl resolution for step IDs
+
+### Changed
+- Documentation restructured: Getting Started now leads with CRuby backend
+- Removed speculative performance claims and inaccurate benchmark numbers from docs
+- Language specification: removed benchmark numbers, fixed Known Limitations
+
 ## [0.3.0] - 2026-03-05
 
 ### Added
@@ -212,6 +247,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `%a{extern}` - external C struct wrappers
 - `%a{simd}` - SIMD vectorization
 
+[0.4.0]: https://github.com/i2y/konpeito/compare/v0.3.1...v0.4.0
+[0.3.1]: https://github.com/i2y/konpeito/compare/v0.3.0...v0.3.1
 [0.3.0]: https://github.com/i2y/konpeito/compare/v0.2.4...v0.3.0
 [0.2.4]: https://github.com/i2y/konpeito/compare/v0.2.3...v0.2.4
 [0.2.3]: https://github.com/i2y/konpeito/compare/v0.2.2...v0.2.3

data/lib/konpeito/cli/base_command.rb

@@ -171,6 +171,8 @@ module Konpeito
 
         if target == :jvm
           "#{base}.jar"
+        elsif target == :mruby
+          Platform.windows? ? "#{base}.exe" : base
         else
           case format
           when :cruby_ext

data/lib/konpeito/cli/build_command.rb

@@ -94,7 +94,7 @@ module Konpeito
           options[:inline_rbs] = true
         end
 
-        opts.on("--target TARGET", %i[native jvm], "Target platform (native, jvm)") do |target|
+        opts.on("--target TARGET", %i[native jvm mruby], "Target platform (native, jvm, mruby)") do |target|
           options[:target] = target
         end
 
@@ -114,6 +114,18 @@ module Konpeito
           options[:library] = true
         end
 
+        opts.on("--cross TARGET", "Cross-compile for target triple (e.g., x86_64-linux-gnu)") do |target|
+          options[:cross_target] = target
+        end
+
+        opts.on("--cross-mruby DIR", "Path to cross-compiled mruby (include/ and lib/)") do |dir|
+          options[:cross_mruby_dir] = dir
+        end
+
+        opts.on("--cross-libs DIR", "Additional library search path for cross-compilation") do |dir|
+          options[:cross_libs_dir] = dir
+        end
+
         opts.on("--stats", "Show optimization statistics") do
           options[:stats] = true
         end
@@ -154,7 +166,11 @@ module Konpeito
           end
         end
 
-        target_label = options[:target] == :jvm ? "jvm" : "native"
+        target_label = case options[:target]
+                       when :jvm then "jvm"
+                       when :mruby then "mruby"
+                       else "native"
+                       end
         emit("Compiling", "#{source_file} (#{target_label})") unless options[:quiet]
 
         compiler = Compiler.new(
@@ -173,7 +189,10 @@ module Konpeito
           run_after: options[:run_after],
           emit_ir: options[:emit_ir],
           classpath: classpath,
-          library: options[:library]
+          library: options[:library],
+          cross_target: options[:cross_target],
+          cross_mruby_dir: options[:cross_mruby_dir],
+          cross_libs_dir: options[:cross_libs_dir]
         )
 
         compiler.compile
@@ -210,8 +229,11 @@ module Konpeito
 
           # Show usage hint (skip for --run and --lib)
           unless options[:run_after] || options[:library]
-            if options[:target] == :jvm
+            case options[:target]
+            when :jvm
               emit("Hint", "java -jar #{output_file}")
+            when :mruby
+              emit("Hint", "./#{output_file}")
             else
               ext_name = File.basename(output_file, File.extname(output_file))
               emit("Hint", "ruby -r ./#{ext_name} -e \"YourModule.method\"")

data/lib/konpeito/cli/completion_command.rb

@@ -60,7 +60,7 @@ module Konpeito
         --no-color -h --help
       ].freeze
 
-      TARGET_VALUES = %w[native jvm].freeze
+      TARGET_VALUES = %w[native jvm mruby].freeze
 
       def bash_completion
         <<~'BASH'
@@ -81,7 +81,7 @@ module Konpeito
 
               # Complete --target values
               if [[ "${prev}" == "--target" ]]; then
-                  COMPREPLY=( $(compgen -W "native jvm" -- "${cur}") )
+                  COMPREPLY=( $(compgen -W "native jvm mruby" -- "${cur}") )
                   return 0
               fi
 
@@ -170,7 +170,7 @@ module Konpeito
                           '--incremental[Enable incremental compilation]' \
                           '--clean-cache[Clear compilation cache]' \
                           '--inline[Use inline RBS annotations]' \
-                          '--target[Target platform]:target:(native jvm)' \
+                          '--target[Target platform]:target:(native jvm mruby)' \
                           '--run[Run after building]' \
                           '--emit-ir[Emit intermediate representation]' \
                           '--classpath[JVM classpath]:path:_files' \
@@ -185,7 +185,7 @@ module Konpeito
                       ;;
                   run)
                       _arguments \
-                          '--target[Target platform]:target:(native jvm)' \
+                          '--target[Target platform]:target:(native jvm mruby)' \
                           '--classpath[JVM classpath]:path:_files' \
                           '--rbs[RBS type definition file]:file:_files -g "*.rbs"' \
                           '-I[Add require search path]:path:_directories' \
@@ -265,7 +265,7 @@ module Konpeito
           complete -c konpeito -n '__fish_seen_subcommand_from build' -l incremental -d 'Incremental compilation'
           complete -c konpeito -n '__fish_seen_subcommand_from build' -l clean-cache -d 'Clear compilation cache'
           complete -c konpeito -n '__fish_seen_subcommand_from build' -l inline -d 'Use inline RBS annotations'
-          complete -c konpeito -n '__fish_seen_subcommand_from build' -l target -r -a 'native jvm' -d 'Target platform'
+          complete -c konpeito -n '__fish_seen_subcommand_from build' -l target -r -a 'native jvm mruby' -d 'Target platform'
           complete -c konpeito -n '__fish_seen_subcommand_from build' -l run -d 'Run after building'
           complete -c konpeito -n '__fish_seen_subcommand_from build' -l emit-ir -d 'Emit intermediate representation'
           complete -c konpeito -n '__fish_seen_subcommand_from build' -l classpath -r -d 'JVM classpath'
@@ -276,7 +276,7 @@ module Konpeito
           complete -c konpeito -n '__fish_seen_subcommand_from build' -F -d 'Ruby source file'
 
           # run options
-          complete -c konpeito -n '__fish_seen_subcommand_from run' -l target -r -a 'native jvm' -d 'Target platform'
+          complete -c konpeito -n '__fish_seen_subcommand_from run' -l target -r -a 'native jvm mruby' -d 'Target platform'
           complete -c konpeito -n '__fish_seen_subcommand_from run' -l classpath -r -d 'JVM classpath'
           complete -c konpeito -n '__fish_seen_subcommand_from run' -l rbs -r -d 'RBS type definition file'
           complete -c konpeito -n '__fish_seen_subcommand_from run' -s I -l require-path -r -d 'Add require search path'

data/lib/konpeito/cli/doctor_command.rb

@@ -22,6 +22,7 @@ module Konpeito
         checks.concat(core_checks)
         checks.concat(native_checks) if check_native?
         checks.concat(jvm_checks) if check_jvm?
+        checks.concat(mruby_checks) if check_mruby?
         checks.concat(ui_checks) if check_ui?
         checks.concat(optional_checks)
 
@@ -56,7 +57,7 @@ module Konpeito
       end
 
       def setup_option_parser(opts)
-        opts.on("--target TARGET", %i[native jvm ui], "Check only native, jvm, or ui dependencies") do |target|
+        opts.on("--target TARGET", %i[native jvm mruby ui], "Check only native, jvm, mruby, or ui dependencies") do |target|
           options[:target] = target
         end
 
@@ -77,6 +78,10 @@ module Konpeito
         options[:target].nil? || options[:target] == :jvm
       end
 
+      def check_mruby?
+        options[:target] == :mruby
+      end
+
       def check_ui?
         options[:target] == :ui
       end
@@ -172,6 +177,65 @@ module Konpeito
         checks
       end
 
+      def mruby_checks
+        checks = []
+
+        # mruby-config
+        mruby_config = Platform.find_mruby_config
+        checks << {
+          name: "mruby-config",
+          detail: mruby_config || "not found",
+          status: mruby_config ? :ok : :warning,
+          hint: "Install: #{Platform.mruby_install_hint}"
+        }
+
+        # mruby headers
+        cflags = Platform.mruby_cflags
+        inc_dir = cflags.split.find { |f| f.start_with?("-I") }&.sub(/^-I/, "")
+        header_found = inc_dir && File.exist?(File.join(inc_dir, "mruby.h"))
+        checks << {
+          name: "mruby.h",
+          detail: header_found ? inc_dir : "not found",
+          status: header_found ? :ok : :missing,
+          hint: "Install mruby development headers. #{Platform.mruby_install_hint}"
+        }
+
+        # libmruby
+        ldflags = Platform.mruby_ldflags
+        lib_dir = ldflags.split.find { |f| f.start_with?("-L") }&.sub(/^-L/, "")
+        lib_found = if lib_dir
+          File.exist?(File.join(lib_dir, "libmruby.a")) || File.exist?(File.join(lib_dir, "libmruby.so"))
+        else
+          false
+        end
+        checks << {
+          name: "libmruby",
+          detail: lib_found ? lib_dir : "not found (will try system default)",
+          status: lib_found ? :ok : :warning,
+          hint: "Install: #{Platform.mruby_install_hint}"
+        }
+
+        # clang (also needed for mruby backend)
+        clang_path = Platform.find_llvm_tool("clang")
+        checks << {
+          name: "clang",
+          detail: clang_path || "not found",
+          status: clang_path ? :ok : :missing,
+          hint: "Install: #{Platform.llvm_install_hint}"
+        }
+
+        # zig (optional, for cross-compilation)
+        zig_path = Platform.find_zig
+        checks << {
+          name: "zig (cross-compile)",
+          detail: zig_path || "not found (optional)",
+          status: zig_path ? :ok : :info,
+          hint: "Install for cross-compilation: https://ziglang.org/download/"
+        }
+
+        checks
+      end
+
       def optional_checks
         checks = []
 

data/lib/konpeito/cli/init_command.rb

@@ -58,7 +58,7 @@ module Konpeito
           options[:with_git] = false
         end
 
-        opts.on("--target TARGET", %i[native jvm], "Target platform (native, jvm)") do |target|
+        opts.on("--target TARGET", %i[native jvm mruby], "Target platform (native, jvm, mruby)") do |target|
           options[:target] = target
         end
 

data/lib/konpeito/cli/run_command.rb

@@ -33,6 +33,8 @@ module Konpeito
         case target
         when :jvm
           run_jvm(source_file)
+        when :mruby
+          run_mruby(source_file)
         else
           run_native(source_file)
         end
@@ -56,7 +58,7 @@ module Konpeito
       end
 
       def setup_option_parser(opts)
-        opts.on("--target TARGET", %i[native jvm], "Target platform (native, jvm)") do |target|
+        opts.on("--target TARGET", %i[native jvm mruby], "Target platform (native, jvm, mruby)") do |target|
           options[:target] = target
         end
 
@@ -225,6 +227,116 @@ module Konpeito
         build_args
       end
 
+      def run_mruby(source_file)
+        require "konpeito/cache"
+
+        base = File.basename(source_file, ".rb")
+        basename = Platform.windows? ? "#{base}.exe" : base
+        run_cache = Cache::RunCache.new(cache_dir: ".konpeito_cache/run_mruby")
+
+        if options[:clean_run_cache]
+          run_cache.clean!
+          emit("Cleaned", "mruby run cache")
+        end
+
+        if options[:no_cache]
+          build_and_run_mruby_tmpdir(source_file, basename)
+          return
+        end
+
+        cache_key = compute_mruby_run_cache_key(source_file, run_cache)
+
+        if cache_key
+          artifact = run_cache.lookup(cache_key, basename)
+          if artifact
+            emit("Cached", source_file)
+            emit("Running", artifact)
+            system(artifact)
+            return
+          end
+        end
+
+        if cache_key
+          build_and_run_mruby_cached(source_file, run_cache, cache_key, basename)
+        else
+          build_and_run_mruby_tmpdir(source_file, basename)
+        end
+      end
+
+      def compute_mruby_run_cache_key(source_file, run_cache)
+        resolver = DependencyResolver.new(
+          base_paths: options[:require_paths],
+          verbose: false
+        )
+        resolver.resolve(source_file)
+
+        all_sources = resolver.resolved_files.keys
+        auto_rbs = resolver.rbs_paths
+        all_rbs = (options[:rbs_paths].map { |p| File.expand_path(p) } + auto_rbs).uniq
+        all_rbs = all_rbs.select { |f| File.exist?(f) }
+
+        # Include extra C files in cache key (they affect the binary)
+        source_dir = File.dirname(File.expand_path(source_file))
+        extra_c_files = Dir.glob(File.join(source_dir, "*.c")).sort
+
+        options_hash = {
+          "inline_rbs" => options[:inline_rbs].to_s,
+          "target" => "mruby"
+        }
+
+        digest = Digest::SHA256.new
+        all_sources.sort.each { |f| digest.update(Digest::SHA256.file(f).hexdigest) }
+        all_rbs.sort.each { |f| digest.update(Digest::SHA256.file(f).hexdigest) }
+        extra_c_files.each { |f| digest.update(Digest::SHA256.file(f).hexdigest) }
+        digest.update(options_hash.sort.map { |k, v| "#{k}=#{v}" }.join("|"))
+        digest.update(Konpeito::VERSION)
+        digest.hexdigest
+      rescue StandardError => e
+        puts_verbose("Cache key computation failed: #{e.message}")
+        nil
+      end
+
+      def build_and_run_mruby_cached(source_file, run_cache, cache_key, basename)
+        dir = run_cache.artifact_dir(cache_key)
+        FileUtils.mkdir_p(dir)
+        output_file = File.join(dir, basename)
+
+        build_args = build_mruby_args(source_file, output_file)
+        Commands::BuildCommand.new(build_args, config: config).run
+
+        run_cache.store(cache_key, basename)
+
+        emit("Running", output_file)
+        system(output_file)
+      end
+
+      def build_and_run_mruby_tmpdir(source_file, basename)
+        require "tmpdir"
+
+        @run_tmpdir = File.join(Dir.tmpdir, "konpeito_mruby_run_#{Process.pid}")
+        FileUtils.mkdir_p(@run_tmpdir)
+        output_file = File.join(@run_tmpdir, basename)
+
+        build_args = build_mruby_args(source_file, output_file)
+        Commands::BuildCommand.new(build_args, config: config).run
+
+        emit("Running", output_file)
+        system(output_file)
+      ensure
+        FileUtils.rm_rf(@run_tmpdir) if @run_tmpdir && Dir.exist?(@run_tmpdir)
+      end
+
+      def build_mruby_args(source_file, output_file)
+        build_args = ["--target", "mruby", "-o", output_file, "-q"]
+        build_args << "-v" if options[:verbose]
+        build_args << "--no-color" unless options[:color]
+        build_args << "--inline" if options[:inline_rbs]
+        options[:rbs_paths].each { |p| build_args << "--rbs" << p }
+        options[:require_paths].each { |p| build_args << "-I" << p }
+        build_args << source_file
+        build_args
+      end
+
       def build_classpath
         parts = []
 

data/lib/konpeito/cli/test_command.rb

@@ -61,7 +61,7 @@ module Konpeito
           options[:compile_first] = true
         end
 
-        opts.on("--target TARGET", %i[native jvm], "Target platform (native, jvm)") do |target|
+        opts.on("--target TARGET", %i[native jvm mruby], "Target platform (native, jvm, mruby)") do |target|
           options[:target] = target
         end