konpeito 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a2c905a6cc383d9539c3d0c1377c4dc8b033636cf8c7b85987e6acb59e4c69c
-  data.tar.gz: 2799693d9a59c0f0b90b0d11bc43da17bd78278aa88b11d3fd0796dfbad5f39b
+  metadata.gz: b625a264d0c1f052c3cde2b8bcc08d7dff02f4a292f462d73e218c2fb9af7e59
+  data.tar.gz: 3fd87bf5f8e81ac6959d0daa8b68f6f48fbf13aedfb6adb68848d1f6e9a569c8
 SHA512:
-  metadata.gz: 184994190193063c34ea651f672b04eeb9499e3d08da65cb3b09297ca321b2a0a645241f27fcf993871858ea17defbfdbe0674a4e0ced6298f1c4e595d36c700
-  data.tar.gz: d8689a1392633e4ed8c29756259e6196c3571c68c4148058013b962b09ee1168fec3b6d095f29f8ae2c5aa1262bde0efa2651d4265480507044b51e5d4182c21
+  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/cache/run_cache.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+require "digest"
+require "json"
+require "fileutils"
+
+module Konpeito
+  module Cache
+    # Manages compilation cache for `konpeito run`.
+    # Content-addressed: cache key is SHA256 of all inputs.
+    class RunCache
+      MANIFEST_FILE = "run_manifest.json"
+      DEFAULT_MAX_ENTRIES = 20
+
+      attr_reader :cache_dir
+
+      def initialize(cache_dir: ".konpeito_cache/run")
+        @cache_dir = File.expand_path(cache_dir)
+        @manifest = nil
+        load_manifest
+      end
+
+      # Compute a cache key from all compilation inputs.
+      def compute_cache_key(source_files:, rbs_files:, options_hash:)
+        digest = Digest::SHA256.new
+        source_files.sort.each { |f| digest.update(Digest::SHA256.file(f).hexdigest) }
+        rbs_files.sort.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
+      end
+
+      # Look up a cached artifact. Returns the path if it exists, nil otherwise.
+      def lookup(cache_key, basename)
+        entry = @manifest["entries"][cache_key]
+        return nil unless entry
+
+        artifact = artifact_path(cache_key, basename)
+        return nil unless File.exist?(artifact)
+
+        # Update last_used_at
+        entry["last_used_at"] = Time.now.iso8601
+        save_manifest
+        artifact
+      end
+
+      # Register a compiled artifact in the manifest.
+      # The artifact should already exist at artifact_dir(cache_key)/basename.
+      def store(cache_key, basename)
+        artifact = artifact_path(cache_key, basename)
+        return nil unless File.exist?(artifact)
+
+        @manifest["entries"][cache_key] = {
+          "basename" => basename,
+          "created_at" => Time.now.iso8601,
+          "last_used_at" => Time.now.iso8601
+        }
+        save_manifest
+        cleanup!
+        artifact
+      end
+
+      # Directory for a given cache key's artifact.
+      def artifact_dir(cache_key)
+        File.join(@cache_dir, cache_key)
+      end
+
+      # Full path to the artifact file.
+      def artifact_path(cache_key, basename)
+        File.join(artifact_dir(cache_key), basename)
+      end
+
+      # Remove all cached entries.
+      def clean!
+        FileUtils.rm_rf(@cache_dir)
+        FileUtils.mkdir_p(@cache_dir)
+        @manifest = create_empty_manifest
+        save_manifest
+      end
+
+      # Evict oldest entries beyond max_entries.
+      def cleanup!(max_entries: DEFAULT_MAX_ENTRIES)
+        entries = @manifest["entries"]
+        return if entries.size <= max_entries
+
+        # Sort by last_used_at ascending (oldest first)
+        sorted = entries.sort_by { |_k, v| v["last_used_at"] || v["created_at"] || "" }
+        to_remove = sorted.first(entries.size - max_entries)
+
+        to_remove.each do |key, _|
+          dir = artifact_dir(key)
+          FileUtils.rm_rf(dir) if Dir.exist?(dir)
+          entries.delete(key)
+        end
+
+        save_manifest
+      end
+
+      private
+
+      def load_manifest
+        FileUtils.mkdir_p(@cache_dir)
+        manifest_path = File.join(@cache_dir, MANIFEST_FILE)
+
+        if File.exist?(manifest_path)
+          begin
+            @manifest = JSON.parse(File.read(manifest_path))
+            # Ensure entries key exists
+            @manifest["entries"] ||= {}
+          rescue JSON::ParserError
+            @manifest = create_empty_manifest
+          end
+        else
+          @manifest = create_empty_manifest
+        end
+      end
+
+      def save_manifest
+        manifest_path = File.join(@cache_dir, MANIFEST_FILE)
+        # Write to tmp file then rename for atomicity
+        tmp_path = "#{manifest_path}.tmp.#{Process.pid}"
+        File.write(tmp_path, JSON.pretty_generate(@manifest))
+        File.rename(tmp_path, manifest_path)
+      rescue StandardError
+        # Best effort — don't crash if manifest write fails
+        FileUtils.rm_f(tmp_path) if tmp_path
+      end
+
+      def create_empty_manifest
+        {
+          "version" => Konpeito::VERSION,
+          "entries" => {}
+        }
+      end
+    end
+  end
+end

data/lib/konpeito/cache.rb

@@ -4,5 +4,6 @@ module Konpeito
   module Cache
     autoload :CacheManager, "konpeito/cache/cache_manager"
     autoload :DependencyGraph, "konpeito/cache/dependency_graph"
+    autoload :RunCache, "konpeito/cache/run_cache"
   end
 end

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
 
@@ -102,7 +102,7 @@ module Konpeito
                       ;;
                   run)
                       if [[ "${cur}" == -* ]]; then
-                          COMPREPLY=( $(compgen -W "--target --classpath --rbs -I --require-path --inline -v --verbose --no-color -h --help" -- "${cur}") )
+                          COMPREPLY=( $(compgen -W "--target --classpath --rbs -I --require-path --inline --no-cache --clean-run-cache -v --verbose --no-color -h --help" -- "${cur}") )
                       else
                           COMPREPLY=( $(compgen -f -X '!*.rb' -- "${cur}") )
                       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,12 +185,14 @@ 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' \
                           '--require-path[Add require search path]:path:_directories' \
                           '--inline[Use inline RBS annotations]' \
+                          '--no-cache[Force recompilation]' \
+                          '--clean-run-cache[Clear run cache before building]' \
                           '-v[Verbose output]' \
                           '--verbose[Verbose output]' \
                           '--no-color[Disable colored output]' \
@@ -263,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'
@@ -274,10 +276,13 @@ 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'
+          complete -c konpeito -n '__fish_seen_subcommand_from run' -l inline -d 'Use inline RBS annotations'
+          complete -c konpeito -n '__fish_seen_subcommand_from run' -l no-cache -d 'Force recompilation'
+          complete -c konpeito -n '__fish_seen_subcommand_from run' -l clean-run-cache -d 'Clear run cache'
           complete -c konpeito -n '__fish_seen_subcommand_from run' -s v -l verbose -d 'Verbose output'
           complete -c konpeito -n '__fish_seen_subcommand_from run' -l no-color -d 'Disable colored output'
           complete -c konpeito -n '__fish_seen_subcommand_from run' -F -d 'Ruby source file'

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